Freigeben über


IVsExpansionSession-Schnittstelle

Stellt den Zustand eines neu eingefügten Codeausschnitt dar, der vom Benutzer bearbeitet wird.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop.8.0 (in Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntax

'Declaration
<GuidAttribute("3DFA7603-3B51-4484-81CD-FF1470123C7C")> _
<InterfaceTypeAttribute()> _
Public Interface IVsExpansionSession
[GuidAttribute("3DFA7603-3B51-4484-81CD-FF1470123C7C")]
[InterfaceTypeAttribute()]
public interface IVsExpansionSession
[GuidAttribute(L"3DFA7603-3B51-4484-81CD-FF1470123C7C")]
[InterfaceTypeAttribute()]
public interface class IVsExpansionSession
[<GuidAttribute("3DFA7603-3B51-4484-81CD-FF1470123C7C")>]
[<InterfaceTypeAttribute()>]
type IVsExpansionSession =  interface end
public interface IVsExpansionSession

Der IVsExpansionSession-Typ macht die folgenden Member verfügbar.

Methoden

  Name Beschreibung
Öffentliche Methode EndCurrentExpansion Wird aufgerufen, um das Ende des aktuellen Prozesses einfügungs Codeausschnitt an.
Öffentliche Methode GetDeclarationNode Ruft den Knoten Deklarationen für das angegebene Feld ab.
Öffentliche Methode GetEndSpan Gibt die Position zurück, an der das caretzeichen Bearbeiten platziert werden soll, wenn der Codeausschnitt in den Quellpuffer ein Commit ausgeführt wird.
Öffentliche Methode GetFieldSpan Ruft die Spanne (die Position und der Block) des angegebenen Felds ab.
Öffentliche Methode GetFieldValue Ruft den Wert des angegebenen Felds ab.
Öffentliche Methode GetHeaderNode Gibt einen Knoten vom Codeausschnitt <Header> tag zurück.
Öffentliche Methode GetSnippetNode Gibt einen Knoten vom Codeausschnitt <Snippet> tag zurück.
Öffentliche Methode GetSnippetSpan Ruft die Spanne des Codeausschnitts ab.
Öffentliche Methode GoToNextExpansionField Verschieben Sie die Markierung auf das nächste Feld in aufsteigender Reihenfolge.
Öffentliche Methode GoToPreviousExpansionField Verschieben Sie die Markierung auf das vorherige Feld in aufsteigender Reihenfolge.
Öffentliche Methode SetEndSpan Legt die Position fest, in der das Bearbeiten caretzeichen platziert werden soll, wenn der Codeausschnitt in den Quellpuffer ein Commit ausgeführt wird.
Öffentliche Methode SetFieldDefault Legt den Standardwert für das angegebene Feld festgelegt.

Zum Seitenanfang

Hinweise

Diese Schnittstelle stellt verschiedene nützliche Methoden, um den Codeausschnitt bearbeitungsmodus spezielle Unterstützung sowie den Codeausschnitt XML-Elemente zu erhalten.

Codeausschnitt-Bearbeitungsmodus

Nachdem ein Codeausschnitt im Quelldokument eingefügt wurde, ist ein spezieller Bearbeitungsmodus, der TAB-TASTE zwischen mehreren Feldern des Codeausschnitts unterstützt sowie aus den Listen mit den Werten ausgewählt werden können, die mit Feldern zugeordnet werden. Der spezielle Bearbeitungsmodus wird, wenn der Benutzer die EINGABETASTE oder ESC beendet. Wenn dieser spezielle Bearbeitungsmodus unterstützt wird, muss er vom Sprachdienst implementiert werden, der den Codeausschnitt unterstützt. Andernfalls sollte der Sprachdienst die EndCurrentExpansion-Methode für diese Schnittstelle aufrufen, um anzugeben, dass der Codeausschnitt akzeptiert wurde und den Ausschnitt nichts weiter verarbeitet werden muss.

Hinweise zur Implementierung

Diese Schnittstelle wird von derselben Entität IVsExpansion implementiert, die die Schnittstelle implementiert (die wiederum in einem IVsTextBuffer-Objekt implementiert wird).

Hinweise zu Aufrufern

Diese Schnittstelle wird von den folgenden Methoden zurückgegeben:

Die IVsExpansionSession-Schnittstelle wird verwendet, um den besonderen Bearbeitungsmodus des Ausschnitts zu implementieren und an den OnBeforeInsertion und OnAfterInsertion-Methode in der IVsExpansionClient-Schnittstelle übergeben.

Siehe auch

Referenz

Microsoft.VisualStudio.TextManager.Interop-Namespace