GTK+ Reference Manual |
||||
---|---|---|---|---|
GtkAboutDialogGtkAboutDialog Отображение информации о приложении |
#include <gtk/gtk.h>
GtkAboutDialog;
GtkWidget* gtk_about_dialog_new (void);
const gchar* gtk_about_dialog_get_name (GtkAboutDialog *about);
void gtk_about_dialog_set_name (GtkAboutDialog *about,
const gchar *name);
const gchar* gtk_about_dialog_get_version (GtkAboutDialog *about);
void gtk_about_dialog_set_version (GtkAboutDialog *about,
const gchar *version);
const gchar* gtk_about_dialog_get_copyright (GtkAboutDialog *about);
void gtk_about_dialog_set_copyright (GtkAboutDialog *about,
const gchar *copyright);
const gchar* gtk_about_dialog_get_comments (GtkAboutDialog *about);
void gtk_about_dialog_set_comments (GtkAboutDialog *about,
const gchar *comments);
const gchar* gtk_about_dialog_get_license (GtkAboutDialog *about);
void gtk_about_dialog_set_license (GtkAboutDialog *about,
const gchar *license);
gboolean gtk_about_dialog_get_wrap_license
(GtkAboutDialog *about);
void gtk_about_dialog_set_wrap_license
(GtkAboutDialog *about,
gboolean wrap_license);
const gchar* gtk_about_dialog_get_website (GtkAboutDialog *about);
void gtk_about_dialog_set_website (GtkAboutDialog *about,
const gchar *website);
const gchar* gtk_about_dialog_get_website_label
(GtkAboutDialog *about);
void gtk_about_dialog_set_website_label
(GtkAboutDialog *about,
const gchar *website_label);
const gchar* const * gtk_about_dialog_get_authors
(GtkAboutDialog *about);
void gtk_about_dialog_set_authors (GtkAboutDialog *about,
const gchar **authors);
const gchar* const * gtk_about_dialog_get_artists
(GtkAboutDialog *about);
void gtk_about_dialog_set_artists (GtkAboutDialog *about,
const gchar **artists);
const gchar* const * gtk_about_dialog_get_documenters
(GtkAboutDialog *about);
void gtk_about_dialog_set_documenters
(GtkAboutDialog *about,
const gchar **documenters);
const gchar* gtk_about_dialog_get_translator_credits
(GtkAboutDialog *about);
void gtk_about_dialog_set_translator_credits
(GtkAboutDialog *about,
const gchar *translator_credits);
GdkPixbuf* gtk_about_dialog_get_logo (GtkAboutDialog *about);
void gtk_about_dialog_set_logo (GtkAboutDialog *about,
GdkPixbuf *logo);
const gchar* gtk_about_dialog_get_logo_icon_name
(GtkAboutDialog *about);
void gtk_about_dialog_set_logo_icon_name
(GtkAboutDialog *about,
const gchar *icon_name);
void (*GtkAboutDialogActivateLinkFunc)
(GtkAboutDialog *about,
const gchar *link,
gpointer data);
GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_email_hook
(GtkAboutDialogActivateLinkFunc func,
gpointer data,
GDestroyNotify destroy);
GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_url_hook
(GtkAboutDialogActivateLinkFunc func,
gpointer data,
GDestroyNotify destroy);
void gtk_show_about_dialog (GtkWindow *parent,
const gchar *first_property_name,
...);
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBin
+----GtkWindow
+----GtkDialog
+----GtkAboutDialog
GtkAboutDialog осуществляет AtkImplementorIface.
"artists" GStrv : Read / Write
"authors" GStrv : Read / Write
"comments" gchararray : Read / Write
"copyright" gchararray : Read / Write
"documenters" GStrv : Read / Write
"license" gchararray : Read / Write
"logo" GdkPixbuf : Read / Write
"logo-icon-name" gchararray : Read / Write
"name" gchararray : Read / Write
"translator-credits" gchararray : Read / Write
"version" gchararray : Read / Write
"website" gchararray : Read / Write
"website-label" gchararray : Read / Write
"wrap-license" gboolean : Read / Write
GtkAboutDialog предлагает простой
способ отображения информации о программе
такой как эмблема, имя, авторское право,
вебсайт и лицензия. Так же возможно
предоставление информации об авторе,
документации, переводах и прочей
информации о программе. Диалог (about
dialog) обычно открывается когда пользователь
выбирает опцию About
в меню Help
.
Все части диалога являются опциональными.
Диалог (About dialog) часто содержит ссылки
и email адреса. GtkAboutDialog поддерживает
их предлагая глобальные обработчики
прерываний, которые вызываются когда
пользователь нажимает на ссылку или
email адрес, смотрите gtk_about_dialog_set_email_hook()
и gtk_about_dialog_set_url_hook()
.
Email адреса в свойствах автор, документация
и оформитель выглядят как <user@host>
,
URLs выглядят как http://url
, где url
распределяется до следующего пробела,
табуляции или конца строки.
Чтобы сделать конструкцию GtkAboutDialog
удобной на сколько это возможно, вы
можете использовать функцию
gtk_show_about_dialog()
которая конструирует и показывает
диалог.
typedef struct _GtkAboutDialog GtkAboutDialog;GtkAboutDialog структура содержит только закрытые данные и не должна использоваться непосредственно.
gtk_about_dialog_new ()
GtkWidget* gtk_about_dialog_new (void);Создаёт новый GtkAboutDialog.
Возвращает: |
вновь созданный GtkAboutDialog |
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_name (GtkAboutDialog *about);Возвращает имя программы отображаемое в диалоге (about dialog).
|
|
Возвращает: |
имя программы. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_name (GtkAboutDialog *about,
const gchar *name);
Устанавливает имя для отображения в
диалоге (about dialog). Если оно не установлено,
то по умолчанию g_get_application_name()
.
|
|
|
имя программы |
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_version (GtkAboutDialog *about);Возвращает строку с версией программы.
|
|
Возвращает: |
Строка с версией. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_version (GtkAboutDialog *about,
const gchar *version);
Устанавливает строку версии отображаемой в диалоге (about dialog).
|
|
|
Строка версии |
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_copyright (GtkAboutDialog *about);Возвращает строку авторского права.
|
|
Возвращает: |
Строка авторского права. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_copyright (GtkAboutDialog *about,
const gchar *copyright);
Устанавливает строку авторского права отображаемой в диалоге. Это должна быть короткая строка в одну или две линии.
|
|
|
Строка авторского права |
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_comments (GtkAboutDialog *about);Возвращает строку комментарий.
|
|
Возвращает: |
Комментарий. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_comments (GtkAboutDialog *about,
const gchar *comments);
Устанавливает строку комментарий отображаемой в диалоге. Это должна быть короткая строка в одну или две линии.
|
|
|
Строка комментарий |
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_license (GtkAboutDialog *about);Возвращает информацию о лицензии.
|
|
Возвращает: |
Информация о лицензии. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_license (GtkAboutDialog *about,
const gchar *license);
Устанавливает информацию о лицензии
отображаемой во вторичном диалоге
(license dialog). Если license
равно
NULL
,
кнопка «лицензия» скрыта.
|
|
|
Информация о лицензии или |
Начиная с версии 2.6
gboolean gtk_about_dialog_get_wrap_license
(GtkAboutDialog *about);
Определяет нужно ли автоматически
заворачивать текст лицензии в about
.
|
|
Возвращает: |
|
Начиная с версии 2.8
void gtk_about_dialog_set_wrap_license
(GtkAboutDialog *about,
gboolean wrap_license);
Устанавливает нужно ли автоматически
заворачивать текст лицензии в about
.
|
|
|
Свернут ли текст лицензии |
Начиная с версии 2.8
const gchar* gtk_about_dialog_get_website (GtkAboutDialog *about);Возвращает URL вебсайта.
|
|
Возвращает: |
URL вебсайта. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_website (GtkAboutDialog *about,
const gchar *website);
Устанавливает URL используемый для ссылки на вебсайт.
|
|
|
Строка URL начинающаяся с "http://" |
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_website_label
(GtkAboutDialog *about);
Возвращает метку используемую для ссылки вебсайта.
|
|
Возвращает: |
Метка используемая для ссылки вебсайта. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_website_label
(GtkAboutDialog *about,
const gchar *website_label);
Устанавливает метку используемую для ссылки вебсайта. По умолчанию это URL.
|
|
|
Метка используемая для ссылки вебсайта |
Начиная с версии 2.6
const gchar* const * gtk_about_dialog_get_authors
(GtkAboutDialog *about);
Возвращает строку которая отображается во вкладке автор вторичного диалога (credits dialog).
|
|
Возвращает: |
Строка |
Начиная с версии 2.6
void gtk_about_dialog_set_authors (GtkAboutDialog *about,
const gchar **authors);
Устанавливает строки которые отображаются во вкладке авторы вторичного диалога (credits dialog).
|
|
|
|
Начиная с версии 2.6
const gchar* const * gtk_about_dialog_get_artists
(GtkAboutDialog *about);
Возвращает строку которая отображается во вкладке оформители вторичного диалога (credits dialog).
|
|
Возвращает: |
Строка |
Начиная с версии 2.6
void gtk_about_dialog_set_artists (GtkAboutDialog *about,
const gchar **artists);
Устанавливает строки которые отображаются во вкладке оформители вторичного диалога (credits dialog).
|
|
|
|
Начиная с версии 2.6
const gchar* const * gtk_about_dialog_get_documenters
(GtkAboutDialog *about);
Возвращает которая отображается во вкладке документация вторичного диалога (credits dialog).
|
|
Возвращает: |
|
Начиная с версии 2.6
void gtk_about_dialog_set_documenters
(GtkAboutDialog *about,
const gchar **documenters);
Устанавливает строку которая отображается во вкладке документация вторичного диалога (credits dialog).
|
|
|
|
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_translator_credits
(GtkAboutDialog *about);
Возвращает строку содержащую переводчиков и отображаемую во вкладке перевод вторичного диалога (credits dialog).
|
|
Возвращает: |
Строка содержащая имена переводчиков. Строкой владеет диалог и она не должна освобождаться или изменяться. |
Начиная с версии 2.6
void gtk_about_dialog_set_translator_credits
(GtkAboutDialog *about,
const gchar *translator_credits);
Устанавливает строку содержащую переводчиков и отображаемую во вкладке перевод вторичного диалога (credits dialog).
Предполагается использовать эту
строку для отображения текущемго языкового
перевода используемого в пользовательском
интерфейсе. Использование gettext()
,
простой способ добиться маркировки
строки для перевода:
gtk_about_dialog_set_translator_credits (about, _("translator-credits"));Хорошая идея использовать общепринятые msgid "translator-credits" для этой цели, так как переводчики будут уже знать результат этого msgid, и так как GtkAboutDialog обнаружит если "translator-credits" будут не переведены и скроет вкладку.
|
|
|
переводчики |
Начиная с версии 2.6
GdkPixbuf* gtk_about_dialog_get_logo (GtkAboutDialog *about);Возвращает pixbuf отображаемый как логотип в диалоге (about dialog).
|
|
Возвращает: |
pixbuf отображаемый как логотип. pixbufом
владеет диалог (about dialog). Если вы хотите
сохранить справочную информацию об
этом, вам придеться вызвать |
Начиная с версии 2.6
void gtk_about_dialog_set_logo (GtkAboutDialog *about,
GdkPixbuf *logo);
Устанавливает pixbuf для отображения
логотипа в диалоге (about dialog). Если равен
NULL
,
по умолчанию значок окна устанавливается
с помощью gtk_window_set_default_icon()
.
|
|
|
Начиная с версии 2.6
const gchar* gtk_about_dialog_get_logo_icon_name
(GtkAboutDialog *about);
Возвращает имя значка отображаемого как логотип в диалоге (about dialog).
|
|
Возвращает: |
Имя значка отображаемого как логотип.
Строкой владеет диалог. Если вы хотите
сохранить справочную информацию для
него, вам придется вызвать |
Начиная с версии 2.6
void gtk_about_dialog_set_logo_icon_name
(GtkAboutDialog *about,
const gchar *icon_name);
Устанавливает pixbuf отображаемый как
логотип в диалоге (about dialog). Если равен
NULL
,
по умолчанию значок окна устанавливается
с помощью gtk_window_set_default_icon()
.
|
|
|
Имя значка, или |
Начиная с версии 2.6
void (*GtkAboutDialogActivateLinkFunc)
(GtkAboutDialog *about,
const gchar *link,
gpointer data);
Тип функции которая вызывается когда URL или email ссылка активизируется.
|
GtkAboutDialog в котором была активизирована ссылка |
|
URL или email адрес |
|
Пользовательские данные которые
помещаются когда функция регистрируется
с помощью |
GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_email_hook
(GtkAboutDialogActivateLinkFunc func,
gpointer data,
GDestroyNotify destroy);
Устанавливает глобальную функцию которая вызывается когда пользователь активизирует email ссылку в диалоге (about dialog).
|
Функция вызываемая когда активизирована email ссылка. |
|
Данные помещаемые в |
|
GDestroyNotify
для |
Возвращает: |
Предварительный обработчик email прерывания. |
Начиная с версии 2.6
GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_url_hook
(GtkAboutDialogActivateLinkFunc func,
gpointer data,
GDestroyNotify destroy);
Устанавливает глобальную функцию вызываемую когда пользователь активизирует URL ссылку в диалоге (about dialog).
|
Функция вызываемая когда активизируется URL ссылка. |
|
Данные помещаемые в |
|
GDestroyNotify
для |
Возвращает: |
Предварительный обработчик URL прерывания. |
Начиная с версии 2.6
void gtk_show_about_dialog (GtkWindow *parent,
const gchar *first_property_name,
...);
Это функция удобства для отображения окна информации о приложении. Конструируемый диалог ассоциируется с родительским окном и многократно используется для будущих запросов этой функции.
|
Переходящий родитель, или |
|
Имя первого свойства |
|
Значение первого свойства, затем
остальные свойства, завершается |
Начиная с версии 2.6
artists
""artists" GStrv : Read / WriteЛюди которые внесли вклад в художественное оформление программы, в виде строк
NULL
-завершенного массива. Каждая строка может содержать email адрес и URLs, которые отображаются как ссылки, смотрите подробности выше.Начиная с версии 2.6
Свойство "
authors
""authors" GStrv : Read / WriteАвторы программы, в виде строк
NULL
-завершенного массива. Каждая строка может содержать email адрес и URLs, которые отображаются как ссылки, смотрите подробности выше.Начиная с версии 2.6
Свойство "
comments
""comments" gchararray : Read / WriteКомментарии к программе. Эта строка отображается в ярлыке основного диалога, поэтому это должно быть короткое объяснение основных функций программы, а не детализированный список особенностей.
Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
copyright
""copyright" gchararray : Read / WriteИнформация об авторском праве для программы.
Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
documenters
""documenters" GStrv : Read / WriteЛюди документирующие программу, как строки
NULL
-завершенного массива. Каждая строка может содержать email адрес и URLs, которые отображаются как ссылки, смотрите подробности выше.Начиная с версии 2.6
Свойство "
license
""license" gchararray : Read / WriteЛицензия программы. Эта стока отображается во вторичном диалоге в области просмотра текста, поэтому это может быть длинный текст. Помните этот текст завернут в область просмотра текста только если "wrap-license" свойство установлено в
TRUE
; иначе сам текст должен содержать намеченный linebreaks.Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
logo
""logo" GdkPixbuf : Read / WriteЛоготип диалога (about box). Если не установлен, то по умолчанию
gtk_window_get_default_icon_list()
.Начиная с версии 2.6
Свойство "
logo-icon-name
""logo-icon-name" gchararray : Read / WriteИменованный значок используемый как логотип для диалога (about box). Это свойство отменяет свойство logo.
Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
name
""name" gchararray : Read / WriteИмя программы. Если не утановлено, то по умолчанию
g_get_application_name()
.Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
translator-credits
""translator-credits" gchararray : Read / WriteПереводчики. Эта строка должна быть помечена как переводимая. Эта строка может содержать email адрес и URLs, которые отображаются как ссылки, смотрите подробности выше.
Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
version
""version" gchararray : Read / WriteВерсия программы.
Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
website
""website" gchararray : Read / WriteURL для ссылки на вебсайт программы. Это должна быть строка начинающаяся с "http://.
Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
website-label
""website-label" gchararray : Read / WriteМетка для ссылки на вебсайт программы. Если не установлена, то по умолчанию используется URL определенный в свойстве website.
Значение по умолчанию: NULL
Начиная с версии 2.6
Свойство "
wrap-license
""wrap-license" gboolean : Read / WriteДолжен ли быть обернут текст в диалоге лицензия.
Значение по умолчанию: FALSE
Начиная с версии 2.8
Смотрите также