Udostępnij za pośrednictwem

Atrybuty XML

Ten temat nie jest aktualny. Aby uzyskać najbardziej aktualne informacje, zobacz Print Schema Specification.

Istnieje wiele atrybutów XML, które są wyświetlane w kilku typach elementów zdefiniowanych w strukturze schematu wydruku. Atrybuty XML o tej samej nazwie zwykle mają takie samo znaczenie i przestrzegają tych samych reguł niezależnie od typu elementu, w którym się znajdują. W związku z tym atrybuty XML są wymienione tutaj według nazwy, a nie według ich typu elementu hosta. Atrybuty XML zdefiniowane prywatnie nie są dozwolone. Tylko atrybuty XML zdefiniowane w tym miejscu mogą być używane w dokumencie PrintCapabilities lub PrintTicket, a następnie tylko w zdefiniowanym kontekście.

Chociaż strony prywatne nie mogą wprowadzać nowych definicji do przestrzeni nazw innej firmy, mogą korzystać z istniejących nazw z innej prywatnej przestrzeni nazw, o ile jej użycie jest zgodne z użyciem ustalonym przez inną stronę. W związku z tym opcja może zawierać elementy ScoredProperty zdefiniowane przez kilka różnych stron, z których każda znajduje się w różnych przestrzeniach nazw.

Nazwa atrybutu Typy danych i wartości Cel Notatki
nazwa
XML QName
 Ten atrybut XML identyfikuje wystąpienie elementu. Odróżnia jeden element od innego tego samego typu elementu. Ten atrybut XML jest tak powszechnie używany, że jest określany jako atrybut name.
 Następujące ograniczenia dotyczą atrybutu name.
  • Atrybut name musi mieć postać prawidłowej nazwy QName zdefiniowanej przez kod XML. Oznacza to, że musi być kwalifikowana przez prawidłową przestrzeń nazw XML. Nazwy QName wyświetlane jako wartości atrybutów nazw muszą być jawnie kwalifikowane w przestrzeni nazw, nawet jeśli zdefiniowano domyślną przestrzeń nazw.
  • Zawartość znaku musi być prawidłową nazwą QName zdefiniowaną przez kod XML.
  • Nazwy zdefiniowane prywatnie muszą być kwalifikowane z przestrzenią nazw, która jest unikatowo skojarzona ze stroną, która wprowadziła atrybut name.
  • Wymaganie unikatowości elementu równorzędnego: Żadne dwa elementy równorzędne należące do tego samego typu elementu mogą mieć ten sam atrybut o nazwie. Jedynym wyjątkiem są elementy opcji, w których atrybut name może służyć do definiowania opcji. W związku z tym elementy opcji wielu elementów równorzędnych mogą mieć ten sam atrybut nazwy.
  • Następujące typy elementów mogą zawierać atrybuty nazw: Właściwość, ScoredProperty, ParameterDef, Option i Feature.
  • Atrybuty nazwy są wymagane do wyświetlenia w każdym z typów elementów, które je zawierają, z wyjątkiem niektórych wcześniej zdefiniowanych elementów opcji schematu drukowania publicznego, takich jak DocumentNUp.
W poniższym przykładzie pokazano, jak zidentyfikować wystąpienie opcji przy użyciu atrybutu "name". Jest to poprawny sposób definiowania elementów opcji. Dostawca nie powinien mieć nienazwanych opcji, chyba że są one publicznie zdefiniowane w schemacie wydruku, takim jak 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>
Propagowanie
Wyliczenie
Obecnie nie zdefiniowano żadnych wartości.
 Atrybut propagacji nie jest używany w początkowej wersji struktury schematu wydruku. Opisano to tutaj, aby kod weryfikacji PrintCapabilities lub PrintTicket zaimplementowany dla początkowej wersji struktury schematu wydruku mógł przetwarzać wszelkie kolejne wersje schematu bez błędu.
Ograniczone
Wyliczenie
Dozwolone wartości:
  • Żaden
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
Wskazuje, czy opcja jest dostępna do wyboru, czy do użycia.
Dozwolone wartości atrybutu ograniczonego mają następujące znaczenie. Należy pamiętać, że te wartości są wymienione w kolejności od najmniej restrykcyjnych (Brak) do najbardziej restrykcyjnych (DeviceSettings).
Żaden
  • Opcja nie jest ograniczona.
PrintTicketSettings
  • Opcja jest ograniczona przez ustawienia PrintTicket. Oznacza to, że zmiana konfiguracji może usunąć ograniczenie.
AdminSettings
  • Opcja jest ograniczona przez ustawienia administratora; Użytkownik nie może włączyć opcji.
DeviceSettings
  • Opcja jest ograniczona przez ustawienia urządzenia lub opcje urządzenia zainstalowanego fizycznie; Opcja nie może być włączona przez użytkownika lub administratora.
Gdy dostawca PrintCapabilities zgłasza wartości ograniczonego atrybutu, należy zgłosić najbardziej restrykcyjne ograniczenie. Jeśli na przykład opcja jest ograniczona zarówno przez ustawienie administratora, jak i ustawienie urządzenia, dostawca PrintCapabilities powinien zgłosić ustawienie DeviceSettings.
xmlns
URI
 Ten atrybut XML ustanawia połączenie między identyfikatorem URI (URI) przestrzeni nazw i prefiksem przestrzeni nazw, który pojawia się w pliku XML QName. Należy ustanowić taki link do identyfikatora URI przestrzeni nazw zdefiniowanego dla struktury schematu wydruku, aby można było użyć dowolnego tagu elementu zdefiniowanego przez platformę, atrybutów, atrybutów nazw itd. Tę przestrzeń nazw można zadeklarować jako domyślną, aby uniknąć faktycznego kwalifikowania tagów elementów z prefiksem przestrzeni nazw, chociaż wszystkie inne nazwy QName muszą być jawnie kwalifikowane. Przestrzeń nazw standardowa musi być zdefiniowana w odpowiednim elemecie głównym. Obserwuj wszystkie reguły i konwencje XML dotyczące używania atrybutu xmlns.
Identyfikator URI dla struktury schematu wydruku jest http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
Identyfikator URI słów kluczowych schematu wydruku to "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords".

specyfikacji schematu drukowania

  • Last updated on