# openWindowParams

> Dictionary of options for the [Titanium.UI.Window.open](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#open) method.

- Source: https://titaniumsdk.com/docs/sdk/openWindowParams
- Titanium SDK version: 14.0.0
- Kind: pseudo
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 2.0.0, iPhone 2.0.0, iPad 2.0.0, macOS 9.2.0

## Properties

### activityEnterAnimation

- Type: Number
- Platforms: Android
- Since: Titanium SDK 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.

Example: Sliding in a new Window

``` js
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

- Type: Number
- Platforms: Android
- Since: Titanium SDK 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

- Type: Boolean
- Platforms: Android, iPhone, iPad, macOS
- Default: `true`

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.

### bottom

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Default: `0`

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

On Android, this property has no effect.

### forceModal

- Type: Boolean
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK iPhone 8.2.0, iPad 8.2.0, macOS 9.2.0
- Requires: iOS 13.0+
- Default: `false`

Indicates whether the window enforces modal behaviour.

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

### fullscreen

- Type: Boolean
- Platforms: Android, iPhone, iPad, macOS
- Default: `false`

Determines if the window is fullscreen.

### height

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS

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](https://msdn.microsoft.com/en-us/library/windows/apps/windows.ui.viewmanagement.applicationview.tryresizeview).
* 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

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Default: `0`

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

On Android, this property has no effect.

### modal

- Type: Boolean
- Platforms: Android, iPhone, iPad, macOS
- Default: `false`

Determines whether to open the window modal in front of other windows.

### modalStyle

- Type: Number
- Platforms: iPhone, iPad, macOS
- Default: `<Titanium.UI.iOS.MODAL_PRESENTATION_FULLSCREEN>`

Presentation style of this modal window.

Accepts: `Titanium.UI.iOS.MODAL_PRESENTATION_CURRENT_CONTEXT`, `Titanium.UI.iOS.MODAL_PRESENTATION_FORMSHEET`, `Titanium.UI.iOS.MODAL_PRESENTATION_FULLSCREEN`, `Titanium.UI.iOS.MODAL_PRESENTATION_OVER_CURRENT_CONTEXT`, `Titanium.UI.iOS.MODAL_PRESENTATION_OVER_CURRENT_FULL_SCREEN`, `Titanium.UI.iOS.MODAL_PRESENTATION_PAGESHEET`

### modalTransitionStyle

- Type: Number
- Platforms: iPhone, iPad, macOS
- Default: `<Titanium.UI.iOS.MODAL_TRANSITION_STYLE_COVER_VERTICAL>`

Transition style of this modal window.

Accepts: `Titanium.UI.iOS.MODAL_TRANSITION_STYLE_COVER_VERTICAL`, `Titanium.UI.iOS.MODAL_TRANSITION_STYLE_CROSS_DISSOLVE`, `Titanium.UI.iOS.MODAL_TRANSITION_STYLE_FLIP_HORIZONTAL`, `Titanium.UI.iOS.MODAL_TRANSITION_STYLE_PARTIAL_CURL`

### navBarHidden

- Type: Boolean
- Platforms: Android, iPhone, iPad, macOS
- Default: `false`

For modal windows, hides the nav bar (`true`) or shows the nav bar (`false`).

On iOS, beginning with **Release 3.1.3**, this is no longer a valid parameter passed to the [Window.open](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#open) method.

### right

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Default: `0`

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

On Android, this property has no effect.

### scene

- Type: Titanium.App.iOS.SceneProxy
- Platforms: iPhone, iPad
- Since: Titanium SDK 14.0.0
- Requires: iOS 13.0+
- Permission: read-only

The scene proxy associated with this window.

Returns a [Titanium.App.iOS.SceneProxy](https://titaniumsdk.com/docs/sdk/Titanium.App.iOS.SceneProxy.md) 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).

``` js
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

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Default: `0`

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

On Android, this property has no effect.

### transition

- Type: Number
- Platforms: iPhone, iPad, macOS
- Default: `<Titanium.UI.iOS.AnimationStyle.NONE>`

Transition style of this non-modal window.

Accepts: `Titanium.UI.iOS.AnimationStyle.CROSS_DISSOLVE`, `Titanium.UI.iOS.AnimationStyle.CURL_DOWN`, `Titanium.UI.iOS.AnimationStyle.CURL_UP`, `Titanium.UI.iOS.AnimationStyle.FLIP_FROM_BOTTOM`, `Titanium.UI.iOS.AnimationStyle.FLIP_FROM_LEFT`, `Titanium.UI.iOS.AnimationStyle.FLIP_FROM_RIGHT`, `Titanium.UI.iOS.AnimationStyle.FLIP_FROM_TOP`, `Titanium.UI.iOS.AnimationStyle.NONE`

### verticalBarBehavior

- Type: Number
- Platforms: iPhone, iPad
- Since: Titanium SDK 14.0.0
- Requires: iOS 27.1+
- Default: `<Titanium.UI.iOS.VERTICAL_BAR_BEHAVIOR_AUTOMATIC>`

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](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.md#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](https://titaniumsdk.com/docs/sdk/Titanium.UI.NavigationWindow.md) or [Titanium.UI.TabGroup](https://titaniumsdk.com/docs/sdk/Titanium.UI.TabGroup.md), set this property
on the content window. The preference of the currently visible window is used.

Accepts: `Titanium.UI.iOS.VERTICAL_BAR_BEHAVIOR_AUTOMATIC`, `Titanium.UI.iOS.VERTICAL_BAR_BEHAVIOR_DISABLED`

### verticalBarCompressionBehavior

- Type: Number
- Platforms: iPhone, iPad
- Since: Titanium SDK 14.0.0
- Requires: iOS 27.1+
- Default: `<Titanium.UI.iOS.VERTICAL_BAR_COMPRESSION_BEHAVIOR_AUTOMATIC>`

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](https://titaniumsdk.com/docs/sdk/Titanium.UI.NavigationWindow.md) or [Titanium.UI.TabGroup](https://titaniumsdk.com/docs/sdk/Titanium.UI.TabGroup.md).

Accepts: `Titanium.UI.iOS.VERTICAL_BAR_COMPRESSION_BEHAVIOR_AUTOMATIC`, `Titanium.UI.iOS.VERTICAL_BAR_COMPRESSION_BEHAVIOR_PREFERS_BAR_ITEMS`, `Titanium.UI.iOS.VERTICAL_BAR_COMPRESSION_BEHAVIOR_PREFERS_TAB_BAR`

### width

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS

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](https://msdn.microsoft.com/en-us/library/windows/apps/windows.ui.viewmanagement.applicationview.tryresizeview).
* 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.

---

- This corpus documents Titanium SDK 14.0.0. Anything here that does not name a version describes 14.0.0.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.