DRAWITEMSTRUCT

La struttura DRAWITEMSTRUCT fornisce informazioni finestra proprietaria devono avere per determinare come dipingere un controllo dal proprietario o voce di menu. La finestra proprietaria del controllo dal proprietario o voce di menu riceve un puntatore a questa struttura come parametro lParam del messaggio WM_DRAWITEM.

 typedef struct tagDRAWITEMSTRUCT {/ / dis UINT CtlType; 
    UINT CtlID; 
    UINT itemID; 
    UINT itemAction; 
    UINT itemState; 
    HWND hwndItem; 
    HDC hDC; 
    RECT rcItem; 
    DWORD itemData; 
} DRAWITEMSTRUCT

Membri

CtlType
Specifica il tipo di controllo. Questo membro può essere uno dei seguenti valori:
Valore Significato
ODT_BUTTON Pulsante creati dal proprietario
ODT_COMBOBOX Casella combinata
ODT_LISTBOX Casella di riepilogo creata dal proprietario
ODT_LISTVIEW Controllo visualizzazione elenco
ODT_MENU Voce di menu creati dal proprietario
ODT_STATIC Controllo statico dal proprietario
ODT_TAB Controllo struttura a schede

CtlID
Specifica l'identificatore della casella combinata, casella di riepilogo, pulsante o controllo statico. Questo membro non viene usato per una voce di menu.
itemID
Specifica l'identificatore di oggetto dal menu per una voce di menu o l'indice dell'elemento in una casella di riepilogo o una casella combinata. Per una casella di riepilogo a vuoto o una casella combinata, questo membro può essere – 1. Ciò consente all'applicazione di disegnare il rettangolo di attivazione solo in base alle coordinate specificate dal membro rcItem anche se non ci sono articoli nel controllo. Ciò indica all'utente se la casella di riepilogo o una casella combinata ha lo stato attivo. Come i bit sono impostati nel membro itemAction determina se il rettangolo è da stabilire come se la casella di riepilogo o una casella combinata ha lo stato attivo.
itemAction
Specifica l'azione di disegno necessaria. Questo membro può essere uno o più dei seguenti valori:
Valore Significato
ODA_DRAWENTIRE L'intero controllo deve essere disegnato.
ODA_FOCUS Il controllo ha perso o guadagnato il focus della tastiera. Il membro itemState dovrebbe essere controllato per determinare se il controllo ha lo stato attivo.
ODA_SELECT Lo stato di selezione è cambiato. Il membro itemState dovrebbe essere controllato per determinare lo stato di selezione di nuove.

itemState
Specifica lo stato dell'elemento dopo l'attuale disegno azione si svolge. Questo membro può essere una combinazione dei seguenti valori:
Valore Significato
ODS_CHECKED La voce di menu è da controllare. Questo bit viene utilizzato solo in un menu.
ODS_COMBOBOXEDIT Il disegno si svolge nel campo di selezione (controllo edit) di una casella combinata.
ODS_DEFAULT L'elemento è l'elemento predefinito.
ODS_DISABLED L'articolo è da stabilire come disabilitato.
ODS_FOCUS L'elemento è stato attivo.
ODS_GRAYED L'elemento deve essere visualizzato in grigio. Questo bit viene utilizzato solo in un menu.
ODS_SELECTED Lo stato della voce di menu selezionato.

hwndItem
Handle per il controllo per caselle combinate, caselle di riepilogo, pulsanti e controlli statici. Per i menu, questo membro identifica il menu contenente l'elemento.
hDC
Handle per un contesto di periferica; questo contesto di periferica deve essere utilizzato quando si eseguono operazioni di disegno sul controllo.
rcItem
Specifica un rettangolo che definisce i limiti del controllo da trarre. Questo rettangolo è nel contesto di periferica specificato dal membro hDC . Il sistema automaticamente clip niente finestra proprietaria disegna nel contesto di periferica per pulsanti, caselle di riepilogo e caselle combinate, ma non clip voci di menu. Quando si disegna le voci di menu, la finestra proprietaria non deve disegnare fuori dai confini del rettangolo definito dal membro rcItem.
itemData
Specifica il valore definito dall'applicazione a 32 bit associato con la voce di menu. Per un controllo, questo parametro specifica il valore ultimo assegnato alla casella di riepilogo o una casella combinata dal messaggio LB_SETITEMDATA o CB_SETITEMDATA . Se la casella di riepilogo o una casella combinata ha lo stile LBS_HASSTRINGS o CBS_HASSTRINGS, questo valore è inizialmente pari a zero. In caso contrario, questo valore è inizialmente il valore passato a casella di riepilogo o una casella combinata nel parametro lParam di uno dei seguenti messaggi:

Se ctlType è ODT_BUTTON o ODT_STATIC, itemData è zero.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarata in winuser.

Vedi anche

Combo Boxes Overview, Combo Box strutture, CB_ADDSTRING, CB_INSERTSTRING, CB_SETITEMDATA, LB_ADDSTRING, LB_INSERTSTRING, LB_SETITEMDATA, WM_DRAWITEM

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index