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