Руководство программиста в Photon (1037671), страница 32

Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла (страница 32)

PtSetResources(ABW_shapes_cbox, 1, args);

Установка того же ресурса функцией PtSetResource() выглядит так:

PtSetResource(ABW_shapes_cbox, Pt_ARG_BEVEL_WIDTH, 5, 0);

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

Получение ресурсов

С получением более чем одного значения ресурсов связано два шага:

• Установка списка аргументов с использованием макроса PtSetArg()

• Получение значения с использованием функции PtGetResources().

Если Вы получаете один ресурс, проще использовать функцию PtGetResource() – Вам не надо устанавливать список аргументов. См. раздел "Получение одного ресурса" ниже. Имеется два метода получения ресурсов: один, связанный с указателями, и второй, с ними не связанный. "Безуказательный" метод обычно проще и безопаснее:

• Так как Вы получаете копию значения, шансы нечаянно переписать настоящее значение уменьшаются.

• Вам не надо заботиться о типе значения (short или long)

• У Вас имеется небольшое количество локальных переменных и Вы не используете указатели на них, что делает Ваш исходный код легче для восприятия и помогает компилятору генерировать лучший код.

Метод с указателями может быть менее запутанным., если Вы получаете значения одновременно нескольких ресурсов; Вы будете иметь именованные указатели на значения, вместо того, чтобы помнить, какой элемент из списка аргументов какому соответствует ресурсу.

Не используя указатели

Если Вы установили в ноль значения аргументов value и len при вызове PtSetArg(), функция PtGetResources() возвращает значение ресурса (преобразованное в long) следующим образом:

Ресурсы scalar и flags (безуказательный метод)

Чтобы получить скалярный или флаговый ресурс (любого допустимого в С типа) безуказательным методом, выполните следующее:

unsigned long getscalar( PtWidget_t *widget, long type ) {

/* Получение любого вида скаляра */

PtArg_t arg;

PtSetArg( &arg, type, 0, 0 );

PtGetResources( widget, 1, &arg );

return arg.value;

}

Ресурс string (безуказательный метод)

Вот как используется безуказательный метод для получения строчного ресурса:

const char *getstr2( PtWidget_t *widget, long type ) {

PtArg_t arg;

PtSetArg( &arg, type, 0, 0 );

PtGetResources( widget, 1, &arg );

return (char*) arg.value;

}

Ресурс boolean (безуказательный метод)

При безуказательном методе получения булевского значения это значение (0 или 1) возвращается в аргументе value функции PtSetArg():

int getbool( PtWidget_t *widget, long type ) {

PtArg_t arg;

PtSetArg( &arg, type, 0, 0 );

PtGetResources( widget, 1, &arg );

return arg.value;

}

Использование указателей

Когда для получения скалярного ресурса, массива или ресурса флага используется указательный метод, виджет всегда помещает указатель во внутренней структуре данных виджета. В элементе списка аргументов, который Вы устанавливаете использованием функции PtSetArg(), Вы должны предоставить адрес переменной, задаваемый указателем внутренних данных.

Четвёртый аргумент в большинстве типов ресурсов не используется. Для массивов это является адресом указателя, который возвращается из PtGetResources(), указывая на число входов.

Например, чтобы получить содержимое ресурса Pt_ARG_FLAGS (которое есть long) для виджета, Вы должны передать адрес указателя как long:

const long *flags;

PtArg_t arg[1];

PtSetArg(&arg[0], Pt_ARG_FLAGS, &flags, 0);

PtGetResources(ABW_label, 1, arg);

PtGetResources() возвращает указатели напрямую во внутреннюю память виджета. Не пытайтесь модифицировать ресурсы, непосредственно используя эти указатели. Такая модификация не будет иметь ожидаемого эффекта и вероятно приведёт к ошибкам поведения виджета. Также никогда не освобождайте эти указатели – результатом этого наверняка станет ошибка нарушения памяти или иная подобная ошибка.

Использование указателей const поможет избегнуть этих проблем.

Изменение состояния виджета может сделать эти указатели недействительными; используйте их сразу же.

Если Вы хотите получить значение данного ресурса и затем модифицировать это значение:

1. Получите ресурс

2. Скопируйте ресурс во временную переменную

3. Модифицируйте временную переменную

4. Используя модифицированную копию, установите ресурс

Вы можете использовать полученное значение, чтобы установить значение другого ресурса этого или любого другого виджета, пока Вы не изменили оригинального значения. Например, Вы можете использовать следующий код, чтобы получить Pt_ARG_TEXT_STRING, текстовую строку, отображаемую на виджете типа label с именем label:

char *str;

PtArg_t args[1];

PtSetArg(&args[0], Pt_ARG_TEXT_STRING, &str, 0);

PtGetResources(ABW_label, 1, args);

Вы можете затем установить эту текстовую строку для другого виджета типа label по имени label2:

PtSetArg(&args[0], Pt_ARG_TEXT_STRING, str, 0);

PtSetResources(ABW_label2, 1, args);

Ресурсы scalar и flag (указательный метод)

Если Вы получаете скалярный ресурс или ресурс флага, используя метод указателя:

• Аргумент value в PtSetArg() является адресом указателя на соответствующий тип языка С.

• len не используется.

Когда вызывается функция PtGetResources(), указатель для этого ресурса устанавливается указывающим на внутреннее хранилище виджета.

Вот некоторые функции, которые получают ресурс scalar или flag, используя метод указателя:

unsigned long getlong( PtWidget_t *widget, long type ) {

/* Получение long или long флагов */

PtArg_t arg; unsigned long const *result;

PtSetArg( &arg, type, &result, 0 );

PtGetResources( widget, 1, &arg );

return *result;

}

