DimensionCombo

Иерархия наследования

Описание

Компонент DimensionCombo предназначен для отображения элементов справочника в виде раскрывающегося списка.

Работа с компонентом

Отметка элементов компонента осуществляется при щелчке как по пиктограмме элемента, так и по самому элементу либо нажатием клавиши ПРОБЕЛ. Источником данных для компонента DimensionCombo является компонент UiDimension.

При двойном щелчке по разделительной линии колонок будет осуществляться автоматический подгон по ширине колонки, расположенной слева. Ширина подгоняется с учетом всех элементов, которые могут содержаться у вершины (наличие экспандера, флажка, пиктограммы и пиктограммы состояния, текста вершины).

Примечание. Размеры раскрывающегося списка элементов можно изменять, перетаскивая его правую, левую или нижнюю границы при помощи мыши. Минимальная ширина раскрывающегося списка равна ширине компонента.

В редакторе компонента по умолчанию отображается информация об отметке элементов. За автоматическое обновление этой информации отвечает свойство AutoUpdateInfo. Для отображения пользовательских данных в редакторе компонента необходимо изменить базовое свойство Text.

Поиск элементов

При развернутом раскрывающемся списке компонента предусмотрены следующие виды поиска:

При наборе первых символов в наименовании элементов курсор будет переходить к первому найденному элементу. Данный поиск осуществляется циклически и только по элементам, присутствующим в развернутой части иерархии дерева элементов.
При помощи строки поиска, которая вызывается при нажатии клавиш F3 либо CTRL+F. После ввода искомой части слова и нажатии клавиши ENTER либо кнопки будет осуществляться поиск. Поиск осуществляется циклически по всей иерархии элементов.

При удачном поиске курсор будет фокусироваться на найденном элементе. Состояние отметки зависит от значения свойства FindMode. В зависимости от выбранного режима множественной отметки добавление элемента в отметку осуществляется выделением с использованием клавиши ПРОБЕЛ либо выделением с помощью мыши при зажатой клавише CTRL.

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

Отметка элементов осуществляется так же, как было описано выше, в зависимости от установленного значения свойства SelectionMode. После закрытия данного окна отметка будет применена в компоненте.

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

Сортировка данных

Необходимым условием для сортировки данных является установка свойствам ShowColumnHeaders, Sorted и ColumnClick значения True, и свойству SortType значения, отличного от None.

В режиме выполнения формы для сортировки данных по какому-либо столбцу необходимо щелкнуть по заголовку данного столбца. При этом все данные будут отсортированы по возрастанию значений. Повторные щелчки будут вызывать смену направления сортировки. Для мультисортировки необходимо зажать клавишу CTRL и щелкнуть по заголовкам необходимых столбцов. Порядок сортировки будет определяться следующим образом: столбец, по заголовку которого был осуществлен последний щелчок, будет отсортирован в последнюю очередь.

Также осуществить настройку сортировки можно в специализированном окне «Сортировка»:

Данное окно появляется при выборе соответствующего пункта контекстного меню, вызываемого в области заголовков колонок.

Примечание. Пункт контекстного меню будет доступен, если свойствам ShowColumnHeaders и Sorted установлено значения True, а свойству SortType значение, отличное от None.

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

В языке Fore для применения сортировки необходимо установить свойству Sorted значение True и свойству SortType значение, отличное от None. Колонка, по данным которой осуществляется сортировка, указывается в свойстве SortColumn. Направление сортировки определяется в свойстве SortAscending соответствующего столбца.

Также для управления сортировкой могут применяться методы Sort и SortDefault.

Отображение нескольких атрибутов справочника

По умолчанию в компоненте отображаются значения атрибута с назначением - «Наименование». Для отображения других атрибутов необходимо свойству ShowColumnHeaders установить значение True и настроить коллекцию столбцов компонента. Для настройки коллекции нажмите кнопку в области свойства Columns или выполните пункт контекстного меню «Колонки». По умолчанию список колонок соответствует списку атрибутов в структуре справочника. Для столбцов, которые должны отображаться, установите в свойстве Visible значение True. По умолчанию значение этого свойства выставляется в соответствии со значением свойства Visible (Hidden для справочников НСИ) атрибута, с которым связан столбец.

Пример

