TextPane2.IsVisible-Methode

Gibt einen Wert zurück, der angibt, ob das Zeichen oder die angegebenen Zeichen im Textbereich sichtbar sind.

Namespace:  EnvDTE80
Assembly:  EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
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

Parameter

• Point
  Typ: TextPoint

  Erforderlich. Eine TextPoint-Position, mit der bestimmt wird, ob ein Zeichen sichtbar ist. Da ein Point zwischen zwei Zeichen liegt, bezieht sich die Standardinterpretation (d. h., wenn für das PointOrCount-Argument kein Wert angegeben ist) auf das erste Zeichen unmittelbar rechts neben dem Textpunkt. Wenn das Zeichen hinter dem Textpunkt sichtbar ist, ist Point ebenfalls sichtbar.

• PointOrCount
  Typ: Object

  Optional. Ein weiterer Punkt, der mit dem ersten Point-Argument verwendet werden kann, um einen Textbereich anzugeben. IsVisible bestimmt, ob dieser Textbereich sichtbar ist. PointOrCount kann auch auf eine Anzahl von Zeichen festgelegt werden, die Point folgen, um den Textbereich anzugeben.

  Wenn für das PointOrCount-Argument kein Wert angegeben wird, prüft IsVisible die Sichtbarkeit des Zeichens unmittelbar rechts neben Point, da PointOrCount den Standardwert 1 hat.

Rückgabewert

Typ: Boolean
true , wenn der Punkt sichtbar ist; andernfalls false.

Hinweise

Wenn für PointOrCount ein Wert angegeben wird, dann gibt IsVisible den Wert true zurück, wenn der gesamte markierte Textbereich sichtbar ist.

Beispiele

In diesem Beispiel wird ein Textdokument geöffnet, der darin enthaltene Text wird angezeigt, und anschließend wird mithilfe der IsVisible-Methode von TextPane2 ermittelt, ob der Text im Textbereich sichtbar ist. Weitere Informationen zum Ausführen dieses Beispiels als Add-In finden Sie unter Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell.

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-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

TextPane2 Schnittstelle

EnvDTE80-Namespace