DataRepeaterItem 类
用于使 DataRepeater 控件显示数据在运行时。
继承层次结构
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.Panel
Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
命名空间: Microsoft.VisualBasic.PowerPacks
程序集: Microsoft.VisualBasic.PowerPacks.Vs(在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)
语法
声明
<DockingAttribute(DockingBehavior.Never)> _
Public Class DataRepeaterItem _
Inherits Panel
[DockingAttribute(DockingBehavior.Never)]
public class DataRepeaterItem : Panel
[DockingAttribute(DockingBehavior::Never)]
public ref class DataRepeaterItem : public Panel
[<DockingAttribute(DockingBehavior.Never)>]
type DataRepeaterItem =
class
inherit Panel
end
public class DataRepeaterItem extends Panel
DataRepeaterItem 类型公开以下成员。
构造函数
名称 | 说明 | |
---|---|---|
DataRepeaterItem | 初始化 DataRepeaterItem 对象的新实例。 |
页首
属性
名称 | 说明 | |
---|---|---|
AccessibilityObject | 获取分配给控件的 AccessibleObject 。 | |
AccessibleDefaultActionDescription | 获取或设置控件的默认操作说明,供辅助功能客户端应用程序使用。 | |
AccessibleDescription | 获取或设置可访问性客户端应用程序使用控件的说明。 | |
AccessibleName | 获取或设置可访问性客户端应用程序使用控件的名称。 | |
AccessibleRole | 获取或设置控件的可访问的角色。 | |
AllowDrop | 获取或设置一个值,该值指示控件是否可以接受用户拖放到它上面的数据。 (继承自 Control。) | |
Anchor | 基础结构。DataRepeater 控件在内部用于 DataRepeaterItem 对象公开数据在运行时。ItemTemplate 的设置确定数据的显示方式。 | |
AutoScroll | 获取或设置一个值,该值指示容器是否允许用户滚动到任何放置在其可见边界之外的控件。 (继承自 ScrollableControl。) | |
AutoScrollMargin | 获取或设置自动滚动边距的大小。 (继承自 ScrollableControl。) | |
AutoScrollMinSize | 获取或设置自动滚动的最小尺寸。 (继承自 ScrollableControl。) | |
AutoScrollOffset | 获取或设置一个值,该值指示在 ScrollControlIntoView 中将控件滚动到何处。 (继承自 Control。) | |
AutoScrollPosition | 获取或设置自动滚动定位的位置。 (继承自 ScrollableControl。) | |
AutoSize | 获取或设置一个值,该值指示控件是否基于其内容调整大小。 (继承自 Panel。) | |
AutoSizeMode | 指示控件的自动调整大小行为。 (继承自 Panel。) | |
BackColor | 获取或设置控件的背景色。 (继承自 Control。) | |
BackgroundImage | 获取或设置在控件中显示的背景图像。 (继承自 Control。) | |
BackgroundImageLayout | 获取或设置在 ImageLayout 枚举中定义的背景图像布局。 (继承自 Control。) | |
BindingContext | 获取或设置控件的 BindingContext。 (继承自 Control。) | |
BorderStyle | 指示控件的边框样式。 (继承自 Panel。) | |
Bottom | 获取控件下边缘与其容器的工作区上边缘之间的距离(以像素为单位)。 (继承自 Control。) | |
Bounds | 获取或设置控件(包括其非工作区元素)相对于其父控件的大小和位置(以像素为单位)。 (继承自 Control。) | |
CanEnableIme | 获取一个用以指示是否可以将 ImeMode 属性设置为活动值的值,以启用 IME 支持。 (继承自 Control。) | |
CanFocus | 获取一个值,该值指示控件是否可以接收焦点。 (继承自 Control。) | |
CanRaiseEvents | 确定是否可以在控件上引发事件。 (继承自 Control。) | |
CanSelect | 获取一个值,该值指示是否可以选中控件。 (继承自 Control。) | |
Capture | 获取或设置一个值,该值指示控件是否已捕获鼠标。 (继承自 Control。) | |
CausesValidation | 获取或设置一个值,该值指示控件是否会引起在任何需要在接收焦点时执行验证的控件上执行验证。 (继承自 Control。) | |
ClientRectangle | 获取表示控件的工作区的矩形。 (继承自 Control。) | |
ClientSize | 获取或设置控件的工作区的高度和宽度。 (继承自 Control。) | |
CompanyName | 获取包含控件的应用程序的公司名称或创建者。 (继承自 Control。) | |
Container | 获取 IContainer,它包含 Component。 (继承自 Component。) | |
ContainsFocus | 获取一个值,该值指示控件或它的一个子控件当前是否有输入焦点。 (继承自 Control。) | |
ContextMenu | 获取或设置与控件关联的快捷菜单。 (继承自 Control。) | |
ContextMenuStrip | 获取或设置与此控件关联的 ContextMenuStrip。 (继承自 Control。) | |
Controls | 获取包含在控件内的控件的集合。 (继承自 Control。) | |
Created | 获取一个值,该值指示控件是否已经创建。 (继承自 Control。) | |
CreateParams | 获取创建控件句柄时所需要的创建参数。 (继承自 Panel。) | |
Cursor | 获取或设置当鼠标指针位于控件上时显示的光标。 (继承自 Control。) | |
DataBindings | 为该控件获取数据绑定。 (继承自 Control。) | |
DefaultCursor | 获取或设置控件的默认光标。 (继承自 Control。) | |
DefaultImeMode | 获取控件支持的输入法编辑器 (IME) 模式。 (继承自 Control。) | |
DefaultMargin | 获取控件之间默认指定的间距(以像素为单位)。 (继承自 Control。) | |
DefaultMaximumSize | 获取以像素为单位的长度和高度,此长度和高度被指定为控件的默认最大大小。 (继承自 Control。) | |
DefaultMinimumSize | 获取以像素为单位的长度和高度,此长度和高度被指定为控件的默认最小大小。 (继承自 Control。) | |
DefaultPadding | 获取控件内容的内部间距(以像素为单位)。 (继承自 Control。) | |
DefaultSize | 获取控件的默认大小。 (继承自 Panel。) | |
DesignMode | 获取一个值,用以指示 Component 当前是否处于设计模式。 (继承自 Component。) | |
DisplayRectangle | 获取表示控件的虚拟显示区域的矩形。 (继承自 ScrollableControl。) | |
Disposing | 获取一个值,该值指示 Control 基类是否在释放进程中。 (继承自 Control。) | |
Dock | 基础结构。DataRepeater 控件在内部用于 DataRepeaterItem 对象公开数据在运行时。ItemTemplate 的设置确定数据的显示方式。 | |
DockPadding | 获取控件的所有边缘的停靠边距设置。 (继承自 ScrollableControl。) | |
DoubleBuffered | 获取或设置一个值,该值指示此控件是否应使用辅助缓冲区重绘其图面,以减少或避免闪烁。 (继承自 Control。) | |
Enabled | 获取或设置一个值,该值指示控件是否可以对用户交互作出响应。 (继承自 Control。) | |
Events | 获取附加到此 Component 的事件处理程序的列表。 (继承自 Component。) | |
Focused | 获取一个值,该值指示控件是否有输入焦点。 (继承自 Control。) | |
Font | 获取或设置控件显示的文字的字体。 (继承自 Control。) | |
FontHeight | 获取或设置控件的字体的高度。 (继承自 Control。) | |
ForeColor | 获取或设置控件的前景色。 (继承自 Control。) | |
Handle | 获取控件绑定到的窗口句柄。 (继承自 Control。) | |
HasChildren | 获取一个值,该值指示控件是否包含一个或多个子控件。 (继承自 Control。) | |
Height | 获取或设置控件的高度。 (继承自 Control。) | |
HorizontalScroll | 获取与水平滚动条相关联的特性。 (继承自 ScrollableControl。) | |
HScroll | 获取或设置一个值,该值指示水平滚动条是否可见。 (继承自 ScrollableControl。) | |
ImeMode | 获取或设置控件的输入法编辑器 (IME) 模式。 (继承自 Control。) | |
ImeModeBase | 获取或设置控件的 IME 模式。 (继承自 Control。) | |
InvokeRequired | 获取一个值,该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法,因为调用方位于创建控件所在的线程以外的线程中。 (继承自 Control。) | |
IsAccessible | 获取或设置一个值,该值指示控件对辅助功能应用程序是否可见。 (继承自 Control。) | |
IsCurrent | 获取用于确定的值 DataRepeaterItem 是否在 DataRepeater 控件的当前选定项。 | |
IsDirty | 获取用于确定的值为 DataRepeater 控件的 DataRepeaterItem 用户是否已更改数据。 | |
IsDisposed | 获取一个值,该值指示控件是否已经被释放。 (继承自 Control。) | |
IsHandleCreated | 获取一个值,该值指示控件是否有与它关联的句柄。 (继承自 Control。) | |
IsMirrored | 获取一个值,该值指示此控件是否为镜像控件。 (继承自 Control。) | |
ItemIndex | 获取 DataRepeaterItem 的索引。 DataRepeater 控件的。 | |
LayoutEngine | 获取控件的布局引擎的缓存实例。 (继承自 Control。) | |
Left | 获取或设置控件左边缘与其容器的工作区左边缘之间的距离(以像素为单位)。 (继承自 Control。) | |
Location | 基础结构。DataRepeater 控件在内部用于 DataRepeaterItem 对象公开数据在运行时。ItemTemplate 的设置确定数据的显示方式。 | |
Margin | 获取或设置控件之间的空间。 (继承自 Control。) | |
MaximumSize | 获取或设置大小,该大小是 GetPreferredSize 可以指定的上限。 (继承自 Control。) | |
MinimumSize | 获取或设置大小,该大小是 GetPreferredSize 可以指定的下限。 (继承自 Control。) | |
Name | 获取或设置 DataRepeaterItem 对象的名称。 | |
Padding | 获取或设置控件内的空白。 (继承自 Control。) | |
Parent | 获取或设置控件的父容器。 (继承自 Control。) | |
PreferredSize | 获取可以容纳控件的矩形区域的大小。 (继承自 Control。) | |
ProductName | 获取包含控件的程序集的产品名称。 (继承自 Control。) | |
ProductVersion | 获取包含控件的程序集的版本。 (继承自 Control。) | |
RecreatingHandle | 获取一个值,该值指示控件当前是否在重新创建其句柄。 (继承自 Control。) | |
Region | 获取或设置与控件关联的窗口区域。 (继承自 Control。) | |
RenderRightToLeft | 已过时。此属性现已过时。 (继承自 Control。) | |
ResizeRedraw | 获取或设置一个值,该值指示控件在调整大小时是否重绘自己。 (继承自 Control。) | |
Right | 获取控件右边缘与其容器的工作区左边缘之间的距离(以像素为单位)。 (继承自 Control。) | |
RightToLeft | 获取或设置一个值,该值指示是否将控件的元素对齐以支持使用从右向左的字体的区域设置。 (继承自 Control。) | |
ScaleChildren | 获取一个值,该值确定子控件的缩放。 (继承自 Control。) | |
ShowFocusCues | 获取一个值,该值指示控件是否应显示聚焦框。 (继承自 Control。) | |
ShowKeyboardCues | 获取一个值,该值指示用户界面是否处于适当的状态以显示或隐藏键盘快捷键。 (继承自 Control。) | |
Site | 获取或设置控件的站点。 (继承自 Control。) | |
Size | 获取或设置控件的高度和宽度。 (继承自 Control。) | |
TabIndex | 基础结构。DataRepeater 控件在内部用于 DataRepeaterItem 对象公开数据在运行时。ItemTemplate 的设置确定数据的显示方式。 | |
TabStop | 基础结构。DataRepeater 控件在内部用于 DataRepeaterItem 对象公开数据在运行时。ItemTemplate 的设置确定数据的显示方式。 | |
Tag | 获取或设置包含有关控件的数据的对象。 (继承自 Control。) | |
Text | 基础结构。此成员对于此控件无意义。 (继承自 Panel。) | |
Top | 获取或设置控件上边缘与其容器的工作区上边缘之间的距离(以像素为单位)。 (继承自 Control。) | |
TopLevelControl | 获取没有另一个 Windows 窗体控件作为其父级的父控件。通常,这是控件所在的最外面的 Form。 (继承自 Control。) | |
UseWaitCursor | 获取或设置一个值,该值指示是否将等待光标用于当前控件以及所有子控件。 (继承自 Control。) | |
VerticalScroll | 获取与垂直滚动条相关联的特性。 (继承自 ScrollableControl。) | |
Visible | 基础结构。DataRepeater 控件在内部用于 DataRepeaterItem 对象公开数据在运行时。ItemTemplate 的设置确定数据的显示方式。 | |
VScroll | 获取或设置一个值,该值指示垂直滚动条是否可见。 (继承自 ScrollableControl。) | |
Width | 获取或设置控件的宽度。 (继承自 Control。) | |
WindowTarget | 基础结构。此属性与此类无关。 (继承自 Control。) |
页首
方法
页首
事件
名称 | 说明 | |
---|---|---|
AutoSizeChanged | 在 AutoSize 属性的值更改后发生。 (继承自 Panel。) | |
BackColorChanged | 当 BackColor 属性的值更改时发生。 (继承自 Control。) | |
BackgroundImageChanged | 当 BackgroundImage 属性的值更改时发生。 (继承自 Control。) | |
BackgroundImageLayoutChanged | 当 BackgroundImageLayout 属性更改时发生。 (继承自 Control。) | |
BindingContextChanged | 当 BindingContext 属性的值更改时发生。 (继承自 Control。) | |
CausesValidationChanged | 当 CausesValidation 属性的值更改时发生。 (继承自 Control。) | |
ChangeUICues | 焦点或键盘用户界面(UI)提示更改时发生。 (继承自 Control。) | |
Click | 在单击控件时发生。 (继承自 Control。) | |
ClientSizeChanged | 当 ClientSize 属性的值更改时发生。 (继承自 Control。) | |
ContextMenuChanged | 当 ContextMenu 属性的值更改时发生。 (继承自 Control。) | |
ContextMenuStripChanged | 当 ContextMenuStrip 属性的值更改时发生。 (继承自 Control。) | |
ControlAdded | 在将新控件添加到 Control.ControlCollection 时发生。 (继承自 Control。) | |
ControlRemoved | 在从 Control.ControlCollection 移除控件时发生。 (继承自 Control。) | |
CursorChanged | 当 Cursor 属性的值更改时发生。 (继承自 Control。) | |
Disposed | 当通过调用 Dispose 方法释放组件时发生。 (继承自 Component。) | |
DockChanged | 当 Dock 属性的值更改时发生。 (继承自 Control。) | |
DoubleClick | 在双击控件时发生。 (继承自 Control。) | |
DragDrop | 拖放操作完成时发生。 (继承自 Control。) | |
DragEnter | 在将对象拖入控件的边界时发生。 (继承自 Control。) | |
DragLeave | 将对象拖出控件的边界时发生。 (继承自 Control。) | |
DragOver | 将对象拖过控件的边界时发生。 (继承自 Control。) | |
EnabledChanged | 在 Enabled 属性值更改后发生。 (继承自 Control。) | |
Enter | 进入控件时发生。 (继承自 Control。) | |
FontChanged | 在 Font 属性值更改时发生。 (继承自 Control。) | |
ForeColorChanged | 在 ForeColor 属性值更改时发生。 (继承自 Control。) | |
GiveFeedback | 在执行拖动操作期间发生。 (继承自 Control。) | |
GotFocus | 在控件接收焦点时发生。 (继承自 Control。) | |
HandleCreated | 在为控件创建句柄时发生。 (继承自 Control。) | |
HandleDestroyed | 在控件的句柄处于销毁过程中时发生。 (继承自 Control。) | |
HelpRequested | 当用户请求控件的帮助时发生。 (继承自 Control。) | |
ImeModeChanged | 在 ImeMode 属性更改后发生。 (继承自 Control。) | |
Invalidated | 控件的显示要求重新绘制时发生。 (继承自 Control。) | |
KeyDown | 基础结构。此成员对于此控件无意义。 (继承自 Panel。) | |
KeyPress | 基础结构。此成员对于此控件无意义。 (继承自 Panel。) | |
KeyUp | 基础结构。此成员对于此控件无意义。 (继承自 Panel。) | |
Layout | 在控件应重新定位其子控件时发生。 (继承自 Control。) | |
Leave | 在输入焦点离开控件时发生。 (继承自 Control。) | |
LocationChanged | 在 Location 属性值更改后发生。 (继承自 Control。) | |
LostFocus | 在控件失去焦点时发生。 (继承自 Control。) | |
MarginChanged | 在控件边距更改时发生。 (继承自 Control。) | |
MouseCaptureChanged | 当控件失去鼠标捕获时发生。 (继承自 Control。) | |
MouseClick | 用鼠标单击控件时发生。 (继承自 Control。) | |
MouseDoubleClick | 用鼠标双击控件时发生。 (继承自 Control。) | |
MouseDown | 当鼠标指针位于控件上并按下鼠标键时发生。 (继承自 Control。) | |
MouseEnter | 在鼠标指针进入控件时发生。 (继承自 Control。) | |
MouseHover | 在鼠标指针停放在控件上时发生。 (继承自 Control。) | |
MouseLeave | 在鼠标指针离开控件时发生。 (继承自 Control。) | |
MouseMove | 在鼠标指针移到控件上时发生。 (继承自 Control。) | |
MouseUp | 在鼠标指针在控件上并释放鼠标键时发生。 (继承自 Control。) | |
MouseWheel | 在控件有焦点的同时鼠标轮移动时发生。 (继承自 Control。) | |
Move | 在移动控件时发生。 (继承自 Control。) | |
PaddingChanged | 在控件空白区更改时发生。 (继承自 Control。) | |
Paint | 在重绘控件时发生。 (继承自 Control。) | |
ParentChanged | 在 Parent 属性值更改时发生。 (继承自 Control。) | |
PreviewKeyDown | 在焦点位于此控件上的情况下,当有按键动作时发生(在 KeyDown 事件之前发生)。 (继承自 Control。) | |
QueryAccessibilityHelp | 在 AccessibleObject 为辅助功能应用程序提供帮助时发生。 (继承自 Control。) | |
QueryContinueDrag | 在拖放操作期间发生,并且允许拖动源确定是否应取消拖放操作。 (继承自 Control。) | |
RegionChanged | 当 Region 属性的值更改时发生。 (继承自 Control。) | |
Resize | 在调整控件大小时发生。 (继承自 Control。) | |
RightToLeftChanged | 在 RightToLeft 属性值更改时发生。 (继承自 Control。) | |
Scroll | 用户或代码滚动工作区时发生。 (继承自 ScrollableControl。) | |
SizeChanged | 在 Size 属性值更改时发生。 (继承自 Control。) | |
StyleChanged | 在控件样式更改时发生。 (继承自 Control。) | |
SystemColorsChanged | 系统颜色更改时发生。 (继承自 Control。) | |
TabIndexChanged | 在 TabIndex 属性值更改时发生。 (继承自 Control。) | |
TabStopChanged | 在 TabStop 属性值更改时发生。 (继承自 Control。) | |
TextChanged | 基础结构。此成员对于此控件无意义。 (继承自 Panel。) | |
Validated | 在控件完成验证时发生。 (继承自 Control。) | |
Validating | 在控件验证时发生。 (继承自 Control。) | |
VisibleChanged | 在 Visible 属性值更改时发生。 (继承自 Control。) |
页首
显式接口实现
名称 | 说明 | |
---|---|---|
IDropTarget.OnDragDrop | 基础结构。引发 DragDrop 事件。 (继承自 Control。) | |
IDropTarget.OnDragEnter | 基础结构。引发 DragEnter 事件。 (继承自 Control。) | |
IDropTarget.OnDragLeave | 基础结构。引发 DragLeave 事件。 (继承自 Control。) | |
IDropTarget.OnDragOver | 基础结构。引发 DragOver 事件。 (继承自 Control。) |
页首
备注
,当滚动到视图, DataRepeater 控件使用 DataRepeaterItem 对象公开控件的每个项。 当项滚动到视图之外, DataRepeaterItem 中下一个可见项的新 DataRepeaterItem 失效并替换。
每个项目布局和外观基于 ItemTemplate 属性。 在每 DataRepeaterItem 呈现,您可以修改在 DrawItem 事件的外观。
备注
您应当修改可以从 DrawItem 事件访问仅的 DataRepeaterItem 。尝试修改它放在活动之外或尝试创建新的 DataRepeaterItem 可能导致意外的结果。
示例
,当项滚动到视图中时,下面的示例演示如何使用 DrawItem 事件处理程序进行更改。 此示例假定您有一个 DataRepeater 控件,该控件绑定到 Northwind 数据库的 Products 表。
Private Sub DataRepeater1_DrawItem(
ByVal sender As Object,
ByVal e As Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs
) Handles DataRepeater1.DrawItem
' Alternate the back color.
If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then
' Apply the secondary back color.
e.DataRepeaterItem.BackColor = Color.AliceBlue
Else
' Apply the default back color.
e.DataRepeaterItem.BackColor = Color.White
End If
' Change the color of out-of-stock items to red.
If e.DataRepeaterItem.Controls(
UnitsInStockTextBox.Name).Text < 1 Then
e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name).
BackColor = Color.Red
Else
e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name).
BackColor = Color.White
End If
End Sub
private void dataRepeater1_DrawItem(object sender,
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs e)
{
// Alternate the back color.
if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
// Apply the secondary back color.
{
e.DataRepeaterItem.BackColor = Color.AliceBlue;
}
else
{
// Apply the default back color.
e.DataRepeaterItem.BackColor = Color.White;
}
// Change the color of out-of-stock items to red.
if (e.DataRepeaterItem.Controls["unitsInStockTextBox"].Text == "0")
{
e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.Red;
}
else
{
e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.White;
}
}
线程安全
此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。
请参见
参考
Microsoft.VisualBasic.PowerPacks 命名空间