InkPicture.CollectingInk, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient une valeur qui spécifie si l'entrée manuscrite est actuellement tracée sur un contrôle InkPicture.

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 InkPicture
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 contrôle InkPicture.

Valeur	Signification
true	L'entrée manuscrite est tracée sur le contrôle InkPicture.
false	L'entrée manuscrite n'est pas tracée sur le contrôle InkPicture.

Notes

La propriété CollectingInk permet de voir si l'entrée manuscrite est tracée sur un contrôle InkPicture 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 avoir la valeur true alors que le code d'application considère toujours qu'elle a 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 InkPicture sont sélectionnés en affectant la même collection Strokes que celle utilisée par l'objet Ink associé à la propriété Selection.

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

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 avoir la valeur true alors que le code d'application considère toujours qu'elle a 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.