Ler em inglês

Compartilhar via


Atributos do XML

Esse tópico não é atual. Para obter as informações mais recentes, consulte Especificação do Esquema de impressão.

Existe uma série de atributos XML que aparecem em vários tipos de elementos definidos na Estrutura de Esquema de Impressão. Os atributos XML com o mesmo nome geralmente têm o mesmo significado e obedecem às mesmas regras, independentemente do tipo de elemento em que residem. Portanto, os atributos XML são listados aqui por nome e não por seu tipo de elemento host. Atributos XML definidos de forma privada não são permitidos. Somente os atributos XML definidos aqui podem ser utilizados em um documento PrintCapabilities ou em um PrintTicket, e somente no contexto definido.

Embora as partes privadas não tenham permissão para apresentar novas definições no namespace de outro grupo, elas podem usar nomes existentes de outro namespace privado, desde que seu uso seja consistente com o uso estabelecido pela outra parte. Assim, uma Opção pode conter elementos ScoredProperty definidos por vários grupos diferentes, cada um residindo em um namespace diferente.

Nome do Atributo Tipos de Dados e Valores Finalidade Observações
name
QName XML
Esse atributo XML identifica a instância do elemento. Distingue um elemento de outro do mesmo tipo de elemento. Esse atributo XML é tão amplamente utilizado que é referenciado como o atributo de nome.
As seguintes restrições se aplicam ao atributo de nome.
  • O atributo de nome deve estar na forma de um QName válido definido por XML. Ou seja, que será qualificado por um namespace XML válido. Os QNames que aparecem como valores dos atributos Nome devem ser explicitamente qualificados pelo namespace, mesmo se um namespace padrão for definido.
  • O conteúdo dos caracteres deve ser o de um QName válido definido por XML.
  • Os nomes definidos de forma privada devem ser qualificados com um namespace associado exclusivamente ao grupo que introduziu o atributo de nome.
  • Requisito de exclusividade entre irmãos: dois elementos irmãos pertencentes ao mesmo tipo de elemento não podem ter o mesmo atributo de nome. A única exceção são os elementos de Opção, em que o atributo de nome pode ser utilizado para definir uma Opção. Assim, vários elementos de Opção irmãos podem ter o mesmo atributo de nome.
  • Os seguintes tipos de elementos podem conter atributos de nome: Property, ScoredProperty, ParameterDef, Opção e Feature.
  • é obrigatório que os atributos Nome apareçam em cada um dos tipos de elementos que os contêm, exceto no caso de alguns elementos públicos previamente definidos da Estrutura de Esquema de Impressão, como o DocumentNUp.
O exemplo a seguir mostra como identificar uma instância de Opção utilizando um atributo 'nome'. Essa é a maneira correta de definir os elementos de Opção. Um provedor não deve ter opções sem nome, a menos que elas sejam definidas publicamente no Esquema de Impressão, como DocumentNUp.
  <psf:Option name="psk:StapleBottomRight">
    \<psf:ScoredProperty name="psk:Angle">
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    </psf:ScoredProperty>
    <psf:ScoredProperty name="psk:SheetCapacity" >
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    <psf:ScoredProperty>
  </psf:Option>
propagar
Enumeração
Nenhum valor está definido no momento.
O atributo propagado não é utilizado na versão inicial da Estrutura de Esquema de Impressão. Ele está documentado aqui para que o código de validação do PrintCapabilities ou do PrintTicket implementado para a versão inicial da Estrutura de Esquema de Impressão possa processar quaisquer versões subsequentes do esquema sem erros.
restringido
Enumeração
Valores permitidos:
  • Nenhuma
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
Indica se a opção está disponível para seleção ou para uso.
Os valores permitidos do atributo restrito têm os seguintes significados. Observe que esses valores estão listados em ordem, do menos restritivo (Nenhum) ao mais restritivo (DeviceSettings).
Nenhuma
  • A Opção não é restrita.
PrintTicketSettings
  • A Opção é limitada pelas configurações do PrintTicket. Isso implica que alterar a configuração pode remover a restrição.
AdminSettings
  • A Opção é limitada pelas configurações do administrador; a Opção não pode ser habilitada pelo usuário.
DeviceSettings
  • A Opção é limitada pelas configurações do dispositivo ou pelas opções do dispositivo fisicamente instalado; a Opção não pode ser habilitada pelo usuário ou pelo administrador.
Quando o provedor PrintCapabilities relata os valores do atributo restrito, deve ser relatada a restrição mais restritiva encontrada. Por exemplo, se uma Opção for restringida por uma configuração de administrador e uma configuração de dispositivo, o provedor PrintCapabilities deverá relatar DeviceSettings.
xmlns
URI
Esse atributo XML estabelece um vínculo entre um identificador de recurso uniforme (URI) de namespace e o prefixo do namespace que aparece no QName XML. Você deve estabelecer esse vínculo com o URI do namespace definido para a Estrutura de Esquema de Impressão antes de poder utilizar qualquer marca de elemento definida pela Estrutura, Atributos, Atributos de nome e assim por diante. Você pode declarar esse namespace como padrão para evitar a qualificação real das marcas de elementos com um prefixo de namespace, embora todos os outros QNames devam ser qualificados explicitamente. O namespace padrão precisa estar definido no elemento raiz apropriado. Observe todas as regras e convenções do XML com relação ao uso do atributo xmlns.
O URI da Estrutura de Esquema de Impressão é http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
O URI para as Palavras-chave do Esquema de Impressão é `https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords`.

Especificação do Esquema de Impressão