InkRecognizerGuide (Clase)
Actualización: noviembre 2007
Representa el área que usa el objeto InkRecognizer y en la que se puede dibujar una entrada manuscrita. El área se conoce como recognizer guide.
Espacio de nombres: System.Windows.Ink
Ensamblado: IAWinFX (en IAWinFX.dll)
Sintaxis
'Declaración
Public Class InkRecognizerGuide
'Uso
Dim instance As InkRecognizerGuide
public class InkRecognizerGuide
public ref class InkRecognizerGuide
public class InkRecognizerGuide
public class InkRecognizerGuide
Comentarios
InkRecognizerGuide puede constar de filas y columnas, y da al reconocedor un mejor contexto en el que realizar el reconocimiento. Por ejemplo, puede dibujar líneas horizontales en la pantalla de un usuario, casi como en una página de papel pautado, que muestra dónde se debe insertar la entrada manuscrita (este tipo de guía sólo estaría compuesto por filas, sin columnas). Si un usuario escribe sobre las líneas, en lugar de en algún espacio arbitrario, mejorará la exactitud del reconocimiento. Por ejemplo, las letras como la "t" y la "I" se reconocen más fácilmente cuando se utiliza una guía para dar contexto a la entrada manuscrita.
InkRecognizerGuide especifica los límites donde se puede dibujar la entrada manuscrita definiendo dos rectángulos: drawn box y writing box. Los límites del cuadro dibujado son indicaciones visuales y los límites del cuadro de escritura no están visibles. Juntos especifican dónde puede tener lugar la escritura. El usuario normalmente escribe dentro de los límites de las líneas visibles del cuadro dibujado. Las propiedades DrawnBoxTop, DrawnBoxLeft, DrawnBoxBottom y DrawnBoxRight especifican el cuadro dibujado. Estas propiedades sólo puede utilizarlas el reconocedor. No basta con establecerlas para que en la pantalla aparezcan dibujadas pistas visuales. Debe dibujar las pistas visuales utilizando la aplicación o el control.
El cuadro de escritura es mayor que el cuadro dibujado y proporciona a los usuarios un margen de error por si insertan la entrada manuscrita fuera de las líneas del cuadro dibujado. Las propiedades WritingBoxTop, WritingBoxLeft, WritingBoxBottom y WritingBoxRight especifican el cuadro de escritura.
Además de dibujar líneas o reglas en la pantalla que indica a los usuarios dónde escribir, también es posible dibujar celdas en la pantalla en la que se escriben caracteres o palabras. Esto se denomina boxed input y resulta útil para algunos idiomas del este asiático. Para determinar si el reconocedor admite la entrada de cuadro, llame a la propiedad Capabilities del objeto InkRecognizer.
De forma predeterminada, la guía tiene todos los valores de propiedad establecidos en 0, lo que significa no hay ninguna guía. Debe utilizar las propiedades del objeto InkRecognizerGuide para establecer la guía.
Ejemplos
A continuación, se establecen todos los valores de InkRecognizerGuide simultáneamente.
Dim guideBoxTop As Double = 0
Dim guideBoxBottom As Double = 50
Dim guideBoxLeft As Double = 0
Dim guideBoxRight As Double = 600
Dim WRITINGBOXMARGIN As Integer = 10
' Find the midline of the guide box.
Dim midline As Double = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop
theGuide.Rows = 1
theGuide.Columns = 0
theGuide.Midline = midline
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN
theGuide.DrawnBoxLeft = guideBoxLeft
theGuide.DrawnBoxTop = guideBoxTop
theGuide.DrawnBoxRight = guideBoxRight
theGuide.DrawnBoxBottom = guideBoxBottom
double guideBoxTop = 0;
double guideBoxBottom = 50;
double guideBoxLeft = 0;
double guideBoxRight = 600;
const int WRITINGBOXMARGIN = 10;
// Find the midline of the guide box.
double midline = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop;
theGuide.Rows = 1;
theGuide.Columns = 0;
theGuide.Midline = midline;
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN;
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN;
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN;
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN;
theGuide.DrawnBoxLeft = guideBoxLeft;
theGuide.DrawnBoxTop = guideBoxTop;
theGuide.DrawnBoxRight = guideBoxRight;
theGuide.DrawnBoxBottom = guideBoxBottom;
Jerarquía de herencia
System.Object
System.Windows.Ink.InkRecognizerGuide
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
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
Vea también
Referencia
System.Windows.Ink (Espacio de nombres)
Recognizer
RecognizerContext