ListView: Компонент

Компонент ListView предназначен для показа и выбора нескольких элементов.

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

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

Работа с коллекцией элементов осуществляется посредством свойства Items.

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

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

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

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

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

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

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

Выбор столбцов

Если для компонента свойства Style = Report и ShowColumnHeaders = True, то в режиме выполнения возможна настройка отображения столбцов. Настройка производится с помощью контекстного меню, вызываемого для заголовка таблицы.

Контекстное меню содержит список всех столбцов компонента. Для включения/отключения отображения столбца следует установить /снять флажок напротив него.

При выборе пункта «Выбрать столбцы» будет открыт диалог:

Для включения/отключения столбца следует установить/снять флажок напротив него. Для отметки/снятия всех установленных флажков следует использовать кнопку «Отметить все»/«Снять отметку». Для задания порядка столбцов в таблице следует использовать кнопки, расположенные в окне справа: вверх, вниз, на уровень вверх.

Особенности использования

В виду особенностей реализации компонента при наведении курсора мыши на элемент событие OnGetHint будет генерироваться два раза.

Пример

Свойства, унаследованные от IListView

	Имя свойства	Краткое описание
	Arrangement	Свойство Arrangement определяет способ выравнивания элементов в компоненте.
	AutoArrange	Свойство AutoArrange определяет, будут ли элементы автоматически располагаться правильными рядами при изменении их количества.
	BorderStyle	Свойство BorderStyle определяет стиль рамки, обрамляющей компонент.
	Checkboxes	Свойство Checkboxes определяет признак наличия флагов у элементов компонента.
	ColumnClick	Свойство ColumnClick определяет возможность отображения заголовков столбцов в виде кнопок.
	Columns	Свойство Columns возвращает коллекцию заголовков компонента.
	FocusedItem	Свойство FocusedItem определяет элемент компонента, содержащий фокус.
	GridLines	Свойство GridLines определяет, будут ли отображаться линии сетки.
	HeaderMenu	Свойство HeaderMenu определяет контекстное меню, вызываемое по щелчку дополнительной кнопки мыши на заголовке колонки компонента.
	HideSelection	Свойство HideSelection определяет признак отображения отметки в компоненте при передаче фокуса другому компоненту.
	HighlightTrack	Свойство HighlightTrack определяет, подсвечивать ли элемент при наведении указателя мыши.
	HotTrackStyles	Свойство HotTrackStyles определяет стиль подсветки элементов, над которыми проходит указатель мыши.
	HoverTime	Свойство HoverTime определяет промежуток времени, по истечении которого элемент, над которым проходит курсор мыши, будет подсвечиваться.
	ItemHeight	Свойство ItemHeight определяет высоту элементов компонента.
	Items	Свойство Items возвращает коллекцию элементов компонента.
	LargeImages	Свойство LargeImages определяет источник крупных пиктограмм.
	MultiSelect	Свойство MultiSelect определяет возможность множественной отметки элементов списка.
	ReadOnly	Свойство ReadOnly определяет возможность внесения каких-либо изменений в список.
	RowSelect	Свойство RowSelect определяет необходимость выделения выбранного элемента подсветкой всей строки.
	SelectedCount	Свойство SelectedCount возвращает количество выделенных в компоненте элементов.
	SelectedItem	Свойство SelectedItem определяет выделенный элемент компонента.
	ShowColumnHeaders	Свойство ShowColumnHeaders определяет, будут ли отображаться заголовки столбцов.
	ShowHeaderButton	Свойство ShowHeaderButton определяет, отображается ли кнопка вызова меню заголовков столбцов.
	ShowHints	Свойство ShowHints определяет, будет ли появляться всплывающая подсказка при задержке курсора мыши над элементами.
	SmallImages	Свойство SmallImages определяет источник маленьких пиктограмм.
	SortColumn	Свойство SortColumn определяет индекс колонки, по которой осуществляется сортировка.
	SortType	Свойство SortType определяет тип сортировки для компонента.
	StateImages	Свойство StateImages определяет список изображений, используемых для индикации состояния элементов.
	Style	Свойство Style определяет стиль отображения элементов компонента.
	TrackSelect	Свойство TrackSelect определяет, будет ли отмечаться элемент компонента при удержании над ним курсора мыши.
	WrapText	Свойство WrapText определяет, будет ли возможность переноса текста элемента на несколько строк, если он выходит за границы пиктограммы.

