Fonctionnalités LineDisplay (documentation du SDK POS pour .NET v1.14)

Un objet de service LineDisplay prend en charge, au minimum, la possibilité d’afficher des caractères sur l’appareil de sortie. En outre, l’appareil peut également prendre en charge des fonctionnalités supplémentaires, que l’objet de service expose à l’application en définissant des propriétés de fonctionnalité et en implémentant les méthodes et propriétés correspondantes.

Pour chaque fonctionnalité supplémentaire, il existe une propriété de fonctionnalité définie dans la classe LineDisplayBase. Les propriétés de fonctionnalité ne peuvent pas être interrogées tant que l’application n’a pas appelé Open sur l’objet de service. Par la suite, les propriétés de fonctionnalité indiquent quelles propriétés et méthodes peuvent être définies et appelées sur l’objet de service.

Cette section répertorie les fonctionnalités qu’un objet de service LineDisplay peut prendre en charge. Pour chaque fonctionnalité, il existe un attribut de fonctionnalité qui doit être défini par l’objet de service, ainsi qu’un ensemble de propriétés ou de méthodes qui seront utilisées par l’application pour accéder à ces fonctionnalités. Dans certains cas, la fonctionnalité est entièrement prise en charge dans LineDisplayBase et ne nécessite aucun code supplémentaire dans la classe d’objet de service.

Les propriétés de fonctionnalité sont implémentées en lecture seule afin d’empêcher l’application de modifier leurs valeurs. Cela signifie également qu’elles ne peuvent pas être définies directement par l’objet de service. Au lieu de cela, LineDisplayBase a une propriété protégée, Properties, qui retourne un objet LineDisplayProperties. Cette classe fournit des équivalents publics pour toutes les propriétés de fonctionnalité. Par exemple, pour annoncer qu’il prend en charge le clignotement, un objet de service écrit :

Properties.CapBlink = true;

And not:

CapBlink = true;

Défilement de la fenêtre avec texte défilant

L’objet de service peut prendre en charge des textes défilants horizontaux ou verticaux. Si le défilement horizontal est pris en charge, l’objet de service définit Properties.CapHMarquee sur true. De même, si le défilement vertical est pris en charge, Properties.CapVMarquee a la valeur true.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir ou obtenir le type de texte défilant :

DisplayMarqueeType MarqueeType {get, set; }

Attente entre chaque caractère

Un appareil d’affichage de ligne peut avoir la possibilité d’attendre une période spécifiée avant d’afficher chaque caractère pour créer un effet de télétype. Si cette fonctionnalité est prise en charge, la propriété Properties.CapICharWait a la valeur true.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir ou obtenir le temps d’attente inter-caractères :

int InterCharacterWait { get; set; }

Texte clignolant

Un appareil d’affichage de ligne peut prendre en charge le clignotement au niveau des caractères ou au niveau de l’appareil à des taux de clignotement réglables. Si cette fonctionnalité est prise en charge, l’objet de service doit définir la propriété Properties.CapBlink sur l’une des valeurs d’énumération Properties.DisplayBlink suivantes.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir ou obtenir le taux de clignotement :

int BlinkRate {get; set; }

Vidéo inversée

Un affichage de ligne peut prendre en charge la vidéo inversée au niveau des caractères ou au niveau de l’appareil. Si cette fonctionnalité est prise en charge, l’objet de service doit affecter à Properties.CapReverse une valeur dans l’énumération DisplayReverse.

La propriété CapReverse est utilisée par la méthode DisplayText.

Descripteurs de périphériques

Les descripteurs sont de petits indicateurs avec une étiquette fixe et sont généralement utilisés pour indiquer les états de transaction tels que l’élément, le total et la modification. L’objet de service doit définir Properties.CapDescriptors sur true si les descripteurs sont pris en charge.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir, obtenir ou effacer les descripteurs :

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

Contrôle de la luminosité

Tous les objets de service LineDisplay prennent en charge deux niveaux de luminosité, normal et vide, même s’ils ne sont pas pris en charge par l’appareil physique. Si l’appareil prend en charge des niveaux de luminosité supplémentaires, Properties.CapBrightness doit avoir la valeur true.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir ou obtenir la luminosité de l’appareil :

int DeviceBrightness {get; set; }

Attributs de curseur

Un appareil d’affichage de ligne peut prendre en charge différents types de curseurs. La propriété Properties.CapCursorType définit les types pris en charge. La propriété CapCursorType est définie à l’aide de l’énumération DisplayCursors et contient une indication au niveau du bit des types de curseurs pris en charge, qui peuvent être l’un des types suivants indiqués dans le tableau.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir ou obtenir le type de curseur :

DisplayCursorsCursorType { get; set; }

Glyphes

Les glyphes sont une définition utilisateur au niveau des pixels des cellules de caractères. Si les glyphes sont pris en charge par l’appareil, Properties.CapCustomGlyph doit avoir la valeur true.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir ou obtenir la liste de glyphes et les paramètres :

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

Mode de l’écran

Un appareil peut prendre en charge la modification du mode d’écran, c’est-à-dire le nombre de lignes et de colonnes affichées. Si cette fonctionnalité est prise en charge par l’appareil, l’objet de service doit définir Properties.CapScreenMode sur true.

Par la suite, l’application et l’objet de service peuvent utiliser les éléments suivants pour définir ou obtenir le mode écran :

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

Images bitmap

L’objet de service doit définir la propriété Properties.CapBitmap sur true si l’appareil prend en charge l’affichage des bitmaps.

L’objet de service peut vouloir remplacer les méthodes suivantes si cette fonctionnalité est prise en charge :

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

Character Sets

Un objet de service doit définir la propriété Properties.CapCharacterSet avec la fonctionnalité de jeu de caractères par défaut de l’appareil d’affichage de ligne. Cette propriété peut être définie sur un membre de l’énumération CharacterSetCapability, comme indiqué dans le tableau suivant.

Par la suite, les applications et les objets de service peuvent utiliser les éléments suivants pour définir ou obtenir le jeu de caractères :

int CharacterSet { get; set; }

Voir aussi

Tâches

• Exemple LineDisplay

Autres ressources

• Implémentation de LineDisplay