InkOverlay.Selection, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit la collection Strokes actuellement sélectionnée à l'intérieur du contrôle InkOverlay.

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

Syntaxe

'Déclaration
<BrowsableAttribute(False)> _
Public Property Selection As Strokes
'Utilisation
Dim instance As InkOverlay
Dim value As Strokes

value = instance.Selection

instance.Selection = value

[BrowsableAttribute(false)]
public Strokes Selection { get; set; }

[BrowsableAttribute(false)]
public:
property Strokes^ Selection {
    Strokes^ get ();
    void set (Strokes^ value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Strokes get_Selection()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Selection(Strokes value)

public function get Selection () : Strokes
public function set Selection (value : Strokes)

Valeur de propriété

Type : Microsoft.Ink.Strokes
Collection Strokes actuellement sélectionnée à l'intérieur du contrôle InkOverlay. La valeur par défaut est une collection Strokes vide.

Notes

Pour obtenir le rectangle englobant de la collection Strokes après son déplacement ou son redimensionnement, appelez la méthode GetBoundingBox de la collection Strokes retournée par cette propriété.

Pour obtenir le rectangle englobant de la collection Strokes avant son déplacement, gérez l'événement SelectionMoved et obtenez la propriété OldSelectionBoundingRect de l'objet InkOverlaySelectionMovedEventArgs.

Pour obtenir le rectangle englobant de la collection Strokes avant son redimensionnement, gérez l'événement SelectionResized et obtenez la propriété OldSelectionBoundingRect de l'objet InkOverlaySelectionResizedEventArgs.

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.