Class Window

Definition

Namespace:

Tizen.NUI

Assembly:

Tizen.NUI.dll

API Level:

3

The window class is used internally for drawing.
The window has an orientation and indicator properties.

public class Window : BaseHandle, INotifyPropertyChanged, IDynamicResourceHandler, IElement, INameScope, IElementController, IDisposable

Inheritance

Object

Tizen.NUI.Binding.BindableObject

Tizen.NUI.Binding.Element

BaseHandle

Window

Implements

INotifyPropertyChanged

IDisposable

Constructors

Window(String, Rectangle, Boolean)

Creates a new Window with a specific name.
This creates an extra window in addition to the default main window

Declaration

public Window(string name, Rectangle windowPosition = null, bool isTranslucent = false)

Parameters

Type	Name	Description
String	name	The name for extra window.
Rectangle	windowPosition	The position and size of the Window.
Boolean	isTranslucent	Whether Window is translucent.

Exceptions

Type	Condition
NotSupportedException	The required feature is not supported.

API Level: 6

Feature: http://tizen.org/feature/opengles.surfaceless_context

Window(Rectangle, Boolean)

Creates a new Window.
This creates an extra window in addition to the default main window

Declaration

public Window(Rectangle windowPosition = null, bool isTranslucent = false)

Parameters

Type	Name	Description
Rectangle	windowPosition	The position and size of the Window.
Boolean	isTranslucent	Whether Window is translucent.

Exceptions

Type	Condition
NotSupportedException	The required feature is not supported.

API Level: 6

Feature: http://tizen.org/feature/opengles.surfaceless_context

Properties

BackgroundColor

The background color property.

Declaration

public Color BackgroundColor { get; set; }

Property Value

Type	Description
Color

API Level: 3

Dpi

The DPI property (read-only).
Retrieves the DPI of the display device to which the Window is connected.

Declaration

public Vector2 Dpi { get; }

Property Value

Type	Description
Vector2

API Level: 3

Instance

The stage instance property (read-only).
Gets the current window.

Declaration

public static Window Instance { get; }

Property Value

Type	Description
Window

API Level: 3

LayerCount

The layer count property (read-only).
Queries the number of on-Window layers.

Declaration

public uint LayerCount { get; }

Property Value

Type	Description
UInt32

API Level: 3

RenderingBehavior

The rendering behavior of a Window.

Declaration

public RenderingBehaviorType RenderingBehavior { get; set; }

Property Value

Type	Description
RenderingBehaviorType

API Level: 5

Size

The window size property (read-only).

Declaration

public Size2D Size { get; }

Property Value

Type	Description
Size2D

API Level: 3

Title

Gets/Sets a window title.

Declaration

public string Title { get; set; }

Property Value

Type	Description
String

API Level: 4

Type

Gets or sets a window type.

Declaration

public WindowType Type { get; set; }

Property Value

Type	Description
WindowType

API Level: 3

WindowPosition

Gets or sets a position of the window.

Declaration

public Position2D WindowPosition { get; set; }

Property Value

Type	Description
Position2D

API Level: 4

WindowSize

Gets or sets a size of the window.

Declaration

public Size2D WindowSize { get; set; }

Property Value

Type	Description
Size2D

API Level: 4

Methods

Activate()

Activates the window to the top of the window stack even it is iconified.

Declaration

public void Activate()

API Level: 3

Add(View)

Add a child view to window.

Declaration

public void Add(View view)

Parameters

Type	Name	Description
View	view	the child should be added to the window.

API Level: 3

AddAuxiliaryHint(String, String)

Creates an auxiliary hint of the window.

Declaration

public uint AddAuxiliaryHint(string hint, string value)

Parameters

Type	Name	Description
String	hint	The auxiliary hint string.
String	value	The value string.

Returns

Type	Description
UInt32	The ID of created auxiliary hint, or 0 on failure.

API Level: 3

AddAvailableOrientation(Window.WindowOrientation)

Adds an orientation to the list of available orientations.

Declaration

public void AddAvailableOrientation(Window.WindowOrientation orientation)

Parameters

Type	Name	Description
Window.WindowOrientation	orientation	The available orientation to add

API Level: 6

AddLayer(Layer)

Adds a layer to the stage.

Declaration

public void AddLayer(Layer layer)

Parameters

Type	Name	Description
Layer	layer	Layer to add.

API Level: 3

FeedKey(Key)

Feeds a key event into the window.

Declaration

public void FeedKey(Key keyEvent)

Parameters

Type	Name	Description
Key	keyEvent	The key event to feed.

API Level: 5

FeedKeyEvent(Key)

