作成日: 2026/03/25    最終更新日: 2026/03/25

文書種別

使用方法

詳細

ViewerコントロールのZoomプロパティでプレビュー時の表示倍率を設定できます。

本プロパティに設定可能な値の範囲は、0.1（10％）～8.0（800％）です。（小数第二位以下は四捨五入）
また、本プロパティを「-1」に設定すると「ページ幅」で、「-2」に設定すると「ページ全体」でプレビュー表示が行われます。

なお、表示倍率を「ページ幅」と「ページ全体」に設定できるのは、ビューワの表示形式（ViewTypeプロパティ）が「SinglePage（単一ページ形式）」に設定されている時のみです。「Continuous（連続ページ形式）」や「MultiPage（複数ページ形式）」に設定されていると、意図した倍率で表示されません。

◆サンプルコード (C#)

// 表示形式を"単一ページ"形式に設定します。
this.viewer1.ViewType = GrapeCity.Viewer.Common.Model.ViewType.SinglePage;

// 表示倍率を設定します
this.viewer1.Zoom = 8.0f     // 800%
//this.viewer1.Zoom = 0.25f  // 25%
//this.viewer1.Zoom = -1.0f  // ページ幅
//this.viewer1.Zoom = -2.0f  // ページ全体

◆サンプルコード (VB.NET)

' 表示形式を"単一ページ"形式に設定します。
Me.Viewer1.ViewType = GrapeCity.Viewer.Common.Model.ViewType.SinglePage

' 表示倍率を設定します
Me.Viewer1.Zoom = 8.0     ' 800%
'Me.Viewer1.Zoom = 0.25F  ' 25%
'Me.Viewer1.Zoom = -1.0F  ' ページ幅
'Me.Viewer1.Zoom = -2.0F  ' ページ全体

※上記のコードは、レポートの読み込みが完了した後に発生するLoadCompletedイベントに実装することをおすすめします。