/*****************************************************************************\ * * * commctrl.h - - Interface for the Windows Common Controls * * * * Version 1.0 * * * * Copyright (c) 1991-1994, Microsoft Corp. All rights reserved. * * * \*****************************************************************************/ /*REVIEW: this stuff needs Windows style in many places; find all REVIEWs. */ #ifndef _INC_COMMCTRL #define _INC_COMMCTRL #ifdef WIN32 #define _huge #endif #ifdef __cplusplus extern "C" { #endif /* Users of this header may define any number of these constants to avoid * the definitions of each functional group. * NOTOOLBAR Customizable bitmap-button toolbar control. * NOUPDOWN Up and Down arrow increment/decrement control. * NOSTATUSBAR Status bar and header bar controls. * NOMENUHELP APIs to help manage menus, especially with a status bar. * NOTRACKBAR Customizable column-width tracking control. * NODRAGLIST APIs to make a listbox source and sink drag&drop actions. * NOPROGRESS Progress gas gauge. * NOHOTKEY HotKey control */ /*/////////////////////////////////////////////////////////////////////////*/ /* InitCommonControls: * Any application requiring the use of any common control should call this * API upon application startup. There is no required shutdown. */ void WINAPI InitCommonControls(); // Define Ownerdraw type for Header controls BUGBUG: should be in windows.h? #define ODT_HEADER 100 #define ODT_TAB 101 #define ODT_LISTVIEW 102 //====== Ranges for control message IDs // (making each control's messages unique makes validation and // debugging easier). // #define LVM_FIRST 0x1000 // ListView messages #define TV_FIRST 0x1100 // TreeView messages #define HDM_FIRST 0x1200 // Header messages //REVIEW: We need to add an "int cbHdr" field to NMHDR! LRESULT WINAPI SendNotify(HWND hwndTo, HWND hwndFrom, int code, NMHDR FAR* pnmhdr); /* LRESULT Cls_OnNotify(HWND hwnd, int idFrom, NMHDR FAR* pnmhdr); */ #define HANDLE_WM_NOTIFY(hwnd, wParam, lParam, fn) \ (fn)((hwnd), (int)(wParam), (NMHDR FAR*)(lParam)) #define FORWARD_WM_NOTIFY(hwnd, idFrom, pnmhdr, fn) \ (void)(fn)((hwnd), WM_NOTIFY, (WPARAM)(int)(id), (LPARAM)(NMHDR FAR*)(pnmhdr)) // Generic WM_NOTIFY notification codes #define NM_OUTOFMEMORY (NM_FIRST-1) #define NM_CLICK (NM_FIRST-2) #define NM_DBLCLK (NM_FIRST-3) #define NM_RETURN (NM_FIRST-4) #define NM_RCLICK (NM_FIRST-5) #define NM_RDBLCLK (NM_FIRST-6) #define NM_SETFOCUS (NM_FIRST-7) #define NM_KILLFOCUS (NM_FIRST-8) #define NM_STARTWAIT (NM_FIRST-9) #define NM_ENDWAIT (NM_FIRST-10) #define NM_BTNCLK (NM_FIRST-10) // WM_NOTIFY codes (NMHDR.code values) // these are not required to be in seperate ranges but that makes // validation and debugging easier #define NM_FIRST (0U- 0U) // generic to all controls #define NM_LAST (0U- 99U) #define LVN_FIRST (0U-100U) // listview #define LVN_LAST (0U-199U) #define HDN_FIRST (0U-300U) // header #define HDN_LAST (0U-399U) #define TVN_FIRST (0U-400U) // treeview #define TVN_LAST (0U-499U) #define TTN_FIRST (0U-520U) // tooltips #define TTN_LAST (0U-549U) #define TCN_FIRST (0U-550U) // tab control #define TCN_LAST (0U-600U) #define CDN_FIRST (0U-601U) // common dialog (new) #define CDN_LAST (0U-699U) #define TBN_FIRST (0U-700U) // toolbar #define TBN_LAST (0U-720U) //====== IMAGE APIS ================================================== #define CLR_NONE 0xFFFFFFFFL #define CLR_DEFAULT 0xFF000000L #define CLR_HILIGHT 0xFF000001L struct _IMAGELIST; typedef struct _IMAGELIST NEAR* HIMAGELIST; // fMask is TRUE to create a masked (two-bitmap) image list. // cInitial is initial size of bitmap, cGrow is size to increase by. HIMAGELIST WINAPI ImageList_Create(int cx, int cy, BOOL fMask, int cInitial, int cGrow); BOOL WINAPI ImageList_Destroy(HIMAGELIST himl); // loads one resource, figures out cy and cInitial from bmp, // and makes mask from a specified color (unless CLR_NONE given) HIMAGELIST WINAPI ImageList_LoadImage(HINSTANCE hi, LPCSTR lpbmp, int cx, int cGrow, COLORREF crMask, UINT uType, UINT uFlags); #define ImageList_LoadBitmap(hi, lpbmp, cx, cGrow, crMask) \ ImageList_LoadImage(hi, lpbmp, cx, cGrow, crMask, IMAGE_BITMAP, 0) // Number of images in list. int WINAPI ImageList_GetImageCount(HIMAGELIST himl); // Add, Remove, replace images. Add returns index of Added item, or -1 if error. int WINAPI ImageList_Add(HIMAGELIST himl, HBITMAP hbmImage, HBITMAP hbmMask); int WINAPI ImageList_AddMasked(HIMAGELIST himl, HBITMAP hbmImage, COLORREF crMask); BOOL WINAPI ImageList_Remove(HIMAGELIST himl, int i); BOOL WINAPI ImageList_Replace(HIMAGELIST himl, int i, HBITMAP hbmImage, HBITMAP hbmMask); // Add or replace given an icon handle. hicon is not saved; can be destroyed // after call. Add returns index of added item, else -1. int WINAPI ImageList_AddIcon(HIMAGELIST himl, HICON hicon); int WINAPI ImageList_ReplaceIcon(HIMAGELIST himl, int i, HICON hicon); HICON WINAPI ImageList_ExtractIcon(HINSTANCE hAppInst, HIMAGELIST himl, int i); int WINAPI ImageList_AddFromImageList(HIMAGELIST himlDest, HIMAGELIST himlSrc, int iSrc); #define ILD_NORMAL 0x0000 // use current bkcolor #define ILD_TRANSPARENT 0x0001 // force transparent icon style (override bk color) #define ILD_MASK 0x0010 // draw the mask #define ILD_BLEND 0x000E // blend #define ILD_BLEND25 0x0002 // blend 25% #define ILD_BLEND50 0x0004 // blend 50% #define ILD_BLEND75 0x0008 // blend 75% #define ILD_OVERLAYMASK 0x0F00 // use these as indexes into special items #define INDEXTOOVERLAYMASK(i) ((i) << 8) // #define ILD_SELECTED ILD_BLEND50 // draw as selected #define ILD_FOCUS ILD_BLEND25 // draw as focused (selection) // Draw item i into hdcDst at x, y. Flags define the drawing style. BOOL WINAPI ImageList_Draw(HIMAGELIST himl, int i, HDC hdcDst, int x, int y, UINT fStyle); // Draw item i into hdcDst at x, y. Flags define the drawing style. BOOL WINAPI ImageList_Draw2(HIMAGELIST himl, int i, HDC hdcDst, int x, int y, COLORREF rgb, UINT fStyle); // Get bounding rectangle of image in image bitmaps. BOOL WINAPI ImageList_GetImageRect(HIMAGELIST himl, int i, RECT FAR* prcImage); // Set & get background color for speedy drawing. Set to CLR_NONE for true // cursor-style AND/XOR transparency. COLORREF WINAPI ImageList_SetBkColor(HIMAGELIST himl, COLORREF clrBk); COLORREF WINAPI ImageList_GetBkColor(HIMAGELIST himl); // Set the image iImage as one of the special images for us in combine // drawing. to draw with these specify the index of this BOOL WINAPI ImageList_SetOverlayImage(HIMAGELIST himl, int iImage, int iOverlay); #ifdef WIN32 #ifdef _OBJBASE_H_ // Read and write an imagelist from/to an IStream. HIMAGELIST WINAPI ImageList_Read(LPSTREAM pstm); BOOL WINAPI ImageList_Write(HIMAGELIST himl, LPSTREAM pstm); #endif #endif typedef struct _IMAGEINFO { HBITMAP hbmImage; HBITMAP hbmMask; int cPlanes; int cBitsPerPixel; RECT rcImage; } IMAGEINFO; // Get information about an image for direct manipulation. rcImage is // part of hbmImage and hbmMask that make up the image. hbmMask is // NULL if not a masked imagelist. BOOL WINAPI ImageList_GetImageInfo(HIMAGELIST himl, int i, IMAGEINFO FAR* pImageInfo); // Start tracking an image i, starting at x, y, offset by dx/dyHotspot. BOOL WINAPI ImageList_StartDrag(HIMAGELIST himl, HWND hwndLock, int i, int x, int y, int dxHotspot, int dyHotspot); // End a dragging operation. void WINAPI ImageList_EndDrag(); // Called on mouse move to move dragging image. BOOL WINAPI ImageList_DragMove(int x, int y); // Create new IMAGELIST that is the merge of two existing images. HIMAGELIST WINAPI ImageList_Merge(HIMAGELIST himl1, int i1, HIMAGELIST himl2, int i2, int dx, int dy); //================ HEADER APIS ============================================= // // Class name: SysHeader (WC_HEADER) // // The SysHeader control provides for column and row headers much like those // found in MSMail and Excel. Header items appear as text on a gray // background. Items can behave as pushbuttons, in which case they have a // raised face. // // SysHeaders support changing width or height of items using the mouse. // These controls do not support a keyboard interface, so they do not accept // the input focus. // // There are notifications that allow applications to determine when an item // has been clicked or double clicked, width change has occured, drag tracking // is occuring, etc. // ////////////////////////////////////////////////////////////////////////////// #ifdef WIN32 #define WC_HEADER "SysHeader32" #else #define WC_HEADER "SysHeader" #endif // Header control styles #define HDS_HORZ 0x00000000 // Horizontal header #define HDS_BUTTONS 0x00000002 // Items act as buttons #define HDS_HIDDEN 0x00000008 // no header in details mode // The HD_ITEM structure describes a header item. // The first field contains a combination of HDI_* flags // indicating which fields contain valid data. // typedef struct _HD_ITEM { UINT mask; int cxy; // width (HDS_HORZ) or height (HDS_VERT) LPSTR pszText; HBITMAP hbm; // Bitmap to use (implies HDF_BITMAP) int cchTextMax; // Valid only for GetItem: contains size of buffer int fmt; // HDF_* value LPARAM lParam; } HD_ITEM; // HD_ITEM mask flags #define HDI_WIDTH 0x0001 #define HDI_HEIGHT HDI_WIDTH #define HDI_TEXT 0x0002 #define HDI_FORMAT 0x0004 #define HDI_LPARAM 0x0008 #define HDI_BITMAP 0x0010 // HD_ITEM fmt field values // First justification values #define HDF_LEFT 0 #define HDF_RIGHT 1 #define HDF_CENTER 2 #define HDF_JUSTIFYMASK 0x0003 // Now other formating options #define HDF_OWNERDRAW 0x8000 #define HDF_STRING 0x4000 #define HDF_BITMAP 0x2000 // Returns number of items in header. // // int Header_GetItemCount(HWND hwndHD); // #define HDM_GETITEMCOUNT (HDM_FIRST + 0) #define Header_GetItemCount(hwndHD) \ (int)SendMessage((hwndHD), HDM_GETITEMCOUNT, 0, 0L) // Insert header item at specified index. Item is inserted at end if // i is greater than or equal to the number of items in the header. // Returns the index of the inserted item. // // int Header_InsertItem(HWND hwndHD, int i, const HD_ITEM FAR* pitem); // #define HDM_INSERTITEM (HDM_FIRST + 1) #define Header_InsertItem(hwndHD, i, phdi) \ (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), (LPARAM)(const HD_ITEM FAR*)(phdi)) // Delete a header item at the specified index. // // BOOL Header_DeleteItem(HWND hwndHD, int i); // #define HDM_DELETEITEM (HDM_FIRST + 2) #define Header_DeleteItem(hwndHD, i) \ (BOOL)SendMessage((hwndHD), HDM_DELETEITEM, (WPARAM)(int)(i), 0L) // Get header item at index i. The mask field of the pointed-to // HD_ITEM structure indicates which fields will be set by this // function; other fields are not changed. // // The cchTextMax field of *pitem contains the maximum // length of the returned string. // // BOOL Header_GetItem(HWND hwndHD, int i, HD_ITEM FAR* phdi); // #define HDM_GETITEM (HDM_FIRST + 3) #define Header_GetItem(hwndHD, i, phdi) \ (BOOL)SendMessage((hwndHD), HDM_GETITEM, (WPARAM)(int)(i), (LPARAM)(HD_ITEM FAR*)(phdi)) // Set header item at index i. The mask field of the pointed-to // HD_ITEM structure indicates which header item attributes will // be changed by this call; other fields of *pitem that do not // correspond to pitem->mask are ignored. // // The cchTextMax of *pitem is ignored. // // BOOL Header_SetItem(HWND hwndHD, int i, const HD_ITEM FAR* phdi); // #define HDM_SETITEM (HDM_FIRST + 4) #define Header_SetItem(hwndHD, i, phdi) \ (BOOL)SendMessage((hwndHD), HDM_SETITEM, (WPARAM)(int)(i), (LPARAM)(const HD_ITEM FAR*)(phdi)) // Calculate size and position of header within a rectangle. // Results are returned in a WINDOWPOS structure you supply, // and the layout rectangle is adjusted to exclude the leftover area. // typedef struct _HD_LAYOUT { RECT FAR* prc; WINDOWPOS FAR* pwpos; } HD_LAYOUT; // BOOL Header_Layout(HWND hwndHD, HD_LAYOUT FAR* playout); // #define HDM_LAYOUT (HDM_FIRST + 5) #define Header_Layout(hwndHD, playout) \ (BOOL)SendMessage((hwndHD), HDM_LAYOUT, 0, (LPARAM)(HD_LAYOUT FAR*)(playout)) #define HHT_NOWHERE 0x0001 #define HHT_ONHEADER 0x0002 #define HHT_ONDIVIDER 0x0004 #define HHT_ONDIVOPEN 0x0008 #define HHT_ABOVE 0x0100 #define HHT_BELOW 0x0200 #define HHT_TORIGHT 0x0400 #define HHT_TOLEFT 0x0800 typedef struct _HD_HITTESTINFO { POINT pt; // in: client coords UINT flags; // out: HHT_ flags int iItem; // out: item } HD_HITTESTINFO; #define HDM_HITTEST (HDM_FIRST + 6) // Header Notifications // // All header notifications are via the WM_NOTIFY message. // lParam of WM_NOTIFY points to a HD_NOTIFY structure for // all of the following notifications. // *pitem contains item being changed. pitem->mask indicates // which fields are valid (others have indeterminate state) // #define HDN_ITEMCHANGING (HDN_FIRST-0) #define HDN_ITEMCHANGED (HDN_FIRST-1) // Item has been clicked or doubleclicked (HDS_BUTTONS only) // iButton contains button id: 0=left, 1=right, 2=middle. // #define HDN_ITEMCLICK (HDN_FIRST-2) #define HDN_ITEMDBLCLICK (HDN_FIRST-3) // Divider area has been clicked or doubleclicked (HDS_DIVIDERTRACK only) // iButton contains button id: 0=left, 1=right, 2=middle. // #define HDN_DIVIDERDBLCLICK (HDN_FIRST-5) // Begin/end divider tracking (HDS_DIVIDERTRACK only) // Return TRUE from HDN_BEGINTRACK notification to prevent tracking. // #define HDN_BEGINTRACK (HDN_FIRST-6) #define HDN_ENDTRACK (HDN_FIRST-7) // HDN_DRAG: cxy field contains new height/width, which may be < 0. // Changing this value will affect the tracked height/width (allowing // for gridding, pinning, etc). // // Return TRUE to cancel tracking. // #define HDN_TRACK (HDN_FIRST-8) typedef struct _HD_NOTIFY { NMHDR hdr; int iItem; int iButton; // *CLICK notifications: 0=left, 1=right, 2=middle HD_ITEM FAR* pitem; // May be NULL } HD_NOTIFY; #ifndef NOTOOLBAR #ifdef WIN32 #define TOOLBARCLASSNAME "ToolbarWindow32" #else #define TOOLBARCLASSNAME "ToolbarWindow" #endif typedef struct _TBBUTTON { int iBitmap; /* index into bitmap of this button's picture */ int idCommand; /* WM_COMMAND menu ID that this button sends */ BYTE fsState; /* button's state */ BYTE fsStyle; /* button's style */ DWORD dwData; /* app defined data */ int iString; /* index into string list */ } TBBUTTON, NEAR* PTBBUTTON, FAR* LPTBBUTTON; typedef const TBBUTTON FAR* LPCTBBUTTON; typedef struct _COLORMAP { COLORREF from; COLORREF to; } COLORMAP, FAR* LPCOLORMAP; HWND WINAPI CreateToolbarEx(HWND hwnd, DWORD ws, UINT wID, int nBitmaps, HINSTANCE hBMInst, UINT wBMID, LPCTBBUTTON lpButtons, int iNumButtons, int dxButton, int dyButton, int dxBitmap, int dyBitmap, UINT uStructSize); HBITMAP WINAPI CreateMappedBitmap(HINSTANCE hInstance, int idBitmap, UINT wFlags, LPCOLORMAP lpColorMap, int iNumMaps); #define CMB_MASKED 0x02 /* create image/mask pair in bitmap */ /*REVIEW: TBSTATE_* should be TBF_* (for Flags) */ #define TBSTATE_CHECKED 0x01 /* radio button is checked */ #define TBSTATE_PRESSED 0x02 /* button is being depressed (any style) */ #define TBSTATE_ENABLED 0x04 /* button is enabled */ #define TBSTATE_HIDDEN 0x08 /* button is hidden */ #define TBSTATE_INDETERMINATE 0x10 /* button is indeterminate */ #define TBSTATE_WRAP 0x20 /* there is a line break after this button */ /* (needs to be endabled, too) */ #define TBSTYLE_BUTTON 0x00 /* this entry is button */ #define TBSTYLE_SEP 0x01 /* this entry is a separator */ #define TBSTYLE_CHECK 0x02 /* this is a check button (it stays down) */ #define TBSTYLE_GROUP 0x04 /* this is a check button (it stays down) */ #define TBSTYLE_CHECKGROUP (TBSTYLE_GROUP | TBSTYLE_CHECK) /* this group is a member of a group radio group */ /* TOOLBAR window styles (not button, not trackbar) */ #define TBSTYLE_TOOLTIPS 0x0100 /* make/use a tooltips control */ #define TBSTYLE_WRAPABLE 0x0200 /* wrappable */ #define TB_ENABLEBUTTON (WM_USER + 1) #define TB_CHECKBUTTON (WM_USER + 2) #define TB_PRESSBUTTON (WM_USER + 3) #define TB_HIDEBUTTON (WM_USER + 4) #define TB_INDETERMINATE (WM_USER + 5) #define TB_ISBUTTONENABLED (WM_USER + 9) #define TB_ISBUTTONCHECKED (WM_USER + 10) #define TB_ISBUTTONPRESSED (WM_USER + 11) #define TB_ISBUTTONHIDDEN (WM_USER + 12) #define TB_ISBUTTONINDETERMINATE (WM_USER + 13) #define TB_SETSTATE (WM_USER + 17) #define TB_GETSTATE (WM_USER + 18) #define TB_ADDBITMAP (WM_USER + 19) #ifdef WIN32 typedef struct { HINSTANCE hInst; // module handle or NULL, or -1 UINT nID; // if hInst == NULL, HBITMAP, else ID } TBADDBITMAP, *LPTBADDBITMAP; #define HINST_COMMCTRL ((HINSTANCE)-1) #define IDB_STD_SMALL_COLOR 0 #define IDB_STD_LARGE_COLOR 1 #define IDB_VIEW_SMALL_COLOR 4 #define IDB_VIEW_LARGE_COLOR 5 #endif #define TB_ADDBUTTONS (WM_USER + 20) #define TB_INSERTBUTTON (WM_USER + 21) #define TB_DELETEBUTTON (WM_USER + 22) #define TB_GETBUTTON (WM_USER + 23) #define TB_BUTTONCOUNT (WM_USER + 24) #define TB_COMMANDTOINDEX (WM_USER + 25) #ifdef WIN32 typedef struct { HKEY hkr; LPCSTR pszSubKey; LPCSTR pszValueName; } TBSAVEPARAMS; // wParam: BOOL (TRUE -> save state, FALSE -> restore // lParam: pointer to TBSAVERESTOREPARAMS #endif #define TB_SAVERESTORE (WM_USER + 26) #define TB_CUSTOMIZE (WM_USER + 27) #define TB_ADDSTRING (WM_USER + 28) #define TB_GETITEMRECT (WM_USER + 29) #define TB_BUTTONSTRUCTSIZE (WM_USER + 30) #define TB_SETBUTTONSIZE (WM_USER + 31) #define TB_SETBITMAPSIZE (WM_USER + 32) #define TB_AUTOSIZE (WM_USER + 33) #define TB_SETBUTTONTYPE (WM_USER + 34) #define TB_GETTOOLTIPS (WM_USER + 35) #define TB_SETTOOLTIPS (WM_USER + 36) #define TB_SETPARENT (WM_USER + 37) #define TB_SETROWS (WM_USER + 39) #define TB_GETROWS (WM_USER + 40) #define TB_SETCMDID (WM_USER + 42) #ifdef WIN32 #define TBBF_LARGE 0x0001 // returns TBBF_ flags #define TB_GETBITMAPFLAGS (WM_USER + 41) #define TBN_GETBUTTONINFO (TBN_FIRST-0) #define TBN_BEGINDRAG (TBN_FIRST-1) #define TBN_ENDDRAG (TBN_FIRST-2) #define TBN_BEGINADJUST (TBN_FIRST-3) #define TBN_ENDADJUST (TBN_FIRST-4) #define TBN_RESET (TBN_FIRST-5) #define TBN_QUERYINSERT (TBN_FIRST-6) #define TBN_QUERYDELETE (TBN_FIRST-7) #define TBN_TOOLBARCHANGE (TBN_FIRST-8) #define TBN_CUSTHELP (TBN_FIRST-9) typedef struct { NMHDR hdr; int iItem; TBBUTTON tbButton; int cchText; LPSTR pszText; } TBNOTIFY, FAR *LPTBNOTIFY; #endif #endif /* NOTOOLBAR */ /*//////////////////////////////////////////////////////////////////////*/ #ifndef NOTOOLTIPS #ifdef WIN32 #define TOOLTIPS_CLASS "tooltips_class32" #else #define TOOLTIPS_CLASS "tooltips_class" #endif typedef struct { UINT cbSize; UINT uFlags; HWND hwnd; UINT uId; RECT rect; HINSTANCE hinst; LPSTR lpszText; } TOOLINFO, NEAR *PTOOLINFO, FAR *LPTOOLINFO; #define TTS_ALWAYSTIP 0x01 // check over inactive windows as well #define TTS_NOPREFIX 0x02 #define TTF_WIDISHWND 0x01 #define TTM_ACTIVATE (WM_USER + 1) // wparam = BOOL (true or false = activate or deactivate) #define TTM_SETDELAYTIME (WM_USER + 3) #define TTM_ADDTOOL (WM_USER + 4) #define TTM_DELTOOL (WM_USER + 5) #define TTM_NEWTOOLRECT (WM_USER + 6) #define TTM_RELAYEVENT (WM_USER + 7) // lParam has TOOLINFO with hwnd and wid. this gets filled in #define TTM_GETTOOLINFO (WM_USER + 8) // lParam has TOOLINFO #define TTM_SETTOOLINFO (WM_USER + 9) // returns true or false for found, not found. // fills in LPHITTESTINFO->ti #define TTM_HITTEST (WM_USER +10) #define TTM_GETTEXT (WM_USER +11) #define TTM_UPDATETIPTEXT (WM_USER +12) #define TTM_GETTOOLCOUNT (WM_USER +13) #define TTM_ENUMTOOLS (WM_USER +14) typedef struct _TT_HITTESTINFO { HWND hwnd; POINT pt; TOOLINFO ti; } TTHITTESTINFO, FAR * LPHITTESTINFO; // WM_NOTIFY message sent to parent window to get tooltip text // if TTF_QUERYFORTIP is set on any tips #define TTN_NEEDTEXT (TTN_FIRST - 0) // WM_NOTIFY structure sent if TTF_QUERYFORTIP is set // the host can // 1) fill in the szText, // 2) point lpszText to their own text // 3) put a resource id number in lpszText // and point hinst to the hinstance to load from typedef struct { NMHDR hdr; LPSTR lpszText; char szText[80]; HINSTANCE hinst; } TOOLTIPTEXT, FAR *LPTOOLTIPTEXT; #endif //NOTOOLTIPS /*/////////////////////////////////////////////////////////////////////////*/ #ifndef NOSTATUSBAR /*REVIEW: Here exists the only known documentation for status bars. */ // SBS_* styles need to not overlap with CCS_* values // want a size gripper on a status bar. this only applies if the // DrawFrameControl function is available. #define SBARS_SIZEGRIP 0x0100 /* DrawStatusText: * This is used if the app wants to draw status in its client rect, * instead of just creating a window. Note that this same function is * used internally in the status bar window's WM_PAINT message. * hDC is the DC to draw to. The font that is selected into hDC will * be used. The RECT lprc is the only portion of hDC that will be drawn * to: the outer edge of lprc will have the highlights (the area outside * of the highlights will not be drawn in the BUTTONFACE color: the app * must handle that). The area inside the highlights will be erased * properly when drawing the text. */ void WINAPI DrawStatusText(HDC hDC, LPRECT lprc, LPCSTR szText, UINT uFlags); HWND WINAPI CreateStatusWindow(LONG style, LPCSTR lpszText, HWND hwndParent, UINT wID); #ifdef WIN32 #define STATUSCLASSNAME "msctls_statusbar32" #else #define STATUSCLASSNAME "msctls_statusbar" #endif #define SB_SETTEXT (WM_USER+1) #define SB_GETTEXT (WM_USER+2) #define SB_GETTEXTLENGTH (WM_USER+3) /* Just like WM_?ETTEXT*, with wParam specifying the pane that is referenced * (at most 255). * Note that you can use the WM_* versions to reference the 0th pane (this * is useful if you want to treat a "default" status bar like a static text * control). * For SETTEXT, wParam is the pane or'ed with SBT_* style bits (defined below). * If the text is "normal" (not OWNERDRAW), then a single pane may have left, * center, and right justified text by separating the parts with a single tab, * plus if lParam is NULL, then the pane has no text. The pane will be * invalidated, but not draw until the next PAINT message. * For GETTEXT and GETTEXTLENGTH, the LOWORD of the return will be the length, * and the HIWORD will be the SBT_* style bits. */ #define SB_SETPARTS (WM_USER+4) /* wParam is the number of panes, and lParam points to an array of points * specifying the right hand side of each pane. A right hand side of -1 means * it goes all the way to the right side of the control minus the X border */ #define SB_SETBORDERS (WM_USER+5) /* lParam points to an array of 3 integers: X border, Y border, between pane * border. If any is less than 0, the default will be used for that one. */ #define SB_GETPARTS (WM_USER+6) /* lParam is a pointer to an array of integers that will get filled in with * the right hand side of each pane and wParam is the size (in integers) * of the lParam array (so we do not go off the end of it). * Returns the number of panes. */ #define SB_GETBORDERS (WM_USER+7) /* lParam is a pointer to an array of 3 integers that will get filled in with * the X border, the Y border, and the between pane border. */ #define SB_SETMINHEIGHT (WM_USER+8) /* wParam is the minimum height of the status bar "drawing" area. This is * the area inside the highlights. This is most useful if a pane is used * for an OWNERDRAW item, and is ignored if the SBS_NORESIZE flag is set. * Note that WM_SIZE (wParam=0, lParam=0L) must be sent to the control for * any size changes to take effect. */ #define SB_SIMPLE (WM_USER+9) /* wParam specifies whether to set (non-zero) or unset (zero) the "simple" * mode of the status bar. In simple mode, only one pane is displayed, and * its text is set with LOWORD(wParam)==255 in the SETTEXT message. * OWNERDRAW is not allowed, but other styles are. * The pane gets invalidated, but not painted until the next PAINT message, * so you can set new text without flicker (I hope). * This can be used with the WM_INITMENU and WM_MENUSELECT messages to * implement help text when scrolling through a menu. */ #define SB_GETRECT (WM_USER + 10) // wParam is the nth part // lparam is lprc // returns true if found a rect for wParam #define SBT_OWNERDRAW 0x1000 /* The lParam of the SB_SETTEXT message will be returned in the DRAWITEMSTRUCT * of the WM_DRAWITEM message. Note that the fields CtlType, itemAction, and * itemState of the DRAWITEMSTRUCT are undefined for a status bar. * The return value for GETTEXT will be the itemData. */ #define SBT_NOBORDERS 0x0100 /* No borders will be drawn for the pane. */ #define SBT_POPOUT 0x0200 /* The text pops out instead of in */ #define HBT_SPRING 0x0400 /* this means that the item is "springy", meaning that it has a minimum * width, but will grow if there is extra room in the window. Note that * multiple springs are allowed, and the extra room will be distributed * among them. */ #endif /* NOSTATUSBAR */ /*/////////////////////////////////////////////////////////////////////////*/ #ifndef NOMENUHELP void WINAPI MenuHelp(UINT uMsg, WPARAM wParam, LPARAM lParam, HMENU hMainMenu, HINSTANCE hInst, HWND hwndStatus, UINT FAR *lpwIDs); BOOL WINAPI ShowHideMenuCtl(HWND hWnd, UINT uFlags, LPINT lpInfo); void WINAPI GetEffectiveClientRect(HWND hWnd, LPRECT lprc, LPINT lpInfo); /*REVIEW: is this internal? */ #define MINSYSCOMMAND SC_SIZE #endif /* NOMENUHELP */ /*/////////////////////////////////////////////////////////////////////////*/ // slider control #ifndef NOTRACKBAR /* This control keeps its ranges in LONGs. but for convienence and symetry with scrollbars WORD parameters are are used for some messages. if you need a range in LONGs don't use any messages that pack values into loword/hiword pairs The trackbar messages: message wParam lParam return TBM_GETPOS ------ ------ Current logical position of trackbar. TBM_GETRANGEMIN ------ ------ Current logical minimum position allowed. TBM_GETRANGEMAX ------ ------ Current logical maximum position allowed. TBM_SETTIC TBM_SETPOS TBM_SETRANGEMIN TBM_SETRANGEMAX */ #ifdef WIN32 #define TRACKBAR_CLASS "msctls_trackbar32" #else #define TRACKBAR_CLASS "msctls_trackbar" #endif /* Trackbar styles */ /* add ticks automatically on TBM_SETRANGE message */ #define TBS_AUTOTICKS 0x0001 #define TBS_VERT 0x0002 /* vertical trackbar */ #define TBS_HORZ 0x0000 /* default */ #define TBS_TOP 0x0004 /* Ticks on top */ #define TBS_BOTTOM 0x0000 /* Ticks on bottom (default) */ #define TBS_LEFT 0x0004 /* Ticks on left */ #define TBS_RIGHT 0x0000 /* Ticks on right (default) */ #define TBS_BOTH 0x0008 /* Ticks on both side */ #define TBS_NOTICKS 0x0010 #define TBS_ENABLESELRANGE 0x0020 /* Trackbar messages */ /* returns current position (LONG) */ #define TBM_GETPOS (WM_USER) /* set the min of the range to LPARAM */ #define TBM_GETRANGEMIN (WM_USER+1) /* set the max of the range to LPARAM */ #define TBM_GETRANGEMAX (WM_USER+2) /* wParam is index of tick to get (ticks are in the range of min - max) */ #define TBM_GETTIC (WM_USER+3) /* wParam is index of tick to set */ #define TBM_SETTIC (WM_USER+4) /* set the position to the value of lParam (wParam is the redraw flag) */ #define TBM_SETPOS (WM_USER+5) /* LOWORD(lParam) = min, HIWORD(lParam) = max, wParam == fRepaint */ #define TBM_SETRANGE (WM_USER+6) /* lParam is range min (use this to keep LONG precision on range) */ #define TBM_SETRANGEMIN (WM_USER+7) /* lParam is range max (use this to keep LONG precision on range) */ #define TBM_SETRANGEMAX (WM_USER+8) /* remove the ticks */ #define TBM_CLEARTICS (WM_USER+9) /* select a range LOWORD(lParam) min, HIWORD(lParam) max */ #define TBM_SETSEL (WM_USER+10) /* set selection rang (LONG form) */ #define TBM_SETSELSTART (WM_USER+11) #define TBM_SETSELEND (WM_USER+12) // #define TBM_SETTICTOK (WM_USER+13) /* return a pointer to the list of tics (DWORDS) */ #define TBM_GETPTICS (WM_USER+14) /* get the pixel position of a given tick */ #define TBM_GETTICPOS (WM_USER+15) /* get the number of tics */ #define TBM_GETNUMTICS (WM_USER+16) /* get the selection range */ #define TBM_GETSELSTART (WM_USER+17) #define TBM_GETSELEND (WM_USER+18) /* clear the selection */ #define TBM_CLEARSEL (WM_USER+19) /* set tic frequency */ #define TBM_SETTICFREQ (WM_USER+20) /* Set/get the page size */ #define TBM_SETPAGESIZE (WM_USER+21) // lParam = lPageSize . Returns old pagesize #define TBM_GETPAGESIZE (WM_USER+22) /* Set/get the line size */ #define TBM_SETLINESIZE (WM_USER+23) #define TBM_GETLINESIZE (WM_USER+24) /* Get the thumb's and channel's rect size */ #define TBM_GETTHUMBRECT (WM_USER+25) // lParam = lprc . for return value #define TBM_GETCHANNELRECT (WM_USER+26) // lParam = lprc . for return value /*REVIEW: these match the SB_ (scroll bar messages); define them that way? */ #define TB_LINEUP 0 #define TB_LINEDOWN 1 #define TB_PAGEUP 2 #define TB_PAGEDOWN 3 #define TB_THUMBPOSITION 4 #define TB_THUMBTRACK 5 #define TB_TOP 6 #define TB_BOTTOM 7 #define TB_ENDTRACK 8 #endif /*/////////////////////////////////////////////////////////////////////////*/ #ifndef NODRAGLIST typedef struct { UINT uNotification; HWND hWnd; POINT ptCursor; } DRAGLISTINFO, FAR *LPDRAGLISTINFO; #define DL_BEGINDRAG (WM_USER+133) #define DL_DRAGGING (WM_USER+134) #define DL_DROPPED (WM_USER+135) #define DL_CANCELDRAG (WM_USER+136) #define DL_CURSORSET 0 #define DL_STOPCURSOR 1 #define DL_COPYCURSOR 2 #define DL_MOVECURSOR 3 #define DRAGLISTMSGSTRING "commctrl_DragListMsg" BOOL WINAPI MakeDragList(HWND hLB); void WINAPI DrawInsert(HWND handParent, HWND hLB, int nItem); int WINAPI LBItemFromPt(HWND hLB, POINT pt, BOOL bAutoScroll); #endif /* NODRAGLIST */ /*/////////////////////////////////////////////////////////////////////////*/ // spinner control #ifndef NOUPDOWN /* // OVERVIEW: // // The UpDown control is a simple pair of buttons which increment or // decrement an integer value. The operation is similar to a vertical // scrollbar; except that the control only has line-up and line-down // functionality, and changes the current position automatically. // // The control also can be linked with a companion control, usually an // "edit" control, to simplify dialog-box management. This companion is // termed a "buddy" in this documentation. Any sibling HWND may be // assigned as the control's buddy, or the control may be allowed to // choose one automatically. Once chosen, the UpDown can size itself to // match the buddy's right or left border, and/or automatically set the // text of the buddy control to make the current position visible. // // ADDITIONAL NOTES: // // The "upper" and "lower" limits must not cover a range larger than 32,767 // positions. It is acceptable to have the range inverted, i.e., to have // (lower > upper). The upper button always moves the current position // towards the "upper" number, and the lower button always moves towards the // "lower" number. If the range is zero (lower == upper), or the control // is disabled (EnableWindow(hCtrl, FALSE)), the control draws grayed // arrows in both buttons. The UDS_WRAP style makes the range cyclic; that // is, the numbers will wrap once one end of the range is reached. // // The buddy window must have the same parent as the UpDown control. // // If either of the UDS_ALIGN* styles are used, the updown control will // locate itself on the "inside" of the buddy by resizing the buddy // accordingly. so the original size of the buddy will now emcompass // both a slightly smaller buddy and the updown control. // // If the buddy window resizes, and the UDS_ALIGN* styles are used, it // is necessary to send the UDM_SETBUDDY message to re-anchor the UpDown // control on the appropriate border of the buddy window. // // The UDS_AUTOBUDDY style uses GetWindow(hCtrl, GW_HWNDPREV) to pick // the best buddy window. In the case of a DIALOG resource, this will // choose the previous control listed in the resource script. If the // windows will change in Z-order, sending UDM_SETBUDDY with a NULL handle // will pick a new buddy; otherwise the original auto-buddy choice is // maintained. // // The UDS_SETBUDDYINT style uses its own SetDlgItemInt-style // functionality to set the caption text of the buddy. All WIN.INI [Intl] // values are honored by this routine. // // The UDS_ARROWKEYS style will subclass the buddy window, in order to steal // the VK_UP and VK_DOWN arrow key messages. // // The UDS_HORZ sytle will draw the two buttons side by side with // left and right arrows instead of up and down arrows. It will also // send the WM_HSCROLL message instead // */ #ifdef WIN32 #define UPDOWN_CLASS "msctls_updown32" #else #define UPDOWN_CLASS "msctls_updown" #endif /* Structures */ typedef struct _UDACCEL { UINT nSec; UINT nInc; } UDACCEL, FAR *LPUDACCEL; #define UD_MAXVAL 0x7fff #define UD_MINVAL (-UD_MAXVAL) /* STYLE BITS */ #define UDS_WRAP 0x0001 #define UDS_SETBUDDYINT 0x0002 #define UDS_ALIGNRIGHT 0x0004 #define UDS_ALIGNLEFT 0x0008 #define UDS_AUTOBUDDY 0x0010 #define UDS_ARROWKEYS 0x0020 #define UDS_HORZ 0x0040 #define UDS_NOTHOUSANDS 0x0080 /* MESSAGES */ #define UDM_SETRANGE (WM_USER+101) /* wParam: not used, 0 // lParam: short LOWORD, new upper; short HIWORD, new lower limit // return: not used */ #define UDM_GETRANGE (WM_USER+102) /* wParam: not used, 0 // lParam: not used, 0 // return: short LOWORD, upper; short HIWORD, lower limit */ #define UDM_SETPOS (WM_USER+103) /* wParam: not used, 0 // lParam: short LOWORD, new pos; HIWORD not used, 0 // return: short LOWORD, old pos; HIWORD not used */ #define UDM_GETPOS (WM_USER+104) /* wParam: not used, 0 // lParam: not used, 0 // return: short LOWORD, current pos; HIWORD not used */ #define UDM_SETBUDDY (WM_USER+105) /* wParam: HWND, new buddy // lParam: not used, 0 // return: HWND LOWORD, old buddy; HIWORD not used */ #define UDM_GETBUDDY (WM_USER+106) /* wParam: not used, 0 // lParam: not used, 0 // return: HWND LOWORD, current buddy; HIWORD not used */ #define UDM_SETACCEL (WM_USER+107) /* wParam: UINT, number of acceleration steps // lParam: LPUDACCEL, pointer to array of UDACCEL elements // Elements should be sorted in increasing nSec order. // return: BOOL LOWORD, nonzero if successful; HIWORD not used */ #define UDM_GETACCEL (WM_USER+108) /* wParam: UINT, number of elements in the UDACCEL array // lParam: LPUDACCEL, pointer to UDACCEL buffer to receive array // return: UINT LOWORD, number of elements returned in buffer */ #define UDM_SETBASE (WM_USER+109) /* wParam: UINT, new radix base (10 for decimal, 16 for hex, etc.) // lParam: not used, 0 // return: not used */ #define UDM_GETBASE (WM_USER+110) /* wParam: not used, 0 // lParam: not used, 0 // return: UINT LOWORD, current radix base; HIWORD not used */ /* NOTIFICATIONS */ // This code is used when we send a WM_COMMAND to specific a // up/down control notification. // It will be received Before the WM_VSCROLL notification. #define UDM_DELTAPOS 1 // wParam: UpDown Control ID // lParam: HIWORD -> Notification code (UDM_DELTAPOS) // lParam: LOWORD -> Position change delta as a signed 16 bit int. /* WM_VSCROLL // Note that unlike a scrollbar, the position is automatically changed by // the control, and the LOWORD(lParam) is always the new position. Only // SB_THUMBTRACK and SB_THUMBPOSITION scroll codes are sent in the wParam. */ /* HELPER APIs */ HWND WINAPI CreateUpDownControl(DWORD dwStyle, int x, int y, int cx, int cy, HWND hParent, int nID, HINSTANCE hInst, HWND hBuddy, int nUpper, int nLower, int nPos); /* Does the CreateWindow call followed by setting the various // state information: // hBuddy The companion control (usually an "edit"). // nUpper The range limit corresponding to the upper button. // nLower The range limit corresponding to the lower button. // nPos The initial position. // Returns the handle to the control or NULL on failure. */ #endif /* NOUPDOWN */ /*/////////////////////////////////////////////////////////////////////////*/ // progress indicator #ifndef NOPROGRESS #ifdef WIN32 #define PROGRESS_CLASS "msctls_progress32" #else #define PROGRESS_CLASS "msctls_progress" #endif /* // OVERVIEW: // // The progress bar control is a "gas gauge" that can be used to show the // progress of a lengthy operation. // // The application sets the range and current position (similar to a // scrollbar) and has the ability to advance the current position in // a variety of ways. // // Text can be displayed in the progress bar as either a percentage // of the entire range (using the PBS_SHOWPERCENT style) or as the // value of the current position (using the PBS_SHOWPOS style). If // neither bit is set, no text is shown in the bar. // // When PBM_STEPIT is used to advance the current position, the gauge // will wrap when it reaches the end and start again at the start. // The position is clamped at either end in other cases. // */ /*/////////////////////////////////////////////////////////////////////////*/ /* STYLE BITS */ #define PBS_SHOWPERCENT 0x01 // BUGBUG: not implemented yet #define PBS_SHOWPOS 0x02 // BUGBUG: not implemented yet /* MESSAGES */ #define PBM_SETRANGE (WM_USER+1) /* wParam: not used, 0 // lParam: int LOWORD, bottom of range; int HIWORD top of range // return: int LOWORD, previous bottom; int HIWORD old top */ #define PBM_SETPOS (WM_USER+2) /* wParam: int new position // lParam: not used, 0 // return: int LOWORD, previous position; HIWORD not used */ #define PBM_DELTAPOS (WM_USER+3) /* wParam: int amount to advance current position // lParam: not used, 0 // return: int LOWORD, previous position; HIWORD not used */ #define PBM_SETSTEP (WM_USER+4) /* wParam: int new step // lParam: not used, 0 // return: int LOWORD, previous step; HIWORD not used */ #define PBM_STEPIT (WM_USER+5) /* advance current position by current step // wParam: not used 0 // lParam: not used, 0 // return: int LOWORD, previous position; HIWORD not used */ #endif /* NOPROGRESS */ #ifndef NOHOTKEY /* // OVERVIEW: k // // The hotkey control is designed as an edit control for hotkey // entry. the application supplies a set of control/alt/shift // combinations that are considered invalid and a default combination // to be used OR'd with an invalid combination. // // Hotkey values are returned as a pair of bytes, one for the // virtual key code of the key and the other specifying the // modifier combinations used with the key. // */ // possible modifiers #define HOTKEYF_SHIFT 0x01 #define HOTKEYF_CONTROL 0x02 #define HOTKEYF_ALT 0x04 #define HOTKEYF_EXT 0x08 // keyboard extended bit // possible modifier combinations (for defining invalid combos) #define HKCOMB_NONE 0x0001 // no modifiers #define HKCOMB_S 0x0002 // only shift #define HKCOMB_C 0x0004 // only control #define HKCOMB_A 0x0008 // only alt #define HKCOMB_SC 0x0010 // shift+control #define HKCOMB_SA 0x0020 // shift+alt #define HKCOMB_CA 0x0040 // control+alt #define HKCOMB_SCA 0x0080 // shift+control+alt // wHotkey: WORD lobyte, virtual key code // WORD hibyte, modifers (combination of HOTKEYF_). #define HKM_SETHOTKEY (WM_USER+1) /* wParam: wHotkey; // lParam: not used, 0 // return: not used */ #define HKM_GETHOTKEY (WM_USER+2) /* wParam: not used, 0 // lParam: not used, 0 // return: wHotkey; */ #define HKM_SETRULES (WM_USER+3) /* wParam: UINT, invalid modifier combinations (using HKCOMB_*) // lParam: UINT loword, default modifier combination (using HOTKEYF_*) // hiword not used // return: not used */ #ifdef WIN32 #define HOTKEY_CLASS "msctls_hotkey32" #else #define HOTKEY_CLASS "msctls_hotkey" #endif #endif /* NOHOTKEY */ /*/////////////////////////////////////////////////////////////////////////*/ /* Note that the following flags are checked every time the window gets a * WM_SIZE message, so the style of the window can be changed "on-the-fly". * If NORESIZE is set, then the app is responsible for all control placement * and sizing. If NOPARENTALIGN is set, then the app is responsible for * placement. If neither is set, the app just needs to send a WM_SIZE * message for the window to be positioned and sized correctly whenever the * parent window size changes. * Note that for STATUS bars, CCS_BOTTOM is the default, for HEADER bars, * CCS_NOMOVEY is the default, and for TOOL bars, CCS_TOP is the default. */ #define CCS_TOP 0x00000001L /* This flag means the status bar should be "top" aligned. If the * NOPARENTALIGN flag is set, then the control keeps the same top, left, and * width measurements, but the height is adjusted to the default, otherwise * the status bar is positioned at the top of the parent window such that * its client area is as wide as the parent window and its client origin is * the same as its parent. * Similarly, if this flag is not set, the control is bottom-aligned, either * with its original rect or its parent rect, depending on the NOPARENTALIGN * flag. */ #define CCS_NOMOVEY 0x00000002L /* This flag means the control may be resized and moved horizontally (if the * CCS_NORESIZE flag is not set), but it will not move vertically when a * WM_SIZE message comes through. */ #define CCS_BOTTOM 0x00000003L /* Same as CCS_TOP, only on the bottom. */ #define CCS_NORESIZE 0x00000004L /* This flag means that the size given when creating or resizing is exact, * and the control should not resize itself to the default height or width */ #define CCS_NOPARENTALIGN 0x00000008L /* This flag means that the control should not "snap" to the top or bottom * or the parent window, but should keep the same placement it was given */ #define CCS_NOHILITE 0x00000010L /* Don't draw the one pixel highlight at the top of the control */ #define CCS_ADJUSTABLE 0x00000020L /* This allows a toolbar (header bar?) to be configured by the user. */ #define CCS_NODIVIDER 0x00000040L /* Don't draw the 2 pixel highlight at top of control (toolbar) */ /*/////////////////////////////////////////////////////////////////////////*/ //================ LISTVIEW APIS =========================================== // // Class name: SysListView (WC_LISTVIEW) // // The SysListView control provides for a group of items which are displayed // as a name and/or an associated icon and associated sub-items, in one of // several organizations, depending on current style settings: // * The Icon Format (LVS_ICON) // The control arranges standard-sized icons on an invisible grid // with their text caption below the icon. The user can drag icons to // rearrange them freely, even overlapping each other. // * The Small Icon Format (LVS_SMALLICON) // The control arranges half-sized icons on an invisible columnar grid // like a multi-column owner-draw listbox, with the caption of each // item to the icon's right. The user can still rearrange items // freely to taste. Converting from LVS_ICON to LVS_SMALLICON and back // will attempt to preserve approximate relative positions of // repositioned items. // * The List Format (LVS_LIST) // The control enforces a multi-column list of small-icon items with // each item's caption to the right. No free rearranging is possible. // * The Report Format (LVS_REPORT) // The control enforces a single-column list of small-icon items with // each item's caption to the right, and further columns used for item- // specific sub-item text. The columns are capped with a SysHeader // bar (unless specified) which allows the user to change the relative // widths of each sub-item column. // // The icons and small-icons presented may be assigned as indices into // an ImageList of the appropriate size. These ImageLists (either custom // lists or copies of the system lists) are assigned to the control by the // owner at initialization time or at any later time. // // Text and icon values may be "late-bound," or assigned by a callback // routine as required by the control. For example, if it would be slow to // compute the correct icon or caption for an item, the item can be assigned // special values which indicate that they should be computed only as the // items become visible (say, for a long list of items being scrolled into // view). // // Each item has a state, which can be (nearly) any combination of the // following attributes, mostly managed automatically by the control: // * Selected (LVIS_SELECTED) // The item appears selected. The appearance of selected items // depends on whether the control has the focus, and the selection // system colors. // * Focused (LVIS_FOCUSED) // One item at a time may be focused. The item is surrounded with a // standard focus-rectangle. // * Marked (LVIS_CUT) // REVIEW: Call this "Checked"? // * Disabled (LVIS_DISABLED) // The item is drawn with the standard disabled style and coloring. // * Hidden (LVIS_HIDDEN) // The item is not visible nor does it respond to user interaction. // * Drop-Highlighted (LVIS_DROPHILITED) // The item appears marked when the user drags an object over it, if // it can accept the object as a drop-target. // * Link/Alias/Shortcut (LVIS_LINK) // The item's text has a standard link-indicator appended (Foo >>). // // There are notifications that allow applications to determine when an item // has been clicked or double clicked, caption text changes have occured, // drag tracking is occuring, widths of columns have changed, etc. // ////////////////////////////////////////////////////////////////////////////// #ifdef WIN32 #define WC_LISTVIEW "SysListView32" #else #define WC_LISTVIEW "SysListView" #endif // ListView styles // // view type styles (we only have 16 bits to use here) #define LVS_ICON 0x0000 #define LVS_REPORT 0x0001 #define LVS_SMALLICON 0x0002 #define LVS_LIST 0x0003 #define LVS_TYPEMASK 0x0003 // shared styles #define LVS_SINGLESEL 0x0004 #define LVS_SHOWSELALWAYS 0x0008 #define LVS_SORTASCENDING 0x0010 #define LVS_SORTDESCENDING 0x0020 #define LVS_SHAREIMAGELISTS 0x0040 #define LVS_NOLABELWRAP 0x0080 #define LVS_AUTOARRANGE 0x0100 #define LVS_EDITLABELS 0x0200 #define LVS_NOITEMDATA 0x1000 #define LVS_NOSCROLL 0x2000 /// the fields below are reserved for style specific settings. #define LVS_TYPESTYLEMASK 0xfc00 // the mask for all these styles // Large icon. #define LVS_ALIGNTOP 0x0000 #define LVS_ALIGNBOTTOM 0x0400 #define LVS_ALIGNLEFT 0x0800 #define LVS_ALIGNRIGHT 0x0c00 #define LVS_ALIGNMASK 0x0c00 // Report view. #define LVS_OWNERDRAWFIXED 0x0400 #define LVS_NOCOLUMNHEADER 0x4000 #define LVS_NOSORTHEADER 0x8000 // COLORREF ListView_GetBkColor(HWND hwnd); #define LVM_GETBKCOLOR (LVM_FIRST + 0) #define ListView_GetBkColor(hwnd) \ (COLORREF)SendMessage((hwnd), LVM_GETBKCOLOR, 0, 0L) // BOOL ListView_SetBkColor(HWND hwnd, COLORREF clrBk); #define LVM_SETBKCOLOR (LVM_FIRST + 1) #define ListView_SetBkColor(hwnd, clrBk) \ (BOOL)SendMessage((hwnd), LVM_SETBKCOLOR, 0, (LPARAM)(COLORREF)(clrBk)) // HIMAGELIST ListView_GetImageList(HWND hwnd, int iImageList); #define LVM_GETIMAGELIST (LVM_FIRST + 2) #define ListView_GetImageList(hwnd, iImageList) \ (HIMAGELIST)SendMessage((hwnd), LVM_GETIMAGELIST, (WPARAM)(INT)(iImageList), 0L) #define LVSIL_NORMAL 0 #define LVSIL_SMALL 1 #define LVSIL_STATE 2 // HIMAGELIST ListView_SetImageList(HWND hwnd, HIMAGELIST himl, int iImageList); #define LVM_SETIMAGELIST (LVM_FIRST + 3) #define ListView_SetImageList(hwnd, himl, iImageList) \ (HIMAGELIST)(UINT)SendMessage((hwnd), LVM_SETIMAGELIST, (WPARAM)(iImageList), (LPARAM)(UINT)(HIMAGELIST)(himl)) // int ListView_GetItemCount(HWND hwnd); #define LVM_GETITEMCOUNT (LVM_FIRST + 4) #define ListView_GetItemCount(hwnd) \ (int)SendMessage((hwnd), LVM_GETITEMCOUNT, 0, 0L) // ListView Item structure #define LVIF_TEXT 0x0001 // LV_ITEM.mask flags (indicate valid fields in LV_ITEM) #define LVIF_IMAGE 0x0002 #define LVIF_PARAM 0x0004 #define LVIF_STATE 0x0008 // State flags #define LVIS_FOCUSED 0x0001 // LV_ITEM.state flags #define LVIS_SELECTED 0x0002 #define LVIS_CUT 0x0004 // LVIS_MARKED #define LVIS_DROPHILITED 0x0008 #define LVIS_DISABLED 0x0010 #define LVIS_HIDDEN 0x0020 #define LVIS_LINK 0x0040 #define LVIS_OVERLAYMASK 0x0F00 // used as ImageList overlay image indexes #define LVIS_STATEIMAGEMASK 0xF000 // client bits for state image drawing #define LVIS_USERMASK LVIS_STATEIMAGEMASK // BUGBUG: remove me. #define INDEXTOSTATEIMAGEMASK(i) ((i) << 12) typedef struct _LV_ITEM { UINT mask; // LVIF_ flags int iItem; int iSubItem; UINT state; // LVIS_ flags UINT stateMask; // LVIS_ flags (valid bits in state) LPSTR pszText; int cchTextMax; int iImage; LPARAM lParam; } LV_ITEM; // Values used to cause text/image GETDISPINFO callbacks #define LPSTR_TEXTCALLBACK ((LPSTR)-1L) #define I_IMAGECALLBACK (-1) // BOOL ListView_GetItem(HWND hwnd, LV_ITEM FAR* pitem); #define LVM_GETITEM (LVM_FIRST + 5) #define ListView_GetItem(hwnd, pitem) \ (BOOL)SendMessage((hwnd), LVM_GETITEM, 0, (LPARAM)(LV_ITEM FAR*)(pitem)) // Sets items and subitems. // // BOOL ListView_SetItem(HWND hwnd, const LV_ITEM FAR* pitem); #define LVM_SETITEM (LVM_FIRST + 6) #define ListView_SetItem(hwnd, pitem) \ (BOOL)SendMessage((hwnd), LVM_SETITEM, 0, (LPARAM)(const LV_ITEM FAR*)(pitem)) // int ListView_InsertItem(HWND hwnd, const LV_ITEM FAR* pitem); #define LVM_INSERTITEM (LVM_FIRST + 7) #define ListView_InsertItem(hwnd, pitem) \ (int)SendMessage((hwnd), LVM_INSERTITEM, 0, (LPARAM)(const LV_ITEM FAR*)(pitem)) // Deletes the specified item along with all its subitems. // // BOOL ListView_DeleteItem(HWND hwnd, int i); #define LVM_DELETEITEM (LVM_FIRST + 8) #define ListView_DeleteItem(hwnd, i) \ (BOOL)SendMessage((hwnd), LVM_DELETEITEM, (WPARAM)(int)(i), 0L) // BOOL ListView_DeleteAllItems(HWND hwnd); #define LVM_DELETEALLITEMS (LVM_FIRST + 9) #define ListView_DeleteAllItems(hwnd) \ (BOOL)SendMessage((hwnd), LVM_DELETEALLITEMS, 0, 0L) // UINT ListView_GetCallbackMask(HWND hwnd); #define LVM_GETCALLBACKMASK (LVM_FIRST + 10) #define ListView_GetCallbackMask(hwnd) \ (BOOL)SendMessage((hwnd), LVM_GETCALLBACKMASK, 0, 0) // BOOL ListView_SetCallbackMask(HWND hwnd, UINT mask); #define LVM_SETCALLBACKMASK (LVM_FIRST + 11) #define ListView_SetCallbackMask(hwnd, mask) \ (BOOL)SendMessage((hwnd), LVM_SETCALLBACKMASK, (WPARAM)(UINT)(mask), 0) // ListView_GetNextItem flags (can be used in combination) #define LVNI_ALL 0x0000 #define LVNI_FOCUSED 0x0001 // return only focused item #define LVNI_SELECTED 0x0002 // return only selected items #define LVNI_CUT 0x0004 // return only marked items #define LVNI_DROPHILITED 0x0008 // return only drophilited items #define LVNI_HIDDEN 0x0010 // return only hidden items #define LVNI_PREVIOUS 0x0020 // Go backwards #define LVNI_ABOVE 0x0100 // return item geometrically above #define LVNI_BELOW 0x0200 // "" below #define LVNI_TOLEFT 0x0400 // "" to left #define LVNI_TORIGHT 0x0800 // "" to right (NOTE: these four are // mutually exclusive, but // can be used with other LVNI's) // int ListView_GetNextItem(HWND hwnd, int i, UINT flags); #define LVM_GETNEXTITEM (LVM_FIRST + 12) #define ListView_GetNextItem(hwnd, i, flags) \ (int)SendMessage((hwnd), LVM_GETNEXTITEM, (WPARAM)(int)(i), MAKELPARAM((flags), 0)) // ListView_FindInfo definitions #define LVFI_PARAM 0x0001 #define LVFI_STRING 0x0002 #define LVFI_SUBSTRING 0x0004 #define LVFI_PARTIAL 0x0008 #define LVFI_NOCASE 0x0010 #define LVFI_WRAP 0x0020 typedef struct _LV_FINDINFO { UINT flags; LPCSTR psz; LPARAM lParam; } LV_FINDINFO; // int ListView_FindItem(HWND hwnd, int iStart, const LV_FINDINFO FAR* plvfi); #define LVM_FINDITEM (LVM_FIRST + 13) #define ListView_FindItem(hwnd, iStart, plvfi) \ (int)SendMessage((hwnd), LVM_FINDITEM, (WPARAM)(int)(iStart), (LPARAM)(const LV_FINDINFO FAR*)(plvfi)) #define LVIR_BOUNDS 0 #define LVIR_ICON 1 #define LVIR_LABEL 2 // Rectangle bounding all or part of item, based on LVIR_* code. Rect is returned in view coords // BOOL ListView_GetItemRect(HWND hwndLV, int i, RECT FAR* prc, int code); #define LVM_GETITEMRECT (LVM_FIRST + 14) #define ListView_GetItemRect(hwnd, i, prc, code) \ ((prc)->left = (code), (BOOL)SendMessage((hwnd), LVM_GETITEMRECT, (WPARAM)(int)(i), (LPARAM)(RECT FAR*)(prc))) // Move top-left corner of item to (x, y), specified in view rect relative coords // (icon and small view only) // BOOL ListView_SetItemPosition(HWND hwndLV, int i, int x, int y); #define LVM_SETITEMPOSITION (LVM_FIRST + 15) #define ListView_SetItemPosition(hwndLV, i, x, y) \ (BOOL)SendMessage((hwndLV), LVM_SETITEMPOSITION, (WPARAM)(int)(i), MAKELPARAM((x), (y))) // BOOL ListView_GetItemPosition(HWND hwndLV, int i, POINT FAR* ppt); #define LVM_GETITEMPOSITION (LVM_FIRST + 16) #define ListView_GetItemPosition(hwndLV, i, ppt) \ (BOOL)SendMessage((hwndLV), LVM_GETITEMPOSITION, (WPARAM)(int)(i), (LPARAM)(POINT FAR*)(ppt)) // Get column width of string // int ListView_GetStringWidth(HWND hwndLV, LPCSTR psz); #define LVM_GETSTRINGWIDTH (LVM_FIRST + 17) #define ListView_GetStringWidth(hwndLV, psz) \ (int)SendMessage((hwndLV), LVM_GETSTRINGWIDTH, 0, (LPARAM)(LPCSTR)(psz)) // Hit test item. Returns item at (x,y), or -1 if not on an item. // Combination of LVHT_ values *pflags, indicating where the cursor // is relative to edges of ListView window (above, below, right, left) // or whether (x, y) is over icon, label, or inside window but not on item. // int ListView_HitTest(HWND hwndLV, LV_HITTESTINFO FAR* pinfo); // ItemHitTest flag values #define LVHT_NOWHERE 0x0001 #define LVHT_ONITEMICON 0x0002 #define LVHT_ONITEMLABEL 0x0004 #define LVHT_ONITEMSTATEICON 0x0008 #define LVHT_ONITEM (LVHT_ONITEMICON | LVHT_ONITEMLABEL | LVHT_ONITEMSTATEICON) #define LVHT_ABOVE 0x0008 #define LVHT_BELOW 0x0010 #define LVHT_TORIGHT 0x0020 #define LVHT_TOLEFT 0x0040 typedef struct _LV_HITTESTINFO { POINT pt; // in: client coords UINT flags; // out: LVHT_ flags int iItem; // out: item } LV_HITTESTINFO; // int ListView_HitTest(HWND hwndLV, LV_HITTESTINFO FAR* pinfo); #define LVM_HITTEST (LVM_FIRST + 18) #define ListView_HitTest(hwndLV, pinfo) \ (int)SendMessage((hwndLV), LVM_HITTEST, 0, (LPARAM)(LV_HITTESTINFO FAR*)(pinfo)) // Return view rectangle, relative to window // BOOL ListView_GetViewRect(HWND hwndLV, RECT FAR* prcVis); // Scroll an item into view if not wholly or partially visible // BOOL ListView_EnsureVisible(HWND hwndLV, int i, BOOL fPartialOK); #define LVM_ENSUREVISIBLE (LVM_FIRST + 19) #define ListView_EnsureVisible(hwndLV, i, fPartialOK) \ (BOOL)SendMessage((hwndLV), LVM_ENSUREVISIBLE, (WPARAM)(int)(i), MAKELPARAM((fPartialOK), 0)) // Scroll listview -- offsets origin of view rectangle by dx, dy // BOOL ListView_Scroll(HWND hwndLV, int dx, int dy); #define LVM_SCROLL (LVM_FIRST + 20) #define ListView_Scroll(hwndLV, dx, dy) \ (BOOL)SendMessage((hwndLV), LVM_SCROLL, 0, MAKELPARAM((dx), (dy))) // Force eventual redraw of range of items (redraw doesn't occur // until WM_PAINT processed -- call UpdateWindow() after to redraw right away) // BOOL ListView_RedrawItems(HWND hwndLV, int iFirst, int iLast); #define LVM_REDRAWITEMS (LVM_FIRST + 21) #define ListView_RedrawItems(hwndLV, iFirst, iLast) \ (BOOL)SendMessage((hwndLV), LVM_REDRAWITEMS, 0, MAKELPARAM((iFirst), (iLast))) // Arrange style #define LVA_DEFAULT 0x0000 #define LVA_ALIGNLEFT 0x0001 #define LVA_ALIGNTOP 0x0002 #define LVA_ALIGNRIGHT 0x0003 #define LVA_ALIGNBOTTOM 0x0004 #define LVA_SNAPTOGRID 0x0005 #define LVA_SORTASCENDING 0x0100 // can be used in combo with above LVA_* values #define LVA_SORTDESCENDING 0x0200 // "" // Arrange icons according to LVA_* code // BOOL ListView_Arrange(HWND hwndLV, UINT code); #define LVM_ARRANGE (LVM_FIRST + 22) #define ListView_Arrange(hwndLV, code) \ (BOOL)SendMessage((hwndLV), LVM_ARRANGE, (WPARAM)(UINT)(code), 0L) // Begin editing the label of a control. Implicitly selects and focuses // item. Send WM_CANCELMODE to cancel. // HWND ListView_EditLabel(HWND hwndLV, int i); #define LVM_EDITLABEL (LVM_FIRST + 23) #define ListView_EditLabel(hwndLV, i) \ (HWND)SendMessage((hwndLV), LVM_EDITLABEL, (WPARAM)(int)(i), 0L) // Return edit control being used for editing. Subclass OK, but // don't destroy. Will be destroyed when editing is finished. //HWND ListView_GetEditControl(HWND hwndLV); #define LVM_GETEDITCONTROL (LVM_FIRST + 24) #define ListView_GetEditControl(hwndLV) \ (HWND)SendMessage((hwndLV), LVM_GETEDITCONTROL, 0, 0L) typedef struct _LV_COLUMN { UINT mask; int fmt; int cx; LPSTR pszText; int cchTextMax; int iSubItem; // subitem to display } LV_COLUMN; // LV_COLUMN mask values #define LVCF_FMT 0x0001 #define LVCF_WIDTH 0x0002 #define LVCF_TEXT 0x0004 #define LVCF_SUBITEM 0x0008 // Column format codes #define LVCFMT_LEFT 0 #define LVCFMT_RIGHT 1 #define LVCFMT_CENTER 2 // Set/Query column info // BOOL ListView_GetColumn(HWND hwndLV, int iCol, LV_COLUMN FAR* pcol); #define LVM_GETCOLUMN (LVM_FIRST + 25) #define ListView_GetColumn(hwnd, iCol, pcol) \ (BOOL)SendMessage((hwnd), LVM_GETCOLUMN, (WPARAM)(int)(iCol), (LPARAM)(LV_COLUMN FAR*)(pcol)) // BOOL ListView_SetColumn(HWND hwndLV, int iCol, LV_COLUMN FAR* pcol); #define LVM_SETCOLUMN (LVM_FIRST + 26) #define ListView_SetColumn(hwnd, iCol, pcol) \ (BOOL)SendMessage((hwnd), LVM_SETCOLUMN, (WPARAM)(int)(iCol), (LPARAM)(const LV_COLUMN FAR*)(pcol)) // insert/delete report view column // int ListView_InsertColumn(HWND hwndLV, int iCol, const LV_COLUMN FAR* pcol); #define LVM_INSERTCOLUMN (LVM_FIRST + 27) #define ListView_InsertColumn(hwnd, iCol, pcol) \ (int)SendMessage((hwnd), LVM_INSERTCOLUMN, (WPARAM)(int)(iCol), (LPARAM)(const LV_COLUMN FAR*)(pcol)) // BOOL ListView_DeleteColumn(HWND hwndLV, int iCol); #define LVM_DELETECOLUMN (LVM_FIRST + 28) #define ListView_DeleteColumn(hwnd, iCol) \ (BOOL)SendMessage((hwnd), LVM_DELETECOLUMN, (WPARAM)(int)(iCol), 0) #define LVM_GETCOLUMNWIDTH (LVM_FIRST + 29) #define ListView_GetColumnWidth(hwnd, iCol) \ (int)SendMessage((hwnd), LVM_GETCOLUMNWIDTH, (WPARAM)(int)(iCol), 0) #define LVSCW_AUTOSIZE -1 #define LVSCW_AUTOSIZE_USEHEADER -2 #define LVM_SETCOLUMNWIDTH (LVM_FIRST + 30) #define ListView_SetColumnWidth(hwnd, iCol, cx) \ (BOOL)SendMessage((hwnd), LVM_SETCOLUMNWIDTH, (WPARAM)(int)(iCol), MAKELPARAM((cx), 0)) // HIMAGELIST ListView_CreateDragImage(HWND hwndLV, int iItem, LPPOINT lpptUpLeft); #define LVM_CREATEDRAGIMAGE (LVM_FIRST + 33) #define ListView_CreateDragImage(hwnd, i, lpptUpLeft) \ (HIMAGELIST)SendMessage((hwnd), LVM_CREATEDRAGIMAGE, (WPARAM)(int)(i), (LPARAM)(LPPOINT)(lpptUpLeft)) // BOOL ListView_GetViewRect(HWND hwndLV, RECT FAR* prc); #define LVM_GETVIEWRECT (LVM_FIRST + 34) #define ListView_GetViewRect(hwnd, prc) \ (BOOL)SendMessage((hwnd), LVM_GETVIEWRECT, 0, (LPARAM)(RECT FAR*)(prc)) // get/set text and textbk color for text drawing. these override // the standard window/windowtext settings. they do NOT override // when drawing selected text. // COLORREF ListView_GetTextColor(HWND hwnd); #define LVM_GETTEXTCOLOR (LVM_FIRST + 35) #define ListView_GetTextColor(hwnd) \ (COLORREF)SendMessage((hwnd), LVM_GETTEXTCOLOR, 0, 0L) // BOOL ListView_SetTextColor(HWND hwnd, COLORREF clrText); #define LVM_SETTEXTCOLOR (LVM_FIRST + 36) #define ListView_SetTextColor(hwnd, clrText) \ (BOOL)SendMessage((hwnd), LVM_SETTEXTCOLOR, 0, (LPARAM)(COLORREF)(clrText)) // COLORREF ListView_GetTextBkColor(HWND hwnd); #define LVM_GETTEXTBKCOLOR (LVM_FIRST + 37) #define ListView_GetTextBkColor(hwnd) \ (COLORREF)SendMessage((hwnd), LVM_GETTEXTBKCOLOR, 0, 0L) // BOOL ListView_SetTextBkColor(HWND hwnd, COLORREF clrTextBk); #define LVM_SETTEXTBKCOLOR (LVM_FIRST + 38) #define ListView_SetTextBkColor(hwnd, clrTextBk) \ (BOOL)SendMessage((hwnd), LVM_SETTEXTBKCOLOR, 0, (LPARAM)(COLORREF)(clrTextBk)) // messages for getting the index of the first visible item #define LVM_GETTOPINDEX (LVM_FIRST + 39) #define ListView_GetTopIndex(hwndLV, ppt) \ (int)SendMessage((hwndLV), LVM_GETTOPINDEX, 0, 0) // Message for getting the count of items per page #define LVM_GETCOUNTPERPAGE (LVM_FIRST + 40) #define ListView_GetCountPerPage(hwndLV, ppt) \ (int)SendMessage((hwndLV), LVM_GETCOUNTPERPAGE, 0, 0) // Message for getting the listview origin, which is needed for SetItemPos... #define LVM_GETORIGIN (LVM_FIRST + 41) #define ListView_GetOrigin(hwndLV, ppt) \ (BOOL)SendMessage((hwndLV), LVM_GETORIGIN, (WPARAM)0, (LPARAM)(POINT FAR*)(ppt)) // Message for getting the count of items per page #define LVM_UPDATE (LVM_FIRST + 42) #define ListView_Update(hwndLV, i) \ (BOOL)SendMessage((hwndLV), LVM_UPDATE, (WPARAM)i, 0L) // set and item's state. this macro will return VOID. but the // message returns BOOL success. #define LVM_SETITEMSTATE (LVM_FIRST + 43) #define ListView_SetItemState(hwndLV, i, data, mask) \ { LV_ITEM lvi;\ lvi.stateMask = mask;\ lvi.state = data;\ SendMessage((hwndLV), LVM_SETITEMSTATE, (WPARAM)i, (LPARAM)(LV_ITEM FAR *)&lvi);\ } // get the item's state #define LVM_GETITEMSTATE (LVM_FIRST + 44) #define ListView_GetItemState(hwndLV, i, mask) \ (UINT)SendMessage((hwndLV), LVM_GETITEMSTATE, (WPARAM)i, (LPARAM)mask) // get the item text. // if you want the int return value of how the buff size, you call it yourself. #define LVM_GETITEMTEXT (LVM_FIRST + 45) #define ListView_GetItemText(hwndLV, i, iSubItem_, pszText_, cchTextMax_) \ { LV_ITEM lvi;\ lvi.iSubItem = iSubItem_;\ lvi.cchTextMax = cchTextMax_;\ lvi.pszText = pszText_;\ SendMessage((hwndLV), LVM_GETITEMTEXT, (WPARAM)i, (LPARAM)(LV_ITEM FAR *)&lvi);\ } // get the item text. // if you want the int return value (BOOL) success do it yourself #define LVM_SETITEMTEXT (LVM_FIRST + 46) #define ListView_SetItemText(hwndLV, i, iSubItem_, pszText_) \ { LV_ITEM lvi;\ lvi.iSubItem = iSubItem_;\ lvi.pszText = pszText_;\ SendMessage((hwndLV), LVM_SETITEMTEXT, (WPARAM)i, (LPARAM)(LV_ITEM FAR *)&lvi);\ } // tell the listview that you are going to add nItems lot of items #define LVM_SETITEMCOUNT (LVM_FIRST + 47) #define ListView_SetItemCount(hwndLV, cItems) \ SendMessage((hwndLV), LVM_SETITEMCOUNT, (WPARAM)cItems, 0) typedef int (CALLBACK *PFNLVCOMPARE)(LPARAM, LPARAM, LPARAM); // tell the listview to resort the items #define LVM_SORTITEMS (LVM_FIRST + 48) #define ListView_SortItems(hwndLV, _pfnCompare, _lPrm) \ (BOOL)SendMessage((hwndLV), LVM_SORTITEMS, (WPARAM)(LPARAM)_lPrm, \ (LPARAM)(PFNLVCOMPARE)_pfnCompare) // void ListView_SetItemPosition(HWND hwndLV, int i, int x, int y); #define LVM_SETITEMPOSITION32 (LVM_FIRST + 49) #define ListView_SetItemPosition32(hwndLV, i, x, y) \ { POINT ptNewPos = {x,y}; \ SendMessage((hwndLV), LVM_SETITEMPOSITION32, (WPARAM)(int)(i), (LPARAM)&ptNewPos); \ } // get the number of items selected #define LVM_GETSELECTEDCOUNT (LVM_FIRST + 50) #define ListView_GetSelectedCount(hwndLV) \ (UINT)SendMessage((hwndLV), LVM_GETSELECTEDCOUNT, 0, 0L) #define LVM_GETITEMSPACING (LVM_FIRST + 51) #define ListView_GetItemSpacing(hwndLV, fSmall) \ (DWORD)SendMessage((hwndLV), LVM_GETITEMSPACING, fSmall, 0L) // ListView notification codes // Structure used by all ListView control notifications. // Not all fields supply useful info for all notifications: // iItem will be -1 and others 0 if not used. // Some return a BOOL, too. // typedef struct _NM_LISTVIEW { NMHDR hdr; int iItem; int iSubItem; UINT uNewState; // Combination of LVIS_* (if uChanged & LVIF_STATE) UINT uOldState; // Combination of LVIS_* UINT uChanged; // Combination of LVIF_* indicating what changed POINT ptAction; // Only valid for LVN_BEGINDRAG and LVN_BEGINRDRAG LPARAM lParam; // Only valid for LVN_DELETEITEM } NM_LISTVIEW; #define LVN_ITEMCHANGING (LVN_FIRST-0) // lParam -> NM_LISTVIEW: item changing. Return FALSE to disallow #define LVN_ITEMCHANGED (LVN_FIRST-1) // item changed. #define LVN_INSERTITEM (LVN_FIRST-2) #define LVN_DELETEITEM (LVN_FIRST-3) #define LVN_DELETEALLITEMS (LVN_FIRST-4) #define LVN_BEGINLABELEDIT (LVN_FIRST-5) // lParam -> LV_DISPINFO: start of label editing #define LVN_ENDLABELEDIT (LVN_FIRST-6) // lParam -> LV_DISPINFO: end of label editing // (iItem == -1 if cancel) //(LVN_FIRST-7) not used #define LVN_COLUMNCLICK (LVN_FIRST-8) // column identified by iItem was clicked #define LVN_BEGINDRAG (LVN_FIRST-9) // Start of drag operation requested // (return FALSE if the app handles it) #define LVN_ENDDRAG (LVN_FIRST-10) // End of dragging operation. #define LVN_BEGINRDRAG (LVN_FIRST-11) // Start of button 2 dragging #define LVN_ENDRDRAG (LVN_FIRST-12) // End of button 2 drag (not used yet) #ifdef PW2 #define LVN_PEN (LVN_FIRST-20) // pen notifications #endif //PW2 // LVN_DISPINFO notification #define LVN_GETDISPINFO (LVN_FIRST-50) // lParam -> LV_DISPINFO #define LVN_SETDISPINFO (LVN_FIRST-51) // lParam -> LV_DISPINFO typedef struct _LV_DISPINFO { NMHDR hdr; LV_ITEM item; } LV_DISPINFO; // LVN_KEYDOWN notification #define LVN_KEYDOWN (LVN_FIRST-55) typedef struct _LV_KEYDOWN { NMHDR hdr; WORD wVKey; UINT flags; } LV_KEYDOWN; // ====== TREEVIEW APIs ================================================= // // Class name: SysTreeView (WC_TREEVIEW) // // The SysTreeView control provides for a group of items which are // displayed in a hierarchical organization. Each item may contain // independent "sub-item" entries which are displayed below and indented // from the parent item. // // Operation of this control is similar to the SysListView control above, // except that sub-items are distinct entries, not supporting text elements // belonging to the owning object (which is the case for the Report View // mode of the SysListView). // // There are notifications that allow applications to determine when an item // has been clicked or double clicked, caption text changes have occured, // drag tracking is occuring, widths of columns have changed, node items // are expanded, etc. // // NOTE: All "messages" below are documented as APIs; eventually these // will be changed to window messages, and corresponding macros will be // written that have the same signature as the APIs shown below. // #ifdef WIN32 #define WC_TREEVIEW "SysTreeView32" #else #define WC_TREEVIEW "SysTreeView" #endif // TreeView window styles #define TVS_HASBUTTONS 0x0001 // draw "plus" & "minus" sign on nodes with children #define TVS_HASLINES 0x0002 // draw lines between nodes #define TVS_LINESATROOT 0x0004 #define TVS_EDITLABELS 0x0008 // alow text edit in place #define TVS_DISABLEDRAGDROP 0x0010 // disable draggine notification of nodes #define TVS_SHOWSELALWAYS 0x0020 typedef struct _TREEITEM FAR* HTREEITEM; #define TVIF_TEXT 0x0001 // TV_ITEM.mask flags #define TVIF_IMAGE 0x0002 #define TVIF_PARAM 0x0004 #define TVIF_STATE 0x0008 #define TVIF_HANDLE 0x0010 #define TVIF_SELECTEDIMAGE 0x0020 #define TVIF_CHILDREN 0x0040 // State flags #define TVIS_FOCUSED 0x0001 // TV_ITEM.state flags #define TVIS_SELECTED 0x0002 #define TVIS_CUT 0x0004 // TVIS_MARKED #define TVIS_DROPHILITED 0x0008 #define TVIS_DISABLED 0x0010 #define TVIS_EXPANDED 0x0020 #define TVIS_EXPANDEDONCE 0x0040 #define TVIS_OVERLAYMASK 0x0F00 // used as ImageList overlay image indexes #define TVIS_STATEIMAGEMASK 0xF000 #define TVIS_USERMASK 0xF000 #define I_CHILDRENCALLBACK (-1) // cChildren value for children callback typedef struct _TV_ITEM { UINT mask; // TVIF_ flags HTREEITEM hItem; // The item to be changed UINT state; // TVIS_ flags UINT stateMask; // TVIS_ flags (valid bits in state) LPSTR pszText; // The text for this item int cchTextMax; // The length of the pszText buffer int iImage; // The index of the image for this item int iSelectedImage; // the index of the selected imagex int cChildren; // # of child nodes, I_CHILDRENCALLBACK for callback LPARAM lParam; // App defined data } TV_ITEM, FAR *LPTV_ITEM; #define TVI_ROOT ((HTREEITEM)0xFFFF0000) #define TVI_FIRST ((HTREEITEM)0xFFFF0001) #define TVI_LAST ((HTREEITEM)0xFFFF0002) #define TVI_SORT ((HTREEITEM)0xFFFF0003) typedef struct _TV_INSERTSTRUCT { HTREEITEM hParent; // a valid HTREEITEM or TVI_ value HTREEITEM hInsertAfter; // a valid HTREEITEM or TVI_ value TV_ITEM item; } TV_INSERTSTRUCT, FAR *LPTV_INSERTSTRUCT; #define TVM_INSERTITEM (TV_FIRST + 0) #define TreeView_InsertItem(hwnd, lpis) \ (HTREEITEM)SendMessage((hwnd), TVM_INSERTITEM, 0, (LPARAM)(LPTV_INSERTSTRUCT)(lpis)) #define TVM_DELETEITEM (TV_FIRST + 1) #define TreeView_DeleteItem(hwnd, hitem) \ (BOOL)SendMessage((hwnd), TVM_DELETEITEM, 0, (LPARAM)(HTREEITEM)(hitem)) #define TreeView_DeleteAllItems(hwnd) \ (BOOL)SendMessage((hwnd), TVM_DELETEITEM, 0, (LPARAM)TVI_ROOT) #define TVM_EXPAND (TV_FIRST + 2) #define TreeView_Expand(hwnd, hitem, code) \ (BOOL)SendMessage((hwnd), TVM_EXPAND, (WPARAM)code, (LPARAM)(HTREEITEM)(hitem)) // TreeView_Expand codes #define TVE_COLLAPSE 0x0001 #define TVE_EXPAND 0x0002 #define TVE_TOGGLE 0x0003 #define TVE_COLLAPSERESET 0x8000 // remove all children when collapsing #define TVM_GETITEMRECT (TV_FIRST + 4) #define TreeView_GetItemRect(hwnd, hitem, prc, code) \ (*(HTREEITEM FAR *)prc = (hitem), (BOOL)SendMessage((hwnd), TVM_GETITEMRECT, (WPARAM)(code), (LPARAM)(RECT FAR*)(prc))) #define TVM_GETCOUNT (TV_FIRST + 5) #define TreeView_GetCount(hwnd) \ (UINT)SendMessage((hwnd), TVM_GETCOUNT, 0, 0) #define TVM_GETINDENT (TV_FIRST + 6) #define TreeView_GetIndent(hwnd) \ (UINT)SendMessage((hwnd), TVM_GETINDENT, 0, 0) #define TVM_SETINDENT (TV_FIRST + 7) #define TreeView_SetIndent(hwnd, indent) \ (BOOL)SendMessage((hwnd), TVM_SETINDENT, (WPARAM)indent, 0) #define TVM_GETIMAGELIST (TV_FIRST + 8) #define TreeView_GetImageList(hwnd, iImage) \ (HIMAGELIST)SendMessage((hwnd), TVM_GETIMAGELIST, iImage, 0) #define TVSIL_NORMAL 0 #define TVSIL_STATE 2 // use TVIS_STATEIMAGEMASK as index into state imagelist #define TVM_SETIMAGELIST (TV_FIRST + 9) #define TreeView_SetImageList(hwnd, himl, iImage) \ (HIMAGELIST)SendMessage((hwnd), TVM_SETIMAGELIST, iImage, (LPARAM)(UINT)(HIMAGELIST)(himl)) #define TVM_GETNEXTITEM (TV_FIRST + 10) #define TreeView_GetNextItem(hwnd, hitem, code) \ (HTREEITEM)SendMessage((hwnd), TVM_GETNEXTITEM, (WPARAM)code, (LPARAM)(HTREEITEM)(hitem)) // TreeView_GetNextItem & TreeView_SelectItem codes #define TVGN_ROOT 0x0000 // GetNextItem() #define TVGN_NEXT 0x0001 // GetNextItem() #define TVGN_PREVIOUS 0x0002 // GetNextItem() #define TVGN_PARENT 0x0003 // GetNextItem() #define TVGN_CHILD 0x0004 // GetNextItem() #define TVGN_FIRSTVISIBLE 0x0005 // GetNextItem() & SelectItem() #define TVGN_NEXTVISIBLE 0x0006 // GetNextItem() #define TVGN_PREVIOUSVISIBLE 0x0007 // GetNextItem() #define TVGN_DROPHILITE 0x0008 // GetNextItem() & SelectItem() #define TVGN_CARET 0x0009 // GetNextItem() & SelectItem() #define TreeView_GetChild(hwnd, hitem) TreeView_GetNextItem(hwnd, hitem, TVGN_CHILD) #define TreeView_GetNextSibling(hwnd, hitem) TreeView_GetNextItem(hwnd, hitem, TVGN_NEXT) #define TreeView_GetPrevSibling(hwnd, hitem) TreeView_GetNextItem(hwnd, hitem, TVGN_PREVIOUS) #define TreeView_GetParent(hwnd, hitem) TreeView_GetNextItem(hwnd, hitem, TVGN_PARENT) #define TreeView_GetFirstVisible(hwnd) TreeView_GetNextItem(hwnd, NULL, TVGN_FIRSTVISIBLE) #define TreeView_GetNextVisible(hwnd, hitem) TreeView_GetNextItem(hwnd, hitem, TVGN_NEXTVISIBLE) #define TreeView_GetPrevVisible(hwnd, hitem) TreeView_GetNextItem(hwnd, hitem, TVGN_PREVIOUSVISIBLE) #define TreeView_GetSelection(hwnd) TreeView_GetNextItem(hwnd, NULL, TVGN_CARET) #define TreeView_GetDropHilight(hwnd) TreeView_GetNextItem(hwnd, NULL, TVGN_DROPHILITE) #define TreeView_GetRoot(hwnd) TreeView_GetNextItem(hwnd, NULL, TVGN_ROOT) #define TVM_SELECTITEM (TV_FIRST + 11) #define TreeView_Select(hwnd, hitem, code) \ (HTREEITEM)SendMessage((hwnd), TVM_SELECTITEM, (WPARAM)code, (LPARAM)(HTREEITEM)(hitem)) #define TreeView_SelectItem(hwnd, hitem) TreeView_Select(hwnd, hitem, TVGN_CARET) #define TreeView_SelectDropTarget(hwnd, hitem) TreeView_Select(hwnd, hitem, TVGN_DROPHILITE) #define TVM_GETITEM (TV_FIRST + 12) #define TreeView_GetItem(hwnd, pitem) \ (BOOL)SendMessage((hwnd), TVM_GETITEM, 0, (LPARAM)(TV_ITEM FAR*)(pitem)) #define TVM_SETITEM (TV_FIRST + 13) #define TreeView_SetItem(hwnd, pitem) \ (BOOL)SendMessage((hwnd), TVM_SETITEM, 0, (LPARAM)(const TV_ITEM FAR*)(pitem)) #define TVM_EDITLABEL (TV_FIRST + 14) #define TreeView_EditLabel(hwnd, hitem) \ (HWND)SendMessage((hwnd), TVM_EDITLABEL, 0, (LPARAM)(HTREEITEM)(hitem)) #define TVM_GETEDITCONTROL (TV_FIRST + 15) #define TreeView_GetEditControl(hwnd) \ (HWND)SendMessage((hwnd), TVM_GETEDITCONTROL, 0, 0) #define TVM_GETVISIBLECOUNT (TV_FIRST + 16) #define TreeView_GetVisibleCount(hwnd) \ (UINT)SendMessage((hwnd), TVM_GETVISIBLECOUNT, 0, 0) #define TVM_HITTEST (TV_FIRST + 17) #define TreeView_HitTest(hwnd, lpht) \ (HTREEITEM)SendMessage((hwnd), TVM_HITTEST, 0, (LPARAM)(LPTV_HITTESTINFO)(lpht)) typedef struct _TV_HITTESTINFO { POINT pt; // in: client coords UINT flags; // out: TVHT_ flags HTREEITEM hItem; // out: } TV_HITTESTINFO, FAR *LPTV_HITTESTINFO; #define TVHT_NOWHERE 0x0001 #define TVHT_ONITEMICON 0x0002 #define TVHT_ONITEMLABEL 0x0004 #define TVHT_ONITEM (TVHT_ONITEMICON | TVHT_ONITEMLABEL | TVHT_ONITEMSTATEICON) #define TVHT_ONITEMINDENT 0x0008 #define TVHT_ONITEMBUTTON 0x0010 #define TVHT_ONITEMRIGHT 0x0020 #define TVHT_ONITEMSTATEICON 0x0040 #define TVHT_ABOVE 0x0100 #define TVHT_BELOW 0x0200 #define TVHT_TORIGHT 0x0400 #define TVHT_TOLEFT 0x0800 #define TVM_CREATEDRAGIMAGE (TV_FIRST + 18) #define TreeView_CreateDragImage(hwnd, hitem) \ (HIMAGELIST)SendMessage((hwnd), TVM_CREATEDRAGIMAGE, 0, (LPARAM)(HTREEITEM)(hitem)) #define TVM_SORTCHILDREN (TV_FIRST + 19) #define TreeView_SortChildren(hwnd, hitem, recurse) \ (BOOL)SendMessage((hwnd), TVM_SORTCHILDREN, (WPARAM)recurse, (LPARAM)(HTREEITEM)(hitem)) #define TVM_ENSUREVISIBLE (TV_FIRST + 20) #define TreeView_EnsureVisible(hwnd, hitem) \ (BOOL)SendMessage((hwnd), TVM_ENSUREVISIBLE, 0, (LPARAM)(HTREEITEM)(hitem)) #define TVM_SORTCHILDRENCB (TV_FIRST + 21) #define TreeView_SortChildrenCB(hwnd, psort, recurse) \ (BOOL)SendMessage((hwnd), TVM_SORTCHILDRENCB, (WPARAM)recurse, \ (LPARAM)(LPTV_SORTCB)(psort)) typedef int (CALLBACK *PFNTVCOMPARE)(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort); typedef struct _TV_SORTCB { HTREEITEM hParent; PFNTVCOMPARE lpfnCompare; LPARAM lParam; } TV_SORTCB, FAR *LPTV_SORTCB; // common notificaton structure for WM_NOTIFY sent to parent // some fields are only valid on some notify messages typedef struct _NM_TREEVIEW { NMHDR hdr; UINT action; // notification specific action TV_ITEM itemOld; TV_ITEM itemNew; POINT ptDrag; } NM_TREEVIEW, FAR *LPNM_TREEVIEW; #define TVN_SELCHANGING (TVN_FIRST-1) #define TVN_SELCHANGED (TVN_FIRST-2) // lParam -> NM_TREEVIEW // NM_TREEVIEW.itemNew.hItem & NM_TREEVIEW.itemNew.lParam are valid // NM_TREEVIEW.itemOld.hItem & NM_TREEVIEW.itemOld.lParam are valid // NM_TREEVIEW.action is a TVE_ value indicating how the selcection changed // TVN_SELCHANGING & TVN_SELCHANGED action values #define TVC_UNKNOWN 0x0000 #define TVC_BYMOUSE 0x0001 #define TVC_BYKEYBOARD 0x0002 #define TVN_GETDISPINFO (TVN_FIRST-3) #define TVN_SETDISPINFO (TVN_FIRST-4) // lParam -> TV_DISPINFO structure // TV_DISPINFO.item.hItem & TV_DISPINFO.item.lParam are valid typedef struct _TV_DISPINFO { NMHDR hdr; TV_ITEM item; } TV_DISPINFO; #define TVN_ITEMEXPANDING (TVN_FIRST-5) #define TVN_ITEMEXPANDED (TVN_FIRST-6) // lParam -> NM_TREEVIEW // NM_TREEVIEW.itemNew.hItem & NM_TREEVIEW.itemNew.state & NM_TREEVIEW.itemNew.lParam are valid // NM_TREEVIEW.action is TVE_ action and flags #define TVN_BEGINDRAG (TVN_FIRST-7) #define TVN_BEGINRDRAG (TVN_FIRST-8) // lParam -> NM_TREEVIEW // NM_TREEVIEW.itemNew.hItem & NM_TREEVIEW.itemNew.lParam are valid // NM_TREEVIEW.ptDrag is start of drag in client coords #define TVN_DELETEITEM (TVN_FIRST-9) // lParam -> NM_TREEVIEW // NM_TREEVIEW.itemOld.hItem & NM_TREEVIEW.itemOld.lParam are valid #define TVN_BEGINLABELEDIT (TVN_FIRST-10) #define TVN_ENDLABELEDIT (TVN_FIRST-11) // lParam -> NM_TREEVIEW // TV_DISPINFO.item.hItem & TV_DISPINFO.item.state & TV_DISPINFO.item.lParam are valid #define TVN_KEYDOWN (TVN_FIRST-12) // lParam -> TV_KEYDOWN typedef struct _TV_KEYDOWN { NMHDR hdr; WORD wVKey; UINT flags; } TV_KEYDOWN; //============================================================================ // // Class name: SysTabControl (WC_TABCONTROL) // #ifdef WIN32 #define WC_TABCONTROL "SysTabControl32" #else #define WC_TABCONTROL "SysTabControl" #endif // window styles to control tab control behavior #define TCS_FORCEICONLEFT 0x0010 // 0nly for fixed width mode #define TCS_FORCELABELLEFT 0x0020 // 0nly for fixed width mode #define TCS_SHAREIMAGELISTS 0x0040 #define TCS_TABS 0x0000 // default #define TCS_BUTTONS 0x0100 #define TCS_SINGLELINE 0x0000 // default #define TCS_MULTILINE 0x0200 #define TCS_RIGHTJUSTIFY 0x0000 // default #define TCS_FIXEDWIDTH 0x0400 #define TCS_RAGGEDRIGHT 0x0800 #define TCS_FOCUSONBUTTONDOWN 0x1000 #define TCS_OWNERDRAWFIXED 0x2000 #define TCS_TOOLTIPS 0x4000 #define TCS_FOCUSNEVER 0x8000 #define TCM_FIRST 0x1300 // Tab Control messages // COLORREF TabCtrl_GetBkColor(HWND hwnd); #define TCM_GETBKCOLOR (TCM_FIRST + 0) #define TabCtrl_GetBkColor(hwnd) \ (COLORREF)SendMessage((hwnd), TCM_GETBKCOLOR, 0, 0L) // BOOL TabCtrl_SetBkColor(HWND hwnd, COLORREF clrBk); #define TCM_SETBKCOLOR (TCM_FIRST + 1) #define TabCtrl_SetBkColor(hwnd, clrBk) \ (BOOL)SendMessage((hwnd), TCM_SETBKCOLOR, 0, (LPARAM)(COLORREF)(clrBk)) // HIMAGELIST TabCtrl_GetImageList(HWND hwnd); #define TCM_GETIMAGELIST (TCM_FIRST + 2) #define TabCtrl_GetImageList(hwnd) \ (HIMAGELIST)SendMessage((hwnd), TCM_GETIMAGELIST, 0, 0L) // this returns the old image list (null if no previous) // BOOL TabCtrl_SetImageList(HWND hwnd, HIMAGELIST himl); #define TCM_SETIMAGELIST (TCM_FIRST + 3) #define TabCtrl_SetImageList(hwnd, himl) \ (HIMAGELIST)SendMessage((hwnd), TCM_SETIMAGELIST, 0, (LPARAM)(UINT)(HIMAGELIST)(himl)) // int TabCtrl_GetItemCount(HWND hwnd); #define TCM_GETITEMCOUNT (TCM_FIRST + 4) #define TabCtrl_GetItemCount(hwnd) \ (int)SendMessage((hwnd), TCM_GETITEMCOUNT, 0, 0L) // TabView Item structure #define TCIF_TEXT 0x0001 // TabView mask flags #define TCIF_IMAGE 0x0002 #define TCIF_PARAM 0x0008 typedef struct _TC_ITEMHEADER { UINT mask; // TCIF_ bits UINT lpReserved1; UINT lpReserved2; LPSTR pszText; int cchTextMax; int iImage; } TC_ITEMHEADER; typedef struct _TC_ITEM { // This block must be identical to TC_TEIMHEADER UINT mask; // TCIF_ bits UINT lpReserved1; UINT lpReserved2; LPSTR pszText; int cchTextMax; int iImage; LPARAM lParam; } TC_ITEM; // BOOL TabCtrl_GetItem(HWND hwnd, int iItem, TC_ITEM FAR* pitem); #define TCM_GETITEM (TCM_FIRST + 5) #define TabCtrl_GetItem(hwnd, iItem, pitem) \ (BOOL)SendMessage((hwnd), TCM_GETITEM, (WPARAM)(int)iItem, (LPARAM)(TC_ITEM FAR*)(pitem)) // BOOL TabCtrl_SetItem(HWND hwnd, int iItem, TC_ITEM FAR* pitem); #define TCM_SETITEM (TCM_FIRST + 6) #define TabCtrl_SetItem(hwnd, iItem, pitem) \ (BOOL)SendMessage((hwnd), TCM_SETITEM, (WPARAM)(int)iItem, (LPARAM)(TC_ITEM FAR*)(pitem)) // int TabCtrl_InsertItem(HWND hwnd, int iItem, const TC_ITEM FAR* pitem); #define TCM_INSERTITEM (TCM_FIRST + 7) #define TabCtrl_InsertItem(hwnd, iItem, pitem) \ (int)SendMessage((hwnd), TCM_INSERTITEM, (WPARAM)(int)iItem, (LPARAM)(const TC_ITEM FAR*)(pitem)) // Deletes the specified item along with all its subitems. // // BOOL TabCtrl_DeleteItem(HWND hwnd, int i); #define TCM_DELETEITEM (TCM_FIRST + 8) #define TabCtrl_DeleteItem(hwnd, i) \ (BOOL)SendMessage((hwnd), TCM_DELETEITEM, (WPARAM)(int)(i), 0L) // BOOL TabCtrl_DeleteAllItems(HWND hwnd); #define TCM_DELETEALLITEMS (TCM_FIRST + 9) #define TabCtrl_DeleteAllItems(hwnd) \ (BOOL)SendMessage((hwnd), TCM_DELETEALLITEMS, 0, 0L) // Rectangle bounding all or part of item, based on code. Rect is returned in view coords // BOOL TabCtrl_GetItemRect(HWND hwndTC, int i, RECT FAR* prc); #define TCM_GETITEMRECT (TCM_FIRST + 10) #define TabCtrl_GetItemRect(hwnd, i, prc) \ (BOOL)SendMessage((hwnd), TCM_GETITEMRECT, (WPARAM)(int)(i), (LPARAM)(RECT FAR*)(prc)) // BOOL TabCtrl_GetCurSel(HWND hwndTC); #define TCM_GETCURSEL (TCM_FIRST + 11) #define TabCtrl_GetCurSel(hwnd) \ (int)SendMessage((hwnd), TCM_GETCURSEL, 0, 0) #define TCM_SETCURSEL (TCM_FIRST + 12) #define TabCtrl_SetCurSel(hwnd, i) \ (int)SendMessage((hwnd), TCM_SETCURSEL, (WPARAM)i, 0) // ItemHitTest flag values #define TCHT_NOWHERE 0x0001 #define TCHT_ONITEMICON 0x0002 #define TCHT_ONITEMLABEL 0x0004 #define TCHT_ONITEM (TCHT_ONITEMICON | TCHT_ONITEMLABEL) typedef struct _TC_HITTESTINFO { POINT pt; // in UINT flags; // out } TC_HITTESTINFO, FAR * LPTC_HITTESTINFO; // int TabCtrl_HitTest(HWND hwndTC, TC_HITTESTINFO FAR* pinfo); #define TCM_HITTEST (TCM_FIRST + 13) #define TabCtrl_HitTest(hwndTC, pinfo) \ (int)SendMessage((hwndTC), TCM_HITTEST, 0, (LPARAM)(TC_HITTESTINFO FAR*)(pinfo)) // Set the size of extra byte (abExtra[]) for each item. #define TCM_SETITEMEXTRA (TCM_FIRST + 14) #define TabCtrl_SetItemExtra(hwndTC, cb) \ (BOOL)SendMessage((hwndTC), TCM_SETITEMEXTRA, (WPARAM)(cb), 0L) // get/set text and textbk color for text drawing. these override // the standard window/windowtext settings. they do NOT override // when drawing selected text. // COLORREF TabCtrl_GetTextColor(HWND hwnd); #define TCM_GETTEXTCOLOR (TCM_FIRST + 35) #define TabCtrl_GetTextColor(hwnd) \ (COLORREF)SendMessage((hwnd), TCM_GETTEXTCOLOR, 0, 0L) // BOOL TabCtrl_SetTextColor(HWND hwnd, COLORREF clrText); #define TCM_SETTEXTCOLOR (TCM_FIRST + 36) #define TabCtrl_SetTextColor(hwnd, clrText) \ (BOOL)SendMessage((hwnd), TCM_SETTEXTCOLOR, 0, (LPARAM)(COLORREF)(clrText)) // COLORREF TabCtrl_GetTextBkColor(HWND hwnd); #define TCM_GETTEXTBKCOLOR (TCM_FIRST + 37) #define TabCtrl_GetTextColor(hwnd) \ (COLORREF)SendMessage((hwnd), TCM_GETTEXTCOLOR, 0, 0L) // BOOL TabCtrl_SetTextBkColor(HWND hwnd, COLORREF clrTextBk); #define TCM_SETTEXTBKCOLOR (TCM_FIRST + 38) #define TabCtrl_SetTextBkColor(hwnd, clrTextBk) \ (BOOL)SendMessage((hwnd), TCM_SETTEXTBKCOLOR, 0, (LPARAM)(COLORREF)(clrTextBk)) #define TCM_ADJUSTRECT (TCM_FIRST + 40) #define TabCtrl_AdjustRect(hwnd, bLarger, prc) \ (void)SendMessage(hwnd, TCM_ADJUSTRECT, (WPARAM)(BOOL)bLarger, (LPARAM)(RECT FAR *)prc) #define TCM_SETITEMSIZE (TCM_FIRST + 41) #define TabCtrl_SetItemSize(hwnd, x, y) \ (DWORD)SendMessage((hwnd), TCM_SETITEMSIZE, 0, MAKELPARAM(x,y)) #define TCM_REMOVEIMAGE (TCM_FIRST + 42) #define TabCtrl_RemoveImage(hwnd, i) \ (void)SendMessage((hwnd), TCM_REMOVEIMAGE, i, 0L) #define TCM_SETPADDING (TCM_FIRST + 43) #define TabCtrl_SetPadding(hwnd, cx, cy) \ (void)SendMessage((hwnd), TCM_SETPADDING, 0, MAKELPARAM(cx, cy)) #define TCM_GETROWCOUNT (TCM_FIRST + 44) #define TabCtrl_GetRowCount(hwnd) \ (int)SendMessage((hwnd), TCM_GETROWCOUNT, 0, 0L) /* all params are NULL * returns the hwnd for tooltips control or NULL */ #define TCM_GETTOOLTIPS (TCM_FIRST + 45) #define TabCtrl_GetToolTips(hwnd) \ (HWND)SendMessage((hwnd), TCM_GETTOOLTIPS, 0, 0L) /* wParam: HWND of ToolTips control to use * lParam unused */ #define TCM_SETTOOLTIPS (TCM_FIRST + 46) #define TabCtrl_SetToolTips(hwnd, hwndTT) \ (void)SendMessage((hwnd), TCM_SETTOOLTIPS, (WPARAM)hwndTT, 0L) // this returns the item with the current focus.. which might not be // the currently selected item, if the user is in the process of selecting a new // item // BOOL TabCtrl_GetCurFocus(HWND hwndTC); #define TCM_GETCURFOCUS (TCM_FIRST + 47) #define TabCtrl_GetCurFocus(hwnd) \ (int)SendMessage((hwnd), TCM_GETCURFOCUS, 0, 0) // TabView notification codes #define TCN_KEYDOWN (TCN_FIRST - 0) typedef struct _TC_KEYDOWN { NMHDR hdr; WORD wVKey; UINT flags; } TC_KEYDOWN; // selection has changed #define TCN_SELCHANGE (TCN_FIRST - 1) // selection changing away from current tab // return: FALSE to continue, or TRUE to not change #define TCN_SELCHANGING (TCN_FIRST - 2) /*/////////////////////////////////////////////////////////////////////////*/ // Animate control #ifndef NOANIMATE /* // OVERVIEW: // // The Animte control is a simple animation control, you can use it to // have animaed controls in dialogs. // // what it animates are simple .AVI files from a resource. // a simple AVI is a uncompressed or RLE compressed AVI file. // // the .AVI file must be placed in the resource with a type of "AVI" // // example: // // myapp.rc: // MyAnimation AVI foobar.avi // must be simple RLE avifile // // myapp.c: // Animate_Open(hwndA, "MyAnimation"); // open the resource // Animate_Play(hwndA, 0, -1, -1); // play from start to finish and repeat */ #ifdef WIN32 #define ANIMATE_CLASS "SysAnimate32" #else #define ANIMATE_CLASS "SysAnimate" #endif /* STYLE BITS */ #define ACS_CENTER 0x0001 // center animation in window #define ACS_TRANSPARENT 0x0002 // make animation transparent. #define ACS_AUTOPLAY 0x0004 // start playing on open /* MESSAGES */ #define ACM_OPEN (WM_USER+100) /* wParam: not used, 0 // lParam: name of resource/file to open // return: bool */ #define ACM_PLAY (WM_USER+101) /* wParam: repeat count -1 = repeat forever. // lParam: LOWORD=frame start 0 = first frame. // HIWORD=play end -1 = last frame. // return: bool */ #define ACM_STOP (WM_USER+102) /* wParam: not used // lParam: not used // return: bool */ /* notify codes, sent via WM_COMMAND */ #define ACN_START 1 // file has started playing #define ACN_STOP 2 // file has stopped playing /* HELPER MACROS */ #define Animate_Create(hwndP, id, dwStyle, hInstance) \ CreateWindow(ANIMATE_CLASS, NULL, \ dwStyle, 0, 0, 0, 0, hwndP, (HMENU)(id), hInstance, NULL) #define Animate_Open(hwnd, szName) (BOOL)SendMessage(hwnd, ACM_OPEN, 0, (LPARAM)(LPSTR)(szName)) #define Animate_Play(hwnd, from, to, rep) (BOOL)SendMessage(hwnd, ACM_PLAY, (WPARAM)(UINT)(rep), (LPARAM)MAKELONG(from, to)) #define Animate_Stop(hwnd) (BOOL)SendMessage(hwnd, ACM_STOP, 0, 0) #define Animate_Close(hwnd) Animate_Open(hwnd, NULL) #define Animate_Seek(hwnd, frame) Animate_Play(hwnd, frame, frame, 0) #endif /* NOANIMATE */ // BUGBUG: move some place else #ifdef __cplusplus } /* end of 'extern "C" {' */ #endif #endif /* _INC_COMMCTRL */