11.32 parsepath()

object parsepath
(
      string  ObjectName input
  { , object  Parent := null input }
  { , object  Dialog := null input }
  { , integer Index  := 0 input }
)

Parameter

string ObjectName input

Dieser Parameter gibt den Namen des gesuchten Objekts an.

Der im Parameter ObjectName angegebene Wert entspricht einem Suchpfad, der vom Objekt, welches im Parameter Parent angegeben ist, ausgeht. Ein Leerstring im Parameter ObjectName ("") entspricht dabei einem leeren Suchpfad.

object Parent := null input

Dieser Parameter bezeichnet den Vater des gesuchten Objekts. Wenn dieser Parameter angegeben ist, wird unterhalb dieses Objekts nach dem angegebenen Objekt gesucht. Wird für diesen Parameter das null-Objekt angegeben, so wird im angegebenen Dialog oder im aktuellen Dialog, wenn kein Dialog angegeben ist, nach dem Objekt gesucht. Wenn nach Ressourcen gesucht wird, muss dieser Parameter mit dem null-Objekt belegt sein.

Wird nach Funktionen in Applikationen gesucht, muss die Applikation angegeben werden.

object Dialog := null input

Dieser optionale Parameter bezeichnet den Dialog des gesuchten Objekts. Wenn dieser Parameter nicht angegeben wird, wird im aktuellen Dialog nach dem Objekt gesucht. Soll in einem Modul nach einem Objekt gesucht werden, so muss das entsprechende Modul in diesem Parameter angegeben werden.

integer Index := 0 input

Ist Index größer als 0, dann werden in den untergeordneten Kindern des Objekts alle Kinder gesucht auf die der entsprechende ObjectName passt. Der Index > 0 gibt der Funktion an, nach dem wievielten Vorkommen von ObjectName gesucht werden soll. Ist für diesen Index kein Kind vorhanden, dann wird null zurückgegeben.

Rückgabewert

ObjektID

Das gesuchte Objekt wird zurückgegeben.

null

Das angegebene Objekt wurde nicht gefunden oder der Name ist nicht eindeutig.

Das heißt, es gibt keins oder mehrere Objekte mit dem angegebenen Namen.

Beispiele

• Suchen im aktuellen Dialog nach der Farbe ROT

  Obj := parsepath("ROT");

• Suchen nach der Regel Test im Modul M1

  Obj := parsepath("Test", null, M1);

• Suchen nach dem Pushbutton OK im Fenster W1

  Obj := parsepath("OK", W1);

• Suchen nach der Funktion ApplFunc in der Applikation A1

  Obj := parsepath("ApplFunc", A1);

• Suchen nach dem I-ten Vorkommen von SubR im Fenster W

  dialog D
  window W
  {
    record R
    {
      record SubR {}
    }
    child groupbox G
    {
      record SubR {}
    }
    rule void DoSomething()
    {
      variable integer I := 1;
      variable object O := D;
      while (O) do
        O := parsepath("SubR", this, null, I);
        if O <> null then
          I := I + 1;
          print O;
        endif
      endwhile
    }
  }
  on dialog start
  {
    W:DoSomething();
  }

Siehe auch

Funktion DM_ParsePath im Handbuch „C-Schnittstelle - Funktionen“