unsigned getshort( PtWidget_t *widget, long type ) {

/* Получение short или short флагов */

PtArg_t arg; unsigned short const *result;

PtSetArg( &arg, type, &result, 0 );

PtGetResources( widget, 1, &arg );

return *result;

}

unsigned getbyte( PtWidget_t *widget, long type ) {

/* Получение char или char флагов */

PtArg_t arg; unsigned char const *result;

PtSetArg( &arg, type, &result, 0 );

PtGetResources( widget, 1, &arg );

return *result;

}

Ресурсы string (указательный метод)

Если Вы получаете строковые ресурсы, используя метод указателя:

• Аргумент value в PtSetArg() является адресом указателя на char

• len не используется.

Когда вызывается PtGetResources(), задаваемый указатель для строкового ресурса устанавливается указывающим на внутреннее хранилище виджета. Например:

const char *getstr1( PtWidget_t *widget, long type ) {

PtArg_t arg; const char *str;

PtSetArg( &arg, type, &str, 0 );

PtGetResources( widget, 1, &arg );

return str;

}

Ресурсы alloc (указательный метод)

Если Вы получаете ресурс размещения, используя метод указателя:

• Аргумент value в PtSetArg() является адресом соответствующего типа (тип определяется по данным, отдаваемым виджету при его установке)

• len не используется.

Когда вызывается PtGetResources(), задаваемый указатель устанавливается указывающим на внутренние данные виджета.

Ресурсы image (указательный метод)

Если Вы получаете ресурсы образа, используя метод указателя:

• Аргумент value в PtSetArg() является адресом указателя на структуру типа PhImage_t

• len не используется.

Когда вызывается PtGetResources(), задаваемый указатель устанавливается указывающим на внутренние данные виджета.

Ресурсы array (указательный метод)

Если Вы получаете ресурсы массива, используя метод указателя:

• Аргумент value в PtSetArg() является адресом указателя соответствующего типа языка С (первый из двух типов языка С, данный в таблице "Новые ресурсы").

• len является адресом указателя на данный второй тип языка С.

Когда вызывается PtGetResources():

• Указатель, задаваемый в value, устанавливается указывающим на начало массива во внутреннем хранилище виджета.

• Указатель, задаваемый в len, устанавливается указывающим на счётчик элементов массива во внутреннем хранилище виджета.

Ресурсы pointer (указательный метод)

Если Вы получаете ресурсы указателя, используя метод указателя:

• Аргумент value в PtGetArg() является адресом указателя соответствующего типа языка С.

• len не используется.

Когда вызывается PtGetResources(), задаваемый указатель устанавливается указывающим на те же данные, что и внутренний указатель виджета. Данные являются внешними по отношению к виджету; Вы можете модифицировать их в зависимости от ресурса.

Ресурсы link (указательный метод)

Если Вы получаете ресурсы связанного списка, используя метод указателя:

• Аргумент value в PtSetArg() является адресом указателя на списочную структуру типа PtLinkedList_t. Эта структура содержит по меньшей мере:

struct Pt_linked_list _*next указатель на следующий пункт списка;

char data[1] адрес данных, хранящихся в списке;

• len не используется.

Когда вызывается PtGetResources(), указатель, заданный в value, устанавливается указывающим на первый узел связанного списка во внутренних данных виджета.

 Если Вы получаете ресурс ответной реакции, аргумент value в PtSetArg() является адресом указателя на структуру типа PtCallbackList_t. Для получения более полной информации см. раздел "Проверка ответных реакций" в главе "Управление виджетами в исходном коде приложения".

Ресурсы struct (указательный метод)

Если Вы получаете ресурсы структуры, используя метод указателя:

• Аргумент value в PtSetArg() является адресом указателя соответствующего типа языка С.

• len не используется.

Когда вызывается функция PtGetResources(), заданный указатель для ресурса структуры устанавливается указывающим на внутреннее хранилище виджета.

Ресурсы boolean (указательный метод)

Если Вы получаете булевский ресурс, используя метод указателя:

• Аргумент value в PtSetArg() является указателем на int.

• len не используется.

Когда вызывается функция PtGetResources(), int устанавливается в 1, если булевское значение "истина", или в 0, если "ложь". Например, чтобы получить значение ресурса Pt_ARG_CURSOR_OVERRIDE в виджете типа PtContainer:

PtArg_t arg;

int bool_value;

PtSetArg( &arg[0], Pt_ARG_CURSOR_OVERRIDE, &bool_value, 0 );

PtGetResources (ABW_container, 1, arg);

if ( bool_value ) {

/* Курсор контейнера перекрывает курсор своих детей. */

}

Вызов функции PtGetResources()

Используйте функцию PtGetResources(), чтобы получить значения каждого ресурса, определённого в списке аргументов:

int PtGetResources(PtWidget_t _*widget, int n_args, PtArg_t _*args);

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

PtGetResources() возвращает 0 в случае успеха или –1, если случается ошибка. Возврат кода, равного –1, может указывать на то, что Вы пытаетесь получить значение ресурса, который для виджета не определён.

Получение одного ресурса

Если Вы получаете значение одного ресурса, проще использовать вместо функции PtGetResources() функцию PtGetResource(). Для функции PtGetResource() Вам нет необходимости устанавливать список аргументов. Аргументами PtGetResource() являются:

int PtGetResource (PtWidget_t _*widget, long type, long value, long len);

widget – это указатель на виджет, ресурс которого мы получаем. Другие аргументы устанавливаются точно так же, как и в PtSetArg(), когда с использованием указательного метода получаете более одного ресурса.

Характеристики

Список файлов учебной работы