version 2.8
Renderings

Detailed Description

Built-in rendering functions for the tabset widget.

These function may be passed to gwinSetCustomDraw() to get different tabset drawing styles.

Note
In your custom tabset drawing function you may optionally call these standard functions and then draw your extra details on top.
These custom drawing routines don't have to worry about setting clipping as the framework sets clipping to the object window prior to calling these routines.

Functions

void gwinTabsetDraw_Std (GWidgetObject *gw, void *param)
 The default rendering function for the tabset widget. More...
 
void gwinTabsetDraw_Transparent (GWidgetObject *gw, void *param)
 Renders the tabset but leaves the client area transparent. More...
 
void gwinTabsetDraw_Image (GWidgetObject *gw, void *param)
 Renders the tabset and uses the specified image for the client area. More...
 

Function Documentation

void gwinTabsetDraw_Image ( GWidgetObject gw,
void *  param 
)

Renders the tabset and uses the specified image for the client area.

The image will be tiled throghout the client area. Therefore, to archive the best looking result the supplied image needs to be of the same size as the client area size of the tabset widget (inner size).

Parameters
[in]gwThe widget object (must be a tabset object).
[in]paramA parameter passed in from the user. Must be an image handle. See note below.
Note
The image must be already opened before calling gwinSetCustomDraw(). The handle is passed as the parameter to this function.
Precondition
GDISP_NEED_IMAGE must be set to TRUE
Function Class:
Normal API, this function can be invoked by regular system threads.
void gwinTabsetDraw_Std ( GWidgetObject gw,
void *  param 
)

The default rendering function for the tabset widget.

Fills the client area with the background color.

Parameters
[in]gwThe widget object (must be a container object).
[in]paramA parameter passed in from the user. Ignored by this function.
Function Class:
Normal API, this function can be invoked by regular system threads.
void gwinTabsetDraw_Transparent ( GWidgetObject gw,
void *  param 
)

Renders the tabset but leaves the client area transparent.

Will not fill the client area at all.

Parameters
[in]gwThe widget object (must be a container object).
[in]paramA parameter passed in from the user. Ignored by this function.
Function Class:
Normal API, this function can be invoked by regular system threads.