MoSync 3.3
Stack screen

Defines

#define MAW_STACK_SCREEN_TITLE   "title"
#define MAW_STACK_SCREEN_ICON   "icon"
#define MAW_STACK_SCREEN_BACK_BUTTON_ENABLED   "backButtonEnabled"
 Specifies whether the back button automatically should pop the stack screen.
#define MAW_STACK_SCREEN_IS_SHOWN   "isShown"
 Check if a stack screen is shown.
#define MAW_STACK_SCREEN_PUSH_TRANSITION_TYPE   "pushTransitionType"
 Stack screen's push transition type.
#define MAW_STACK_SCREEN_POP_TRANSITION_TYPE   "popTransitionType"
 Stack screen's pop transition type.
#define MAW_STACK_SCREEN_PUSH_TRANSITION_DURATION   "pushTransitionDuration"
 Stack screen's push transition duration.
#define MAW_STACK_SCREEN_POP_TRANSITION_DURATION   "popTransitionDuration"
 Stack screen's pop transition duration.

Detailed Description

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


Define Documentation

#define MAW_STACK_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_STACK_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_STACK_SCREEN_BACK_BUTTON_ENABLED   "backButtonEnabled"

Specifies whether the back button automatically should pop the stack screen.

This can have different behaviors on different platforms, on iPhone the UI back button is disabled, on Android the stack screen ignores back button events.

Valid values
A boolean string 'true' or 'false'.
Operations
Set only.
Example
#define MAW_STACK_SCREEN_IS_SHOWN   "isShown"

Check if a stack screen is shown.

Valid values
"true" if the stack screen is visible, "false" otherwise.
Operations
Get only.
Example
        char buffer[BUFFER_SIZE];
        int result = maWidgetGetProperty(stackScreenHandle, MAW_STACK_SCREEN_IS_SHOWN,
                                    buffer, BUFFER_SIZE);
        if(result == MAW_RES_OK && strcmp(buffer, "true") == 0)
        {
        // Stack screen is visible.
        }
#define MAW_STACK_SCREEN_PUSH_TRANSITION_TYPE   "pushTransitionType"

Stack screen's push transition type.

Type of the animated transition used when pushing a screen from the current screen stack.

Note: This property is available only Android and Windows Phone. On iOS the native navigation animation is used when pushing a screen.

Valid values
A transition type from the set of available screen transitions found here .
Example
#define MAW_STACK_SCREEN_POP_TRANSITION_TYPE   "popTransitionType"

Stack screen's pop transition type.

Type of the animated transition used when popping a screen from the current screen stack.

Note: This property is available only Android and Windows Phone. On iOS the native navigation animation is used when popping a screen.

Valid values
A transition type from the set of available screen transitions found here .
Example
#define MAW_STACK_SCREEN_PUSH_TRANSITION_DURATION   "pushTransitionDuration"

Stack screen's push transition duration.

Duration of the animated transition used when pushing a screen from the current screen stack.

Note: This property is available only on Android. On iOS the native navigation animation is used when pushing a screen and on Windows Phone is ignored due to the constant duration of the native screen transitions.

Valid values
A positive number representing a time interval in milliseconds.
Example
        char buf[32];
 sprintf(buf, "%d", 300);
        maWidgetSetProperty(stackScreenHandle, MAW_STACK_SCREEN_PUSH_TRANSITION_DURATION, buf);
#define MAW_STACK_SCREEN_POP_TRANSITION_DURATION   "popTransitionDuration"

Stack screen's pop transition duration.

Duration of the animated transition used when popping a screen from the current screen stack.

Note: This property is available only on Android. On iOS the native navigation animation is used when popping a screen and on Windows Phone is ignored due to the constant duration of the native screen transitions.

Valid values
A positive number representing a time interval in milliseconds.
Example
        char buf[32];
 sprintf(buf, "%d", 300);
        maWidgetSetProperty(stackScreenHandle, MAW_STACK_SCREEN_POP_TRANSITION_DURATION, buf);
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines