Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este tópico não é atual. Para obter as informações mais atuais, consulte o especificação de esquema de impressão.
Um elemento ParameterDef difere de um elemento ParameterInit, pois descreve o valor que um elemento ParameterInit pode conter, enquanto um elemento ParameterInit atribui um valor ao parâmetro. Um elemento ParameterDef consiste em um conjunto específico de elementos property, que são filhos do elemento ParameterDef, que especificam o tipo de dados, máximo, mínimo e valores padrão para os dados e outras informações. Esses elementos de propriedade são discutidos posteriormente neste tópico.
Os elementos ParameterDef só podem aparecer no contexto permitido. Para a versão inicial do Esquema de Impressão, eles podem estar localizados no nível raiz do documento PrintCapabilities. O atributo de nome do elemento ParameterDef define o nome do parâmetro. Cada elemento ParameterDef no documento PrintCapabilities deve receber um atributo de nome exclusivo.
Nota
para imprimir provedores de documentos de funcionalidades:
O significado de um nome de parâmetro é universal; ou seja, se um elemento ParameterDef em um documento PrintCapabilities tiver o mesmo atributo de nome (a cadeia de caracteres formada do namespace e o nome descritivo do elemento ParameterDef) como um elemento ParameterDef em outro documento PrintCapabilities, supõe-se que ambos os elementos representem o mesmo conceito e devem ser interpretados da mesma maneira. Portanto, um elemento ParameterDef definido em um PrintTicket para um documento PrintCapabilities pode ser usado para inicializar o elemento ParameterInit com o mesmo nome definido em um documento PrintCapabilities diferente.
Relação com atributos XML
Como é verdadeiro para todos os atributos de nome, o nome do parâmetro está na forma de um QName XML. Um constructo de parâmetro definido por esquema tem um nome qualificado pelo namespace público, formando o atributo de nome, enquanto o atributo de nome de um constructo de parâmetro definido privadamente é qualificado por um namespace privado exclusivo para o criador.
Relação entre tipos de elemento ParameterDef e Property
Os elementos ParameterDef definidos nas palavras-chave do esquema de impressão devem ser totalmente definidos em um documento PrintCapabilities. O documento Palavras-chave do Esquema de Impressão fornece valores nominais para alguns elementos de propriedade de um elemento ParameterDef (como DefaultValue e outros), mas o autor de um documento PrintCapabilities é responsável por definir os elementos de Propriedade restantes. De qualquer forma, todos os elementos de propriedade devem ser definidos explicitamente em um elemento ParameterDef, incluindo aqueles que são definidos nas palavras-chave do esquema de impressão.
Determinados elementos de propriedade de cada elemento ParameterDef que aparecem nas palavras-chave do esquema de impressão são designados como imutável. Isso significa que todas as definições de documento PrintCapabilities dos elementos ParameterDef definidos por palavras-chave de esquema de impressão devem preservar esses elementos de propriedade sem modificação. Esses elementos de propriedade imutável permitem que os constructos de parâmetro sejam portáteis e inequívocos em todos os documentos PrintCapabilities. Um exemplo principal são as unidades usadas em um elemento ParameterDef. Essas unidades devem ser imutáveis, para promover uma compreensão consistente de seu significado. Os elementos de propriedade de um ParameterDef designados como não imutáveis podem ser redefinidos em um documento PrintCapabilities.
Um elemento ParameterDef é composto dos seguintes elementos de propriedade. Todos devem estar presentes, a menos que indicado de outra forma.
| Nome da propriedade | Valores | Descrição | Imutável? |
|---|---|---|---|
| Datatype |
inteiro decimal corda Nenhum valor padrão. |
Especifica se o valor do parâmetro é um inteiro ou um número de ponto flutuante ou uma cadeia de texto. O valor de um parâmetro é expresso no mesmo formato que o tipo de dados básico XSD correspondente; ou seja, como um inteiro, decimal ou cadeia de caracteres. |
Sim |
| DefaultValue |
O tipo especificado pela Propriedade DataType. Nenhum valor padrão. |
Especifica o valor com o qual inicializar um controle de interface do usuário (interface do usuário).
|
Não |
| Obrigatório |
Incondicional: o elemento ParameterInit sempre deve ser fornecido. Condicional: o elemento ParameterInit será necessário somente se o parâmetro for referenciado dentro de um elemento Option em um PrintTicket. DefaultValue: Condicional. |
Indica quando um elemento ParameterInit deve aparecer explicitamente. Se condicional, o ParameterInit deverá ser inicializado se o PrintTicket contiver uma opção que faça referência ao parâmetro. Usado por clientes de interface do usuário e provedores PrintCapabilities ou PrintTicket. Observe que, em qualquer restrição, a Propriedade Obrigatória do elemento ParameterDef deve ser definida como Incondicional. O ParameterDef deve ter um valor definido, caso contrário, o valor ou restrição dependente não pôde ser avaliado. |
Não |
| MaxLength |
inteiro se a Propriedade DataType especificar cadeia de caracteres. DefaultValue: nenhum valor máximo é imposto. |
Para parâmetros com valor de cadeia de caracteres, especifica a cadeia de caracteres mais longa permitida. Os provedores IU e PrintCapabilities ou PrintTicket usam essa propriedade para validar o elemento ParameterDef. |
Não |
| MaxValue |
inteiro se a Propriedade DataType especificar inteiro. decimal se a Propriedade DataType especificar decimal. DefaultValue: nenhum valor máximo é imposto. |
Para elementos ParameterDef com valor inteiro ou decimal, define o maior valor permitido. |
Não |
| MinLength |
inteiro se a Propriedade DataType especificar cadeia de caracteres. DefaultValue: nenhum valor mínimo é imposto. |
Para valores de cadeia de caracteres, define a cadeia de caracteres mais curta permitida. Os provedores IU e PrintCapabilities ou PrintTicket usam essa propriedade para validar o elemento ParameterDef. |
Não |
| MinValue |
inteiro se a Propriedade DataType especificar inteiro. decimal se a Propriedade DataType especificar decimal. DefaultValue: nenhum valor mínimo é imposto. |
Para parâmetros inteiros ou com valor decimal, define o menor valor permitido. |
Não |
| Múltiplo |
inteiro se a Propriedade DataType especificar inteiro. decimal se a Propriedade DataType especificar decimal. DefaultValue: 1 |
Para parâmetros inteiros ou com valor decimal, o valor do parâmetro deve ser um múltiplo desse número. Para obter mais informações, consulte Anotações sobre vários seguindo esta tabela. |
Não |
| UnitType |
valor da cadeia de caracteres que indica as unidades usadas para o parâmetro. Nenhum valor padrão. |
Indica as unidades nas quais o parâmetro é expresso. Por exemplo, ângulos em décimos de graus, comprimentos em microns e assim por diante. |
Sim |
Anotações sobre múltiplos
Para elementos ParameterInit com valores inteiros ou decimais, o valor do ParameterInit deve ser um múltiplo desse número. Por exemplo, os elementos ParameterInit com valor decimal podem ser limitados a décimos definindo essa propriedade como 0,1. Os elementos de interface do usuário usam essa Propriedade quando constrói diálogos e controles de interface do usuário. Além disso, o código de validação PrintTicket pode usar essa Propriedade para arredondar o valor de um ParameterInit para o valor mais próximo indicado por Multiple. Observação: os drivers de dispositivo e os provedores PrintCapabilities não devem assumir que os valores ParameterInit são múltiplos desse valor de propriedade. Cada provedor deve ser capaz de arredondar valores arbitrários para o valor utilizável mais próximo devido à possibilidade de que diferentes provedores possam especificar valores diferentes e conflitantes para essa propriedade.