InkOverlay.Cursors (Propiedad)

Artículo
10/28/2008

Actualización: noviembre 2007

Obtiene la colección Cursors que se puede usar en la región de escritura a mano.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
<BrowsableAttribute(False)> _
Public ReadOnly Property Cursors As Cursors
'Uso
Dim instance As InkOverlay
Dim value As Cursors

value = instance.Cursors

[BrowsableAttribute(false)]
public Cursors Cursors { get; }

[BrowsableAttribute(false)]
public:
property Cursors^ Cursors {
    Cursors^ get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Cursors get_Cursors()

public function get Cursors () : Cursors

Valor de propiedad

Tipo: Microsoft.Ink.Cursors
Colección Cursors que se puede usar en la región de escritura a mano.

Comentarios

Cada cursor corresponde a la punta de una pluma u otro dispositivo de lectura de entrada manuscrita.

Los cursores de esta colección son locales respecto a un objeto InkOverlay.

Cualquier nuevo cursor que encuentre el objeto InkOverlay se agrega a la colección Cursors devuelta, aunque los cursores no se devuelven necesariamente en el orden en que los encuentra el objeto InkOverlay.

Al habilitar un mouse como un dispositivo de entrada en el objeto InkOverlay (cuando el parámetro useMouseForInput del método SetAllTabletsMode es true), el mouse se agrega a la colección Cursors después de que el objeto InkOverlay encuentra cualquier otro cursor, por ejemplo una pluma. Esto se debe a que la pluma también se comporta como un mouse.

Nota

El evento CursorInRange se recibe para el cursor del mouse después de que cualquier otro cursor, por ejemplo una pluma, dibuja un trazo (que desencadena el evento Stroke).

La colección Cursors se borra (el recuento se establece en 0, no conteniendo ningún objeto) cuando:

Se cambia el modo de Tablet PC (por ejemplo, de SetSingleTabletIntegratedMode a SetAllTabletsMode).
Se llama al método SetSingleTabletIntegratedMode.

Ejemplos

En este ejemplo de C# se devuelve un informe sobre los atributos de todos los cursores que ha visto el objeto InkOverlay pasado como parámetro.

using Microsoft.Ink;
//. . .
public string CursorReport(InkOverlay theInkOverlay)
{
    string theReport = "The InkOverlay has encountered the following cursors so far:" + Environment.NewLine;
    // Get the Cursors collection from the InkOverlay
    Microsoft.Ink.Cursors theCursors = theInkOverlay.Cursors;
    // Prevent changes to the collection while we iterate over it.
    lock( theCursors.SyncRoot )
    {
        theReport += "Count of cursors: " + theCursors.Count + Environment.NewLine + Environment.NewLine ;
        foreach (Microsoft.Ink.Cursor cursor in theCursors)
        {
            theReport += "Cursor Name: " + cursor.Name + Environment.NewLine;
            theReport += "Cursor ToString: " + cursor.ToString() + Environment.NewLine;
            theReport += "Tablet Name: " + cursor.Tablet.Name  + Environment.NewLine;
            theReport += "Cursor Id: " + cursor.Id.ToString()  + Environment.NewLine;
            theReport += "Cursor is inverted: " + cursor.Inverted.ToString()  + Environment.NewLine;
            theReport += "Cursor Buttons:" + Environment.NewLine;
            foreach (CursorButton button in cursor.Buttons)
            {
                CursorButtonState theState = button.State;
                theReport += "    Button Name: " + button.Name + Environment.NewLine;
                theReport += "    State: " + button.State.ToString() + Environment.NewLine;
                theReport += "    Id: " + button.Id.ToString()  + Environment.NewLine + Environment.NewLine;
            }
        }
    }
    return theReport;
}

En este ejemplo de Microsoft® Visual Basic® .NET se devuelve un informe de los atributos de todos los cursores que ha visto el objeto InkOverlay pasado como parámetro.

Imports Microsoft.Ink
'. . .
Public Function CursorReport(ByVal theInkOverlay As InkOverlay) _
    As String
    Dim theReport As String = "The InkOverlay has encountered " & _
        "the following cursors so far:" & vbCrLf
    ' Get the Cursors collection from the InkOverlay
    Dim theCursors As Cursors = theInkOverlay.Cursors
    ' Prevent changes to the collection while we iterate over it.
    SyncLock theCursors.SyncRoot
        theReport &= "Count of cursors: " & theCursors.Count & vbCrLf
        Dim theCursor As Cursor
        For Each theCursor In theCursors
            theReport &= "Cursor Name: " & theCursor.Name & vbCrLf
            theReport &= "Cursor ToString: " & theCursor.ToString() & _
                vbCrLf
            theReport &= "Tablet Name: " & theCursor.Tablet.Name & vbCrLf
            theReport &= "Cursor Id: " & theCursor.Id.ToString() & vbCrLf
            theReport &= "Cursor is inverted: " & _
                theCursor.Inverted.ToString() & vbCrLf
            theReport &= "Cursor Buttons:" & vbCrLf
            Dim theButton As CursorButton
            For Each theButton In theCursor.Buttons
                Dim theState As CursorButtonState = theButton.State
                theReport &= "    Button Name: " & theButton.Name & vbCrLf
                theReport &= "    State: " & _
                    theButton.State.ToString() & vbCrLf
                theReport &= "    Id: " & theButton.Id.ToString() & _
                    vbCrLf & vbCrLf
            Next
        Next
    End SyncLock
    Return theReport
End Function

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.