TextPane2-Schnittstelle

Artikel
08/10/2011

Stellt einen Bereich innerhalb eines Text-Editor-Fensters dar.

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

Syntax

'Declaration
<GuidAttribute("ACE19C7B-A0AC-4089-94FD-749CF4380E1F")> _
Public Interface TextPane2 _
    Inherits TextPane

[GuidAttribute("ACE19C7B-A0AC-4089-94FD-749CF4380E1F")]
public interface TextPane2 : TextPane

[GuidAttribute(L"ACE19C7B-A0AC-4089-94FD-749CF4380E1F")]
public interface class TextPane2 : TextPane

[<GuidAttribute("ACE19C7B-A0AC-4089-94FD-749CF4380E1F")>]
type TextPane2 =  
    interface
        interface TextPane
    end

public interface TextPane2 extends TextPane

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

Eigenschaften

	Name	Beschreibung
	Collection	(Von TextPane geerbt.)
	Collection	Ruft die Auflistung mit dem TextPane-Objekt ab, das diese Eigenschaft unterstützt.
	DTE	(Von TextPane geerbt.)
	DTE	Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
	Height	(Von TextPane geerbt.)
	Height	Ruft der Höhe des Textbereichs in Zeicheneinheiten ab.
	IncrementalSearch	Ermöglicht den Zugriff auf die inkrementelle Suchfunktion (ISearch) des Text-Editors.
	Selection	(Von TextPane geerbt.)
	Selection	Ruft ein Objekt ab, das die aktuelle Auswahl im TextPane-Objekt darstellt.
	StartPoint	(Von TextPane geerbt.)
	StartPoint	Ruft das TextPoint-Objekt ab, das das erste angezeigte Zeichen des Bereichs darstellt.
	Width	(Von TextPane geerbt.)
	Width	Ruft die Breite des Bereichs in Zeicheneinheiten ab.
	Window	(Von TextPane geerbt.)
	Window	Ruft das Window-Objekt ab, das den Bereich enthält.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Activate()	(Von TextPane geerbt.)
	Activate()	Verschiebt den Fokus auf das aktuelle Element.
	IsVisible(TextPoint, Object)	(Von TextPane geerbt.)
	IsVisible(TextPoint, Object)	Gibt einen Wert zurück, der angibt, ob das Zeichen oder die angegebenen Zeichen im Textbereich sichtbar sind.
	TryToShow(TextPoint, vsPaneShowHow, Object)	(Von TextPane geerbt.)
	TryToShow(TextPoint, vsPaneShowHow, Object)	Passt die Position der Ansicht im Textpuffer an, sodass der angegebene Text nach Möglichkeit im Textbereich angezeigt wird.Sie können bestimmen, an welcher Stelle im Bereich der Text angezeigt wird.

Zum Seitenanfang

Hinweise

Sie können das Fenster eines Text-Editors in zwei Bereiche aufteilen. Über das TextPane-Objekt können Sie auf den in jedem Bereich markierten Text und auf die Eigenschaften des Bereichs zugreifen, z. B. Höhe, Breite usw.

Beispiele

In diesem Beispiel wird ein Textdokument geöffnet, und einige Eigenschaften des Textbereichs werden in einem Meldungsfeld angezeigt. Weitere Informationen zum Ausführen dieses Beispiels als Add-In finden Sie unter Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell.

Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    TextPane2Example(_applicationObject)
End Sub
Sub TextPane2Example(ByVal dte As DTE2)
    Dim objTW As TextWindow
    Dim objPane As TextPane2
    Dim objStart As TextPoint
    Dim objTextDoc As TextDocument
    Dim objTextPt As TextPoint
    Dim objEP As EditPoint
    ' Create a new text document.
    _applicationObject.ItemOperations.NewFile("General\Text File")
    ' Get a handle to the new document and create EditPoint,
    ' TextPoint, and TextPane2 objects.
    objTextDoc = CType(_applicationObject.ActiveDocument.Object _
    ("TextDocument"), TextDocument)
    objEP = objTextDoc.StartPoint.CreateEditPoint
    objTextPt = objTextDoc.StartPoint
    ' Plug in some text.
    objEP.Insert("A test sentence.")
    objTW = CType(dte.ActiveWindow.Object, TextWindow)
    objPane = CType(objTW.ActivePane, TextPane2)
    MsgBox("The active pane is " & Str(objPane.Height)  _
    & " lines high and " & Str(objPane.Width) & " columns wide.")
    objStart = objPane.StartPoint
    MsgBox("It begins at line " & Str(objStart.Line) & ", column " & _
     Str(objStart.LineCharOffset) & ".")
End Sub

using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void OnConnection(object application, 
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    TextPane2Example(_applicationObject);
}
public void TextPane2Example(DTE2 dte)
{
    TextWindow objTW;
    TextPane2 objPane;
    TextPoint objStart;
    TextDocument objTextDoc;
    TextPoint objTextPt;
    EditPoint2 objEP;
    // Create a new text document.
    _applicationObject.ItemOperations.NewFile(@"General\Text File",
 "test.txt", Constants.vsViewKindTextView);
    // Get a handle to the text document and create EditPoint2,
    // TextPoint, and TextPane2 objects.
    objTextDoc =(TextDocument)_applicationObject.ActiveDocument.Object
("TextDocument");
    objEP = (EditPoint2)objTextDoc.StartPoint.CreateEditPoint();
    objTextPt = objTextDoc.StartPoint;
    // Plug in some text.
    objEP.Insert("A test sentence.");
    objTW = (TextWindow)_applicationObject.ActiveWindow.Object;
    objPane = (TextPane2)objTW.ActivePane;
    MessageBox.Show("The active pane is " + objPane.Height + " 
lines high and " + objPane.Width + " columns wide.");
    objStart = objPane.StartPoint;
    MessageBox.Show("It begins at line " + objStart.Line 
+ ", column " +  objStart.LineCharOffset + ".");
}

Siehe auch

Referenz

EnvDTE80-Namespace

Freigeben über