PrinterSettings.PrinterName プロパティ

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

PrinterSettings.PrinterName プロパティ

使用するプリンタの名前を取得または設定します。

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

Visual Basic (宣言)

Public Property PrinterName As
 String

Visual Basic (使用法)

Dim instance As PrinterSettings
Dim value As String

value = instance.PrinterName

instance.PrinterName = value

C#

public string PrinterName { get;
 set; }

C++

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

J#

/** @property */
public String get_PrinterName ()

/** @property */
public void set_PrinterName (String value)

JScript

public function get PrinterName
 () : String

public function set PrinterName
 (value : String)

プロパティ値
使用するプリンタの名前。

解説

プリンタ名を設定した後、IsValid を呼び出して、プリンタ名がシステムで有効なプリンタとして認識されるかどうかを判断します。

InstalledPrinters プロパティを使用して、システムにインストールされているプリンタの一覧を取得することもできます。

使用例

PrinterName プロパティを設定して印刷先プリンタを指定するコード例を次に示します。IsValid が true の場合は、指定したプリンタでドキュメントが印刷されます。この例には、次の 3 つの必要条件があります。

• 変数 filePath が印刷するファイルのパスに設定されていること。

• PrintPage イベントを処理する pd_PrintPage メソッドが定義されていること。

• 変数 printer がプリンタ名に設定されていること。

この例では、System.Drawing、System.Drawing.Printing、および System.IO の各名前空間を使用します。

Visual Basic

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
   

C#

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

C++

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

J#

public void Printing(String printer)
{
    try {
        streamToPrint = new StreamReader(filePath);
        try {
            printFont = new Font("Arial", 10);
            PrintDocument pd = new PrintDocument();
            pd.add_PrintPage(new PrintPageEventHandler(pd_PrintPage));

            // Specify the printer to use.
            pd.get_PrinterSettings().set_PrinterName(printer);
            if (pd.get_PrinterSettings().get_IsValid()) {
                pd.Print();
            }
            else {
                MessageBox.Show("Printer is invalid.");
            }
        }
        finally {
            streamToPrint.Close();
        }
    }
    catch (System.Exception ex) {
        MessageBox.Show(ex.get_Message());
    }
} //Printing

.NET Framework のセキュリティ

• PrintingPermission  (印刷を行うため、およびネットワーク上のすべてのプリンタにアクセスするために必要なアクセス許可)。PrintingPermissionLevel.AllPrinting (関連する列挙体)

プラットフォーム

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

参照

関連項目
PrinterSettings クラス
PrinterSettings メンバ
System.Drawing.Printing 名前空間
PrinterSettings.IsValid プロパティ
PrinterSettings.InstalledPrinters プロパティ
PrinterSettings.Duplex プロパティ
PrinterSettings.MaximumCopies プロパティ