ICON property (Window)
Description
Specifies the name of the icon displayed in the window's caption bar, and if appropriate, the Windows TaskBar.
Property Value
This can be one of three formats:
• The path and name of an icon (.ico) file.
• The path and name of a resource file (.exe/.dll) containing the icon. This should have the format:
<filepath> "#" <resourceID>
• The name of a Windows system Icon:
o "APPLICATION"
o "ERROR"
o "INFORMATION"
o "QUESTION"
o "WARNING"
o "SHIELD"
Property Traits
Development | Runtime | Indexed | Scaled | Synthetic |
---|---|---|---|---|
Get/Set | Get/Set | No | No | No |
Remarks
Equated constants for using System Icons can be found the PS_SYSCON_EQUATES insert record.
Example
Declare Function Repository $Insert PS_SysIcon_Equates // Example 1 - setting an ICON property with a normal filename IcoFile = ".\icons\rti_ide.res\rti_test_dummy.ico" Call Set_Property_Only( @Window, "ICON", IcoFile ) // Example 2 - setting an ICON property with a resource from a DLL. // (the icon with an ID of "1" from OEngine.dll) IcoFile = "oengine.dll#1" Call Set_Property_Only( @Window, "ICON", IcoFile ) // Example 3 - setting an ICON property with a System Icon IcoFile = "WARNING" Call Set_Property_Only( @Window, "ICON", IcoFile ) // Example 4 - setting an ICON property using a repository ID // // IMAGE entities always return the filename in field 1 IcoFile = Repository( "ACCESS", PS_REP_SYSICON_QUESTION$ )<1> Call Set_Property_Only( @Window, "ICON", IcoFile )
See Also
Appendix J - System Icons