Funcionalidad de LineDisplay (documentación del SDK de POS para .NET v1.14)

Un objeto de servicio LineDisplay admite, como mínimo, la capacidad de mostrar caracteres en el dispositivo de salida. Además, el dispositivo también puede admitir características adicionales, que el objeto de servicio expone a la aplicación estableciendo propiedades de funcionalidad e implementando los métodos y propiedades correspondientes.

Para cada característica adicional, se define una propiedad de funcionalidad en la clase LineDisplayBase. Puede que las propiedades de funcionalidad no se consulten hasta que la aplicación haya llamado a Open en el objeto de servicio. Después, las propiedades de funcionalidad indicarán qué propiedades y métodos se pueden establecer y llamar en el objeto de servicio.

En esta sección se enumeran las características que un objeto de servicio LineDisplay puede admitir. Para cada característica, hay un atributo de funcionalidad que el objeto de servicio debe establecer, así como un conjunto de propiedades o métodos que la aplicación usará para acceder a estas características. En algunos casos, la característica es totalmente compatible con LineDisplayBase y no requiere código adicional en la clase del objeto de servicio.

Las propiedades de funcionalidad se implementan como de solo lectura para evitar que la aplicación cambie sus valores. Esto significa también que el objeto de servicio no las puede establecer directamente. En cambio, LineDisplayBase tiene una propiedad protegida, Properties, que devuelve un objeto LineDisplayProperties. Esta clase proporciona equivalentes públicos para todas las propiedades de funcionalidad. Por ejemplo, para anunciar que admite parpadeo, un objeto de servicio escribiría:

Properties.CapBlink = true;

Y no:

CapBlink = true;

Desplazamiento de ventana de tipo marquesina

El objeto de servicio puede admitir marquesinas horizontales o verticales. Si se admite el desplazamiento horizontal, el objeto de servicio establece Properties.CapHMarquee en true. Del mismo modo, si se admite el desplazamiento vertical, se establece Properties.CapVMarquee en true.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer u obtener el tipo de marquesina:

DisplayMarqueeType MarqueeType {get, set; }

Espera entre caracteres

Un dispositivo de visualización lineal puede tener la capacidad de esperar un determinado período de tiempo antes de mostrar cada carácter, para crear un efecto de teletipo. Si se admite esta característica, la propiedad Properties.CapICharWait se establece en true.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer u obtener el tiempo de espera entre caracteres:

int InterCharacterWait { get; set; }

Texto parpadeante

Un dispositivo de visualización lineal puede admitir el parpadeo de nivel de carácter o de dispositivo a una velocidad ajustable. Si se admite esta característica, el objeto de servicio debe establecer la propiedad Properties.CapBlink en uno de los siguientes valores de la enumeración Properties.DisplayBlink.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer u obtener la velocidad de parpadeo:

int BlinkRate {get; set; }

Vídeo inverso

Una pantalla de visualización lineal puede admitir vídeo inverso de nivel de caracteres o de nivel de dispositivo. Si se admite esta característica, el objeto de servicio debe establecer Properties.CapReverse en un valor de la enumeración DisplayReverse.

El método DisplayText usa la propiedad CapReverse.

Descriptores de dispositivo

Los descriptores son pequeños indicadores con una etiqueta fija que suelen utilizarse para indicar estados de transacción, como artículo, total y cambio. El objeto de servicio debe establecer Properties.CapDescriptors en true si se admiten descriptores.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer, obtener o borrar los descriptores:

• int DeviceDescriptors {get; set; }
• void ClearDescriptors();
• void SetDescriptor(int descriptor, DisplaySetDescriptor attribute);

Control de brillo

Todos los objetos de servicio LineDisplay admiten dos niveles de brillo, normal y en blanco, incluso si el dispositivo físico no lo admite. Si el dispositivo admite más niveles de brillo, Properties.CapBrightness debe establecerse en true.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer u obtener el brillo del dispositivo:

int DeviceBrightness {get; set; }

Atributos del cursor

Un dispositivo de visualización lineal puede admitir una gran variedad de tipos de cursor diferentes. La propiedad Properties.CapCursorType define cuáles de estos tipos se admiten. La propiedad CapCursorType se establece con la enumeración DisplayCursors y contiene una indicación bit a bit de los tipos de cursor admitidos, que pueden ser cualquiera de los siguientes que se muestran en la tabla.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer u obtener el tipo de cursor:

DisplayCursorsCursorType { get; set; }

Glifos

Los glifos son una definición de celdas de caracteres de nivel de píxel que crea el usuario. Si el dispositivo admite glifos, la propiedad Properties.CapCustomGlyph debe establecerse en true.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer u obtener la lista y la configuración de glifos:

• RangeOfCharacters[] CustomGlyphList { get; set; }
• int GlyphHeight { get; }
• int GlyphWidth { get; }
• void DefineGlyph(int glyphCode, byte[] glyph);

Modos de pantalla

Un dispositivo puede admitir el cambio de modo de pantalla, es decir, el número de filas y columnas que se muestran. Si el dispositivo admite esta característica, el objeto de servicio debe establecer Properties.CapScreenMode en true.

Después, la aplicación y el objeto de servicio pueden usar lo siguiente para establecer u obtener el modo de pantalla:

• int ScreenMode { get; set; }
• DisplayScreenMode[] ScreenModeList { get; }

Mapas de bits

El objeto de servicio debe establecer la propiedad Properties.CapBitmap en true si el dispositivo admite la visualización de mapas de bits.

Es posible que el objeto de servicio quiera invalidar los siguientes métodos si se admite esta funcionalidad:

• void DisplayBitmap(string fileName, int alignmentX, int alignmentY);
• void DisplayBitmap(string fileName, int width, int alignmentX, int alignmentY);

Juegos de caracteres

Un objeto de servicio debe establecer la propiedad Properties.CapCharacterSet con la funcionalidad de juego de caracteres predeterminada del dispositivo de visualización lineal. Esta propiedad se puede establecer en un miembro de la enumeración CharacterSetCapability, como se muestra en la siguiente tabla.

Después, las aplicaciones y los objetos de servicio pueden usar lo siguiente para establecer u obtener el juego de caracteres:

int CharacterSet { get; set; }

Consulte también

Tareas

• Ejemplo de LineDisplay

Otros recursos

• Implementación de LineDisplay