treelist.h

Go to the documentation of this file.

/*
 * Copyright (c) 2013 Martin Mitas
 *
 * This library is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 2.1 of the License, or
 * (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#ifndef MCTRL_TREELIST_H
#define MCTRL_TREELIST_H

#include <mCtrl/_defs.h>
#include <mCtrl/_common.h>

#ifdef __cplusplus
extern "C" {
#endif



BOOL MCTRL_API mcTreeList_Initialize(void);

void MCTRL_API mcTreeList_Terminate(void);


#define MC_WC_TREELISTW           L"mCtrl.treelist"

#define MC_WC_TREELISTA            "mCtrl.treelist"


#define MC_TLS_HASBUTTONS           0x0001

#define MC_TLS_HASLINES             0x0002

#define MC_TLS_LINESATROOT          0x0004

#define MC_TLS_GRIDLINES            0x0008

#define MC_TLS_SHOWSELALWAYS        0x0010

#define MC_TLS_FULLROWSELECT        0x0020

#define MC_TLS_NONEVENHEIGHT        0x0040

#define MC_TLS_DOUBLEBUFFER         0x0080

#define MC_TLS_NOCOLUMNHEADER       0x0100

#define MC_TLS_HEADERDRAGDROP       0x0200

#define MC_TLS_SINGLEEXPAND         0x0400

#define MC_TLS_MULTISELECT          0x0800

#define MC_TLS_NOTOOLTIPS           0x1000

#if 0 /* TODO */
#define MC_TLS_CHECKBOXES           0x2000
#define MC_TLS_EDITLABELS           0x4000
#define MC_TLS_EDITSUBLABELS        0x8000
#endif


#define MC_TLCF_FORMAT          (1 << 0)

#define MC_TLCF_WIDTH           (1 << 1)

#define MC_TLCF_TEXT            (1 << 2)

#define MC_TLCF_IMAGE           (1 << 3)

#define MC_TLCF_ORDER           (1 << 4)


#define MC_TLFMT_LEFT             0x0

#define MC_TLFMT_RIGHT            0x1

#define MC_TLFMT_CENTER           0x2

#define MC_TLFMT_JUSTIFYMASK      0x3


#define MC_TLI_ROOT  ((MC_HTREELISTITEM)(ULONG_PTR) -0x10000)

#define MC_TLI_FIRST ((MC_HTREELISTITEM)(ULONG_PTR) -0xffff)

#define MC_TLI_LAST  ((MC_HTREELISTITEM)(ULONG_PTR) -0xfffe)


#define MC_TLIF_STATE                (1 << 0)

#define MC_TLIF_TEXT                 (1 << 1)

#define MC_TLIF_PARAM                (1 << 2)

#define MC_TLIF_LPARAM               (1 << 2)

#define MC_TLIF_IMAGE                (1 << 3)

#define MC_TLIF_SELECTEDIMAGE        (1 << 4)

#define MC_TLIF_EXPANDEDIMAGE        (1 << 5)

#define MC_TLIF_CHILDREN             (1 << 6)


#define MC_TLIS_SELECTED             (1 << 1)

#define MC_TLIS_EXPANDED             (1 << 5)




#define MC_TLSIF_TEXT                (1 << 1)


#define MC_TLHT_NOWHERE              (1 << 0)

#define MC_TLHT_ONITEMICON           (1 << 1)

#define MC_TLHT_ONITEMSTATEICON      (1 << 2)

#define MC_TLHT_ONITEMLABEL          (1 << 3)

#define MC_TLHT_ONITEM               (MC_TLHT_ONITEMICON | MC_TLHT_ONITEMSTATEICON | MC_TLHT_ONITEMLABEL)

#define MC_TLHT_ONITEMINDENT         (1 << 4)

#define MC_TLHT_ONITEMBUTTON         (1 << 5)

#define MC_TLHT_ONITEMRIGHT          (1 << 6)

#define MC_TLHT_ONITEMLEFT           (1 << 7)

#define MC_TLHT_ABOVE                (1 << 8)

#define MC_TLHT_BELOW                (1 << 9)

