GtkAboutDialog

gtk_about_dialog_new ()

GtkWidget *
gtk_about_dialog_new (void);

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

С: 2.6

gtk_about_dialog_get_program_name ()

const gchar *
gtk_about_dialog_get_program_name (GtkAboutDialog *about);

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

С: 2.12

gtk_about_dialog_set-program-name ()

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

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

С: 2.12

gtk_about-dialog-get-version ()

const gchar *
gtk_about_dialog_get_version (GtkAboutDialog *about);

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

С: 2.6

gtk_about_dialog_set_version ()

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

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

С: 2.6

gtk_about-dialog-get-copyright ()

const gchar *
gtk_about_dialog_get_copyright (GtkAboutDialog *about);

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

С: 2.6

gtk_about-dialog-set-copyright ()

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

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

С: 2.6

gtk_about_dialog_get_comments ()

const gchar *
gtk_about_dialog_get_comments (GtkAboutDialog *about);

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

С: 2.6

gtk_about_dialog_set_comments ()

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

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

С: 2.6

gtk_about_dialog_get_license ()

const gchar *
gtk_about_dialog_get_license (GtkAboutDialog *about);

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

С: 2.6

gtk_about_dialog_set_license ()

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

Устанавливает информацию о лицензии, которая будет отображаться во вторичном диалоговом окне лицензии. Если license имеет значение NULL, кнопка лицензии скрывается.

С: 2.6

gtk_about_dialog_get_wrap-license ()

gboolean
gtk_about_dialog_get_wrap_license (GtkAboutDialog *about);

Возвращает, автоматически ли обрезается текст лицензии в about.

С: 2.8

gtk_about_dialog_set-wrap-license ()

void
gtk_about_dialog_set_wrap_license (GtkAboutDialog *about,
                                   gboolean wrap_license);

Устанавливает, автоматически ли обрезается текст лицензии в about.

С: 2.8

gtk_about_dialog_get_license_type ()

GtkLicense
gtk_about_dialog_get_license_type (GtkAboutDialog *about);

Получает лицензию, установленную с помощью gtk_about_dialog_set_license_type()

С версии: 3.0

gtk_about_dialog_set_license_type ()

void
gtk_about_dialog_set_license_type (GtkAboutDialog *about,
                                   GtkLicense license_type);

Устанавливает лицензию приложения, отображающего диалог about из списка известных лицензий.

Эта функция переопределяет лицензию, установленную с помощью gtk_about_dialog_set_license().

С версии: 3.0

gtk_about_dialog_get_website ()

const gchar *
gtk_about_dialog_get_website (GtkAboutDialog *about);

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

С версии: 2.6

gtk_about_dialog_set_website ()

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

Устанавливает URL для ссылки на веб-сайт.

С версии: 2.6

gtk_about_dialog_get_website_label ()

const gchar *
gtk_about_dialog_get_website_label (GtkAboutDialog *about);

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

С версии: 2.6

gtk_about_dialog_set_website_label ()

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

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

С версии: 2.6

gtk_about_dialog_get_authors ()

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

Возвращает строку, отображаемую во вкладке «Авторы» диалога вторичных данных об авторских правах.

Since: 2.6

gtk_about_dialog_set_authors ()

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

Устанавливает строки, отображаемые во вкладке «Авторы» диалога вторичных данных об авторских правах.

Since: 2.6

gtk_about_dialog_get_artists ()

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

Возвращает строку, отображаемую во вкладке «Художники» диалога вторичных данных об авторских правах.

Since: 2.6

gtk_about_dialog_set_artists ()

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

Устанавливает строки, отображаемые во вкладке «Художники» диалога вторичных данных об авторских правах.

Since: 2.6

gtk_about_dialog_get_documenters ()

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

Возвращает строку, отображаемую во вкладке «Документаторы» диалога вторичных данных об авторских правах.

Since: 2.6

gtk_about_dialog_set_documenters ()

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

Устанавливает строки, которые отображаются во вкладке «Документаторы» диалога вторичных данных о лицензировании.

С: 2.6

gtk_about_dialog_get_translator_credits ()

const gchar *
gtk_about_dialog_get_translator_credits
                               (GtkAboutDialog *about);

Возвращает строку с данными о переводчиках, отображаемую во вкладке «Переводчики» диалога вторичных данных о лицензировании.

С: 2.6

gtk_about_dialog_set_translator_credits ()

void
gtk_about_dialog_set_translator_credits
                               (GtkAboutDialog *about,
                                const gchar *translator_credits);

Устанавливает строку с данными о переводчиках, отображаемую во вкладке «Переводчики» диалога вторичных данных о лицензировании.

Предполагается, что эта строка отображает переводчика языка, который в данный момент используется в пользовательском интерфейсе. Используя gettext(), простой способ достижения этого - отметить строку для перевода:

gtk_show_about_dialog (NULL,
                       "program-name", "ExampleCode",
                       "logo", example_logo,
                       "title" _("About ExampleCode"),
                       NULL);

