VirtualPoint-Schnittstelle

Ermöglicht das Bearbeiten von Text, der sich außerhalb des rechten Randes (des linken Randes unter bidirektionalem Windows) des Textdokuments befindet.

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

Syntax

'Declaration
<GuidAttribute("42320454-626C-4DD0-9ECB-357C4F1966D8")> _
Public Interface VirtualPoint _
    Inherits TextPoint
[GuidAttribute("42320454-626C-4DD0-9ECB-357C4F1966D8")]
public interface VirtualPoint : TextPoint
[GuidAttribute(L"42320454-626C-4DD0-9ECB-357C4F1966D8")]
public interface class VirtualPoint : TextPoint
[<GuidAttribute("42320454-626C-4DD0-9ECB-357C4F1966D8")>]
type VirtualPoint =  
    interface 
        interface TextPoint 
    end
public interface VirtualPoint extends TextPoint

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

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft AbsoluteCharOffset Ruft das 1-basierte Zeichenoffset vom Anfang des Dokuments bis zum Objekt ab.
Öffentliche Eigenschaft AtEndOfDocument Gibt true zurück, wenn sich das Objekt am Ende des Dokuments befindet.
Öffentliche Eigenschaft AtEndOfLine Gibt true zurück, wenn sich das Objekt am Ende einer Zeile befindet.
Öffentliche Eigenschaft AtStartOfDocument Gibt true zurück, wenn sich das Objekt am Anfang des Dokuments befindet.
Öffentliche Eigenschaft AtStartOfLine Gibt true zurück, wenn sich das Objekt am Anfang einer Zeile befindet.
Öffentliche Eigenschaft CodeElement Gibt das Codeelement an der Position von VirtualPoint zurück.
Öffentliche Eigenschaft DisplayColumn Ruft die Nummer der derzeit angezeigten Spalte ab, die das Objekt enthält.
Öffentliche Eigenschaft DTE Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
Öffentliche Eigenschaft Line Ruft die Zeilennummer des Objekts ab.
Öffentliche Eigenschaft LineCharOffset Ruft das Zeichenoffset des Objekts ab.
Öffentliche Eigenschaft LineLength Ruft die Anzahl der Zeichen in einer Zeile ab, in der das Objekt enthalten ist. Dabei werden Zeilenumbruchzeichen nicht berücksichtigt.
Öffentliche Eigenschaft Parent Ruft das unmittelbar übergeordnete Objekt eines VirtualPoint-Objekts ab.
Öffentliche Eigenschaft VirtualCharOffset Ruft den Spaltenindex eines virtuellen Punktes im virtuellen Bereich ab.
Öffentliche Eigenschaft VirtualDisplayColumn Ruft die Anzeigespalte der aktuellen Position ab.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode CreateEditPoint Erstellt ein EditPoint-Objekt an der Position des aufrufenden Objekts und gibt es zurück.
Öffentliche Methode EqualTo Gibt zurück, ob der Wert der AbsoluteCharOffset-Eigenschaft des angegebenen TextPoint-Objekts gleich dem des aufrufenden VirtualPoint-Objekts ist.
Öffentliche Methode GreaterThan Gibt zurück, ob der Wert der AbsoluteCharOffset-Eigenschaft des aufrufenden Objekts größer als der des angegebenen Point-Objekts ist.
Öffentliche Methode LessThan Gibt zurück, ob der Wert der AbsoluteCharOffset-Eigenschaft des aufgerufenen Objekts kleiner als der des angegebenen Objekts ist.
Öffentliche Methode TryToShow Hiermit wird versucht, die Position des Textpunkts anzuzeigen.

Zum Seitenanfang

Hinweise

VirtualPoint-Objekte sind mit dem TextPoint-Objekt vergleichbar, mit der Ausnahme, dass sie in der Lage sind, den virtuellen Bereich in einem Dokument abzufragen. VirtualPoint-Objekte werden durch TextSelection.StartPoint und TextSelection.EndPoint zurückgegeben.

Ein virtueller Bereich ist der Leerraum rechts neben vorhandenen Textzeilen, in dem virtuelle Punkte vorhanden sind.

Beispiele

Sub VirtualPointExample()
   ' Before running this example, open a text document.
   Dim objSel As TextSelection = DTE.ActiveDocument.Selection
   Dim objActive As VirtualPoint = objSel.ActivePoint
   ' Collapse the selection to the beginning of the line.
   objSel.StartOfLine()
   ' objActive is "live", tied to the position of the actual selection, 
   ' so it will reflect the new position.
   Dim iCol As Long = objActive.DisplayColumn
   ' Move the selection to the end of the line.
   objSel.EndOfLine()

   MsgBox("The length of the insertion point line is " & (objActive.DisplayColumn - iCol) & " display characters.")
   MsgBox("VirtualCharOffset value: " & objActive.VirtualCharOffset & vbCr & "VirtualDisplayColumn value: " & objActive.VirtualDisplayColumn)
End Sub

Siehe auch

Referenz

EnvDTE-Namespace