Parameters and Values часть 3, ага

g_param_spec_string ()

GParamSpec*         g_param_spec_string                 (const gchar *name,
                                                         const gchar *nick,
                                                         const gchar *blurb,
                                                         const gchar *default_value,
                                                         GParamFlags flags);

Создаёт новый экземпляр GParamSpecString.

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

default_value :

значение по умолчанию для определённого свойства

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация параметра

g_value_set_string ()

void                g_value_set_string                  (GValue *value,
                                                         const gchar *v_string);

Устанавливает содержимое G_TYPE_STRING GValue в значение v_string.

value :

допустимая структура GValue типа G_TYPE_STRING

v_string :

string to be set

g_value_set_static_string ()

Устанавливает содержимое G_TYPE_STRING GValue в значение v_string. Строка, как предполагается, является статичной, и поэтому не дублируется при установке GValue.

value :

допустимая структура GValue типа G_TYPE_STRING

v_string :

статичная строка для установки

g_value_take_string ()

Устанавливает содержимое G_TYPE_STRING GValue в значение v_string.

value :

допустимая структура GValue типа G_TYPE_STRING

v_string :

дублируемая не имеющая владельца строка для установки

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

g_value_set_string_take_ownership ()

Внимание

g_value_set_string_take_ownership устарела начиная с версии 2.4 и не должна использоваться во вновь создаваемом коде. Вместо неё используйте g_value_take_string().

Это внутренняя функция введенная главным образом для C маршаллеров.

value :

допустимая структура GValue типа G_TYPE_STRING

v_string :

дублируемая не имеющая владельца строка для установки

g_value_get_string ()

Получает содержимое G_TYPE_STRING GValue.

value :

допустимая структура GValue типа G_TYPE_STRING

Возвращает :

строковое содержимое value

g_value_dup_string ()

Получает копию содержимого G_TYPE_STRING GValue.

value :

допустимая структура GValue типа G_TYPE_STRING

Возвращает :

вновь распределённая копия строкового содержимого value

G_IS_PARAM_SPEC_PARAM()

Определяет соответствует ли GParamSpec типу G_TYPE_PARAM_PARAM.

pspec :

допустимый экземпляр GParamSpec

G_PARAM_SPEC_PARAM()

Преобразует экземпляр GParamSpec в GParamSpecParam.

pspec :

допустимый экземпляр GParamSpec

G_VALUE_HOLDS_PARAM()

Определяет может ли полученная структура GValue содержать значения наследуемыйе из типа G_TYPE_PARAM.

value :

допустимая структура GValue

G_TYPE_PARAM_PARAM

GType из GParamSpecParam.

GParamSpecParam

Производная структура GParamSpec которая содержит метаданные для свойств G_TYPE_PARAM.

GParamSpec parent_instance;

закрытая часть GParamSpec

g_param_spec_param ()

Создаёт новый экземпляр GParamSpecParam определяющий свойство G_TYPE_PARAM.

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

param_type :

a GType derived from G_TYPE_PARAM

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация параметра

g_value_set_param ()

Устанавливает содержимое G_TYPE_PARAM GValue в значение param.

value :

допустимая структура GValue типа G_TYPE_PARAM

param :

GParamSpec для установки

g_value_take_param ()

Устанавливает содержимое G_TYPE_PARAM GValue в значение param и принимает монопольное пользование ссылкой param; вызывающий больше не сможет отменить эту ссылку.

value :

допустимая структура GValue типа G_TYPE_PARAM

param :

GParamSpec для установки

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

g_value_set_param_take_ownership ()

Внимание

g_value_set_param_take_ownership устарела начиная с версии 2.4 и не должна использоваться во вновь создаваемом коде. Вместо неё используйте g_value_take_param().

Это внутренняя функция введённая в основном для С маршаллеров.

value :

допустимая структура GValue типа G_TYPE_PARAM

param :

GParamSpec для установки

g_value_get_param ()

Получает содержимое G_TYPE_PARAM GValue.

value :

допустимая структура GValue чей тип унаследован из G_TYPE_PARAM

Возвращает :

GParamSpec содержимое value

g_value_dup_param ()

Получает содержимое G_TYPE_PARAM GValue, увеличивает количество ссылок.

