267 lines
12 KiB
C
267 lines
12 KiB
C
#ifndef NULLOSFT_MEDIALIBRARY_NAVIGATION_HEADER
|
|
#define NULLOSFT_MEDIALIBRARY_NAVIGATION_HEADER
|
|
|
|
#if defined(_MSC_VER) && (_MSC_VER >= 1020)
|
|
#pragma once
|
|
#endif
|
|
|
|
#include <windows.h>
|
|
#include "./config.h"
|
|
#include "./ml_imagelist.h"
|
|
|
|
typedef LPVOID HNAVCTRL;
|
|
typedef LPVOID HNAVITEM;
|
|
|
|
typedef struct _NAVITEM_I
|
|
{
|
|
UINT mask;
|
|
INT id;
|
|
LPWSTR pszText;
|
|
INT cchTextMax;
|
|
LPWSTR pszInvariant;
|
|
INT cchInvariantMax;
|
|
INT iImage;
|
|
INT iSelectedImage;
|
|
UINT state;
|
|
UINT stateMask;
|
|
UINT style;
|
|
UINT styleMask;
|
|
HFONT hFont;
|
|
LPARAM lParam;
|
|
} NAVITEM_I;
|
|
|
|
typedef struct _NAVITEMDRAW_I
|
|
{
|
|
HDC hdc; //
|
|
COLORREF clrText; //
|
|
COLORREF clrTextBk; //
|
|
HFONT hFont; //
|
|
RECT *prc; //
|
|
UINT itemState; // NIS_XXX
|
|
UINT drawStage; // NIDS_XXX
|
|
INT iLevel; // Zero-based level of the item being drawn.
|
|
} NAVITEMDRAW_I;
|
|
|
|
|
|
// navigation control styles
|
|
#define NCS_NORMAL_I 0x0000
|
|
#define NCS_FULLROWSELECT_I 0x0001
|
|
#define NCS_SHOWICONS_I 0x0002
|
|
|
|
// nav item draw stage
|
|
#define NIDS_PREPAINT_I 0x0001
|
|
#define NIDS_POSTPAINT_I 0x0002
|
|
|
|
// item custom draw callback return values
|
|
#define NICDRF_DODEFAULT_I 0x0001
|
|
#define NICDRF_SKIPDEFAULT_I 0x0002
|
|
#define NICDRF_NOTIFYPOSTPAINT_I 0x0004
|
|
#define NICDRF_NEWFONT_I 0x0008
|
|
|
|
|
|
// hit test flags
|
|
#define NAVHT_NOWHERE_I 0x0001
|
|
#define NAVHT_ONITEM_I 0x0002
|
|
#define NAVHT_ONITEMBUTTON_I 0x0004 // only if item currently has children
|
|
#define NAVHT_ONITEMINDENT_I 0x0010
|
|
#define NAVHT_ONITEMRIGHT_I 0x0020
|
|
#define NAVHT_ABOVE_I 0x0100
|
|
#define NAVHT_BELOW_I 0x0200
|
|
#define NAVHT_TORIGHT_I 0x0400
|
|
#define NAVHT_TOLEFT_I 0x0800
|
|
|
|
// navigation item masks
|
|
#define NIMF_ITEMID_I 0x0001
|
|
#define NIMF_TEXT_I 0x0002
|
|
#define NIMF_TEXTINVARIANT_I 0x0004
|
|
#define NIMF_IMAGE_I 0x0008
|
|
#define NIMF_IMAGESEL_I 0x0010
|
|
#define NIMF_STATE_I 0x0020
|
|
#define NIMF_STYLE_I 0x0040
|
|
#define NIMF_FONT_I 0x0080
|
|
#define NIMF_PARAM_I 0x0100
|
|
|
|
// states
|
|
#define NIS_NORMAL_I 0x0000
|
|
#define NIS_SELECTED_I 0x0001
|
|
#define NIS_EXPANDED_I 0x0002
|
|
#define NIS_DROPHILITED_I 0x0004
|
|
#define NIS_FOCUSED_I 0x0008 // used with draw item
|
|
|
|
// styles
|
|
#define NIS_HASCHILDREN_I 0x0001 // item has children
|
|
#define NIS_ALLOWCHILDMOVE_I 0x0002 // allow children to be moved (re-ordered)
|
|
#define NIS_ALLOWEDIT_I 0x0004 // allow title edit
|
|
#define NIS_ITALIC_I 0x0100 // when displaying item text draw it with italic style
|
|
#define NIS_BOLD_I 0x0200 // when displaying item text draw it with bold style
|
|
#define NIS_UNDERLINE_I 0x0400 // when displaying item text draw it with underline style
|
|
#define NIS_CUSTOMDRAW_I 0x0010 // custom draw calback
|
|
#define NIS_WANTSETCURSOR_I 0x0020 // item want to recive set cursor notification
|
|
#define NIS_WANTHITTEST_I 0x0040 // item want to monitor/modify hittest results
|
|
/// internal style - do not use
|
|
#define NIS_WANTPOSTPAINT_I 0x8000 // custom draw calback
|
|
|
|
|
|
// image types
|
|
#define IMAGE_NORMAL_I 0x0000
|
|
#define IMAGE_SELECTED_I 0x0001
|
|
|
|
// item expand command flags
|
|
#define NAVITEM_TOGGLE_I 0x0000
|
|
#define NAVITEM_EXPAND_I 0x0001
|
|
#define NAVITEM_COLLAPSE_I 0x0002
|
|
|
|
// action codes
|
|
#define ACTION_CLICKL_I 0x0000
|
|
#define ACTION_CLICKR_I 0x0001
|
|
#define ACTION_ENTER_I 0x0002
|
|
#define ACTION_DBLCLICKL_I 0x0003
|
|
#define ACTION_DBLCLICKR_I 0x0004
|
|
|
|
// navigation callbacks ident
|
|
#define CALLBACK_ONCLICK_I 0x0001
|
|
#define CALLBACK_ONSELECTED_I 0x0002
|
|
#define CALLBACK_ONKEYDOWN_I 0x0003
|
|
#define CALLBACK_ONBEGINDRAG_I 0x0004
|
|
#define CALLBACK_ONGETIMAGEINDEX_I 0x0005
|
|
#define CALLBACK_ONBEGINTITLEEDIT_I 0x0006
|
|
#define CALLBACK_ONENDTITLEEDIT_I 0x0007
|
|
#define CALLBACK_ONITEMDELETE_I 0x0008
|
|
#define CALLBACK_ONITEMDRAW_I 0x0009
|
|
#define CALLBACK_ONSETCURSOR_I 0x000A
|
|
#define CALLBACK_ONHITTEST_I 0x000B
|
|
#define CALLBACK_ONDESTROY_I 0x000C
|
|
|
|
typedef BOOL (CALLBACK *ONNAVITEMCLICK_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/, INT /*actionId*/); // return TRUE if you want to prevent further processing
|
|
typedef void (CALLBACK *ONNAVITEMSELECTED_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItemOld*/, HNAVITEM /*hItemNew*/);
|
|
typedef BOOL (CALLBACK *ONNAVCTRLKEYDOWN_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/, NMTVKEYDOWN* /*ptvkd*/);
|
|
typedef void (CALLBACK *ONNAVCTRLBEGINDRAG_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/, POINT /*pt*/);
|
|
typedef INT (CALLBACK *ONNAVITEMGETIMAGEINDEX_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/, INT /*imageType*/); // if item image index == -1 you can provide some some other index
|
|
typedef BOOL (CALLBACK *ONNAVITEMBEGINTITLEEDIT_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/); // return TRUE to allow edit
|
|
typedef BOOL (CALLBACK *ONNAVCTRLENDTITLEEDIT_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/, LPCWSTR /*pszNewTitle*/); // if pszNewTitle == NULL edit wa canceled. Return TRUE to accept new title
|
|
typedef void (CALLBACK *ONNAVITEMDELETE_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/); //
|
|
typedef UINT (CALLBACK *ONNAVITEMDRAW_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/, NAVITEMDRAW_I* /*pnicd*/, LPARAM /*lParam*/); // custom draw
|
|
typedef BOOL (CALLBACK *ONNAVITEMSETCURSOR_I)(HNAVCTRL /*hNav*/, HNAVITEM /*hItem*/, LPARAM /*lParam*/); // set cursor
|
|
typedef void (CALLBACK *ONNAVITEMHITTEST_I)(HNAVCTRL /*hNav*/, POINT /*pt*/, UINT* /*pFlags*/, HNAVITEM* /*phItem*/, LPARAM /*lParam*/);
|
|
typedef void (CALLBACK *ONNAVCTRLDESTROY_I)(HNAVCTRL /*hNav*/);
|
|
|
|
// name compare flags
|
|
#define NICF_DISPLAY_I 0x0001 // compare display name (if specified in combination with othe flags will be used last)
|
|
#define NICF_INVARIANT_I 0x0002 // compare invariant name (if specified in combination with other flags will be used after FULL and before DISPLAY
|
|
#define NICF_IGNORECASE_I 0x0004 // ignore case (always used when comparing invariant names)
|
|
|
|
// NavItemI_SetOrder flags
|
|
#define NOF_MOVEONEBEFORE_I 0x00 // if order inded already used set order for this item and move old item on one position after until all items rearranged
|
|
#define NOF_MOVEONEAFTER_I 0x01 //
|
|
#define NOF_MOVEBEFORE_I 0x02 //
|
|
#define NOF_MOVEAFTER_I 0x03 //
|
|
|
|
// NavCtrlI_EnumItems callback
|
|
typedef BOOL (CALLBACK *NAVENUMPROC_I)(HNAVITEM /*hItem*/, LPARAM /*lParam*/); // return FALSE to stop enumeration
|
|
|
|
// Use this to in NavCtrlI_InertItem to create hInsertAfter
|
|
#define MAKE_NAVITEMSORTORDER(o) ((HNAVITEM)((ULONG_PTR)((WORD)(o))))
|
|
#define IS_NAVITEMSORTORDER(_i) ((((ULONG_PTR)(_i)) >> 16) == 0)
|
|
|
|
#define NUF_LOCK_NONE_I 0x00
|
|
#define NUF_LOCK_SELECTED_I 0x01 // try to remember selected position if no selected items in the view it will fallback to NUF_REMEMBER_TOP_I
|
|
#define NUF_LOCK_TOP_I 0x02 // try to remeber top item...
|
|
|
|
// insert item Insert after flags
|
|
#define NCI_FIRST_I ((HNAVITEM)(ULONG_PTR)-0x0FFFF) // insert first item
|
|
#define NCI_LAST_I ((HNAVITEM)(ULONG_PTR)-0x00000) // insert as last item
|
|
|
|
// Navigation Control
|
|
|
|
// NavCtrlI_Create - create new navigation manager
|
|
HNAVCTRL NavCtrlI_Create(HWND hwndParent);
|
|
BOOL NavCtrlI_SetRect(HNAVCTRL hNav, RECT *prc);
|
|
BOOL NavCtrlI_Show(HNAVCTRL hNav, INT nCmdShow);
|
|
BOOL NavCtrlI_Enable(HNAVCTRL hNav, BOOL fEnable);
|
|
BOOL NavCtrlI_Destroy(HNAVCTRL hNav);
|
|
BOOL NavCtrlI_Update(HNAVCTRL hNav); // calls UpdateWindow for the host;
|
|
BOOL NavCtrlI_ProcessNotifications(HNAVCTRL hNav, LPNMHDR pnmh, LRESULT *pResult);
|
|
C_Config *NavCtrlI_SetConfig(HNAVCTRL hNav, C_Config *pConfig);
|
|
|
|
BOOL NavCtrlI_BeginUpdate(HNAVCTRL hNav, UINT fRememberPos); // call to prevent redraw (use NUF_REMEMBER_XXX)
|
|
BOOL NavCtrlI_EndUpdate(HNAVCTRL hNav); // call to allow redraw
|
|
|
|
BOOL NavCtrlI_DeleteItem(HNAVCTRL hNav, HNAVITEM hItem);
|
|
BOOL NavCtrlI_DeleteAll(HNAVCTRL hNav);
|
|
HNAVITEM NavCtrlI_FindItem(HNAVCTRL hNav, INT itemId);
|
|
HNAVITEM NavCtrlI_FindItemByName(HNAVCTRL hNav, LCID Locale, UINT compFlags, LPCWSTR pszName, INT cchLength); // use one of the NICF_* flags
|
|
HNAVITEM NavCtrlI_FindItemByFullName(HNAVCTRL hNav, LCID Locale, UINT compFlags, LPCWSTR pszName, INT cchLength, BOOL fAncestorOk); // use one of the NICF_* flags. if fAncestor is set and item with this name not exist - will fall back to closest ancestor
|
|
|
|
HNAVITEM NavCtrlI_InsertItem(HNAVCTRL hNav, HNAVITEM hInsertAfter, HNAVITEM hParent, NAVITEM_I *pnis); // if hInsertAfter > 0xFFFF it is consider as an item otherwise it is sort order, Use MAKE_NAVITEMSORTORDER macro
|
|
HNAVITEM NavCtrlI_GetRoot(HNAVCTRL hNav);
|
|
HNAVITEM NavCtrlI_GetSelection(HNAVCTRL hNav);
|
|
HNAVITEM NavCtrlI_GetFirstVisible(HNAVCTRL hNav);
|
|
HNAVITEM NavCtrlI_GetLastVisible(HNAVCTRL hNav);
|
|
BOOL NavCtrlI_UpdateLook(HNAVCTRL hNav);
|
|
|
|
HMLIMGLST NavCtrlI_SetImageList(HNAVCTRL hNav, HMLIMGLST hmlil);
|
|
HMLIMGLST NavCtrlI_GetImageList(HNAVCTRL hNav);
|
|
|
|
HWND NavCtrlI_GetHWND(HNAVCTRL hNav);
|
|
LPVOID NavCtrlI_RegisterCallback(HNAVCTRL hNav, LPVOID fnCallback, INT cbType);
|
|
HNAVITEM NavCtrlI_HitTest(HNAVCTRL hNav, POINT *ppt, UINT *pFlags);
|
|
BOOL NavCtrlI_SetInsertMark(HNAVCTRL hNav, HNAVITEM hItem, BOOL fAfter);
|
|
|
|
BOOL NavCtrlI_EnumItems(HNAVCTRL hNav, NAVENUMPROC_I pEnumFunc, HNAVITEM hItemStart, LPARAM lParam);
|
|
INT NavCtrlI_MapPointsTo(HNAVCTRL hNav, HWND hwndTo, POINT *ppt, UINT cPoints);
|
|
INT NavCtrlI_MapPointsFrom(HNAVCTRL hNav, HWND hwndFrom, POINT *ppt, UINT cPoints);
|
|
|
|
BOOL NavCtrlI_EndEditTitle(HNAVCTRL hNav, BOOL fCancel);
|
|
INT NavCtrlI_GetIndent(HNAVCTRL hNav);
|
|
DWORD NavCtrlI_GetStyle(HNAVCTRL hNav); // NCS_XXX
|
|
|
|
// Navigation Item
|
|
|
|
BOOL NavItemI_EditTitle(HNAVITEM hItem);
|
|
HNAVITEM NavItemI_GetChild(HNAVITEM hItem);
|
|
INT NavItemI_GetChildrenCount(HNAVITEM hItem);
|
|
HFONT NavItemI_GetFont(HNAVITEM hItem);
|
|
INT NavItemI_GetId(HNAVITEM hItem);
|
|
INT NavItemI_GetImageIndex(HNAVITEM hItem, INT imageType);
|
|
BOOL NavItemI_GetIndirect(HNAVITEM hItem, NAVITEM_I *pnis);
|
|
BOOL NavItemI_GetText(HNAVITEM hItem, LPWSTR pszText, INT cchMaxLen);
|
|
BOOL NavItemI_GetInvariantText(HNAVITEM hItem, LPWSTR pszText, INT cchMaxLen);
|
|
HNAVITEM NavItemI_GetNext(HNAVITEM hItem);
|
|
WORD NavItemI_GetOrder(HNAVITEM hItem);
|
|
HNAVITEM NavItemI_GetParent(HNAVITEM hItem);
|
|
HNAVITEM NavItemI_GetPrevious(HNAVITEM hItem);
|
|
BOOL NavItemI_GetRect(HNAVITEM hItem, RECT *prc, BOOL fItemRect);
|
|
HNAVITEM NavItemI_GetRoot(HNAVITEM hItem);
|
|
UINT NavItemI_GetState(HNAVITEM hItem, UINT stateMask);
|
|
UINT NavItemI_GetStyle(HNAVITEM hItem, UINT styleMask);
|
|
INT NavItemI_GetFullName(HNAVITEM hItem, LPWSTR pszFullName, INT cchMaxLen);
|
|
|
|
|
|
BOOL NavItemI_HasChildren(HNAVITEM hItem); // checks if item style for NIS_HASCHILDREN_I
|
|
BOOL NavItemI_HasChildrenReal(HNAVITEM hItem); // cheks if item actually has at least one child
|
|
BOOL NavItemI_IsSelected(HNAVITEM hItem);
|
|
BOOL NavItemI_IsExpanded(HNAVITEM hItem);
|
|
BOOL NavItemI_Expand(HNAVITEM hItem, UINT flag);
|
|
BOOL NavItemI_Move(HNAVITEM hItem, HNAVITEM hItemDest, BOOL fAfter);
|
|
HFONT NavItemI_SetFont(HNAVITEM hItem, HFONT hFont); // you stil own this font !!! (set hFont to NULL if you want to use treeview font). Returns previously set font.
|
|
BOOL NavItemI_SetId(HNAVITEM hItem, INT itemId);
|
|
BOOL NavItemI_SetImageIndex(HNAVITEM hItem, INT mlilIndex, INT imageType);
|
|
BOOL NavItemI_SetIndirect(HNAVITEM hItem, NAVITEM_I *pnis);
|
|
BOOL NavItemI_SetState(HNAVITEM hItem, UINT state, UINT stateMask);
|
|
BOOL NavItemI_SetStyle(HNAVITEM hItem, UINT style, UINT mask);
|
|
BOOL NavItemI_SetText(HNAVITEM hItem, LPCWSTR pszText);
|
|
BOOL NavItemI_SetInvariantText(HNAVITEM hItem, LPCWSTR pszText);
|
|
|
|
|
|
// Sets Item order and modifies all items oreder after it if required.
|
|
// if oder == 0xFFFF order will be set to max + 1 for this group
|
|
// returns new item order or 0xFFFF if error;
|
|
// minimal order value 1.
|
|
// flags one of the NOF_XXX
|
|
WORD NavItemI_SetOrder(HNAVITEM hItem, WORD order, UINT flags);
|
|
BOOL NavItemI_EnsureVisible(HNAVITEM hItem);
|
|
BOOL NavItemI_Select(HNAVITEM hItem);
|
|
HIMAGELIST NavItemI_CreateDragImage(HNAVITEM hItem, LPCWSTR pszTipText);
|
|
BOOL NavItemI_Invalidate(HNAVITEM hItem, RECT *prc, BOOL fErase);
|
|
|
|
#endif //NULLOSFT_MEDIALIBRARY_NAVIGATION_HEADER
|