GtkExpression

GtkExpressionNotify ()

void
(*GtkExpressionNotify) (gpointer user_data);

Обратный вызов, вызываемый gtk_expression_watch(), когда значение выражения изменяется.

gtk_expression_ref ()

GtkExpression *
gtk_expression_ref (GtkExpression *self);

Получает ссылку на заданный GtkExpression.

gtk_expression_unref ()

void
gtk_expression_unref (GtkExpression *self);

Освобождает ссылку на заданный GtkExpression.

Если ссылка была последней, ресурсы, связанные с self, освобождаются.

gtk_expression_get_value_type ()

GType
gtk_expression_get_value_type (GtkExpression *self);

Получает GType, к которому вычисляется это выражение. Этот тип является постоянным и не изменится на протяжении всего жизненного цикла этого выражения.

gtk_expression_is_static ()

gboolean
gtk_expression_is_static (GtkExpression *self);

Проверяет, является ли выражение статическим.

Статическое выражение никогда не изменит свой результат при вызове gtk_expression_evaluate() с теми же аргументами.

Это означает, что вызов gtk_expression_watch() не нужен, так как он никогда не вызовет уведомление.

gtk_expression_evaluate ()

gboolean
gtk_expression_evaluate (GtkExpression *self,
                         gpointer this_,
                         GValue *value);

Вычисляет заданное выражение и при успехе сохраняет результат в value . Тип GType value будет типом, указанным в gtk_expression_get_value_type().

Возможны ситуации, когда выражение не может быть вычислено — например, когда выражение ссылается на объекты, которые были уничтожены или установлены в состояние NULL. В этом случае value останется пустым, и будет возвращено FALSE.

gtk_expression_watch ()

GtkExpressionWatch *
gtk_expression_watch (GtkExpression *self,
                      gpointer this_,
                      GtkExpressionNotify notify,
                      gpointer user_data,
                      GDestroyNotify user_destroy);

Устанавливает наблюдение за заданным expression, которое вызывает функцию notify всякий раз, когда вычисление self может измениться.

GTK не гарантирует, что вычисление действительно изменилось, когда вызывается notify, но гарантирует обратное: когда оно действительно изменилось, вызов notify будет произведен.

gtk_expression_bind ()

GtkExpressionWatch *
gtk_expression_bind (GtkExpression *self,
                     gpointer target,
                     const char *property,
                     gpointer this_);

Связывает свойство target с именем property объекта self.

Значение, вычисляемое выражением self, устанавливается с помощью g_object_set() объекта target. Эта операция повторяется всякий раз, когда изменяется self, для обеспечения синхронизации свойства объекта с self.

Если вычисление self завершится неудачно, свойство target, property, не будет обновлено. Для предотвращения этого можно использовать резервное выражение.

Обратите внимание, что эта функция принимает во владение self. Если вам нужно сохранить его, необходимо gtk_expression_ref() его заранее.

gtk_expression_watch_ref ()

GtkExpressionWatch *
gtk_expression_watch_ref (GtkExpressionWatch *watch);

Получает ссылку на заданный GtkExpressionWatch.

gtk_expression_watch_unref ()

void
gtk_expression_watch_unref (GtkExpressionWatch *watch);

Освобождает ссылку на заданный GtkExpressionWatch.

Если эта ссылка была последней, ресурсы, связанные с self, освобождаются.

gtk_expression_watch_evaluate ()

gboolean
gtk_expression_watch_evaluate (GtkExpressionWatch *watch,
                               GValue *value);

Вычисляет наблюдаемое выражение и в случае успеха сохраняет результат в value.

Это эквивалентно вызову gtk_expression_evaluate() с выражением и указателем this, первоначально используемыми для создания watch.

gtk_expression_watch_unwatch ()

void
gtk_expression_watch_unwatch (GtkExpressionWatch *watch);

Прекращает наблюдение за выражением, установленным с помощью gtk_expression_watch().

gtk_property_expression_new ()

GtkExpression *
gtk_property_expression_new (GType this_type,
                             GtkExpression *expression,
                             const char *property_name);

Создаёт выражение, которое ищет свойство через заданный expression или аргумент this, когда expression равно NULL.

