TextPane2.TryToShow-Methode (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.
Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)
Syntax
'Declaration
Function TryToShow ( _
Point As TextPoint, _
How As vsPaneShowHow, _
PointOrCount As Object _
) As Boolean
bool TryToShow(
TextPoint Point,
vsPaneShowHow How,
Object PointOrCount
)
bool TryToShow(
[InAttribute] TextPoint^ Point,
[InAttribute] vsPaneShowHow How,
[InAttribute] Object^ PointOrCount
)
abstract TryToShow :
Point:TextPoint *
How:vsPaneShowHow *
PointOrCount:Object -> bool
function TryToShow(
Point : TextPoint,
How : vsPaneShowHow,
PointOrCount : Object
) : boolean
Parameter
- Point
Typ: EnvDTE.TextPoint
Erforderlich.Die TextPoint-Position, die Sie anzeigen möchten.
- How
Typ: EnvDTE.vsPaneShowHow
Erforderlich.Eine vsPaneShowHow-Konstante, die angibt, wie der Text angezeigt werden soll.
- PointOrCount
Typ: System.Object
Optional.Eine Variante, die das Ende eines anzuzeigenden Textbereichs darstellt.Wenn PointOrCount eine Anzahl von Zeichen ist, folgen die Zeichen auf Point.Wenn PointOrCount ein Punkt vor Point ist, befindet er sich am oberen Rand des Textbereichs, falls How auf vsPaneShowTop festgelegt ist.
Wenn How auf vsPaneShowCentered festgelegt ist und die Anzahl der Zeilen im markierten Text größer ist als die Höhe des Bereichs, wird die oberste Zeile des markierten Textes an den Anfang des Bereichs gesetzt.
Rückgabewert
Typ: System.Boolean
true , wenn der Text angezeigt werden kann; andernfalls false.
Beispiele
In diesem Beispiel wird ein Textdokument geöffnet, der darin enthaltene Text wird angezeigt, und anschließend wird mithilfe der TryToShow-Methode von TextPane2 das Fenster angezeigt, das den Textbereich enthält.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)
TextPane2TryToShowExample(_applicationObject)
End Sub
Sub TextPane2TryToShowExample(ByVal dte As DTE2)
Dim objTW As TextWindow
Dim objPane As TextPane2
Dim objTextDoc As TextDocument
Dim objTextPt As TextPoint
Dim objEP As EditPoint
Dim objStart As TextPoint
' Create a new text document.
_applicationObject.ItemOperations.NewFile("General\Text File")
' Get a handle to the new document and create EditPoint,
' TextPoint, and TextPane 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) & ".")
MsgBox("Using TryToShow to center the pane...")
objPane.TryToShow(objStart, vsPaneShowHow.vsPaneShowCentered)
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;
TextPane2TryToShowExample(_applicationObject);
}
public void TextPane2TryToShowExample(DTE2 dte)
{
TextWindow objTW;
TextPane2 objPane;
TextDocument objTextDoc;
TextPoint objTextPt;
EditPoint2 objEP;
TextPoint objStart;
// 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 + ".");
MessageBox.Show("Using TryToShow to show the pane as centered...");
objPane.TryToShow(objStart, vsPaneShowHow.vsPaneShowCentered, 2);
}
.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.