Progress
AppBuilder
Developer’s Guide


Adding a Button to the Objects Palette

Use this type of entry to define your own object type and place it on the Object Palette:

SYNTAX
#object-type &Default
UP-IMAGE-FILE bitmap-file [X,Y]
DOWN-IMAGE-FILE bitmap-file [X,Y]
LABEL label-name
{     USE master-file-name
   |  NEW template-file-name
        [ DIRECTORY-LIST list FILTER filter TITLE title ]
       |     DIRECTORY-LIST list FILTER filter TITLE title 
}
[ DB-CONNECT ] 

#object-type &Default

Specifies the type of object to add to the Object Palette.

UP-IMAGE-FILE bitmap-file [X,Y]

Specifies the name of the bitmap file for object-type when deselected. To fit properly on the Object Palette, the image must be 28 by 28 pixels, including all shadows and highlights.

DOWN-IMAGE-FILE bitmap-file [X,Y]

Specifies the name of the bitmap file for object-type when selected. To fit properly on the Object Palette, the image must be 28 by 28 pixels, including all shadows and highlights.

LABEL label-name

Specifies the text for the label for object-type. This label appears on the Object Palette and in the Object Palette menu.

USE master-file-name

Specifies the name of the SmartObject master file to instantiate when smartobject-type is selected from the Object Palette. If you specify USE, a Choose Object dialog box does not appear.

NEW template-file-name

Specifies the template file that AppBuilder opens when the user performs a New operation from Object Palette. You cannot use this option with the USE option.

DIRECTORY-LIST list

Specifies the directories that appear in the Choose dialog box for object-type.

FILTER filter

Specifies a comma-separated list of file search masks that appear in the Choose dialog box for the current directory.

TITLE title

Specifies the title for the Choose dialog box for object-type.

DB-CONNECT

Specifies whether AppBuilder prompts you to connect a database (if one is not connected) when you select the object-type. This is useful for data-aware objects such as SmartDataViewers, SmartDataObjects, and SmartDataBrowsers.

The sample entry in Figure C–1 adds a SmartObject type, specifically a SmartDataBrowser.

Figure C–1: Sample Entry for SmartObject Type

NOTE: You can also use the adecomm/_chosobj.w procedure in the src/adecomm.pl procedure library to modify the Choose Object dialog box. For more information, see the Progress Basic Development Tools manual (character only; information for Windows is in online help).


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095