TextPane2.TryToShow (Método) (TextPoint, vsPaneShowHow, Object)
Ajusta la ubicación de la vista en el búfer de texto para que el intervalo de texto especificado se muestre en el panel de texto, si es posible.Se puede controlar en qué lugar del panel se muestra el texto.
Espacio de nombres: EnvDTE80
Ensamblado: EnvDTE80 (en EnvDTE80.dll)
Sintaxis
'Declaración
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
Parámetros
- Point
Tipo: EnvDTE.TextPoint
Obligatorio.Ubicación de TextPoint que se desea mostrar.
- How
Tipo: EnvDTE.vsPaneShowHow
Obligatorio.Constante vsPaneShowHow que indica cómo se debe mostrar el texto.
- PointOrCount
Tipo: System.Object
Opcional.Variante que representa el final del intervalo de texto que se va a mostrar.Si PointOrCount es un conjunto de caracteres, éstos se muestran a continuación del parámetro Point.Si PointOrCount es un punto anterior a Point, entonces está en la parte superior del panel de texto si How se establece en vsPaneShowTop.
Si How se ha establecido en vsPaneShowCentered y el número de líneas del texto seleccionado supera el alto del panel, la línea superior del texto seleccionado se coloca en la parte superior del panel.
Valor devuelto
Tipo: System.Boolean
true si se puede mostrar el texto; en caso contrario, false.
Ejemplos
Este ejemplo abre un documento de texto, muestra texto en él y, a continuación, usa el método TryToShow de TextPane2 para mostrar la ventana que contiene el panel de texto.Para obtener más información sobre cómo ejecutar este ejemplo como un complemento, vea Cómo: Compilar y ejecutar los ejemplos de código del modelo de objetos de automatización.
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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.