Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

GtkAboutDialog

GtkAboutDialog Отображение информации о приложении

Краткое описание

#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() которая конструирует и показывает диалог.

Детали

GtkAboutDialog

typedef struct _GtkAboutDialog GtkAboutDialog;

GtkAboutDialog структура содержит только закрытые данные и не должна использоваться непосредственно.


gtk_about_dialog_new ()

GtkWidget*  gtk_about_dialog_new            (void);

Создаёт новый GtkAboutDialog.

Возвращает:

вновь созданный GtkAboutDialog

Начиная с версии 2.6


gtk_about_dialog_get_name ()

const gchar* gtk_about_dialog_get_name      (GtkAboutDialog *about);

Возвращает имя программы отображаемое в диалоге (about dialog).

about :

GtkAboutDialog

Возвращает:

имя программы. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_name ()

void gtk_about_dialog_set_name (GtkAboutDialog *about, const gchar *name);

Устанавливает имя для отображения в диалоге (about dialog). Если оно не установлено, то по умолчанию g_get_application_name().

about :

GtkAboutDialog

name :

имя программы

Начиная с версии 2.6


gtk_about_dialog_get_version ()

const gchar* gtk_about_dialog_get_version   (GtkAboutDialog *about);

Возвращает строку с версией программы.

about :

GtkAboutDialog

Возвращает:

Строка с версией. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_version ()

void gtk_about_dialog_set_version (GtkAboutDialog *about, const gchar *version);

Устанавливает строку версии отображаемой в диалоге (about dialog).

about :

GtkAboutDialog

version :

Строка версии

Начиная с версии 2.6


gtk_about_dialog_get_copyright ()

const gchar* gtk_about_dialog_get_copyright (GtkAboutDialog *about);

Возвращает строку авторского права.

about :

GtkAboutDialog

Возвращает:

Строка авторского права. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_copyright ()

void gtk_about_dialog_set_copyright (GtkAboutDialog *about, const gchar *copyright);

Устанавливает строку авторского права отображаемой в диалоге. Это должна быть короткая строка в одну или две линии.

about :

GtkAboutDialog

copyright :

Строка авторского права

Начиная с версии 2.6


gtk_about_dialog_get_comments ()

const gchar* gtk_about_dialog_get_comments  (GtkAboutDialog *about);

Возвращает строку комментарий.

about :

GtkAboutDialog

Возвращает:

Комментарий. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_comments ()

void gtk_about_dialog_set_comments (GtkAboutDialog *about, const gchar *comments);

Устанавливает строку комментарий отображаемой в диалоге. Это должна быть короткая строка в одну или две линии.

about :

GtkAboutDialog

comments :

Строка комментарий

Начиная с версии 2.6


gtk_about_dialog_get_license ()

const gchar* gtk_about_dialog_get_license   (GtkAboutDialog *about);

Возвращает информацию о лицензии.

about :

GtkAboutDialog

Возвращает:

Информация о лицензии. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_license ()

void gtk_about_dialog_set_license (GtkAboutDialog *about, const gchar *license);

Устанавливает информацию о лицензии отображаемой во вторичном диалоге (license dialog). Если license равно NULL, кнопка «лицензия» скрыта.

about :

GtkAboutDialog

license :

Информация о лицензии или NULL

Начиная с версии 2.6


gtk_about_dialog_get_wrap_license ()

gboolean gtk_about_dialog_get_wrap_license (GtkAboutDialog *about);

Определяет нужно ли автоматически заворачивать текст лицензии в about.

about :

GtkAboutDialog

Возвращает:

TRUE если текст лицензии свёрнут

Начиная с версии 2.8


gtk_about_dialog_set_wrap_license ()

void gtk_about_dialog_set_wrap_license (GtkAboutDialog *about, gboolean wrap_license);

Устанавливает нужно ли автоматически заворачивать текст лицензии в about.

about :

GtkAboutDialog