#define MC_TLHT_TORIGHT              (1 << 10)

#define MC_TLHT_TOLEFT               (1 << 11)


#define MC_TLE_COLLAPSE              0x1

#define MC_TLE_EXPAND                0x2

#define MC_TLE_TOGGLE                0x3

#define MC_TLE_COLLAPSERESET         0x8000


#define MC_TLGN_ROOT                 0x0

#define MC_TLGN_NEXT                 0x1

#define MC_TLGN_PREVIOUS             0x2

#define MC_TLGN_PARENT               0x3

#define MC_TLGN_CHILD                0x4

#define MC_TLGN_FIRSTVISIBLE         0x5

#define MC_TLGN_NEXTVISIBLE          0x6

#define MC_TLGN_PREVIOUSVISIBLE      0x7

#define MC_TLGN_CARET                0x9

#define MC_TLGN_LASTVISIBLE          0xa


#define MC_TLIR_BOUNDS               0

#define MC_TLIR_ICON                 1

#define MC_TLIR_LABEL                2

#define MC_TLIR_SELECTBOUNDS         3


typedef struct MC_TLCOLUMNW_tag {
    UINT fMask;
    int fmt;
    int cx;
    WCHAR* pszText;
    int cchTextMax;
    int iImage;
    int iOrder;
} MC_TLCOLUMNW;

typedef struct MC_TLCOLUMNA_tag {
    UINT fMask;
    int fmt;
    int cx;
    char* pszText;
    int cchTextMax;
    int iImage;
    int iOrder;
} MC_TLCOLUMNA;

typedef void* MC_HTREELISTITEM;


typedef struct MC_TLITEMW_tag {
    UINT fMask;
    UINT state;
    UINT stateMask;
    WCHAR* pszText;
    int cchTextMax;
    LPARAM lParam;
    int iImage;
    int iSelectedImage;
    int iExpandedImage;
    int cChildren;
} MC_TLITEMW;

typedef struct MC_TLITEMA_tag {
    UINT fMask;
    UINT state;
    UINT stateMask;
    char* pszText;
    int cchTextMax;
    LPARAM lParam;
    int iImage;
    int iSelectedImage;
    int iExpandedImage;
    int cChildren;
} MC_TLITEMA;

typedef struct MC_TLSUBITEMW_tag {
    UINT fMask;
    int iSubItem;
    WCHAR* pszText;
    int cchTextMax;
} MC_TLSUBITEMW;

typedef struct MC_TLSUBITEMA_tag {
    UINT fMask;
    int iSubItem;
    char* pszText;
    int cchTextMax;
} MC_TLSUBITEMA;

typedef struct MC_TLINSERTSTRUCTW_tag {
    MC_HTREELISTITEM hParent;
    MC_HTREELISTITEM hInsertAfter;
    MC_TLITEMW item;
} MC_TLINSERTSTRUCTW;

typedef struct MC_TLINSERTSTRUCTA_tag {
    MC_HTREELISTITEM hParent;
    MC_HTREELISTITEM hInsertAfter;
    MC_TLITEMA item;
} MC_TLINSERTSTRUCTA;

typedef struct MC_TLHITTESTINFO_tag {
    POINT pt;
    UINT flags;
    MC_HTREELISTITEM hItem;
    int iSubItem;
} MC_TLHITTESTINFO;

typedef struct MC_NMTREELIST_tag {
    NMHDR hdr;
    UINT action;
    MC_HTREELISTITEM hItemOld;
    LPARAM lParamOld;
    MC_HTREELISTITEM hItemNew;
    LPARAM lParamNew;
} MC_NMTREELIST;

typedef struct MC_NMTLCUSTOMDRAW_tag {
    MC_NMCUSTOMDRAW nmcd;
    int iLevel;
    int iSubItem;
    COLORREF clrText;
    COLORREF clrTextBk;
} MC_NMTLCUSTOMDRAW;

typedef struct MC_NMTLDISPINFOW_tag {
    NMHDR hdr;
    MC_HTREELISTITEM hItem;
    MC_TLITEMW item;
} MC_NMTLDISPINFOW;

