InkOverlay.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
<BrowsableAttribute(True)> _
Public Property MarginY As Integer
'Utilisation
Dim instance As InkOverlay
Dim value As Integer

value = instance.MarginY

instance.MarginY = value

[BrowsableAttribute(true)]
public int MarginY { get; set; }

[BrowsableAttribute(true)]
public:
property int MarginY {
    int get ();
    void set (int value);
}

/** @property */
/** @attribute BrowsableAttribute(true) */
public int get_MarginY()
/** @property */
/** @attribute BrowsableAttribute(true) */
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 InkOverlay.
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 InkOverlay, 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 InkOverlay avant de définir cette propriété. Pour désactiver la collecte d'entrée manuscrite sur le contrôle InkOverlay, 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 devez désactiver la collecte d'entrée manuscrite sur l'objet InkOverlay avant de définir cette propriété. Pour désactiver la collecte d'entrée manuscrite sur le contrôle InkOverlay, 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.

Exemples

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

mInkOverlay.Enabled = False
mInkOverlay.MarginY = 5
mInkOverlay.Enabled = True

mInkOverlay.Enabled = false;
mInkOverlay.MarginY = 5;
mInkOverlay.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.