ZoomFactor プロパティ (PrintInfo)

このシートを印刷するときに使用する拡大／縮小倍率を取得または設定します。

構文

Visual Basic
C#

'Declaration
 
Public Property ZoomFactor As Single

'使用法
 
Dim instance As PrintInfo
Dim value As Single
 
instance.ZoomFactor = value
 
value = instance.ZoomFactor

public float ZoomFactor {get; set;}

プロパティ値

印刷の倍率を表す単精度浮動小数点数

解説

シートの印刷倍率を指定するときは、このプロパティに0.1F（10）から4.0F（400）までの任意の値を設定します。この範囲から外れた値を設定すると、Out-Of-Range例外が発生します。たとえば、オブジェクトを通常の半分のサイズ（50）に縮小して印刷する場合はこのプロパティに0.5を設定し、通常の2倍のサイズ（200）に拡大して印刷する場合は2を設定します。

また、ScaleRuleオブジェクト（印刷の最適化に使用されるSmartPrintルールの1つ）を使用することで、最適な倍率を自動的に決定することもできます。

この倍率と印刷プレビュー時の拡大/縮小は異なります。このプロパティは、実際の表示サイズと印刷サイズに影響します。印刷プレビューダイアログでの拡大/縮小は、あくまでも一時的な表示効果に過ぎません。

例

次のサンプルコードは、印刷ページのレイアウトをカスタマイズするための設定を定義する方法を示します。

C#
Visual Basic

// Define the printer settings
FarPoint.Win.Spread.PrintInfo printset = new FarPoint.Win.Spread.PrintInfo();
FarPoint.Win.Spread.PrintMargin printmar = new FarPoint.Win.Spread.PrintMargin();

printmar.Left = 10;
printmar.Right = 10;
printmar.Top = 20;
printmar.Bottom = 40;

printset.Centering = FarPoint.Win.Spread.Centering.Both;
printset.FirstPageNumber = 1;
printset.Margin = printmar;
printset.Opacity = 60;
printset.Orientation = FarPoint.Win.Spread.PrintOrientation.Portrait;
printset.ShowBorder = false;
printset.ShowColor = false;
printset.ShowColumnHeader = FarPoint.Win.Spread.PrintHeader.Hide;
printset.ShowRowHeader = FarPoint.Win.Spread.PrintHeader.Hide;
printset.ShowGrid = true;
printset.ShowShadows = false;
printset.ZoomFactor = 2;

// Assign the printer settings to the sheet and print it
printset.PrintToPdf = true;
printset.PdfFileName = "C:\\results.pdf";
fpSpread1.Sheets[0].PrintInfo = printset;
fpSpread1.PrintSheet(0);

' Define the printer settings
Dim printset As New FarPoint.Win.Spread.PrintInfo()
Dim printmar As New FarPoint.Win.Spread.PrintMargin

printmar.Left = 10
printmar.Right = 10
printmar.Top = 20
printmar.Bottom = 40

printset.Centering = FarPoint.Win.Spread.Centering.Both
printset.FirstPageNumber = 1
printset.Margin = printmar
printset.Opacity = 60
printset.Orientation = FarPoint.Win.Spread.PrintOrientation.Portrait
printset.ShowBorder = False
printset.ShowColor = False
printset.ShowColumnHeader = FarPoint.Win.Spread.PrintHeader.Hide
printset.ShowRowHeader = FarPoint.Win.Spread.PrintHeader.Hide
printset.ShowGrid = True
printset.ShowShadows = False
printset.ZoomFactor = 2

' Assign the printer settings to the sheet and print it
printset.PrintToPdf = True
printset.PdfFileName = "C:\results.pdf"
FpSpread1.Sheets(0).PrintInfo = printset
FpSpread1.PrintSheet(0)

参照

PrintInfo クラス
 PrintInfo メンバ

開発者ガイド

印刷ページのレイアウトのカスタマイズ