ParameterDef ve ParameterInit Öğeleri

Bu konu güncel değil. En güncel bilgiler için bkz. Yazdırma Şeması Belirtimi.

ParameterDef öğesi, parameterInit öğesinin içerebileceği değeri tanımladığı için bir ParameterInit öğesinden farklıdır ve parameterInit öğesi parametreye bir değer atar. ParameterDef öğesi, parameterdef öğesinin alt öğeleri olan ve verilerin türünü, verilerin en yüksek, en düşük ve varsayılan değerlerini ve diğer bilgileri belirten belirli bir Özellik öğesi kümesinden oluşur. Bu Özellik öğeleri bu konunun ilerleyen bölümlerinde ele alınmıştır.

ParameterDef öğeleri yalnızca izin verilen bağlamlarında görünebilir. Yazdırma Şemasının ilk sürümü için, PrintCapabilities belgesinin kök düzeyinde bulunabilirler. ParameterDef öğesinin name özniteliği parametre adını tanımlar. PrintCapabilities belgesindeki her ParameterDef öğesine benzersiz bir ad özniteliği atanmalıdır.

Not

Yazdırma Özellikleri Belge Sağlayıcıları:

Parametre adının anlamı evrenseldir; yani, bir PrintCapabilities belgesindeki ParameterDef öğesi başka bir PrintCapabilities belgesindeki ParameterDef öğesiyle aynı ad özniteliğine (ad alanından oluşturulan dize ve ParameterDef öğesinin açıklayıcı adı) sahipse, bu öğelerin her ikisinin de aynı kavramı temsil ettiğini ve aynı şekilde yorumlanması gerektiği varsayılır. Bu nedenle, bir PrintCapabilities belgesi için PrintTicket'te tanımlanan bir ParameterDef öğesi, farklı bir PrintCapabilities belgesinde tanımlanan aynı ada sahip ParameterInit öğesini başlatmak için kullanılabilir.

XML Öznitelikleriyle İlişki

Tüm ad özniteliklerinde olduğu gibi parametre adı xml QName biçimindedir. Şema tanımlı parametre yapısı, ortak ad alanı tarafından nitelenen ve ad özniteliğini oluşturan bir ada sahipken, özel olarak tanımlanmış bir parametre yapısının name özniteliği, oluşturucuya özgü bir özel ad alanı tarafından nitelenmiştir.

ParameterDef ile Özellik Öğesi Türleri Arasındaki İlişki

Yazdırma Şeması Anahtar Sözcükleri'nde tanımlanan ParameterDef öğeleri, PrintCapabilities belgesinde tam olarak tanımlanmalıdır. Şema Anahtar Sözcüklerini Yazdır belgesi, ParameterDef öğesinin bazı Özellik öğeleri için nominal değerler sağlar (DefaultValue ve diğerleri gibi), ancak printCapabilities belgesinin yazarı kalan Özellik öğelerini tanımlamaktan sorumludur. Her durumda, Tüm Özellik öğelerinin, Yazdırma Şeması Anahtar Sözcükleri'nde tanımlananlar da dahil olmak üzere bir ParameterDef öğesinde açıkça tanımlanması gerekir.

Yazdırma Şeması Anahtar Sözcüklerinde görünen her ParameterDef öğesinin bazı Özellik öğeleri sabit olarak belirlenir. Bu, Yazdırma Şeması Anahtar Sözcükleri tanımlı ParameterDef öğelerinin tüm PrintCapabilities belge tanımlarının bu Özellik öğelerini değiştirmeden koruması gerektiği anlamına gelir. Bu sabit Özellik öğeleri, parametre yapılarının tüm PrintCapabilities belgelerinde taşınabilir ve belirsiz olmasını sağlar. En önemli örnek, ParameterDef öğesinde kullanılan birimlerdir. Anlamlarının tutarlı bir şekilde anlaşılmasını sağlamak için bu birimlerin sabit olması gerekir. Bir ParameterDef'in sabit olmayan özellik öğeleri PrintCapabilities belgesinde yeniden tanımlanabilir.

ParameterDef öğesi aşağıdaki Özellik öğelerinden oluşur. Aksi belirtilmedikçe tümü mevcut olmalıdır.

Özellik Adı Değer Açıklama Sabit?
Datatype
tam sayı
On -da -lık
dizgi
Varsayılan değer yok.
 Parametre değerinin tamsayı mı, kayan noktalı sayı mı yoksa metin dizesi mi olduğunu belirtir. Parametrenin değeri, karşılık gelen XSD temel veri türüyle aynı biçimde ifade edilir; yani tamsayı, ondalık veya dize olarak.
