The Button Listbar provides users with a list of options to select.

---

Implementation:

//Open Event of window that contains the control
//Or the post constructor event of the userobject that contains the control

//Add items to the list
uo_1.of_AddItem("Mail", 'Mail.ico')
uo_1.of_AddItem("Calendar", 'calendar.ico')
uo_1.of_AddItem("Contacts", 'contact.ico')
uo_1.of_AddItem("Tasks", 'task.ico')
uo_1.of_AddItem("Notes", 'note.ico')
uo_1.of_AddItem("Folder List", 'folder.ico')

//Set the size of the images
uo_1.of_SetSize(uo_1.LARGE)

Button Listbar
Developed by Brad Wery [TeamSybase]
brad.wery@PowerToTheBuilder.com

---

Usage:

Place u_cst_buttonlistbar from advguicontrols.pbl on your window.

---

Library List:

Add the following libraries to your application library list:
      - advguicontrols.pbl
      - advguiobjects.pbl

---

Distribution:

You will have to distribute the canvas.pbx file with your application

---

Functions:

of_additem (string as_text, string as_image, any aa_data)
of_additem (string as_text, string as_image)
      - Add an item to the list with an optional paramater for data

of_setsize (integer ai_size)
      - Set button size
           - for 16x16 pass SMALL
           - for 24x24 pass MEDIUM
           - for 32x32 pass LARGE
           - for 48x48 pass XLARGE

of_selectbutton (long al_selected)
of_selectbutton (string as_text)
      - Select a button by index or text

of_setenabled (long al_index, boolean ab_enabled)
of_setenabled (string as_text, boolean ab_enabled)
      - Set buttons enabled property by index or text

of_settext (string as_item, string as_text)
of_settext (long al_item, string as_text)
      - Set a buttons text by index or text

of_gettext (long al_index)
      - Get Button text by index

of_setscrollspeed (long al_speed)
      - Set the speed that the object scrolls at

---

Events:

ue_selectionchanged ( oldindex, newindex )
      - Occurs when an items is selected.

---

Special Contributions:

The following was contributed by Allan Cartagenas:
     Giving buttons the ability to store data.

The u_canvas object was kindly donated by Yeyi of kodigo.sourceforge.net

Download:

PBGUIControls.zip Version 2.1.2 - for PB9.0   668 KB
PBGUIControls.zip Version 2.1.2 - for PB10.5   776 KB
PBGUIControls.zip Version 2.1.2 - for PB11.1\11.2 .Net Winforms   810 KB

Special Note: PowerBuilder 9.0     - Theme support is intermittent and a fix is being investigated.     - canvas.pbd must be distributed with your PowerBuilder 9.0 application along with the canvas.pbx file. PowerBuilder 11.1 - .Net Winforms     - The PBCanvas.dll assembly must be added to and distributed with your application.     - There is no need to distribute canvas.pbx with your application.     - You must remove and re-add the reference to the PBCanvas.dll assembly to run the sample.

---

New This Release:

Version 2.1.2 - May 04, 2008
    - General
        - Support for PB11.2
    - PowerDock
        - Mail application frame lost focus when pane was pinned or unpinned

---

Version 2.1.1 (Winforms) - Apr 27, 2008
    - PowerDock
        - Support for Winforms deployment

---

Version 2.1.1 - Apr 13, 2008
    - PowerDock
        - Added new close and context menu for document which will display on the main windows menu
        - New function to close the active document
        - Hover effect on pin
        - Misc. bug fixes

    - Tab Control
        - Added more overloads to make it easier to work with tabs that represent windows

---

Version 2.1.0 - Apr 06, 2008
    - PowerDock
        - Added many new functions to make the control more usable

    - Tab Control
        - Added more overloads to make it easier to work with tabs that represent windows

---

Version 2.0.0 - Mar 27, 2008
    - PowerDock
        - New this release

    - Tab Control
        - Added new overloads so Windows can be opened as tabs

    - Toolbar
        - Now supports verticle orientation

---

Version 1.2.1 - Feb 24, 2008
    - GroupBox
        - Added a new style for the groupbox

---

Version 1.2.0 - Feb 10, 2008
    - Toolbar
        - Added an overload for of_SetEnabled so items can be enabled\disabled by using an item index
            - of_SetEnabled(long al_item, boolean ab_switch

        - Added an overload for of_Toggle so items can be toggled on or off by using an item index
            - of_Toggle(long al_item)

        - Added an overload for of_AddItem so tip text can be specified
            - of_AddItem(string text, string image, string tiptext)

        - Added an overload for of_DisplayText so text can be displayed for a single item
            - of_DisplayText(string as_item, boolean ab_display)

        - Added two new functions which allow you to change the text for any item
            - of_SetText(string as_item, string as_text)
            - of_SetTipText(string as_item, string as_text)

    - ButtonListBar
        - Added a new function which allows you to change the text for any item
            - of_SetText(long al_item, string as_text)
            - of_SetText(string as_item, string as_text)

    - Outlook 2003 ShortcutBar
        - Added a new function which allows you to change the text for any item
            - of_SetText(long al_item, string as_text)
            - of_SetText(string as_item, string as_text)

        - Added a new function which allows you to change the text for the popmenu that displays when the chevron (">>") is clicked
            - of_SetMenuText(long al_item, string as_text)

    - Custom Static Text
        - Renamed to u_cst_statictext

---

Version 1.1.1 - Jan 30, 2008
     - Bug fix for of_SetSize in u_cst_shortcutbar

---

Version 1.1.0 - Jan 27, 2008
     - GroupBox
         - New this release.

     - Toolbar
         - Added functions to toggle button
             - of_Toggle(string as_item)
             - of_IsToggleOn(string as_item)

     - XPListBar
         - Link items now have the ability to store data

     - ButtonListBar
         - Buttons now have the ability to store data

---

Version 1.0.0 - Jan 11, 2008
      - Initial Release