PageSettings.Color プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

PageSettings.Color プロパティ

ページを色付きで印刷するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property Color As
 Boolean

Visual Basic (使用法)

Dim instance As PageSettings
Dim value As Boolean

value = instance.Color

instance.Color = value

public bool Color { get;
 set; }

C++

public:
property bool Color {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Color ()

/** @property */
public void set_Color (boolean value)

JScript

public function get Color
 () : boolean

public function set Color
 (value : boolean)

プロパティ値
ページを色付きで印刷する場合は true。それ以外の場合は false。既定値はプリンタによって決定されます。

例外

例外の種類	条件
InvalidPrinterException	PrinterSettings.PrinterName プロパティで指定されたプリンタが存在しません。

解説

PrinterSettings.SupportsColor プロパティを使用して、プリンタがカラー印刷をサポートしているかどうかを判断できます。プリンタがカラー印刷をサポートしていても、カラー印刷は行わない場合は、Color プロパティを false に設定します。既定値は 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

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;
         }
      }
   }

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