RecognizerGuide.Columns (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece el número de columnas del cuadro guía de reconocimiento.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Property Columns As Integer
'Uso
Dim instance As RecognizerGuide
Dim value As Integer

value = instance.Columns

instance.Columns = value

public int Columns { get; set; }

public:
property int Columns {
    int get ();
    void set (int value);
}

/** @property */
public int get_Columns()
/** @property */
public  void set_Columns(int value)

public function get Columns () : int
public function set Columns (value : int)

Valor de propiedad

Tipo: System.Int32
El número de columnas del cuadro de guía.

Comentarios

El tamaño del cuadro dibujado determina el ancho de la columna. Para obtener o establecer el cuadro dibujado, utilice la propiedad DrawnBox.

Utilice los valores de las propiedades Rows y Columns para controlar el tipo de entrada de reconocimiento utilizada. Cuando las propiedades Columns y Rows son mayores que cero, se utiliza la entrada en caja. La tabla siguiente enumera los posibles modos de entrada y en qué valores se deben establecer las propiedades Rows y Columns para cada modo.

Para este tipo de entrada	Establezca la propiedad Rows en	Y establezca la propiedad Columns en
Entrada libre	0	0
Entrada de línea vertical con 1 línea	0	1
Entrada de línea vertical con n líneas	0	n
Entrada de línea horizontal con 1 línea	1	0
Entrada de línea horizontal con n líneas	n	0
Entrada de cuadro con 1 cuadro	1	1
Entrada de cuadro con 1 columna de n cuadros	1	n
Entrada de cuadro en una cuadrícula de cuadros con x filas por z columnas	x	z

Ejemplos

En este ejemplo, se crea una instancia del objeto RecognizerContext y se asigna la propiedad Guide creando un nuevo objeto RecognizerGuide.

' create a new RecognizerContext object
mRecognizerContext = New RecognizerContext()
' if the Recognizer supports LinedInput, set the Guide
If (mRecognizerContext.Recognizer.Capabilities And RecognizerCapabilities.LinedInput) <> 0 Then
    ' get the lower right corner in pixel units
    Dim lowerRight As Point = New Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height)
    ' convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(Me.CreateGraphics(), lowerRight)
    ' create Rectangles
    Dim writingBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    Dim drawnBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    ' shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100)
    ' create Guide with 8 rows, zero columns, and no midline
    Dim guide As RecognizerGuide = New RecognizerGuide(8, 0, 0, writingBox, drawnBox)
    mRecognizerContext.Guide = guide
End If

// create a new RecognizerContext object
mRecognizerContext = new RecognizerContext();
// if the Recognizer supports LinedInput, set the Guide
if ((mRecognizerContext.Recognizer.Capabilities & RecognizerCapabilities.LinedInput) != 0)
{
    // get the lower right corner in pixel units
    Point lowerRight = new Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height);
    // convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(this.CreateGraphics(), ref lowerRight);
    // create Rectangles
    Rectangle writingBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    Rectangle drawnBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    // shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100);
    // create Guide with 8 rows, zero columns, and no midline
    RecognizerGuide guide = new RecognizerGuide(8, 0, 0, writingBox, drawnBox);
    mRecognizerContext.Guide = guide;
}

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.