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 null, versi XML dari PrintTicket (lihat SaveTo dan GetXmlStream) tidak akan berisi markup apa pun untuk fitur ini.

Properti ini umumnya mewakili Skala dari kata kunci Skema Cetak . Tetapi ada beberapa kompleksitas sebagai berikut.

Saat membaca properti PageScalingFactor, properti berulah sebagai berikut.

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

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

• Dalam semua kasus lain, null dikembalikan.

Saat mengatur properti PageScalingFactor, properti berulah sebagai berikut.

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

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