LXF94:GTK+ - История изменений

Crazy Rebel в 05:23, 16 декабря 2008

2008-12-16T05:23:32Z

Crazy Rebel: /* Виртуальная файловая система GNOME */ викификация, оформление

2008-12-16T04:39:40Z

‎Виртуальная файловая система GNOME: викификация, оформление

Внесённые изменения

Yaleks в 16:31, 10 августа 2008

2008-08-10T16:31:05Z

Lockal: «LXF94:GTK+: Буфер обмена и VFS» переименована в «LXF94:GTK+»: унификация

2008-04-27T16:43:03Z

«LXF94:GTK+: Буфер обмена и VFS» переименована в «LXF94:GTK+»: унификация

Lockal: восстановление кавычек в коде AWB

2008-04-27T14:18:22Z

восстановление кавычек в коде AWB

Lodger: /* Буфер обмена GTK+ и GNOME */

2008-03-13T17:35:05Z

‎Буфер обмена GTK+ и GNOME

Lodger: /* Буфер обмена GTK+ и GNOME */

2008-03-13T17:33:47Z

‎Буфер обмена GTK+ и GNOME

Lodger: /* Буфер обмена GTK+ и GNOME */

2008-03-13T17:33:11Z

‎Буфер обмена GTK+ и GNOME

Lodger: /* Редактирование меню */

2008-03-13T17:27:23Z

‎Редактирование меню

Lodger: /* Редактирование меню */

2008-03-13T17:27:02Z

‎Редактирование меню

@@ Строка 28: / Строка 28: @@
 Организовать передачу данных между буфером обмена и экземпляром GtkTextBuffer очень просто. Ниже приводится текст обработчика сигнала меню copy1_activate нашего текстового редактора (этот сигнал генерирует команда Правка | Копировать).
   void on_copy1_activate (GtkMenuItem * menuitem, gpointer user_data)
+  {
@@ Строка 35: / Строка 36: @@
   gtk_text_buffer_copy_clipboard(textbuffer, cb);
+  }
 Вызывая gtk_clipboard_get(), мы передаем этой функции X-атом, идентифицирующий буфер обмена, который мы хотим открыть, и получаем строку с именем атома с помощью функции gdk_atom_name(). Функция gtk_text_buffer_copy_clipboard() копирует в буфер обмена строку текста, выделенную в текстовом буфере GtkTextBuffer (программно или с помощью интерфейса пользователя). Первым параметром функции, копирующей данные, должен быть указатель на объект GtkTextBuffer, вторым параметром – указатель на объект GtkClipboard. Для вставки данных из буфера обмена в текстовый буфер применяется функция gtk_text_buffer_paste_clipboard(), которой, помимо прочего, следует передать итератор, указывающий, где именно в тексте должна быть вставлена строка из буфера обмена (при использовании текстового буфера вместе с GtkTextView вместо итератора функции можно передать NULL).
@@ Строка 44: / Строка 46: @@
 Если вы хотите поместить в буфер обмена данные в нескольких форматах или реализовать отложенную запись, все становится более сложным. В этом случае ваша программа должна объявить системе, что она готова передать в буфер обмена данные в определенных форматах и зарегистрировать функции обратного вызова, которые будут выполнять их фактическую обработку. Когда данные понадобятся, эти функции будут вызваны системой. Рассмотрим пример – фрагмент программы, копирующей в буфер строку текста:
   void cb_get_func(GtkClipboard * clipboard, GtkSelectionData * selection_data, guint info, gpointer user_data)
+  {
@@ Строка 63: / Строка 66: @@
   NULL);
+  }
 === Виртуальная файловая система GNOME ===
@@ Строка 74: / Строка 78: @@
 Рассмотрим функцию '''open_file()''' нашего текстового редактора (листинг сокращен):
    void open_file(char * file_name)
+   {
@@ Строка 98: / Строка 103: @@
    gtk_text_buffer_set_modified(textbuffer, FALSE);
+   }
 Функции ''GNOME VFS'' API объявлены в заголовочном файле '''libgnomevfs/gnome-vfs.h''' (сама библиотека '''libgnomevfs''' включена в проект приложения GNOME, созданный в ''Anjuta'', по умолчанию). Систему
