10. Глава 5. Создание виджетов в PhAb

Как только Вы создали или открыли приложение, Вы, вероятно, захотите добавить, удалить или модифицировать виджеты. Эта глава описывает, как работать с виджетами. Она включает:

• Типы виджетов

• Имена экземпляров

• Создание виджета

• Выбор виджетов

• Выравнивание виджетов

• Общепользовательский доступ (CUA) и обработка фокусирования

• Выстраивание виджетов

• Перетаскивание виджетов

• Установка x и y координат для виджетов

• Перемещение виджетов между контейнерами

• Изменение размеров виджетов и модулей

• Буфер обмена

• Дублирование виджетов и контейнеров

• Удаление виджетов

• Импортирование графических файлов

• Изменение классов виджетов

• Шаблоны

 Для получения более полной информации по использованию специфических классов виджетов, см.

• Приложение "Обзор виджетов" в этом руководстве

• "Справочник по виджетам".

Поскольку виджеты наследуют кучу свойств от своих родительских классов, Вам стоит познакомиться с фундаментальными классами: PtWidget, PtBasic, PtContainer и прочая.

1. Типы виджетов

Существуют два основных типа виджетов:

• Контейнерные виджеты, такие как PtWindow и PtScrollContainer

• Неконтейнерные виджеты, такие как PtButton и PtText.

Виджеты контейнерного класса могут содержать другие виджеты, в том числе другие контейнеры. Виджеты, расположенные внутри контейнера, известны как порождённые виджеты; иерархия, возникающая в результате такой компоновки, называется семейством виджетов. Контейнерные виджеты могут заботиться о задании размеров и позиционировании своих потомков, как описано в главе "Управление геометрией".

Работая с виджетами контейнерного класса в PhAB, помните следующее:

• если Вы перемещаете контейнер, все виджеты, порождённые контейнером, также перемещаются

• если Вы помещаете указатель внутрь контейнера, когда создаёте новый виджет, этот виджет иерархически будет размещён внутри контейнера

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

• нажать <Alt> перед тем как начать окаймлять

• начать окаймление внутри контейнера.

Для получения более полной информации см. раздел "Выбор виджетов" в этой главе.

2. Имена экземпляров

Если Ваша программа взаимодействует с виджетом, этот виджет должен иметь уникальное имя экземпляра. Используя это имя, PhAB генерирует глобальную переменную и декларацию, позволяющую Вам легко получить доступ к виджету из Вашего программного кода.

Чтобы просмотреть или отредактировать имя экземпляра виджета, используйте область "Widget Instance Name" в верхней части панели управления ресурсами или ответными реакциями:

1. Редактирование имени экземпляра виджета

	Имя экземпляра виджета используется для создания нескольких переменных языка С, так что оно может включать только буквы, цифры и символы подчёркивания. PhAB не позволит Вам использовать какие-либо другие символы. Имя экземпляра не может быть длиннее чем 64 символа.
	Вам имеет смысл разработать соглашение по именам для всех виджетов Вашего приложения – это сделает легче управляемыми большие приложения.

Вы можете (что необязательно) включить имя экзепляра в память виджета. См. раздел "Включение имён экземпляров" в главе "Работа с приложениями".