Свойства компонента DimensionCombo

	Имя свойства	Краткое описание
	Align	Свойство Align определяет, как поведет себя компонент при изменении размеров содержащего его родительского компонента.
	AllowDrag	Свойство AllowDrag определяет возможность взять у компонента перетаскиваемый объект.
	AllowDrop	Свойство AllowDrop определяет, будет ли возможность у компонента принять перетаскиваемый объект.
	Anchors	Свойство Anchors возвращает настройки, определяющие в процентном соотношении изменение размеров текущего компонента при изменении размеров родительского компонента.
	AnimationType	Свойство AnimationType определяет тип анимации, применяемый при разворачивании списка компонента.
	AutoCheckParent	Свойство AutoCheckParent определяет, будет ли у родительских вершин компонента автоматически устанавливаться неопределенное состояние, если отмечены не все дочерние элементы.
	AutoExpandDepth	Свойство AutoExpandDepth определяет номер уровня измерения, который будет автоматически разворачиваться при запуске формы на выполнение.
	AutoUpdateInfo	Свойство AutoUpdateInfo определяет признак автоматического обновления информации об отметке в редакторе компонента.
	BorderStyle	Свойство BorderStyle определяет стиль границы компонента.
	Brush	Свойство Brush определяет кисть, используемую для заливки области компонента.
	CancelOnEscape	Свойство CancelOnEscape определяет, будет ли производиться отмена установленной отметки и закрытие списка при нажатии клавиши ESC.
	Checkboxes	Свойство Checkboxes определяет видимость флагов у элементов компонента.
	Checked	Свойство Checked определяет признак установки флага у элемента измерения.
	CheckState	Свойство CheckState определяет состояние вершины измерения.
	ClientHeight	Свойство ClientHeight используется для получения или задания высоты клиентской области компонента.
	ClientWidth	Свойство ClientWidth используется для получения или задания ширины клиентской области компонента.
	CloseOnClick	Свойство CloseOnClick определяет, будет ли производиться автоматическое закрытие списка при выборе одного элемента из этого списка.
	CloseOnEnter	Свойство CloseOnEnter определяет, будет ли производиться закрытие списка и сохранение отметки при нажатии клавиши ENTER.
	Color	Свойство Color определяет цвет фона компонента.
	ColumnClick	Свойство ColumnClick определяет возможность отображения заголовков столбцов в виде кнопок.
	Columns	Свойство Соlumns возвращает коллекцию столбцов компонента.
	ComponentCount	Свойство ComponentCount возвращает количество дочерних компонентов.
	Components	Свойство Components возвращает дочерний компонент.
	Cursor	Свойство Cursor определяет вид курсора над компонентом.
	CustomMultiselectText	Свойство CustomMultiselectText определяет признак использования пользовательского шаблона для формирования текста компонента при множественной отметке.
	CustomMultiselectTextTemplate	Свойство CustomMultiselectTextTemplate определяет шаблон, в соответствии с которым будет формироваться текст компонента при множественной отметке.
	Data	Свойство Data предназначено для хранения любых пользовательских данных.
	Dimension	Свойство Dimension определяет наименование компонента UiDimension , который будет являться источником данных для компонента.
	DimGroup	Свойство DimGroup определяет группу элементов справочника, на базе которой будет строиться дерево элементов в компоненте.
	DimUpdateTimer	Свойство DimUpdateTimer определяет задержку между выделением элементов и сменой отметки в измерении.
	Dropped	Свойство Dropped возвращает видимость раскрывающегося списка.
	DroppedListHeight	Свойство DroppedListHeight определяет высоту раскрывающегося списка компонента.
	DroppedListWidth	Свойство DroppedListWidth определяет ширину раскрывающегося списка компонента.
	DroppedPopupMenu	Свойство DroppedPopupMenu определяет контекстное меню, вызываемое в области раскрывающегося списка компонента.
	DropTargetNode	Свойство DropTargetNode определяет индекс элемента измерения, который подсвечен.
	Enabled	Свойство Enabled определяет доступность компонента для пользователя.
	EnableFindDialog	Свойство EnableFindDialog определяет, будет ли вызываться стандартный диалог поиска элементов при нажатии сочетания клавиш CTRL+F или F3.
	FindMode	Свойство FindMode определяет режим отметки найденных элементов.
	FilterStyle	Свойство FilterStyle определяет режим построения дерева отфильтрованных элементов.
	FindEditVisible	Свойство FindEditVisible определяет признак отображения строки поиска при развернутом раскрывающемся списке компонента.
	Focused	Свойство Focused возвращает True, если фокус установлен на данном компоненте.
	FocusedElement	Свойство FocusedElement определяет индекс элемента измерения, на котором установлен фокус.
	Font	Свойство Font определяет множество характеристик, описывающих шрифт, используемый при отображении текста.
	GridLines	Свойство GridLines определяет, будет ли отображаться сетка.
	Height	Свойство Height определяет высоту компонента.
	HelpContext	Свойство HelpContext определяет уникальный индекс раздела контекстно-зависимой справки для данного компонента.
	HideSelection	Свойство HideSelection определяет признак отображения отметки в компоненте при передаче фокуса другому компоненту.
	Hint	Свойство Hint определяет текст подсказки для компонента.
	HotTrack	Свойство HotTrack определяет признак выделения подчеркиванием элемента, над которым проходит указатель мыши.
	HotTrackAutoExpand	Свойство HotTrackAutoExpand определяет признак изменения состояния дерева дочерних элементов при щелчке по выделенному элементу.
	Images	Свойство Images определяет имя компонента ImageList , изображения которого будут использоваться в компоненте.
	Left	Свойство Left определяет координату левого края компонента.
	Locked	Свойство Locked определяет возможность изменения отметки элементов в компоненте.
	Name	Свойство Name определяет наименование компонента.
	OwnSelection	Свойство OwnSelection определяет необходимость создания копии массива выделения.
	Parent	Свойство Parent определяет родительский компонент.
	ParentColor	Свойство ParentColor определяет, будет ли для компонента заимствован цвет родительского компонента.
	ParentFont	Свойство ParentFont определяет, будет ли для компонента использоваться шрифт родительского компонента.
	ParentShowHint	Свойство ParentShowHint определяет условие отображения всплывающей подсказки.
	PopupMenu	Свойство PopupMenu определяет контекстное меню, которое будет появляться по щелчку дополнительной кнопки мыши на компоненте.
	RowSelect	Свойство RowSelect определяет необходимость выделения выбранного элемента подсветкой всей строки.
	Scrolls	Свойство Scrolls возвращает параметры полос прокрутки компонента.
	Selection	Свойство Selection определяет отметку элементов в измерении.
	SelectionMode	Свойство SelectionMode определяет режим отметки элементов в компоненте.
	ShowButtons	Свойство ShowButtons разрешает или запрещает показ кнопок разворачивания и сворачивания дерева потомков вершин.
	ShowColumnHeaders	Свойство ShowColumnHeaders определяет, будут ли отображаться заголовки столбцов.
	ShowEditImage	Свойство ShowEditImage определяет признак отображения пиктограммы элемента в редакторе компонента.
	ShowHint	Свойство ShowHint включает и выключает показ всплывающего окна подсказки для компонента.
	ShowHints	Свойство ShowHints определяет, будет ли появляться подсказка при задержке мыши над одним из элементов компонента.
	ShowLines	Свойство ShowLines определяет, будет ли отображаться линия, соединяющая вершину с ее потомками.
	ShowRoot	Свойство ShowRoot определяет, будут ли отображаться кнопки сворачивания и разворачивания корней деревьев.
	ShowSystemHints	Свойство ShowSystemHints определяет, будет ли отображаться системная всплывающая подсказка для различных элементов компонента.
	SortColumn	Свойство SortColumn определяет индекс столбца, по которому будет осуществляться сортировка.
	Sorted	Свойство Sorted определяет возможность сортировки по столбцу, указанному в свойстве SortColumn .
	SortType	Свойство SortType определяет тип сортировки для компонента.
	TabOrder	Свойство TabOrder определяет позицию компонента в последовательности табуляции.
	TabStop	Свойство TabStop определяет признак необходимости компоненту получать фокус при нажатии кнопки «TAB».
	Tag	Свойство Tag не используется компилятором. Пользователь может изменить значение свойства Tag и использовать его по своему усмотрению.
	Text	Свойство Text определяет строку, идентифицирующую компонент для пользователя.
	Top	Свойство Top определяет координату верхнего края компонента.
	Visible	Свойство Visible определяет видимость компонента во время выполнения.
	Width	Свойство Width определяет ширину компонента.

