Como: Exibir cabeçalhos de Item em um controle DataRepeater (Visual Studio)

O cabeçalho de item em um DataRepeater controle fornece um indicador visual quando um DataRepeaterItem está selecionado. Quando o LayoutStyle for definida como Vertical (padrão), o cabeçalho de item é exibido à esquerda de cada item. Quando o LayoutStyle for definida como Horizontal, o cabeçalho de item é exibido na parte superior de cada item.

Quando o primeiro estiver selecionada, o cabeçalho de item é exibido na cor especificada pelo SelectionColor propriedade e um ícone de seta branca é exibida.

Observação
Se você definir a SelectionColor para White, o símbolo de seleção não ficará visível quando pela primeira vez em que o item é selecionado.

Quando um campo na DataRepeaterItem tem o foco, a cor das alterações de cabeçalho de item para o ItemTemplate a cor de plano de fundo e as alterações do ícone de seta para preto. Se os dados são alterados, um símbolo de lápis é exibido no cabeçalho de item.

A largura padrão (ou altura quando o LayoutStyle for definida como Horizontal) do item de cabeçalho é 15 pixels. Você pode alterar a largura, definindo a ItemHeaderSize propriedade.

Observação
Se a ItemHeaderSize propriedade estiver definida como um valor que é menor que 11, os símbolos do indicador no cabeçalho de item não serão exibidos.

Você pode ocultar os cabeçalhos de item definindo a ItemHeaderVisible propriedade para False. Quando ItemHeaderVisible for definido como False, a única indicação de que um item é selecionado é uma linha pontilhada ao redor do perímetro da DataRepeaterItem.

Observação
Você também pode fornecer seu próprio indicador de seleção, monitorando o IsCurrent propriedade da DataRepeaterItem na DrawItem evento do DataRepeater de controle. Para obter mais informações, consulte IsCurrent.

Para alterar a aparência dos cabeçalhos de item

1. No Windows Forms Designer, selecione a região inferior da DataRepeater de controle.

   Observação
   Você deve selecionar a região inferior do controle. Se você selecionar a seção de modelo de item, um conjunto diferente de propriedades aparecerão na janela Propriedades.

2. Na janela Propriedades, use o SelectionColor propriedade para alterar a cor do item cabeçalhos.

   Observação
   Se você definir a SelectionColor para White, o símbolo de seleção não ficará visível quando pela primeira vez em que o item é selecionado.

3. Use o ItemHeaderSize propriedade para alterar a largura (ou altura) do item cabeçalhos.

   Observação
   Se a ItemHeaderSize propriedade estiver definida como um valor que é menor que 11, os símbolos do indicador no cabeçalho de item não serão exibidos.

Para ocultar os cabeçalhos de item

1. No Windows Forms Designer, selecione a região inferior da DataRepeater de controle.

   Observação
   Você deve selecionar a região inferior do controle. Se você selecionar a seção de modelo de item, um conjunto diferente de propriedades aparecerão na janela Propriedades.

2. Na janela Properties, defina a ItemHeaderVisible propriedade para False.

   Quando um item a DataRepeater é selecionada, a única indicação será uma linha pontilhada ao redor do perímetro da DataRepeaterItem.

Consulte também

Tarefas

Como: Alterar a aparência de um controle DataRepeater (Visual Studio)

Como: Alterar o Layout de um controle DataRepeater (Visual Studio)

Solucionando problemas de controle DataRepeater (Visual Studio)

Referência

DataRepeater

Conceitos

Introdução ao controle DataRepeater (Visual Studio)