PrinterSettings.PrinterName プロパティ

定義

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

public:
 property System::String ^ PrinterName { System::String ^ get(); void set(System::String ^ value); };
public string PrinterName { get; set; }
member this.PrinterName : string with get, set
Public Property PrinterName As String

プロパティ値

String

使用するプリンターの名前。The name of the printer to use.

次のコード例では、PrinterName プロパティを設定して対象のプリンターを指定し、IsValidtrue場合は、指定されたプリンターでドキュメントを印刷します。The following code example specifies the target printer by setting the PrinterName property, and if the IsValid is true, prints the 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
   

注釈

プリンター名を設定した後、IsValid を呼び出して、プリンター名がシステム上の有効なプリンターとして認識されているかどうかを判断します。After setting the printer name, call IsValid to determine if the printer name is recognized as a valid printer on the system.

また、InstalledPrinters プロパティを使用して、システムにインストールされているプリンターの一覧を取得することもできます。You can also use the InstalledPrinters property to get a list of printers installed on the system.

適用対象

こちらもご覧ください