Tizen Native API  9.0
Functions | Typedefs
Tizen WS Shell
UI

The Tizen WS Shell (tzsh) provides APIs to communicate with the window manager.

Required Header

#include <tzsh.h>

Overview

The Tizen WS Shell API provides functions to create/destroy the tzsh instance to communicate the window manager.

The Tizen WS Shell (TZSH) is a library for system GUI services such as Quickpanel and Softkey that have various Tizen-specific features through communication with the window manager.
By using the TZSH and its sub-libraries, it is possible to create global system GUI applications, and user applications can also use the libraries to obtain and modify status of the system GUI applications.
For sub-libraries, the TZSH library creates, deletes, and defines error types of the TZSH instances. It is possible to generate sub-libraries by combining the generated TZSH instance with a client window.

Functions

tzsh_h tzsh_create (tzsh_toolkit_type_e type)
 Creates a tzsh_h instance.
int tzsh_destroy (tzsh_h tzsh)
 Destroys the given tzsh_h instance.

Typedefs

typedef struct _tzsh_s * tzsh_h
 Handle for the Tizen shell.
typedef unsigned int tzsh_window
 The window handle for native window.

Typedef Documentation

typedef struct _tzsh_s* tzsh_h

Handle for the Tizen shell.

Since :
3.0
typedef unsigned int tzsh_window

The window handle for native window.

This is abstract window type for native window handle.

Since :
3.0

Enumeration Type Documentation

enum tzsh_error_e

Enumeration for Tizen shell error.

Since :
3.0
Enumerator:
TZSH_ERROR_NONE 

Successful

TZSH_ERROR_OUT_OF_MEMORY 

Out of memory

TZSH_ERROR_INVALID_PARAMETER 

Invalid parameter

TZSH_ERROR_PERMISSION_DENIED 

Permission denied

TZSH_ERROR_NOT_SUPPORTED 

Not supported

TZSH_ERROR_NO_SERVICE 

Service does not exist

TZSH_ERROR_ALREADY_REGISTERED_WINDOW 

Window is already registered

enum tzsh_toolkit_type_e

Enumeration for toolkit type.

Since :
3.0
Enumerator:
TZSH_TOOLKIT_TYPE_UNKNOWN 

Unknown type

TZSH_TOOLKIT_TYPE_EFL 

Use EFL toolkit

Function Documentation

tzsh_h tzsh_create ( tzsh_toolkit_type_e  type)

Creates a tzsh_h instance.

This function creates a tzsh_h instance for the given toolkit type.

Since :
3.0
Remarks:
The returned handle should be released using tzsh_destroy(). The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]typeThe toolkit type
Returns:
tzsh_h instance on success, NULL otherwise
Exceptions:
TZSH_ERROR_NONESuccessful
TZSH_ERROR_INVALID_PARAMETERInvalid parameter
TZSH_ERROR_OUT_OF_MEMORYOut of memory
See also:
tzsh_destroy()
int tzsh_destroy ( tzsh_h  tzsh)

Destroys the given tzsh_h instance.

Since :
3.0
Parameters:
[in]tzshThe tzsh_h instance to be destroyed
Returns:
0 on success, otherwise a negative error value
Return values:
TZSH_ERROR_NONESuccessful
TZSH_ERROR_INVALID_PARAMETERInvalid parameter
See also:
tzsh_create()