Controles con soporte para Built-In Owner-Drawing

2025-05-07

El dibujo propietario en Windows Forms, que también se conoce como dibujo personalizado, es una técnica para cambiar el aspecto de ciertos controles.

Nota:

La palabra "control" de este tema se usa para significar clases que derivan de Control o Component.

Normalmente, Windows controla la pintura automáticamente mediante la configuración de propiedades como BackColor para determinar la apariencia de un control. Con el dibujo del propietario, se toma el proceso de pintura, cambiando los elementos de apariencia que no están disponibles mediante propiedades. Por ejemplo, muchos controles permiten establecer el color del texto que se muestra, pero se limita a un solo color. El dibujo del propietario le permite hacer cosas como mostrar parte del texto en negro y parte en rojo.

En la práctica, el dibujo del propietario es similar al dibujo de gráficos en un formulario. Por ejemplo, podría usar métodos gráficos en un controlador para el evento del Paint formulario para emular un ListBox control, pero tendría que escribir su propio código para controlar toda la interacción del usuario. Con el dibujo del propietario, el control utiliza tu código para dibujar su contenido, pero conserva todas sus capacidades intrínsecas. Puede usar métodos gráficos para dibujar cada elemento en el control o para personalizar algunos aspectos de cada elemento mientras usa la apariencia predeterminada para otros aspectos de cada elemento.

Dibujo personalizado en controles de Windows Forms

Para realizar el dibujo del propietario en los controles que lo admiten, normalmente establecerá una propiedad y controlará uno o varios eventos.

La mayoría de los controles que admiten el dibujo personalizado por el propietario tienen una propiedad OwnerDraw o DrawMode que indica si el control generará su evento o eventos relacionados con el dibujo cuando se pinta a sí mismo.

Los controles que no tienen una OwnerDraw propiedad o DrawMode incluyen el DataGridView control , que proporciona eventos de dibujo que se producen automáticamente y el ToolStrip control , que se dibuja mediante una clase de representación externa que tiene sus propios eventos relacionados con el dibujo.

Hay muchos tipos diferentes de eventos de dibujo, pero se produce un evento de dibujo típico para dibujar un solo elemento dentro de un control. El controlador de eventos recibe un EventArgs objeto que contiene información sobre el elemento que se dibuja y las herramientas que se pueden usar para dibujarlo. Por ejemplo, este objeto normalmente contiene el número de índice del elemento dentro de su colección principal, un Rectangle que indica los límites de presentación del elemento y un objeto Graphics para invocar métodos de pintura. Para algunos eventos, el EventArgs objeto proporciona información adicional sobre el elemento y los métodos a los que se puede llamar para pintar algunos aspectos del elemento de forma predeterminada, como el fondo o un rectángulo de foco.

Para crear un control reutilizable que contenga las personalizaciones dibujadas por el propietario, cree una nueva clase que derive de una clase de control que admita el dibujo del propietario. En lugar de controlar eventos de dibujo, incluya el código de dibujo personalizado en las sobrescrituras para el método o métodos OnEventName adecuados en la nueva clase. Asegúrese de llamar al método On, o métodos, EventName de la clase base en este caso para que los usuarios del control puedan manejar eventos de dibujo personalizado y proporcionar personalización adicional.

Los siguientes controles de Windows Forms admiten el dibujo de propietario en todas las versiones de .NET Framework:

ListBox
ComboBox
MenuItem (usado por MainMenu y ContextMenu)
TabControl

Los controles siguientes solo admiten el dibujo de propietario en .NET Framework 2.0:

Los siguientes controles admiten el dibujo del propietario y son nuevos en .NET Framework 2.0:

En las secciones siguientes se proporcionan detalles adicionales para cada uno de estos controles.

Controles ListBox y ComboBox

Los controles ListBox y ComboBox te permiten dibujar elementos individuales en el control, ya sea todos en un solo tamaño o en diferentes tamaños.

Nota:

Aunque el CheckedListBox control se deriva del ListBox control , no admite el dibujo del propietario.

Para dibujar cada elemento del mismo tamaño, establezca la propiedad DrawMode a OwnerDrawFixed y maneje el evento DrawItem.

Para dibujar cada elemento con un tamaño diferente, establezca la propiedad DrawMode a OwnerDrawVariable y maneje tanto los eventos MeasureItem como DrawItem. El MeasureItem evento le permite indicar el tamaño de un elemento antes de que se produzca el DrawItem evento para ese elemento.

Para obtener más información, incluidos ejemplos de código, consulte los temas siguientes:

Componente MenuItem

El componente MenuItem representa un único elemento de menú en un componente MainMenu o ContextMenu.

Para dibujar un MenuItem, establezca la propiedad OwnerDraw en true y gestione el evento DrawItem. Para personalizar el tamaño del elemento de menú antes de que se produzca el DrawItem evento, controle el evento del MeasureItem elemento.