mitemview.h

Go to the documentation of this file.

//
//                          IMPORTANT NOTICE
//
// The following open source license statement does not apply to any
// entity in the Exception List published by FMSoft.
//
// For more information, please visit:
//
// https://www.fmsoft.cn/exception-list
//

#ifndef _MGUI_CTRL_ITEMVIEW_H
#define _MGUI_CTRL_ITEMVIEW_H

#ifdef __cplusplus
extern "C" {
#endif  /* __cplusplus */

#define NCSCTRL_ITEMVIEW   NCSCLASSNAME("itemview")

typedef struct _mItemView mItemView;
typedef struct _mItemViewClass mItemViewClass;
typedef struct _mItemViewRenderer mItemViewRenderer;

typedef int  (*NCS_CB_INITITEM)(mItemView *self, HITEM hItem);

typedef void (*NCS_CB_DSTRITEM)(mItemView *self, HITEM hItem);

typedef void (*NCS_CB_DRAWITEM)(mItemView *self, HITEM hItem, HDC hdc, RECT *rcDraw);

typedef struct _NCS_CB_ITEMOPS
{
    NCS_CB_INITITEM     initItem; 
    NCS_CB_DSTRITEM  destroyItem;
    NCS_CB_DRAWITEM     drawItem;  
} NCS_CB_ITEMOPS;

#define NCSS_ITEMV_AUTOSORT    (0x0002<<NCSS_SWGT_SHIFT)

#define NCSS_ITEMV_LOOP        (0x0004<<NCSS_SWGT_SHIFT)

#define NCSS_ITEMV_SINGLE      (0x0000<<NCSS_SWGT_SHIFT)

#define NCSS_ITEMV_MULTIPLE    (0x0008<<NCSS_SWGT_SHIFT)

#define NCSS_ITEMV_SHIFT   (NCSS_SWGT_SHIFT+4)

#define pItemList (self->itemList)

#define mItemViewHeader(className)  \
        mScrollWidgetHeader(className)  \
    NCS_CB_ITEMOPS   itemOps;        \
    mItemManager    *itemList;      \
    int             defItemHeight;

struct _mItemView
{
        mItemViewHeader(mItemView)
};

#define mItemViewClassHeader(clsName, parentClass)                          \
        mScrollWidgetClassHeader(clsName, parentClass)                          \
        int (*onRButtonDown)(clsName*, int x, int y, DWORD keyFlags);           \
        int (*onRButtonUp)(clsName*, int x, int y, DWORD keyFlags);             \
        int (*onLButtonDBClk)(clsName*, int x, int y, DWORD keyFlags);          \
    NCS_CB_DRAWITEM (*setItemDraw)(clsName*, NCS_CB_DRAWITEM func);         \
    NCS_CB_INITITEM (*setItemInit)(clsName*, NCS_CB_INITITEM func);         \
    NCS_CB_DSTRITEM (*setItemDestroy)(clsName*,                             \
            NCS_CB_DSTRITEM func);                                          \
    \
    NCS_CB_CMPITEM (*setItemCmpFunc)(clsName*, NCS_CB_CMPITEM func);        \
    HWND (*createItem)(clsName*, HITEM prev, HITEM next, int index,         \
            int height, const char* text, DWORD addData, int *pos, BOOL adjust);              \
    int (*insertItem)(clsName*, HITEM hItem, HITEM prev, HITEM next,        \
            int index, int *pos);                                           \
    int (*removeItem)(clsName*, HITEM hItem);                               \
    int (*inItem)(clsName*, int mouseX, int mouseY, HITEM *pRet, POINT *pt);\
    NCS_CB_CMPSTR (*setStrCmpFunc)(clsName*, NCS_CB_CMPSTR func);           \
    NCS_CB_CMPSTR (*getStrCmpFunc)(clsName*);                               \
    void (*setAutoSortItem)(clsName*, BOOL sort);                           \
    int (*getTotalHeight)(clsName*);                                        \
    int (*adjustItemsHeight)(clsName*, int diff);                           \
    void (*freeze)(clsName*, BOOL lock);                                    \
    BOOL (*isFrozen)(clsName*);                                             \
    list_t* (*getQueue)(clsName*);                                          \
    HITEM (*getListEntry)(clsName*, list_t* entry);                         \
    HITEM (*getFirstItem)(clsName*);                                        \
    int (*isEmpty)(clsName*);                                               \
    void (*sortItems)(clsName*, NCS_CB_CMPITEM func);                       \
    BOOL (*removeAll)(clsName*);                                            \
    int (*indexOf)(clsName*, HITEM hItem);                                  \
    int (*setItemHeight)(clsName*, HITEM hItem, int height);                \
    int (*getItemHeight)(clsName*, HITEM hItem);                            \
    HITEM (*getNext)(clsName*, HITEM hItem);                                \
    HITEM (*getPrev)(clsName*, HITEM hItem);                                \
    HITEM (*getItem)(clsName*, int index);                                  \
    BOOL (*isSelected)(clsName*, HITEM hItem);                              \
    BOOL (*isEnabled)(clsName*, HITEM hItem);                               \
    BOOL (*enable)(clsName*, HITEM hItem, BOOL enable);                     \
    void (*selectAll)(clsName*);                                            \
    void (*deselectAll)(clsName*);                                          \
    int (*hilight)(clsName*, HITEM hItem);                                  \
    HITEM (*getHilight)(clsName*);                                          \
    BOOL (*isHilight)(clsName*, HITEM hItem);                               \
    int (*getItemCount)(clsName*);                                          \
    DWORD (*getAddData)(clsName*, HITEM hItem);                             \
    void (*setAddData)(clsName*, HITEM hItem, DWORD addData);               \
    void (*setImage)(clsName*, HITEM hItem, DWORD image);                   \
    DWORD (*getImage)(clsName*, HITEM hItem);                               \
    void (*setFlags)(clsName*, HITEM hItem, DWORD flags);                   \
    DWORD (*getFlags)(clsName*, HITEM hItem);                               \
    BOOL (*setText)(clsName*, HITEM hItem, const char* text);               \
    const char* (*getText)(clsName*, HITEM hItem);                          \
    int (*getTextLen)(clsName*, HITEM hItem);                               \
    int (*getSelectionCount)(clsName*);                                     \
    BOOL (*getSelection)(clsName*, HITEM *pRet, int count);                 \
    \
    BOOL (*select)(clsName*, HITEM hItem);                                  \
    BOOL (*deselect)(clsName*, HITEM hItem);                                \
    BOOL (*setTextByIdx)(clsName*, int index, const char* text);            \
    const char* (*getTextByIdx)(clsName*, int index);                       \
    \
    int (*getFirstVisItem)(clsName*);                                       \
    void (*resetContent)(clsName*);                                         \
    int (*getRect)(clsName*, HITEM hItem, RECT *rcItem, BOOL bConv);        \
    int (*getCurSel)(clsName*);                                             \
    int (*setCurSel)(clsName*, int newSel);                                 \
    void (*refreshItem)(clsName*, HITEM hItem, const RECT *rcInv);          \
    BOOL (*showItemByIdx)(clsName*, int index);             \
    BOOL (*showItem)(clsName*, HITEM hItem);  

struct _mItemViewClass
{
        mItemViewClassHeader(mItemView, mScrollWidget)
};

#define mItemViewRendererHeader(clsName, parentClass) \
        mScrollWidgetRendererHeader(clsName, parentClass)

struct  _mItemViewRenderer {
        mItemViewRendererHeader(mItemView, mScrollWidget)
};

MGNCS_EXPORT extern mItemViewClass g_stmItemViewCls;

enum mItemViewProp
{
        NCSP_ITEMV_DEFITEMHEIGHT = NCSP_SWGT_MAX + 1,

    NCSP_ITEMV_ITEMCOUNT,
    NCSP_ITEMV_MAX,
};

enum mItemViewNotify {
    NCSN_ITEMV_CLICKED = NCSN_WIDGET_CLICKED,

    NCSN_ITEMV_SELCHANGING = NCSN_SWGT_MAX + 1,

    NCSN_ITEMV_SELCHANGED,

    NCSN_ITEMV_ENTER,

    NCSN_ITEMV_SETFOCUS,

    NCSN_ITEMV_KILLFOCUS,

    NCSN_ITEMV_MAX
};

#ifdef __cplusplus
}
#endif  /* __cplusplus */

#endif /* _MGUI_CTRL_ITEMVIEW_H */