Funcionalidades do LineDisplay (POS para documentação do SDK do .NET v1.14)

Um Objeto de Serviço LineDisplay dá suporte, no mínimo, à capacidade de exibir caracteres no dispositivo de saída. Além disso, o dispositivo também pode dar suporte a recursos adicionais, que o Objeto de Serviço expõe ao aplicativo definindo propriedades de funcionalidade e implementando seus métodos e propriedades correspondentes.

Para cada recurso adicional, há uma propriedade de funcionalidade definida na classe LineDisplayBase. As propriedades de funcionalidade podem não ser consultadas até que o aplicativo tenha chamado Open no Objeto de Serviço. Depois disso, as propriedades de funcionalidade indicarão quais propriedades e métodos podem ser definidos e chamados no Objeto de Serviço.

Esta seção lista os recursos aos quais um Objeto de Serviço LineDisplay pode dar suporte. Para cada recurso, há um atributo de funcionalidade que deve ser definido pelo Objeto de Serviço, bem como um conjunto de propriedades ou métodos que serão usados pelo aplicativo para acessar esses recursos. Em alguns casos, o recurso tem suporte total no LineDisplayBase e não requer nenhum código adicional na classe de Objeto de Serviço.

As propriedades de funcionalidade são implementadas como somente leitura para impedir que o aplicativo altere seus valores. Isso significa, também, que eles não podem ser definidos diretamente pelo Objeto de Serviço. Em vez disso, LineDisplayBase tem uma propriedade protegida, Properties, que retorna um objeto LineDisplayProperties. Essa classe fornece equivalentes públicos para todas as propriedades de funcionalidade. Por exemplo, para anunciar que dá suporte ao piscar, um Objeto de Serviço gravaria:

Properties.CapBlink = true;

E não:

CapBlink = true;

Rolagem semelhante ao letreiro da Janela

O Objeto de Serviço pode dar suporte a letreiros horizontais ou verticais. Se houver suporte para rolagem horizontal, o Objeto de Serviço definirá Properties.CapHMarquee como true. Da mesma forma, se houver suporte para rolagem vertical, Properties.CapVMarquee será definido como true.

Depois disso, aplicativos e Objetos de Serviço podem usar o seguinte para definir ou obter o tipo de letreiro:

DisplayMarqueeType MarqueeType {get, set; }

Inter-Character Wait

Um dispositivo de exibição de linha pode ter a capacidade de aguardar um período de tempo especificado antes de exibir cada caractere para criar um efeito de teletipo. Se esse recurso tiver suporte, a propriedade Properties.CapICharWait será definida como true.

Depois disso, os aplicativos e Objetos de Serviço podem usar o seguinte para definir ou obter o tipo de inter-character wait:

int InterCharacterWait { get; set; }

Texto piscando

Um dispositivo de exibição de linha pode dar suporte ao nível do caractere ou do dispositivo piscando em taxas de intermitência ajustáveis. Se esse recurso tiver suporte, o Objeto de Serviço deverá definir a propriedade Properties.CapBlink como um dos seguintes valores de enumeração Properties.DisplayBlink.

Depois disso, aplicativos e Objetos de Serviço podem usar o seguinte para definir ou obter a taxa de intermitência:

int BlinkRate {get; set; }

Vídeo reverso

Uma exibição de linha pode dar suporte a vídeo reverso no nível do caractere ou no nível do dispositivo. Se esse recurso tiver suporte, o Objeto de Serviço deverá definir Properties.CapReverse como um valor na enumeração DisplayReverse.

A propriedade CapReverse é usada pelo método DisplayText.

Descritores de dispositivo

Os descritores são indicadores pequenos com um rótulo fixo e normalmente são usados para indicar estados de transação, como item, total e alteração. O Objeto de Serviço deve definir Properties.CapDescriptors como true se houver suporte para descritores.

Depois disso, aplicativos e Objetos de Serviço podem usar o seguinte para definir, obter, ou desmarcar os Descritores:

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

Controle de brilho

Todos os Objetos de Serviço LineDisplay dão suporte a dois níveis de brilho, normais e em branco, mesmo que não sejam compatíveis com o dispositivo físico. Se o dispositivo der suporte a níveis de brilho adicionais, então Properties.CapBrightness deverá ser definido como true.

Depois disso, aplicativos e Objetos de Serviço podem usar o seguinte para definir ou obter o brilho do dispositivo:

int DeviceBrightness {get; set; }

Atributos do cursor

Um dispositivo de exibição de linha pode dar suporte a uma variedade de tipos de cursor diferentes. A propriedade Properties.CapCursorType define quais desses tipos têm suporte. A propriedade CapCursorType é definida usando a enumeração DisplayCursors e contém uma indicação bit a bit dos tipos de cursor com suporte, que podem ser qualquer um dos tipos a seguir mostrados na tabela.

Depois disso, aplicativos e Objetos de Serviço podem usar o seguinte para definir ou obter o tipo de cursor:

DisplayCursorsCursorType { get; set; }

Glifos

Os glifos são uma definição de usuário de nível de pixel de células de caracteres. Se houver suporte para glifos no dispositivo, então Properties.CapCustomGlyph deverá ser definido como true.

Depois disso, aplicativos e Objetos de Serviço podem usar o seguinte para definir ou obter a lista de glifo e as configurações:

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

Modos de tela

Um dispositivo pode dar suporte à alteração do modo de tela; ou seja, o número de linhas e colunas exibidas. Se esse recurso for compatível com o dispositivo, o Objeto de Serviço deverá definir Properties.CapScreenMode como true.

Depois disso, o aplicativo e o Objeto de Serviço podem usar o seguinte para definir ou obter o modo de tela:

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

Bitmaps

O Objeto de Serviço deverá definir a propriedade Properties.CapBitmap como true se o dispositivo der suporte à exibição de bitmaps.

O Objeto de Serviço talvez queira substituir os seguintes métodos se essa funcionalidade tiver suporte:

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

Conjuntos de caracteres

Um Objeto de Serviço deve definir a propriedade Properties.CapCharacterSet com a funcionalidade de conjunto de caracteres padrão do dispositivo de exibição de linha. Essa propriedade pode ser definida como um membro da enumeração CharacterSetCapability, conforme mostrado na tabela a seguir.

Depois disso, os aplicativos e Objetos de Serviço podem usar o seguinte para definir ou obter o tipo de caractere:

int CharacterSet { get; set; }

Consulte Também

Tarefas

• Exemplo de LineDisplay

Outros recursos

• Implementação de LineDisplay