PrinterSettings PrinterSettings PrinterSettings PrinterSettings Class

定義

Windows フォーム アプリケーションから印刷する場合のドキュメントの印刷方法に関する情報 (印刷に使用するプリンターなど) を指定します。Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
継承
PrinterSettingsPrinterSettingsPrinterSettingsPrinterSettings
属性
実装

次のコード例では、指定したプリンターでドキュメントを印刷します。The following code example prints a document on the specified printer. この例には、次の3つの前提条件があります。The example has three prerequisites:

  • という名前filePathの変数が、印刷するファイルのパスに設定されています。A variable named filePath has been set to the path of the file to print.

  • イベントPrintPageを処理pd_PrintPageするという名前のメソッドが定義されています。A method named pd_PrintPage, which handles the PrintPage event, has been defined.

  • という名前printerの変数がプリンターの名前に設定されています。A variable named printer has been set to the printer's name.

この例System.DrawingSystem.Drawing.Printingは、 System.IO 、、およびの各名前空間を使用します。Use the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

public:
   void Printing( String^ printer )
   {
      try
      {
         streamToPrint = gcnew StreamReader( filePath );
         try
         {
            printFont = gcnew System::Drawing::Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler(
               this, &Form1::pd_PrintPage );
            // Specify the printer to use.
            pd->PrinterSettings->PrinterName = printer;
            if ( pd->PrinterSettings->IsValid )
            {
               pd->Print();
            }
            else
            {
               MessageBox::Show( "Printer is invalid." );
            }
         }
         finally
         {
            streamToPrint->Close();
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }
public void Printing(string printer) {
  try {
    streamToPrint = new StreamReader (filePath);
    try {
      printFont = new Font("Arial", 10);
      PrintDocument pd = new PrintDocument(); 
      pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
      // Specify the printer to use.
      pd.PrinterSettings.PrinterName = printer;

      if (pd.PrinterSettings.IsValid) {
         pd.Print();
      } 
      else {	
         MessageBox.Show("Printer is invalid.");
      }
    } 
    finally {
      streamToPrint.Close();
    }
  } 
  catch(Exception ex) {
    MessageBox.Show(ex.Message);
  }
}

Public Sub Printing(printer As String)
    Try
        streamToPrint = New StreamReader(filePath)
        Try
            printFont = New Font("Arial", 10)
            Dim pd As New PrintDocument()
            AddHandler pd.PrintPage, AddressOf pd_PrintPage
            ' Specify the printer to use.
            pd.PrinterSettings.PrinterName = printer

            If pd.PrinterSettings.IsValid then
               pd.Print()
            Else
               MessageBox.Show("Printer is invalid.")
            End If
        Finally
            streamToPrint.Close()
        End Try
    Catch ex As Exception
        MessageBox.Show(ex.Message)
    End Try
End Sub
   

注釈

通常、プリンターの設定PrinterSettingsPrintDocument.PrinterSettings変更PageSettings.PrinterSettingsするには、またはのプロパティにアクセスします。Typically, you access a PrinterSettings through PrintDocument.PrinterSettings or PageSettings.PrinterSettings properties to modify printer settings. 最も一般的なプリンター設定はPrinterNameです。これは、印刷するプリンターを指定します。The most common printer setting is PrinterName, which specifies the printer to print to.

Windows フォームを使用した印刷の詳細についSystem.Drawing.Printingては、「名前空間の概要」を参照してください。For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Windows Presentation Foundation アプリケーションから印刷する場合は、 System.Printing名前空間を参照してください。If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

コンストラクター

PrinterSettings() PrinterSettings() PrinterSettings() PrinterSettings()

PrinterSettings クラスの新しいインスタンスを初期化します。Initializes a new instance of the PrinterSettings class.

プロパティ

CanDuplex CanDuplex CanDuplex CanDuplex

プリンターが両面印刷をサポートしているかどうかを示す値を取得します。Gets a value indicating whether the printer supports double-sided printing.

Collate Collate Collate Collate

ドキュメントを部単位で印刷するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the printed document is collated.

Copies Copies Copies Copies

印刷するドキュメントの部数を取得または設定します。Gets or sets the number of copies of the document to print.

DefaultPageSettings DefaultPageSettings DefaultPageSettings DefaultPageSettings

プリンターの既定のページ設定を取得します。Gets the default page settings for this printer.

Duplex Duplex Duplex Duplex

両面印刷用のプリンター設定を取得または設定します。Gets or sets the printer setting for double-sided printing.

FromPage FromPage FromPage FromPage

印刷開始ページの番号を取得または設定します。Gets or sets the page number of the first page to print.

InstalledPrinters InstalledPrinters InstalledPrinters InstalledPrinters

コンピューターにインストールされているすべてのプリンターの名前を取得します。Gets the names of all printers installed on the computer.

IsDefaultPrinter IsDefaultPrinter IsDefaultPrinter IsDefaultPrinter

ユーザーが明示的に PrinterName を設定した場合を除き、PrinterName プロパティが、通常使うプリンターに指定されているかどうかを示す値を取得します。Gets a value indicating whether the PrinterName property designates the default printer, except when the user explicitly sets PrinterName.

IsPlotter IsPlotter IsPlotter IsPlotter

プリンターがプロッターかどうかを示す値を取得します。Gets a value indicating whether the printer is a plotter.

IsValid IsValid IsValid IsValid

PrinterName プロパティが有効なプリンターに指定されているかどうかを示す値を取得します。Gets a value indicating whether the PrinterName property designates a valid printer.

LandscapeAngle LandscapeAngle LandscapeAngle LandscapeAngle

縦向きの用紙を回転して横向きにする場合の角度 (°) を取得します。Gets the angle, in degrees, that the portrait orientation is rotated to produce the landscape orientation.

MaximumCopies MaximumCopies MaximumCopies MaximumCopies

プリンターで一度に印刷できる最大部数を取得します。Gets the maximum number of copies that the printer enables the user to print at a time.

MaximumPage MaximumPage MaximumPage MaximumPage

FromPage で選択できる ToPage または PrintDialog の最大値を取得または設定します。Gets or sets the maximum FromPage or ToPage that can be selected in a PrintDialog.

MinimumPage MinimumPage MinimumPage MinimumPage

FromPage で選択できる ToPage または PrintDialog の最小値を取得または設定します。Gets or sets the minimum FromPage or ToPage that can be selected in a PrintDialog.

PaperSizes PaperSizes PaperSizes PaperSizes

プリンターでサポートされている用紙サイズを取得します。Gets the paper sizes that are supported by this printer.

PaperSources PaperSources PaperSources PaperSources

プリンターで使用できる用紙トレイを取得します。Gets the paper source trays that are available on the printer.

PrinterName PrinterName PrinterName PrinterName

使用するプリンターの名前を取得または設定します。Gets or sets the name of the printer to use.

PrinterResolutions PrinterResolutions PrinterResolutions PrinterResolutions

プリンターでサポートされている解像度をすべて取得します。Gets all the resolutions that are supported by this printer.

PrintFileName PrintFileName PrintFileName PrintFileName

ファイルに出力する際にファイル名を取得または設定します。Gets or sets the file name, when printing to a file.

PrintRange PrintRange PrintRange PrintRange

ユーザーが指定した印刷ページの番号を取得または設定します。Gets or sets the page numbers that the user has specified to be printed.

PrintToFile PrintToFile PrintToFile PrintToFile

ポートではなく、ファイルに印刷出力を送信するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the printing output is sent to a file instead of a port.

SupportsColor SupportsColor SupportsColor SupportsColor

プリンターがカラー印刷をサポートしているかどうかを示す値を取得します。Gets a value indicating whether this printer supports color printing.

ToPage ToPage ToPage ToPage

印刷終了ページの番号を取得または設定します。Gets or sets the number of the last page to print.

メソッド

Clone() Clone() Clone() Clone()

この PrinterSettings のコピーを作成します。Creates a copy of this PrinterSettings.

CreateMeasurementGraphics() CreateMeasurementGraphics() CreateMeasurementGraphics() CreateMeasurementGraphics()

Graphics の作成時に役立つプリンター情報を格納する PrintDocument を返します。Returns a Graphics that contains printer information that is useful when creating a PrintDocument.

CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean)

プリンター情報を格納し、オプションで余白の原点を指定する Graphics を返します。Returns a Graphics that contains printer information, optionally specifying the origin at the margins.

CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings)

