Cursor.Inverted (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene un valor que indica si el cursor es la punta invertida de la pluma.

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

Sintaxis

'Declaración
Public ReadOnly Property Inverted As Boolean
'Uso
Dim instance As Cursor
Dim value As Boolean

value = instance.Inverted

public bool Inverted { get; }

public:
property bool Inverted {
    bool get ();
}

/** @property */
public boolean get_Inverted()

public function get Inverted () : boolean

Valor de propiedad

Tipo: System.Boolean
Es true si el cursor es la punta invertida de la pluma; es false si el cursor no es la punta invertida de la pluma o la pluma no admite ningún cursor asociado a la punta invertida de la pluma.

Comentarios

Los cursores invertidos generalmente se asocian al borrado, por lo que una pluma dada puede tener una punta destinada a dibujar la entrada manuscrita y la otra a borrar los trazos. Sin embargo, el comportamiento con el que el sistema reconoce la punta invertida de la pluma no se limita al borrado. Puede asociar cualquier comportamiento aceptable del cursor a la propiedad Inverted.

Para obtener más información sobre cómo borrar la entrada manuscrita, vea Erasing Ink with the Pen.

Nota

El usar o no usar la propiedad Inverted depende completamente de las necesidades de la aplicación. Las aplicaciones no tienen que inspeccionar los cursores invertidos y el recopilador de entrada manuscrita aplica los atributos de dibujo predeterminados a los cursores invertidos de la misma forma que a los cursores no invertidos.

Nota

Esta función puede especificarse de nuevo si se llama en determinados controladores de mensajes, lo cual causa resultados inesperados. Procure evitar que se produzca una llamada reentrante al controlar alguno de los siguientes mensajes WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam se establece en SC_HOTKEY o SC_TASKLIST y WM_SYSKEYDOWN (al procesar las combinaciones de teclas Alt-Tab o Alt-Esc). Este problema se produce con las aplicaciones del modelo de contenedor uniproceso.

Ejemplos

En este ejemplo de C# se devuelve un informe sobre los atributos de todos los cursores encontrados por el objeto InkCollector pasado como parámetro.

using Microsoft.Ink;
//. . .
public string CursorReport(InkCollector theInkCollector)
{
    string theReport = "The InkCollector has encountered the following cursors so far:" + Environment.NewLine;
    // Get the Cursors collection from the InkCollector
    Microsoft.Ink.Cursors theCursors = theInkCollector.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 encontrados por el objeto InkCollector pasado como parámetro.

Imports Microsoft.Ink
'. . .
Public Function CursorReport(ByVal theInkCollector As InkCollector) _
    As String
    Dim theReport As String = "The InkCollector has encountered " & _
        "the following cursors so far:" & vbCrLf
    ' Get the Cursors collection from the InkCollector
    Dim theCursors As Cursors = theInkCollector.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.