Поделиться через

Элемент управления SelectionTree

  • Статья

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

Элемент управления SelectionTree автоматически публикует следующие события управления в Windows XP или более ранних операционных системах. Элемент управления SelectionTree публикует эти события, когда выбранный элемент изменяется с одного узла на другой. Если в дереве выбора нет узлов, элемент управления публикует эти события и удаляет содержимое элементов управления, которые подписываются на событие. Эти элементы ControlEvent не требуются для перечисления в таблице ControlEvent.

Событие элемента управления Description
SelectionAction Публикует строку из таблицы UIText, описывающей выделенный элемент.
SelectionBrowse Создает диалоговое окно обзора, используемое для изменения пути выделенного элемента.
SelectionDescription Публикует строку из таблицы компонентов, описывающей выделенный элемент.
SelectionNoItems Удаляет описательный текст или отключает кнопки устаревшего элемента.
SelectionPath Публикует путь для выделенного элемента.
SelectionPathOn Публикует, существует ли путь выбора, связанный с выбранной функцией.
SelectionSize Публикует размер выделенного элемента.

 

Начиная с систем Windows Server 2003, элементы управления SelectionTree публикуют все события в приведенной выше таблице и, кроме того, опубликуйте DoAction ControlEvent или SetProperty ControlEvent. Записи необходимо добавить в таблицу ControlEvent для публикации DoAction или SetProperty ControlEvents.

Событие элемента управления Description
DoAction Уведомляет установщик о выполнении пользовательского действия.
SetProperty Задает для свойства новое значение.

 

Начиная с установщика Windows версии 3.0 элементы управления SelectionTree публикуют событие, которое выполняет пользовательские действия , перечисленные в таблице ControlEvent. Элемент управления SelectionTree публикует это событие всякий раз, когда выбор компонентов изменяется в элементе управления или при выборе другого состояния выбора для текущей функции. Пользовательские действия выполняются при каждом публикации события. Элемент управления SelectionTree отправляет сведения в настраиваемое действие, задав значения следующих свойств. Все эти свойства очищаются при закрытии элемента управления SelectionTree.

Установщик Windows 2.0: не поддерживается. Элемент управления SelectionTree не публикует событие и не задает следующие свойства.

Свойство Description
MsiSelectionTreeSelectedFeature Имя выбранной функции в поле "Функция" таблицы "Компоненты".
MsiSelectionTreeSelectedAction Состояние действия установки выбранной функции. Это значение может быть INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE или INSTALLSTATE_ADVERTISED.
MsiSelectonTreeChildrenCount Число прямых дочерних узлов.
MsiSelectionTreeInstallingChildrenCount Число прямых дочерних узлов, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE или INSTALLSTATE_ADVERTISED.
MsiSelectionTreeSelectedCost Стоимость установки выбранной функции в единицах 512 байт.
MsiSelectionTreeChildrenCost Стоимость установки всех дочерних функций в единицах 512 байт.
MsiSelectionTreeSelectedPath Путь, в котором устанавливается выбранная функция. Определяется только в том случае, если компонент устанавливается как INSTALLSTATE_LOCAL.

 

Примечание.

Содержимое поля "Текст" таблицы control никогда не отображается элементом управления SelectionTree. Вместо этого это поле указывает стиль текста, отображаемого элементом управления, и содержит описание элемента управления, используемого служебными программами проверки экрана. Чтобы задать стиль шрифта и шрифта текстовой строки, префиксировать строку отображаемых символов с помощью {\style} или {&style}. Где стиль — это идентификатор, указанный в столбце TextStyle таблицы TextStyle. Если ни из них нет, но свойство DefaultUIFont определяется как допустимый текстовый стиль, используется этот шрифт. Приведенные ниже сведения считываются служебными программами проверки экрана в качестве описания элемента управления. См . специальные возможности.

 

Атрибуты элемента управления

С этим элементом управления можно использовать следующие атрибуты. Чтобы изменить значение атрибута с помощью события, подпишите элемент управления ControlEvent в таблице EventMapping и перечислите идентификатор атрибута в столбце атрибута. Введите идентификатор ControlEvent в столбце событий.

