DefaultPicture

Description

Specifies whether a button displays a default picture for the button’s action.

Applies to

Button controls

Syntax

PowerBuilder dot notation:

dw_control.Object.buttonname.DefaultPicture

Describe and Modify argument:

"buttonname.DefaultPicture { = ' value ' }"

Parameter

Description

buttonname

The name of the button to which you want to assign an action.

value

Whether the action’s default picture is used.

Values are:

  • Yes – Use the default picture.

  • No – Do not use the default picture.

Usage

Default pictures can be associated with all button action types. However, the only default pictures provided for use on a Web DataWindow are: InsertRow, PageFirst, PageLast, PageNext, PagePrior, Retrieve, and Update. These pictures are included as GIF files in the DWACTION115.JAR file in the Sybase\Shared\PowerBuilder directory.

For the Web DataWindow, you must uncompress the dwaction115.jar file, deploy the individual GIF files to your Web site, and specify their location with the DataWindow HTMLGen.ResourceBase property that you can set on the JavaScript Generation page in the DataWindow’s Property view.

You can add your own action pictures by setting the DefaultPicture property to False and setting the Filename property to the file name for the picture you want. You can use a URL instead of a complete path to qualify the file name, and you can leave off the URL server name, mapping prefix, and folder name if you set them in the HTMLGen.ResourceBase property.

A user-defined action does not have a default picture associated with it.


In the painter

Select the control and set the value in the Properties view, General tab, Action Default Picture option. When the DefaultPicture is not set, you can specify a picture file name in the Picture File property. Button pictures can be BMP, GIF, or JPEG files.

Examples

Example 1

dw1.Object.b_name.DefaultPicture = "Yes"

Example 2

setting = dw1.Describe("b_name.DefaultPicture")

dw1.Modify("b_name.DefaultPicture ='No'")

See also