---

(Перевёл Яныч
о всех ошибках и неточностях пишите на e-mail)

Об Этом Руководстве

---

Если Вы знакомы с более ранними версиями Фотона, то должны прочитать "Что нового в Фотоне для QNX 6.2.0", чтобы выяснить то, что изменилось в этой версии.

---

Руководство Создание Заказных Виджетов (Building Custom Widgets) сопровождает Комплект Инструментов Разработчика Фотона и предназначен для программистов Фотона, которые хотят создать заказные виджеты. Это руководство содержит все, что Вы должны знать о создании ваших собственных виджетов Фотона. Код примеров, используемый по всему этому руководству, демонстрирует новые концепции.

Когда Вы хотите:	Прейдите к
Узнать о концепциях, атрибутах и поведении виджетов	Краткий Обзор
Инициализировать класс виджета, установить структуру образца виджета, или установить ресурсы приложения	Цикл Жизни Виджета
Определить класс виджета, его ресурсы, методы или действия	Анатомия Виджета
Выбрать суперкласс виджета, на котором будет базироваться ваш заказной виджет	Использование Суперклассов Виджетов
Настроить виджет списка	Создание Виджета Списка
Настроить виджет дерева	Создание Виджета Дерева
Добавить заказной виджет к палитре виджетов PhAB	Связь Виджетов с PhAB
Управлять виджетами, используя обеспеченные удобные функции	API Библиотеки Создания Виджетов
Прочитать советы по созданию виджетов	Разные Советы по Созданию Виджетов
Просмотреть термины Фотона	Глоссарий

Что нового в Фотоне для QNX 6.2.0

Этот раздел суммирует изменения в следующих главах:

• Краткий Обзор
• Анатомия Виджета
• Создание Виджета Списка
• Создание Виджета Дерева
• API Библиотеки Создания Виджетов
• Связь Виджетов с PhAB
• Разные Советы по Созданию Виджетов

Краткий Обзор

• Закрепление теперь делается PtWidget вместо PtContainer.

Анатомия Виджета

• Раздел Записи ресурсов PtResourceRec_t включает новое специальное значение mod_f (Pt_CHANGE_CANVAS и Pt_CHANGE_CANVAS_REDRAW) и новый тип arg_value (Pt_ARG_IS_IMAGE).
• Классы виджетов теперь включают текстовое описание. Смотрите "Таблица ресурсов класса виджета."
• PtContainerChildRedirect() больше не существует; вместо нее используйте декларацию Pt_SET_CHILD_REDIRECT_F в функции создания класса вашего виджета. Смотрите "Анатомия виджета контейнера."

Создание Виджета Списка

• Изменились прототипы для PtSuperClassGenListMouse() и PtSuperClassGenListSelect().

Создание Виджета Дерева

• При расширении элемента метод Состояния Элемента Дерева возвращает ноль, чтобы разрешить расширение, или ненулевое значение, чтобы его предотвратить -- PtGenTreeExpand() возвращает это значение. При свертывании элемента метод Состояния Элемента Дерева возвращает ненулевое значение, если элемент разрушен, или ноль, если элемент все еще существует -- PtGenTreeCollapse() возвращают это значение (прототип изменился).
• PtGenTreeAddAfter() и PtGenTreeAddFirst() теперь возвращает 0 в случае успеха, или -1, если элемент уже в дереве.
• PtGenTreeFreeItems() теперь возвращает 0 в случае успеха, или -1, если элементы все еще в дереве.

Связь Виджетов с PhAB

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

API Библиотеки Создания Виджетов

Новые функции:

• PtAnchorDeregister() -- заменяет PtContainerDeregister().
• PtAnchorRegister() -- заменяет PtContainerRegister().
• PtResizeCanvas() -- подобна PtAttemptResize(), но более легкая для использования.

• PtContainerChildRedirect() больше не существует; используйте декларацию Pt_SET_CHILD_REDIRECT_F в функции создания класса вашего виджета вместо нее. Смотрите "Анатомия виджета контейнера" в главе Анатомия Виджета.
• PtGetAnchoredExtent() больше не существует; якоря обрабатываются библиотекой виджетов.
• PtInvokeResizeCallbacks() теперь пустая функция. Она предполагает, что виджет, переданный ей, контейнер.

Разные Советы по Созданию Виджетов

Были добавлены различные советы.

---

---

Источник

Все мессаги сюда:yanich@inbox.ru