EditPoint.TryToShow - метод (vsPaneShowHow, Object)

Статья
11/01/2012

Пытается отобразить положение точки текста.

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

Синтаксис

'Декларация
Function TryToShow ( _
    How As vsPaneShowHow, _
    PointOrCount As Object _
) As Boolean

bool TryToShow(
    vsPaneShowHow How,
    Object PointOrCount
)

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

abstract TryToShow : 
        How:vsPaneShowHow * 
        PointOrCount:Object -> bool

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

Параметры

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

PointOrCount
Тип: System.Object
Необязательный параметр.Конечная точка выбранного для отображения участка текста.Может быть либо TextPoint, либо целым числом.

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

Тип: System.Boolean
Возвращает true, если указанный текстовый диапазон умещается в текущем редакторе кода, и возвращающее false, если нет.

Заметки

Метод TryToShow корректирует положение буфера в текстовом представлении таким образом, чтобы, если это возможно, в редакторе кода отображался указанный диапазон текста.Метод TryToShow похож на метод Activate объекта TextPane за тем исключением, что он пытается отобразить диалоговое окно и указанный диапазон текста.

Примеры

Sub TryToShowExample(ByVal dte As DTE2)

    ' Before running this example, open a text document.
    Dim win As Window = dte.ActiveWindow
    Dim textWin As TextWindow = CType(win.Object, TextWindow)

    ' Split the text document window.
    Dim cmd As Command = dte.Commands.Item("Window.Split")
    dte.Commands.Raise(cmd.Guid, cmd.ID, Nothing, Nothing)

    ' Display the beginning of the document in the top pane and the 
    ' end of the document in the bottom pane.
    Dim sel As TextSelection = textWin.Panes.Item(2).Selection
    sel.StartOfDocument()
    sel.ActivePoint.TryToShow()
    sel = textWin.Panes.Item(1).Selection
    sel.EndOfDocument()
    sel.ActivePoint.TryToShow()

End Sub

public void TryToShowExample(DTE2 dte)
{
    // Before running this example, open a text document.
    Window win = dte.ActiveWindow;
    TextWindow textWin = (TextWindow)win.Object;

    // Split the text document window.
    Command cmd = dte.Commands.Item("Window.Split", -1);
    object dummy = null;
    dte.Commands.Raise(cmd.Guid, cmd.ID, ref dummy, ref dummy);

    // Display the beginning of the document in the top pane and the 
    // end of the document in the bottom pane.
    TextSelection sel = textWin.Panes.Item(2).Selection;
    sel.StartOfDocument(false);
    sel.ActivePoint.TryToShow(vsPaneShowHow.vsPaneShowCentered, null);
    sel = textWin.Panes.Item(1).Selection;
    sel.EndOfDocument(false);
    sel.ActivePoint.TryToShow(vsPaneShowHow.vsPaneShowCentered, null);
}

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

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