InkCollector.MarginY (Propiedad)
Actualización: noviembre 2007
Obtiene o establece los márgenes a lo largo del eje Y, en píxeles.
Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)
Sintaxis
'Declaración
Public Property MarginY As Integer
'Uso
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)
Valor de propiedad
Tipo: System.Int32
Márgenes a lo largo del eje Y, en píxeles.
Valor |
Significado |
|---|---|
Propiedad DefaultMargin |
El campo DefaultMargin del control InkCollector |
Int32 |
Márgenes definidos por la aplicación a lo largo del eje Y. |
Comentarios
Este margen proporciona un búfer en torno al borde de la ventana de entrada manuscrita. El campo DefaultMargin especifica el margen predeterminado que usa la propiedad MarginY.
Esta propiedad se usa con mayor frecuencia en dispositivos de Tablet PC no integrados. El búfer proporciona a los usuarios un margen de error cuando escriben en un dispositivo que no se corresponde exactamente con el tamaño de la pantalla.
Un margen positivo se extiende fuera de los límites del objeto InkCollector, un margen negativo se extiende dentro de los límites del control y un valor de cero no genera ningún margen. La entrada manuscrita se recopila si el trazo se inicia dentro del margen.
Este comportamiento no recorta la entrada manuscrita. Los límites del control son la propiedad GetWindowInputRectangle o el rectángulo cliente de la ventana.
El margen solo es efectivo en la ventana de la aplicación. Si la pluma se aplica fuera de la ventana de la aplicación, la aplicación pierde el foco y no puede recopilar la entrada manuscrita.
Nota
Se debe deshabilitar la recopilación de entradas manuscritas en el objeto InkCollector antes de establecer esta propiedad. Para deshabilitar la recopilación de entradas manuscritas en el objeto InkCollector, establezca la propiedad Enabled en false. A continuación, puede establecer la propiedad MarginY y volver a habilitar la recopilación de entradas manuscritas en el control estableciendo la propiedad Enabled en true. También puede usar el método SetWindowInputRectangle para cambiar el área de entrada mientras está habilitado el objeto InkCollector.
Ejemplos
En el ejemplo siguiente se establece el margen del eje Y de un rectángulo de ventana de un objeto InkCollector en cinco píxeles.
mInkCollector.Enabled = False
mInkCollector.MarginY = 5
mInkCollector.Enabled = True
mInkCollector.Enabled = false;
mInkCollector.MarginY = 5;
mInkCollector.Enabled = true;
Plataformas
Windows Vista
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Información de versión
.NET Framework
Compatible con: 3.0