如何：在 DataRepeater 控件中显示项标题 (Visual Studio)

更新： 2008 年 7 月

DataRepeater 控件中的项标头会在选定了某个 DataRepeaterItem 时提供直观的指示。当 LayoutStyle 属性设置为 Vertical（默认值）时，项标头会显示在每个项的左侧。当 LayoutStyle 属性设置为 Horizontal 时，项标头会显示在每个项的顶部。

首次选定项标头时，它将以 SelectionColor 属性指定的颜色显示，并且还将显示一个白色箭头图标。

说明：
如果 SelectionColor 设置为 White，当首次选定项时您将看不到选择符号。

当 DataRepeaterItem 中的某个字段具有焦点时，项标头的颜色将变为 ItemTemplate 背景颜色并且箭头图标将变为黑色。如果数据发生更改，项标头中会显示一个铅笔符号。

项标头的默认宽度（如果 LayoutStyle 属性设置为 Horizontal，则为高度）为 15 像素。可以通过设置 ItemHeaderSize 属性来更改此宽度。

说明：
如果 ItemHeaderSize 属性设置为小于 11 的值，项标头中将不会显示指示符。

可以通过将 ItemHeaderVisible 属性设置为“False”来隐藏项标头。当 ItemHeaderVisible 设置为“False”时，表示选定了某个项的唯一指示是该 DataRepeaterItem 周围的虚线。

说明：
您还可以通过在 DataRepeater 控件的 DrawItem 事件中监视 DataRepeaterItem 的 IsCurrent 属性来提供自己的选择指示符。有关更多信息，请参见 IsCurrent。

更改项标头的外观

1. 在 Windows 窗体设计器中，选择 DataRepeater 控件的下半部分区域。

   说明：
   必须选择控件的下半部分区域。如果选择项模板部分，“属性”窗口中将显示一组不同的属性。

2. 在“属性”窗口中使用 SelectionColor 属性来更改项标头的颜色。

   说明：
   如果 SelectionColor 设置为 White，当首次选定项时您将看不到选择符号。

3. 使用 ItemHeaderSize 属性来更改项标头的宽度（或高度）。

   说明：
   如果 ItemHeaderSize 属性设置为小于 11 的值，项标头中将不会显示指示符。

隐藏项标头

1. 在 Windows 窗体设计器中，选择 DataRepeater 控件的下半部分区域。

   说明：
   必须选择控件的下半部分区域。如果选择项模板部分，“属性”窗口中将显示一组不同的属性。

2. 在“属性”窗口中，将 ItemHeaderVisible 属性设置为“False”。

   当选定了 DataRepeater 中的某个项时，唯一的指示将是该 DataRepeaterItem 周围的虚线。

请参见

任务

如何：更改 DataRepeater 控件的外观 (Visual Studio)

如何：更改 DataRepeater 控件的布局 (Visual Studio)

DataRepeater 控件疑难解答 (Visual Studio)

概念

DataRepeater 控件简介 (Visual Studio)

参考

DataRepeater

修订记录

日期	History	原因
2008 年 7 月	新增主题。	SP1 功能更改。