winuser.h


InsertMenuItem

[Ahora soportado en Windows NT]

La función InsertMenuItem inserta un nuevo ítem de menú en la posición especificada de un menú.

Sintaxis

BOOL WINAPI InsertMenuItem(
    HMENU hMenu, 	
    UINT uItem, 	
    BOOL fByPosition, 	
    LPMENUITEMINFO lpmii	
   );

Parámetros

hMenu: manipulador de menú en el que se insertará el nuevo ítem.

uItem: identificador o posición del ítem de menú antes del que se insertará el nuevo ítem. El significado de este parámetro depende del valor de fByPosition.

fByPosition: valor que especifica el significado de uItem. Si este parámetro es FALSE, uItem es un identificador de menú. En caso contrario, es una posción de ítem de menú.

lpmii: puntero a una estructura MENUITEMINFO que contiene información sobre el nuevo í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 la función GetLastError.