WinTreeNodeSearch

Mit diesem Befehl wird in einem TreeView-Objekt oder einem TreeNode-Objekt (obj) nach einem bestimmten TreeNode gesucht.

info

Ist ein Referenzknoten (handle3) angegeben und wird das Ende der Unterelemente des übergebenen TreeView bzw. TreeNode-Objektes (obj) erreicht, beginnt die Suche von vorne, bis zum wieder erreichen des Referenzknotens.

Wird als Startobjekt (obj) ein TreeNode-Objekt übergeben, wird standardmäßig auch in höheren Baumebenen weiter gesucht.

Folgende Optionen (int2) können angegeben werden:

• _WinTreeNodeSearchCaption

  Vergleicht den Suchtext mit Caption-Eigenschaft des TreeNode-Objektes.

• _WinTreeNodeSearchCustom

  Vergleicht den Suchtext mit Custom-Eigenschaft des TreeNode-Objektes.

• _WinTreeNodeSearchCI

  Die Groß-/Kleinschreibung wird bei der Suche ignoriert.

• _WinTreeNodeSearchLike

  Führt einen Wildcard-Vergleich durch.

• _WinTreeNodeSearchLikeAuto

  Führt einen Wildcard-Vergleich durch. Der Suchtext wird automatisch mit *<Suchtext>* maskiert. Dies entspricht dem Verhalten im Designer.

• _WinTreeNodeSearchToken

  Führt eine begriffsorientierte Suche durch.

• _WinTreeNodeSearchRegEx

  Vergleich mittels regulären Ausdrücken.

• _WinTreeNodeSearchChildrenOnly

  Nur untergeordnete Knoten werden durchsucht.

• _WinTreeNodeSearchUp

  Die Suche wird nach oben durchgeführt.

• _WinTreeNodeSearchNoSelect

  Der gefundene Knoten wird nicht ausgewählt.

• _WinTreeNodeSearchStart

  Das Sucheingabefeld wird geöffnet. Hierbei wird das Sucheingabefeld mit dem Wert von (alpha1) vorbelegt. Für die Suche werden die restlichen angegebenen Optionen verwendet.

  info

  Die Prozedur bleibt beim Öffnen des Sucheingabefeldes nicht stehen. Dadurch ist der Rückgabewert der Funktion, bei Angabe dieser Option, immer 0.

Mehrere Optionen können miteinander kombiniert werden. Die Kombination erfolgt durch eine binäre ODER-Verknüpfung.

info

Die Optionen _WinTreeNodeSearchLike, _WinTreeNodeSearchLikeAuto, _WinTreeNodeSearchToken und _WinTreeNodeSearchRegEx können nicht miteinander kombiniert werden.

Ist weder _WinTreeNodeSearchCaption noch _WinTreeNodeSearchCustom gesetzt wird trotzdem das Ereignis EvtNodeSearch aufgerufen.

Wird die Option (int2) _WinTreeNodeSearchChildrenOnly angegeben, kann in (handle4) ein Referenzknoten angegeben werden. Dabei wird nur unterhalb des Knotens (obj) vom Referenzknoten (handle4) ausgehend gesucht. Ist bei der Option kein Referenzknoten (handle4) angegeben, wird ab dem ersten untergeordneten Knoten gesucht.

Resultat

Wird ein TreeNode gefunden, ist das Resultat der Deskriptor des TreeNode-Objektes. Wurde kein TreeNode gefunden, ist das Resultat 0. Zusätzlich sind die folgenden Fehlerwerte möglich:

• Fehlerwert: Bedeutung
• _ErrUnavailable: Der aktuell geprüfte Knoten wurde im Ereignis EvtNodeSearch gelöscht. Daher kann die Suche nicht fortgesetzt werden.
• _ErrRegExRuleSyntax: Syntaxfehler im regulären Ausdruck
• _ErrRegExBadEscapeSequence: Nicht aufgelöste Escape-Sequenz im Ausdruck
• _ErrRegExPropertySyntax: Ungültige Unicode-Eigenschaft
• _ErrRegExNotSupported: Verwendung einer Funktion, die nicht unterstützt wird
• _ErrRegExMismatchedParentheses: Falsch verschachtelte Klammern im regulären Ausdruck
• _ErrRegExNumberTooBig: Dezimalzahl zu groß
• _ErrRegExBadInterval: Fehler im {min,max} Intervall
• _ErrRegExMaxLtMin: Im Intervall {min,max} ist max kleiner als min
• _ErrRegExInvalidBackRef: Rückbezug auf eine nicht vorhandene Referenz
• _ErrRegExInvalidFlag: Ungültiger Modus
• _ErrRegExLookBehindLimit: Rückschau Ausdrücke müssen eine beschränkte maximale Länge haben
• _ErrRegExSetContainsString: Reguläre Ausdrücke können keine UnicodeSets mit Zeichenketten beinhalten
• _ErrRegExMissingCloseBracket: Fehlende schließende Klammer in einem Klammerausdruck
• _ErrRegExInvalidRange: In einer Zeichenmenge [x-y] ist x größer als y
• _ErrRegExStackOverflow: Stapelüberlauf in der Ablaufverfolgung des regulären Ausdrucks

Die Suche wird so lange durchgeführt, bis ein TreeNode gefunden, die Suche im Ereignis EvtNodeSearch mit dem Rückgabewert false abgebrochen oder das Startobjekt (obj) bzw. der Referenzknoten (handle4) bei _WinTreeNodeSearchChildrenOnly wieder erreicht wurde.

Beispiel:

// Findet alle untergeordneten TreeNodes, die mit '.doc' enden und ändert die Schriftart
for
{
  tFirst # true;
  tNodeFound # tNodeCurrent->WinTreeNodeSearch('*.doc', _WinTreeNodeSearchCaption | _WinTreeNodeSearchCI | _WinTreeNodeSearchLike | _WinTreeNodeSearchChildrenOnly | _WinTreeNodeSearchNoSelect);
  tNodeRef # tNodeFound;
}
loop tNodeFound # tNodeCurrent->WinTreeNodeSearch('*.doc', _WinTreeNodeSearchCaption | _WinTreeNodeSearchCI | _WinTreeNodeSearchLike | _WinTreeNodeSearchChildrenOnly | _WinTreeNodeSearchNoSelect, tNodeFound);
while (tNodeFound > 0 and (tNodeFound != tNodeRef or tFirst))
{
  tFirst # false;
  tNodeFound->wpIndexData(_WinFlagIndexFont) # sIndexHighlight;
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: In (obj) oder (handle3) wurde kein gültiger Deskriptor eines TreeView- oder TreeNode-Objektes übergeben. In (int2) ist _WinTreeNodeSearchChildrenOnly gesetzt und (handle3) ist kein untergeordnetes TreeNode-Objekt von (obj).
• _ErrValueInvalid: Es wurde eine ungültige Kombination an Optionen (int2) übergeben.