Table of Contents

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

DevelopmentRuntimeIndexedScaledSynthetic
Get/SetGet/SetNoNoNo

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