Find.Execute-Methode (Word)

  • Artikel

Führt den angegebenen Suchvorgang aus. Gibt True zurück, wenn die Suche erfolgreich ist. Boolescher Wert.

Syntax

Ausdruck. Execute (FindText, MatchCase, MatchWholeWord, MatchWildcards, MatchSoundsLike, MatchAllWordForms, Forward, Wrap, Format, ReplaceWith, Replace, MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl)

Ausdruck: Erforderlich. Ein Ausdruck, der ein Find -Objekt zurückgibt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
FindText Optional Variant Der Text, nach dem gesucht werden soll. Verwenden Sie eine leere Zeichenfolge (""), wenn Sie nur nach Formatierungen suchen möchten. Sie können nach Sonderzeichen suchen, indem Sie entsprechende Zeichencodes angeben. Z. B. entspricht "p" einer Absatzmarke und "t" entspricht einem Tabstoppzeichen.
MatchCase Optional Variant True gibt an, dass beim Suchtext die Groß- und Kleinschreibung beachtet werden soll. Entspricht dem Kontrollkästchen Groß-und Kleinschreibung im Dialogfeld Suchen und Ersetzen (Menü Bearbeiten).
MatchWholeWord Optional Variant True, wenn der Suchvorgang nur ganze Wörter suchen soll, keinen Text, der Teil eines größeren Worts ist. Entspricht dem Kontrollkästchen Nur ganze Wörter suchen im Dialogfeld Suchen und Ersetzen.
MatchWildcards Optional Variant True, damit der Suchtext ein spezieller Suchoperator ist. Entspricht dem Kontrollkästchen Platzhalter verwenden im Dialogfeld Suchen und Ersetzen.
MatchSoundsLike Optional Variant True, damit der Suchvorgang Wörter sucht, die ähnlich klingen wie der Suchtext. Entspricht dem Kontrollkästchen Klingt wie im Dialogfeld Suchen und Ersetzen.
MatchAllWordForms Optional Variant True, damit der Suchvorgang alle Formen des Suchtextes sucht (z. B. findet "sitzen" auch die Formen "sitzt" und "saß"). Entspricht dem Kontrollkästchen Alle Wortformen suchen im Dialogfeld Suchen und Ersetzen.
Forward Optional Variant True, um vorwärts zu suchen (zum Dokumentende hin)
Wrap Optional Variant Steuert die weiteren Vorgänge, wenn die Suche nicht am Dokumentanfang begonnen wurde und das Dokumentende erreicht ist (oder umgekehrt, falls Forward auf False festgelegt ist). Dieses Argument steuert die Vorgänge auch, wenn eine Markierung oder ein Bereich vorgegeben ist, und der Suchtext dort nicht gefunden wird. Dies kann eine der WdFindWrap-Konstanten sein.
Format Optional Variant True, damit der Suchvorgang neben dem Suchtext nach Formatierungen oder anstelle des Suchtexts nach Formatierung sucht.
ReplaceWith Optional Variant Der neue Text. Wenn der durch das Argument Find angegebene Text gelöscht werden soll, verwenden Sie eine leere Zeichenfolge (""). Sonderzeichen und weiter gehende Suchkriterien werden auf dieselbe Weise angegeben wie für das Argument Find. Wenn Sie ein Grafikobjekt oder ein anderes Nicht-Text-Element als Ersatz angeben möchten, verschieben Sie das Element in die Zwischenablage und geben Sie "^c" für ReplaceWith an.
Replace Optional Variant Gibt die Anzahl der vorzunehmenden Ersetzungen an: eine, alle oder keine. Kann eine beliebige WdReplace-Konstante sein.
MatchKashida Optional Variant True, wenn Suchvorgänge Text zu übereinstimmenden Kashidas in einem arabischen Dokument zuordnen. Einige dieser Konstanten stehen Ihnen, abhängig von der ausgewählten oder installierten Sprachunterstützung (z. B. US-Englisch), möglicherweise nicht zur Verfügung.
MatchDiacritics Optional Variant True, wenn Suchvorgänge Text zu übereinstimmenden diakritischen Zeichen in einem Von-rechts-nach-links-Dokument zuordnen. Einige dieser Konstanten stehen Ihnen, abhängig von der ausgewählten oder installierten Sprachunterstützung (z. B. US-Englisch), möglicherweise nicht zur Verfügung.
MatchAlefHamza Optional Variant True, wenn Suchvorgänge Text zu übereinstimmenden Alef Hamzas in einem arabischen Dokument zuordnen. Einige dieser Konstanten stehen Ihnen, abhängig von der ausgewählten oder installierten Sprachunterstützung (z. B. US-Englisch), möglicherweise nicht zur Verfügung.
MatchControl Optional Variant True, wenn Suchvorgänge Text zu übereinstimmenden bidirektionalen Steuerzeichen in einem Von-rechts-nach-links-Dokument zuordnen. Einige dieser Konstanten stehen Ihnen, abhängig von der ausgewählten oder installierten Sprachunterstützung (z. B. US-Englisch), möglicherweise nicht zur Verfügung.
MatchPrefix Optional Variant True, um Wörter zuzuordnen, deren Anfang der Suchzeichenfolge entspricht. Entspricht dem Kontrollkästchen Präfix beachten im Dialogfeld Suchen und Ersetzen.
MatchSuffix Optional Variant True, um Wörter zuzuordnen, deren Ende der zu Suchzeichenfolge entspricht. Entspricht dem Kontrollkästchen Suffix beachten im Dialogfeld Suchen und Ersetzen.
MatchPhrase Optional Variant Durch True wird angegeben, dass alle Leerraum- und Steuerzeichen zwischen Wörtern ignoriert werden sollen.
IgnoreSpace Optional Variant True ignoriert alle Leerzeichen zwischen Wörtern. Entspricht dem Kontrollkästchen Leerzeichen ignorieren im Dialogfeld Suchen und Ersetzen.
IgnorePunct Optional Variant True ignoriert alle Interpunktionszeichen zwischen Wörtern. Entspricht dem Kontrollkästchen Interpunktion ignorieren im Dialogfeld Suchen und Ersetzen.