value :

допустимая структура GValue чей тип унаследован из G_TYPE_PARAM

Возвращает :

GParamSpec содержимое value, ссылка должна быть отменена когда больше не нужна.

G_IS_PARAM_SPEC_BOXED()

Определяет соответствует ли полученная GParamSpec типу G_TYPE_PARAM_BOXED.

pspec :

допустимый экземпляр GParamSpec

G_PARAM_SPEC_BOXED()

Преобразует экземпляр GParamSpec в GParamSpecBoxed.

pspec :

допустимый экземпляр GParamSpec

G_VALUE_HOLDS_BOXED()

Определяет может ли полученная структура GValue содержать значения наследуемыйе из типа G_TYPE_BOXED.

value :

допустимая структура GValue

G_TYPE_PARAM_BOXED

GType из GParamSpecBoxed.

GParamSpecBoxed

Производная структура GParamSpec которая содержит метаданные для упаковочных свойств.

GParamSpec parent_instance;

закрытая часть GParamSpec

g_param_spec_boxed ()

Создаёт новый экземпляр GParamSpecBoxed определяющий производное свойство G_TYPE_BOXED.

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

boxed_type :

G_TYPE_BOXED наследуемыйй тип этого свойства

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация параметра

g_value_set_boxed ()

Устанавливает содержимое G_TYPE_BOXED derived GValue в значение v_boxed.

value :

допустимая структура GValue наследуемого типа G_TYPE_BOXED

v_boxed :

boxed значение для установки

g_value_set_static_boxed ()

Устанавливает содержимое G_TYPE_BOXED наследуемой GValue в значение v_boxed. Значение как предполагается статично, поэтому не дублируется когда устанавливается GValue.

value :

допустимая структура GValue наследуемого типа G_TYPE_BOXED

v_boxed :

статичное boxed значение для установки

g_value_take_boxed ()

Устанавливает содержимое G_TYPE_BOXED наследуемой GValue в значение v_boxed и принимает монополию использования ссылки на v_boxed; вызывающий уже не сможет отменить эту ссылку.

value :

допустимая структура GValue наследуемого типа G_TYPE_BOXED

v_boxed :

дублируемое не имеющее владельца boxed значение для установки

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

g_value_set_boxed_take_ownership ()

внимание

g_value_set_boxed_take_ownership устарела начиная с версии 2.4 и не должна использоваться во вновь создаваемом коде. Вместо неё используйте g_value_take_boxed().

Это внутренняя функция введённая в основном для С маршаллеров.

value :

допустимая структура GValue наследуемого типа G_TYPE_BOXED

v_boxed :

дублируемое не имеющее владельца boxed значение для установки

g_value_get_boxed ()

Получает содержимое G_TYPE_BOXED наследуемой GValue.

value :

допустимая структура GValue наследуемого типа G_TYPE_BOXED derived type

Возвращает :

boxed содержимое value

g_value_dup_boxed ()

Получает содержимое G_TYPE_BOXED наследуемой GValue. После получения, boxed значение дублируется и должно быть освобождено позже с помощью g_boxed_free(), например как: g_boxed_free (G_VALUE_TYPE (value), return_value);

value :

допустимая структура GValue наследуемого типа G_TYPE_BOXED

Возвращает :

boxed содержимое value

G_IS_PARAM_SPEC_POINTER()

Определяет соответствует ли GParamSpec типу G_TYPE_PARAM_POINTER.

pspec :

допустимый экземпляр GParamSpec

G_PARAM_SPEC_POINTER()

Преобразует экземпляр GParamSpec в GParamSpecPointer.

pspec :

допустимый экземпляр GParamSpec

G_VALUE_HOLDS_POINTER()

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

value :

допустимая структура GValue

G_TYPE_PARAM_POINTER

GType из GParamSpecPointer.

GParamSpecPointer

Производная структура GParamSpec которая содержит метаданные для свойств указателя.

GParamSpec parent_instance;

закрытая часть GParamSpec

g_param_spec_pointer ()

Создаёт новый экземпляр GParamSpecPoiner определяющий свойство указателя.

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация параметра

g_value_set_pointer ()

Устанавливает содержимое указателя GValue в значение v_pointer.

