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.
C#Copypublic class Window : BaseHandle, IDisposable
- Inheritance
- Implements
-
System.IDisposable
Properties
Declaration
C#Copypublic 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
C#Copypublic Vector2 Dpi { get; }
Property Value
Type | Description |
---|---|
Vector2 |
API Level: 3
Declaration
C#Copypublic 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
C#Copypublic uint LayerCount { get; }
Property Value
Type | Description |
---|---|
System.UInt32 |
API Level: 3
Declaration
C#Copypublic Size2D Size { get; }
Property Value
Type | Description |
---|---|
Size2D |
API Level: 3
Declaration
C#Copypublic string Title { get; set; }
Property Value
Type | Description |
---|---|
System.String |
API Level: 4
Declaration
C#Copypublic WindowType Type { get; set; }
Property Value
Type | Description |
---|---|
WindowType |
API Level: 3
Declaration
C#Copypublic Position2D WindowPosition { get; set; }
Property Value
Type | Description |
---|---|
Position2D |
API Level: 4
Declaration
C#Copypublic Size2D WindowSize { get; set; }
Property Value
Type | Description |
---|---|
Size2D |
API Level: 4
Methods
Declaration
C#Copypublic void Activate()
API Level: 3
Declaration
C#Copypublic void Add(View view)
Parameters
Type | Name | Description |
---|---|---|
View | view | the child should be added to the window. |
API Level: 3
Declaration
C#Copypublic uint AddAuxiliaryHint(string hint, string value)
Parameters
Type | Name | Description |
---|---|---|
System.String | hint | The auxiliary hint string. |
System.String | value | The value string. |
Returns
Type | Description |
---|---|
System.UInt32 | The ID of created auxiliary hint, or 0 on failure. |
API Level: 3
Declaration
C#Copypublic void AddLayer(Layer layer)
Parameters
Type | Name | Description |
---|---|---|
Layer | layer | Layer to add. |
API Level: 3
Declaration
C#Copy[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
Declaration
C#Copypublic uint GetAuxiliaryHintId(string hint)
Parameters
Type | Name | Description |
---|---|---|
System.String | hint | The auxiliary hint string. |
Returns
Type | Description |
---|---|
System.UInt32 | The ID of auxiliary hint string, or 0 on failure. |
API Level: 3
Declaration
C#Copypublic string GetAuxiliaryHintValue(uint id)
Parameters
Type | Name | Description |
---|---|---|
System.UInt32 | id | The auxiliary hint ID. |
Returns
Type | Description |
---|---|
System.String | The string value of the auxiliary hint ID, or an empty string if none exists. |
API Level: 3
Declaration
C#Copypublic int GetBrightness()
Returns
Type | Description |
---|---|
System.Int32 | The preferred brightness. |
API Level: 3
Declaration
C#Copypublic Layer GetDefaultLayer()
Returns
Type | Description |
---|---|
Layer | The root layer. |
API Level: 3
Declaration
C#Copypublic Layer GetLayer(uint depth)
Parameters
Type | Name | Description |
---|---|---|
System.UInt32 | depth | The layer's depth index. |
Returns
Type | Description |
---|---|
Layer | The layer found at the given depth. |
API Level: 3
Declaration
C#Copypublic NotificationLevel GetNotificationLevel()
Returns
Type | Description |
---|---|
NotificationLevel | The notification window level. |
API Level: 3
Declaration
C#Copypublic 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
C#Copypublic string GetSupportedAuxiliaryHint(uint index)
Parameters
Type | Name | Description |
---|---|---|
System.UInt32 | index | The index of the supported auxiliary hint lists. |
Returns
Type | Description |
---|---|
System.String | The auxiliary hint string of the index. |
API Level: 3
GetSupportedAuxiliaryHintCount()
Gets the count of supported auxiliary hints of the window.
Declaration
C#Copypublic uint GetSupportedAuxiliaryHintCount()
Returns
Type | Description |
---|---|
System.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
C#Copypublic bool GrabKey(int DaliKey, Window.KeyGrabMode GrabMode)
Parameters
Type | Name | Description |
---|---|---|
System.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
C#Copypublic bool GrabKeyTopmost(int DaliKey)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | DaliKey | The key code to grab. |
Returns
Type | Description |
---|---|
Boolean | True if the grab succeeds. |
API Level: 3
Declaration
C#Copypublic void Hide()
API Level: 3
Declaration
C#Copypublic bool IsFocusAcceptable()
Returns
Type | Description |
---|---|
Boolean | True if the window accepts a focus, false otherwise. |
API Level: 3
Declaration
C#Copypublic 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
Declaration
C#Copypublic bool IsVisible()
Returns
Type | Description |
---|---|
Boolean | True if the window is visible. |
API Level: 3
Declaration
C#Copypublic 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
Declaration
C#Copypublic void Lower()
API Level: 3
Declaration
C#Copypublic void Raise()
API Level: 3
Declaration
C#Copypublic void Remove(View view)
Parameters
Type | Name | Description |
---|---|---|
View | view | the child to be removed. |
API Level: 3
Declaration
C#Copypublic bool RemoveAuxiliaryHint(uint id)
Parameters
Type | Name | Description |
---|---|---|
System.UInt32 | id | The ID of the auxiliary hint. |
Returns
Type | Description |
---|---|
Boolean | True if no error occurred, false otherwise. |
API Level: 3
Declaration
C#Copypublic 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
C#Copypublic void RenderOnce()
API Level: 4
Declaration
C#Copypublic void SetAcceptFocus(bool accept)
Parameters
Type | Name | Description |
---|---|---|
Boolean | accept | If a focus is accepted or not. The default is true. |
API Level: 3
Declaration
C#Copypublic bool SetAuxiliaryHintValue(uint id, string value)
Parameters
Type | Name | Description |
---|---|---|
System.UInt32 | id | The auxiliary hint ID. |
System.String | value | The value string to be set. |
Returns
Type | Description |
---|---|
Boolean | True if no error occurred, false otherwise. |
API Level: 3
Declaration
C#Copypublic bool SetBrightness(int brightness)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | brightness | The preferred brightness (0 to 100). |
Returns
Type | Description |
---|---|
Boolean | True if no error occurred, false otherwise. |
API Level: 3
Declaration
C#Copypublic void SetClass(string name, string klass)
Parameters
Type | Name | Description |
---|---|---|
System.String | name | The name of the window. |
System.String | klass | The class of the window. |
API Level: 4
Declaration
C#Copypublic void SetInputRegion(Rectangle inputRegion)
Parameters
Type | Name | Description |
---|---|---|
Rectangle | inputRegion | The region to accept input events. |
API Level: 3
SetNotificationLevel(NotificationLevel)
Sets a priority level for the specified notification window.
Declaration
C#Copypublic 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
C#Copypublic 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
Declaration
C#Copypublic 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
Declaration
C#Copypublic 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
C#Copypublic bool UngrabKey(int DaliKey)
Parameters
Type | Name | Description |
---|---|---|
System.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
C#Copypublic bool UngrabKeyTopmost(int DaliKey)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | DaliKey | The key code to ungrab. |
Returns
Type | Description |
---|---|
Boolean | True if the ungrab succeeds. |
API Level: 3
Events
Declaration
C#Copypublic event EventHandler<Window.FocusChangedEventArgs> FocusChanged
Event Type
Type | Description |
---|---|
System.EventHandler<Window.FocusChangedEventArgs> |
API Level: 3
Declaration
C#Copypublic event EventHandler<Window.KeyEventArgs> KeyEvent
Event Type
Type | Description |
---|---|
System.EventHandler<Window.KeyEventArgs> |
API Level: 3
Declaration
C#Copypublic event EventHandler<Window.ResizedEventArgs> Resized
Event Type
Type | Description |
---|---|
System.EventHandler<Window.ResizedEventArgs> |
API Level: 3
TouchEvent
This event is emitted when the screen is touched and when the touch ends.
If there are multiple touch points, then this will be emitted when the first touch occurs and
then when the last finger is lifted.
An interrupted event will also be emitted (if it occurs).
Declaration
C#Copypublic event EventHandler<Window.TouchEventArgs> TouchEvent
Event Type
Type | Description |
---|---|
System.EventHandler<Window.TouchEventArgs> |
API Level: 3
Declaration
C#Copypublic event EventHandler<Window.WheelEventArgs> WheelEvent
Event Type
Type | Description |
---|---|
System.EventHandler<Window.WheelEventArgs> |