Spec-Zone.ru › GTK 3.24

Утилиты файловой системы

Утилиты файловой системы — Функции для работы с GIO

Функции

GMountOperation * gtk_mount_operation_new ()
gboolean gtk_mount_operation_is_showing ()
void gtk_mount_operation_set_parent ()
GtkWindow * gtk_mount_operation_get_parent ()
void gtk_mount_operation_set_screen ()
GdkScreen * gtk_mount_operation_get_screen ()
gboolean gtk_show_uri ()
gboolean gtk_show_uri_on_window ()

Свойства

gboolean is-showing Чтение
GtkWindow * parent Чтение / Запись
GdkScreen * screen Чтение / Запись

Типы и значения

struct GtkMountOperation
struct GtkMountOperationClass

Иерархия объектов

    GObject
    ╰── GMountOperation
        ╰── GtkMountOperation

Включаемые файлы

#include <gtk/gtk.h>

Описание

Функции и объекты, описанные здесь, делают работу с GTK+ и GIO более удобной.

GtkMountOperation необходим при монтировании томов: это реализация GMountOperation, которая может быть использована с функциями GIO для монтирования томов, таких как g_file_mount_enclosing_volume(), g_file_mount_mountable(), g_volume_mount(), g_mount_unmount_with_operation() и другие.

При необходимости GtkMountOperation отображает диалоги для запроса паролей, вопросов или отображения процессов, блокирующих размонтирование.

gtk_show_uri_on_window() — удобный способ запуска приложений для URI.

Другой объект, заслуживающий упоминания в этом контексте, это GdkAppLaunchContext, который предоставляет визуальную обратную связь при запуске приложений.

Функции

gtk_mount_operation_new ()

GMountOperation *
gtk_mount_operation_new (GtkWindow *parent);

Создаёт новый GtkMountOperation

Параметры

parent

транзитивный родитель окна, или NULL.

[allow-none]

Возвращает

новый GtkMountOperation

С: 2.14

gtk_mount_operation_is_showing ()

gboolean
gtk_mount_operation_is_showing (GtkMountOperation *op);

Возвращает, отображается ли окно GtkMountOperation в данный момент.

Параметры

op

a GtkMountOperation

Возвращает

TRUE если op в данный момент отображает окно

С: 2.14

gtk_mount_operation_set_parent ()

void
gtk_mount_operation_set_parent (GtkMountOperation *op,
                                GtkWindow *parent);

Устанавливает транзитивного родителя для окон, показанных GtkMountOperation.

Параметры

op

a GtkMountOperation

parent

транзитивный родитель окна, или NULL.

[allow-none]

С: 2.14

gtk_mount_operation_get_parent ()

GtkWindow *
gtk_mount_operation_get_parent (GtkMountOperation *op);

Получает транзитивного родителя, используемого GtkMountOperation

Параметры

op

a GtkMountOperation

Возвращает

транзитивного родителя для окон, показанных op .

[transfer none]

С: 2.14

gtk_mount_operation_set_screen ()

void
gtk_mount_operation_set_screen (GtkMountOperation *op,
                                GdkScreen *screen);

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

Параметры

op

a GtkMountOperation

screen

a GdkScreen

С: 2.14

gtk_mount-operation_get_screen ()

GdkScreen *
gtk_mount_operation_get_screen (GtkMountOperation *op);

Получает экран, на котором будут отображаться окна GtkMountOperation.

Параметры

op

a GtkMountOperation

Возвращает

экран, на котором отображаются окна op .

[transfer none]

С: 2.14

gtk_show_uri ()

gboolean
gtk_show_uri (GdkScreen *screen,
              const gchar *uri,
              guint32 timestamp,
              GError **error);

gtk_show_uri устарела с версии 3.22 и не должна использоваться в новом коде.

Используйте gtk_show_uri_on_window() вместо этого.

Функция-помощник для запуска приложения по умолчанию для отображения uri. Как gtk_show_uri_on_window(), но в качестве транзитивного родителя используется экран вместо окна.

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

Параметры

screen

экран для отображения uri или NULL для основного экрана.

[allow-none]

uri

uri для отображения

timestamp

временная метка для предотвращения захвата фокуса

error

a GError, возвращаемый в случае ошибок

Возвращает

TRUE при успехе, FALSE при ошибке

С: 2.14

gtk_show_uri_on_window ()

gboolean
gtk_show_uri_on_window (GtkWindow *parent,
                        const char *uri,
                        guint32 timestamp,
                        GError **error);

Это функция-помощник для запуска приложения по умолчанию для отображения uri. Uri должен быть в формате, понятном GIO (то есть, вам необходимо установить gvfs для поддержки схем uri, таких как http:// или ftp://, так как только локальные файлы обрабатываются самим GIO). Типичные примеры:

  • file:///home/gnome/pict.jpg

  • http://www.gnome.org

  • mailto:me@gnome.org

В идеале временная метка берётся из события, вызвавшего вызов gtk_show_uri(). Если временная метка неизвестна, можно использовать GDK_CURRENT_TIME.

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

Параметры

parent

родительское окно.

[allow-none]

uri

uri для отображения

timestamp

временная метка для предотвращения захвата фокуса

error

a GError для возвращения в случае ошибок

Возвращает

TRUE при успехе, FALSE при ошибке

С: 3.22

Типы и значения

struct GtkMountOperation

struct GtkMountOperation;

К нему нельзя обращаться напрямую. Используйте функции-аксессоры ниже.

struct GtkMountOperationClass

struct GtkMountOperationClass {
  GMountOperationClass parent_class;
};

Члены

Подробное описание свойств

Свойство “is-showing”

  “is-showing”               gboolean

Отображается ли диалог.

Владелец: GtkMountOperation

Флаги: Чтение

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

Свойство “parent”

  “parent”                   GtkWindow *

Родительское окно.

Владелец: GtkMountOperation

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

Свойство “screen”

  “screen”                   GdkScreen *

Экран, на котором будет отображено это окно.

Владелец: GtkMountOperation

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

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/gtk3-Filesystem-utilities.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API