TextPane.TryToShow - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Корректирует положение представления в текстовом буфере таким образом, чтобы указанный фрагмент текста отображался, если возможно, в текстовой области. Местом отображения текста в области можно управлять.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
Function TryToShow ( _
    Point As TextPoint, _
    How As vsPaneShowHow, _
    PointOrCount As Object _
) As Boolean
'Применение
Dim instance As TextPane
Dim Point As TextPoint
Dim How As vsPaneShowHow
Dim PointOrCount As Object
Dim returnValue As Boolean

returnValue = instance.TryToShow(Point, _
    How, PointOrCount)

bool TryToShow(
    TextPoint Point,
    vsPaneShowHow How,
    Object PointOrCount
)

bool TryToShow(
    [InAttribute] TextPoint^ Point, 
    [InAttribute] vsPaneShowHow How, 
    [InAttribute] Object^ PointOrCount
)

function TryToShow(
    Point : TextPoint, 
    How : vsPaneShowHow, 
    PointOrCount : Object
) : boolean

Параметры

Point
Тип: EnvDTE.TextPoint
Обязательный. Позиция TextPoint, которую нужно отобразить.

How
Тип: EnvDTE.vsPaneShowHow
Обязательный. Константа vsPaneShowHow, показывающая способ отображения текста.

PointOrCount
Тип: System.Object
Необязательный компонент. Переменная, представляющее конец отображаемого фрагмента текста. Если параметр PointOrCount задает число символов, то символы следуют за Point. Если параметр PointOrCount — это точка перед Point, тогда текст будет находиться в верхней части текстовой области, если значение параметра How установлено на vsPaneShowTop.
Если значение параметра How установлено на vsPaneShowCentered, и число строк в выделенном фрагменте текста больше, чем высота текстовой области, то верхняя строка выделенного фрагмента текста помещается в верхней части текстовой области.

Возвращаемое значение

Тип: System.Boolean
true , если текст можно отобразить; в противном случае — false.

Примеры

Sub TryToShowExample(ByVal dte As EnvDTE.DTE)
    Dim objTW As TextWindow
    Dim objPane As TextPane
    Dim objStart As TextPoint

    objTW = dte.ActiveWindow.Object
    objPane = objTW.ActivePane
    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) & ".")
    objPane.TryToShow(objStart, vsPaneShowHow.vsPaneShowCentered)
End Sub

public void TryToShowExample(_DTE dte)
{
    TextWindow tw;
    TextPane tpn;
    TextPoint tpt;

    tw = (TextWindow)dte.ActiveWindow.Object;
    tpn = tw.ActivePane;
    MessageBox.Show ("The active pane is " + tpn.Height.ToString () + " 
    lines high and " + tpn.Width.ToString () + " columns wide.");
    tpt = tpn.StartPoint;
    MessageBox.Show ("It begins at line " + tpt.Line.ToString () + ", 
    column " + tpt.LineCharOffset.ToString () + ".");
    tpn.TryToShow (tpt,vsPaneShowHow.vsPaneShowCentered,1);
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

TextPane Интерфейс

TextPane - члены

EnvDTE - пространство имен

Поделиться через