GetMenu

Kategorie: Objekte / Menü
Ab Engineversion: 4.9.1.0 GWE

Beschreibung

Liefert die ID des Menüs, falls das Objekt ein Menü geöffnet hat. Normalerweise ist das die ID des Menüsymbols (idSymbol), wenn nicht bei CreateMenu explizit eine andere Menü-ID als idMenuID angegeben wurde. 0 bei keinem Menü oder bei keinem Symbol.

Syntax

id GetMenu (object pObj);

Parameter

pObj:
Menüobjekt

Anmerkung

Ein Rückgabewert von -1 bedeutet, dass kein gültiges Symbol ermittelt werden konnte. Dies kann z.B. dann auftreten, wenn bei einem globalen Aufruf kein Objektzeiger an die Funktion übergeben wurde. Engineinterne Menüs (Kaufen, Verkaufen, etc.) geben keine gültigen IDs zurück.

Beispiel

/* Wird bei klick auf Spezial aufgerufen */
protected func ControlSpecial()
{
  /* überhaupt ein Menü offen und ein Symbol angegeben? */
  if(GetMenu())
    /* Mutieren */
    ChangeDef(GetMenu());
  return(1);
}
Zu einem Objekt mutieren, welches vom Symbol repräsentiert wird.
Siehe auch: CloseMenu, CreateMenu, SetMenuDecoration, SetMenuTextProgress
wipfmetz, August 2002