ph_setccobjgraphic PowerHome formula function
Description
Allows for the setting of both up and down graphic files associated with a Control Center graphic object
Syntax
ph_setccobjgraphic ( as_filepathup, as_filepathdown )
ph_setccobjgraphic ( as_tab, as_id, as_filepathup, as_filepathdown )
| Argument |
Description |
|
as_tab
|
String (Optional). The ID of the Control Center tab containing the object. If this parameter is omitted, the system variable CCTAB will be used |
|
as_id |
String (Optional). The ID of the object on the specified tab. If this parameter is omitted, the system variable CCOBJ will be used |
|
as_filepathup |
String. The full path and filename of the "up" graphic object. Used by all graphic objects |
|
as_filepathdown |
String. The full path and filename of the "down" graphic object. Used ONLY by graphic button objects |
Return value
Integer. Returns a 0
Usage
Use this function to dynamically change the graphic files associated with Control Center graphic objects. Also sends the changes to Remote CC clients using the UDP broadcast server.
Use a single space character as the graphic file to leave the existing graphic file unchanged. Useful when you wish to change ONLY the up or down graphic file and not the other
Examples
The following examples demonstrate typical /syntax usage for this function.
•ph_setccobjgraphic("STATUS","[LOCAL2]","C:\powerhome\web\graphics\buttons\b1gray-d_50.gif","
")
• ph_setccobjgraphic("STATUS","DSCN",ph_getvar_s(1,4),"
")