Proprietà InkOverlay.CollectingInk

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene un valore che specifica se attualmente l'input penna viene disegnato su un oggetto InkOverlay.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
<BrowsableAttribute(False)> _
Public ReadOnly Property CollectingInk As Boolean
'Utilizzo
Dim instance As InkOverlay
Dim value As Boolean

value = instance.CollectingInk

[BrowsableAttribute(false)]
public bool CollectingInk { get; }

[BrowsableAttribute(false)]
public:
property bool CollectingInk {
    bool get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_CollectingInk()

public function get CollectingInk () : boolean

Valore proprietà

Tipo: System.Boolean
Valore che specifica se attualmente l'input penna viene disegnato su un oggetto InkOverlay.
true se l'input penna viene disegnato sull'oggetto InkOverlay; in caso contrario, false.

Note

È possibile utilizzare la proprietà CollectingInk per verificare se l'input penna viene disegnato su un oggetto InkOverlay piuttosto che monitorare l'evento Stroke.

Nota

Poiché la raccolta dell'input penna viene gestita in un thread separato dal codice dell'applicazione, la proprietà CollectingInk può essere modificata in true mentre il codice dell'applicazione si basa sul fatto che sia ancora false. Per gestire questa situazione, il codice che dipende dal valore della proprietà CollectingInk deve essere contenuto in un blocco try-catch.

Esempi

In questo esempio, si selezionano tutti i tratti dell'oggetto InkOverlay impostando la proprietà Selection sullo stesso insieme Strokes utilizzato dall'oggetto Ink associato.

Dopo aver eseguito la selezione, la proprietà EditingMode viene impostata su Select.

Non è possibile modificare la proprietà EditingMode mentre l'oggetto raccoglie l'input penna. Poiché la raccolta dell'input penna viene gestita in un thread separato dal codice dell'applicazione, la proprietà CollectingInk può essere modificata in true mentre il codice dell'applicazione si basa sul fatto che sia ancora false. Per gestire questa situazione, l'accesso alla proprietà EditingMode deve essere contenuto in un blocco try-catch.

' Select all strokes
' mInkObject can be InkOverlay or InkPicture
Try
    If Not mInkObject.CollectingInk Then
        mInkObject.Selection = mInkObject.Ink.Strokes
        mInkObject.EditingMode = InkOverlayEditingMode.Select
    End If

Catch
    ' handle or rethrow
End Try

// Select all strokes
// mInkObject can be InkOverlay or InkPicture
try
{
    if (!mInkObject.CollectingInk)
    {
        mInkObject.Selection = mInkObject.Ink.Strokes;
        mInkObject.EditingMode = InkOverlayEditingMode.Select;
    }
}
catch
{
    // handle or rethrow
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.