@@ Строка 135: / Строка 141: @@
 для чтения:
   gnome_vfs_open(&file_handle, “http://www.somesite.com/somefile.txt”,
   GNOME_VFS_OPEN_READ);
 Префикс '''http://''' надо указывать обязательно, иначе система не узнает, какой модуль виртуальной файловой системы должен использоваться для загрузки ресурса. Дальше данные можно считывать с помощью '''gnome_vfs_read()'''. Загрузить файл на FTP-сайт тоже очень просто. Создаем или перезаписываем файл, например:
   gnome_vfs_create(&file_handle, “ftp://user:password@somesite.com/
   home/user/somefile.txt”, GNOME_VFS_OPEN_WRITE, FALSE, 0666);
 Затем данные записываются в новый файл с помощью '''gnome_vfs_write()''' (для работы с идентификаторами FTP-ресурсов лучше
@@ Строка 169: / Строка 179: @@
 всегда, на диске).
   int scan_directory(char * dir_name)
+  {
@@ Строка 206: / Строка 217: @@
       return 0;
+  }
 Мы открываем директорию для чтения с помощью функции

← Предыдущая		Версия 16:31, 10 августа 2008
Строка 1:		Строка 1:
		+	{{Цикл/GTK+}}
		+
	== Погружение в GNOME ==		== Погружение в GNOME ==
	''ЧАСТЬ 8 Мы уже успели замочить ножки в океане возможностей, которые предоставляет GNOME – и сейчас самое время зайти поглубже. '''Андрей Боровский''' проверяет, теплая ли водичка.''		''ЧАСТЬ 8 Мы уже успели замочить ножки в океане возможностей, которые предоставляет GNOME – и сейчас самое время зайти поглубже. '''Андрей Боровский''' проверяет, теплая ли водичка.''

@@ Строка 28: / Строка 28: @@
   void on_copy1_activate (GtkMenuItem * menuitem, gpointer user_data)