Свойства, унаследованные от IControl

	Имя свойства	Краткое описание
	Align	Свойство Align определяет выравнивание компонента в рамках содержащего его родительского компонента.
	AllowDrag	Свойство AllowDrag определяет возможность взять у компонента перетаскиваемый объект.
	AllowDrop	Свойство AllowDrop определяет, будет ли возможность у компонента принять перетаскиваемый объект.
	Anchors	Свойство Anchors возвращает настройки, определяющие в процентном соотношении изменение размеров текущего компонента при изменении размеров родительского компонента.
	Brush	Свойство Brush определяет кисть, используемую для заливки области компонента.
	ClientHeight	Свойство ClientHeight определяет высоту клиентской области компонента.
	ClientWidth	Свойство ClientWidth определяет ширину клиентской области компонента.
	Color	Свойство Color определяет цвет фона компонента.
	Cursor	Свойство Cursor определяет вид курсора, отображаемого при наведении курсора мыши на компонент, во время выполнения формы.
	Enabled	Свойство Enabled определяет доступность компонента для пользователя.
	Focused	Свойство Focused возвращает True, если фокус установлен на данном компоненте.
	Font	Свойство Font определяет параметры шрифта, используемого при отображении текста в компоненте.
	Height	Свойство Height определяет высоту компонента в пикселях.
	HelpContext	Свойство HelpContext определяет уникальный индекс раздела контекстно-зависимой справки для данного компонента.
	Hint	Свойство Hint определяет текст подсказки, появляющийся при задержке указателя мыши над компонентом.
	HintTimeout	Свойство HintTimeout определяет время отображения всплывающей подсказки.
	Left	Свойство Left определяет координату левого края компонента в пикселях.
	Parent	Свойство Parent определяет родительский компонент.
	ParentColor	Свойство ParentColor определяет, будет ли для компонента заимствован цвет родительского компонента.
	ParentFont	Свойство ParentFont определяет, будет ли для компонента использоваться шрифт родительского компонента.
	ParentShowHint	Свойство ParentShowHint определяет условие отображения всплывающей подсказки.
	PopupMenu	Свойство PopupMenu определяет контекстное меню, которое будет появляться по щелчку правой кнопки мыши на компоненте.
	Scrolls	Свойство Scrolls возвращает параметры полос прокрутки компонента.
	ShowHint	Свойство ShowHint определяет, будет ли показываться всплывающая подсказка при задержке курсора мыши над компонентом.
	TabOrder	Свойство TabOrder определяет позицию компонента в последовательности табуляции.
	TabStop	Свойство TabStop определяет признак необходимости компоненту получать фокус при нажатии кнопки «Tab».
	Text	Свойство Text определяет строку, идентифицирующую компонент для пользователя.
	Top	Свойство Top определяет координату верхнего края компонента в пикселях.
	Visible	Свойство Visible определяет видимость компонента во время выполнения формы.
	Width	Свойство Width определяет горизонтальный размер компонента в пикселях.

Свойства, унаследованные от IComponent

Методы, унаследованные от IListView

Методы, унаследованные от IControl

События

	Имя события	Краткое описание
	OnChecked	Событие OnChecked наступает после отметки элемента списка.
	OnChecking	Событие OnChecking наступает, когда пользователь начинает отмечать элемент списка.
	OnColumnClick	Событие OnColumnClick наступает при щелчке по заголовку одного из столбцов компонента.
	OnComparelItems	Событие OnCompareItems наступает при сравнении двух элементов, во время сортировки в колонке компонента.
	OnDeletion	Событие OnDeletion происходит при удалении элемента компонента.
	OnEdited	Событие OnEdited наступает при выходе из режима редактирования содержимого поля текущей записи компонента.
	OnEditing	Событие OnEditing наступает при переходе в режим редактирования текущего элемента компонента.
	OnFocusChange	Событие OnFocusChange происходит при передаче фокуса другому элементу компонента.
	OnFocusChanging	Событие OnFocusChanging наступает перед сменой фокуса у элемента компонента.
	OnGetHint	Событие OnGetHint наступает при появлении подсказки у элемента, над которым остановился курсор мыши.
	OnHover	Событие OnHover наступает в момент прохождения курсора мыши над элементом и отметки подчеркиванием элемента компонента.
	OnInsert	Событие OnInsert происходит при вставке нового элемента компонента.
	OnSelectingItem	Событие OnSelectingItem наступает перед изменением отметки у элемента компонента.
	OnSelectItem	Событие OnSelectItem наступает при изменении отметки у элемента компонента.

