Skip to content

Class: cCommandLinkButton

Properties | Events | Methods | Index of Classes

Displays a command line button, with an image on the left followed by a large-text label with optional notes text underneath it in smaller text

Hierarchy

cObject > cUIObject > DfBaseObject > DfBaseWindow > DfBaseUIWindow > DfBaseControl > DfBaseList > DfBaseButton > DfBasePushButton > Button > cCommandLinkButton

Show full hierarchy and direct subclasses

Library: Windows Application Class Library

Package: cCommandLinkButton.pkg

Description

This creates a command link button, which is consists of an image of the left (by default the green Windows arrow pointing to the right), followed by a large-text label with optional notes text underneath it in smaller text. Typically, these button are stacked horizontally.

The Label property sets the Label text. The psNote property sets the notes text. The image is the green Windows arrow, but can be changed using pbShield or psImage.

Windows only supports this style of button with Vista/Windows Server 2008 and above.; you would not want to use this with earlier versions. If used with a non-supported version of Windows, this will appear as a big button and the notes will not be displayed.

The Button class displays a button, with an image and/or text label, that executes an action when clicked.

The cSplitButton class displays a split button, with an image and text on the left and a drop down image on the right.

Sample

Object oButton1 is a cCommandLinkButton
    Set Location to 55 77
    Set Size to 30 100
    Set Label to 'Command Link Text'
    Set psNote to "Test Notes can go here"

    // fires when the button is clicked
    Procedure OnClick
    End_Procedure
End_Object

Object oButton2 is a cCommandLinkButton
    Set Location to 89 77
    Set Size to 30 100
    Set Label to 'Command Link Elevated'
    Set pbShield to True

    // fires when the button is clicked
    Procedure OnClick
    End_Procedure
End_Object

Object oButton3 is a cCommandLinkButton
    Set Location to 120 77
    Set Size to 32 186
    Set Label to 'Command Link Custom Image'
    Set psNote to "Test Notes can go here and have all kinds of stuff"
    Set psImage to "vdf32.bmp"
    Set piImageSize to 48

    // fires when the button is clicked
    Procedure OnClick
    End_Procedure
End_Object

Windows Support

Windows only supports this style of button with Windows Vista/Windows Server 2008 and above. You would not want to use this with earlier versions. If used with a non-supported version this will appear as a big button and the notes will not be displayed.