Controles com suporte Built-In Owner-Drawing

Artigo
12/20/2024

O desenho do proprietário no Windows Forms, que também é conhecido como desenho personalizado, é uma técnica para alterar a aparência visual de determinados controles.

Observação

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

Normalmente, o Windows gere o processo de desenho automaticamente usando propriedades como o BackColor para determinar a aparência de um controlo. Com o desenho do proprietário, você assume o processo de pintura, alterando elementos de aparência que não estão disponíveis usando propriedades. Por exemplo, muitos controles permitem definir a cor do texto exibido, mas você está limitado a uma única cor. O desenho do proprietário permite que você faça coisas como exibir parte do texto em preto e parte em vermelho.

Na prática, o desenho do proprietário é semelhante ao desenho gráfico em um formulário. Por exemplo, você poderia usar métodos gráficos em um manipulador para o evento Paint do formulário para emular um controle ListBox, mas você teria que escrever seu próprio código para manipular toda a interação do usuário. Com o desenho do proprietário, o controle usa seu código para desenhar seu conteúdo, mas mantém todas as suas capacidades intrínsecas. Você pode usar métodos gráficos para desenhar cada item no controle ou para personalizar alguns aspetos de cada item enquanto usa a aparência padrão para outros aspetos de cada item.

Desenho personalizado em controlos do Windows Forms

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

A maioria dos controles que suportam desenho personalizado tem uma propriedade OwnerDraw ou DrawMode que indica se o controle gerará seu evento ou eventos relacionados ao desenho quando se desenhar.

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

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

Para criar um controle reutilizável que contenha suas personalizações desenhadas pelo proprietário, crie uma nova classe que derive de uma classe de controle que ofereça suporte ao desenho do proprietário. Em vez de manipular eventos de desenho, inclua o seu código de desenho personalizado nas substituições para o(s) método(s) On EventName apropriado(s) na nova classe. Certifique-se de chamar a classe base OnEventName método ou métodos nesse caso para que os usuários do seu controle possam manipular eventos de desenho do proprietário e fornecer personalização adicional.

Os seguintes controlos do Windows Forms oferecem suporte ao desenho personalizado em todas as versões do .NET Framework:

ListBox
ComboBox
MenuItem (usado por MainMenu e ContextMenu)
TabControl

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

Os seguintes controles 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 ListBox e ComboBox

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

Observação

Embora o controlo CheckedListBox seja derivado do controlo ListBox, ele não suporta desenho proprietário.

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

Para desenhar cada item usando um tamanho diferente, defina a propriedade DrawMode como OwnerDrawVariable e manipular os eventos MeasureItem e DrawItem. O evento MeasureItem permite indicar o tamanho de um item antes que o evento DrawItem ocorra para esse item.

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

Componente MenuItem

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

Para desenhar um MenuItem, defina a sua propriedade OwnerDraw como true e manipule o seu evento DrawItem. Para personalizar o tamanho do item de menu antes que o evento DrawItem ocorra, manipule o evento MeasureItem do item.