value :

допустимая структура GValue из G_TYPE_POINTER

v_pointer :

значение указателя для установки

g_value_get_pointer ()

Получает содержимое указателя GValue.

value :

допустимая структура GValue из G_TYPE_POINTER

Возвращает :

указатель содержащийся в value

G_IS_PARAM_SPEC_OBJECT()

Определяет соответствует ли GParamSpec типу G_TYPE_PARAM_OBJECT.

pspec :

допустимый экземпляр GParamSpec

G_PARAM_SPEC_OBJECT()

Преобразует экземпляр GParamSpec в GParamSpecObject.

pspec :

допустимый экземпляр GParamSpec

G_VALUE_HOLDS_OBJECT()

Определяет может ли полученная структура GValue содержать значения наследуемыйе из типа G_TYPE_OBJECT.

value :

допустимая структура GValue

G_TYPE_PARAM_OBJECT

GType из GParamSpecObject.

GParamSpecObject

Производная структура GParamSpec которая содержит метаданные для свойств объекта.

GParamSpec parent_instance;

закрытая часть GParamSpec

g_param_spec_object ()

Создаёт новый экземпляр GParamSpecBoxed определяющий свойство наследуемого G_TYPE_OBJECT.

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

object_type :

G_TYPE_OBJECT наследуемого типа этого свойства

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация параметра

g_value_set_object ()

Устанавливает содержимое G_TYPE_OBJECT наследуемой GValue в значение v_object.

value :

допустимая структура GValue наследуемого типа G_TYPE_OBJECT

v_object :

объектное значение для установки

g_value_take_object ()

Устанавливает содержимое G_TYPE_OBJECT наследуемой GValue в значение v_object и принимает монопольное использование ссылки на v_object; вызывающий уже не сможет отменить эту ссылку.

value :

допустимая структура GValue наследуемого типа G_TYPE_OBJECT

v_object :

объектное значение для установки

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

g_value_set_object_take_ownership ()

Внимание

g_value_set_object_take_ownership устарела начиная с версии 2.4 и не должна использоваться во вновь создаваемом коде. Вместо неё используйте g_value_take_object().

Это внутренняя функция введённая в основном для С маршаллеров.

value :

допустимая структура GValue наследуемого типа G_TYPE_OBJECT

v_object :

объектное значение для установки

g_value_get_object ()

Получает содержимое G_TYPE_OBJECT наследуемой GValue.

value :

допустимая структура GValue наследуемого типа G_TYPE_OBJECT

Возвращает :

объект содержащийся в value

g_value_dup_object ()

Получает содержимое G_TYPE_OBJECT наследуемой GValue, увеличивая количество ссылок.

value :

допустимая структура GValue чей тип унаследован из G_TYPE_OBJECT

Возвращает :

объект содержащийся в value, ссылка должна быть отменена когда больше не нужна.

G_IS_PARAM_SPEC_UNICHAR()

Определяет соответствует ли полученная GParamSpec типу G_TYPE_PARAM_UNICHAR.

pspec :

допустимый экземпляр GParamSpec

G_PARAM_SPEC_UNICHAR()

Преобразует экземпляр GParamSpec в GParamSpecUnichar.

pspec :

допустимый экземпляр GParamSpec

G_TYPE_PARAM_UNICHAR

GType из GParamSpecUnichar.

GParamSpecUnichar

Производная структура GParamSpec которая содержит метаданные для unichar (unsigned integer) properties.

GParamSpec parent_instance;

закрытая часть GParamSpec

gunichar default_value;

значение по умолчанию для определённого свойства

g_param_spec_unichar ()

Создаёт новый экземпляр GParamSpecUnichar определяющий свойство G_TYPE_UINT property. GValue structures for this property can be accessed with g_value_set_uint() and g_value_get_uint().

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

default_value :

значение по умолчанию для определённого свойства

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация параметра

G_IS_PARAM_SPEC_VALUE_ARRAY()

Определяет соответствует ли полученная GParamSpec типу G_TYPE_PARAM_VALUE_ARRAY.

pspec :

допустимый экземпляр GParamSpec

G_PARAM_SPEC_VALUE_ARRAY()

Преобразует экземпляр GParamSpec в GParamSpecValueArray.

