Compartir a través de


Función RemoveMenu (winuser.h)

Elimina un elemento de menú o separa un submenú del menú especificado. Si el elemento de menú abre un menú desplegable o submenú, RemoveMenu no destruye el menú ni su identificador, lo que permite reutilizar el menú. Antes de llamar a esta función, la función GetSubMenu debe recuperar un identificador en el menú desplegable o submenú.

Sintaxis

BOOL RemoveMenu(
  [in] HMENU hMenu,
  [in] UINT  uPosition,
  [in] UINT  uFlags
);

Parámetros

[in] hMenu

Tipo: HMENU

Identificador del menú que se va a cambiar.

[in] uPosition

Tipo: UINT

Elemento de menú que se va a eliminar, determinado por el parámetro uFlags .

[in] uFlags

Tipo: UINT

Indica cómo se interpreta el parámetro uPosition . Este parámetro puede ser uno de los siguientes valores.

Value Significado
MF_BYCOMMAND
0x00000000L
Indica que uPosition proporciona el identificador del elemento de menú. Si no se especifica la marca MF_BYCOMMAND ni MF_BYPOSITION , la marca de MF_BYCOMMAND es la marca predeterminada.
MF_BYPOSITION
0x00000400L
Indica que uPosition proporciona la posición relativa de base cero del elemento de menú.

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 aplicación debe llamar a la función DrawMenuBar cada vez que cambia un menú, si el menú está en una ventana mostrada.

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-0 (introducido en Windows 8)

Consulte también

Conceptual

CreatePopupMenu

DeleteMenu

DrawMenuBar

GetSubMenu

Menús

Referencia