Методы компонента DimensionCombo

	Имя метода	Краткое описание
	AdjustDroppedListWidth	Метод AdjustDroppedListWidth осуществляет подгонку ширины раскрывающегося списка компонента.
	AdjustWidth	Метод AdjustWidth осуществляет автоматический подгон ширины колонки с учетом её содержимого.
	BringToFront	Метод BringToFront располагает компонент на передний план.
	ClientToScreen	Метод ClientToScreen преобразовывает координаты точки, указанные относительно системы координат компонента, в экранные координаты.
	Collapse	Метод Collapse осуществляет сворачивание иерархии потомков дерева.
	DoDragDrop	Метод DoDragDrop позволяет начать операцию перетаскивания.
	DropDown	Метод DropDown осуществляет разворачивание списка элементов компонента.
	Expand	Метод Expand осуществляет разворачивание иерархии потомков дерева.
	GetCheckedNodes	Метод GetCheckedNodes возвращает коллекцию элементов, отмеченных флагом.
	GetImage	Метод GetImage возвращает графическое изображение компонента со всеми дочерними компонентами.
	GetItemAt	Метод GetItemAt осуществляет проверку наличия элемента в заданной точке клиентской области компонента.
	HitTest	Метод HitTest осуществляет проверку наличия элемента в заданной точке клиентской области компонента и возвращает результат проверки.
	MakeVisible	Метод MakeVisible позволяет сделать видимым конкретный элемент.
	RollUp	Метод RollUp осуществляет сворачивание раскрывающегося списка.
	ScreenToClient	Метод ScreenToClient преобразовывает экранные координаты точки в координаты, указываемые относительно системы координат компонента.
	SendToBack	Метод SendToBack располагает компонент на задний план.
	SetFocus	Метод SetFocus устанавливает фокус на данный компонент.
	Sort	Метод Sort выполняет сортировку по значениям указанного столбца.
	SortDefault	Метод SortDefault выполняет сортировку по значениям столбца, индекс которого указан в свойстве SortColumn .
	UpdateInfo	Метод UpdateInfo производит обновление информации об отметке элементов.