Рекомендуется использовать стандартный идентификатор «translator-credits», так как переводчики уже знакомы с его назначением, и GtkAboutDialog определит, если «translator-credits» не переведён, и скроет вкладку.

С: 2.6

gtk_about_dialog_get_logo ()

GdkPixbuf *
gtk_about_dialog_get_logo (GtkAboutDialog *about);

Возвращает pixbuf, отображаемый в качестве логотипа в диалоге о программе.

С: 2.6

gtk_about_dialog_set_logo ()

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

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

С: 2.6

gtk_about_dialog_get_logo_icon_name ()

const gchar *
gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about);

Возвращает имя значка, отображаемого в качестве логотипа в диалоговом окне «О программе».

С: 2.6

gtk_about_dialog_set_logo_icon_name ()

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

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

С: 2.6

gtk_about_dialog_add_credit_section ()

void
gtk_about_dialog_add_credit_section (GtkAboutDialog *about,
                                     const gchar *section_name,
                                     const gchar **people);

Создаёт новый раздел на странице «Участие».

С: 3.4

gtk_show_about_dialog ()

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

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

С: 2.6

Свойство “artists”

  “artists”                  GStrv

Авторы графического дизайна программы, представленные в виде NULL-ограниченного массива строк. Каждая строка может содержать электронные адреса и URL-адреса, которые будут отображаться как ссылки, см. введение для более подробной информации.

Флаги: Чтение / Запись

С версии: 2.6

Свойство “authors”

  “authors”                  GStrv

Авторы программы, представленные в виде NULL-ограниченного массива строк. Каждая строка может содержать электронные адреса и URL-адреса, которые будут отображаться как ссылки, см. введение для более подробной информации.

Флаги: Чтение / Запись

С версии: 2.6

Свойство “comments”

  “comments”                 gchar *

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

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.6

Свойство “copyright”

  “copyright”                gchar *

Информация об авторских правах на программу.

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.6

Свойство “documenters”

  “documenters”              GStrv

Авторы документации к программе, представленные в виде NULL-ограниченного массива строк. Каждая строка может содержать электронные адреса и URL-адреса, которые будут отображаться как ссылки, см. введение для более подробной информации.

Флаги: Чтение / Запись

С версии: 2.6

Свойство “license”

  “license”                  gchar *

Лицензия программы. Эта строка отображается в текстовом представлении во вторичном диалоговом окне, поэтому допустимо использование длинного текста с несколькими абзацами. Обратите внимание, что текст будет переносить строки только в текстовом представлении, если свойство "wrap-license" установлено в TRUE; в противном случае текст должен содержать необходимые переводы строк. При установке этого свойства на значение, отличное от NULL, свойство “тип-лицензии” автоматически устанавливается в GTK_LICENSE_CUSTOM.

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.6

Свойство “license-type”

  “license-type”             GtkLicense

Лицензия программы, представленная в виде значения перечисления GtkLicense.

Программа GtkAboutDialog автоматически заполнит стандартное уведомление и предоставит пользователю ссылку на соответствующий онлайн-ресурс с текстом лицензии.

Если используется GTK_LICENSE_UNKNOWN, ссылка будет той же, что указана в свойстве “сайт”.

Если используется GTK_LICENSE_CUSTOM, будут использоваться текущие данные свойства “лицензия”.

Для любого другого значения перечисления GtkLicense содержимое свойства “лицензия” также устанавливается этим свойством как побочный эффект.

Флаги: Чтение / Запись

Значение по умолчанию: GTK_LICENSE_UNKNOWN

С версии: 3.0

Свойство “logo”

  “logo”                     GdkPixbuf *

Логотип для диалогового окна "О программе". Если это NULL, будет использоваться значок окна по умолчанию, заданный с помощью gtk_window_set_default_icon().

Флаги: Чтение / Запись

С версии: 2.6

Свойство “logo-icon-name”

  “logo-icon-name”           gchar *

Имя иконки, используемой в качестве логотипа в окне «О программе». Это свойство переопределяет свойство «logo».

Флаги: Чтение / Запись

Значение по умолчанию: "image-missing"

С версии: 2.6

Свойство “program-name”

  “program-name”             gchar *

Имя программы. Если это свойство не задано, используется значение по умолчанию из g_get_application_name().

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.12

Свойство “translator-credits”

  “translator-credits”       gchar *

Данные о переводчиках. Эта строка должна быть отмечена как переводимая. Строка может содержать адреса электронной почты и URL-адреса, которые будут отображаться как ссылки. Подробнее см. вводную часть.

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.6

Свойство “version”

  “version”                  gchar *

Версия программы.

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.6

Свойство “website”

  “website”                  gchar *

URL веб-сайта программы. Строка должна начинаться с «http://».

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.6

Свойство “website-label”

  “website-label”            gchar *

Метка для ссылки на веб-сайт программы.

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.6

Свойство “wrap-license”

  “wrap-license”             gboolean

Указывает, нужно ли обрезать текст в окне лицензии.

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 2.8