Buttons Component

Fnd_Bttn_GetPicture

Fnd_Bttn_GetPicture (icon name; button label) -> Picture

Legacy manual page 54

Parameters

ParameterTypeDescription
icon nameTextName of the icon to use from the 4D picture library
button labelTextLabel for the button
Function resultPicturePicture to use for a 4D picture rollover button

Description

This routine returns a picture of a rollover based on the parameters you pass for the icon, text, size and type. The Buttons component caches the images it creates, so if the picture already exists in the cache, it is retrieved from there instead of being generated again.

Fnd_Bttn_GetPicture ("Fnd_Bttn_Calendar";"Events")

The icon name can be one of the icons pre-installed in the Button component (e.g. “Fnd_Bttn_Alarm”), or it can be the name of a series of pictures in the 4D Picture Library. This routine will look for an image with the specified icon name plus “_a” to use when drawing the button in its “active” state. The icon name plus “_b” is used to draw the button in the clicked state. And the icon name plus “_c” is used to draw the button in the disabled state. See the details at the beginning of this chapter.

Extracted source text
            Fnd_Bttn_GetPicture (icon name; button label) ➔ Picture

              Parameter                Type              Description
              icon name                Text              Name of the icon to use from the 4D picture library
              button label             Text              Label for the button
              Function result          Picture           Picture to use for a 4D picture rollover button

            This routine returns a picture of a rollover based on the parameters you pass for the icon, text, size and
            type. The Buttons component caches the images it creates, so if the picture already exists in the cache, it
            is retrieved from there instead of being generated again.
              Fnd_Bttn_GetPicture ("Fnd_Bttn_Calendar";"Events")

            The icon name can be one of the icons pre-installed in the Button component (e.g. “Fnd_Bttn_Alarm”),
            or it can be the name of a series of pictures in the 4D Picture Library. This routine will look for an image
            with the specified icon name plus “_a” to use when drawing the button in its “active” state. The icon
            name plus “_b” is used to draw the button in the clicked state. And the icon name plus “_c” is used to
            draw the button in the disabled state. See the details at the beginning of this chapter.