====== 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 ====
 
<code>
 
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 )
 
 
 

</code>

 
==== See Also ====
 
 
Appendix J - System Icons