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

  • Статья

Элемент управления DirectoryList отображает часть пути, который в настоящее время отображается в элементе управления PathEdit. Элемент управления DirectoryList отображает папки под каталогом, отображаемым элементом управления DirectoryCombo.

Элементы управления PathEdit, DirectoryCombo и DirectoryList связаны с тем же строковым значением свойства. Это свойство — путь, выбранный пользователем. Введите имя свойства в столбец "Свойство" таблицы Control. Это свойство должно иметь начальное значение, содержащее по крайней мере один том и один вложенный. Укажите начальное значение свойства в столбце Value таблицы Свойств.

Этот элемент управления предназначен для использования в диалоговом окне обзора вместе с элементом управления PathEdit и DirectoryList.

Элемент управления DirectoryList публикует следующие элементы ControlEvents.

ControlEvent Description
DirectoryListNew Создает новую папку и выбирает поле имени для редактирования.
IgnoreChange Выделяется, но не открывается папка в текущем каталоге.
DirectoryListUp Выбирает родительский элемент текущего каталога.
DirectoryListOpen Выбирает и выделяет каталог.

Содержимое текстового поля таблицы Control никогда не отображается элементом управления DirectoryList. Вместо этого это поле указывает стиль текста, отображаемого элементом управления, и содержит описание элемента управления, используемого служебными программами проверки экрана. Чтобы задать стиль шрифта и шрифта текстовой строки, префиксировать строку отображаемых символов с помощью {\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_LISTVIEW с помощью функции CreateWindowEx. Он содержит стили LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP и WS_TABSTOP.

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