skin.h

Go to the documentation of this file.

/*
 * $Id: skin.h,v 1.58 2006/06/11 04:20:37 weiym Exp $
 *
 *             MiniGUI for Linux/uClinux, eCos, uC/OS-II, VxWorks, 
 *                     pSOS, ThreadX, NuCleus, OSE, and Win32.
 *
 *             Copyright (C) 2002-2006 Feynman Software.
 *             Copyright (C) 1998-2002 Wei Yongming.
 */


#ifndef _MGUI_SKIN_H
#define _MGUI_SKIN_H

#ifdef _EXT_SKIN

/* skin messages (send to items) */
#define SKIN_MSG_LBUTTONDOWN    1
#define SKIN_MSG_LBUTTONUP      2
#define SKIN_MSG_CLICK          3
/*#define SKIN_MSG_DBCLICK      4 */
#define SKIN_MSG_MOUSEMOVE      5
#define SKIN_MSG_MOUSEDRAG      6
#define SKIN_MSG_SETFOCUS       7
#define SKIN_MSG_KILLFOCUS      8

/* type of item */

#define SI_TYPE_NRMLABEL        0x10000000

#define SI_TYPE_BMPLABEL        0x20000000

#define SI_TYPE_CMDBUTTON       0x30000000

#define SI_TYPE_CHKBUTTON       0x40000000

#define SI_TYPE_NRMSLIDER       0x50000000

#ifdef _FIXED_MATH

#define SI_TYPE_ROTSLIDER       0x60000000
#endif

#define SI_TYPE_CONTROL         0x70000000

#define SI_TYPE_MASK            0xF0000000

/* type of hittest shape */

#define SI_TEST_SHAPE_RECT      0x01000000

#ifdef _USE_NEWGAL

#define SI_TEST_SHAPE_ELLIPSE   0x02000000

#define SI_TEST_SHAPE_LOZENGE   0x03000000

#define SI_TEST_SHAPE_LTRIANGLE 0x04000000

#define SI_TEST_SHAPE_RTRIANGLE 0x05000000

#define SI_TEST_SHAPE_UTRIANGLE 0x06000000

#define SI_TEST_SHAPE_DTRIANGLE 0x07000000

#endif

#define SI_TEST_SHAPE_MASK      0x0F000000

/* common status of item */

#define SI_STATUS_OK            0x00000001

#define SI_STATUS_VISIBLE       0x00000002

#define SI_STATUS_DISABLED      0x00000004

#define SI_STATUS_HILIGHTED     0x00000008

#define SI_STATUS_MASK          0x0000000F

/* status of button item */

#define SI_BTNSTATUS_CLICKED    0x00000010

#define SI_BTNSTATUS_CHECKED    SI_BTNSTATUS_CLICKED

#define SI_STATUS_CLICKED       SI_BTNSTATUS_CLICKED

#define SI_BTNSTATUS_MASK       0x000000F0

#define SI_CMDBUTTON_2STATE     0x00000100

/* style of normal slider item */

#define SI_NRMSLIDER_HORZ       0x00000100

#define SI_NRMSLIDER_VERT       0x00000200

#define SI_NRMSLIDER_STATIC     0x00000400

#ifdef _FIXED_MATH

/* style of rotation slider item */

#define SI_ROTSLIDER_CW         0x00000100

#define SI_ROTSLIDER_ANTICW     0x00000200

#define SI_ROTSLIDER_STATIC     0x00000400

#endif /* _FIXED_MATH */

#define SI_STYLE_MASK           0x0000FF00

#define CTRL_SKIN               "skin"

typedef struct skin_item_ops_s skin_item_ops_t;

typedef struct skin_head_s skin_head_t;

typedef struct skin_item_s
{
    int id;

    DWORD style;

    int x;
    int y;

    RECT item_rc;

    int bmp_index;

    char* tip;

    DWORD attached;

    void* type_data;

    /******** start of internal fields ********/
    /* The bounding rectangle of the item. */
    RECT shape;
    /* The hit-test rectangle of the item. */
    RECT rc_hittest;
    /* The region for mouse hittest. */
    CLIPRGN region;
    /* The operation routines of the item. */
    skin_item_ops_t *ops;
    /* The parent skin. */
    skin_head_t *hostskin;
} skin_item_t;

struct skin_item_ops_s
{
    int (*init) (skin_head_t*, skin_item_t*);
    int (*deinit) (skin_item_t*);

    int (*on_create) (skin_item_t*);
    int (*on_destroy) (skin_item_t*);

    void (*draw_bg) (HDC, skin_item_t*);
    void (*draw_attached) (HDC, skin_item_t*);

    DWORD (*get_value) (skin_item_t *item);
    DWORD (*set_value) (skin_item_t *item, DWORD status);
    
    int (*item_msg_proc) (skin_item_t* item, int message, 
                    WPARAM wparam, LPARAM lparam);
};

typedef struct sie_slider_s
{
    int min_pos;
    int max_pos;
    int cur_pos;
} sie_slider_t;

typedef struct si_nrmlabel_s
{
    char* label;        

    DWORD color;        
    DWORD color_focus;  
    DWORD color_click;  
    int font_index;
} si_nrmlabel_t;

typedef struct si_bmplabel_s
{
    char* label;
    const char* label_chars;
} si_bmplabel_t;

typedef struct si_nrmslider_s
{
    sie_slider_t    slider_info;

    int thumb_bmp_index;
} si_nrmslider_t;

#ifdef _FIXED_MATH