Идентификатор атрибута Шестнадцатеричный бит Description
НепрямаяpropertyName Имя косвенного свойства, связанного с элементом управления. Если задан бит косвенного атрибута, элемент управления отображает или изменяет значение свойства, имеющего это имя. Если задан бит косвенного атрибута, это имя также является значением свойства, указанного в столбце свойств таблицы Control.
Занимаемая должность Положение элемента управления в диалоговом окне. Введите ширину, высоту и координаты левого угла элемента управления в столбцы Width, Height, X и Y таблицы Control. Используйте единицы установщика для длины и расстояния.
PropertyName Имя свойства, связанного с этим элементом управления. Если бит косвенного атрибута не задан, элемент управления отображает или изменяет значение свойства, имеющего это имя. Этот атрибут указан в столбце "Свойство" таблицы Control.
PropertyValue Текущее значение свойства, отображаемое или измененное этим элементом управления. Если бит косвенного атрибута не задан, это значение PropertyName. Если задан бит непрямого атрибута, это значение IndirectPropertyName. Если атрибут изменяется, элемент управления отражает новое значение.
Text Отображает текст в экранах в соответствии с текстом, введенным в текстовый столбец таблицы Control. См . специальные возможности.
Visible 0x00000000 0x00000001
 Скрытый элемент управления. Видимый элемент управления.
Включите этот бит в битовое слово столбца "Атрибуты" в таблице Control, чтобы сделать элемент управления видимым или скрытым при его создании.
Вы также можете скрыть или показать элемент управления с помощью таблицы ControlCondition.
Включено 0x00000000 0x00000002
 Управление в отключенном состоянии. Управление включенным состоянием.
Включите этот бит в битовое слово в столбец "Атрибуты" элемента управления , чтобы включить элемент управления при создании.
Вы также можете включить или отключить элемент управления с помощью таблицы ControlCondition.
Затонувший 0x00000000 0x00000004
 Отображает визуальный стиль по умолчанию. Отображает элемент управления с 3D-изображением.
Включите эти биты в битовое слово в столбец "Атрибуты" таблицы Control.
Косвенные 0x00000000 0x00000008
 Элемент управления отображает или изменяет значение свойства в столбце "Свойство" таблицы Control. Элемент управления отображает или изменяет значение свойства, которое содержит идентификатор, указанный в столбце свойств таблицы Control.
Определяет, ссылается ли свойство, связанное с этим элементом управления, косвенно.
RTLRO 0x00000000 0x00000020
 Текст в элементе управления отображается в порядке чтения слева направо. Текст в элементе управления отображается в порядке чтения справа налево.
RightAligned 0x00000000 0x00000040
 Текст в элементе управления выровнен по левому краю. Текст в элементе управления выровнен справа.
LeftScroll 0x00000000 0x00000080
 Полоса прокрутки расположена справа от элемента управления. Полоса прокрутки расположена слева от элемента управления.
Bidi 0x000000E0 Задайте это значение для сочетания атрибутов RTLRO, RightAligned и LeftScroll .

 

Замечания

Этот элемент управления можно создать из класса WC_TREEVIEW с помощью функции CreateWindowEx. Он содержит стили WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOP и WS_GROUP.

Дерево выбора заполняется только при вызове действия CostInitialize и действия CostFinalize.

Следующая строка в таблице UIText связана с этим элементом управления.

Срок Description
AbsentPath
 Путь, отображаемый для элемента в отсутствующем состоянии.

 

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

  • SelChildCostPos
  • SelChildCostNeg
  • SelParentCostPosPos
  • SelParentCostPosNeg
  • SelParentCostNegPos
  • SelParentCostNegNeg

Следующие строки используются для отображения доступных параметров выбора элемента во всплывающем меню:

  • MenuAbsent
  • MenuLocal
  • MenuCD
  • MenuNetwork
  • MenuAllLocal
  • MenuAllCD
  • MenuAllNetwork

Следующие строки используются для объяснения текущего выбора в Элементе управления SelectionDescription ControlEvent.

  • SelAbsentAbsentAbsent
  • SelAbsentLocal
  • SelAbsentCD
  • SelAbsentNetwork
  • SelLocalAbsent
  • SelLocalLocalLocal
  • SelLocalCD
  • SelLocalNetwork
  • SelCDAbsent
  • SelNetworkAbsent
  • SelCDLocal
  • SelNetworkLocal
  • SelCDCD
  • SelNetworkNetworkNetworkNetworkWork

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

  • Байт
  • КБ
  • МБ
  • ГБ