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

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

Quando ele for selecionado pela primeira vez, o cabeçalho de item é exibido na cor especificada pelo SelectionColor propriedade e um ícone de seta branco é exibida.

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

Quando um campo no DataRepeaterItem tem o foco, a cor do cabeçalho o item é alterado para o ItemTemplate cor do plano de fundo e o ícone de seta é alterado para preto. Se dados forem alterados, um símbolo de lápis será exibido no cabeçalho do item.

A largura padrão (ou altura quando o LayoutStyle propriedade é conjunto para Horizontal) do item de cabeçalho é 15 pixels. Você pode alterar a largura por configuração o ItemHeaderSize propriedade.

Observação:
Se a ItemHeaderSize propriedade é conjunto para um valor é menor do que 11, símbolos indicadores no cabeçalho do item não serão exibidos.

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

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

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

1. No Designer de Formulários do Windows, selecionar a região inferior do DataRepeater controle.

   Observação:
   Você deve selecionar o menor região do controle.Se você selecionar a seção de modelo de item , um conjunto diferente de propriedades será aparecem na janela Propriedades .

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

   Observação:
   Se você conjunto o SelectionColor para White, o símbolo de seleção não ficará visível quando o item for 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 é conjunto para um valor é menor do que 11, símbolos indicadores no cabeçalho do item não serão exibidos.

Para ocultar cabeçalhos de item

1. No Designer de Formulários do Windows, selecionar a região inferior do DataRepeater controle.

   Observação:
   Você deve selecionar o menor região do controle.Se você selecionar a seção de modelo de item , um conjunto diferente de propriedades será aparecem na janela Propriedades .

2. Na janela Propriedades, defina o ItemHeaderVisible propriedade para False.

   Quando um item no DataRepeater é selecionada, a única indicação será uma linha pontilhada ao redor do perímetro das 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)

Solução de problemas do controle DataRepeater (Visual Studio)

Conceitos

Introdução ao controle DataRepeater (Visual Studio)

Referência

DataRepeater

Date	History	Motivo
Julho de 2008	Tópico adicional.	Alteração de recurso do SP1.