Funzione LoadMenuA (winuser.h)

Articolo
03/13/2024

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 al modulo contenente la risorsa del menu da caricare.

[in] lpMenuName

Tipo: LPCTSTR

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

Valore restituito

Tipo: HMENU

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

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

Commenti

La funzione DestroyMenu viene usata, prima che un'applicazione venga chiusa, per eliminare il menu e liberare memoria occupata dal menu caricato.

Esempio

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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-menu-l1-1-3 (introdotta in Windows 10, versione 10.0.14393)

Vedi anche

Informazioni concettuali

LoadMenuIndirect

MAKEINTRESOURCE

Riferimento