wrap_license :

Свернут ли текст лицензии

Начиная с версии 2.8


gtk_about_dialog_get_website ()

const gchar* gtk_about_dialog_get_website   (GtkAboutDialog *about);

Возвращает URL вебсайта.

about :

GtkAboutDialog

Возвращает:

URL вебсайта. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_website ()

void gtk_about_dialog_set_website (GtkAboutDialog *about, const gchar *website);

Устанавливает URL используемый для ссылки на вебсайт.

about :

GtkAboutDialog

website :

Строка URL начинающаяся с "http://"

Начиная с версии 2.6


gtk_about_dialog_get_website_label ()

const gchar* gtk_about_dialog_get_website_label (GtkAboutDialog *about);

Возвращает метку используемую для ссылки вебсайта.

about :

GtkAboutDialog

Возвращает:

Метка используемая для ссылки вебсайта. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_website_label ()

void gtk_about_dialog_set_website_label (GtkAboutDialog *about, const gchar *website_label);

Устанавливает метку используемую для ссылки вебсайта. По умолчанию это URL.

about :

GtkAboutDialog

website_label :

Метка используемая для ссылки вебсайта

Начиная с версии 2.6


gtk_about_dialog_get_authors ()

const gchar* const * gtk_about_dialog_get_authors (GtkAboutDialog *about);

Возвращает строку которая отображается во вкладке автор вторичного диалога (credits dialog).

about :

GtkAboutDialog

Возвращает:

Строка NULL-завершённый массив содержащий авторов. Массивом владеет диалог (about dialog) и он не должен освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_authors ()

void gtk_about_dialog_set_authors (GtkAboutDialog *about, const gchar **authors);

Устанавливает строки которые отображаются во вкладке авторы вторичного диалога (credits dialog).

about :

GtkAboutDialog

authors :

NULL-завершенный массив строк

Начиная с версии 2.6


gtk_about_dialog_get_artists ()

const gchar* const * gtk_about_dialog_get_artists (GtkAboutDialog *about);

Возвращает строку которая отображается во вкладке оформители вторичного диалога (credits dialog).

about :

GtkAboutDialog

Возвращает:

Строка NULL-завершённый массив содержащий оформителей. Массивом владеет диалог (about dialog) и он не должен освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_artists ()

void gtk_about_dialog_set_artists (GtkAboutDialog *about, const gchar **artists);

Устанавливает строки которые отображаются во вкладке оформители вторичного диалога (credits dialog).

about :

GtkAboutDialog

artists :

NULL-завершённый массив строк

Начиная с версии 2.6


gtk_about_dialog_get_documenters ()

const gchar* const * gtk_about_dialog_get_documenters (GtkAboutDialog *about);

Возвращает которая отображается во вкладке документация вторичного диалога (credits dialog).

about :

GtkAboutDialog

Возвращает:

NULL-завершенный массив содержащий документацию. Массивом владеет диалог (about dialog) и он не должен освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_documenters ()

void gtk_about_dialog_set_documenters (GtkAboutDialog *about, const gchar **documenters);

Устанавливает строку которая отображается во вкладке документация вторичного диалога (credits dialog).

about :

GtkAboutDialog

documenters :

NULL-завершённый массив строк

Начиная с версии 2.6


gtk_about_dialog_get_translator_credits ()

const gchar* gtk_about_dialog_get_translator_credits (GtkAboutDialog *about);

Возвращает строку содержащую переводчиков и отображаемую во вкладке перевод вторичного диалога (credits dialog).

about :

GtkAboutDialog

Возвращает:

Строка содержащая имена переводчиков. Строкой владеет диалог и она не должна освобождаться или изменяться.

Начиная с версии 2.6


gtk_about_dialog_set_translator_credits ()

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" будут не переведены и скроет вкладку.

about :

GtkAboutDialog

translator_credits :

переводчики

Начиная с версии 2.6


