InkCollector.MarginY, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit les marges le long de l'axe des ordonnées, en pixels.

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

Syntaxe

'Déclaration
Public Property MarginY As Integer
'Utilisation
Dim instance As InkCollector
Dim value As Integer

value = instance.MarginY

instance.MarginY = value

public int MarginY { get; set; }

public:
property int MarginY {
    int get ();
    void set (int value);
}

/** @property */
public int get_MarginY()
/** @property */
public  void set_MarginY(int value)

public function get MarginY () : int
public function set MarginY (value : int)

Valeur de propriété

Type : System.Int32
Marges, en pixels, le long de l'axe des ordonnées.

Valeur	Signification
Propriété DefaultMargin	Champ DefaultMargin du contrôle InkCollector.
Int32	Marges définies par l'application le long de l'axe des ordonnées.

Notes

Cette marge fournit une mémoire tampon autour de la fenêtre d'entrée manuscrite. Le champ DefaultMargin spécifie la marge par défaut utilisée par la propriété MarginY.

Cette propriété est le plus souvent utilisée avec des périphériques de tablette non intégrés. Grâce à la mémoire tampon, les utilisateurs disposent d'une marge d'erreur lors de l'écriture sur un périphérique qui peut ne pas correspondre directement à la taille de l'écran.

Une marge positive s'étend hors des limites de l'objet InkCollector, une marge négative s'étend dans les limites du contrôle et la valeur zéro ne produit aucune marge. L'entrée manuscrite est collectée si le trait démarre dans la marge.

Ce comportement ne détoure pas l'entrée manuscrite. Les limites du contrôle sont la propriété GetWindowInputRectangle ou le rectangle client de la fenêtre.

La marge n'est effective que dans la fenêtre de l'application. Si le stylet est placé en dehors de la fenêtre de l'application, l'application perd le focus et ne peut pas collecter l'entrée manuscrite.

Remarque :
Vous devez désactiver la collecte d'entrée manuscrite sur l'objet InkCollector avant de définir cette propriété. Pour désactiver la collecte d'entrée manuscrite sur le contrôle InkCollector, affectez la valeur false à la propriété Enabled. Vous pouvez ensuite définir la propriété MarginY et réactiver la collecte d'entrée manuscrite sur le contrôle en affectant la valeur true à la propriété Enabled. Vous pouvez également utiliser la méthode SetWindowInputRectangle pour modifier la zone de saisie pendant que le InkCollector est activé.

Vous devez désactiver la collecte d'entrée manuscrite sur l'objet InkCollector avant de définir cette propriété. Pour désactiver la collecte d'entrée manuscrite sur le contrôle InkCollector, affectez la valeur false à la propriété Enabled. Vous pouvez ensuite définir la propriété MarginY et réactiver la collecte d'entrée manuscrite sur le contrôle en affectant la valeur true à la propriété Enabled. Vous pouvez également utiliser la méthode SetWindowInputRectangle pour modifier la zone de saisie pendant que le InkCollector est activé.

Exemples

L'exemple suivant définit à cinq pixels la marge de l'axe des ordonnées d'un rectangle de fenêtre pour un InkCollector.

mInkCollector.Enabled = False
mInkCollector.MarginY = 5
mInkCollector.Enabled = True

mInkCollector.Enabled = false;
mInkCollector.MarginY = 5;
mInkCollector.Enabled = true;

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.