Please do not use! This will be deprecated! Please use FeedKey(Key keyEvent) instead!

Feed a key-event into the window.

Declaration

[Obsolete("Please do not use! This will be deprecated! Please use FeedKey(Key keyEvent) instead!")]
public static void FeedKeyEvent(Key keyEvent)

Parameters

Type	Name	Description
Key	keyEvent	The key event to feed.

API Level: 4

GetAuxiliaryHintId(String)

Gets an ID of the auxiliary hint string.

Declaration

public uint GetAuxiliaryHintId(string hint)

Parameters

Type	Name	Description
String	hint	The auxiliary hint string.

Returns

Type	Description
UInt32	The ID of auxiliary hint string, or 0 on failure.

API Level: 3

GetAuxiliaryHintValue(UInt32)

Gets a value of the auxiliary hint.

Declaration

public string GetAuxiliaryHintValue(uint id)

Parameters

Type	Name	Description
UInt32	id	The auxiliary hint ID.

Returns

Type	Description
String	The string value of the auxiliary hint ID, or an empty string if none exists.

API Level: 3

GetBrightness()

Gets the preferred brightness of the window.

Declaration

public int GetBrightness()

Returns

Type	Description
Int32	The preferred brightness.

API Level: 3

GetDefaultLayer()

Gets the default ( root ) layer.

Declaration

public Layer GetDefaultLayer()

Returns

Type	Description
Layer	The root layer.

API Level: 3

GetKeyboardRepeatInfo(out Single, out Single)

Gets the keyboard repeat information.

Declaration

public bool GetKeyboardRepeatInfo(out float rate, out float delay)

Parameters

Type	Name	Description
Single	rate	The key repeat rate value in seconds.
Single	delay	The key repeat delay value in seconds.

Returns

Type	Description
Boolean	True if setting the keyboard repeat succeeds.

API Level: 5

GetLayer(UInt32)

Retrieves the layer at a specified depth.

Declaration

public Layer GetLayer(uint depth)

Parameters

Type	Name	Description
UInt32	depth	The layer's depth index.

Returns

Type	Description
Layer	The layer found at the given depth.

API Level: 3

GetNotificationLevel()

Gets a priority level for the specified notification window.

Declaration

public NotificationLevel GetNotificationLevel()

Returns

Type	Description
NotificationLevel	The notification window level.

API Level: 3

GetParent()

Gets parent window of the window.

Declaration

public Window GetParent()

Returns

Type	Description
Window	The parent window of the window.

Exceptions

Type	Condition
NotSupportedException	The required feature is not supported.

API Level: 6

Feature: http://tizen.org/feature/opengles.surfaceless_context

GetPreferredOrientation()

Gets the preferred orientation.

Declaration

public Window.WindowOrientation GetPreferredOrientation()

Returns

Type	Description
Window.WindowOrientation	The preferred orientation if previously set, or none.

API Level: 6

GetScreenOffMode()

Gets the screen mode of the window.

Declaration

public ScreenOffMode GetScreenOffMode()

Returns

Type	Description
ScreenOffMode	The screen off mode.

API Level: 4

GetSupportedAuxiliaryHint(UInt32)

Gets the supported auxiliary hint string of the window.

Declaration

public string GetSupportedAuxiliaryHint(uint index)

Parameters

Type	Name	Description
UInt32	index	The index of the supported auxiliary hint lists.

Returns

Type	Description
String	The auxiliary hint string of the index.

API Level: 3

GetSupportedAuxiliaryHintCount()

Gets the count of supported auxiliary hints of the window.

Declaration

public uint GetSupportedAuxiliaryHintCount()

Returns

Type	Description
UInt32	The number of supported auxiliary hints.

API Level: 3

GrabKey(Int32, Window.KeyGrabMode)

Grabs the key specified by a key for a window in a GrabMode.
Details: This function can be used for following example scenarios:

• TV - A user might want to change the volume or channel of the background TV contents while focusing on the foregrund app.
  
• Mobile - When a user presses the Home key, the homescreen appears regardless of the current foreground app.
  
• Mobile - Using the volume up or down as zoom up or down in camera apps.
  

Declaration

public bool GrabKey(int DaliKey, Window.KeyGrabMode GrabMode)

Parameters

Type	Name	Description
Int32	DaliKey	The key code to grab.
Window.KeyGrabMode	GrabMode	The grab mode for the key.

Returns

Type	Description
Boolean	True if the grab succeeds.

API Level: 3

GrabKeyTopmost(Int32)

Grabs the key specified by a key for a window only when a window is the topmost window.
This function can be used for following example scenarios:

• Mobile - Using volume up or down as zoom up or down in camera apps.
  