События, унаследованные от IControl

	Имя события	Краткое описание
	OnBeginDrag	Событие OnBeginDrag для компонента наступает, когда пользователь начинает перетаскивать объект от компонента.
	OnClick	Событие OnClick наступает, если пользователь щёлкнул в области компонента.
	OnControlMove	Событие OnControlMove наступает при перемещении компонента.
	OnControlResize	Событие OnControlResize наступает при изменении размеров у компонента.
	OnDblClick	Событие OnDblClick наступает, если пользователь дважды щёлкнул в области компонента.
	OnDragDrop	Событие OnDragDrop для компонента наступает, когда пользователь отпускает над ним перетаскиваемый объект.
	OnDragEnter	Событие OnDragEnter наступает, когда перетаскиваемый объект входит в область данного компонента.
	OnDragLeave	Событие OnDragLeave наступает, когда перетаскиваемый объект выходит за границы данного компонента.
	OnDragOver	Событие OnDragOver для компонента наступает, когда пользователь протаскивает над ним перетаскиваемый объект.
	OnEnter	Событие OnEnter наступает в момент получения фокуса компонентом.
	OnExit	Событие OnExit наступает в момент потери фокуса компонентом.
	OnHScroll	Событие OnHScroll наступает при изменении положения ползунка горизонтальной полосы прокрутки.
	OnKeyDown	Событие OnKeyDown наступает, если компонент находится в фокусе и производится нажатие на клавиатуру.
	OnKeyPress	Событие OnKeyPress наступает, если компонент находится в фокусе, при нажатии пользователем символьной клавиши.
	OnKeyPreview	Событие OnKeyPreview наступает перед каждым событием, связанным с нажатием клавиш.
	OnKeyUp	Событие OnKeyUp наступает, если компонент находится в фокусе, при отпускании пользователем любой, ранее нажатой клавиши.
	OnMouseDown	Событие OnMouseDown наступает, если указатель находится в области компонента и была нажата любая кнопка мыши.
	OnMouseEnter	Событие OnMouseEnter наступает в момент входа курсора мыши в область компонента.
	OnMouseHover	Событие OnMouseHover наступает при задержке курсора мыши в области компонента.
	OnMouseLeave	Событие OnMouseLeave наступает в момент выхода курсора мыши за пределы области компонента.
	OnMouseMove	Событие OnMouseMove наступает при перемещении курсора мыши над компонентом.
	OnMouseUp	Событие OnMouseUp наступает при отпускании кнопки мыши, когда указатель находится в области компонента.
	OnMouseWheel	Событие OnMouseWheel наступает, если компонент находится в фокусе при вращении колеса мыши.
	OnVScroll	Событие OnVScroll наступает при изменении положения ползунка вертикальной полосы прокрутки.

	Имя свойства	Краткое описание
	ComponentCount	Свойство ComponentCount возвращает количество дочерних компонентов, расположенных на родительском компоненте.
	Components	Свойство Components возвращает дочерний компонент, индекс которого передается посредством входного параметра.
	Data	Свойство Data предназначено для хранения любых пользовательских данных.
	Name	Свойство Name определяет наименование компонента.
	Tag	Свойство Tag не используется компилятором. Пользователь может изменить значение данного свойства и использовать его по своему усмотрению.

	Имя метода	Краткое описание
	AdjustWidth	Метод AdjustWidth осуществляет автоматический подгон ширины колонки с учетом её содержимого.
	GetItemAt	Метод GetItemAt позволяет получить элемент компонента в заданной точке.
	HitTest	Метод HitTest является расширением метода GetItemAt.
	InsertControl	Метод InsertControl осуществляет вставку компонента в область элементов компонента.

	Имя метода	Краткое описание
	ClientToScreen	Метод ClientToScreen преобразовывает координаты точки, указанные относительно системы координат компонента, в экранные координаты.
	DoDragDrop	Метод DoDragDrop позволяет начать операцию перетаскивания.
	GetImage	Метод GetImage возвращает графическое изображение компонента со всеми дочерними компонентами.
	ScreenToClient	Метод ScreenToClient преобразовывает экранные координаты точки в координаты, указываемые относительно системы координат компонента.
	SetFocus	Метод SetFocus устанавливает фокус на данный компонент.

ListView

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

Описание