TextPane.TryToShow - метод

Статья
11/01/2012

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

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

Синтаксис

'Декларация
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

Параметры

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

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

PointOrCount
Тип: System.Object
Необязательный.Значение типа variant, представляющее конец отображаемого фрагмента текста.Если параметр 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);
}

Безопасность платформы .NET Framework

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

См. также

Ссылки

TextPane Интерфейс

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

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