Instruction Manual

OEM External Specification
OEM User’s Guide—520330-001
A-35
Client Callback API (OEM to Client Application)
SetIcons
SetIcons is used to inform the client that the user has changed the default icon set within
a framework, the OEM, or a client application. The client can then update its own icon
set to utilize the new images if applicable.
Parameters
IconDirectoryName (input)
is the name of the directory containing the object and state images to use.
Return Value
•
0 if the client has accepted the call and handled the request (even if the icon set is
not updated)
•
Non-zero if the client cannot or will not process the request
Considerations
The client determines whether or not it will honor the SetIcons request and update its
icon set accordingly. In some cases you might want to allow users to specify different
icons sets within different components of the OEM infrastructure; in these cases, the
client can simply ignore the SetIcons request.
A client that calls the OEM’s SetIcons method receives a SetIcons callback from the
OEM; the directory name passed is identical to that supplied on the initial call.
Example
Dim RC As Integer
' ClientCallbackObject was passed in a Popup.Add or Object.Add
call
RC = ClientCallback.SetIcons 'C:\MyIcons'
In this example, the OEM sets the icon directory to “C:\MyIcons.”
Function SetIcons(IconDirectoryName As String) As Integer