typedef struct MC_NMTLDISPINFOA_tag {
    NMHDR hdr;
    MC_HTREELISTITEM hItem;
    MC_TLITEMA item;
} MC_NMTLDISPINFOA;

typedef struct MC_NMTLSUBDISPINFOW_tag {
    NMHDR hdr;
    MC_HTREELISTITEM hItem;
    LPARAM lItemParam;
    MC_TLSUBITEMW subitem;
} MC_NMTLSUBDISPINFOW;

typedef struct MC_NMTLSUBDISPINFOA_tag {
    NMHDR hdr;
    MC_HTREELISTITEM hItem;
    LPARAM lItemParam;
    MC_TLSUBITEMA subitem;
} MC_NMTLSUBDISPINFOA;


#define MC_TLM_INSERTCOLUMNW         (MC_TLM_FIRST + 0)

#define MC_TLM_INSERTCOLUMNA         (MC_TLM_FIRST + 1)

#define MC_TLM_SETCOLUMNW            (MC_TLM_FIRST + 2)

#define MC_TLM_SETCOLUMNA            (MC_TLM_FIRST + 3)

#define MC_TLM_GETCOLUMNW            (MC_TLM_FIRST + 4)

#define MC_TLM_GETCOLUMNA            (MC_TLM_FIRST + 5)

#define MC_TLM_DELETECOLUMN          (MC_TLM_FIRST + 6)

#define MC_TLM_SETCOLUMNORDERARRAY   (MC_TLM_FIRST + 7)

#define MC_TLM_GETCOLUMNORDERARRAY   (MC_TLM_FIRST + 8)

#define MC_TLM_SETCOLUMNWIDTH        (MC_TLM_FIRST + 9)

#define MC_TLM_GETCOLUMNWIDTH        (MC_TLM_FIRST + 10)

#define MC_TLM_INSERTITEMW           (MC_TLM_FIRST + 11)

#define MC_TLM_INSERTITEMA           (MC_TLM_FIRST + 12)

#define MC_TLM_SETITEMW              (MC_TLM_FIRST + 13)

#define MC_TLM_SETITEMA              (MC_TLM_FIRST + 14)

#define MC_TLM_GETITEMW              (MC_TLM_FIRST + 15)

#define MC_TLM_GETITEMA              (MC_TLM_FIRST + 16)

#define MC_TLM_DELETEITEM            (MC_TLM_FIRST + 17)

#define MC_TLM_SETITEMHEIGHT         (MC_TLM_FIRST + 18)

#define MC_TLM_GETITEMHEIGHT         (MC_TLM_FIRST + 19)

#define MC_TLM_SETSUBITEMW           (MC_TLM_FIRST + 20)

#define MC_TLM_SETSUBITEMA           (MC_TLM_FIRST + 21)

#define MC_TLM_GETSUBITEMW           (MC_TLM_FIRST + 22)

#define MC_TLM_GETSUBITEMA           (MC_TLM_FIRST + 23)

#define MC_TLM_SETINDENT             (MC_TLM_FIRST + 24)

#define MC_TLM_GETINDENT             (MC_TLM_FIRST + 25)

#define MC_TLM_HITTEST               (MC_TLM_FIRST + 26)

#define MC_TLM_EXPAND                (MC_TLM_FIRST + 27)

#define MC_TLM_GETNEXTITEM           (MC_TLM_FIRST + 28)

#define MC_TLM_GETVISIBLECOUNT       (MC_TLM_FIRST + 29)

#define MC_TLM_ENSUREVISIBLE         (MC_TLM_FIRST + 30)

#define MC_TLM_SETIMAGELIST          (MC_TLM_FIRST + 31)

#define MC_TLM_GETIMAGELIST          (MC_TLM_FIRST + 32)

#define MC_TLM_GETSELECTEDCOUNT     (MC_TLM_FIRST + 33)

#define MC_TLM_GETITEMRECT          (MC_TLM_FIRST + 34)

#define MC_TLM_GETSUBITEMRECT       (MC_TLM_FIRST + 35)

