  |
GoFiler Legato Script Reference
Legato v 1.5d Application v 5.25a
|
| Table of Contents | < < Previous | Next >> |
Chapter Nine — Dialog Functions (continued)
Overview
The ButtonSetImage function sets an icon or bitmap into a button control.
Syntax/Parameters
Syntax
int = StaticControlSetImage ( int id, handle hResource | string name );
Parameters
id
An int containing the control ID of a button control.
hResource
A handle to a Resource Object containing an icon or bitmap. Or,
name
A string specifying the name of a resource or a file containing image data in icon or bitmap format.
Return Value
Returns an int as ERROR_NONE or a formatted error code on failure, ERROR_RANGE if id is an invalid control ID for the open dialog, or ERROR_INVALID_HANDLE if no dialog is open. Use the GetLastError function to retrieve error information.
Remarks
The button control receiving the request to display an image must have the matching style set as BS_BITMAP or BS_ICON and the type must match the source resource type. If the image is passed to the control as a Resource Object, the object should remain intact until the dialog box is destroyed. If Resource Object is destroyed prior to the dialog box, the button control will not display the image correctly.
If specified as a direct file or resource name, the size of the icon is automatically selected based on the system settings. To select a different size, use the LoadIcon function to specify a size.
Related Functions
Platform Support
Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL
Legato IDE, Legato Basic
| Table of Contents | < < Previous | Next >> |
© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.