Declaration

public bool GrabKeyTopmost(int DaliKey)

Parameters

Type	Name	Description
Int32	DaliKey	The key code to grab.

Returns

Type	Description
Boolean	True if the grab succeeds.

API Level: 3

Hide()

Hides the window if it is showing.

Declaration

public void Hide()

API Level: 3

IsFocusAcceptable()

Returns whether the window accepts a focus or not.

Declaration

public bool IsFocusAcceptable()

Returns

Type	Description
Boolean	True if the window accepts a focus, false otherwise.

API Level: 3

IsOpaqueState()

Returns whether a transparent window's visual state is opaque or not.

Declaration

public bool IsOpaqueState()

Returns

Type	Description
Boolean	True if the window's visual state is opaque, false otherwise.

Remarks

The return value has no meaning on an opaque window.

API Level: 3

IsVisible()

Retrieves whether the window is visible or not.

Declaration

public bool IsVisible()

Returns

Type	Description
Boolean	True if the window is visible.

API Level: 3

KeepRendering(Single)

Keep rendering for at least the given amount of time.

Declaration

public void KeepRendering(float durationSeconds)

Parameters

Type	Name	Description
Single	durationSeconds	Time to keep rendering, 0 means render at least one more frame.

API Level: 3

Lower()

Lowers the window to the bottom of the window stack.

Declaration

public void Lower()

API Level: 3

Raise()

Raises the window to the top of the window stack.

Declaration

public void Raise()

API Level: 3

Remove(View)

Remove a child view from window.

Declaration

public void Remove(View view)

Parameters

Type	Name	Description
View	view	the child to be removed.

API Level: 3

RemoveAuxiliaryHint(UInt32)

Removes an auxiliary hint of the window.

Declaration

public bool RemoveAuxiliaryHint(uint id)

Parameters

Type	Name	Description
UInt32	id	The ID of the auxiliary hint.

Returns

Type	Description
Boolean	True if no error occurred, false otherwise.

API Level: 3

RemoveAvailableOrientation(Window.WindowOrientation)

Removes an orientation from the list of available orientations.

Declaration

public void RemoveAvailableOrientation(Window.WindowOrientation orientation)

Parameters

Type	Name	Description
Window.WindowOrientation	orientation	The available orientation to remove.

API Level: 6

RemoveLayer(Layer)

Removes a layer from the stage.

Declaration

public void RemoveLayer(Layer layer)

Parameters

Type	Name	Description
Layer	layer	Layer to remove.

API Level: 3

RenderOnce()

Allows at least one more render, even when paused. The window should be shown, not minimised.

Declaration

public void RenderOnce()

API Level: 4

SetAcceptFocus(Boolean)

Sets whether the window accepts a focus or not.

Declaration

public void SetAcceptFocus(bool accept)

Parameters

Type	Name	Description
Boolean	accept	If a focus is accepted or not. The default is true.

API Level: 3

SetAuxiliaryHintValue(UInt32, String)

Changes a value of the auxiliary hint.

Declaration

public bool SetAuxiliaryHintValue(uint id, string value)

Parameters

Type	Name	Description
UInt32	id	The auxiliary hint ID.
String	value	The value string to be set.

Returns

Type	Description
Boolean	True if no error occurred, false otherwise.

API Level: 3

SetBrightness(Int32)

Sets preferred brightness of the window.

Declaration

public bool SetBrightness(int brightness)

Parameters

Type	Name	Description
Int32	brightness	The preferred brightness (0 to 100).

Returns

Type	Description
Boolean	True if no error occurred, false otherwise.

API Level: 3

SetClass(String, String)

Sets the window name and the class string.

Declaration

public void SetClass(string name, string klass)

Parameters

Type	Name	Description
String	name	The name of the window.
String	klass	The class of the window.

API Level: 4

SetInputRegion(Rectangle)

Sets a region to accept input events.

Declaration

public void SetInputRegion(Rectangle inputRegion)

Parameters

Type	Name	Description
Rectangle	inputRegion	The region to accept input events.

API Level: 3

SetKeyboardRepeatInfo(Single, Single)

Sets the keyboard repeat information.

Declaration

public bool SetKeyboardRepeatInfo(float rate, float delay)

Parameters

Type	Name	Description
Single	rate	The key repeat rate value in seconds.
Single	delay	The key repeat delay value in seconds.

Returns

Type	Description
Boolean	True if setting the keyboard repeat succeeds.

API Level: 5

SetNotificationLevel(NotificationLevel)

Sets a priority level for the specified notification window.

Declaration

public bool SetNotificationLevel(NotificationLevel level)

Parameters

