Controles com suporte para desenho do proprietário interno

Artigo
07/07/2023

Proprietário do desenho nos Windows Forms, que é também conhecido como desenho personalizado, é uma técnica para alterar a aparência visual de certos controles.

Observação

A palavra "controle" neste tópico é usada para significar classes que derivam de um Control ou Component.

Normalmente, o Windows manipula a pintura automaticamente usando configurações de propriedade, como BackColor para determinar a aparência de um controle. Com o desenho do proprietário, assumir o processo de pintura, alterando os elementos que não estão disponíveis usando propriedades de aparência. Por exemplo, muitos controles permitem que você defina a cor do texto que é exibido, mas você está limitado a uma única cor. Desenho do proprietário permite que você faça coisas como parte do texto de exibição em preto e parte em vermelho.

Na prática, o desenho do proprietário é semelhante ao desenho de gráficos em um formulário. Por exemplo, você poderia usar métodos gráficos em um manipulador para o evento do formulário para emular um ListBox controle, mas você teria que escrever seu próprio código para lidar com toda a interação do Paint usuário. Com o desenho do proprietário, o controle usa seu código para desenhar seu conteúdo, mas caso contrário retém todos os seus recursos intrínsecos. Você pode usar métodos gráficos para desenhar cada item no controle ou personalizar alguns aspectos de cada item enquanto você usa a aparência padrão para outros aspectos de cada item.

Desenho do proprietário no Controle dos Windows Forms

Para executar o desenho do proprietário na controles que oferecem suporte a ele, você normalmente define uma propriedade e manipular um ou mais eventos.

A maioria dos controles têm de desenho do proprietário que suporte uma propriedade OwnerDraw ou DrawMode que indica se o controle será aumentará seu evento ou eventos de desenho quando ela pinta a si mesma.

Controles que não têm uma propriedade OwnerDraw ou DrawMode, incluem o DataGridView controle, que fornece eventos de desenho que ocorrem automaticamente e o ToolStrip controle, que é desenhado usando uma classe de renderização externa que tem seus próprios eventos relacionados ao desenho.

Há muitos tipos diferentes de eventos de desenho, mas ocorre um evento típico de desenho para desenhar um único item em um controle. O manipulador de eventos recebe um EventArgs objeto que contém informações sobre o item que está sendo desenhado e ferramentas que você pode usar para desenhá-lo. Por exemplo, esse objeto normalmente contém o número de índice do item dentro de sua coleção pai, um que indica os limites de exibição do item e um Rectangle Graphics objeto para chamar métodos de pintura. Em alguns casos, o EventArgs objeto fornece informações adicionais sobre o item e os métodos que você pode chamar para pintar alguns aspectos do item por padrão, como a tela de fundo ou um retângulo de foco.

Para criar um controle reutilizável que contém as personalizações desenhados pelo proprietário, crie uma nova classe que deriva de uma classe de controle que dá suporte ao desenho do proprietário. Em vez de manipular eventos de desenho, incluir o código de desenho do proprietário em substituições de método ou métodos apropriados de OnEventName na nova classe. Certifique-se de que você chamar o método ou métodos da classe base OnEventName nesse caso, para que os usuários de seu controle possam manipular eventos de desenho do proprietário e fornecer personalização adicional.

O Windows Forms a seguir controla desenho do proprietário em todas as versões do .NET Framework:

ListBox
ComboBox
MenuItem (usado por MainMenu e ContextMenu)
TabControl

Os controles a seguir oferecem suporte ao desenho do proprietário somente no .NET Framework 2.0:

Os controles a seguir oferecem suporte ao desenho do proprietário e são novos no .NET Framework 2.0:

As seções a seguir fornecem detalhes adicionais para cada um desses controles.

Controles de Caixa de Combinação e Caixa de listagem

Os ListBox controles e ComboBox permitem que você desenhe itens individuais no controle em um único tamanho ou em tamanhos variados.

Observação

Embora o CheckedListBox controle seja derivado do controle, ele não oferece suporte ao ListBox desenho do proprietário.

Para desenhar cada item do mesmo tamanho, defina a DrawMode propriedade como OwnerDrawFixed e manipule o DrawItem evento.

Para desenhar cada item usando um tamanho diferente, defina a DrawMode propriedade e OwnerDrawVariable manipule os MeasureItem eventos e DrawItem . O evento MeasureItem permite indicar o tamanho de um item antes do evento DrawItem ocorrer para aquele item.

Para obter mais informações, incluindo exemplos de código, consulte os seguintes tópicos:

Componente do MenuItem

O MenuItem componente representa um único item de menu em um MainMenu ou ContextMenu componente.

Para desenhar um MenuItem, defina sua OwnerDraw propriedade como true e manipule seu DrawItem evento. Para personalizar o tamanho do item de menu antes do evento DrawItem ocorrer, identifique os eventos MeasureItem do item.