Find.Execute-Methode (Word)
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.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für