Элементы управления с поддержкой Built-In Owner-Drawing

Статья
12/18/2024

Пользовательская отрисовка в Windows Forms, также известная как собственная отрисовка, является техникой изменения визуального вида определенных элементов управления.

Заметка

Слово "control" в этом разделе используется для обозначения классов, производных от Control или Component.

Как правило, Windows автоматически обрабатывает рисование с помощью параметров свойств, таких как BackColor для определения внешнего вида элемента управления. При использовании пользовательского рисунка вы управляете процессом рисования, изменяя элементы внешнего вида, которые недоступны с помощью свойств. Например, многие элементы управления позволяют задать цвет отображаемого текста, но вы ограничены одним цветом. Рисунок владельца позволяет выполнять такие действия, как отображение части текста в черном и красном цвете.

На практике рисунок владельца аналогичен рисованию графики на форме. Например, можно использовать графические методы в обработчике для события Paint формы, чтобы эмулировать элемент управления ListBox, но вам придется писать собственный код для обработки всего взаимодействия с пользователем. Когда используется рисование владельцем, элемент управления использует ваш код для рисования содержимого, но при этом сохраняет все свои встроенные возможности. Графические методы можно использовать для рисования каждого элемента в элементе управления или настройки некоторых аспектов каждого элемента при использовании внешнего вида по умолчанию для других аспектов каждого элемента.

Пользовательская отрисовка в элементах управления Windows Forms

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

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

Элементы управления, которые не имеют свойства OwnerDraw или DrawMode, включают элемент управления DataGridView, предоставляющий события рисования, которые происходят автоматически, и элемент управления ToolStrip, который рисуется с помощью внешнего класса отрисовки с собственными событиями, связанными с рисованием.

Существует множество различных типов событий рисования, но обычное событие рисования организуется для прорисовки какого-либо элемента в элементе управления. Обработчик событий получает объект EventArgs, содержащий сведения о рисуемом элементе и средствах, которые можно использовать для рисования. Например, этот объект обычно содержит номер индекса элемента в родительской коллекции, Rectangle, указывающий границы отображения элемента, а также объект Graphics для вызова методов рисования. Для некоторых событий объект EventArgs предоставляет дополнительные сведения о элементе и методах, которые можно вызвать для рисования некоторых аспектов элемента по умолчанию, таких как фон или прямоугольник фокуса.

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

Следующие элементы управления Windows Forms поддерживают рисование владельца во всех версиях .NET Framework:

ListBox
ComboBox
MenuItem (используется MainMenu и ContextMenu)
TabControl

Следующие элементы управления поддерживают рисование владельца только в .NET Framework 2.0:

Следующие элементы управления поддерживают рисование владельца и являются новыми в .NET Framework 2.0:

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

Элементы управления ListBox и ComboBox

Элементы управления ListBox и ComboBox позволяют рисованию отдельных элементов в элементе управления либо в одном размере, либо в различных размерах.

Заметка

Хотя элемент управления CheckedListBox является производным от элемента управления ListBox, он не поддерживает рисование владельца.

Чтобы нарисовать каждый элемент одинакового размера, задайте для свойства DrawMode значение OwnerDrawFixed и обработать событие DrawItem.

Чтобы нарисовать каждый элемент разного размера, задайте для свойства DrawMode значение OwnerDrawVariable и обрабатывайте события MeasureItem и DrawItem. Событие MeasureItem позволяет указать размер элемента перед событием DrawItem для этого элемента.

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

Компонент MenuItem

Компонент MenuItem представляет один пункт меню в компоненте MainMenu или ContextMenu.

Чтобы нарисовать MenuItem, задайте свойству OwnerDraw значение true и обработайте событие DrawItem. Чтобы настроить размер элемента меню перед событием DrawItem, обработайте событие MeasureItem элемента.