Evet
DefaultValue
DataType Özelliği tarafından belirtilen tür.
Varsayılan değer yok.
 Kullanıcı arabirimi (UI) denetiminin başlatıldığı değeri belirtir.
  • veya
PrintTicket'de ilgili parametre öğesi eksikse kullanılacak değeri belirtir.
 Hayır
Zorunlu
Koşulsuz: ParameterInit öğesi her zaman sağlanmalıdır.
Koşullu: ParameterInit öğesinin gerekli olması için, parametreye bir PrintTicket'teki Option öğesinde başvuru yapılması gerekir.
DefaultValue: Koşullu.
 Bir ParameterInit öğesinin ne zaman açıkça görünmesi gerektiğini gösterir. Koşullu ise, PrintTicket parametresine başvuran bir Seçenek içeriyorsa ParameterInit başlatılmalıdır.
UI İstemcileri ve PrintCapabilities veya PrintTicket sağlayıcıları tarafından kullanılır. Herhangi bir kısıtlamada ParameterDef öğesinin Zorunlu Özelliğinin Koşulsuz olarak ayarlanması gerektiğini unutmayın. ParameterDef tanımlı bir Değere sahip olmalıdır, aksi takdirde bağımlı Değer veya kısıtlama değerlendirilemedi.
 Hayır
MaxLength
DataType Özelliği dizeyi belirtiyorsa integer.
DefaultValue: Hiçbir maksimum değer zorlanmaz.
 Dize değerli parametreler için izin verilen en uzun dizeyi belirtir. UI ve PrintCapabilities veya PrintTicket sağlayıcıları ParameterDef öğesini doğrulamak için bu Özelliği kullanır.
 Hayır
MaxValue
DataType Özelliği tamsayı belirtiyorsa integer.
DataType Özelliği ondalık belirtiyorsa ondalık.
DefaultValue: Hiçbir maksimum değer zorlanmaz.
 Tamsayı veya ondalık değerli ParameterDef öğeleri için izin verilen en büyük değeri tanımlar.
 Hayır
MinLength
DataType Özelliği dizeyi belirtiyorsa integer.
DefaultValue: Hiçbir minimum değer zorunlu tutulmaz.
 Dize değerleri için, izin verilen en kısa dizeyi tanımlar. UI ve PrintCapabilities veya PrintTicket sağlayıcıları ParameterDef öğesini doğrulamak için bu Özelliği kullanır.
 Hayır
MinValue
DataType Özelliği tamsayı belirtiyorsa integer.
DataType Özelliği ondalık belirtiyorsa ondalık.
DefaultValue: Hiçbir minimum değer zorunlu tutulmaz.
 Tamsayı veya ondalık değerli parametreler için izin verilen en küçük değeri tanımlar.
Hayır
Çoklu
DataType Özelliği tamsayı belirtiyorsa integer.
DataType Özelliği ondalık belirtiyorsa ondalık.
DefaultValue: 1
 Tamsayı veya ondalık değerli parametreler için parametrenin değeri bu sayının katı olmalıdır. Daha fazla bilgi için bkz. Bu tabloyu izleyen Birden Çok .
 Hayır
UnitType
parametresi için kullanılan birimleri gösteren dize değeri.
Varsayılan değer yok.
 Parametresinin ifade edildiği birimleri gösterir. Örneğin, derecenin onda biri cinsinden açılar, mikron cinsinden uzunluklar vb.
 Evet

Birden Çok Not

Tamsayı veya ondalık değerleri olan ParameterInit öğeleri için, ParameterInit değeri bu sayının katı olmalıdır. Örneğin, ondalık değerli ParameterInit öğeleri, bu özellik 0,1 olarak ayarlanarak onda biriyle sınırlanabilir. Kullanıcı arabirimi öğeleri, iletişim kutuları ve kullanıcı arabirimi denetimleri oluştururken bu Özelliği kullanır. Ayrıca, PrintTicket doğrulama kodu bu Özelliği kullanarak bir ParameterInit değerini Birden Çok ile belirtilen en yakın değere yuvarlayabilir. Not: Cihaz sürücüleri ve PrintCapabilities sağlayıcıları ParameterInit değerlerinin bu Özellik değerinin katları olduğunu varsaymamalıdır. Farklı sağlayıcıların bu özellik için farklı ve çakışan değerler belirtme olasılığı nedeniyle her sağlayıcının rastgele değerleri en yakın kullanılabilir değere yuvarlayabilmesi gerekir.

Yazdırma Şeması Belirtimi

  • Last updated on