|
|
//////////////////////////////////////////////////////////////////
// File : ddbtn.h ( DropDownButton)
// Purpose : new control for drop down button
//
//
// Copyright(c) 1991-1997, Microsoft Corp. All rights reserved
//
// History :970905 Started
//////////////////////////////////////////////////////////////////
//----------------------------------------------------------------
//
//Detail description
//
//----------------------------------------------------------------
#if 0
This Drop down Button(DDButton) control has 2 mode, 1. Separated Button. 2. No Separated Button. Normal case is Separated button. like Word or Excel's common interface, Icon button and Triangle button. If DDBS_NOSEPARATED is NOT set, you can see below face. this is 1.case. Figure 1. normal face. left right +-----------+-------+ | | | | | ##### | | | ### | | | # | | | | +-----------+-------+ you can set Text or Icon to left button, with DDButton_SetText() or DDButton_SetIcon(). you can set Item list to DDButton with DDButton_InsertItem() or DDButton_AddItem(). If some item are inserted, and you can see drop down menu if you clicked the "right" button.
Figure 2. drop down menu has shown.
left button right button +-----------+-------+ | | | | | ##### | | | ### | | | # | | | | +-----------+-------+---+ | I t e m 0 | | I t e m 1 | |V I t e m 2 | | I t e m 3 | | I t e m 4 | | I t e m 5 | | I t e m 6 | +-----------------------+ "V" means current selected Item. If you Call DDButton_GetCurSel(), you can get current selected item. in this case, you can get 2 as integer value. If you selected specified item in the menu, not current selected item, you can get WM_COMMAND in Parent window procedure with, "DDBN_SELCHANGE".
you can also set current selected item by DDButton_SetCurSel(). If you click "left button", current selected item index is incremented. in this case, if you click "left button", you can receive DDBN_CLICKED notify, and AFTER that, you receive DDBN_SELCHANGE. current selected index has changed to "3" and Before menu will be shown, you can receive WM_COMMAND with DDBN_DROPDOWN, and after menu has hidden, you can receive, DDBN_CLOSEUP notify.
If DDBS_NOSEPARATED is NOT set, you can see below face. Figure 3. with DDBS_NOSEPARATED style. +-------------------+ | | | ##### | | ### | | # | | | +-------------------+
This DDButton has this style, you can NOT receive DDBN_CLICKED. only DDBN_DROPDOWN, DDBN_CLOSEUP and DDBN_SELCHANGE will be sent.
#endif //if 0
#ifndef _DROP_DOWN_BUTTON_
#define _DROP_DOWN_BUTTON_
//----------------------------------------------------------------
//Drop Down Button Style
//----------------------------------------------------------------
#define DDBS_TEXT 0x0000 // Show Text as Button Face.
#define DDBS_ICON 0x0001 // Show Icon as Button Face.
#define DDBS_THINEDGE 0x0002 // Draw Thin Edge.
#define DDBS_FLAT 0x0004 // Flat style drop down button.
#define DDBS_NOSEPARATED 0x0010 // No separated button.
// when button was pushed, always drop down is shown.
//----------------------------------------------------------------
//Drop down Item's type mask.
//----------------------------------------------------------------
#define DDBF_TEXT 0x0000 //Only Unicode string.
#define DDBF_ICON 0x0001 //not used.
#define DDBF_SEPARATOR 0x0002 //not used.
//----------------------------------------------------------------
//Drop down Item structure
//----------------------------------------------------------------
#pragma pack(1)
typedef struct tagDDBITEM { INT cbSize; // DDBITEM structure size is needed.
UINT mask; // reserved. not used.
LPWSTR lpwstr; // drop down item string.
HICON hIcon; //reserved. not used.
LPARAM lParam; //reserved. not used.
}DDBITEM, *LPDDBITEM;#pragma pack()
//----------------------------------------------------------------
//Drop Down Button Message
//----------------------------------------------------------------
#define DDBM_ADDITEM (WM_USER + 100)
#define DDBM_INSERTITEM (WM_USER + 101)
#define DDBM_SETCURSEL (WM_USER + 102)
#define DDBM_GETCURSEL (WM_USER + 103)
#define DDBM_SETICON (WM_USER + 104)
#define DDBM_SETTEXT (WM_USER + 105)
#define DDBM_SETSTYLE (WM_USER + 106)
//----------------------------------------------------------------
//Drop Down Button Notify code.
//It is set to Parent window of Drop Down button as
//WM_COMMAND.
//----------------------------------------------------------------
//----------------------------------------------------------------
// Notify: DDBN_CLICKED
// When it comes?: If DDBS_NOSEPARATED was SET,this notify only come,
// when current selected item was change.
// If DDBS_NOSEPARATED was NOT set, when button was clicked, or menu item
// was changed, this notify come.
//----------------------------------------------------------------
//----------------------------------------------------------------
// Notify: DDBN_SELCHANGED
// When it comes?: If menu item was selected, this notify come.
// if DDBS_NOSEPARATED style is NOT set,
// when right button(Separated right button, not a mouse)
// was clicked, this notify comes, after DDBN_CLICKED notify.
//----------------------------------------------------------------
//----------------------------------------------------------------
// Notify: DDBN_DROPDOWN
// When it comes?: If dropdown menu was shown, this notify come.
//----------------------------------------------------------------
//----------------------------------------------------------------
// Notify: DDBN_CLOSEUP
// When it comes?: If dropdown menu was hidden, this notify come.
//----------------------------------------------------------------
#define DDBN_CLICKED 0
#define DDBN_SELCHANGE 1
#define DDBN_DROPDOWN 2
#define DDBN_CLOSEUP 3
//----------------------------------------------------------------
//Drop Down Button Message Macro.
//----------------------------------------------------------------
//////////////////////////////////////////////////////////////////
// Function : DDButton_AddItem
// Type : INT
// Purpose : add dropdown item.
// Args : HWND hwndCtrl: DDButton window handle
// : LPDDBITEM lpDDBItem:
// Remarks : when it was called,
// : lpDDBItem->lpwstr data is copyed to DDButton's
// : internal data area.
// Return :
//////////////////////////////////////////////////////////////////
#define DDButton_AddItem(hwndCtrl, pddbItem) \
((int)(DWORD)SendMessage((hwndCtrl), DDBM_ADDITEM, 0, (LPARAM)pddbItem))
//////////////////////////////////////////////////////////////////
// Function : DDButton_InsertItem
// Type : INT
// Purpose : insert dropdown item.
// Args : HWND hwndCtrl: DDButton window handle
// : INT index:
// : LPDDBITEM lpDDBItem:
// Remarks : when it was called,
// : lpDDBItem->lpwstr data is copyed to DDButton's
// : internal data area.
// Return :
//////////////////////////////////////////////////////////////////
#define DDButton_InsertItem(hwndCtrl, index, pddbItem) \
((int)(DWORD)SendMessage((hwndCtrl), DDBM_INSERTITEM, (WPARAM)(index), (LPARAM)(pddbItem)))
//////////////////////////////////////////////////////////////////
// Function : DDButton_SetCurSel
// Type : INT
// Purpose : Set current item by specified index.
// Args : HWND hwndCtrl: DDButton window handle
// : INT index: Select index.
// Return :
//////////////////////////////////////////////////////////////////
#define DDButton_SetCurSel(hwndCtrl, index) \
((int)(DWORD)SendMessage((hwndCtrl), DDBM_SETCURSEL, (WPARAM)(index), (LPARAM)0))
//////////////////////////////////////////////////////////////////
// Function : DDButton_GetCurSel
// Type : INT
// Purpose :
// Args : HWND hwndCtrl: DDButton window handle
// Return : current selected item index.
//////////////////////////////////////////////////////////////////
#define DDButton_GetCurSel(hwndCtrl) \
((int)(DWORD)SendMessage((hwndCtrl), DDBM_GETCURSEL, (WPARAM)0, (LPARAM)0))
//////////////////////////////////////////////////////////////////
// Function : DDButton_SetIcon
// Type : INT
// Purpose : Set button image as icon.
// Args : HWND hwndCtrl: DDButton window handle.
// : HICON hIcon: Icon handle.
// Remarks : DDBS_ICON style must be set.
// Return :
//////////////////////////////////////////////////////////////////
#define DDButton_SetIcon(hwndCtrl, hIcon) \
((int)(DWORD)SendMessage((hwndCtrl), DDBM_SETICON, (WPARAM)hIcon, (LPARAM)0))
//////////////////////////////////////////////////////////////////
// Function : DDButton_SetText
// Type : INT
// Purpose : Set button image as icon.
// Args : HWND hwndCtrl: DDButton window handle.
// : LPWSTR lpsz: Unicode String pointer.
// Remarks :
// Return :
//////////////////////////////////////////////////////////////////
#define DDButton_SetText(hwndCtrl, lpsz) \
((int)(DWORD)SendMessage((hwndCtrl), DDBM_SETTEXT, (WPARAM)lpsz, (LPARAM)0))
//////////////////////////////////////////////////////////////////
// Function : DDButton_SetStyle
// Type : INT
// Purpose : Set Drop down button's style.
// Args : HWND hwndCtrl: DDButton window handle.
// : DWORD dwStyle: DDBS_XXXXX combination.
// Remarks :
// Return :
//////////////////////////////////////////////////////////////////
#define DDButton_SetStyle(hwndCtrl, dwStyle) \
((int)(DWORD)SendMessage((hwndCtrl), DDBM_SETSTYLE, (WPARAM)dwStyle, (LPARAM)0))
//////////////////////////////////////////////////////////////////
// Function : DDButton_CreateWindow
// Type : HWND
// Purpose : Opened API.
// : Create Drop Down Button.
// Args :
// : HINSTANCE hInst
// : HWND hwndParent
// : DWORD dwStyle DDBS_XXXXX combination.
// : INT wID Window ID
// : INT xPos
// : INT yPos
// : INT width
// : INT height
// Return :
// DATE : 970905
//////////////////////////////////////////////////////////////////
extern HWND DDButton_CreateWindow(HINSTANCE hInst, HWND hwndParent, DWORD dwStyle, INT wID, INT xPos, INT yPos, INT width, INT height);
#ifdef UNDER_CE // In Windows CE, all window classes are process global.
extern BOOL DDButton_UnregisterClass(HINSTANCE hInst);#endif // UNDER_CE
#endif //_DROP_DOWN_BUTTON_
|
