InkCollector.MarginX, propriété

Article
11/05/2008

Mise à jour : November 2007

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

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

Syntaxe

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

value = instance.MarginX

instance.MarginX = value

public int MarginX { get; set; }

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

/** @property */
public int get_MarginX()
/** @property */
public  void set_MarginX(int value)

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

Valeur de propriété

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

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

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é MarginX.

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é MarginX 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é MarginX 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 abscisses d'un rectangle de fenêtre pour un InkCollector.

mInkCollector.Enabled = False
mInkCollector.MarginX = 5
mInkCollector.Enabled = True

mInkCollector.Enabled = false;
mInkCollector.MarginX = 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.