CreateMenu

Kategorie: Objekte / Menü
Ab Engineversion: 4.6.5.0 CP

Beschreibung

Erzeugt ein benutzerdefiniertes Menü in pMenuObject. Menüeinträge müssen mit AddMenuItem hinzugefügt werden.

Syntax

int CreateMenu (id idSymbol, object pMenuObject, object pCommandObject, int iExtra, string szCaption, int iExtraData, int iStyle, bool fPermanent, id idMenuID);

Parameter

idSymbol:
Objektdefinition, deren Bild als Symbol verwendet wird
pMenuObject:
Objekt, in welchem das Menü geöffnet wird; kann bei lokalen Aufrufen Null sein
pCommandObject:
Erhält das Menükommando (siehe AddMenuItem); kann bei lokalen Aufrufen Null sein
iExtra:
Zusätzliche Information im Menü über das jeweils markierte Objekt. Die angegebenen C4MN_*-Konstanten sind seit 4.9.5.0 CE ebenfalls definiert und sollten statt der numerischen Werte verwendet werden:
Konstante Wert Effekt
C4MN_Extra_None 0 Nichts
C4MN_Extra_Components 1 Komponenten
C4MN_Extra_Value 2 Wert
C4MN_Extra_MagicValue 3 Wert als Magiewert. Dabei wird außerdem iExtraData als Vergleichswert angezeigt, z.B. "50/100".
C4MN_Extra_Info 4 Beschreibungstext sofort anzeigen
C4MN_Extra_ComponentsMagic 5 Komponenten und Magiewert
C4MN_Extra_LiveMagicValue 6 Wie C4MN_Extra_MagicValue, nur wird der Wert kontinuierlich aktualisiert.
C4MN_Extra_ComponentsLiveMagic 7 Wie C4MN_Extra_ComponentsMagic, nur wird der Wert kontinuierlich aktualisiert.
szCaption:
Bestimmt den angezeigten Menütext, wenn das Menü keine Einträge enthält
iExtraData:
Vergleichswert für iExtra 3
iStyle:
Aussehen des Menüs. Folgende Konstanten sind ab CR definiert:
Konstante Wert Aussehen
C4MN_Style_Normal 0 Normal
C4MN_Style_Context 1 Kontextmenü
C4MN_Style_Info 2 Infomenü
C4MN_Style_Dialog 3 Dialog
C4MN_Style_EqualItemHeight 128 Kann mit C4MN_Style_Dialog kombiniert werden: Alle Einträge mit Icon im Dialogmenü bekommen die gleiche Höhe.
fPermanent:
Das Menü bleibt geöffnet, wenn eine Auswahl getroffen wird.
idMenuID:
[opt] Wenn angegeben, wird diese ID als Menü-ID gesetzt. Die aktuelle Menü-ID wird zum Beispiel von GetMenu zurückgegeben.

Beispiel

siehe AddMenuItem
Siehe auch: AddMenuItem, CloseMenu, GetMenu, SelectMenuItem, SetMenuDecoration, SetMenuTextProgress
springer, April 2002
Sven2, März 2007