CodeEvent.StartPoint-Eigenschaft

Artikel
10/24/2012

Ruft die Position in der Quelldatei ab, die als Anfang des Codeereigniselements markiert ist.

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

Syntax

'Declaration
ReadOnly Property StartPoint As TextPoint

TextPoint StartPoint { get; }

property TextPoint^ StartPoint {
    TextPoint^ get ();
}

abstract StartPoint : TextPoint

function get StartPoint () : TextPoint

Eigenschaftswert

Typ: EnvDTE.TextPoint
Ein TextPoint-Objekt.

Hinweise

Die Position des Bearbeitungspunkts befindet sich unmittelbar hinter dem letzten Zeichen des Codeereigniselements (einschließlich aller Semikolons oder schließender bzw. trennender Syntaxelemente).Das Abrufen der Eigenschaft öffnet die Quelldatei implizit, wenn sie geöffnet werden kann.Einige Sprachen können jedoch nicht beliebige Dateien auf der Festplatte öffnen, sondern nur Dateien, die sich in gegenwärtig geöffneten Projektmappen befinden.

Hinweis
Die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. können nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben.Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. können nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben.Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die StartPoint-Eigenschaft verwendet wird.

So testen Sie diese Eigenschaft

Öffnen Sie das Zielprojekt, und wählen Sie das Codeereigniselement aus, indem Sie den Cursor auf das Ereignisobjekt setzen.
Führen Sie das Add-In aus.

public static void StartPoint(EnvDTE80.DTE2 dte)
{
    TextSelection objTextSel;
    EnvDTE80.CodeEvent codeEvent;
    objTextSel = (TextSelection)dte.ActiveDocument.Selection;
    codeEvent = (EnvDTE80.CodeEvent)objTextSel.ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);

    MessageBox.Show("\nStart point column number: " +
                    codeEvent.StartPoint.DisplayColumn, "Testing StartPoint Property");
}

.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.