Skip to content
Titanium SDK
Version14.0.0

openWindowParams

pseudoAndroidiPhoneiPadmacOSsince Android 2.0.0, iPhone 2.0.0, iPad 2.0.0, macOS 9.2.0

Dictionary of options for the Titanium.UI.Window.open method.

Properties 19

activityEnterAnimation

NumberAndroidsince 3.1.0

Animation resource to run on the activity being opened.

This value will be ignored if animated is set to false. See "Window Transitions in Android" in the main description of Titanium.UI.Window for more information.

Sliding in a new Window

var win2 = Ti.UI.createWindow({fullscreen:false});
win2.open({
    activityEnterAnimation: Ti.Android.R.anim.slide_in_left,
    activityExitAnimation: Ti.Android.R.anim.slide_out_right
});

activityExitAnimation

NumberAndroidsince 3.1.0

Animation resource to run on the activity that is being put in background as a window is being opened above it.

This value will be ignored if animated is set to false. See "Window Transitions in Android" in the main description of Titanium.UI.Window for more information.

animated

Boolean

Determines whether to use an animated effect when the window is shown.

On Android, this property supports animated transitions on windows except for modal windows (modal:true). The transitions are on by default, but you can disable this behavior by setting this value to false.

On iOS, only use this property to disable animated transitions on modal windows. This property has unintended side effects on non-modal windows if it is defined.

Default: true

bottom

Number | String

Window's bottom position, in platform-specific units.

On Android, this property has no effect.

Default: 0

forceModal

BooleaniPhoneiPadmacOSsince iPhone 8.2.0, iPad 8.2.0, macOS 9.2.0iOS 13.0+

Indicates whether the window enforces modal behaviour.

Set to true to prevent interactive dismissal of window while it is onscreen.

Default: false

fullscreen

Boolean

Determines if the window is fullscreen.

Default: false

height

Number | String

Window's height, in platform-specific units.

On Windows Phone and Windows 10 Mobile, this property does not take any effect. On Windows 10 Store App, resizing Window takes no effect in following cases according to Windows Runtime API document.

  • The requested size is larger than the available work area.
  • The requested size is less than the view's minimum size.
  • The smallest allowed minimum size is 192 x 48 effective pixels.
  • The largest allowed minimum size is 500 x 500 effective pixels.

left

Number | String

Window's left position, in platform-specific units.

On Android, this property has no effect.

Default: 0

scene

Titanium.App.iOS.SceneProxyiPhoneiPadsince 14.0.0read-onlyiOS 13.0+

The scene proxy associated with this window.

Returns a Titanium.App.iOS.SceneProxy object representing the UIWindowScene that this window belongs to. In multi-scene apps on iPadOS, each window is associated with a specific scene. Use this property to access scene-specific information such as trait collections.

Returns null if scenes are not available (iOS versions prior to 13.0 or apps without a scene manifest).

var win = Ti.UI.createWindow({ backgroundColor: '#fff' });
win.addEventListener('open', function() {
    var scene = win.scene;
    if (scene) {
        Ti.API.info('Window belongs to scene: ' + scene.sceneId);
    }
});

top

Number | String

Window's top position, in platform-specific units.

On Android, this property has no effect.

Default: 0

verticalBarBehavior

NumberiPhoneiPadsince 14.0.0iOS 27.1+

Whether the system may lay out the bars of this window vertically.

On iPhone Duo and apps built with the iOS 27.1 SDK or later, the system moves the navigation bar and toolbar buttons into a vertical bar along the screen edge. Set this property to Titanium.UI.iOS.VERTICAL_BAR_BEHAVIOR_DISABLED to opt out and keep the standard horizontal top and bottom bars.

Only disable the vertical bar for screens that are better served by horizontal bars, such as a full-screen video player or a non-scrolling layout like a calculator. Treat it as a stable choice and avoid changing it frequently while the user navigates.

When the window is shown inside a Titanium.UI.NavigationWindow or Titanium.UI.TabGroup, set this property on the content window. The preference of the currently visible window is used.

Default: <Titanium.UI.iOS.VERTICAL_BAR_BEHAVIOR_AUTOMATIC>

verticalBarCompressionBehavior

NumberiPhoneiPadsince 14.0.0iOS 27.1+

Defines whether the bar items or the tab bar compress first when the vertical bar runs out of space.

This property only has an effect if the window is shown with a vertical bar (iPhone Duo, iOS 27.1 SDK or later). It is applied to the navigation item of the window, so the window needs to be inside a Titanium.UI.NavigationWindow or Titanium.UI.TabGroup.

Default: <Titanium.UI.iOS.VERTICAL_BAR_COMPRESSION_BEHAVIOR_AUTOMATIC>

width

Number | String

Window's width, in platform-specific units.

On Windows Phone and Windows 10 Mobile, this property does not take any effect. On Windows 10 Store App, resizing Window takes no effect in following cases according to Windows Runtime API document.

  • The requested size is larger than the available work area.
  • The requested size is less than the view's minimum size.
  • The smallest allowed minimum size is 192 x 48 effective pixels.
  • The largest allowed minimum size is 500 x 500 effective pixels.
  • This method is called while in while the app is running in Tablet Mode.