InkPicture.Cursors (Propiedad)
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 InkPicture
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 un pluma u otro dispositivo de lectura de entrada manuscrita.
Los cursores de esta colección son locales respecto a un control InkPicture.
Cualquier nuevo cursor que encuentre el control InkPicture se agrega a la colección Cursors devuelta, aunque los cursores no se devuelven necesariamente en el orden en que los encuentra el control InkPicture.
Al habilitar un mouse como un dispositivo de entrada en el control InkPicture (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 InkPicture 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 control InkPicture, theInkPicture pasado en el parámetro.
[C#]
using Microsoft.Ink;
//. . .
public string CursorReport(InkPicture theInkPicture)
{
string theReport = "The InkPicture has encountered the following cursors so far:" + Enivironment.NewLine;
// Get the Cursors collection from the InkPicture
Cursors theCursors = theInkPicture.Cursors;
// Prevent changes to the collection while we iterate over it.
lock(theCursors.SyncRoot )
{
theReport += "Count of cursors: " + theCursors.Count + Enivironment.NewLine + Enivironment.NewLine;
foreach (Cursor cursor in theCursors)
{
theReport += "Cursor Name: " + cursor.Name + Enivironment.NewLine;
theReport += "Cursor ToString: " + cursor.ToString() + Enivironment.NewLine;
theReport += "Tablet Name: " + cursor.Tablet.Name + Enivironment.NewLine;
theReport += "Cursor Id: " + cursor.Id.ToString() + Enivironment.NewLine;
theReport += "Cursor is inverted: " + cursor.Inverted.ToString() + Enivironment.NewLine;
theReport += "Cursor Buttons:" + Enivironment.NewLine;
foreach (CursorButton button in cursor.Buttons)
{
CursorButtonState theState = button.State;
theReport += " Button Name: " + button.Name + Enivironment.NewLine;
theReport += " State: " + button.State.ToString() + Enivironment.NewLine;
theReport += " Id: " + button.Id.ToString() + Enivironment.NewLine + Enivironment.NewLine;
}
}
}
return theReport;
}
En este ejemplo de Microsoft® Visual Basic® .NET se devuelve un informe sobre los atributos de todos los cursores que ha visto el control InkPicture, theInkPicture pasado en el parámetro.
[Visual Basic]
Imports Microsoft.Ink
'. . .
Public Function CursorReport(ByVal theInkPicture As InkPicture) _
As String
Dim theReport As String = "The InkPicture has encountered " & _
"the following cursors so far:" & vbCrLf
' Get the Cursors collection from the InkPicture
Dim theCursors As Cursors = theInkPicture.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.
Información de versión
.NET Framework
Compatible con: 3.0