Condividi tramite

Funzione LoadMenuA (winuser.h)

  • Articolo

Carica la risorsa di menu specificata dal file eseguibile (.exe) associato a un'istanza dell'applicazione.

Sintassi

HMENU LoadMenuA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpMenuName
);

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle per il modulo contenente la risorsa di menu da caricare.

[in] lpMenuName

Tipo: LPCTSTR

Nome della risorsa di menu. In alternativa, questo parametro può essere costituito dall'identificatore della risorsa nella parola con ordine basso e zero nella parola di ordine elevato. Per creare questo valore, utilizzare la macro MAKEINTRESOURCE .

Valore restituito

Tipo: HMENU

Se la funzione ha esito positivo, il valore restituito è un handle per la risorsa di menu.

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

Osservazioni

La funzione DestroyMenu viene usata, prima della chiusura di un'applicazione, per eliminare definitivamente il menu e liberare memoria occupata dal menu caricato.

Esempi

Per un esempio, vedere Visualizzazione di un menu di scelta rapida

Nota

L'intestazione winuser.h definisce LoadMenu come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione winuser.h (include Windows.h)
libreria User32.lib
dll User32.dll
set di API ext-ms-win-ntuser-menu-l1-1-3 (introdotto in Windows 10, versione 10.0.14393)

Vedere anche

concettuale

LoadMenuIndirect

MAKEINTRESOURCE

menu

riferimento