/*
 * @brief Associate a tooltip window with the control.
 * @param[in] wParam (@c HWND) Handle of the tooltip window.
 * @param lParam Reserved, set to zero.
 * @return (@c HWND) Handle of previous tooltip window or @c NULL if no tooltip
 * was associated with the control.
 * @sa MC_TLS_NOTOOLTIPS
 */
#define MC_TLM_SETTOOLTIPS          (MC_TLM_FIRST + 36)

#define MC_TLM_GETTOOLTIPS          (MC_TLM_FIRST + 37)


#define MC_TLN_DELETEITEM            (MC_TLN_FIRST + 0)

#define MC_TLN_SELCHANGING           (MC_TLN_FIRST + 1)

#define MC_TLN_SELCHANGED            (MC_TLN_FIRST + 2)

#define MC_TLN_EXPANDING             (MC_TLN_FIRST + 3)

#define MC_TLN_EXPANDED              (MC_TLN_FIRST + 4)

#if 0
#define MC_TLN_SETDISPINFOW          (MC_TLN_FIRST + 5)
#define MC_TLN_SETDISPINFOA          (MC_TLN_FIRST + 6)
#endif

#define MC_TLN_GETDISPINFOW          (MC_TLN_FIRST + 7)

#define MC_TLN_GETDISPINFOA          (MC_TLN_FIRST + 8)

#if 0
#define MC_TLN_SETSUBDISPINFOW       (MC_TLN_FIRST + 9)
#define MC_TLN_SETSUBDISPINFOA       (MC_TLN_FIRST + 10)
#endif

#define MC_TLN_GETSUBDISPINFOW       (MC_TLN_FIRST + 11)

#define MC_TLN_GETSUBDISPINFOA       (MC_TLN_FIRST + 12)


#define MC_WC_TREELIST           MCTRL_NAME_AW(MC_WC_TREELIST)

#define MC_TLCOLUMN              MCTRL_NAME_AW(MC_TLCOLUMN)

#define MC_TLITEM                MCTRL_NAME_AW(MC_TLITEM)

#define MC_TLSUBITEM             MCTRL_NAME_AW(MC_TLSUBITEM)

#define MC_TLINSERTSTRUCT        MCTRL_NAME_AW(MC_TLINSERTSTRUCT)

#define MC_NMTLDISPINFO          MCTRL_NAME_AW(MC_NMTLDISPINFO)

#define MC_NMTLSUBDISPINFO       MCTRL_NAME_AW(MC_NMTLSUBDISPINFO)

#define MC_TLM_SETCOLUMN         MCTRL_NAME_AW(MC_TLM_SETCOLUMN)

#define MC_TLM_INSERTCOLUMN      MCTRL_NAME_AW(MC_TLM_INSERTCOLUMN)

#define MC_TLM_SETCOLUMN         MCTRL_NAME_AW(MC_TLM_SETCOLUMN)

#define MC_TLM_GETCOLUMN         MCTRL_NAME_AW(MC_TLM_GETCOLUMN)

#define MC_TLM_INSERTITEM        MCTRL_NAME_AW(MC_TLM_INSERTITEM)

#define MC_TLM_SETITEM           MCTRL_NAME_AW(MC_TLM_SETITEM)

#define MC_TLM_GETITEM           MCTRL_NAME_AW(MC_TLM_GETITEM)

#define MC_TLM_SETSUBITEM        MCTRL_NAME_AW(MC_TLM_SETSUBITEM)

#define MC_TLM_GETSUBITEM        MCTRL_NAME_AW(MC_TLM_GETSUBITEM)

#define MC_TLN_SETDISPINFO       MCTRL_NAME_AW(MC_TLN_SETDISPINFO)

#define MC_TLN_GETDISPINFO       MCTRL_NAME_AW(MC_TLN_GETDISPINFO)

#define MC_TLN_SETSUBDISPINFO    MCTRL_NAME_AW(MC_TLN_SETSUBDISPINFO)

#define MC_TLN_GETSUBDISPINFO    MCTRL_NAME_AW(MC_TLN_GETSUBDISPINFO)

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

#endif  /* MCTRL_TREELIST_H */