InkPicture.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 InkPicture
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 InkPicture. Par défaut.
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 du contrôle InkPicture, 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 :
La collecte d'entrée manuscrite sur le contrôle InkPicture doit être désactivée avant de définir cette propriété. Pour désactiver la collecte d'entrée manuscrite sur le contrôle InkPicture, affectez la valeur false à la propriété InkEnabled. 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é InkEnabled.

La collecte d'entrée manuscrite sur le contrôle InkPicture doit être désactivée avant de définir cette propriété. Pour désactiver la collecte d'entrée manuscrite sur le contrôle InkPicture, affectez la valeur false à la propriété InkEnabled. 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é InkEnabled.

Exemples

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

mInkPicture.InkEnabled = False
mInkPicture.MarginY = 5
mInkPicture.InkEnabled = True

mInkPicture.InkEnabled = false;
mInkPicture.MarginY = 5;
mInkPicture.InkEnabled = 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.