Variáveis padrão

Importante

Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft, juntamente com aplicativos de suporte de impressão (PSA), para personalizar a experiência de impressão em Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte o Guia de design do aplicativo de suporte de impressão.

A linguagem GPD define um conjunto de variáveis padrão que podem ser referenciadas dentro de cadeias de caracteres de comando, usando o formato de cadeia de caracteres de comando. O driver Unidrv atribui valores a essas variáveis. Do ponto de vista de um arquivo GPD, as variáveis são somente leitura.

Todas as variáveis padrão são armazenadas como inteiros DWORD.

A seguinte entrada de comando da impressora especifica a cadeia de caracteres de comando que é enviada para um HP LaserJet 4P quando um bloco de dados de raster está pronto:

*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"

A tabela a seguir contém todas as variáveis padrão, em ordem alfabética.

Nome da variável padrão	Valor	Comentários
BlueValue	Componente azul da cor atual.	Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry (consulte GreenValue, RedValue).
CurrentFontID	Número de identificação da fonte flexível baixada atualmente.	Válido se o trabalho de impressão atual incluir fontes suaves baixadas.
CurrentPaletteIndex	Índice atual na paleta de cores.	Válido para uso em cadeias de caracteres de comando CmdSelectPaletteEntry (consulte GreenValue, RedValue).
CursorOriginX	Coordenada X da origem do cursor, em unidades de master.	Válido sempre que um trabalho de impressão estiver em andamento.
CursorOriginY	Coordenada Y da origem do cursor, em unidades master.	Válido sempre que um trabalho de impressão estiver em andamento.
DestX	Coordenada X do destino do cursor, em master unidades, em relação à origem do cursor.	Válido para uso em cadeias de caracteres de comando CmdXMoveAbsolute.
DestXRel	Coordenada X do destino do cursor, em unidades de master, em relação à posição atual do cursor.	Válido para uso em cadeias de caracteres de comando CmdXMoveRelLeft e CmdXMoveRelRight.
DestY	Coordenada Y do destino do cursor, em unidades master, em relação à origem do cursor.	Válido para uso em cadeias de caracteres de comando CmdYMoveAbsolute.
DestYRel	Coordenada Y do destino do cursor, em unidades master, em relação à posição atual do cursor.	Válido para uso nas cadeias de caracteres de comando CmdYMoveRelUp e CmdYMoveRelDown.
FontBold	Defina como um se a fonte atual estiver em negrito ou zero caso contrário.	Válido quando uma fonte foi especificada.
Fontheight	Altura, em master unidades, da fonte atual.	Válido quando uma fonte foi especificada.
FontItalic	Defina como um se a fonte atual for itálica ou zero caso contrário.	Válido quando uma fonte foi especificada.
FontMaxWidth	Defina como o incremento máximo de caracteres de todos os glifos na fonte.	Válido quando uma fonte foi especificada.
FontStrikeThru	Defina como um se strike-through estiver habilitado para a fonte atual ou zero caso contrário.	Válido quando uma fonte foi especificada.
FontUnderLine	Defina como um se a fonte atual estiver sublinhada ou zero caso contrário.	Válido quando uma fonte foi especificada.
FontWidth	Largura, em master unidades, da fonte atual.	Válido quando uma fonte foi especificada.
GraphicsXRes	Resolução horizontal atual para gráficos, em DPI.	Válido sempre que um trabalho de impressão estiver em andamento.
GraphicsYRes	Resolução vertical atual para gráficos, em DPI.	Válido sempre que um trabalho de impressão estiver em andamento.
GrayPercentage	Nível de cinza (porcentagem) a ser usado para preenchimento cinza.	Válido para uso em cadeias de caracteres de comando CmdRectGrayFill.
GreenValue	Componente verde da cor atual.	Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry (consulte BlueValue, RedValue).
LinefeedSpacing	Quantidade de espaço vertical, em unidades master, representando um feed de linha.	Válido para uso em cadeias de caracteres de comando CmdSetLineSpacing.
NextFontID	Número de identificação da próxima fonte flexível a ser baixada.	Válido para uso em cadeias de caracteres de comando CmdSetFontID.
NextGlyph	O código de dois bytes do próximo glifo a ser baixado.	Válido para uso em cadeias de caracteres de comando CmdSetCharCode.
NumOfCopies	Número de cópias solicitadas pelo usuário.	Válido sempre que um trabalho de impressão estiver em andamento.
NumOfDataBytes	Número de bytes de dados raster prontos para transferência.	Válido para uso em qualquer cadeia de caracteres de comando CmdSendXXXData. Se os dados forem compactados, o valor será o número de bytes após a compactação.
PageNumber	O número da página que está sendo impressa no momento. Observe que isso não corresponde necessariamente ao número de página do aplicativo, mas sim ao número de vezes que DrvSendPage foi chamado. Esse valor é inicializado por DrvStartDoc e incrementado por DrvSendPage. Por exemplo, se N-up = 4 estiver selecionado, PageNumber será incrementado para 2 somente quando a quinta página do documento estiver sendo impressa. Como outro exemplo, se um documento for impresso em ordem inversa (de volta à frente), a variável padrão PageNumber ainda relatará a primeira página a ser impressa como página 1, mesmo que esta seja a última página do documento. Esse comportamento é necessário para dar suporte adequado ao recurso de duplicação automática. O OEM deve usar PageNumber somente para determinar se a página atual é o lado frontal ou traseiro.	Válido sempre que um trabalho de impressão estiver em andamento.
PaletteIndexToProgram	Indexe na paleta de cores para a próxima entrada ao programa.	Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry. (Confira também RedValue, GreenValue, BlueValue, CurrentPaletteIndex).
PatternBrushID	Número de identificação de um pincel de padrão baixado.	Válido para uso com cadeias de caracteres de comando CmdDownloadPattern e CmdSelectPattern.
PatternBrushSize	Tamanho, em bytes, do pincel padrão atual.	Válido para uso com a cadeia de caracteres de comando CmdDownloadPattern.
PatternBrushType	Tipo do pincel de padrão atual. O valor pode ser: 2: Padrão de sombreamento 3: padrão entre hatches 4: padrão definido pelo usuário.	Válido para uso com cadeias de caracteres de comando CmdDownloadPattern e CmdSelectPattern.
PhysPaperLength	Comprimento do modo retrato, em unidades de master y, do papel atualmente em uso.	Válido sempre que um trabalho de impressão estiver em andamento.
PhysPaperWidth	Largura do modo retrato, em unidades master, do papel atualmente em uso.	Válido sempre que um trabalho de impressão estiver em andamento.
PrintDirInCCDegrees	Quantidade de rotação, medida no sentido anti-horário, em graus.	Válido quando o driver envia a cadeia de caracteres de comando CmdSetSimpleRotation ou CmdSetAnyRotation.
RasterDataHeightInPixels	Altura, em pixels, da imagem representada pelos dados atuais.	Válido para uso em qualquer cadeia de caracteres de comando CmdSendXXXData e em Cadeias de caracteres de comando CmdSetSrcBmpHeight. A compactação não modifica esse valor.
RasterDataWidthInBytes	Número de bytes contidos em uma linha de verificação.	Válido para uso em qualquer cadeia de caracteres de comando CmdSendXXXData e em Cadeias de caracteres de comando CmdSetSrcBmpWidth. A compactação não modifica esse valor.
RectXSize	Largura do retângulo, em unidades de master x.	Válido para uso em cadeias de caracteres de comando CmdSetRectWidth.
Redimensionar	Comprimento do retângulo, em unidades de master y.	Válido para uso em cadeias de caracteres de comando CmdSetRectHeight.
RedValue	Componente vermelho da cor atual.	Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry (consulte GreenValue, BlueValue).
TextXRes	Resolução horizontal atual para texto, em DPI.	Válido sempre que um trabalho de impressão estiver em andamento.
TextYRes	Resolução vertical atual para texto, em DPI.	Válido sempre que um trabalho de impressão estiver em andamento.