TASKBARID property (System)
Description
Returns the TaskBar identifier for the current Presentation Server instance. It can be set by the “taskBarID” option in the RXI file or the /TB command line switch.
Property Value
This property is a simple string containing the TaskBar identifier.
Property Traits
Development | Runtime | Indexed | Scaled | Synthetic |
---|---|---|---|---|
N/A | Get | No | No | No |
Remarks
Under Windows 7 and 8 multiple instances of an executable launched from the same directory are grouped under one icon on the taskbar, making navigating between them quite tedious. To allow an executable to override this behavior Microsoft introduced a new application property called the “Application User Model ID” – a simple string that can be applied to an executable instance to differentiate it from other sibling instances, thereby allowing them to be un-grouped.
Windows assigns a default value to this property at runtime based on the executable name and the starting directory. The OpenInsight /TB switch (or taskBarID element in an RXI file) allows you to set your own unique value for this property so that your application can be differentiated on the Windows taskbar.
The Application User Model ID must be set before any forms are created by an executable which is why it can only be set via the RXI file or the command line switch.
If you wish to find out more details about the Application User Model ID please see the MSDN documentation about the SetCurrentProcessExplicitAppUserModelID function.
Example
TaskBarID = Get_Property( "SYSTEM", "TASKBARID" )
See Also
Starting the Presentation Server, WINDOW TASKBARID property.