指定した Graphics に関連付けられたプリンター情報を格納する PageSettings を返します。Returns a Graphics that contains printer information associated with the specified PageSettings.

CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean)

指定したページ設定に関連付けられ、オプションで余白の原点を指定する Graphics を作成します。Creates a Graphics associated with the specified page settings and optionally specifying the origin at the margins.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetHdevmode() GetHdevmode() GetHdevmode() GetHdevmode()

プリンター設定に対応する DEVMODE 構造体を識別するハンドルを作成します。Creates a handle to a DEVMODE structure that corresponds to the printer settings.

GetHdevmode(PageSettings) GetHdevmode(PageSettings) GetHdevmode(PageSettings) GetHdevmode(PageSettings)

プリンター設定や、pageSettings パラメーターで指定されたページ設定に対応する DEVMODE 構造体を識別するハンドルを作成します。Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the pageSettings parameter.

GetHdevnames() GetHdevnames() GetHdevnames() GetHdevnames()

プリンター設定に対応する DEVNAMES 構造体を識別するハンドルを作成します。Creates a handle to a DEVNAMES structure that corresponds to the printer settings.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image)

指定したイメージ ファイルの印刷をプリンターがサポートしているかどうかを示す値を取得します。Gets a value indicating whether the printer supports printing the specified image file.

IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat)

指定したイメージ形式の印刷をプリンターがサポートしているかどうかを示す値を返します。Returns a value indicating whether the printer supports printing the specified image format.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
SetHdevmode(IntPtr) SetHdevmode(IntPtr) SetHdevmode(IntPtr) SetHdevmode(IntPtr)

特定のハンドルから PrinterSettings に関連情報をコピーします。Copies the relevant information out of the given handle and into the PrinterSettings.

SetHdevnames(IntPtr) SetHdevnames(IntPtr) SetHdevnames(IntPtr) SetHdevnames(IntPtr)

特定のハンドルから PrinterSettings に関連情報をコピーします。Copies the relevant information out of the given handle and into the PrinterSettings.

ToString() ToString() ToString() ToString()

PrinterSettings に関する情報を文字列形式で提供します。Provides information about the PrinterSettings in string form.

適用対象

こちらもご覧ください