Compartir a través de


Función SetMenu (winuser.h)

Asigna un nuevo menú a la ventana especificada.

Sintaxis

BOOL SetMenu(
  [in]           HWND  hWnd,
  [in, optional] HMENU hMenu
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana a la que se va a asignar el menú.

[in, optional] hMenu

Tipo: HMENU

Identificador del nuevo menú. Si este parámetro es NULL, se quita el menú actual de la ventana.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La ventana se vuelve a dibujar para reflejar el cambio de menú. Se puede asignar un menú a cualquier ventana que no sea una ventana secundaria.

La función SetMenu reemplaza el menú anterior, si existe, pero no lo destruye. Una aplicación debe llamar a la función DestroyMenu para realizar esta tarea.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-menu-l1-1-3 (introducido en Windows 10, versión 10.0.14393)

Consulte también

Conceptual

DestroyMenu

GetMenu

Menús

Referencia