winuser.h


RemoveMenu

Esta función es obsoleta, usar en su lugar DeleteMenu.

La función RemoveMenu borra un ítem de menú del menú especificado. Si el ítem de menú abre un menú emergente o un submenú, RemoveMenu no destruye el menú o su manipulador, permitiendo que se pueda volver a usar. Antes de llamar a esta función, la función GetSubMenu puede recuperar el manipulador del menú emergente o submenú.

Sintaxis

BOOL RemoveMenu(
    HMENU hMenu,     // manipulador de menú
    UINT uPosition,  // identificador o posción de ítem de menú
    UINT uFlags      // bandera de ítem de menú
   );

Parámetros

hMenu: identifica el menú a modificar.

uPosition: especifica el ítem de menú a borrar, tal como determine el parámetro uFlags.

uFlags: especifica el modo en que se interpreta el parámetro uPosition. Este parámetro debe ser uno de los siguientes valores:

Valor Significado
MF_BYCOMMAND Indica que el parámetro uPosition contiene el identificador del ítem de menú. La bandera MF_BYCOMMAND es el valor por defecto, si no se especifica ni MF_BYCOMMAND ni MF_BYPOSITION.
MF_BYPOSITION Indica que el parámetro uPosition contiene la posición relativa empezando en cero del ítem de menú.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

La aplicación debe llamar a la función DrawMenuBar cada vez que un menú cambie, tanto si el menú está en una ventana visible como si no.