Rückgabewert

Boolesch

Bemerkungen

Wenn MatchWildcards auf True festgelegt ist, können Sie für das FindText-Argument Platzhalterzeichen und andere erweiterte Suchkriterien angeben. Das Argument "*(ung)" findet z. B. Wörter, die auf "ung" enden.

Wenn Sie nach einem Symbolzeichen suchen möchten, geben Sie ein Caret-Zeichen (^), eine Null (0) und dann den Zeichencode des Symbols ein. "^0150" entspricht z. B. einem Gedankenstrich (\endash ).

Wenn nicht anders festgelegt, wird dem Text im Feld Ersetzen durch das Format des im Dokument ersetzten Texts zugewiesen. Wenn Sie z. B. die Zeichenfolge "abc" durch "xyz" ersetzen, wird jedes Vorkommen von "abc" in Fettdruck durch die Zeichenfolge "xyz" in Fettdruck ersetzt.

Wenn MatchCaseauf False festgelegt ist, werden vorkommende Suchtexte, die Großbuchstaben enthalten, durch eine Großbuchstabenversion des Ersetzungstexts ersetzt, unabhängig von der Groß-/Kleinschreibung des Ersetzungstexts. Im vorherige Beispiel werden die Vorkommen von "ABC" durch "XYZ" ersetzt.

Beispiel

In diesem Beispiel wird der Begriff "library" gesucht und das nächste Vorkommen dieses Begriffs markiert.

With Selection.Find 
    .ClearFormatting 
    .MatchWholeWord = True 
    .MatchCase = False 
    .Execute FindText:="library" 
End With

In diesem Beispiel wird jedes Vorkommen des Worts "hi" im aktiven Dokument gefunden und durch "hello" ersetzt.

Set myRange = ActiveDocument.Content 
myRange.Find.Execute FindText:="hi", _ 
    ReplaceWith:="hello", Replace:=wdReplaceAll

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.