This control incorperates many features which simply are not available with the standard listbox. A number of special properties allow for a virtually endless array of visual styles. In addition, the enhanced set of properties, methods and events make it more suitable for a variety of uses. All properties can be changed at runtime as well, even applicable properties of the ScrollBar.
Here are just a few of the capabilities:
- Alphabetically sort items at any time.
- Specific items can have a different color, and/or bold and italic text.
- Specific items can be grayed or disabled.
- Use a horizontal rule and/or alternate background color.
- Built-in Caption property.
- Many different border styles.
- Customized gradients can be applied to various elements such as the border, background, and even the highlighting used for selected items.
- Much much more!
|
|
Properties |
 | Archive: Returns/sets whether files with the Archive attribute should be shown.
Attrib: Returns/sets a specific attribute.
Attribs: Returns the current number of attributes.
AutoRefresh: Returns/set whether new items and changes to appearence properties are rendered immediately.
BackColor: Returns/sets the background color.
BorderColor: Returns/sets the color of the border.
BorderGradient: Returns/sets the gradient applied to the border.
BorderPicture: Returns/sets a picture to be applied to the border.
BorderStyle: Returns/sets the style of the border.
BorderStyleInner: Returns/sets the style of the inner border.
BorderWidth: Returns/sets the width of the border.
Caption: Returns/sets the caption.
CaptionAlignment: Returns/sets the alignment of the caption.
CaptionColor: Returns/sets the color of the caption.
CaptionFont: Returns/sets the font used for the Caption.
CaptionStyle: Returns/sets the style of the caption.
CheckBoxColor: Returns/sets the color for checkbox rectangles.
CheckPicture: Returns/sets the picture used for checked items.
CheckPicGrayed: Returns/sets the picture used for grayed items.
Enabled: Returns/sets whether the control can respond to the user.
EnumerateSubs: Returns/sets whether subdirectories should be enumerated.
FocusColor: Returns/sets the color used to indicate that the control has the focus.
FocusEffect: Returns/sets the effect which is applied when the control has the focus.
Font: Returns/sets the font used for list items.
FontBold: Returns/sets the bold attribute of the Font.
FontItalic: Returns/sets the italic attribute of the Font.
FontName: Returns/sets the name of the Font.
FontSize: Returns/sets the size attribute of the Font.
ForeColor: Returns/sets the color of items in the list.
Gradient: Returns/sets the gradient applied to the background.
Grayness: Returns/sets the color blend of grayed and disabled items as a percentage.
Hidden: Returns/sets whether files with the Hidden attribute should be shown.
HideColor: Returns/sets the color used to hide list items.
HideList: Returns/sets whether all items are hidden using the HideColor.
HorizRuleColor: Returns/sets the color of the horizontal rule.
HorizRuleStyle: Returns/sets the style of the horizontal rule.
hWnd: Returns the window handle.
IndexColor: Returns/sets the color of the Index column.
IndexFormat: Returns/sets the format of the Index column.
IndexWidth: Returns/sets the number of character spaces reserved for the Index column.
ItemSpace: Returns/sets the amount of space between items.
List: Returns/sets a specific list item.
ListCount: Returns the number of list items.
ListIndex: Returns/sets the index of the currently selected item.
MaskColor: Returns/sets the color used for the transparent areas of checkbox images.
MaskEnabled: Returns/sets whether the MaskColor is applied.
MouseIcon: Returns/sets the image for the mouse pointer.
MousePointer: Returns/sets the type of mouse pointer.
MultiSelect: Returns/sets how multiple items may be selected.
NewIndex: Returns the index of the newest item added to the list.
Normal: Returns/sets whether files with the Normal attribute should be shown.
OLEDropMode: Returns/sets whether the control can act as an OLE drop target.
Path: Returns/sets the path used to display files.
Pattern: Returns/sets the pattern used to display files.
Picture: Returns/sets a background image.
ReadOnly: Returns/sets whether files with the Read Only attribute should be shown.
ScrollBar: Returns/sets the properties of the ScrollBar.
SelCount: Returns the number of selected items.
Selected: Returns/sets the selection state of a specified list item.
SelBackColor: Returns/sets the background color of selected items.
SelForeColor: Returns/sets the foreground color of selected items.
SelFullWidth: Returns/sets whether the highlighted area for selected items includes the Index column.
SelGradient: Returns/sets the gradient applied to selected items.
ShowEllipsis: Returns/sets whether an ellipsis is used for items wider than the list area.
ShowSize: Returns/sets whether the Size column is shown.
SizeFormat: Returns/sets the format of the Size column.
SmoothScroll: Returns/sets whether the list should scroll smoothly.
Style: Returns/sets the style of the Index column.
System: Returns/sets whether files with the System attribute should be shown.
Text: Returns/sets the Text of the currently selected item.
TipBackColor: Returns/sets the background color of item tooltips.
TipForeColor: Returns/sets the foreground color of item tooltips.
TipStyle: Returns/sets the style of item tooltips.
TopIndex: Returns/sets the index of the first visible item.
TotalSize: Returns the total Size of all list items.
VisibleItems: Returns the number of items which can be seen without scrolling.
|
|
Methods |
| AddAttrib: Adds an attribute.
AddItem: Adds an item to the list.
Alphabetize: Sorts the items in the list alphabetically.
Clear: Clears all items from the list.
Find: Locates a list item based on a search string.
MoveItem: Moves an item to a new position within the list.
Refresh: Refreshes the control.
RemoveAttrib: Removes a specified list attribute.
RemoveItem: Removes a specified list item.
|
|
Events |
| Click: Fires when the user selects an item.
DblClick: Fires when the user double-clicks an item.
ItemCheck: Fires when the user checks or unchecks an item.
ItemMove: Fires when the user moves an item.
KeyDown: Fires when a keyboard key is pressed.
KeyPress: Fires when a keyboard ANSI key is pressed and released.
KeyUp: Fires when a keyboard key is released.
MouseDown: Fires when a mouse button is pressed.
MouseMove: Fires when the mouse is moved over a list item.
MouseUp: Fires when a mouse button is released.
OLECompleteDrag: Fires after an OLE drag/drop from the control is completed or canceled.
OLEDragDrop: Fires when the control is the target of a manual OLE drag/drop operation.
OLEDragOver: Fires when the mouse is moved over the control during a manual OLE drag/drop operation.
OLEGiveFeedback: Fires when the control is the source of an OLE drag/drop operation and the mouse cursor needs to be changed.
OLESetData: Fires when an OLE drag/drop target requests data that was not provided to the DataObject during the OLEDragStart event.
OLEStartDrag: Fires when an OLE drag/drop operation is initiated.
Scroll: Fires when the user repositions the ScrollBar.
|