События компонента DimensionCombo

	Имя события	Краткое описание
	OnBeginDrag	Событие OnBeginDrag для компонента наступает, когда пользователь начинает перетаскивать объект от компонента.
	OnChecked	Событие OnChecked наступает после изменения состояния отметки флага элемента.
	OnChecking	Событие OnChecking наступает перед изменением состояния отметки флага элемента.
	OnClick	Событие OnClick наступает, если пользователь осуществил щёлкнул в области компонента.
	OnCollapsed	Событие OnCollapsed наступает после свертывания иерархии потомков вершины дерева.
	OnCollapsing	Событие OnCollapsing наступает начале свертывания иерархии потомков вершины дерева.
	onColumnClick	Событие OnColumnClick наступает при щелчке кнопкой мыши по одному из столбцов компонента.
	OnCompareItems	Событие OnCompareItems наступает при сравнении двух элементов во время пользовательской сортировки элементов.
	OnDblClick	Событие OnDblClick наступает, если пользователь дважды щёлкнул в области компонента.
	OnDragDrop	Событие OnDragDrop для компонента наступает, когда пользователь отпускает над ним перетаскиваемый объект.
	OnDragEnter	Событие OnDragEnter наступает, когда перетаскиваемый объект входит в область данного компонента.
	OnDragLeave	Событие OnDragLeave наступает, когда перетаскиваемый объект выходит за границы данного компонента.
	OnDragOver	Событие OnDragOver для компонента наступает, когда пользователь протаскивает над ним перетаскиваемый объект.
	OnDropDown	Событие OnDropDown наступает при разворачивании списка компонента.
	OnEnter	Событие OnEnter наступает в момент получения фокуса компонентом.
	OnExit	Событие OnExit наступает в момент потери фокуса компонентом.
	OnExpanded	Событие OnExpanded наступает после развертывания иерархии потомков вершины дерева.
	OnExpanding	Событие OnExpanding наступает непосредственно перед развертыванием иерархии потомков вершины дерева.
	OnFocusedChanged	Событие OnFocusedChanged наступает при передаче фокуса другому элементу компонента.
	OnGetHint	Событие OnGetHint наступает при появлении подсказки над элементом, где остановился курсор мыши.
	OnGetNodeImage	Событие OnGetNodeImage используется при определении изображения возле элемента дерева.
	OnHover	Событие OnHover наступает в момент прохождения курсора мыши над элементом и отметки подчеркиванием элемента компонента.
	OnHScroll	Событие OnHScroll наступает при изменении положения ползунка горизонтальной полосы прокрутки.
	OnKeyDown	Событие OnKeyDown наступает, если компонент находится в фокусе и производится нажатие на клавиатуру.
	OnKeyPress	Событие OnKeyPress наступает, если компонент находится в фокусе, при нажатии пользователем символьной клавиши.
	OnKeyPreview	Событие OnKeyPreview наступает перед каждым событием, связанным с нажатием клавиш.
	OnKeyUp	Событие OnKeyUp наступает, если компонент находится в фокусе, при отпускании пользователем любой, ранее нажатой клавиши.
	OnMouseDown	Событие OnMouseDown наступает, если указатель находится в области компонента и была нажата любая кнопка мыши.
	OnMouseEnter	Событие OnMouseEnter наступает в момент входа курсора мыши в область компонента.
	OnMouseHover	Событие OnMouseHover наступает при задержке курсора мыши в области компонента.
	OnMouseLeave	Событие OnMouseLeave наступает в момент выхода курсора мыши за пределы области компонента.
	OnMouseMove	Событие OnMouseMove наступает при перемещении курсора мыши над компонентом.
	OnMouseUp	Событие OnMouseUp наступает при отпускании кнопки мыши, когда указатель находится в области компонента.
	OnMouseWheel	Событие OnMouseWheel наступает, если компонент находится в фокусе при вращении колеса мыши.
	OnRollUp	Событие OnRollUp наступает при сворачивании списка компонента.
	OnSelectionChanged	Событие OnSelectionChanged наступает при изменении отметки элементов компонента.
	OnVScroll	Событие OnVScroll наступает при изменении положения ползунка вертикальной полосы прокрутки.

См. также:

Компоненты доступа к данным