pspec :

допустимый экземпляр GParamSpec

G_TYPE_PARAM_VALUE_ARRAY

GType из GParamSpecValueArray.

GParamSpecValueArray

Производная структура GParamSpec которая содержит метаданные для свойств GValueArray.

GParamSpec parent_instance;

закрытая часть GParamSpec

GParamSpec *element_spec;

GParamSpec описывающая элементы содержащиеся в массиве этого свойства, может быть NULL

guint fixed_n_elements;

если больше чем 0, массивы этого свойства будут все иметь это количество элементов

g_param_spec_value_array ()

Создаёт новый экземпляр GParamSpecValueArray определяющий свойство G_TYPE_VALUE_ARRAY. G_TYPE_VALUE_ARRAY это тип G_TYPE_BOXED, также к структурам GValue этого свойства можно обратиться с помощью g_value_set_boxed() и g_value_get_boxed().

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

element_spec :

GParamSpec описывающая элементы содержащиеся в массиве этого свойства, может быть NULL

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация свойства

G_IS_PARAM_SPEC_OVERRIDE()

Определяет соответствует ли GParamSpec типу G_TYPE_PARAM_OVERRIDE.

pspec :

a GParamSpec

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

G_PARAM_SPEC_OVERRIDE()

Преобразует GParamSpec в GParamSpecOverride.

pspec :

GParamSpec

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

G_TYPE_PARAM_OVERRIDE

GType из GParamSpecOverride.

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

GParamSpecOverride

Это тип GParamSpec который просто перенаправляет операции в другую спецификацию параметра. Все операции, кроме получения или установки значения, перенаправляются, включая доступное имя и описание, утверждённое значение, и так далее. Смотрите g_param_spec_get_redirect_target() поиска свойства overidden. GParamSpecOverrideиспользуется в реализации g_object_class_override_property(), и в основном полезна только при реализации нового базового типа наподобие GObject.

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

g_param_spec_override ()

Создаёт новый экземпляр свойства типа GParamSpecOverride. Используется для направления операций в другие спецификации параметра (paramspec), и в основном полезна только при реализации нового базового типа наподобие GObject.

name :

имя свойства.

overridden :

переписываемое свойство

Возвращает :

вновь созданная GParamSpec

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

G_IS_PARAM_SPEC_GTYPE()

Определяет соответствует ли GParamSpec типу G_TYPE_PARAM_GTYPE.

pspec :

a GParamSpec

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

G_PARAM_SPEC_GTYPE()

Преобразует GParamSpec в GParamSpecGType.

pspec :

GParamSpec

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

G_VALUE_HOLDS_GTYPE()

Определяет может ли GValue содержать значения типа G_TYPE_GTYPE.

value :

допустимая структура GValue

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

G_TYPE_PARAM_GTYPE

GType из GParamSpecGType.

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

GParamSpecGType

Производная структура GParamSpec которая содержит метаданные для свойства GType.

GParamSpec parent_instance;

закрытая часть GParamSpec

GType is_a_type;

GType чей подтип может использоваться как значение

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

g_param_spec_gtype ()

Создаёт новый экземпляр GParamSpecGType определяющий свойство G_TYPE_GTYPE.

Смотрите g_param_spec_internal() относительно деталей имён свойств.

name :

каноническое имя определённого свойства

nick :

псевдоним определённого свойства

blurb :

описание определённого свойства

is_a_type :

GType чей подтип доступен для использования в качестве значения свойства (используйте G_TYPE_NONE для любого типа)

flags :

флаги для определённого свойства

Возвращает :

вновь созданная спецификация параметра

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

g_value_get_gtype ()

Получает содержимое G_TYPE_GTYPE GValue.

value :

допустимая структура GValue типа G_TYPE_GTYPE

Возвращает :

GType хранящийся в value

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

g_value_set_gtype ()

Устанавливает содержимое G_TYPE_GTYPE GValue в значение v_gtype.

value :

допустимая структура GValue типа G_TYPE_GTYPE

v_gtype :

GType для установки

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

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

GParamSpec, GValue, g_object_class_install_property().

PreviousParameters and Values часть 2NextValue arrays

Last updated

Was this helpful?