Språk

PrintTicket.PageScalingFactor Egenskap

Definition

Hämtar eller anger den procentandel med vilken skrivaren förstorar eller minskar utskriftsbilden på en sida.

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)

Egenskapsvärde

Ett Int32 värde som representerar en procentandel.

Undantag

Anropande kod har försökt ange egenskapen till ett värde som är mindre än 1.

Kommentarer

Skrivaren kan ha maximala och lägsta gränser för skalning. Du kan testa skalningsgränser med hjälp PageScalingFactorRangeav .

Ett null värde för den här egenskapen innebär att den här funktionsinställningen inte har angetts. När värdet är nullinnehåller XML-versionerna av PrintTicket (se SaveTo och GetXmlStream) inte heller någon markering för den här funktionen.

Den här PageScalingFactor egenskapen representerar vanligtvis skalanScoredProperty för nyckelordet för utskriftsschematPageScaling. Men det finns vissa komplexiteter enligt följande.

När du läser egenskapen PageScalingFactor fungerar egenskapen på följande sätt.

  • Om XML-dokumentet PrintTicket har PageScaling funktionen inställd på alternativet CustomSquare och alternativet Skala för CustomSquare är ett positivt värde, är det det värde som returneras.

  • Om XML-dokumentet PrintTicket har PageScaling funktionen inställd på alternativet Anpassad och värdet För alternativet Anpassad är ScaleWidth-värdet positivt, så är det det värde som returneras.

  • I alla andra fall null returneras.

När du anger PageScalingFactor egenskapen fungerar egenskapen på följande sätt.

  • Om den är inställd på nullPageScaling tas markeringen bort från XML-dokumentet PrintTicket.

  • Annars PageScaling är funktionen i XML-dokumentet PrintTicket inställd på CustomSquare och alternativet CustomSquareSkalningsvärde anges till det angivna värdet. (Se Undantag för vad som händer om egenskapen är inställd på ett värde som är mindre än 1.)

Gäller för