{"id":3993,"date":"2012-04-05T12:31:00","date_gmt":"2012-04-05T20:31:00","guid":{"rendered":"http:\/\/www.sapien.com\/blog\/?p=3993"},"modified":"2012-04-11T09:06:02","modified_gmt":"2012-04-11T17:06:02","slug":"spotlight-on-the-listview-control-part-2","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2012\/04\/05\/spotlight-on-the-listview-control-part-2\/","title":{"rendered":"Spotlight on the ListView Control – Part 2"},"content":{"rendered":"

The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011 , details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms.<\/em><\/p>\n

In Part 1<\/a> of the Spotlight on the ListView Control we discussed a number of important properties. Here, in Part 2, we complete our look at the control’s properties and we will also cover some of the more important methods and events.<\/p>\n

Important Properties Continued:<\/font><\/span><\/strong><\/p>\n

Items<\/strong><\/p>\n

This property contains a collection of all the items in the ListView. All items in a ListView are represented by a ListViewItem object:<\/p>\n

ListViewItem<\/strong> [System.Windows.Forms.ListViewItem]<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n
Property<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
Checked<\/td>\nThis property indicates whether the item is checked.<\/td>\n<\/tr>\n
Text<\/td>\nThis property contains the displayed text of the item.<\/td>\n<\/tr>\n
ToolTipText<\/td>\nThis property contains the text shown when the mouse pointer rests on the ListViewItem.<\/td>\n<\/tr>\n
Group<\/td>\nThis property points to the group to which the item is assigned.
Set this property to any existing Group. All items with an unsigned Group will be show in the \u201cDefault\u201d Group.<\/td>\n<\/tr>\n
ImageIndex<\/td>\nThis property indicates the index of the image that is displayed for the item.<\/td>\n<\/tr>\n
StateImageIndex<\/td>\nThis property indicates the index of the state image (an image such as a selected or cleared check box that indicates the state of the item) that is displayed for the item.<\/td>\n<\/tr>\n
SubItems<\/td>\nThis property is a collection containing all subitems of the item.
Compatible Views: Details<\/em>, Tile
<\/em>
In the Details<\/em> view the Subitems will be displayed only if Columns are defined.
\"SubItem-Details4\"<\/a><\/p>\n

In the Tile<\/em> view only the first SubItem will be displayed (below the Item\u2019s text).
\"SubItem<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/blockquote>\n

Adding Items to the ListView:<\/em><\/strong><\/p>\n

You can access the Items Collection Editor via the Designer:<\/p>\n

\"Item-Collection-Editor-Via-Designer_\"<\/a><\/p>\n

Or via the Property Pane:<\/p>\n

\"Item-Collection-Editor-via-Property-\"<\/a><\/p>\n

The ListViewItem Collection Editor allows you to add \/ remove Item as well set their properties:<\/p>\n

\"ListViewItem-Collection-Editor_thumb\"<\/a><\/p>\n

Via the Script Editor:<\/p>\n

[ListViewItem]<\/span> Add <\/span>([<\/span>ListViewItem] <\/span>value<\/span>)
Adds an existing ListViewItem to the collection.<\/font><\/span><\/p>\n

\"Public
[ListViewItem] <\/span>Add <\/span>([<\/span>String] <\/span>text<\/span>)
Creates an item with the specified text and adds it to the collection.<\/font><\/span><\/p>\n

[ListViewItem] <\/span>Add <\/span>([<\/span>String] text<\/span><\/span>, [<\/span>Int] <\/span>imageIndex<\/span>)
Creates an item with the specified text and image and adds it to the collection.<\/font><\/span><\/p>\n

[ListViewItem] <\/span>Add <\/span>([<\/span>String] text<\/span><\/span>, [<\/span>String] <\/span>imageKey<\/span>)
Creates an item with the specified text and image and adds it to the collection.<\/font><\/span><\/p>\n

[ListViewItem] <\/span>Add <\/span>([<\/span>String] key<\/span><\/span>, [<\/span>String] text<\/span>, [<\/span>Int] imageIndex<\/span><\/span><\/span>)
Creates an item with the specified key, text, and image and adds an item to the collection.<\/font><\/span><\/p>\n

[ListViewItem] <\/span>Add <\/span>([<\/span>String] key<\/span><\/span>, [<\/span>String] text<\/span>, [<\/span>String] imageKey<\/span><\/span><\/span>)
Creates an item with the specified key, text, and image and adds an item to the collection.<\/font><\/span><\/p>\n

Example Use:<\/p>\n

$listitem <\/span>= <\/span>$listview1<\/span>.Items.Add(<\/span>‘PrimalForms’<\/span> , <\/span>2<\/span>)<\/span><\/p>\n

 <\/p>\n

Adding SubItems:<\/em><\/strong><\/span><\/p>\n

In the cases where you wish to add SubItems to the ListView you can add them using:<\/p>\n

Via the ListViewItem Collection Editor:<\/p>\n

\"SubItems-in-Collection-Editor4\"<\/a><\/p>\n

By clicking on the SubItems property in the ListViewItem Collection Editor, you will be presented with a ListViewSubItem Collection Editor.<\/p>\n

\"ListViewSubItem-Collection-Editor_th\"<\/a><\/p>\n

The only important property you need to set for a ListViewSubItemis the Text property.<\/p>\n

Via the Script Editor:<\/p>\n

The SubItems property has the following methods to add ListViewSubItems:<\/p>\n

[ListViewSubItem]<\/span> Add <\/span>([<\/span>ListViewSubItem] <\/span>item<\/span>)
Adds an existing ListViewItem.ListViewSubItem to the collection.<\/font><\/span><\/p>\n

\"Public
[ListViewSubItem] <\/span>Add <\/span>([<\/span>String] <\/span>text<\/span>)
Adds a subitem to the collection with specified text.<\/font><\/span><\/p>\n

[ListViewSubItem] <\/span>Add <\/span>([<\/span>String] text<\/span><\/span>, [Color<\/span>] foreColor<\/span>, [Color<\/span>] backColor,<\/span> [Font] <\/span><\/span>font<\/span>)
Adds a subitem to the collection with specified text, foreground color, background color, and font settings.<\/font><\/span><\/p>\n

Example Use:<\/p>\n

$subItem <\/span>= <\/span>$listitem<\/span>.SubItems.Add(<\/span>'Installed'<\/span>)<\/span><\/pre>\n
<\/strong><\/p>\n
<\/pre>\n
Important Methods:<\/font><\/strong><\/span><\/p>\n
Clear<\/strong><\/p>\n
This method removes all items and columns from the ListView.<\/p>\n
$listview1<\/span>.Clear()<\/span><\/pre>\n
BeginUpdate<\/strong><\/p>\n
This method prevents the control from drawing until the EndUpdate method is called. Use this method when you are updating or adding a large amount of items.<\/p>\n
$listview1<\/span>.BeginUpdate()<\/span><\/pre>\n
EndUpdate<\/strong><\/p>\n
This method resumes drawing of the list view control after drawing is suspended by the BeginUpdate method.<\/p>\n
$listview1<\/span>.EndUpdate()<\/span><\/pre>\n
Example use of the BeginUpdate and EndUpdate:<\/p>\n
$listview1<\/span>.BeginUpdate() \n<\/span>$listview1<\/span>.Items.Clear(); \n<\/span>foreach<\/span>(<\/span>$itemin$array<\/span>) \n{ \n    [void]<\/span>$listview1<\/span>.Items.Add(<\/span>$item<\/span>.Text)\n} \n<\/span>$listview1<\/span>.EndUpdate();<\/span><\/pre>\n
<\/strong><\/p>\n
<\/span><\/strong> <\/p>\n
Important Events:<\/font><\/span><\/strong><\/p>\n
AfterLabelEdit<\/strong><\/p>\n
This event occurs when the label for an item has been edited by the user. Label editing must be enabled for this event to be called (See LabelEdit property).<\/p>\n
AfterLabelEdit event uses the following argument, which is accessible via the $_<\/span> variable:<\/p>\n
[System.Windows.Forms.LabelEditEventHandler]<\/strong><\/p>\n\n\n\n\n\n\n
Properties<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
CancelEdit<\/td>\nGets or sets a value indicating whether the edit has been canceled.<\/td>\n<\/tr>\n
Label<\/td>\nGets the new text assigned to the label of the ListViewItem.<\/td>\n<\/tr>\n
Item<\/td>\nGets the zero-based index of the ListViewItem containing the label to edit.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Use this event to react to name changes. For example if the represents a file, you can use this event as a trigger for renaming the file. You should also perform any validation and reject the name change if there is a failure.<\/p>\n
$listview1_AfterLabelEdit<\/span>=<\/span>[System.Windows.Forms.LabelEditEventHandler]{\n    <\/span>#Event Argument: $_ = [System.Windows.Forms.LabelEditEventArgs]<\/span>\n    <\/span>if<\/span>(<\/span>-not<\/span> (<\/span>Validate-FileName<\/span>$_<\/span>.Label)) \n    { \n        <\/span>$_<\/span>.CancelEdit <\/span>=<\/span>$true<\/span>\n    } \n    <\/span>else<\/span> \n    { \n        <\/span>#Rename the file <\/span>\n    } \n}<\/span><\/pre>\n
BeforeLabelEdit<\/strong><\/p>\n
This event occurs when the user starts editing the label of an item.<\/p>\n
This event uses the [System.Windows.Forms.LabelEditEventHandler] argument. See AfterLabelEdit for more information about this argument.<\/p>\n
Use this event to prevent users from renaming specific items.<\/p>\n
$listview1_BeforeLabelEdit<\/span>=<\/span>[System.Windows.Forms.LabelEditEventHandler]{ \n    <\/span>#Event Argument: $_ = [System.Windows.Forms.LabelEditEventArgs]<\/span>\n    <\/span>if<\/span>(<\/span>-not<\/span>$listview1<\/span>.Items[<\/span>$_<\/span>.Item].Checked) \n    { \n        <\/span>$_<\/span>.CancelEdit <\/span>=<\/span>$true<\/span> \n    } \n}<\/span><\/pre>\n
ColumnClick<\/strong><\/p>\n
This event occurs when the user clicks a column header within the list view control. Typically you will use this event to sort the list by the selected column.<\/p>\n
ColumnClick event uses the following argument, which is accessible via the $_<\/span> variable:<\/p>\n
[System.Windows.Forms.ColumnClickEventArgs]<\/strong><\/p>\n\n\n\n\n
Properties<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
Column<\/td>\nGets the zero-based index of the column that is clicked.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/strong><\/em><\/p>\n
$listview1_ColumnClick<\/span>=<\/span>[System.Windows.Forms.ColumnClickEventHandler]{ \n    <\/span>#Event Argument: $_ = [System.Windows.Forms.ColumnClickEventArgs]<\/span>\n    <\/span>Write-Host<\/span> (<\/span>\"Column '{0}' was clicked\"<\/span> <\/span>-f<\/span> <\/span>$this<\/span>.Columns[<\/span>$_<\/span>.Column].Text)\n}<\/span><\/pre>\n
See Part 3  for how to sort columns.<\/p>\n
ItemActivate<\/strong><\/p>\n
This event occurs when an item is activated. One or more items can be activated by the user, depending on the Activate property. Note: Activating an item is not the same as selecting an item. For example, you may want to display a webpage when the user activates an item in the ListView. Use the SelectedItems or SelectedIndices property to referenced the activated item.<\/p>\n
$listview1_ItemActivate<\/span>=<\/span>{ \n    <\/span>#TODO: Place custom script here<\/span>\n    <\/span>Write-Host<\/span> <\/span>\"Activate Item\"<\/span> <\/span>$listview1<\/span>.SelectedItems[<\/span>0<\/span>].Text \n}<\/span><\/pre>\n
ItemChecked<\/strong><\/p>\n
This event occurs when the checked property of a ListView item changes.<\/p>\n
ItemChecked event uses the following argument, which is accessible via the $_<\/span> variable:<\/p>\n
[System.Windows.Forms.ItemCheckedEventArgs]<\/strong><\/p>\n\n\n\n\n
Properties<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
Item<\/td>\nGets the ListViewItem whose checked state is changing.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
$listview1_ItemChecked<\/span>=<\/span>[System.Windows.Forms.ItemCheckedEventHandler]{\n    <\/span>#Event Argument: $_ = [System.Windows.Forms.ItemCheckedEventArgs]<\/span>\n    <\/span>if<\/span>(<\/span>$_<\/span>.Item.Checked)\n    { \n        <\/span>Write-Host<\/span> <\/span>\"Checked Item: $($_.Item.Text)\"<\/span> \n    } \n    <\/span>else<\/span> \n    { \n        <\/span>Write-Host<\/span>\"Unchecked Item: $($_.Item.Text)\"<\/span> \n    } \n}<\/span><\/pre>\n
SelectedIndexChanged<\/strong><\/p>\n
This event occurs when the SelectedIndices collection changes. Use the event when you want to react to a change in the selection.<\/p>\n
$listview1_SelectedIndexChanged<\/span>=<\/span>{ \n    <\/span>Write-Host<\/span> <\/span>\"Selection Changed\"<\/span> \n}<\/span><\/pre>\n
<\/strong><\/p>\n
ItemSelectionChanged<\/strong><\/p>\n
This event occurs when the selection state of an item changes. Use this event instead of the SelectedIndexChanged when you want to know the which item was selected or unselected.<\/p>\n
ItemSelectionChanged event uses the following argument, which is accessible via the $_<\/span> variable:<\/p>\n
[System.Windows.Forms.ListViewItemSelectionChangedEventArgs]<\/strong><\/p>\n\n\n\n\n\n\n
Properties<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
Item<\/td>\nGets the item whose selection state has changed.<\/td>\n<\/tr>\n
IsSelected<\/td>\nGets a value indicating whether the item’s state has changed to selected.<\/td>\n<\/tr>\n
ItemIndex<\/td>\nGets the index of the item whose selection state has changed.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
$listview1_ItemSelectionChanged<\/span>=<\/span>[System.Windows.Forms.ListViewItemSelectionChangedEventHandler]{\n    <\/span>#Event Argument: $_ = [System.Windows.Forms.ListViewItemSelectionChangedEventArgs]<\/span>\n    <\/span>if<\/span>(<\/span>$_<\/span>.IsSelected)\n    {\n        <\/span>Write-Host<\/span>\"Selected: $($_.Item.Text)\"<\/span> \n    } \n    <\/span>else<\/span> \n    { \n        <\/span>Write-Host<\/span>\"UnSelected: $($_.Item.Text)\"<\/span> \n    } \n}<\/span><\/pre>\n
Next: Part 3 \u2013  Sorting Columns and Helper Functions<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011 , details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms. In Part 1 of the Spotlight on the […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[509,575,644,25],"tags":[641,699,28,633,327],"class_list":["post-3993","post","type-post","status-publish","format-standard","hentry","category-primalforms-software-news","category-primalforms-2011-software-news","category-spotlight-on-controls","category-windows-powershell","tag-controls","tag-listview","tag-powershell","tag-primalforms-2011","tag-winform"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3993","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=3993"}],"version-history":[{"count":7,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3993\/revisions"}],"predecessor-version":[{"id":4119,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3993\/revisions\/4119"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=3993"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=3993"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=3993"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}