QueryPageSettingsEventArgs.PageSettings プロパティ

.NET Framework クラス ライブラリ リファレンス

QueryPageSettingsEventArgs.PageSettings プロパティ

印刷するページのページ設定を取得または設定します。

名前空間: System.Drawing.Printing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Property PageSettings As
 PageSettings

Visual Basic (使用法)

Dim instance As QueryPageSettingsEventArgs
Dim value As PageSettings

value = instance.PageSettings

instance.PageSettings = value

C#

public PageSettings PageSettings { get; set;
 }

C++

public:
property PageSettings^ PageSettings {
    PageSettings^ get ();
    void set (PageSettings^ value);
}

J#

/** @property */
public PageSettings get_PageSettings ()

/** @property */
public void set_PageSettings (PageSettings
 value)

JScript

public function get PageSettings
 () : PageSettings

public function set PageSettings
 (value : PageSettings)

プロパティ値
印刷するページのページ設定。

解説

ドキュメントの各ページを異なるページ設定を使用して印刷できます。PageSettings のプロパティを個別に変更するか、プロパティを PageSettings に設定することによって、ページ設定を指定します。Cancel プロパティを true に設定することによって、印刷ジョブをキャンセルすることもできます。

使用例

文書を印刷するコード例を次に示します。カラー プリンタの場合は、先頭ページがカラーで印刷されます。この例では、printDoc という名前の PrintDocument 変数が既に作成されており、PrintPage イベントと QueryPageSettings イベントが処理されることを前提にしています。

この例では、System.Drawing 名前空間と System.Drawing.Printing 名前空間を使用します。

Visual Basic

Private Sub MyButtonPrint_OnClick(ByVal
 sender As Object, ByVal
 e As System.EventArgs)

    ' Set the printer name and ensure it is valid. If not, provide a
 message to the user.
    printDoc.PrinterSettings.PrinterName = "\\mynetworkprinter"

    If printDoc.PrinterSettings.IsValid Then

        ' If the printer supports printing in color, then override the
 printer's default behavior.
        if printDoc.PrinterSettings.SupportsColor then

            ' Set the page default's to not print in color.
            printDoc.DefaultPageSettings.Color = False
        End If

        ' Provide a friendly name, set the page number, and print the
 document.
        printDoc.DocumentName = "My Presentation"
        currentPageNumber = 1
        printDoc.Print()
    Else
        MessageBox.Show("Printer is not valid")
    End If
End Sub

Private Sub MyPrintQueryPageSettingsEvent(ByVal
 sender As Object, ByVal
 e As QueryPageSettingsEventArgs)

    ' Determines if the printer supports printing in color.
    If printDoc.PrinterSettings.SupportsColor Then

        ' If the printer supports color printing, use color.
        If currentPageNumber = 1 Then

            e.PageSettings.Color = True
        End If

    End If
End Sub

C#

private void MyButtonPrint_OnClick(object sender,
 System.EventArgs e)
{
    
    // Set the printer name and ensure it is valid. If not, provide
 a message to the user.
    printDoc.PrinterSettings.PrinterName = "\\mynetworkprinter";

    if (printDoc.PrinterSettings.IsValid) {
    
        // If the printer supports printing in color, then override
 the printer's default behavior.
        if (printDoc.PrinterSettings.SupportsColor) {

            // Set the page default's to not print in color.
            printDoc.DefaultPageSettings.Color = false;
        }

        // Provide a friendly name, set the page number, and print the
 document.
        printDoc.DocumentName = "My Presentation";
        currentPageNumber = 1;
        printDoc.Print();
    }
    else {
        MessageBox.Show("Printer is not valid");
    }
}

private void MyPrintQueryPageSettingsEvent(object
 sender, QueryPageSettingsEventArgs e)
{
    // Determines if the printer supports printing in color.
    if (printDoc.PrinterSettings.SupportsColor) {

        // If the printer supports color printing, use color.
        if (currentPageNumber == 1 ) {

            e.PageSettings.Color = true;
        }

    }    
}

C++

private:
   void MyButtonPrint_OnClick( Object^ sender, System::EventArgs^
 e )
   {
      // Set the printer name and ensure it is valid. If not, provide
 a message to the user.
      printDoc->PrinterSettings->PrinterName = "\\mynetworkprinter";
      if ( printDoc->PrinterSettings->IsValid )
      {
         // If the printer supports printing in color, then override
 the printer's default behavior.
         if ( printDoc->PrinterSettings->SupportsColor )
         {
            // Set the page default's to not print in color.
            printDoc->DefaultPageSettings->Color = false;
         }

         // Provide a friendly name, set the page number, and print the
 document.
         printDoc->DocumentName = "My Presentation";
         currentPageNumber = 1;
         printDoc->Print();
      }
      else
      {
         MessageBox::Show( "Printer is not valid" );
      }
   }

   void MyPrintQueryPageSettingsEvent( Object^ sender, QueryPageSettingsEventArgs^
 e )
   {
      // Determines if the printer supports printing in color.
      if ( printDoc->PrinterSettings->SupportsColor )
      {
         // If the printer supports color printing, use color.
         if ( currentPageNumber == 1 )
         {
            e->PageSettings->Color = true;
         }
      }
   }

J#

private void myButtonPrint_OnClick(Object sender,
 System.EventArgs e)
{
    // Set the printer name and ensure it is valid. If not,
    // provide a message to the user.
    printDoc.get_PrinterSettings().set_PrinterName("\\mynetworkprinter");

    if (printDoc.get_PrinterSettings().get_IsValid()) {
        // If the printer supports printing in color, then 
        // override the printer's default behavior.
        if (printDoc.get_PrinterSettings().get_SupportsColor())
 {
            // Set the page default's to not print in color.
            printDoc.get_DefaultPageSettings().set_Color(false);
        }
        // Provide a friendly name, set the page number, and print
        // the document.
        printDoc.set_DocumentName("My Presentation");
        currentPageNumber = 1;
        printDoc.Print();
    }
    else {
        MessageBox.Show("Printer is not valid");
    }
} //myButtonPrint_OnClick

private void MyPrintQueryPageSettingsEvent(Object
 sender, 
    QueryPageSettingsEventArgs e)
{
    // Determines if the printer supports printing in color.
    if (printDoc.get_PrinterSettings().get_SupportsColor()) {
        // If the printer supports color printing, use color.
        if (currentPageNumber == 1) {
            e.get_PageSettings().set_Color(true);
        }
    }
} //MyPrintQueryPageSettingsEvent

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
QueryPageSettingsEventArgs クラス
QueryPageSettingsEventArgs メンバ
System.Drawing.Printing 名前空間
PageSettings クラス
PrintDocument.QueryPageSettings イベント