Если полученный объект соответствует this_type, будет запрошено свойство с именем property_name. В противном случае вычисление выражения завершится неудачей.

Указанный this_type должен иметь свойство с типом property_name.

gtk_property_expression_new_for_pspec ()

GtkExpression *
gtk_property_expression_new_for_pspec (GtkExpression *expression,
                                       GParamSpec *pspec);

Создаёт выражение, которое ищет свойство через заданный expression или аргумент this, когда expression равно NULL.

Если полученный объект соответствует this_type, будет запрошено свойство, указанное с помощью pspec. В противном случае вычисление выражения завершится неудачей.

gtk_property_expression_get_expression ()

GtkExpression *
gtk_property_expression_get_expression
                               (GtkExpression *expression);

Получает выражение, определяющее объект выражения свойства.

gtk_property_expression_get_pspec ()

GParamSpec *
gtk_property_expression_get_pspec (GtkExpression *expression);

Получает GParamSpec, определяющий свойство выражения свойства.

gtk_constant_expression_new ()

GtkExpression *
gtk_constant_expression_new (GType value_type,
                             ...);

Создаёт GtkExpression, который вычисляет объект, заданный аргументами.

gtk_constant_expression_new_for_value ()

GtkExpression *
gtk_constant_expression_new_for_value (const GValue *value);

Создаёт выражение, которое всегда вычисляет заданный value .

gtk_constant_expression_get_value ()

const GValue *
gtk_constant_expression_get_value (GtkExpression *expression);

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

gtk_object_expression_new ()

GtkExpression *
gtk_object_expression_new (GObject *object);

Создаёт выражение, вычисляющее заданный object со слабой ссылкой. После удаления object вычисление завершится ошибкой. Это выражение предназначено для разрыва циклов ссылок.

Если вы хотите сохранить ссылку на object , используйте gtk_constant_expression_new().

gtk_object_expression_get_object ()

GObject *
gtk_object_expression_get_object (GtkExpression *expression);

Получает объект, к которому вычисляется выражение.

gtk_closure-expression-new ()

GtkExpression *
gtk_closure_expression_new (GType value_type,
                            GClosure *closure,
                            guint n_params,
                            GtkExpression **params);

Создаёт GtkExpression, который вызывает closure при вычислении. closure вызывается с объектом this и результатами вычисления params выражений.

gtk_cclosure_expression_new ()

GtkExpression *
gtk_cclosure_expression_new (GType value_type,
                             GClosureMarshal marshal,
                             guint n_params,
                             GtkExpression **params,
                             GCallback callback_func,
                             gpointer user_data,
                             GClosureNotify user_destroy);

Эта функция является вариантом gtk_closure_expression_new(), которая создаёт GClosure вызвав g_cclosure_new() с заданными callback_func, user_data и user_destroy.

GTK_VALUE_HOLDS_EXPRESSION()

#define GTK_VALUE_HOLDS_EXPRESSION(value)       (G_VALUE_HOLDS ((value), GTK_TYPE_EXPRESSION))

Возвращает TRUE если value была инициализирована с помощью GTK_TYPE_EXPRESSION.

gtk_value_set_expression ()

void
gtk_value_set_expression (GValue *value,
                          GtkExpression *expression);

Сохраняет заданный GtkExpression в value.

Значение GValue получит ссылку на expression.

gtk_value_take_expression ()

void
gtk_value_take_expression (GValue *value,
                           GtkExpression *expression);

Сохраняет заданный GtkExpression в value.

Эта функция передает владение expression в GValue.

gtk_value_get_expression ()

GtkExpression *
gtk_value_get_expression (const GValue *value);

Возвращает GtkExpression, хранящийся в заданном value.

gtk_value_dup_expression ()

GtkExpression *
gtk_value_dup_expression (const GValue *value);

Возвращает GtkExpression, хранящийся в заданном value, и получает на него ссылку.

gtk_param_spec_expression ()

GParamSpec *
gtk_param_spec_expression (const char *name,
                           const char *nick,
                           const char *blurb,
                           GParamFlags flags);

Создаёт новый экземпляр GParamSpec для свойства, содержащего GtkExpression.

См. g_param_spec_internal() для получения подробной информации о строках свойства.