InkOverlay.CollectingInk, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient une valeur qui spécifie si l'entrée manuscrite est tracée actuellement sur un objet InkOverlay.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<BrowsableAttribute(False)> _
Public ReadOnly Property CollectingInk As Boolean
'Utilisation
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

Valeur de propriété

Type : System.Boolean
Valeur qui spécifie si l'entrée manuscrite est actuellement tracée sur un objet InkOverlay.
true si l'entrée manuscrite est tracée sur l'objet InkOverlay ; sinon, false.

Notes

Vous pouvez utiliser la propriété CollectingInk pour déterminer si l'entrée manuscrite est tracée sur un objet InkOverlay au lieu de surveiller l'événement Stroke.

Remarque :
Étant donné que la collecte d'entrée manuscrite est gérée sur un thread séparé de votre code d'application, la propriété CollectingInk peut prendre la valeur true alors que le code d'application considère qu'elle a toujours la valeur false. Pour gérer cette éventualité, le code qui dépend de la valeur de la propriété CollectingInk doit être contenu dans un bloc try- catch.

Exemples

Dans cet exemple, tous les traits de l'objet InkOverlay sont sélectionnés en affectant la propriété Selection à la même collection Strokes utilisée par l'objet Ink associé.

Après avoir effectué la sélection, la propriété EditingMode a la valeur Select.

La propriété EditingMode ne peut pas être modifiée lorsque l'objet collecte l'entrée manuscrite. Étant donné que la collecte d'entrée manuscrite est gérée sur un thread séparé de votre code d'application, la propriété CollectingInk peut prendre la valeur true alors que le code d'application considère qu'elle a toujours la valeur false. Pour gérer cette éventualité, l'accès à la propriété EditingMode doit être contenu dans un bloc 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
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.