Función DeleteMenu (winuser.h)

Artículo
08/27/2023

Elimina un elemento del menú especificado. Si el elemento de menú abre un menú o submenú, esta función destruye el identificador del menú o submenú y libera la memoria utilizada por el menú o submenú.

Sintaxis

BOOL DeleteMenu(
  [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ú. La marca MF_BYCOMMAND es la predeterminada si no se especifica la marca MF_BYCOMMAND ni MF_BYPOSITION .
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 siempre que cambie un menú, si el menú está en una ventana mostrada.

Ejemplos

Para obtener un ejemplo, vea Ejemplo de un Visor de Portapapeles.

Requisitos


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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-menu-l1-1-0 (introducido en Windows 8)