Overview

This XPListBar object is for developers to use in programs developed in PowerBuilder. The look and feel of the XPListBar is similar to those found in XP, Kodigo, PowerToTheBuilder, etc. It supports groups, text, separators and resizing.

What makes the XPListBar offering unique in that it is written in PowerBuilder using the dataWindow object as its means of transport. The XPListBar, for all intents and purposes, is a datawindow placed on a window/userObject. It takes advantage of features built into the dataWindow and uses only Windows API calls and calls into the PBVMxxx.dll. There are no other "external" DLLs or PBNI code.

Implementing

Include dwgui.pbl in your project.

If you do not use the PFC, include dwgui_PFC.pbl as well. The PFC objects are provided as a courtesy. The main requirements from the PFC are n_cst_color (in general), n_cst_numerical.of_bitWiseAnd(), n_cst_string.of_globalReplace() and n_cst_string.of_parseToArray(). If you have your own versions of these routines, feel free to modify your copy of the code accordingly. These are modified copies of the corresponding PFC objects and should not be used to replace any PFC objects already in your project.

The PFC objects contained in the dwGUI_PFC_textOnly.pbl are only provided to make the test window work and are not needed to use the XPListBar in your project. These are modified copies of the corresponding PFC objects and should not be used to replace any PFC objects already in your project.

Once you have your target updated, placing u_cst_XPListBar from the dwgui.pbl on an object will provide you with the XPListBar capability contained in this project.

Constants

ue_itemClicking Outcomes
Name Value Description
ALLOW 1 The item click is allowed
PREVENT -1 The item click is NOT allowed
General return conditions
Name Value Description
SUCCESS 1 Successful completion
NO_ACTION 0 No action was taken
FAILURE -1 Failed completion
Picture Sizes
Name Value Description
SMALL 16 Displays pictures as 16x16 pixels
MEDIUM 24 Displays pictures as 24x24 pixels
LARGE 32 Displays pictures as 32x32 pixels
XLARGE 48 Displays pictures as 48x48 pixels
Scroll Speeds
Name Value Description
NORMAL 1 Scrolls display 1 vertical unit at a time
FAST 5 Scrolls display 5 vertical units at a time
FASTEST 10 Scrolls display 10 vertical units at a time

Properties (set at design time)

Name Type Default Description
#DisplayBorder Boolean TRUE Draws a border around the XPListBar
#RaisedBorder Boolean FALSE Draws a raised border around the XPListBar, used in conjunction with DisplayBorder
#SolidBackGround Boolean FALSE Switches between a solid and a gradient background
#FontFace String Tahoma Used to determine the type face of the text displayed on the XPListBar
#FontSize Long 8 Determines the size used for the type face of the text displayed on the XPListBar
#BitMapSize Long 16 Indicates the size of the pictures displayed on the XPListBar and causes the size of the XPListBar to change to accommodate the pictures. Valid choices are SMALL, MEDIUM, LARGE AND XLARGE. Currently, only SMALL is actually supported
#ScrollSpeed Long 1 Used to control the speed of the auto-scrolling feature
#ToolTipDelayInitial Long 1000 How long to hover before toolTips are enabled (value in millseconds)
#ToolTipDelayVisible Long 32000 How long to display toolTips (value in milliseconds)
#ToolTipIsBubble Boolean TRUE Enables/Disables the display of toolTips as a bubble

Events

Public Methods

Last edited Sep 28, 2016 at 10:52 AM by cjharris02892, version 13