PrintPreview(Int32) メソッド

System.Windows.Forms.PrintPreviewDialogによって印刷結果をプレビューします。

構文

Visual Basic (宣言)
C#

Public Overloads Sub PrintPreview( _
   ByVal maxPages As Integer _
)

public void PrintPreview( 
   int maxPages
)

パラメータ

maxPages: System.Windows.Forms.PrintPreviewDialogに表示する最大ページを示すSystem.Int32値。印刷プレビューに関するメモリと時間のコストを抑えるために使用します。

例外

例外	解説
System.ArgumentOutOfRangeException	maxPagesが1未満です。

解説

Print、PrintPreview、およびPageSetupは、一連の印刷メソッドです。これらのメソッドを使用して印刷機能を簡単に実装できます。System.Windows.Forms.PrintDialog、System.Windows.Forms.PrintPreviewDialog、およびSystem.Windows.Forms.PageSetupDialogを使用することで、ユーザーが印刷設定を選択できるようにすることができます。System.Windows.Forms.PageSetupDialogのSystem.Drawing.Printing.PageSettingsはこれらのメソッドで共有されます。

PrintSettingsプロパティの値を変更して、印刷結果を調整できます。

使用例

次のサンプルコードは、GcMultiRowの印刷方法を示します。GcMultiRowを印刷する前に、必要なPrintSettingsを設定します。その後、PrintPreviewを実行して印刷結果をプレビューするか、Printを実行してプリンタに直接印刷します。このサンプルコードは、GcMultiRow.PrintSettingsに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

void setRichAndFlowButton_Click(object sender, EventArgs e)
{
    Template template1 = CreateTemplate(3, 21);
    AddPrintInfoCellColumnFooterSection(template1, 21);
    this.gcMultiRow1.Template = template1;
    gcMultiRow1.RowCount = 50;

    //The all UI elements will be printed, like UpDown button.
    gcMultiRow1.PrintSettings.PrintStyle = PrintStyle.Rich;
    //The all Rows will be printed from first page to last page one by one.
    gcMultiRow1.PrintSettings.PagingMode = PagingMode.Flow;
    //The GcMultiRow will be aligned by MiddleLeft.
    gcMultiRow1.PrintSettings.Alignment = MultiRowContentAlignment.MiddleLeft;
    //Between every two Rows, there will exist 15 pixels space.
    gcMultiRow1.PrintSettings.SectionMargin = 15;
    //Only the Row from 2th to 8th are printed
    gcMultiRow1.PrintSettings.PrintRange = MultiRowPrintRange.SomeRows;
    gcMultiRow1.PrintSettings.FromRow = 2;
    gcMultiRow1.PrintSettings.ToRow = 8;

    if (flag)
    {
        //The Template's width is less than page's width, set AutoFitWidth to true, the Template will be zoomed out to fit the page's width.
        gcMultiRow1.PrintSettings.AutoFitWidth = true;
        flag = false;
    }
    else
    {
        gcMultiRow1.PrintSettings.AutoFitWidth = false;
        flag = true;
    }
    gcMultiRow1.PrintSettings.ZoomFactor = 1f;
    try
    {
        gcMultiRow1.PrintPreview();
        //If you have a printer, you can execute the following code directly instead code above.
        //gcMultiRow1.Print(true);
    }
    catch (Exception ex)
    {
        // Can't find printer driver.
        MessageBox.Show(ex.Message);
    }
    label.Text = "In Rich style, all elements will be printed, like UpDown button; Between two rows, 15 pixels space existed; Only  the 2th to 8th row are printed one by one from page's Top to Bottom; The GcMultiRow will be aligned by MiddleLeft; (Click the button again to view the AutoFitWidth property's effect)";
}

Private Sub setRichAndFlowButton_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setRichAndFlowButton.Click
    Dim template1 As Template = CreateTemplate(3, 21)
    AddPrintInfoCellColumnFooterSection(template1, 21)
    Me.gcMultiRow1.Template = template1
    gcMultiRow1.RowCount = 50

    'The all UI elements will be printed, like UpDown button.
    gcMultiRow1.PrintSettings.PrintStyle = PrintStyle.Rich
    'The all Rows will be printed from first page to last page one by one.
    gcMultiRow1.PrintSettings.PagingMode = PagingMode.Flow
    'The GcMultiRow will be aligned by MiddleLeft.
    gcMultiRow1.PrintSettings.Alignment = MultiRowContentAlignment.MiddleLeft
    'Between every two Rows, there will exist 15 pixels space.
    gcMultiRow1.PrintSettings.SectionMargin = 15
    'Only the Row from 2th to 8th are printed
    gcMultiRow1.PrintSettings.PrintRange = MultiRowPrintRange.SomeRows
    gcMultiRow1.PrintSettings.FromRow = 2
    gcMultiRow1.PrintSettings.ToRow = 8

    If flag Then
        'The Template's width is less than page's width, set AutoFitWidth to true, the Template will be zoomed out to fit the page's width.
        gcMultiRow1.PrintSettings.AutoFitWidth = True
        flag = False
    Else
        gcMultiRow1.PrintSettings.AutoFitWidth = False
        flag = True
    End If
    gcMultiRow1.PrintSettings.ZoomFactor = 1.0F
    Try
        'If you have a printer, you can execute the following code directly instead code above.
        'gcMultiRow1.Print(true);
        gcMultiRow1.PrintPreview()
    Catch ex As Exception
        ' Can't find printer driver.
        MessageBox.Show(ex.Message)
    End Try
    label.Text = "In Rich style, all elements will be printed, like UpDown button; Between two rows, 15 pixels space existed; Only  the 2th to 8th row are printed one by one from page's Top to Bottom; The GcMultiRow will be aligned by MiddleLeft; (Click the button again to view the AutoFitWidth property's effect)"
End Sub

参照

GcMultiRow クラス
 GcMultiRow メンバ
 オーバーロード一覧
 PrintSettings プロパティ
 PrintPreview メソッド
 PageSetup メソッド
 PrintSettings プロパティ
 Print メソッド
 PageSetup メソッド