Type	Name	Description
NotificationLevel	level	The notification window level.

Returns

Type	Description
Boolean	True if no error occurred, false otherwise.

API Level: 3

SetOpaqueState(Boolean)

Sets a transparent window's visual state to opaque.
If a visual state of a transparent window is opaque,
then the window manager could handle it as an opaque window when calculating visibility.

Declaration

public void SetOpaqueState(bool opaque)

Parameters

Type	Name	Description
Boolean	opaque	Whether the window's visual state is opaque.

Remarks

This will have no effect on an opaque window.
It doesn't change transparent window to opaque window but lets the window manager know the visual state of the window.

API Level: 3

SetParent(Window)

Sets parent window of the window. After setting that, these windows do together when raise-up, lower and iconified/deiconified. Initially, the window is located on top of the parent. The window can go below parent by calling Lower(). If parent's window stack is changed by calling Raise() or Lower(), child windows are located on top of the parent again.

Declaration

public void SetParent(Window parent)

Parameters

Type	Name	Description
Window	parent	The parent window.

Exceptions

Type	Condition
NotSupportedException	The required feature is not supported.

API Level: 6

Feature: http://tizen.org/feature/opengles.surfaceless_context

SetPreferredOrientation(Window.WindowOrientation)

Sets a preferred orientation.

Declaration

public void SetPreferredOrientation(Window.WindowOrientation orientation)

Parameters

Type	Name	Description
Window.WindowOrientation	orientation	The preferred orientation.

API Level: 6

SetScreenOffMode(ScreenOffMode)

Sets a window's screen off mode.

Declaration

public bool SetScreenOffMode(ScreenOffMode screenOffMode)

Parameters

Type	Name	Description
ScreenOffMode	screenOffMode	The screen mode.

Returns

Type	Description
Boolean	True if no error occurred, false otherwise.

API Level: 4

SetTransparency(Boolean)

Sets whether the window is transparent or not.

Declaration

public void SetTransparency(bool transparent)

Parameters

Type	Name	Description
Boolean	transparent	Whether the window is transparent or not.

API Level: 5

Show()

Shows the window if it is hidden.

Declaration

public void Show()

API Level: 3

UngrabKey(Int32)

Ungrabs the key specified by a key for a window.
Note: If this function is called between key down and up events of a grabbed key, an application doesn't receive the key up event.

Declaration

public bool UngrabKey(int DaliKey)

Parameters

Type	Name	Description
Int32	DaliKey	The key code to ungrab.

Returns

Type	Description
Boolean	True if the ungrab succeeds.

API Level: 3

UngrabKeyTopmost(Int32)

Ungrabs the key specified by a key for the window.
Note: If this function is called between key down and up events of a grabbed key, an application doesn't receive the key up event.

Declaration

public bool UngrabKeyTopmost(int DaliKey)

Parameters

Type	Name	Description
Int32	DaliKey	The key code to ungrab.

Returns

Type	Description
Boolean	True if the ungrab succeeds.

API Level: 3

Unparent()

Unsets parent window of the window. After unsetting, the window is disconnected his parent window.

Declaration

public void Unparent()

Exceptions

Type	Condition
NotSupportedException	The required feature is not supported.

API Level: 6

Feature: http://tizen.org/feature/opengles.surfaceless_context

Events

FocusChanged

FocusChanged event.

Declaration

public event EventHandler<Window.FocusChangedEventArgs> FocusChanged

Event Type

Type	Description
EventHandler<Window.FocusChangedEventArgs>

API Level: 3

KeyEvent

Emits the event when the key event is received.

Declaration

public event EventHandler<Window.KeyEventArgs> KeyEvent

Event Type

Type	Description
EventHandler<Window.KeyEventArgs>

API Level: 3

Resized

Emits the event when the window resized.

Declaration

public event EventHandler<Window.ResizedEventArgs> Resized

Event Type

Type	Description
EventHandler<Window.ResizedEventArgs>

API Level: 3

TouchEvent

Emits the event when the screen is touched and when the touch ends.
If there are multiple touch points then it is emitted when the first touch occurs and when the last finger is lifted too.
Even though incoming events are interrupted, the event occurs.

Declaration

public event EventHandler<Window.TouchEventArgs> TouchEvent

Event Type

Type	Description
EventHandler<Window.TouchEventArgs>

API Level: 3

WheelEvent

Emits the event when the wheel event is received.

Declaration

public event EventHandler<Window.WheelEventArgs> WheelEvent

Event Type

Type	Description
EventHandler<Window.WheelEventArgs>

API Level: 3

Implements

System.ComponentModel.INotifyPropertyChanged

System.IDisposable