TextPane2.IsVisible 方法 (TextPoint, Object)

  • 發行項

傳回數值，指出字元或指定字元在文字窗格中是否為可見的。

命名空間：  EnvDTE80
組件：  EnvDTE80 (在 EnvDTE80.dll 中)

語法

'宣告
Function IsVisible ( _
    Point As TextPoint, _
    PointOrCount As Object _
) As Boolean

bool IsVisible(
    TextPoint Point,
    Object PointOrCount
)

bool IsVisible(
    [InAttribute] TextPoint^ Point, 
    [InAttribute] Object^ PointOrCount
)

abstract IsVisible : 
        Point:TextPoint * 
        PointOrCount:Object -> bool 

function IsVisible(
    Point : TextPoint, 
    PointOrCount : Object
) : boolean

參數

  • Point
    型別：EnvDTE.TextPoint
    必要項。用來判斷某一字元是否為可見的 TextPoint 位置。由於 Point 是位於兩個字元之間，預設的轉譯 (也就是在沒有指定 PointOrCount 引數的值時) 剛好是在文字位置右邊的第一個字元。如果文字位置後面的字元是可見的，那麼 Point 也一樣可見。
  • PointOrCount
    型別：System.Object
    選擇項。另一位置與第一個 Point 引數搭配使用，以指定文字範圍。IsVisible 用以判斷此文字範圍是否可見。而 PointOrCount 也可以設為 Point 之後的字元數，以指定文字範圍。
    如果沒有提供值給 PointOrCount 引數，IsVisible 會檢查緊接在 Point 右邊的字元，因為 PointOrCount 的預設值為 1。

傳回值

型別：System.Boolean
如果這個位置是可見的，則為 true，否則為 false。

備註

如果有提供值給 PointOrCount，當整個文字選取範圍都是可見時，IsVisible 會傳回 true。

範例

這個範例會開啟文字文件並顯示其中的文字，再使用 TextPane2 的IsVisible 方法，判斷這個文字窗格中的文字是否為可見。如需如何像執行增益集一般，執行這個範例的詳細資訊，請參閱 HOW TO：編譯和執行 Automation 物件模型程式碼範例。

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)
    TextPane2IsVisibleExample(_applicationObject)
End Sub
Sub TextPane2IsVisibleExample(ByVal dte As DTE2)
    Dim objTW As TextWindow
    Dim objPane As TextPane2
    Dim objTextDoc As TextDocument
    Dim objTextPt As TextPoint
    Dim objEP As EditPoint
    ' 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)
    ' Check the first ten characters for visibility.
    If objPane.IsVisible(objTextPt, 10) = True Then
        MsgBox("Text is visible")
    Else
        MsgBox("Text is not visible.")
    End If
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;
    TextPane2IsVisibleExample(_applicationObject);
}
public void TextPane2IsVisibleExample(DTE2 dte)
{
    TextWindow objTW;
    TextPane2 objPane;
    TextDocument objTextDoc;
    TextPoint objTextPt;
    EditPoint2 objEP;
    // 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;
    // Check the first ten characters for visibility.
    if (objPane.IsVisible(objTextPt, 10))
        MessageBox.Show("Text is visible");
    else
        MessageBox.Show("Text is not visible.");
}

.NET Framework 安全性

請參閱

參考

TextPane2 介面

IsVisible 多載

EnvDTE80 命名空間