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á selecionada.Quando o LayoutStyle propriedade estiver definida como Vertical (padrão), o cabeçalho de item é exibido à esquerda de cada item.Quando o LayoutStyle propriedade estiver definida como Horizontal, o cabeçalho de item é exibido na parte superior de cada item.

Quando ele é selecionado pela primeira vez, 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 o item é selecionado pela primeira vez.

Quando um campo na DataRepeaterItem tem o foco, a cor das alterações de cabeçalho de item para o ItemTemplate as alterações do ícone de seta para preto e de cor de plano de fundo.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 propriedade estiver definida como Horizontal) do item de cabeçalho é de 15 pixels.Você pode alterar a largura, definindo a ItemHeaderSize propriedade.

Observação
Se a ItemHeaderSize propriedade estiver definida como um valor que seja menor do 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 da DataRepeater 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 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 será exibida na janela Propriedades.

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

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

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

   Observação
   Se a ItemHeaderSize propriedade estiver definida como um valor que seja menor do 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 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 será exibida 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)