System.Windows.Forms.ListView : Control

时间:2020-12-12 12:25:56
#region 程序集 System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
// C:\Windows\Microsoft.NET\Framework\v2.0.50727\System.Windows.Forms.dll
#endregion using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Drawing.Design;
using System.Reflection;
using System.Runtime.InteropServices; namespace System.Windows.Forms
{
//
// 摘要:
// 表示 Windows 列表视图控件,该控件显示可用四种不同视图之一显示的项集合。
[ClassInterface(ClassInterfaceType.AutoDispatch)]
[ComVisible(true)]
[DefaultEvent("SelectedIndexChanged")]
[DefaultProperty("Items")]
[Designer("System.Windows.Forms.Design.ListViewDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[Docking(DockingBehavior.Ask)]
[SRDescriptionAttribute("DescriptionListView")]
public class ListView : Control
{
//
// 摘要:
// 初始化 System.Windows.Forms.ListView 类的新实例。
public ListView(); //
// 摘要:
// 获取或设置用户激活某个项必须要执行的操作的类型。
//
// 返回结果:
// System.Windows.Forms.ItemActivation 值之一。默认为 System.Windows.Forms.ItemActivation.Standard。
//
// 异常:
// T:System.ComponentModel.InvalidEnumArgumentException:
// 指定的值不是 System.Windows.Forms.ItemActivation 成员之一。
[DefaultValue(ItemActivation.Standard)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewActivationDescr")]
public ItemActivation Activation { get; set; }
//
// 摘要:
// 获取或设置控件中项的对齐方式。
//
// 返回结果:
// System.Windows.Forms.ListViewAlignment 值之一。默认为 System.Windows.Forms.ListViewAlignment.Top。
//
// 异常:
// T:System.ComponentModel.InvalidEnumArgumentException:
// 指定的值不是 System.Windows.Forms.ListViewAlignment 值之一。
[DefaultValue(ListViewAlignment.Top)]
[Localizable(true)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewAlignmentDescr")]
public ListViewAlignment Alignment { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示用户是否可拖动列标题来对控件中的列重新排序。
//
// 返回结果:
// 如果允许通过拖放列来重新排序,则为 true;否则,为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewAllowColumnReorderDescr")]
public bool AllowColumnReorder { get; set; }
//
// 摘要:
// 获取或设置图标是否自动进行排列。
//
// 返回结果:
// 如果图标自动进行排列且与网格线对齐,则为 true;否则,为 false。默认为 true。
[DefaultValue(true)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewAutoArrangeDescr")]
public bool AutoArrange { get; set; }
//
// 摘要:
// 获取或设置背景色。
//
// 返回结果:
// 作为背景色的 System.Drawing.Color。
public override Color BackColor { get; set; }
//
// 摘要:
// 获取或设置 System.Windows.Forms.ImageLayout 值。
//
// 返回结果:
// System.Windows.Forms.ImageLayout 值之一。
//
// 异常:
// T:System.ComponentModel.InvalidEnumArgumentException:
// 指定的值不是 System.Windows.Forms.ImageLayout 值之一。
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public override ImageLayout BackgroundImageLayout { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示是否应平铺 System.Windows.Forms.ListView 的背景图像。
//
// 返回结果:
// 如果应平铺 System.Windows.Forms.ListView 的背景图像,则为 true;否则为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewBackgroundImageTiledDescr")]
public bool BackgroundImageTiled { get; set; }
//
// 摘要:
// 获取或设置控件的边框样式。
//
// 返回结果:
// System.Windows.Forms.BorderStyle 值之一。默认为 System.Windows.Forms.BorderStyle.Fixed3D。
//
// 异常:
// T:System.ComponentModel.InvalidEnumArgumentException:
// 指定的值不是 System.Windows.Forms.BorderStyle 值之一。
[DefaultValue(BorderStyle.Fixed3D)]
[DispId(-)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("borderStyleDescr")]
public BorderStyle BorderStyle { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示控件中各项的旁边是否显示复选框。
//
// 返回结果:
// 如果在 System.Windows.Forms.ListView 控件中的每个项的旁边显示复选框,则为 true;否则为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewCheckBoxesDescr")]
public bool CheckBoxes { get; set; }
//
// 摘要:
// 获取控件中当前选中项的索引。
//
// 返回结果:
// System.Windows.Forms.ListView.CheckedIndexCollection,包含当前选中项的索引。如果当前未选中任何项,则返回空的
// System.Windows.Forms.ListView.CheckedIndexCollection。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public CheckedIndexCollection CheckedIndices { get; }
//
// 摘要:
// 获取控件中当前选中的项。
//
// 返回结果:
// System.Windows.Forms.ListView.CheckedListViewItemCollection,包含当前选中的项。如果当前未选中任何项,则返回空的
// System.Windows.Forms.ListView.CheckedListViewItemCollection。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public CheckedListViewItemCollection CheckedItems { get; }
//
// 摘要:
// 获取控件中显示的所有列标题的集合。
//
// 返回结果:
// System.Windows.Forms.ListView.ColumnHeaderCollection,表示当 System.Windows.Forms.ListView.View
// 属性设置为 System.Windows.Forms.View.Details 时显示的列标题。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
[Editor("System.Windows.Forms.Design.ColumnHeaderCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(UITypeEditor))]
[Localizable(true)]
[MergableProperty(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewColumnsDescr")]
public ColumnHeaderCollection Columns { get; }
//
// 摘要:
// 获取或设置当前具有焦点的控件中的项。
//
// 返回结果:
// 表示具有焦点的项的 System.Windows.Forms.ListViewItem;如果 System.Windows.Forms.ListView
// 中的所有项都不具有焦点,则为 null。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewFocusedItemDescr")]
public ListViewItem FocusedItem { get; set; }
//
// 摘要:
// 获取或设置前景色。
//
// 返回结果:
// 一个作为前景色的 System.Drawing.Color。
public override Color ForeColor { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示单击某项是否选择其所有子项。
//
// 返回结果:
// 如果单击某项会选择该项及其所有子项,则为 true;如果单击某项仅选择项本身,则为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewFullRowSelectDescr")]
public bool FullRowSelect { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示:在包含控件中项及其子项的行和列之间是否显示网格线。
//
// 返回结果:
// 如果在项及其子项的周围绘制网格线的,则为 true;否则,为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewGridLinesDescr")]
public bool GridLines { get; set; }
//
// 摘要:
// 获取分配给控件的 System.Windows.Forms.ListViewGroup 对象的集合。
//
// 返回结果:
// 一个包含 System.Windows.Forms.ListView 控件中所有的组的 System.Windows.Forms.ListViewGroupCollection。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
[Editor("System.Windows.Forms.Design.ListViewGroupCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(UITypeEditor))]
[Localizable(true)]
[MergableProperty(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewGroupsDescr")]
public ListViewGroupCollection Groups { get; }
//
// 摘要:
// 获取或设置列标题样式。
//
// 返回结果:
// System.Windows.Forms.ColumnHeaderStyle 值之一。默认为 System.Windows.Forms.ColumnHeaderStyle.Clickable。
//
// 异常:
// T:System.ComponentModel.InvalidEnumArgumentException:
// 指定的值不是 System.Windows.Forms.ColumnHeaderStyle 值之一。
[DefaultValue(ColumnHeaderStyle.Clickable)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewHeaderStyleDescr")]
public ColumnHeaderStyle HeaderStyle { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示当控件没有焦点时,该控件中选定的项是否保持突出显示。
//
// 返回结果:
// 在控件没有焦点时,如果选定项不突出显示,则为 true;如果选定项在控件没有焦点时仍突出显示,则为 false。默认为 true。
[DefaultValue(true)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewHideSelectionDescr")]
public bool HideSelection { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示当鼠标指针经过某个项或子项的文本时,文本的外观是否变为超链接的形式。
//
// 返回结果:
// 如果当鼠标指针经过项文本时,其外观变为超链接的形式,则为 true;否则为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewHotTrackingDescr")]
public bool HotTracking { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示当鼠标指针在项上停留几秒钟时是否自动选定该项。
//
// 返回结果:
// 如果在鼠标指针悬停于项上时自动选择项,则为 true;否则,为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewHoverSelectDescr")]
public bool HoverSelection { get; set; }
//
// 摘要:
// 获取一个对象,在 System.Windows.Forms.ListView 控件内拖动项时,该对象用来指示预期的放置位置。
//
// 返回结果:
// 表示插入标记的 System.Windows.Forms.ListViewInsertionMark 对象。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[SRDescriptionAttribute("ListViewInsertionMarkDescr")]
public ListViewInsertionMark InsertionMark { get; }
//
// 摘要:
// 获取包含控件中所有项的集合。
//
// 返回结果:
// System.Windows.Forms.ListView.ListViewItemCollection,包含 System.Windows.Forms.ListView
// 控件中所有的项。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
[Editor("System.Windows.Forms.Design.ListViewItemCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(UITypeEditor))]
[Localizable(true)]
[MergableProperty(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewItemsDescr")]
public ListViewItemCollection Items { get; }
//
// 摘要:
// 获取或设置一个值,该值指示用户是否可以编辑控件中项的标签。
//
// 返回结果:
// 如果用户可以在运行时编辑项的标签,则为 true;否则,为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewLabelEditDescr")]
public bool LabelEdit { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示当项作为图标在控件中显示时,项标签是否换行。
//
// 返回结果:
// 如果当项显示为图标时,项标签换行,为 true;否则,为 false。默认为 true。
[DefaultValue(true)]
[Localizable(true)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewLabelWrapDescr")]
public bool LabelWrap { get; set; }
//
// 摘要:
// 获取或设置当项以大图标在控件中显示时使用的 System.Windows.Forms.ImageList。
//
// 返回结果:
// System.Windows.Forms.ImageList,包含将 System.Windows.Forms.ListView.View 属性设置为 System.Windows.Forms.View.LargeIcon
// 时要使用的图标。默认为 null。
[DefaultValue(null)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewLargeImageListDescr")]
public ImageList LargeImageList { get; set; }
//
// 摘要:
// 获取或设置用于控件的排序比较器。
//
// 返回结果:
// System.Collections.IComparer,表示用于控件的排序比较器。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewItemSorterDescr")]
public IComparer ListViewItemSorter { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示是否可以选择多个项。
//
// 返回结果:
// 如果可以一次选择控件中的多个项,则为 true;否则为 false。默认为 true。
[DefaultValue(true)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewMultiSelectDescr")]
public bool MultiSelect { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示 System.Windows.Forms.ListView 控件是由操作系统绘制还是由您提供的代码绘制。
//
// 返回结果:
// 如果 System.Windows.Forms.ListView 控件由您提供的代码绘制,则为 true;如果 System.Windows.Forms.ListView
// 控件由操作系统绘制,则为 false。默认为 false。
[DefaultValue(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewOwnerDrawDescr")]
public bool OwnerDraw { get; set; }
//
// 摘要:
// 获取或设置 System.Windows.Forms.ListView 控件及其内容之间的间距。
//
// 返回结果:
// System.Windows.Forms.Padding,用于指定 System.Windows.Forms.ListView 控件及其内容之间的间距。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[EditorBrowsable(EditorBrowsableState.Never)]
public Padding Padding { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示是否从右至左布局控件。
//
// 返回结果:
// 若要指示从右至左布局 System.Windows.Forms.ListView 控件,则为 true;否则为 false。
[DefaultValue(false)]
[Localizable(true)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ControlRightToLeftLayoutDescr")]
public virtual bool RightToLeftLayout { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示在没有足够空间来显示所有项时,是否给滚动条添加控件。
//
// 返回结果:
// 如果在需要时给控件添加滚动条,以允许用户查看所有项,则为 true;否则为 false。默认为 true。
[DefaultValue(true)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewScrollableDescr")]
public bool Scrollable { get; set; }
//
// 摘要:
// 获取控件中选定项的索引。
//
// 返回结果:
// System.Windows.Forms.ListView.SelectedIndexCollection,包含选定的项的索引。如果当前没有选定的项,则返回空
// System.Windows.Forms.ListView.SelectedIndexCollection。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public SelectedIndexCollection SelectedIndices { get; }
//
// 摘要:
// 获取在控件中选定的项。
//
// 返回结果:
// System.Windows.Forms.ListView.SelectedListViewItemCollection,包含在控件中选定的项。如果当前没有选定的项,则返回空
// System.Windows.Forms.ListView.SelectedListViewItemCollection。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewSelectedItemsDescr")]
public SelectedListViewItemCollection SelectedItems { get; }
//
// 摘要:
// 获取或设置一个值,该值指示是否以分组方式显示项。
//
// 返回结果:
// 若要以分组方式显示项,则为 true;否则为 false。默认值为 true。
[DefaultValue(true)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewShowGroupsDescr")]
public bool ShowGroups { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示是否为 System.Windows.Forms.ListView 中包含的 System.Windows.Forms.ListViewItem
// 对象显示工具提示。
//
// 返回结果:
// 如果应显示 System.Windows.Forms.ListViewItem 工具提示,则为 true;否则为 false。默认为 true。
[DefaultValue(false)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewShowItemToolTipsDescr")]
public bool ShowItemToolTips { get; set; }
//
// 摘要:
// 获取或设置 System.Windows.Forms.ImageList,当项在控件中显示为小图标时使用。
//
// 返回结果:
// System.Windows.Forms.ImageList,包含将 System.Windows.Forms.ListView.View 属性设置为 System.Windows.Forms.View.SmallIcon
// 时要使用的图标。默认为 null。
[DefaultValue(null)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewSmallImageListDescr")]
public ImageList SmallImageList { get; set; }
//
// 摘要:
// 获取或设置控件中项的排序顺序。
//
// 返回结果:
// System.Windows.Forms.SortOrder 值之一。默认为 System.Windows.Forms.SortOrder.None。
//
// 异常:
// T:System.ComponentModel.InvalidEnumArgumentException:
// 指定的值不是 System.Windows.Forms.SortOrder 值之一。
[DefaultValue(SortOrder.None)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewSortingDescr")]
public SortOrder Sorting { get; set; }
//
// 摘要:
// 获取或设置与控件中应用程序定义的状态相关的 System.Windows.Forms.ImageList。
//
// 返回结果:
// System.Windows.Forms.ImageList,包含一组状态图像,这些图像可用于指示项的应用程序定义的状态。默认为 null。
[DefaultValue(null)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewStateImageListDescr")]
public ImageList StateImageList { get; set; }
//
// 摘要:
// 此属性与此类无关。
//
// 返回结果:
// System.Windows.Forms.ListView 控件中将显示的文本。
[Bindable(false)]
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public override string Text { get; set; }
//
// 摘要:
// 获取或设置平铺视图中显示的图块的大小。
//
// 返回结果:
// 一个包含新的图块大小的 System.Drawing.Size。
[Browsable(true)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewTileSizeDescr")]
public Size TileSize { get; set; }
//
// 摘要:
// 获取或设置控件中的第一个可见项。
//
// 返回结果:
// System.Windows.Forms.ListViewItem,表示控件中的第一个可见项。
//
// 异常:
// T:System.InvalidOperationException:
// 将 System.Windows.Forms.ListView.View 属性设置为 System.Windows.Forms.View.LargeIcon、System.Windows.Forms.View.SmallIcon
// 或 System.Windows.Forms.View.Tile。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewTopItemDescr")]
public ListViewItem TopItem { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示 System.Windows.Forms.ListView 是使用与 .NET Framework 1.1 兼容的状态图像行为,还是使用与
// .NET Framework 2.0 兼容的状态图像行为。
//
// 返回结果:
// 如果状态图像的行为与 .NET Framework 1.1 兼容,则为 true;如果状态图像的行为与 .NET Framework 2.0 兼容,则为
// false。默认为 true。
[Browsable(false)]
[DefaultValue(true)]
[EditorBrowsable(EditorBrowsableState.Advanced)]
public bool UseCompatibleStateImageBehavior { get; set; }
//
// 摘要:
// 获取或设置项在控件中的显示方式。
//
// 返回结果:
// System.Windows.Forms.View 值之一。默认为 System.Windows.Forms.View.LargeIcon。
//
// 异常:
// T:System.ComponentModel.InvalidEnumArgumentException:
// 指定的值不是 System.Windows.Forms.View 值之一。
[DefaultValue(View.LargeIcon)]
[SRCategoryAttribute("CatAppearance")]
[SRDescriptionAttribute("ListViewViewDescr")]
public View View { get; set; }
//
// 摘要:
// 获取或设置处于虚拟模式时列表中包含的 System.Windows.Forms.ListViewItem 对象的数量。
//
// 返回结果:
// 处于虚拟模式时 System.Windows.Forms.ListView 中包含的 System.Windows.Forms.ListViewItem
// 对象的数量。
//
// 异常:
// T:System.ArgumentException:
// System.Windows.Forms.ListView.VirtualListSize 设置为小于 0 的值。
//
// T:System.InvalidOperationException:
// System.Windows.Forms.ListView.VirtualMode 设置为 true,System.Windows.Forms.ListView.VirtualListSize
// 大于 0,且未处理 System.Windows.Forms.ListView.RetrieveVirtualItem。
[DefaultValue()]
[RefreshProperties(RefreshProperties.Repaint)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewVirtualListSizeDescr")]
public int VirtualListSize { get; set; }
//
// 摘要:
// 获取或设置一个值,该值指示您是否为 System.Windows.Forms.ListView 控件提供了自己的数据管理操作。
//
// 返回结果:
// 如果 System.Windows.Forms.ListView 使用您提供的数据管理操作,则为 true;否则为 false。默认为 false。
//
// 异常:
// T:System.InvalidOperationException:
// System.Windows.Forms.ListView.VirtualMode 设置为 true 且存在以下条件之一:System.Windows.Forms.ListView.VirtualListSize
// 大于 0 且未处理 System.Windows.Forms.ListView.RetrieveVirtualItem。- 或 -System.Windows.Forms.ListView.Items、System.Windows.Forms.ListView.CheckedItems
// 或 System.Windows.Forms.ListView.SelectedItems 包含项。- 或 -对 System.Windows.Forms.ListView.Items
// 进行了编辑。
[DefaultValue(false)]
[RefreshProperties(RefreshProperties.Repaint)]
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewVirtualModeDescr")]
public bool VirtualMode { get; set; }
//
// 摘要:
// 此属性与此类无关。
protected override CreateParams CreateParams { get; }
//
// 返回结果:
// 控件的默认 System.Drawing.Size。
protected override Size DefaultSize { get; }
//
// 返回结果:
// 如果应使用双缓冲绘制控件的图面,则为 true;否则为 false。
protected override bool DoubleBuffered { get; set; } //
// 摘要:
// 当用户编辑项的标签时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewAfterLabelEditDescr")]
public event LabelEditEventHandler AfterLabelEdit;
//
// 摘要:
// 当 System.Windows.Forms.ListView.BackgroundImageLayout 属性更改时发生。
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public event EventHandler BackgroundImageLayoutChanged;
//
// 摘要:
// 当用户开始编辑项的标签时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewBeforeLabelEditDescr")]
public event LabelEditEventHandler BeforeLabelEdit;
//
// 摘要:
// 当处于虚拟模式下的 System.Windows.Forms.ListView 的显示区域的内容发生更改时发生,System.Windows.Forms.ListView
// 决定需要的项的新范围。
[SRCategoryAttribute("CatAction")]
[SRDescriptionAttribute("ListViewCacheVirtualItemsEventDescr")]
public event CacheVirtualItemsEventHandler CacheVirtualItems;
//
// 摘要:
// 当用户在列表视图控件中单击列标题时发生。
[SRCategoryAttribute("CatAction")]
[SRDescriptionAttribute("ListViewColumnClickDescr")]
public event ColumnClickEventHandler ColumnClick;
//
// 摘要:
// 在列标题顺序更改时发生。
[SRCategoryAttribute("CatPropertyChanged")]
[SRDescriptionAttribute("ListViewColumnReorderedDscr")]
public event ColumnReorderedEventHandler ColumnReordered;
//
// 摘要:
// 在成功更改列的宽度后发生。
[SRCategoryAttribute("CatPropertyChanged")]
[SRDescriptionAttribute("ListViewColumnWidthChangedDscr")]
public event ColumnWidthChangedEventHandler ColumnWidthChanged;
//
// 摘要:
// 在更改列的宽度时发生。
[SRCategoryAttribute("CatPropertyChanged")]
[SRDescriptionAttribute("ListViewColumnWidthChangingDscr")]
public event ColumnWidthChangingEventHandler ColumnWidthChanging;
//
// 摘要:
// 当绘制 System.Windows.Forms.ListView 的详细信息视图并且 System.Windows.Forms.ListView.OwnerDraw
// 属性设置为 true 时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewDrawColumnHeaderEventDescr")]
public event DrawListViewColumnHeaderEventHandler DrawColumnHeader;
//
// 摘要:
// 在绘制 System.Windows.Forms.ListView 并且 System.Windows.Forms.ListView.OwnerDraw
// 属性设置为 true 时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewDrawItemEventDescr")]
public event DrawListViewItemEventHandler DrawItem;
//
// 摘要:
// 当绘制 System.Windows.Forms.ListView 的详细信息视图并且 System.Windows.Forms.ListView.OwnerDraw
// 属性设置为 true 时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewDrawSubItemEventDescr")]
public event DrawListViewSubItemEventHandler DrawSubItem;
//
// 摘要:
// 当激活项时发生。
[SRCategoryAttribute("CatAction")]
[SRDescriptionAttribute("ListViewItemClickDescr")]
public event EventHandler ItemActivate;
//
// 摘要:
// 当某项的选中状态更改时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("CheckedListBoxItemCheckDescr")]
public event ItemCheckEventHandler ItemCheck;
//
// 摘要:
// 当某项的选中状态更改时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewItemCheckedDescr")]
public event ItemCheckedEventHandler ItemChecked;
//
// 摘要:
// 当用户开始拖动项时发生。
[SRCategoryAttribute("CatAction")]
[SRDescriptionAttribute("ListViewItemDragDescr")]
public event ItemDragEventHandler ItemDrag;
//
// 摘要:
// 当鼠标在项上悬停时发生。
[SRCategoryAttribute("CatAction")]
[SRDescriptionAttribute("ListViewItemMouseHoverDescr")]
public event ListViewItemMouseHoverEventHandler ItemMouseHover;
//
// 摘要:
// 当项的选定状态发生更改时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewItemSelectionChangedDescr")]
public event ListViewItemSelectionChangedEventHandler ItemSelectionChanged;
//
// 摘要:
// 当 System.Windows.Forms.ListView.Padding 属性的值更改时发生。
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public event EventHandler PaddingChanged;
//
// 摘要:
// 在绘制 System.Windows.Forms.ListView 控件时发生。
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public event PaintEventHandler Paint;
//
// 摘要:
// 当 System.Windows.Forms.ListView 处于虚拟模式且需要 System.Windows.Forms.ListViewItem 时发生。
//
// 异常:
// T:System.InvalidOperationException:
// 在处理 System.Windows.Forms.ListView.RetrieveVirtualItem 事件时,未将 System.Windows.Forms.RetrieveVirtualItemEventArgs.Item
// 属性设置为某个项。
[SRCategoryAttribute("CatAction")]
[SRDescriptionAttribute("ListViewRetrieveVirtualItemEventDescr")]
public event RetrieveVirtualItemEventHandler RetrieveVirtualItem;
//
// 摘要:
// 当 System.Windows.Forms.ListView.RightToLeftLayout 属性的值更改时发生。
[SRCategoryAttribute("CatPropertyChanged")]
[SRDescriptionAttribute("ControlOnRightToLeftLayoutChangedDescr")]
public event EventHandler RightToLeftLayoutChanged;
//
// 摘要:
// 当 System.Windows.Forms.ListView 处于虚拟模式下且正进行搜索时发生。
[SRCategoryAttribute("CatAction")]
[SRDescriptionAttribute("ListViewSearchForVirtualItemDescr")]
public event SearchForVirtualItemEventHandler SearchForVirtualItem;
//
// 摘要:
// 当 System.Windows.Forms.ListView.SelectedIndices 集合更改时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewSelectedIndexChangedDescr")]
public event EventHandler SelectedIndexChanged;
//
// 摘要:
// 当 System.Windows.Forms.ListView.Text 属性更改时发生。
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public event EventHandler TextChanged;
//
// 摘要:
// 当 System.Windows.Forms.ListView 处于虚拟模式下且某个范围内的项的选定状态发生更改时发生。
[SRCategoryAttribute("CatBehavior")]
[SRDescriptionAttribute("ListViewVirtualItemsSelectionRangeChangedDescr")]
public event ListViewVirtualItemsSelectionRangeChangedEventHandler VirtualItemsSelectionRangeChanged; //
// 摘要:
// 当控件中的项根据 System.Windows.Forms.ListView.Alignment 属性的值以图标显示时,对其进行排列。
public void ArrangeIcons();
//
// 摘要:
// 当控件中的项显示为带有指定的对齐方式设置的图标时,对其进行排列。
//
// 参数:
// value:
// System.Windows.Forms.ListViewAlignment 值之一。
//
// 异常:
// T:System.ArgumentException:
// 在 value 参数中指定的值不是 System.Windows.Forms.ListViewAlignment 枚举的成员。
public void ArrangeIcons(ListViewAlignment value);
//
// 摘要:
// 按照大小调整样式的指示,调整给定列的宽度。
//
// 参数:
// columnIndex:
// 要调整其大小的列的从零开始的索引。
//
// headerAutoResize:
// System.Windows.Forms.ColumnHeaderAutoResizeStyle 值之一。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// 当 System.Windows.Forms.ListView.Columns 为 null 时,columnIndex 大于 0。- 或 -columnIndex
// 小于 0 或大于列集的数量。
//
// T:System.ComponentModel.InvalidEnumArgumentException:
// headerAutoResize 不是 System.Windows.Forms.ColumnHeaderAutoResizeStyle 枚举的成员。
public void AutoResizeColumn(int columnIndex, ColumnHeaderAutoResizeStyle headerAutoResize);
//
// 摘要:
// 按照大小调整样式的指示,调整列的宽度。
//
// 参数:
// headerAutoResize:
// System.Windows.Forms.ColumnHeaderAutoResizeStyle 值之一。
//
// 异常:
// T:System.InvalidOperationException:
// 在 System.Windows.Forms.ListView.View 未被设置为 System.Windows.Forms.View.Details
// 时,使用 System.Windows.Forms.ColumnHeaderAutoResizeStyle.None 以外的值调用 System.Windows.Forms.ListView.AutoResizeColumn(System.Int32,System.Windows.Forms.ColumnHeaderAutoResizeStyle)。
public void AutoResizeColumns(ColumnHeaderAutoResizeStyle headerAutoResize);
//
// 摘要:
// 避免在调用 System.Windows.Forms.ListView.EndUpdate 方法之前描述控件。
public void BeginUpdate();
//
// 摘要:
// 从控件中移除所有项和列。
public void Clear();
//
// 摘要:
// 在 System.Windows.Forms.ListView.BeginUpdate 方法挂起描述后,继续描述列表视图控件。
public void EndUpdate();
//
// 摘要:
// 确保指定项在控件中是可见的,必要时滚动控件的内容。
//
// 参数:
// index:
// 要滚动至视图中的项的从零开始的索引。
public void EnsureVisible(int index);
//
// 摘要:
// 查找以指定文本值开头的第一个 System.Windows.Forms.ListViewItem。
//
// 参数:
// text:
// 要搜索的文本。
//
// 返回结果:
// 以指定文本值开头的第一个 System.Windows.Forms.ListViewItem。
public ListViewItem FindItemWithText(string text);
//
// 摘要:
// 查找以指定文本值开头的第一个 System.Windows.Forms.ListViewItem 或 System.Windows.Forms.ListViewItem.ListViewSubItem(如果指定)。搜索从指定索引处开始。
//
// 参数:
// text:
// 要搜索的文本。
//
// includeSubItemsInSearch:
// 在搜索中包含子项时为 true;否则为 false。
//
// startIndex:
// 从该处开始执行搜索操作的项索引。
//
// 返回结果:
// 以指定文本值开头的第一个 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// startIndex 小于 0 或大于 System.Windows.Forms.ListView 中的项的数量。
public ListViewItem FindItemWithText(string text, bool includeSubItemsInSearch, int startIndex);
//
// 摘要:
// 查找以指定文本值开头的第一个 System.Windows.Forms.ListViewItem 或 System.Windows.Forms.ListViewItem.ListViewSubItem(如果指定)。搜索从指定索引处开始。
//
// 参数:
// text:
// 要搜索的文本。
//
// includeSubItemsInSearch:
// 在搜索中包含子项时为 true;否则为 false。
//
// startIndex:
// 从该处开始执行搜索操作的项索引。
//
// isPrefixSearch:
// 要将搜索文本与项的前缀相匹配,则为 true;否则为 false。
//
// 返回结果:
// 以指定文本值开头的第一个 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// startIndex 小于 0 或大于 System.Windows.Forms.ListView 中的项的数量。
public ListViewItem FindItemWithText(string text, bool includeSubItemsInSearch, int startIndex, bool isPrefixSearch);
//
// 摘要:
// 按照指定的搜索方向,从给定点开始查找下一个项。
//
// 参数:
// dir:
// System.Windows.Forms.SearchDirectionHint 值之一。
//
// point:
// 从该处开始执行搜索的点。
//
// 返回结果:
// 与给定点最接近的 System.Windows.Forms.ListViewItem (以指定方向进行搜索)。
//
// 异常:
// T:System.InvalidOperationException:
// System.Windows.Forms.ListView.View 设置为除 System.Windows.Forms.View.SmallIcon 或
// System.Windows.Forms.View.LargeIcon 以外的值。
public ListViewItem FindNearestItem(SearchDirectionHint dir, Point point);
//
// 摘要:
// 按照指定的搜索方向,从给定的 X 和 Y 坐标开始查找下一个项。
//
// 参数:
// searchDirection:
// System.Windows.Forms.SearchDirectionHint 值之一。
//
// x:
// 在该处开始进行搜索的点的 X 坐标。
//
// y:
// 在该处开始进行搜索的点的 Y 坐标。
//
// 返回结果:
// 与给定坐标最接近的 System.Windows.Forms.ListViewItem(以指定方向进行搜索)。
//
// 异常:
// T:System.InvalidOperationException:
// System.Windows.Forms.ListView.View 设置为除 System.Windows.Forms.View.SmallIcon 或
// System.Windows.Forms.View.LargeIcon 以外的值。
public ListViewItem FindNearestItem(SearchDirectionHint searchDirection, int x, int y);
//
// 摘要:
// 检索位于指定位置的项。
//
// 参数:
// x:
// 项的搜索位置的 x 轴坐标(用工作区坐标表示)。
//
// y:
// 项的搜索位置的 y 轴坐标(用工作区坐标表示)。
//
// 返回结果:
// System.Windows.Forms.ListViewItem,表示位于指定位置的项。如果指定的位置没有项,该方法返回 null。
public ListViewItem GetItemAt(int x, int y);
//
// 摘要:
// 在列表视图控件中检索特定项的边框。
//
// 参数:
// index:
// 位于要返回其边框的 System.Windows.Forms.ListView.ListViewItemCollection 内的项的从零开始的索引。
//
// 返回结果:
// System.Drawing.Rectangle,表示指定的 System.Windows.Forms.ListViewItem 的边框。
public Rectangle GetItemRect(int index);
//
// 摘要:
// 在列表视图控件中检索指定项的边框的指定部分。
//
// 参数:
// index:
// 位于要返回其边框的 System.Windows.Forms.ListView.ListViewItemCollection 内的项的从零开始的索引。
//
// portion:
// System.Windows.Forms.ItemBoundsPortion 值之一,表示要为其检索边框的 System.Windows.Forms.ListViewItem
// 的一部分。
//
// 返回结果:
// System.Drawing.Rectangle,表示指定 System.Windows.Forms.ListViewItem 的指定部分的边框。
public Rectangle GetItemRect(int index, ItemBoundsPortion portion);
//
// 摘要:
// 在给定一个点的情况下,提供项信息。
//
// 参数:
// point:
// System.Drawing.Point,将检索该处的项信息。坐标相对于控件的左上角。
//
// 返回结果:
// System.Windows.Forms.ListViewHitTestInfo。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// 点包含小于 0 的坐标。
public ListViewHitTestInfo HitTest(Point point);
//
// 摘要:
// 在给定 X 和 Y 坐标的情况下,提供项信息。
//
// 参数:
// x:
// 要在该处检索项信息的 X 坐标。该坐标相对于控件的左上角。
//
// y:
// 要在该处检索项信息的 Y 坐标。该坐标相对于控件的左上角。
//
// 返回结果:
// System.Windows.Forms.ListViewHitTestInfo。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// X 坐标或 Y 坐标小于 0。
public ListViewHitTestInfo HitTest(int x, int y);
//
// 摘要:
// 强制重新绘制某个范围内的 System.Windows.Forms.ListViewItem。
//
// 参数:
// startIndex:
// 要重新绘制的范围中第一个项的索引。
//
// endIndex:
// 要重新绘制的范围中最后一个项的索引。
//
// invalidateOnly:
// 若为 true,则使项的范围无效;若为 false,则使项无效并重新绘制项。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// startIndex 或 endIndex 小于 0,大于或等于 System.Windows.Forms.ListView 中的项数;或者对于虚拟模式,大于
// System.Windows.Forms.ListView.VirtualListSize 的值。- 或 -给定的 startIndex 大于 endIndex.
[EditorBrowsable(EditorBrowsableState.Advanced)]
public void RedrawItems(int startIndex, int endIndex, bool invalidateOnly);
//
// 摘要:
// 对列表视图的项进行排序。
public void Sort();
//
// 摘要:
// 返回 System.Windows.Forms.ListView 控件的字符串表示形式。
//
// 返回结果:
// 一个字符串,其中的信息表明了控件类型、System.Windows.Forms.ListView 控件中的项的计数以及 System.Windows.Forms.ListView
// 中的第一个项的类型(如果计数不为 0)。
public override string ToString();
//
// 摘要:
// 重写 System.Windows.Forms.Control.CreateHandle。
protected override void CreateHandle();
//
// 摘要:
// 释放由 System.Windows.Forms.ListView 占用的非托管资源,还可以另外再释放托管资源。
//
// 参数:
// disposing:
// 如果为 true,则释放托管资源和非托管资源;如果为 false,则仅释放非托管资源。
protected override void Dispose(bool disposing);
//
// 参数:
// keyData:
// System.Windows.Forms.Keys 值之一。
//
// 返回结果:
// 如果指定的键是常规输入键,则为 true;否则为 false。
protected override bool IsInputKey(Keys keyData);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.AfterLabelEdit 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.LabelEditEventArgs。
protected virtual void OnAfterLabelEdit(LabelEditEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.Control.BackgroundImageChanged 事件。
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnBackgroundImageChanged(EventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.BeforeLabelEdit 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.LabelEditEventArgs。
protected virtual void OnBeforeLabelEdit(LabelEditEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.CacheVirtualItems 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.CacheVirtualItemsEventArgs。
protected virtual void OnCacheVirtualItems(CacheVirtualItemsEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ColumnClick 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ColumnClickEventArgs。
protected virtual void OnColumnClick(ColumnClickEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ColumnReordered 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ColumnReorderedEventArgs。
protected virtual void OnColumnReordered(ColumnReorderedEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ColumnWidthChanged 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ColumnWidthChangedEventArgs。
protected virtual void OnColumnWidthChanged(ColumnWidthChangedEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ColumnWidthChanging 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ColumnWidthChangingEventArgs。
protected virtual void OnColumnWidthChanging(ColumnWidthChangingEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.DrawColumnHeader 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.DrawListViewColumnHeaderEventArgs。
protected virtual void OnDrawColumnHeader(DrawListViewColumnHeaderEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.DrawItem 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.DrawListViewItemEventArgs。
protected virtual void OnDrawItem(DrawListViewItemEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.DrawSubItem 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.DrawListViewSubItemEventArgs。
protected virtual void OnDrawSubItem(DrawListViewSubItemEventArgs e);
//
// 摘要:
// 引发 FontChanged 事件。
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnFontChanged(EventArgs e);
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnHandleCreated(EventArgs e);
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnHandleDestroyed(EventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ItemActivate 事件。
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected virtual void OnItemActivate(EventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ItemCheck 事件。
//
// 参数:
// ice:
// 包含事件数据的 System.Windows.Forms.ItemCheckEventArgs。
protected virtual void OnItemCheck(ItemCheckEventArgs ice);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ItemChecked 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ItemCheckedEventArgs。
protected virtual void OnItemChecked(ItemCheckedEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ItemDrag 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ItemDragEventArgs。
protected virtual void OnItemDrag(ItemDragEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ItemMouseHover 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ListViewItemMouseHoverEventArgs。
protected virtual void OnItemMouseHover(ListViewItemMouseHoverEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.ItemSelectionChanged 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ListViewItemSelectionChangedEventArgs。
protected virtual void OnItemSelectionChanged(ListViewItemSelectionChangedEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.Control.MouseHover 事件。
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnMouseHover(EventArgs e);
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnMouseLeave(EventArgs e);
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnParentChanged(EventArgs e);
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnResize(EventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.RetrieveVirtualItem 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.RetrieveVirtualItemEventArgs。
protected virtual void OnRetrieveVirtualItem(RetrieveVirtualItemEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.RightToLeftLayoutChanged 事件。
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
[EditorBrowsable(EditorBrowsableState.Advanced)]
protected virtual void OnRightToLeftLayoutChanged(EventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.SearchForVirtualItem 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.SearchForVirtualItemEventArgs。
protected virtual void OnSearchForVirtualItem(SearchForVirtualItemEventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.SelectedIndexChanged 事件。
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected virtual void OnSelectedIndexChanged(EventArgs e);
//
// 参数:
// e:
// 包含事件数据的 System.EventArgs。
protected override void OnSystemColorsChanged(EventArgs e);
//
// 摘要:
// 引发 System.Windows.Forms.ListView.VirtualItemsSelectionRangeChanged 事件。
//
// 参数:
// e:
// 包含事件数据的 System.Windows.Forms.ListViewVirtualItemsSelectionRangeChangedEventArgs。
protected virtual void OnVirtualItemsSelectionRangeChanged(ListViewVirtualItemsSelectionRangeChangedEventArgs e);
//
// 摘要:
// 初始化用于管理控件外观的 System.Windows.Forms.ListView 控件属性。
protected void RealizeProperties();
//
// 摘要:
// 更新应用于列表视图控件的扩展样式。
protected void UpdateExtendedStyles();
//
// 摘要:
// 重写 System.Windows.Forms.Control.WndProc(System.Windows.Forms.Message@)。
//
// 参数:
// m:
// 要处理的 WindowsSystem.Windows.Forms.Message。
protected override void WndProc(ref Message m); //
// 摘要:
// 表示包含列表视图控件中选中项的索引的集合。
[DefaultMember("Item")]
[ListBindable(false)]
public class CheckedIndexCollection : IList, ICollection, IEnumerable
{
//
// 摘要:
// 初始化 System.Windows.Forms.ListView.CheckedIndexCollection 类的新实例。
//
// 参数:
// owner:
// 拥有该集合的 System.Windows.Forms.ListView 控件。
public CheckedIndexCollection(ListView owner); //
// 摘要:
// 获取集合中指定索引处的索引值。
//
// 参数:
// index:
// 要检索的项在集合中的索引。
//
// 返回结果:
// 存储在指定位置的 System.Windows.Forms.ListView.ListViewItemCollection 中的索引值。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于等于 System.Windows.Forms.ListView.CheckedIndexCollection 的 System.Windows.Forms.ListView.CheckedIndexCollection.Count
// 属性的值。
public int this[int index] { get; } //
// 摘要:
// 获取集合中项的数目。
//
// 返回结果:
// 集合中的项数。
[Browsable(false)]
public int Count { get; }
//
// 摘要:
// 获取一个值,该值指示集合是否为只读。
//
// 返回结果:
// 如果该集合为只读,则为 true;否则为 false。
public bool IsReadOnly { get; } //
// 摘要:
// 确定指定索引是否位于集合中。
//
// 参数:
// checkedIndex:
// 要在集合中定位的索引。
//
// 返回结果:
// 如果 System.Windows.Forms.ListView 的 System.Windows.Forms.ListView.ListViewItemCollection
// 中的指定索引是集合中的项,则为 true;否则为 false。
public bool Contains(int checkedIndex);
//
// 摘要:
// 返回一个可用于循环访问选定索引集合的枚举数。
//
// 返回结果:
// System.Collections.IEnumerator,表示选中的索引集合。
public IEnumerator GetEnumerator();
//
// 摘要:
// 从列表视图控件的 System.Windows.Forms.ListView.ListViewItemCollection 返回指定索引的 System.Windows.Forms.ListView.CheckedIndexCollection
// 中的索引。
//
// 参数:
// checkedIndex:
// 要在集合中查找的 System.Windows.Forms.ListView.ListViewItemCollection 中从零开始的索引。
//
// 返回结果:
// 如果指定的 System.Windows.Forms.ListView.ListViewItemCollection 索引在 System.Windows.Forms.ListView.CheckedIndexCollection
// 中,则为在集合中的从零开始的索引;否则为 -1。
public int IndexOf(int checkedIndex);
}
//
// 摘要:
// 表示列表视图控件中选中项的集合。
[DefaultMember("Item")]
[ListBindable(false)]
public class CheckedListViewItemCollection : IList, ICollection, IEnumerable
{
//
// 摘要:
// 初始化 System.Windows.Forms.ListView.CheckedListViewItemCollection 类的新实例。
//
// 参数:
// owner:
// 拥有该集合的 System.Windows.Forms.ListView 控件。
public CheckedListViewItemCollection(ListView owner); //
// 摘要:
// 从集合中获取具有指定键的项。
//
// 参数:
// key:
// 集合中要检索的项的键。
//
// 返回结果:
// 一个 System.Windows.Forms.ListViewItem,表示集合中具有指定索引的项。
//
// 异常:
// T:System.InvalidOperationException:
// 所有者 System.Windows.Forms.ListView 处于虚拟模式下。
public virtual ListViewItem this[string key] { get; }
//
// 摘要:
// 获取集合中指定索引处的项。
//
// 参数:
// index:
// 要检索的项在集合中的索引。
//
// 返回结果:
// System.Windows.Forms.ListViewItem,表示位于集合内指定索引处的项。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于等于 System.Windows.Forms.ListView.CheckedListViewItemCollection
// 的 System.Windows.Forms.ListView.CheckedListViewItemCollection.Count 属性的值。
//
// T:System.InvalidOperationException:
// System.Windows.Forms.ListView 处于虚拟模式下。
public ListViewItem this[int index] { get; } //
// 摘要:
// 获取集合中项的数目。
//
// 返回结果:
// 集合中的项数。
[Browsable(false)]
public int Count { get; }
//
// 摘要:
// 获取一个值,该值指示集合是否为只读。
//
// 返回结果:
// 如果该集合为只读,则为 true;否则为 false。
public bool IsReadOnly { get; } //
// 摘要:
// 确定指定项是否位于集合内。
//
// 参数:
// item:
// System.Windows.Forms.ListViewItem,表示要在集合中查找的项。
//
// 返回结果:
// 如果指定项位于集合中,则为 true;否则为 false。
public bool Contains(ListViewItem item);
//
// 摘要:
// 确定具有指定键的列是否包含在集合中。
//
// 参数:
// key:
// 要搜索的项的名称。
//
// 返回结果:
// true 如果具有指定键的项包含在集合中;否则, false.
//
// 异常:
// T:System.InvalidOperationException:
// 所有者 System.Windows.Forms.ListView 处于虚拟模式下。
public virtual bool ContainsKey(string key);
//
// 摘要:
// 将整个集合复制到现有数组中,从该数组内的指定位置开始复制。
//
// 参数:
// dest:
// System.Array,表示要将该集合的内容复制到的数组。
//
// index:
// 集合中的项将复制到的目标数组中的位置。
public void CopyTo(Array dest, int index);
//
// 摘要:
// 返回一个可用于循环访问选定的项集合的枚举数。
//
// 返回结果:
// 一个 System.Collections.IEnumerator,表示选中项的集合。
public IEnumerator GetEnumerator();
//
// 摘要:
// 返回指定的项在集合中的索引。
//
// 参数:
// item:
// System.Windows.Forms.ListViewItem,表示要在集合中查找的项。
//
// 返回结果:
// 集合中项的从零开始的索引;否则为 -1。
public int IndexOf(ListViewItem item);
//
// 摘要:
// 确定具有指定键的项的索引。
//
// 参数:
// key:
// 要为其检索索引的项的名称。
//
// 返回结果:
// 如果找到,则为该具有指定名称的 System.Windows.Forms.ListViewItem 的从零开始的索引;否则为 -1。
//
// 异常:
// T:System.InvalidOperationException:
// 所有者 System.Windows.Forms.ListView 处于虚拟模式下。
public virtual int IndexOfKey(string key);
}
//
// 摘要:
// 表示 System.Windows.Forms.ListView 控件中列标题的集合。
[DefaultMember("Item")]
[ListBindable(false)]
public class ColumnHeaderCollection : IList, ICollection, IEnumerable
{
//
// 摘要:
// 初始化 System.Windows.Forms.ListView.ColumnHeaderCollection 类的新实例。
//
// 参数:
// owner:
// 拥有该集合的 System.Windows.Forms.ListView。
public ColumnHeaderCollection(ListView owner); //
// 摘要:
// 获取集合中具有指定键的列标题。
//
// 参数:
// key:
// 要从集合中检索的列标题的名称。
//
// 返回结果:
// 带有指定键的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader this[string key] { get; }
//
// 摘要:
// 获取集合中指定索引处的列标题。
//
// 参数:
// index:
// 要从集合中检索的列标题的索引。
//
// 返回结果:
// System.Windows.Forms.ColumnHeader,表示位于集合内指定索引处的列标题。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 小于 0,或者大于或等于 System.Windows.Forms.ListView.ColumnHeaderCollection 的 System.Windows.Forms.ListView.ColumnHeaderCollection.Count
// 属性的值。
public virtual ColumnHeader this[int index] { get; } //
// 摘要:
// 获取集合中项的数目。
//
// 返回结果:
// 集合中的项数。
[Browsable(false)]
public int Count { get; }
//
// 摘要:
// 获取一个值,该值指示集合是否为只读。
//
// 返回结果:
// 如果该集合为只读,则为 true;否则为 false。
public bool IsReadOnly { get; } //
// 摘要:
// 创建具有指定文本的列并将其添加到集合。
//
// 参数:
// text:
// 要在列标题中显示的文本。
//
// 返回结果:
// 添加到 System.Windows.Forms.ListView.ColumnHeaderCollection 的具有指定文本的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader Add(string text);
//
// 摘要:
// 将现有的 System.Windows.Forms.ColumnHeader 添加到集合中。
//
// 参数:
// value:
// 要添加到集合中的 System.Windows.Forms.ColumnHeader。
//
// 返回结果:
// 已添加项的集合中的从零开始的索引。
public virtual int Add(ColumnHeader value);
//
// 摘要:
// 创建具有指定的文本和键的列并将其添加到集合。
//
// 参数:
// key:
// 要添加到集合的 System.Windows.Forms.ColumnHeader 的键。
//
// text:
// 要添加到集合的 System.Windows.Forms.ColumnHeader 的文本。
//
// 返回结果:
// 添加到 System.Windows.Forms.ListView.ColumnHeaderCollection 的具有指定键和文本的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader Add(string key, string text);
//
// 摘要:
// 创建具有指定的文本和宽度的列并将其添加到集合。
//
// 参数:
// text:
// 要添加到集合的 System.Windows.Forms.ColumnHeader 的文本。
//
// width:
// 要添加到集合的 System.Windows.Forms.ColumnHeader 的宽度。
//
// 返回结果:
// 添加到 System.Windows.Forms.ListView.ColumnHeaderCollection 的具有指定文本和宽度的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader Add(string text, int width);
//
// 摘要:
// 创建具有指定的文本、键和宽度的列并将其添加到集合。
//
// 参数:
// key:
// 列标题的键。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// System.Windows.Forms.ColumnHeader 的初始宽度。
//
// 返回结果:
// 添加到集合的具有给定文本、键和宽度的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader Add(string key, string text, int width);
//
// 摘要:
// 将列标题添至具有指定文本、宽度和对齐方式设置的集合。
//
// 参数:
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度。
//
// textAlign:
// System.Windows.Forms.HorizontalAlignment 值之一。
//
// 返回结果:
// 已创建并已添至集合的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader Add(string text, int width, HorizontalAlignment textAlign);
//
// 摘要:
// 创建具有指定键、对齐文本、宽度和图像索引的列并将其添加到集合。
//
// 参数:
// key:
// 列标题的键。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度。
//
// textAlign:
// System.Windows.Forms.HorizontalAlignment 值之一。
//
// imageIndex:
// 要显示在列中的图像的索引值。
//
// 返回结果:
// 已添加到集合的具有指定键、对齐文本、宽度和图像索引的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader Add(string key, string text, int width, HorizontalAlignment textAlign, int imageIndex);
//
// 摘要:
// 创建具有指定键、对齐文本、宽度和图像键的列并将其添加到集合。
//
// 参数:
// key:
// 列标题的键。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度。
//
// textAlign:
// System.Windows.Forms.HorizontalAlignment 值之一。
//
// imageKey:
// 要显示在列标题中的图像的键值。
//
// 返回结果:
// 已添加到集合的具有指定键、对齐文本、宽度和图像键的 System.Windows.Forms.ColumnHeader。
public virtual ColumnHeader Add(string key, string text, int width, HorizontalAlignment textAlign, string imageKey);
//
// 摘要:
// 给集合添加列标题数组。
//
// 参数:
// values:
// 要添加到集合中的 System.Windows.Forms.ColumnHeader 对象的数组。
public virtual void AddRange(ColumnHeader[] values);
//
// 摘要:
// 从集合中移除所有列标题。
public virtual void Clear();
//
// 摘要:
// 确定指定列标题是否位于集合内。
//
// 参数:
// value:
// 表示要在集合中查找的列标题的 System.Windows.Forms.ColumnHeader。
//
// 返回结果:
// 如果集合包含该列标题,则为 true;否则为 false。
public bool Contains(ColumnHeader value);
//
// 摘要:
// 确定具有指定键的列是否包含在集合中。
//
// 参数:
// key:
// 要搜索的列的名称。
//
// 返回结果:
// 如果集合包含具有指定名称的列,则为 true;否则为 false。
public virtual bool ContainsKey(string key);
//
// 摘要:
// 返回要用于循环访问列标题集合的枚举数。
//
// 返回结果:
// System.Collections.IEnumerator,表示列标题集合。
public IEnumerator GetEnumerator();
//
// 摘要:
// 返回指定的列标题在集合中的索引。
//
// 参数:
// value:
// 表示要在集合中查找的列标题的 System.Windows.Forms.ColumnHeader。
//
// 返回结果:
// 集合中列标题位置的从零开始的索引。如果列题不在集合中,则返回值为 -1。
public int IndexOf(ColumnHeader value);
//
// 摘要:
// 确定具有指定键的列的索引。
//
// 参数:
// key:
// 要检索其索引的列的名称。
//
// 返回结果:
// 如果找到具有指定名称的列,则为第一个匹配项的从零开始的索引;否则为 -1。
public virtual int IndexOfKey(string key);
//
// 摘要:
// 创建具有指定文本的新列标题,并将其插入到集合中指定索引处。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// text:
// 要在列标题中显示的文本。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 小于 0,或者大于或等于 System.Windows.Forms.ListView.ColumnHeaderCollection 的 System.Windows.Forms.ListView.ColumnHeaderCollection.Count
// 属性的值。
public void Insert(int index, string text);
//
// 摘要:
// 将现有的列标题插入到集合中的指定索引位置。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// value:
// 要插入到集合中的 System.Windows.Forms.ColumnHeader。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 小于 0,或者大于或等于 System.Windows.Forms.ListView.ColumnHeaderCollection 的 System.Windows.Forms.ListView.ColumnHeaderCollection.Count
// 属性的值。
public void Insert(int index, ColumnHeader value);
//
// 摘要:
// 创建具有指定的文本和键的新列标题,并将其插入到集合中指定索引处。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// key:
// 列标题的名称。
//
// text:
// 要在列标题中显示的文本。
public void Insert(int index, string key, string text);
//
// 摘要:
// 创建具有指定文本和初始宽度的新列标题,并将其插入到集合中指定索引处。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度,单位为像素。
public void Insert(int index, string text, int width);
//
// 摘要:
// 创建具有指定的文本、键和宽度的新列标题,并将其插入到集合中指定索引处。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// key:
// 列标题的名称。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度,单位为像素。
public void Insert(int index, string key, string text, int width);
//
// 摘要:
// 新建列标题并将它插入集合中的指定索引位置。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度。设置为 -1,则将列标题的大小自动调整为列中最大子项文本的大小,或者设置为 -2,则将列标题的大小自动调整为列标题的文本的大小。
//
// textAlign:
// System.Windows.Forms.HorizontalAlignment 值之一。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 小于 0 或者大于等于 System.Windows.Forms.ListView.ColumnHeaderCollection 的 System.Windows.Forms.ListView.ColumnHeaderCollection.Count
// 属性的值。
public void Insert(int index, string text, int width, HorizontalAlignment textAlign);
//
// 摘要:
// 创建具有指定的对齐文本、键、宽度和图像索引的新列标题,并将其插入到集合中指定索引处。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// key:
// 列标题的名称。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度,单位为像素。
//
// textAlign:
// System.Windows.Forms.HorizontalAlignment 值之一。
//
// imageIndex:
// 要显示在列标题上的图像的索引。
public void Insert(int index, string key, string text, int width, HorizontalAlignment textAlign, int imageIndex);
//
// 摘要:
// 创建具有指定的对齐文本、键、宽度和图像键的新列标题,并将其插入到集合中指定索引处。
//
// 参数:
// index:
// 插入列标题处的从零开始的索引位置。
//
// key:
// 列标题的名称。
//
// text:
// 要在列标题中显示的文本。
//
// width:
// 列标题的初始宽度,单位为像素。
//
// textAlign:
// System.Windows.Forms.HorizontalAlignment 值之一。
//
// imageKey:
// 要显示在列标题上的图像的键。
public void Insert(int index, string key, string text, int width, HorizontalAlignment textAlign, string imageKey);
//
// 摘要:
// 从集合中移除指定的列标题。
//
// 参数:
// column:
// System.Windows.Forms.ColumnHeader,表示要从集合中移除的列标题。
public virtual void Remove(ColumnHeader column);
//
// 摘要:
// 移除集合中指定索引处的列标题。
//
// 参数:
// index:
// 要移除的列标题的从零开始的索引。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 小于 0,或者大于或等于 System.Windows.Forms.ListView.ColumnHeaderCollection 的 System.Windows.Forms.ListView.ColumnHeaderCollection.Count
// 属性的值。
public virtual void RemoveAt(int index);
//
// 摘要:
// 从集合中移除具有指定键的列。
//
// 参数:
// key:
// 要从集合中移除的列的名称。
public virtual void RemoveByKey(string key);
}
//
// 摘要:
// 表示 System.Windows.Forms.ListView 控件中的项的集合或指定给 System.Windows.Forms.ListViewGroup
// 的项的集合。
[DefaultMember("Item")]
[ListBindable(false)]
public class ListViewItemCollection : IList, ICollection, IEnumerable
{
//
// 摘要:
// 初始化 System.Windows.Forms.ListView.ListViewItemCollection 类的新实例。
//
// 参数:
// owner:
// 拥有该集合的 System.Windows.Forms.ListView。
public ListViewItemCollection(ListView owner); //
// 摘要:
// 检索具有指定键的项。
//
// 参数:
// key:
// 要检索的项的名称。
//
// 返回结果:
// System.Windows.Forms.ListViewItem,其 System.Windows.Forms.ListViewItem.Name 属性与指定键匹配。
public virtual ListViewItem this[string key] { get; }
//
// 摘要:
// 获取或设置集合中指定索引处的项。
//
// 参数:
// index:
// 集合中要获取或设置的项的索引。
//
// 返回结果:
// System.Windows.Forms.ListViewItem,表示位于集合内指定索引处的项。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于等于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public virtual ListViewItem this[int index] { get; set; } //
// 摘要:
// 获取集合中项的数目。
//
// 返回结果:
// 集合中的项数。
[Browsable(false)]
public int Count { get; }
//
// 摘要:
// 获取一个值,该值指示集合是否为只读。
//
// 返回结果:
// 如果该集合为只读,则为 true;否则为 false。
public bool IsReadOnly { get; } //
// 摘要:
// 将现有的 System.Windows.Forms.ListViewItem 添加到集合中。
//
// 参数:
// value:
// 要添加到集合中的 System.Windows.Forms.ListViewItem。
//
// 返回结果:
// 已添加到集合中的 System.Windows.Forms.ListViewItem。
public virtual ListViewItem Add(ListViewItem value);
//
// 摘要:
// 用指定的文本创建一个项并将该项添加到集合中。
//
// 参数:
// text:
// 要为该项显示的文本。
//
// 返回结果:
// 已添加到集合中的 System.Windows.Forms.ListViewItem。
public virtual ListViewItem Add(string text);
//
// 摘要:
// 用指定的文本和图像创建一个项并将该项添加到集合中。
//
// 参数:
// text:
// 项的文本。
//
// imageKey:
// 要为该项显示的图像的键。
//
// 返回结果:
// 添加到集合中的 System.Windows.Forms.ListViewItem。
public virtual ListViewItem Add(string text, string imageKey);
//
// 摘要:
// 用指定的文本和图像创建一个项并将该项添加到集合中。
//
// 参数:
// text:
// 项的文本。
//
// imageIndex:
// 要为该项显示的图像的索引。
//
// 返回结果:
// 已添加到集合中的 System.Windows.Forms.ListViewItem。
public virtual ListViewItem Add(string text, int imageIndex);
//
// 摘要:
// 用指定的键、文本和图像创建一个项并将该项添加到集合中。
//
// 参数:
// key:
// 项的名称。
//
// text:
// 项的文本。
//
// imageIndex:
// 要为该项显示的图像的索引。
//
// 返回结果:
// 添加到集合中的 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.InvalidOperationException:
// 包含 System.Windows.Forms.ListView 处于虚拟模式下。
public virtual ListViewItem Add(string key, string text, int imageIndex);
//
// 摘要:
// 用指定的键、文本和图像创建一个项并将该项添加到集合中。
//
// 参数:
// key:
// 项的名称。
//
// text:
// 项的文本。
//
// imageKey:
// 要为该项显示的图像的键。
//
// 返回结果:
// 添加到集合中的 System.Windows.Forms.ListViewItem。
public virtual ListViewItem Add(string key, string text, string imageKey);
//
// 摘要:
// 向集合中添加项的集合。
//
// 参数:
// items:
// 要添加到集合中的 System.Windows.Forms.ListView.ListViewItemCollection。
//
// 异常:
// T:System.ArgumentNullException:
// items 为 null。
//
// T:System.InvalidOperationException:
// 包含 System.Windows.Forms.ListView 处于虚拟模式下。
public void AddRange(ListViewItemCollection items);
//
// 摘要:
// 向集合中添加 System.Windows.Forms.ListViewItem 对象的数组。
//
// 参数:
// items:
// 要添加到集合中的 System.Windows.Forms.ListViewItem 对象的数组。
//
// 异常:
// T:System.ArgumentNullException:
// items 为 null。
public void AddRange(ListViewItem[] items);
//
// 摘要:
// 从集合中移除所有项。
public virtual void Clear();
//
// 摘要:
// 确定指定项是否位于集合内。
//
// 参数:
// item:
// System.Windows.Forms.ListViewItem,表示要在集合中查找的项。
//
// 返回结果:
// 如果集合中包含该项,则为 true;否则为 false。
public bool Contains(ListViewItem item);
//
// 摘要:
// 确定集合是否包含具有指定键的项。
//
// 参数:
// key:
// 要搜索的项的名称。
//
// 返回结果:
// 如果集合包含具有指定键的项,则为 true;否则为 false。
public virtual bool ContainsKey(string key);
//
// 摘要:
// 将整个集合复制到现有数组中,从该数组内的指定位置开始复制。
//
// 参数:
// dest:
// System.Array,表示要将该集合的内容复制到的数组。
//
// index:
// 集合中的项将复制到的目标数组中的位置。
public void CopyTo(Array dest, int index);
//
// 摘要:
// 搜索名称与指定键匹配的项,也可以选择搜索子项。
//
// 参数:
// key:
// 要搜索的项名称。
//
// searchAllSubItems:
// 若要搜索子项,则为 true;否则为 false。
//
// 返回结果:
// System.Windows.Forms.ListViewItem 类型数组。
public ListViewItem[] Find(string key, bool searchAllSubItems);
//
// 摘要:
// 返回一个枚举数,将使用该枚举数循环访问项集合。
//
// 返回结果:
// System.Collections.IEnumerator,表示项集合。
//
// 异常:
// T:System.InvalidOperationException:
// 所有者 System.Windows.Forms.ListView 处于虚拟模式下。
public IEnumerator GetEnumerator();
//
// 摘要:
// 返回指定的项在集合中的索引。
//
// 参数:
// item:
// System.Windows.Forms.ListViewItem,表示要在集合中查找的项。
//
// 返回结果:
// 项在集合中的位置的从零开始的索引;如果项不在集合中,则为 -1。
public int IndexOf(ListViewItem item);
//
// 摘要:
// 检索具有指定键的项的索引。
//
// 参数:
// key:
// 要在集合中查找的项的名称。
//
// 返回结果:
// 如果找到具有指定键的项,则为第一个匹配项的从零开始的索引;否则为 -1。
public virtual int IndexOfKey(string key);
//
// 摘要:
// 创建一个新项,并将其插入到集合中的指定索引处。
//
// 参数:
// index:
// 插入项的从零开始的索引位置。
//
// text:
// 要为该项显示的文本。
//
// 返回结果:
// 已插入到集合中的 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public ListViewItem Insert(int index, string text);
//
// 摘要:
// 将现有的 System.Windows.Forms.ListViewItem 插入到集合中的指定索引处。
//
// 参数:
// index:
// 插入项的从零开始的索引位置。
//
// item:
// System.Windows.Forms.ListViewItem,表示要插入的项。
//
// 返回结果:
// 已插入到集合中的 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public ListViewItem Insert(int index, ListViewItem item);
//
// 摘要:
// 创建一个具有指定的文本和图像的新项,并将该项插入到集合中指定索引处。
//
// 参数:
// index:
// 插入项的从零开始的索引位置。
//
// text:
// System.Windows.Forms.ListViewItem 的文本。
//
// imageKey:
// 要为该项显示的图像的键。
//
// 返回结果:
// 添加到集合中的 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public ListViewItem Insert(int index, string text, string imageKey);
//
// 摘要:
// 创建具有指定图像索引的新项,并将其插入到集合中的指定索引处。
//
// 参数:
// index:
// 插入项的从零开始的索引位置。
//
// text:
// 要为该项显示的文本。
//
// imageIndex:
// 要为该项显示的图像的索引。
//
// 返回结果:
// 已插入到集合中的 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public ListViewItem Insert(int index, string text, int imageIndex);
//
// 摘要:
// 创建一个具有指定的键、文本和图像的新项,并将该项插入到集合中指定索引处。
//
// 参数:
// index:
// 插入项的从零开始的索引位置
//
// key:
// 项的 System.Windows.Forms.ListViewItem.Name。
//
// text:
// 项的文本。
//
// imageIndex:
// 要为该项显示的图像的索引。
//
// 返回结果:
// 添加到集合中的 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public virtual ListViewItem Insert(int index, string key, string text, int imageIndex);
//
// 摘要:
// 创建一个具有指定的键、文本和图像的新项,并将该项添加到集合中指定索引处。
//
// 参数:
// index:
// 插入项的从零开始的索引位置。
//
// key:
// 项的 System.Windows.Forms.ListViewItem.Name。
//
// text:
// 项的文本。
//
// imageKey:
// 要为该项显示的图像的键。
//
// 返回结果:
// 添加到集合中的 System.Windows.Forms.ListViewItem。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public virtual ListViewItem Insert(int index, string key, string text, string imageKey);
//
// 摘要:
// 从集合中移除指定的项。
//
// 参数:
// item:
// System.Windows.Forms.ListViewItem,表示要从集合中移除的项。
//
// 异常:
// T:System.ArgumentException:
// 分配给 item 参数的 System.Windows.Forms.ListViewItem 是 null。
public virtual void Remove(ListViewItem item);
//
// 摘要:
// 移除集合中指定索引处的项。
//
// 参数:
// index:
// 从零开始的索引(属于要移除的项)。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于等于 System.Windows.Forms.ListView.ListViewItemCollection 的 System.Windows.Forms.ListView.ListViewItemCollection.Count
// 属性的值。
public virtual void RemoveAt(int index);
//
// 摘要:
// 从集合中移除具有指定键的项。
//
// 参数:
// key:
// 要从集合中移除的项的名称。
public virtual void RemoveByKey(string key);
}
//
// 摘要:
// 表示包含 System.Windows.Forms.ListView 控件中选定项的索引的集合。
[DefaultMember("Item")]
[ListBindable(false)]
public class SelectedIndexCollection : IList, ICollection, IEnumerable
{
//
// 摘要:
// 初始化 System.Windows.Forms.ListView.SelectedIndexCollection 类的新实例。
//
// 参数:
// owner:
// 拥有该集合的 System.Windows.Forms.ListView 控件。
public SelectedIndexCollection(ListView owner); //
// 摘要:
// 获取集合中指定索引处的索引值。
//
// 参数:
// index:
// 要检索的项在集合中的索引。
//
// 返回结果:
// 存储在指定位置的 System.Windows.Forms.ListView.ListViewItemCollection 中的索引值。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 小于 0 或者大于等于 System.Windows.Forms.ListView.SelectedIndexCollection 的 System.Windows.Forms.ListView.SelectedIndexCollection.Count
// 属性的值。
public int this[int index] { get; } //
// 摘要:
// 获取集合中项的数目。
//
// 返回结果:
// 集合中的项数。
[Browsable(false)]
public int Count { get; }
//
// 摘要:
// 获取一个值,该值指示集合是否为只读。
//
// 返回结果:
// 如果该集合为只读,则为 true;否则为 false。
public bool IsReadOnly { get; } //
// 摘要:
// 将 System.Windows.Forms.ListView.Items 数组中指定索引处的项添加到集合。
//
// 参数:
// itemIndex:
// 要添加到 System.Windows.Forms.ListView.SelectedIndexCollection 的 System.Windows.Forms.ListView.Items
// 集合中的项的索引。
//
// 返回结果:
// System.Windows.Forms.ListView.SelectedIndexCollection 中的项数。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// 指定的索引小于 0,或者大于等于所有者 System.Windows.Forms.ListView 中的项数。- 或 -所有者 System.Windows.Forms.ListView
// 处于虚拟模式下,而指定的索引小于 0,或者大于等于 System.Windows.Forms.ListView.VirtualListSize 的值。
public int Add(int itemIndex);
//
// 摘要:
// 清除集合中的项。
public void Clear();
//
// 摘要:
// 确定指定索引是否位于集合中。
//
// 参数:
// selectedIndex:
// 要在集合中定位的索引。
//
// 返回结果:
// 如果 System.Windows.Forms.ListView 的 System.Windows.Forms.ListView.ListViewItemCollection
// 中的指定索引是集合中的项,则为 true;否则为 false。
public bool Contains(int selectedIndex);
//
// 摘要:
// 将整个集合复制到现有数组中,从该数组内的指定位置开始复制。
//
// 参数:
// dest:
// System.Array,表示要将该集合的内容复制到的数组。
//
// index:
// 集合中的项将复制到的目标数组中的位置。
public void CopyTo(Array dest, int index);
//
// 摘要:
// 返回可用于循环访问选定索引集合的枚举数。
//
// 返回结果:
// 一个表示选定的索引集合的 System.Collections.IEnumerator。
public IEnumerator GetEnumerator();
//
// 摘要:
// 从 System.Windows.Forms.ListView 控件的 System.Windows.Forms.ListView.ListViewItemCollection
// 中返回指定索引的 System.Windows.Forms.ListView.SelectedIndexCollection 内的索引。
//
// 参数:
// selectedIndex:
// 要在集合中查找的 System.Windows.Forms.ListView.ListViewItemCollection 中从零开始的索引。
//
// 返回结果:
// System.Windows.Forms.ListView.ListViewItemCollection 的指定索引在 System.Windows.Forms.ListView.SelectedIndexCollection
// 内所在的集合中的索引(索引从零开始计算);如果索引不在该集合中则为 -1。
public int IndexOf(int selectedIndex);
//
// 摘要:
// 从 System.Windows.Forms.ListView.SelectedIndexCollection 中移除 System.Windows.Forms.ListView.Items
// 集合中指定索引处的项。
//
// 参数:
// itemIndex:
// 要从 System.Windows.Forms.ListView.SelectedIndexCollection 内移除的 System.Windows.Forms.ListView.Items
// 集合中的项的索引。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// 指定的索引小于 0,或者大于等于所有者 System.Windows.Forms.ListView 中的项数。- 或 -所有者 System.Windows.Forms.ListView
// 处于虚拟模式下,而指定的索引小于 0,或者大于等于 System.Windows.Forms.ListView.VirtualListSize 的值。
public void Remove(int itemIndex);
}
//
// 摘要:
// 表示列表视图控件中选定项的集合。
[DefaultMember("Item")]
[ListBindable(false)]
public class SelectedListViewItemCollection : IList, ICollection, IEnumerable
{
//
// 摘要:
// 初始化 System.Windows.Forms.ListView.SelectedListViewItemCollection 类的新实例。
//
// 参数:
// owner:
// 拥有该集合的 System.Windows.Forms.ListView 控件。
public SelectedListViewItemCollection(ListView owner); //
// 摘要:
// 获取集合中具有指定键的项。
//
// 参数:
// key:
// 要从集合中检索的项的名称。
//
// 返回结果:
// 带有指定键的 System.Windows.Forms.ListViewItem。
public virtual ListViewItem this[string key] { get; }
//
// 摘要:
// 获取集合中指定索引处的项。
//
// 参数:
// index:
// 要检索的项在集合中的索引。
//
// 返回结果:
// System.Windows.Forms.ListViewItem,表示位于集合内指定索引处的项。
//
// 异常:
// T:System.ArgumentOutOfRangeException:
// index 参数小于零或大于等于 System.Windows.Forms.ListView.SelectedListViewItemCollection
// 的 System.Windows.Forms.ListView.ListViewItemCollection.Count 属性的值。
public ListViewItem this[int index] { get; } //
// 摘要:
// 获取集合中项的数目。
//
// 返回结果:
// 集合中的项数。
[Browsable(false)]
public int Count { get; }
//
// 摘要:
// 获取一个值,该值指示集合是否为只读。
//
// 返回结果:
// 如果该集合为只读,则为 true;否则为 false。
public bool IsReadOnly { get; } //
// 摘要:
// 从集合中移除所有项。
public void Clear();
//
// 摘要:
// 确定指定项是否位于集合内。
//
// 参数:
// item:
// System.Windows.Forms.ListViewItem,表示要在集合中查找的项。
//
// 返回结果:
// 如果指定项位于集合中,则为 true;否则为 false。
public bool Contains(ListViewItem item);
//
// 摘要:
// 确定集合中是否包含具有指定键的项。
//
// 参数:
// key:
// 要在集合中查找的项的名称。
//
// 返回结果:
// 如果指定的项包含在集合中,则为 true;否则为 false。
public virtual bool ContainsKey(string key);
//
// 摘要:
// 将整个集合复制到现有数组中,从该数组内的指定位置开始复制。
//
// 参数:
// dest:
// System.Array,表示要将该集合的内容复制到的数组。
//
// index:
// 集合中的项将复制到的目标数组中的位置。
public void CopyTo(Array dest, int index);
//
// 摘要:
// 返回可用于循环访问选定项集合的枚举数。
//
// 返回结果:
// System.Collections.IEnumerator,表示选定项的集合。
public IEnumerator GetEnumerator();
//
// 摘要:
// 返回指定的项在集合中的索引。
//
// 参数:
// item:
// System.Windows.Forms.ListViewItem,表示要在集合中查找的项。
//
// 返回结果:
// 集合中项的从零开始的索引。如果该项不在集合中,则返回值为负 1 (-1)。
public int IndexOf(ListViewItem item);
//
// 摘要:
// 返回具有指定键的项的第一个匹配项的索引。
//
// 参数:
// key:
// 要在集合中查找的项的名称。
//
// 返回结果:
// 具有指定键的第一个项的索引(从零开始)。
public virtual int IndexOfKey(string key);
}
}
}