Proprietà InkCollector.MarginY

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta i margini lungo l'asse Y, espressi in pixel.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Property MarginY As Integer
'Utilizzo
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)

Valore proprietà

Tipo: System.Int32
Margini lungo l'asse Y, espressi in pixel.

Valore	Significato
Proprietà DefaultMargin	Campo DefaultMargin del controllo InkCollector.
Int32	Margini definiti dall'applicazione lungo l'asse Y.

Note

Questo margine fornisce un buffer intorno al bordo della finestra dell'input penna. Il campo DefaultMargin specifica il margine predefinito utilizzato dalla proprietà MarginY.

Questa proprietà è utilizzata comunemente con i dispositivi del Tablet PC non integrati. Il buffer offre agli utenti un margine di errore in caso di scrittura in un dispositivo che non viene mappato direttamente alle dimensioni dello schermo.

Un margine positivo si estende al di fuori dei limiti dell'oggetto InkCollector, mentre un margine negativo rientra nei limiti del controllo; a un valore zero non corrisponde alcun margine. L'input penna viene raccolto se il tratto inizia all'interno del margine.

Questo comportamento non ritaglia l'input penna. I limiti del controllo sono la proprietà GetWindowInputRectangle o il rettangolo client per la finestra.

Il margine è valido solo all'interno della finestra dell'applicazione. Se la penna viene applicata all'esterno della finestra dell'applicazione, l'applicazione perde lo stato attivo e non può raccogliere l'input penna.

Nota

È necessario disattivare la raccolta dell'input penna sull'oggetto InkCollector prima di impostare questa proprietà. Per disattivare la raccolta dell'input penna sull'oggetto InkCollector, impostare la proprietà Enabled su false. È possibile quindi impostare la proprietà MarginY e riattivare la raccolta dell'input penna sul controllo impostando la proprietà Enabled su true. In alternativa, utilizzare SetWindowInputRectangle per modificare l'area di input mentre l'oggetto InkCollector è attivato.

Esempi

Nell'esempio seguente il margine dell'asse Y del rettangolo di una finestra per un oggetto InkCollector viene impostato su cinque pixel.

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

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.