Compartir a través de


Función CreatePopupMenu (winuser.h)

Crea un menú desplegable, un submenú o un menú contextual. El menú está inicialmente vacío. Puede insertar o anexar elementos de menú mediante la función InsertMenuItem . También puede usar la función InsertMenu para insertar elementos de menú y la función AppendMenu para anexar elementos de menú.

Sintaxis

HMENU CreatePopupMenu();

Valor devuelto

Tipo: HMENU

Si la función se ejecuta correctamente, el valor devuelto es un identificador del menú recién creado.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La aplicación puede agregar el nuevo menú a un menú existente, o puede mostrar un menú contextual llamando a las funciones TrackPopupMenuEx o TrackPopupMenu .

Los recursos asociados a un menú asignado a una ventana se liberan automáticamente. Si el menú no está asignado a una ventana, una aplicación debe liberar recursos del sistema asociados al menú antes de cerrarse. Una aplicación libera recursos de menú mediante una llamada a la función DestroyMenu .

Ejemplos

Para obtener un ejemplo, vea Agregar líneas y gráficos a un menú.

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)

Consulte también

AppendMenu

Conceptual

CreateMenu

DestroyMenu

InsertMenu

InsertMenuItem

Menús

Referencia

SetMenu

TrackPopupMenu

TrackPopupMenuEx