Controles com suporte de desenho de proprietário interno

Artigo
08/01/2011

Desenho proprietário na 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" Este tópico é usado para indicar a classes que derivam de uma Control ou Component.

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

Na prática, o desenho proprietário é semelhante ao desenho de elementos gráficos em um formulário. Por exemplo, você pode usar métodos gráficos em um manipulador para o formulário Paint evento para emular um ListBox o controle, mas você precisaria escrever seu próprio código para manipular todos os interação do usuário. Com o desenho do proprietário, o controle usa o seu código para desenhar o 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 para personalizar alguns aspectos de cada item enquanto você usa a aparência padrão para outros aspectos de cada item.

Desenho do proprietário em controles do Windows Forms

Para executar os controles que dão suporte a ele de desenho proprietário, você normalmente irá definir uma propriedade e manipular eventos de um ou mais.

Esse desenho proprietário de suporte da maioria dos controles possuem uma OwnerDraw ou DrawMode propriedade que indica se o controle será elevar seu evento de desenho ou eventos quando ela pinta a mesmo.

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

Há muitos tipos diferentes de eventos de desenho, mas ocorre de 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 desenhar o proprietário. Por exemplo, este objeto normalmente contém o número de índice do item dentro da sua coleção pai, um Rectangle que indica que o item exibe limites e um Graphics o objeto para chamar métodos de pintura. Para alguns eventos, o EventArgs objeto fornece informações adicionais sobre o item e métodos que você pode chamar para pintar alguns aspectos do item por padrão, como o plano 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 ofereça suporte a desenho proprietário. Em vez de manipulação de eventos de desenho, incluir o seu código de desenho proprietário em substituições apropriadas para o OnEventName método ou métodos na nova classe. Certifique-se de que você chamar a classe base OnEventName método ou métodos neste caso para que os usuários do seu controle podem manipular eventos de desenho proprietário e fornecer personalização adicional.

Os seguintes formulários do Windows controla o proprietário de suporte de desenho em todas as versões do.NET Framework:

ListBox
ComboBox
MenuItem(usado por MainMenu and ContextMenu)
TabControl

Os seguintes controles suportam proprietário desenho somente na .NET Framework versão 2.0:

Os seguintes controles oferecem suporte a desenho proprietário e são novo no .NET Framework versão 2.0:

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

ListBox e ComboBox controles

O ListBox e ComboBox controles permitem que você desenhar itens individuais no controle de tudo em um tamanho, ou em tamanhos variados.

Observação
Embora o CheckedListBox controle é derivado de ListBox controle, não suporta desenho do proprietário.

Para desenhar cada item do mesmo tamanho, defina a DrawMode propriedade para OwnerDrawFixed e lidar com o DrawItem de evento.

Para desenhar cada item usando um tamanho diferente, defina a DrawMode propriedade para OwnerDrawVariable e lidar com ambos os MeasureItem e DrawItem eventos. O MeasureItem evento permite indicar o tamanho de um item antes de DrawItem evento ocorre para o item.

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

Componente de MenuItem

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

Para desenhar um MenuItem, defina sua OwnerDraw propriedade para true e lidar com seus DrawItem de evento. Para personalizar o tamanho do item de menu antes do DrawItem evento ocorre, lidar com o item MeasureItem de evento.