PictureListBox control
A PictureListBox displays available options or values,
which can include pictures. If more options or values exist than
can display in the PictureListBox at one time or the text exceeds
the width of the PictureListBox, the PictureListBox has one or two
(vertical or horizontal) scroll bars.
PictureListBox controls can contain images in the following
formats:
-
Bitmaps, with the .BMP extension
-
Icons, with the .CUR extension
-
Cursors, with the .ICO extension
-
GIF files, with the .GIF extension,
but not animated GIF files -
JPEG files, with .JPEG or .JPG extensions
-
Portable Networks Graphics, with .PNG extension
Properties
PictureListBox property |
Datatype |
Description |
---|---|---|
Integer |
Specifies the ASCII value of the key |
|
String |
A description of the control and/or |
|
String |
A label that briefly describes the control, |
|
AccessibleRole (enumerated) |
Describes what kind of user interface |
|
Long |
Specifies the numeric value of the background |
|
Boolean |
Specifies whether the control has a border.
|
|
BorderStyle (enumerated) |
Specifies the style of the border of
|
|
Boolean |
Specifies whether PowerBuilder moves
|
|
ClassDefinition |
PowerObject |
An object of type PowerObject containing |
Boolean |
Specifies behavior of scroll bar. Values
|
|
Boolean |
Specifies whether PowerBuilder puts the
|
|
String |
Specifies the name of the stock icon When the user drags the control, the icon displays when the control |
|
Boolean |
Specifies whether the control is enabled
|
|
Boolean |
Specifies whether users can select multiple
Used with MultiSelect The MultiSelect property allows users to select multiple items |
|
String |
Specifies the name of the typeface in |
|
FontCharSet (enumerated) |
Specifies the font character set used |
|
FontFamily (enumerated) |
Specifies the font family (type style)
|
|
FontPitch (enumerated) |
Specifies the pitch (spacing) of the
|
|
Integer |
Specifies the height of the control, |
|
Boolean |
Specifies whether a horizontal scroll
|
|
Boolean |
Specifies whether the text in the control
|
|
String |
Specifies the items in the control. Not |
|
Integer |
Specifies the picture index for each |
|
Boolean |
Specifies whether users can select multiple
|
|
Integer |
Specifies height of the picture, in pixels. In a script, this property can be set only when there are |
|
Long |
Specifies the numeric value of the color Values can be: -2 to 16,777,215. For more information about color, see the RGB function |
|
String |
Specifies the names of the files containing Not updated after initialization. |
|
Integer |
Specifies width of the picture, in pixels. In a script, this property can be set only when there are |
|
String |
Specifies the name of the stock pointer |
|
Boolean |
Specifies that characters should be displayed
|
|
Boolean |
Specifies whether the items in the PictureListBox
|
|
Integer |
Specifies the tab value of the control |
|
Integer array |
Specifies the positions of the tab stops |
|
String |
Specifies the tag value assigned to the |
|
Long |
Specifies the numeric value of the color |
|
Integer |
Specifies the size of the text in the |
|
Boolean |
Specifies whether the text in the control
|
|
Boolean |
Specifies whether the control is visible.
|
|
Boolean |
Specifies whether a vertical scroll bar
|
|
Integer |
Specifies the stroke weight of the text |
|
Integer |
Specifies the width of the control, in |
|
Integer |
Specifies the X position (the distance |
|
Integer |
Specifies the Y position (the distance |
Events
PictureListBox event |
Occurs |
---|---|
Immediately before the Open event occurs |
|
Immediately after the Close event occurs |
|
When the control is double-clicked (selected |
|
When a dragged control is dropped on |
|
When a dragged control enters the control |
|
When a dragged control leaves the control |
|
When a dragged control is within the |
|
Just before the control receives focus |
|
When the user presses the F1 key or drags |
|
When the control loses focus (becomes |
|
When a Control message occurs that is |
|
When the right mouse button is pressed |
|
When an item in the control is selected |
Functions
PictureListBox function |
Datatype returned |
Description |
---|---|---|
Integer |
Adds a new item to the end of the PictureListBox. The AddItem function does not update the |
|
Integer |
Adds the bitmap, icon, or cursor file |
|
String |
Returns the name assigned to the control. |
|
Integer |
Deletes the item indicated by the index |
|
Integer |
Deletes the specified picture from the |
|
Integer |
Deletes all the pictures from the image |
|
Boolean |
Populates the PictureListBox with a list |
|
Boolean |
Returns the current selection for the |
|
Integer |
Starts or ends the dragging of a control. |
|
Integer |
Finds the first item in the PictureListBox |
|
Integer |
Creates a reference to a context-specific |
|
PowerObject |
Returns a reference to the name of the |
|
Integer |
Makes the control invisible. |
|
Integer |
Adds a new item to the PictureListBox |
|
Integer |
Moves the control to a specified location. |
|
Integer |
Returns the distance of the pointer from |
|
Integer |
Returns the distance of the pointer from |
|
Boolean |
Adds an event to the end of the message |
|
Integer |
Prints the control. |
|
Integer |
Removes all items from the control. |
|
Integer |
Changes the size of the control. |
|
Integer |
Returns the index of the item in the |
|
String |
Returns the text of the first selected |
|
Integer |
Finds and highlights an item in the control. SelectItem has no effect on a PictureListBox whose MultiSelect property |
|
Integer |
Sets focus to the control. |
|
Integer |
Specifies the position of the control |
|
Integer |
Controls automatic redrawing of the control |
|
Integer |
Sets the state (highlighted or not highlighted) |
|
Integer |
Scrolls the items in the control so that |
|
Integer |
Makes the control visible. |
|
Integer |
Returns 1 if the item specified by the |
|
String |
Returns the text of the item in the control |
|
Integer |
Returns the index number of the item |
|
Integer |
Returns the total number of items in |
|
Integer |
Returns the total number of items selected |
|
Integer |
Triggers a specified event in the control |
|
Object |
Returns the type of the control. |