PrintTicket.PageScalingFactor Properti

Definisi

Ruang nama:

System.Printing

Rakitan:

ReachFramework.dll

Mendapatkan atau mengatur persentase di mana printer memperbesar atau mengurangi gambar cetak pada halaman.

public:
 property Nullable<int> PageScalingFactor { Nullable<int> get(); void set(Nullable<int> value); };

public int? PageScalingFactor { get; set; }

member this.PageScalingFactor : Nullable<int> with get, set

Public Property PageScalingFactor As Nullable(Of Integer)

Nilai Properti

Nullable<Int32>

Nilai Int32 yang mewakili persentase.

Pengecualian

ArgumentOutOfRangeException

Kode panggilan telah mencoba mengatur properti ke nilai yang kurang dari 1.

Keterangan

Printer dapat memiliki batas maksimum dan minimum untuk penskalaan. Anda dapat menguji batas skala dengan menggunakan PageScalingFactorRange.

Nilai null untuk properti ini berarti bahwa pengaturan fitur ini tidak ditentukan. Selain itu, ketika nilainya adalah null, versi XML dari PrintTicket (lihat SaveTo dan GetXmlStream) tidak akan berisi markup apa pun untuk fitur ini.

Properti ini PageScalingFactor umumnya mewakili SkalaScoredProperty kata kunci SkemaPageScaling Cetak. Tetapi ada beberapa kompleksitas sebagai berikut.

Saat membaca PageScalingFactor properti, properti berulah sebagai berikut.

• Jika dokumen XML PrintTicket memiliki PageScaling fitur yang diatur ke opsi CustomSquare, dan nilai Skala opsi CustomSquare adalah nilai positif, maka itu adalah nilai yang dikembalikan.

• Jika dokumen XML PrintTicket memiliki PageScaling fitur yang diatur ke opsi Kustom, dan nilai ScaleWidth opsi Kustom adalah nilai positif, maka itu adalah nilai yang dikembalikan.

• Dalam semua kasus lain, null dikembalikan.

Saat mengatur PageScalingFactor properti, properti berulah sebagai berikut.

• Jika diatur ke null, maka PageScaling markup dihapus dari dokumen XML PrintTicket.

• Jika tidak, PageScaling fitur dalam dokumen XML PrintTicket diatur ke CustomSquare dan nilai Skala opsi CustomSquare diatur ke nilai yang diteruskan. (Lihat Pengecualian untuk apa yang terjadi jika properti diatur ke nilai kurang dari 1.)