Screen

Defines
#define	MAW_SCREEN_TITLE   "title"
	Sets the title of a screen. The screen title is used by tab screen to display a text on the tab indicator.
#define	MAW_SCREEN_ICON   "icon"
	Sets an icon for a screen. The icon is used by a tab screen to display an icon on the tab indicator.
#define	MAW_SCREEN_REMOVE_OPTIONS_MENU   "removeoptionsmenu"
	Remove the options menu from this screen. The options menu can be added by calling maWidgetScreenAddOptionsMenuItem for each item.
#define	MAW_SCREEN_IS_SHOWN   "isShown"
	Check if a screen is shown.

---

Detailed Description

The available widget properties for a MAW_SCREEN. See Widget properties for more properties.

---

Define Documentation

#define MAW_SCREEN_TITLE   "title"

Sets the title of a screen. The screen title is used by tab screen to display a text on the tab indicator.

Valid values

Null terminated string. The length of the string should be short enough to fit in a tab indicator.

Operations

Set only.

Example

        maWidgetSetProperty(screenHandle, MAW_SCREEN_TITLE, "My title");

#define MAW_SCREEN_ICON   "icon"

Sets an icon for a screen. The icon is used by a tab screen to display an icon on the tab indicator.

Valid values

MoSync handle to an uncompressed image resource. The size of the image should be small enough to fit in a tab indicator.

Operations

Set only.

Example

        maWidgetSetProperty(screenHandle, MAW_SCREEN_ICON, toString(R_MY_ICON));

#define MAW_SCREEN_REMOVE_OPTIONS_MENU   "removeoptionsmenu"

Remove the options menu from this screen. The options menu can be added by calling maWidgetScreenAddOptionsMenuItem for each item.

Valid values

No value needed.

Operations

Set only.

Example

        maWidgetSetProperty(screenHandle, MAW_SCREEN_REMOVE_OPTIONS_MENU, "");

#define MAW_SCREEN_IS_SHOWN   "isShown"

Check if a screen is shown.

Valid values

"true" if the screen is visible, "false" otherwise.

Operations

Get only.

Example

        char buffer[BUFFER_SIZE];
        int result = maWidgetGetProperty(screenHandle, MAW_SCREEN_IS_SHOWN, buffer, BUFFER_SIZE);
        if(result == MAW_RES_OK && strcmp(buffer, "true") == 0)
        {
        // Screen is visible.
        }