ListView

A ListView control lets you display items and icons in a variety of arrangements. You can display large or small icons in free-form lists. You can add columns, pictures, and items to the ListView, and modify column properties, using PowerScript functions such as AddColumn, AddLargePicture, SetItem, SetColumn, and so on. For information about ListView functions, see the online Help.

The following illustration from the Code Examples application shows a ListView control used in a sales order application.

The sample screen is labeled Products. At top is the text "Drag / Drop a product onto the order to add it. Double - click a product to view it. R M B to change the view."  Below this is a scrollable display with rows of pictures with text labels. They represent products such as Cotton Cap and Wool Cap.

Adding ListView items and pictures

Adding images to a ListView control is the same as adding images to a PictureListBox. The ListView control’s Properties view has two tab pages for adding pictures: Large Picture (default size 32 by 32 pixels) and Small Picture (16 by 16 pixels).

For more information, see “Adding images to a PictureListBox”.

StepsTo add ListView items:

  1. Select the ListView control to display its properties in the Properties view and then select the Items tab.

  2. Enter the name of the ListView item and the picture index you want to associate with it. This picture index corresponds to the images you select on the Large Picture, Small Picture, and State property pages.

    On the Items tab page, you can work with rows in this way:

    To

    Do this

    Select a row

    Click the row button on the left, or with the cursor in the edit box, press Shift+Space

    Delete a row

    Select the row and press Delete

    Move a row

    Click the row button and drag the row where you want it, or press Shift+Space to select the row and then press Ctrl+Up Arrow or Ctrl+Down Arrow to move the row

    Delete text

    Click the text and select Delete from the pop-up menu

    NoteSetting the picture index for the first item to zero clears all the settings on the tab page.

  3. Set properties for the item on the Large Picture, Small Picture, and/or State tab pages as you did on the Items tab page.

    On these pages, you can also browse for a picture. To do so, click the browse button or press F2.

  4. Repeat until all the items are added to the ListView.

Choosing a ListView style

You can display a ListView in four styles:

StepsTo select a ListView style:

  1. Select the ListView control to display its properties in the Properties view and then select the General tab.

  2. Select the type of view you want from the View drop-down list.

For more information about other properties, right-click in any tab page in the Properties view and select Help from the pop-up menu.

Setting other properties

You can set other ListView properties.

StepsTo specify other ListView properties:

  1. Select the ListView control to display its properties in the Properties view.

  2. Choose the tab appropriate to the property you want to specify:

    To specify

    Choose this tab

    The border style

    General

    Whether the user can delete items

    General

    The images for ListView items in Large Icon view

    Large Picture

    The images for ListView items in Small Icon, list, and report views

    Small Picture

    The state images for ListView items

    State

    The names and associated picture index for ListView items

    Items

    The font size, family, and color for ListView items

    Font

    The size and position of the ListView

    Other

    The icon for the mouse pointer in the ListView

    Other

    The icon for a drag item, and whether the drag-and-drop must be performed programmatically

    Other

For more information on the ListView control, see Application Techniques. For information about its properties, see Objects and Controls.