gtk_about_dialog_get_logo ()

GdkPixbuf*  gtk_about_dialog_get_logo       (GtkAboutDialog *about);

Возвращает pixbuf отображаемый как логотип в диалоге (about dialog).

about :

GtkAboutDialog

Возвращает:

pixbuf отображаемый как логотип. pixbufом владеет диалог (about dialog). Если вы хотите сохранить справочную информацию об этом, вам придеться вызвать g_object_ref() на нём.

Начиная с версии 2.6


gtk_about_dialog_set_logo ()

void gtk_about_dialog_set_logo (GtkAboutDialog *about, GdkPixbuf *logo);

Устанавливает pixbuf для отображения логотипа в диалоге (about dialog). Если равен NULL, по умолчанию значок окна устанавливается с помощью gtk_window_set_default_icon().

about :

GtkAboutDialog

logo :

GdkPixbuf, или NULL

Начиная с версии 2.6


gtk_about_dialog_get_logo_icon_name ()

const gchar* gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about);

Возвращает имя значка отображаемого как логотип в диалоге (about dialog).

about :

GtkAboutDialog

Возвращает:

Имя значка отображаемого как логотип. Строкой владеет диалог. Если вы хотите сохранить справочную информацию для него, вам придется вызвать g_strdup() на нем.

Начиная с версии 2.6


gtk_about_dialog_set_logo_icon_name ()

void gtk_about_dialog_set_logo_icon_name (GtkAboutDialog *about, const gchar *icon_name);

Устанавливает pixbuf отображаемый как логотип в диалоге (about dialog). Если равен NULL, по умолчанию значок окна устанавливается с помощью gtk_window_set_default_icon().

about :

GtkAboutDialog

icon_name :

Имя значка, или NULL

Начиная с версии 2.6


GtkAboutDialogActivateLinkFunc ()

void (*GtkAboutDialogActivateLinkFunc) (GtkAboutDialog *about, const gchar *link, gpointer data);

Тип функции которая вызывается когда URL или email ссылка активизируется.

about :

GtkAboutDialog в котором была активизирована ссылка

link :

URL или email адрес

data :

Пользовательские данные которые помещаются когда функция регистрируется с помощью gtk_about_dialog_set_email_hook() или gtk_about_dialog_set_url_hook()


gtk_about_dialog_set_email_hook ()

GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_email_hook (GtkAboutDialogActivateLinkFunc func, gpointer data, GDestroyNotify destroy);

Устанавливает глобальную функцию которая вызывается когда пользователь активизирует email ссылку в диалоге (about dialog).

func :

Функция вызываемая когда активизирована email ссылка.

data :

Данные помещаемые в func

destroy :

GDestroyNotify для data

Возвращает:

Предварительный обработчик email прерывания.

Начиная с версии 2.6


gtk_about_dialog_set_url_hook ()

GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_url_hook (GtkAboutDialogActivateLinkFunc func, gpointer data, GDestroyNotify destroy);

Устанавливает глобальную функцию вызываемую когда пользователь активизирует URL ссылку в диалоге (about dialog).

func :

Функция вызываемая когда активизируется URL ссылка.

data :

Данные помещаемые в func

destroy :

GDestroyNotify для data

Возвращает:

Предварительный обработчик URL прерывания.

Начиная с версии 2.6


gtk_show_about_dialog ()

void gtk_show_about_dialog (GtkWindow *parent, const gchar *first_property_name, ...);

Это функция удобства для отображения окна информации о приложении. Конструируемый диалог ассоциируется с родительским окном и многократно используется для будущих запросов этой функции.

parent :

Переходящий родитель, или NULL если нет

first_property_name :

Имя первого свойства

... :

Значение первого свойства, затем остальные свойства, завершается NULL

Начиная с версии 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 / Write

URL для ссылки на вебсайт программы. Это должна быть строка начинающаяся с "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

Смотрите также

GTK_STOCK_ABOUT