{"id":3793,"date":"2012-04-04T14:00:35","date_gmt":"2012-04-04T22:00:35","guid":{"rendered":"http:\/\/www.sapien.com\/blog\/?p=3793"},"modified":"2013-02-25T13:19:30","modified_gmt":"2013-02-25T21:19:30","slug":"spotlight-on-the-listview-control-part-1","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2012\/04\/04\/spotlight-on-the-listview-control-part-1\/","title":{"rendered":"Spotlight on the ListView Control – Part 1"},"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

Last time we took a look at the ContextMenuStrip . This time we will look at the ListView control:<\/p>\n

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

Represents a Windows list view control, which displays a collection of items that can be displayed using one of four different views.<\/p>\n

\"ListView<\/p>\n

Default Event: SelectedIndexChanged<\/p>\n

Why use a ListView control?<\/em><\/p>\n

The ListView is a hybrid display. It is more complex then a ListBox, but also can display data similar to a grid. A ListView control allows you to display a list of items with item text and, optionally, an icon to identify the type of item. For example, you could use the ListView to display icons in a similar fashion to the Window\u2019s File Explorer.<\/p>\n

Note: Requires PrimalForms 2011 v2.0.20 and above to utilize some of the following ListView features.<\/span><\/em><\/p>\n

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

View<\/strong><\/p>\n

This property indicates how items are displayed in the control. Use this property to set the style or view of the ListView control.<\/p>\n

Select from the following views:<\/p>\n

\n

LargeIcon<\/em>
Each item appears as a full-sized icon with a label below it.<\/p>\n

\"LargeIcon<\/p>\n

Details<\/em>
Each item appears on a separate line with further information about each item arranged in columns. The left-most column contains a small icon and label, and subsequent columns contain sub items as specified by the application. A column displays a header which can display a caption for the column. The user can resize each column at run time.<\/p>\n

\"Details<\/p>\n

SmallIcon<\/em>
Each item appears as a small icon with a label to its right.<\/p>\n

\"SmallIcon<\/p>\n

List<\/em>
Each item appears as a small icon with a label to its right. Items are arranged in columns with no column headers.<\/p>\n

\"List<\/p>\n

Tile<\/em>
Each item appears as a full-sized icon with the item label and subitem information to the right of it. The subitem information that appears is specified by the application. This view is available only on Windows XP and the Windows Server 2003 family. On earlier operating systems, this value is ignored and the ListView control displays in the LargeIcon view.<\/p>\n<\/blockquote>\n

\n

\"Tile<\/strong><\/p>\n<\/blockquote>\n

Note: Some properties only pertain to particular views. The compatible views will be listed in each property\u2019s description.<\/p>\n

 <\/p>\n

Alignment<\/strong><\/p>\n

This property indicates how items are aligned within the ListView.<\/p>\n

Compatible Views: SmallIcon, <\/em>LargeIcon<\/em><\/p>\n

Default Value: Top<\/em><\/p>\n

\n

Default<\/em>
When the user moves an item, it remains where it is dropped.<\/p>\n

Top<\/em>
Items are aligned to the top of the ListView control.<\/p>\n

Left<\/em>
Items are aligned to the left of the ListView control.<\/p>\n

SnapToGrid<\/em>
Items are aligned to an invisible grid in the control. When the user moves an item, it moves to the closest juncture in the grid.<\/p>\n<\/blockquote>\n

AllowColumnReorder<\/strong><\/p>\n

This property indicates whether the user can reorder column headers in the Details view. Set this property to True, the users the order of the column header, by dragging the header to the desired location.<\/p>\n

Compatible Views: Details<\/em><\/p>\n

Default Value: False<\/em><\/p>\n

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

CheckBoxes<\/strong><\/p>\n

This property indicates whether a check box appears next to each item in the control.<\/p>\n

Compatible Views: All except Tile<\/em><\/p>\n

Default Value: False<\/em><\/p>\n

When CheckBoxes is set to True<\/em>, use the ItemChecked event to respond to an item\u2019s checked state changes.<\/p>\n

\"CheckBoxes\"<\/strong><\/strong><\/p>\n

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

Columns<\/strong><\/p>\n

This property contains a collection of column headers that are displayed in the Details view.<\/p>\n

Compatible Views: Details<\/em><\/p>\n

You can access the ColumnHeader Collection Editor via the designer:<\/p>\n

\"Edit<\/a><\/p>\n

Or you can access the ColumnHeader Collection Editor via the Property Pane:<\/p>\n

\"Edit<\/p>\n

The ColumnHeader Collection Editor allows you to add \/ remove Column as well as modify their properties:<\/p>\n

\"ColumnHeader<\/a><\/p>\n

The Columns collection is made up of the following object:<\/p>\n

ColumnHeader<\/strong> [System.Windows.Forms.ColumnHeader ]<\/p>\n\n\n\n\n\n\n\n\n
Property<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
DisplayIndex<\/td>\nThis property indicates the display order of the column relative to the currently displayed columns<\/td>\n<\/tr>\n
ImageIndex<\/td>\nThis property indicates the index of the image displayed in the ColumnHeader.<\/td>\n<\/tr>\n
Text<\/td>\nThis property contains the text displayed in the column header.<\/td>\n<\/tr>\n
TextAlign<\/td>\nThis property determines the horizontal alignment of the text displayed in the ColumnHeader.
Values (Default: Left<\/em>):
Left<\/em>
The object or text is aligned on the left of the control element. <\/p>\n

Right<\/em>
The object or text is aligned on the right of the control element.<\/p>\n

Center<\/em>
The object or text is aligned in the center of the control element.<\/p>\n<\/td>\n<\/tr>\n

Width<\/td>\nThis property determines the width of the column.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Set Width = -1, to adjust the width of the longest item in the column.
Set Width = -2, to auto size to the width of the column heading.
Note: When setting these special values, the control will automatically replace the Width with the calculated value.<\/p>\n

<\/strong>You can use the Column\u2019s Add<\/em> method to add Columns via the script editor:<\/p>\n

Add Methods:<\/p>\n

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


[ColumnHeader]<\/span> Add <\/span>([<\/span>String] <\/span>text)
Creates and adds a column with the specified text to the collection. <\/span><\/span><\/p>\n


[ColumnHeader] <\/span>Add <\/span>([<\/span>String] text<\/span><\/span>, [int] <\/span>width<\/span>)
Creates and adds a column with the specified text and width to the collection. <\/span><\/p>\n


[ColumnHeader] <\/span>Add <\/span>([<\/span>String] key<\/span><\/span>, [<\/span>String] text<\/span><\/span>)
Creates and adds a column with the specified text and key to the collection. <\/span><\/p>\n


[ColumnHeader] <\/span>Add <\/span>([<\/span>String] text<\/span><\/span>, [int] width<\/span><\/span>, [<\/span>HorizontalAlignment] textAlign<\/span><\/span>)
Adds a column header to the collection with specified text, width, and alignment settings. <\/span><\/p>\n


[ColumnHeader] <\/span>Add <\/span>([<\/span>String] <\/span>key<\/span>, [<\/span>String] text<\/span><\/span>, [int] <\/span>width<\/span>)
Creates and adds a  column with the specified text, key, and width to the collection. <\/span><\/p>\n


[ColumnHeader] <\/span>Add <\/span>([<\/span>String] key<\/span><\/span>, [<\/span>String] text<\/span><\/span>, [int] width<\/span><\/span>, [<\/span>HorizontalAlignment] <\/span>textAlign<\/span>, [int] imageIndex<\/span><\/span>)
Creates and adds a column with the specified key, aligned text, width, and image index to the collection. <\/span><\/p>\n


[ColumnHeader] <\/span>Add <\/span>([<\/span>String] <\/span>key<\/span>, [<\/span>String] text<\/span><\/span>, [int] width<\/span><\/span>, [<\/span>HorizontalAlignment] textAlign<\/span><\/span>, [<\/span>String] <\/span>imageKey<\/span>)
Creates and add s a column with the specified key, aligned text, width, and image key to the collection.<\/span><\/p>\n

Example Use:<\/p>\n

$columnApplication <\/span>= <\/span>$listview1<\/span>.Columns.Add(<\/span>\"Application\"<\/span>) <\/span><\/pre>\n
<\/span>$columnInstalled <\/span>= <\/span>$listview1<\/span>.Columns.Add(<\/span>\"Installed\"<\/span>)<\/span><\/pre>\n
 <\/p>\n
FullRowSelect<\/strong><\/p>\n
This property indicates whether all sub items are highlighted along with the item when selected.<\/p>\n
Compatible Views: Details<\/em><\/p>\n
<\/strong>Default Value: False<\/em><\/p>\n
Selection without FullRowSelect:<\/p>\n
\"FullRowSelect<\/p>\n
Selection with FullRowSelect:<\/p>\n
\"FullRowSelect<\/p>\n
 <\/p>\n
GridLines<\/strong><\/p>\n
This property indicates whether grid lines appear between the rows and columns containing the items and sub items in the control. The grid lines are only shown when in Details view.<\/p>\n
Compatible Views: Details<\/em><\/p>\n
<\/em> \"Gridlines\"<\/p>\n
Groups<\/strong><\/p>\n
This property contains a collection of ListViewGroup objects that are used by the control. Groups are very useful to display items in categories within the ListView.<\/p>\n
Note: If there are groups defined and a item has no group set, it will go into the \u201cDefault\u201d group.<\/p>\n
Compatible Views: All except the List<\/em><\/p>\n
<\/em><\/p>\n
You can access the Group Collection Editor via the Designer:<\/p>\n
<\/strong> \"Edit<\/a><\/p>\n
Or via the Property Pane:<\/p>\n
\"Groups<\/p>\n
 <\/p>\n
The ListViewGroup Collection Editor allows you to add \/ remove groups:<\/p>\n
\"ListViewGroup<\/a><\/p>\n
The Group collection is made up of the following object:<\/p>\n
ListViewGroup<\/strong> [System.Windows.Forms.ListViewGroup]<\/p>\n\n\n\n\n\n
Property<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
Header<\/td>\nThis property sets the header text for the group.<\/td>\n<\/tr>\n
HeaderAlignment<\/td>\nThis property sets the alignment of the group header text.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Values (Default: Left<\/em>):<\/p>\n
Left<\/em>
The object or text is aligned on the left of the control element.<\/p>\n
\"Group<\/p>\n
Right<\/em>
The object or text is aligned on the right of the control element.<\/p>\n
\"Group<\/p>\n
Center<\/em>
The object or text is aligned in the center of the control element.<\/p>\n
\"Group<\/p>\n
Adding groups via the Script Editor:<\/p>\n
[int]<\/span> Add <\/span>([<\/span>ListViewGroup] <\/span>group<\/span>)
Adds the specified ListViewGroup to the collection.<\/span><\/p>\n
[ListViewGroup] <\/span>Add <\/span>([<\/span>String] <\/span>key<\/span>, [<\/span>String] <\/span>headerText<\/span>)
Adds a new ListViewGroup to the collection using the specified values to initialize the Name and Header properties<\/span><\/p>\n
Example Use:<\/p>\n
$listview1<\/span>.Groups.Add(<\/span>\"InstallGroup\"<\/span>, <\/span>\"Installed\"<\/span>)<\/span><\/pre>\n
ShowGroups<\/strong><\/p>\n
This property indicates whether items are displayed in groups.<\/p>\n
Compatible Views: Details, LargeIcon, SmallIcon, Tile<\/em><\/em><\/p>\n
<\/strong>Default Value: True<\/em><\/p>\n
\"ListView<\/p>\n
HeaderStyle<\/strong><\/p>\n
This property indicated the style of the column headers in the Details view. Use this property when you want to prevent the users from having the option to click on the headers. Typically you would want to sort the items when a user clicks on the header. You can respond to a header click by using the ListView\u2019s ColumnClick event.<\/p>\n
Compatible Views: Details<\/em><\/p>\n
<\/strong>Values (Default: Clickable<\/em>):<\/p>\n
\n
None<\/em>
The column header is not displayed in report view.<\/p>\n
Nonclickable<\/em>
The column headers do not respond to the click of a mouse.<\/p>\n
Clickable<\/em>
The column headers function like buttons and can carry out an action, such as sorting, when clicked.<\/p>\n<\/blockquote>\n
HideSelection<\/strong><\/p>\n
This property indicates whether the selected item in the control remains highlighted when the control loses focus.<\/p>\n
Compatible Views: All<\/p>\n
<\/strong><\/p>\n
HotTracking<\/strong><\/p>\n
This property indicates whether the text of an item or subitem has the appearance of a hyperlink when the mouse pointer passes over it.<\/p>\n
Enabling hot tracking will cause the Activation property to be set to OneClick and the HoverSelection property to be set to true. In addition, run-time label editing is not allowed when hot tracking is enabled.<\/p>\n
Compatible Views: All<\/p>\n
<\/strong>Default Value: False<\/em><\/p>\n
LabelEdit<\/strong><\/p>\n
This property indicates whether the user can edit the labels of items in the control.  Use the BeforeEditLabel and AfterEditLabel events in order react to when a user changes a label.<\/p>\n
Compatible Views: All<\/p>\n
Default Value: False<\/em><\/p>\n
LargeImageList<\/strong><\/p>\n
This property contains the ImageList control used by the ListView for images in Large Icon view.  See the Spotlight on the ImageList Control blog article for more information on the ImageList.<\/p>\n
Note: The index of the corresponding SmallImageList should be the same as the LargeImageList.<\/p>\n
Compatible Views: LargeIcon<\/em><\/p>\n
<\/strong><\/p>\n
SmallImageList<\/strong><\/p>\n
This property contains the ImageList control used by the ListView for images in all views except for the Large Icon view.<\/p>\n
Compatible Views: SmallIcon, Detail, List, Tile<\/em><\/p>\n
 <\/p>\n
StateImageList<\/strong><\/p>\n
This property contains the ImageList control used by the ListView for custom states.<\/p>\n
Note: If an ImageList is specified in the StateImageList property and the CheckBoxes property is set to true, the images at index positions 0 and 1 in the ImageList are displayed instead of the check box. The image at index position 0 is displayed instead of the unchecked check box, and the image at index position 1 is displayed instead of the checked check box.<\/p>\n
Compatible Views: All<\/p>\n
 <\/p>\n
MultiSelect<\/strong><\/p>\n
This property indicating whether multiple items can be selected. If this property is set to true, use the SelectedItems property to determine which items are selected.<\/p>\n
Compatible Views: All<\/p>\n
<\/strong>Default Value: True<\/em><\/p>\n
<\/em><\/p>\n
ShowItemToolTips<\/strong><\/p>\n
This property indicates whether ToolTips are shown for the ListViewItem objects contained in the ListView.<\/p>\n
Compatible Views: All<\/p>\n
<\/strong>Default Value: False<\/em><\/p>\n
<\/em><\/p>\n
Sorting<\/strong><\/p>\n
This property indicates the manner in which items are to be sorted.<\/p>\n
Default Value: None<\/p>\n
\n
None<\/em>
The items are not sorted.<\/p>\n
Ascending<\/em>
The items are sorted in ascending order.<\/p>\n
Descending<\/em>
The items are sorted in descending order.<\/p>\n<\/blockquote>\n
Compatible Views: All<\/p>\n
<\/strong><\/p>\n
SelectedItems<\/strong><\/p>\n
This property contains all the items that are selected in the ListView. Note: Each item is a ListViewItem object, so you will have to use the Text property to display the name. The ListViewItem will be addressed in Part 2.<\/p>\n
#Display Selected Items
<\/span>foreach<\/span>(<\/span>$item<\/span>in<\/span>$listview1<\/span>.SelectedItems)
{ 
   <\/span>Write-Host <\/span>$item<\/span>.Text
}<\/span><\/pre>\n
 <\/p>\n
Next:<\/strong> Part 2<\/a> \u2013 Adding Items, Methods and Events<\/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. Last time we took a look at 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-3793","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\/3793","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=3793"}],"version-history":[{"count":7,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3793\/revisions"}],"predecessor-version":[{"id":5750,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3793\/revisions\/5750"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=3793"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=3793"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=3793"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}