+  {
-  char * atom = gdk_atom_name(“CLIPBOARD”);
+  char * atom = gdk_atom_name("CLIPBOARD");
   GtkClipboard * cb = gtk_clipboard_get(atom);
   g_free(atom);
@@ Строка 44: / Строка 44: @@
   void cb_get_func(GtkClipboard * clipboard, GtkSelectionData * selection_data, guint info, gpointer user_data)
+  {
-  char * str = “Данные для буфера обмена”;
+  char * str = "Данные для буфера обмена";
   gtk_selection_data_set_text(selection_data, str, strlen(str));
+  }
@@ Строка 54: / Строка 54: @@
+  {
   static const GtkTargetEntry targets[] =
-  { { “UTF8_STRING”, 0, GDK_TARGET_STRING } };
+  { { "UTF8_STRING", 0, GDK_TARGET_STRING } };
-  char * atom = gdk_atom_name(“CLIPBOARD”);
+  char * atom = gdk_atom_name("CLIPBOARD");
   GtkClipboard * cb = gtk_clipboard_get(atom);
   g_free(atom);

← Предыдущая		Версия 17:35, 13 марта 2008
Строка 41:		Строка 41:

	Если вы хотите поместить в буфер обмена данные в нескольких форматах или реализовать отложенную запись, все становится более сложным. В этом случае ваша программа должна объявить системе, что она готова передать в буфер обмена данные в определенных форматах и зарегистрировать функции обратного вызова, которые будут выполнять их фактическую обработку. Когда данные понадобятся, эти функции будут вызваны системой. Рассмотрим пример – фрагмент программы, копирующей в буфер строку текста:		Если вы хотите поместить в буфер обмена данные в нескольких форматах или реализовать отложенную запись, все становится более сложным. В этом случае ваша программа должна объявить системе, что она готова передать в буфер обмена данные в определенных форматах и зарегистрировать функции обратного вызова, которые будут выполнять их фактическую обработку. Когда данные понадобятся, эти функции будут вызваны системой. Рассмотрим пример – фрагмент программы, копирующей в буфер строку текста:
		+
		+	void cb_get_func(GtkClipboard * clipboard, GtkSelectionData * selection_data, guint info, gpointer user_data)
		+	{
		+	char * str = “Данные для буфера обмена”;
		+	gtk_selection_data_set_text(selection_data, str, strlen(str));
		+	}
		+	void cb_clear_func(GtkClipboard * clipboard, gpointer user_data)
		+	{
		+	// Nothing to do
		+	}
		+	void on_copy1_activate (GtkMenuItem * menuitem, gpointer user_data)
		+	{
		+	static const GtkTargetEntry targets[] =
		+	{ { “UTF8_STRING”, 0, GDK_TARGET_STRING } };
		+	char * atom = gdk_atom_name(“CLIPBOARD”);
		+	GtkClipboard * cb = gtk_clipboard_get(atom);
		+	g_free(atom);
		+	gtk_clipboard_set_with_data(cb, targets, 1, cb_get_func, cb_clear_func,
		+	NULL);
		+	}

	=== Виртуальная файловая система GNOME ===		=== Виртуальная файловая система GNOME ===

@@ Строка 38: / Строка 38: @@
 Разумеется, у буфера обмена есть и собственный API, который можно применять независимо от других компонентов GTK+/GNOME. Для передачи в буфер обмена строки текста в общем случае используется функция gtk_clipboard_set_text(). Первым параметром этой функции должен быть указатель на объект GtkClipboard. Второй и третий параметры, соответственно, строка текста с нулевым конечным символом и длина строки в байтах (напомню, что в GTK+ и GNOME по умолчанию используется кодировка UTF-8). Для передачи в буфер обмена растрового графического объекта служит функция gtk_clipboard_set_image(). У этой функции всего два параметра: указатель на объект GtkClipboard и указатель на объект GdkPixBuf, содержащий данные растрового изображения.
-[[Image:Gtk 2.JPG|left|thumb|200px]]
+[[Image:Gtk 2.JPG|right|thumb|180px]]
 Если вы хотите поместить в буфер обмена данные в нескольких форматах или реализовать отложенную запись, все становится более сложным. В этом случае ваша программа должна объявить системе, что она готова передать в буфер обмена данные в определенных форматах и зарегистрировать функции обратного вызова, которые будут выполнять их фактическую обработку. Когда данные понадобятся, эти функции будут вызваны системой. Рассмотрим пример – фрагмент программы, копирующей в буфер строку текста:
 === Виртуальная файловая система GNOME ===

← Предыдущая		Версия 17:33, 13 марта 2008
Строка 18:		Строка 18:
	=== Буфер обмена GTK+ и GNOME ===		=== Буфер обмена GTK+ и GNOME ===

		+	Интерфейс буфера обмена в GTK+ основан на структуре GtkClipboard. Мы получаем доступ к этой структуре с помощью функции gtk_clipboard_get(). Первый вызов gtk_clipboard_get() создает экземпляр структуры, которая переходит под управление GTK+ (так что мы не должны удалять ее явным образом). При последующих вызовах gtk_clipboard_get() возвращает указатель на существующую структуру GtkClipboard.
		+
		+	При работе с X Window следует учесть, что система поддерживает как минимум два буфера обмена (теоретически их может быть и больше). Если вы используете команду меню Правка \| Копировать, данные обычно попадают в буфер обмена, связанный с атомом CLIPBOARD. В то же время любые данные, выделенные мышью в окне X-программы, заносятся в буфер обмена, связанный с атомом PRIMARY (вставка данных из этого буфера обычно выполняется с помощью щелчка средней кнопкой мыши). Вообще говоря, X-программы вольны интерпретировать оба буфера так, как им заблагорассудится. На практике это иногда приводит к тому, что результаты вставки данных из буфера обмена оказываются несколько неожиданными.
		+
		+	Интерфейс буфера обмена GTK+ позволяет работать со всеми буферами обмена X. GTK+ поддерживает размещение данных в буферах обмена в нескольких форматах и отложенную запись.
		+
		+	Организовать передачу данных между буфером обмена и экземпляром GtkTextBuffer очень просто. Ниже приводится текст обработчика сигнала меню copy1_activate нашего текстового редактора (этот сигнал генерирует команда Правка \| Копировать).
		+
		+	void on_copy1_activate (GtkMenuItem * menuitem, gpointer user_data)
		+	{
		+	char * atom = gdk_atom_name(“CLIPBOARD”);
		+	GtkClipboard * cb = gtk_clipboard_get(atom);
		+	g_free(atom);
		+	gtk_text_buffer_copy_clipboard(textbuffer, cb);
		+	}
		+
		+	Вызывая gtk_clipboard_get(), мы передаем этой функции X-атом, идентифицирующий буфер обмена, который мы хотим открыть, и получаем строку с именем атома с помощью функции gdk_atom_name(). Функция gtk_text_buffer_copy_clipboard() копирует в буфер обмена строку текста, выделенную в текстовом буфере GtkTextBuffer (программно или с помощью интерфейса пользователя). Первым параметром функции, копирующей данные, должен быть указатель на объект GtkTextBuffer, вторым параметром – указатель на объект GtkClipboard. Для вставки данных из буфера обмена в текстовый буфер применяется функция gtk_text_buffer_paste_clipboard(), которой, помимо прочего, следует передать итератор, указывающий, где именно в тексте должна быть вставлена строка из буфера обмена (при использовании текстового буфера вместе с GtkTextView вместо итератора функции можно передать NULL).
		+
		+	Разумеется, у буфера обмена есть и собственный API, который можно применять независимо от других компонентов GTK+/GNOME. Для передачи в буфер обмена строки текста в общем случае используется функция gtk_clipboard_set_text(). Первым параметром этой функции должен быть указатель на объект GtkClipboard. Второй и третий параметры, соответственно, строка текста с нулевым конечным символом и длина строки в байтах (напомню, что в GTK+ и GNOME по умолчанию используется кодировка UTF-8). Для передачи в буфер обмена растрового графического объекта служит функция gtk_clipboard_set_image(). У этой функции всего два параметра: указатель на объект GtkClipboard и указатель на объект GdkPixBuf, содержащий данные растрового изображения.
		+
		+	[[Image:Gtk 2.JPG\|left\|thumb\|200px]]
		+
		+	Если вы хотите поместить в буфер обмена данные в нескольких форматах или реализовать отложенную запись, все становится более сложным. В этом случае ваша программа должна объявить системе, что она готова передать в буфер обмена данные в определенных форматах и зарегистрировать функции обратного вызова, которые будут выполнять их фактическую обработку. Когда данные понадобятся, эти функции будут вызваны системой. Рассмотрим пример – фрагмент программы, копирующей в буфер строку текста:

	=== Виртуальная файловая система GNOME ===		=== Виртуальная файловая система GNOME ===

@@ Строка 8: / Строка 8: @@
 Заготовка главного меню нашей программы содержит пункт Вид (View), однако само это меню пустое. Добавим в меню Вид новую команду Шрифт..., позволяющую выбрать шрифт для отображения текста. Щелкните правой кнопкой мыши по строке главного меню в окне формы приложения и в открывшемся контекстном меню выберите команду Правка меню...
-[[Image:Gtk 1.JPG|left|thumb|220px|Редактор меню Glade.]]
+[[Image:Gtk 1.JPG|left|thumb|300px|Редактор меню Glade.]]
 Список названий пунктов меню отражает существующие между ними иерархические отношения. Сдвиг строки вправо означает переход к следующему уровню вложенности меню. С помощью кнопок Добавить и Добавить подчиненный в меню можно добавить новый пункт. При добавлении нового подчиненного пункта необходимо указать для него родительский пункт меню. Если мы потом передумаем, то с помощью клавиш навигации сможем переместить уже созданный пункт в другую группу или на другой уровень вложенности.