IncrementalSearch.AppendCharAndSearch-Methode

Artikel
08/10/2011

Fügt dem ISearch-Muster ein Zeichen hinzu und führt eine Suche nach der neuen Zeichenfolge aus.

Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
Function AppendCharAndSearch ( _
    Character As Short _
) As vsIncrementalSearchResult

vsIncrementalSearchResult AppendCharAndSearch(
    short Character
)

vsIncrementalSearchResult AppendCharAndSearch(
    short Character
)

abstract AppendCharAndSearch : 
        Character:int16 -> vsIncrementalSearchResult

function AppendCharAndSearch(
    Character : short
) : vsIncrementalSearchResult

Parameter

Character
Typ: System.Int16
Eine kurze ganze Zahl, die in ein Unicode-Zeichen übersetzt wird.

Rückgabewert

Typ: EnvDTE80.vsIncrementalSearchResult
Eine vsIncrementalSearchResult-Enumeration.

Hinweise

AppendCharAndSearch fügt dem Suchmuster (siehe die Pattern-Eigenschaft) ein neues Zeichen hinzu und sucht anschließend in der aktuellen Richtung nach dem neuen Muster.

Wenn eine Übereinstimmung gefunden wird, wird die Editor-Auswahl zu dieser Übereinstimmung verschoben, und der Wert Found wird zurückgegeben.

Wenn keine Übereinstimmung gefunden wird, wird die Auswahl nicht geändert, und der Wert Failed wird zurückgegeben. An ein Suchmuster, mit dem ein Fehler zurückgegeben wurde, können keine neuen Zeichen angehängt werden. Um AppendCharAndSearch weiter ausführen zu können, muss das falsche Zeichen aus dem Muster entfernt werden.

Verwenden Sie die AscW()-Funktion, um den Unicode-Codepunkt für das Zeichen bereitzustellen.

Beispiele

Sub testIS()
    ' Set variables for text pane.
    Dim tp As EnvDTE80.TextPane2
    tp = CType(DTE.ActiveDocument.ActiveWindow.Object.ActivePane, _
    TextPane2)
    ' Start an incremental search forward from
    ' the current insertion point in the document.
    tp.IncrementalSearch.StartForward()
    ' Add the character "a" to the search pattern.
    tp.IncrementalSearch.AppendCharAndSearch(Asc("a"))
    ' Display the status of the search mode.
    'MsgBox("ISearch status: " & _
    tp.IncrementalSearch.IncrementalSearchModeOn.ToString)
    ' Perform incremental search using the pattern ("a").
    tp.IncrementalSearch.SearchWithLastPattern()
    ' After the search, exit incremental search mode.
    tp.IncrementalSearch.Exit()
End Sub

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.