typedef struct si_rotslider_s
{
    int radius;
    int start_deg;
    int end_deg;
    int cur_pos;

    int thumb_bmp_index;
} si_rotslider_t;

#endif /* _FIXED_MATH */

#define SIE_BUTTON_CLICKED      0x00000001

#define SIE_SLIDER_CHANGED      0x00000002

#define SIE_GAIN_FOCUS          0x00010000

#define SIE_LOST_FOCUS          0x00020000

typedef int (* skin_event_cb_t) (HWND hwnd, skin_item_t* item, 
                int event, void* data);
#define MSG_CB_GOON     0

#define MSG_CB_DEF_GOON 1

#define MSG_CB_STOP     2

typedef int (* skin_msg_cb_t) (HWND hwnd, int message, 
                WPARAM wparam, LPARAM lparam, int* result);

#define SKIN_STYLE_NONE     0x00000000

#define SKIN_STYLE_TOOLTIP  0x00000001

#define SKIN_STYLE_MODAL    0x00000002

struct skin_head_s
{
    char* name;

    DWORD style;

    const BITMAP* bmps;
    const LOGFONT* fonts;

    int bk_bmp_index;

    int nr_items;
    skin_item_t* items;

    DWORD attached;

    /******** start of internal fields ********/

    /* The event callback function of the skin. */
    skin_event_cb_t event_cb;

    /* The window message procedure of the skin window. */
    skin_msg_cb_t msg_cb;

    /**** The fields initialized when skin_init called. ****/
    /* The rectangle heap for hit-test regions. */
    BLOCKHEAP rc_heap;

    /**** 
     * The fields initialized when create_skin_main_window or 
     * create_skin_control called.
     ****/
    /* The handle of window in which the skin locates. */
    HWND hwnd;
    /* The handle of tool tip window. */
    HWND tool_tip;

    /* The old x and y. */
    int oldx, oldy;
    /* The current hilighted item. */
    skin_item_t* hilighted;

    /* cached identifier. */
    int cached_id;
    /* the item whose identifier is cached_id. */
    skin_item_t* cached_item;
};

MGEXT_EXPORT BOOL skin_init (skin_head_t* skin, 
                skin_event_cb_t event_cb, skin_msg_cb_t msg_cb);

MGEXT_EXPORT void skin_deinit (skin_head_t* skin);

MGEXT_EXPORT HWND create_skin_main_window_ex (skin_head_t* skin, HWND hosting, 
                int x, int y, int w, int h, DWORD dwExStyle, BOOL modal);
#define create_skin_main_window(skin, hosting, x, y, w, h, modal) \
                create_skin_main_window_ex (skin, hosting, x, y, w, h, 0, modal);

MGEXT_EXPORT HWND create_skin_control (skin_head_t* skin, HWND parent, 
                int id, int x, int y, int w, int h);

MGEXT_EXPORT BOOL is_skin_main_window (HWND hwnd);

MGEXT_EXPORT void destroy_skin_window (HWND hwnd);

MGEXT_EXPORT skin_head_t* set_window_skin (HWND hwnd, skin_head_t *new_skin);

MGEXT_EXPORT skin_head_t* get_window_skin (HWND hwnd);

static inline skin_event_cb_t skin_set_event_cb (skin_head_t* skin, 
                skin_event_cb_t event_cb)
{
    skin_event_cb_t old = skin->event_cb;
    skin->event_cb = event_cb;
    return old;
}

static inline skin_msg_cb_t skin_set_msg_cb (skin_head_t* skin, 
                skin_msg_cb_t msg_cb)
{
    skin_msg_cb_t old = skin->msg_cb;
    skin->msg_cb = msg_cb;
    return old;
}

MGEXT_EXPORT skin_item_t* skin_get_item (skin_head_t* skin, int id);

MGEXT_EXPORT DWORD skin_get_item_status (skin_head_t* skin, int id);

MGEXT_EXPORT skin_item_t* skin_get_hilited_item (skin_head_t* skin);

MGEXT_EXPORT DWORD skin_show_item (skin_head_t* skin, int id, BOOL show);

MGEXT_EXPORT DWORD skin_enable_item (skin_head_t* skin, int id, BOOL enable);

MGEXT_EXPORT skin_item_t* skin_set_hilited_item (skin_head_t* skin, int id);

MGEXT_EXPORT BOOL skin_get_check_status (skin_head_t* skin, int id);

MGEXT_EXPORT DWORD skin_set_check_status (skin_head_t* skin, 
                int id, BOOL check);

MGEXT_EXPORT const char* skin_get_item_label (skin_head_t* skin, int id);

MGEXT_EXPORT BOOL skin_set_item_label (skin_head_t* skin, 
                int id, const char* label);

MGEXT_EXPORT HWND skin_get_control_hwnd (skin_head_t* skin, int id);

MGEXT_EXPORT int skin_get_thumb_pos (skin_head_t* skin, int id);

MGEXT_EXPORT BOOL skin_set_thumb_pos (skin_head_t* skin, int id, int pos);

MGEXT_EXPORT BOOL skin_get_slider_info (skin_head_t* skin, 
                int id, sie_slider_t* sie);

MGEXT_EXPORT BOOL skin_set_slider_info (skin_head_t* skin, 
                int id, const sie_slider_t* sie);

MGEXT_EXPORT int skin_scale_slider_pos (const sie_slider_t* org, 
                int new_min, int new_max);

#ifdef __cplusplus
}
#endif  /* __cplusplus */

#endif /* _EXT_SKIN */

#endif /* _MGUI_SKIN_H */

---