InkCollector.MarginX (Propiedad)
Actualización: noviembre 2007
Obtiene o establece los márgenes a lo largo del eje X, en píxeles.
Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)
Sintaxis
'Declaración
Public Property MarginX As Integer
'Uso
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)
Valor de propiedad
Tipo: System.Int32
Márgenes a lo largo del eje X, en píxeles.
Valor |
Significado |
|---|---|
Propiedad DefaultMargin |
El campo DefaultMargin del control InkCollector |
Int32 |
Los márgenes definidos por la aplicación a lo largo del eje X. |
Comentarios
Este margen proporciona un búfer en torno al borde de la ventana de la entrada manuscrita. El campo DefaultMargin especifica el margen predeterminado que usa la propiedad MarginX.
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 MarginX 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 X de un rectángulo de ventana de un objeto InkCollector en cinco píxeles.
mInkCollector.Enabled = False
mInkCollector.MarginX = 5
mInkCollector.Enabled = True
mInkCollector.Enabled = false;
mInkCollector.MarginX = 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