PrinterSettings Kelas

Definisi

Ruang nama:

System.Drawing.Printing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

PrinterSettings.cs

Menentukan informasi tentang bagaimana dokumen dicetak, termasuk pencetak yang mencetaknya, ketika mencetak dari aplikasi Formulir Windows.

public ref class PrinterSettings : ICloneable

public class PrinterSettings : ICloneable

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Warisan

Object

PrinterSettings

Penerapan

ICloneable

Contoh

Contoh kode berikut mencetak dokumen pada printer yang ditentukan. Contohnya memiliki tiga prasyarat:

• Variabel bernama filePath telah diatur ke jalur file yang akan dicetak.

• Metode bernama pd_PrintPage, yang menangani PrintPage peristiwa, telah ditentukan.

• Variabel bernama printer telah diatur ke nama printer.

System.DrawingGunakan namespace , System.Drawing.Printing, dan System.IO untuk contoh ini.

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

Keterangan

Biasanya, Anda mengakses PrinterSettingsPrintDocument.PrinterSettings melalui atau PageSettings.PrinterSettings properti untuk mengubah pengaturan printer. Pengaturan printer yang paling umum adalah PrinterName, yang menentukan printer untuk dicetak.

Untuk informasi selengkapnya tentang pencetakan dengan Formulir Windows, lihat System.Drawing.Printing gambaran umum namespace. Jika Anda ingin mencetak dari aplikasi Windows Presentation Foundation, lihat System.Printing namespace.

Catatan

Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common, yang mencakup jenis ini, hanya didukung pada sistem operasi Windows. Penggunaan jenis ini dalam aplikasi lintas platform menyebabkan peringatan waktu kompilasi dan pengecualian run-time. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

Konstruktor

PrinterSettings()

Menginisialisasi instans baru kelas PrinterSettings.

Properti

CanDuplex	Mendapatkan nilai yang menunjukkan apakah printer mendukung pencetakan dua sisi.
Collate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah dokumen cetak disusun.
Copies	Mendapatkan atau mengatur jumlah salinan dokumen yang akan dicetak.
DefaultPageSettings	Mendapatkan pengaturan halaman default untuk pencetak ini.
Duplex	Mendapatkan atau menyetel setelan pencetak untuk pencetakan dua sisi.
FromPage	Mendapatkan atau mengatur nomor halaman dari halaman pertama yang akan dicetak.
InstalledPrinters	Mendapatkan nama semua pencetak yang terinstal pada komputer.
IsDefaultPrinter	Mendapatkan nilai yang menunjukkan apakah PrinterName properti menunjuk printer default, kecuali ketika pengguna secara eksplisit mengatur PrinterName.
IsPlotter	Mendapatkan nilai yang menunjukkan apakah printer adalah plotter.
IsValid	Mendapatkan nilai yang menunjukkan apakah PrinterName properti menunjuk printer yang valid.
LandscapeAngle	Mendapatkan sudut, dalam derajat, bahwa orientasi potret diputar untuk menghasilkan orientasi lanskap.
MaximumCopies	Mendapatkan jumlah maksimum salinan yang memungkinkan pengguna mencetak pada satu waktu.
MaximumPage	Mendapatkan atau mengatur maksimum FromPage atau ToPage yang dapat dipilih dalam PrintDialog.
MinimumPage	Mendapatkan atau mengatur minimum FromPage atau ToPage yang dapat dipilih dalam PrintDialog.
PaperSizes	Mendapatkan ukuran kertas yang didukung oleh pencetak ini.
PaperSources	Mendapatkan baki sumber kertas yang tersedia pada pencetak.
PrinterName	Mendapatkan atau mengatur nama pencetak yang akan digunakan.
PrinterResolutions	Mendapatkan semua resolusi yang didukung oleh printer ini.
PrintFileName	Mendapatkan atau mengatur nama file, saat mencetak ke file.
PrintRange	Mendapatkan atau mengatur nomor halaman yang telah ditentukan pengguna untuk dicetak.
PrintToFile	Mendapatkan atau menetapkan nilai yang menunjukkan apakah output pencetakan dikirim ke file alih-alih port.
SupportsColor	Mendapatkan nilai yang menunjukkan apakah printer ini mendukung pencetakan warna.
ToPage	Mendapatkan atau mengatur jumlah halaman terakhir yang akan dicetak.

Metode

Clone()	Membuat salinan ini PrinterSettings.
CreateMeasurementGraphics()	Mengembalikan yang Graphics berisi informasi printer yang berguna saat membuat PrintDocument.
CreateMeasurementGraphics(Boolean)	Mengembalikan Graphics yang berisi informasi printer, secara opsional menentukan asal pada margin.
CreateMeasurementGraphics(PageSettings)	Mengembalikan yang Graphics berisi informasi printer yang terkait dengan yang ditentukan PageSettings.
CreateMeasurementGraphics(PageSettings, Boolean)	Membuat yang Graphics terkait dengan pengaturan halaman yang ditentukan dan secara opsional menentukan asal pada margin.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHdevmode()	Membuat handel ke DEVMODE struktur yang sesuai dengan pengaturan printer.
GetHdevmode(PageSettings)	Membuat handel ke DEVMODE struktur yang sesuai dengan printer dan pengaturan halaman yang ditentukan melalui pageSettings parameter .
GetHdevnames()	Membuat handel ke DEVNAMES struktur yang sesuai dengan pengaturan printer.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsDirectPrintingSupported(Image)	Mendapatkan nilai yang menunjukkan apakah printer mendukung pencetakan file gambar yang ditentukan.
IsDirectPrintingSupported(ImageFormat)	Mengembalikan nilai yang menunjukkan apakah printer mendukung pencetakan format gambar yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
SetHdevmode(IntPtr)	Menyalin informasi yang relevan dari handel yang diberikan dan ke PrinterSettingsdalam .
SetHdevnames(IntPtr)	Menyalin informasi yang relevan dari handel yang diberikan dan ke PrinterSettingsdalam .
ToString()	Menyediakan informasi tentang PrinterSettings formulir dalam string.

Lihat juga

• PrinterName
• PrinterSettings
• PrinterSettings