WinTreeNodeSearch

obj `->` WinTreeNodeSearch(alpha1[, int2[, handle3]]) : handle

Knoten im Baum suchen

Details

obj: Startobjekt der Suche: TreeView - oder TreeNode -Objekt
alpha1: Suchtext
int2:
handle3: Referenzknoten für untergeordnete Suche
Resultat: handle > 0 Deskriptor des gefundenen Knotens = 0 Kein Knoten gefunden < 0 Fehlerwert
Siehe: Verwandte Befehle , TreeNode , TreeView , EvtNodeSearch , Blog

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.

obj -> WinTreeNodeSearch(alpha1[, int2[, handle3]]) : handle​

obj `->` WinTreeNodeSearch(alpha1[, int2[, handle3]]) : handle