Funzione GetMenuItemInfoW (winuser.h)

Recupera informazioni su una voce di menu.

Sintassi

BOOL GetMenuItemInfoW(
  [in]      HMENU           hmenu,
  [in]      UINT            item,
  [in]      BOOL            fByPosition,
  [in, out] LPMENUITEMINFOW lpmii
);

Parameters

[in] hmenu

Tipo: HMENU

Handle del menu che contiene la voce di menu.

[in] item

Tipo: UINT

Identificatore o posizione della voce di menu per ottenere informazioni. Il significato di questo parametro dipende dal valore di fByPosition.

[in] fByPosition

Tipo: BOOL

Significato di Item. Se questo parametro è FALSE, Item è un identificatore di voce di menu. In caso contrario, si tratta di una posizione della voce di menu. Per altre informazioni, vedere Accesso a voci di menu a livello di codice .

[in, out] lpmii

Tipo: LPMENUITEMINFO

Puntatore a una struttura MENUITEMINFO che specifica le informazioni da recuperare e ricevere informazioni sulla voce di menu. Si noti che è necessario impostare il membro cbSize su sizeof(MENUITEMINFO) prima di chiamare questa funzione.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, usare la funzione GetLastError .

Osservazioni:

Per recuperare una voce di menu di tipo MFT_STRING, trovare prima le dimensioni della stringa impostando il membro dwTypeData di MENUITEMINFO su NULL e quindi chiamando GetMenuItemInfo. Il valore di cch+1 è la dimensione necessaria. Allocare quindi un buffer di questa dimensione, posizionare il puntatore al buffer in dwTypeData, incrementare cch di uno e quindi chiamare nuovamente GetMenuItemInfo per riempire il buffer con la stringa.

Se la voce di menu recuperata è di un altro tipo, GetMenuItemInfo imposta il membro dwTypeData su un valore il cui tipo è specificato dal membro fType fType e imposta cch su 0.

Esempi

Per un esempio, vedere Esempio di Owner-Drawn voci di menu.

Requisiti

Vedere anche

Concettuale

Menu

Riferimento

SetMenuItemInfo