Ler em inglês

Compartilhar via


Atributos XML

Este tópico não é atual. Para obter as informações mais atuais, consulte o especificação de esquema de impressão.

Há vários atributos XML que aparecem em vários tipos de elemento definidos na Estrutura de Esquema de Impressão. 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 pelo nome e não pelo tipo de elemento host. Atributos XML definidos privadamente não são permitidos. Somente os atributos XML definidos aqui podem ser usados em um documento PrintCapabilities ou em um PrintTicket e, em seguida, somente no contexto definido.

Embora as partes privadas não tenham permissão para introduzir novas definições no namespace de outra parte, elas têm permissão para utilizar nomes existentes de outro namespace privado, desde que seu uso seja consistente com o uso estabelecido pela outra parte. Portanto, uma opção pode conter elementos ScoredProperty definidos por várias partes diferentes, cada uma residindo em namespaces diferentes.

Nome do atributo Tipos e valores de dados Propósito Anotações
nome
XML QName
Esse atributo XML identifica a instância do elemento. Ele distingue um elemento de outro do mesmo tipo de elemento. Esse atributo XML é tão amplamente usado que é chamado de atributo de nome.
As restrições a seguir pertencem ao atributo de nome.
  • O atributo de nome deve estar na forma de um QName definido por XML válido. Ou seja, ele deve ser qualificado por um namespace XML válido. Os QNames que aparecem como valores de atributos de nome devem ser explicitamente qualificados para namespace, mesmo se um namespace padrão for definido.
  • O conteúdo do caractere deve ser o de um QName definido por XML válido.
  • Os nomes definidos privadamente devem ser qualificados com um namespace associado exclusivamente à parte que introduziu o atributo de nome.
  • Requisito de exclusividade de irmão: nenhum elemento irmão pertencente ao mesmo tipo de elemento pode ter o mesmo atributo de nome. A única exceção são os elementos Option, em que o atributo de nome pode ser usado para definir uma opção. Portanto, elementos de opção de vários irmãos podem ter o mesmo atributo de nome.
  • Os seguintes tipos de elemento podem conter atributos de nome: Propriedade, ScoredProperty, ParameterDef, Option e Feature.
  • atributos de nome são necessários para aparecer em cada um dos tipos de elemento que os contêm, exceto no caso de alguns elementos da opção de esquema de impressão pública definida anteriormente, como DocumentNUp.
O exemplo a seguir mostra como identificar uma instância de opção usando um atributo 'name'. Essa é a maneira correta de definir elementos option. Um provedor não deve ter opções sem nome, a menos que 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 é usado na versão inicial do Print Schema Framework. Ele está documentado aqui para que o código de validação PrintCapabilities ou PrintTicket implementado para a versão inicial do Print Schema Framework possa processar as versões de esquema subsequentes sem erros.
Restrita
Enumeração
Valores permitidos:
  • Nenhum
  • 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 são listados em ordem, desde menos restritivos (Nenhum) até mais restritivos (DeviceSettings).
Nenhum
  • A opção não é restrita.
PrintTicketSettings
  • A opção é restrita pelas configurações do PrintTicket. Isso implica que alterar a configuração pode remover a restrição.
AdminSettings
  • A opção é restrita pelas configurações do administrador; a opção não pode ser habilitada pelo usuário.
DeviceSettings
  • A opção é restrita pelas configurações do dispositivo ou pelas opções de dispositivo fisicamente instaladas; a opção não pode ser habilitada pelo usuário ou pelo administrador.
Quando o provedor PrintCapabilities relata valores do atributo restrito, a restrição mais restritiva encontrada deve ser relatada. Por exemplo, se uma opção for restrita 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 URI (identificador de recurso uniforme) de namespace e o prefixo de namespace que aparece no QName XML. Você deve estabelecer esse link para o URI do namespace definido para a Estrutura de Esquema de Impressão antes de poder usar qualquer uma das marcas de elemento definidas pela Estrutura, Atributos, atributos de nome e assim por diante. Você pode declarar esse namespace como o padrão para evitar, na verdade, qualificar as marcas de elemento com um prefixo de namespace, embora todos os outros QNames precisem ser explicitamente qualificados. O namespace padrão deve ser definido no elemento raiz apropriado. Observe todas as regras e convenções XML relativas 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 das palavras-chave do esquema de impressão é 'https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords'.

especificação de esquema de impressão