Bagikan melalui


PrinterSettings Kelas

Definisi

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
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
Warisan
PrinterSettings
Atribut
Penerapan

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.

Berlaku untuk

Lihat juga