Lets you set global properties and modify them at runtime.
integer SetRuntimeProperty (string PropertyName, boolean fValue)
Argument |
Description |
---|---|
PropertyName |
A read-only string for an internal runtime property that you want to modify at runtime. The properties you can modify are described in a table in the usage section for this function. |
fvalue |
A boolean for the value of the property that you want to modify at runtime. |
Returns 0 for success and a negative number for failure.
The SetRuntimeProperty function has no effect on internal runtime properties in applications that you deploy to the desktop. It works only for applications running on a handheld device or emulator. The runtime properties you can set with this function are described in the following table:
Property |
Description |
---|---|
AllowAutomaticSIPHandling |
When you set this property to false, the PowerScript SIPOnFocus property is disabled for all controls. However, this does not prevent the application user from manually raising or lowering the SIP, or from changing its type. It also does not interfere with SIPUp and SIPDown events. By default, this property is set to true. |
DrawFlatTabs |
By default, this property is false and window tab controls have a classic 3-D look. You can display the tab controls with a traditional Pocket PC flat look at runtime by setting this property to true. The property does not affect tab control appearance in DataWindow objects, only in window objects. You should not try to modify the runtime appearance of tab controls when a tab control is already visible in an application window. |
EnableExtraActivates |
Windows operating systems typically provide fewer window activation and deactivation messages for mobile devices than for desktop computers. This is especially true for pop-up windows. Setting this property to true enables you to capture more window activation and deactivation messages on a mobile device without breaking legacy behavior. Unfortunately, it can also cause a window to receive two identical activation or deactivation messages. However, you can turn this property on or off at any time to fine tune the message capturing behavior. |
MOPEnable |
By setting this property to false, you disable MOP views or allow the end user of a PocketBuilder application to disable MOP views. This can be convenient if you want MOP views turned off only for a series of dialog boxes, after which, you can enable MOP views again by setting the MOPEnable property to true. When you turn off the MOPEnable property, the last values saved for X, Y, Width, and Height properties determine the positions and dimensions of windows and controls regardless of the screen orientation or size of the handheld device. |
SIPOnFocusUp_AlternateTechnique |
On some devices, the automatic SIP driver does not cause the SIP to display when text controls gain focus after a soft reboot. This property supplements the internal API of the device, ensuring that the preferred SIP position for the operating system is the up position. Typically you set this property only in the application Open event and the setting remains in effect for the lifetime of the application. |
SIPOnFocusDown_AlternateTechnique |
This property supplements the internal API on a handheld device, ensuring that the default SIP position for the operating system is the down position. Typically you set this property in the application Open event only if a particular device requires such an intervention. The property setting remains in effect for the lifetime of the application. |
There is no equivalent “get” function for internal runtime property settings.
The following script sets the tabs on tab controls in application windows to a flat style:
integer li_return
li_return = SetRuntimeProperty (“DrawFlatTabs”, true)