PageSettings.PrinterResolution Eigenschaft

Referenz

Definition

Namespace:: System.Drawing.Printing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v6.0.0

Paket:: System.Drawing.Common v7.0.0

Paket:: System.Drawing.Common v8.0.0

Paket:: System.Drawing.Common v9.0.0-preview.2.24128.3

Quelle:: PageSettings.cs

Quelle:: PageSettings.cs

Quelle:: PageSettings.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Druckerauflösung für die Seite ab oder legt diese fest.

public:
 property System::Drawing::Printing::PrinterResolution ^ PrinterResolution { System::Drawing::Printing::PrinterResolution ^ get(); void set(System::Drawing::Printing::PrinterResolution ^ value); };

public System.Drawing.Printing.PrinterResolution PrinterResolution { get; set; }

member this.PrinterResolution : System.Drawing.Printing.PrinterResolution with get, set

Public Property PrinterResolution As PrinterResolution

Eigenschaftswert

PrinterResolution

Eine PrinterResolution, die die Druckerauflösung für die Seite angibt. Der Standardwert entspricht der Standardauflösung des Druckers.

Ausnahmen

InvalidPrinterException

Der in der PrinterName-Eigenschaft bezeichnete Drucker ist nicht vorhanden, oder es wurde kein Standarddrucker installiert.

Beispiele

Im folgenden Codebeispiel werden drei Eigenschaften für die Standardseite des Dokuments festgelegt, einschließlich der Druckerauflösung basierend auf der im comboPrintResolution Kombinationsfeld ausgewählten Auflösung. Anschließend wird das Dokument mit der Print -Methode gedruckt. Das Beispiel erfordert, dass eine PrintDocument Variable mit dem Namen printDoc vorhanden ist und dass die spezifischen Kombinationsfelder vorhanden sind.

private:
   void MyButtonPrint_Click( Object^ sender, System::EventArgs^ e )
   {
      // Set the paper size based upon the selection in the combo box.
      if ( comboPaperSize->SelectedIndex != -1 )
      {
         printDoc->DefaultPageSettings->PaperSize = printDoc->PrinterSettings->PaperSizes[ comboPaperSize->SelectedIndex ];
      }

      // Set the paper source based upon the selection in the combo box.
      if ( comboPaperSource->SelectedIndex != -1 )
      {
         printDoc->DefaultPageSettings->PaperSource = printDoc->PrinterSettings->PaperSources[ comboPaperSource->SelectedIndex ];
      }

      // Set the printer resolution based upon the selection in the combo box.
      if ( comboPrintResolution->SelectedIndex != -1 )
      {
         printDoc->DefaultPageSettings->PrinterResolution = printDoc->PrinterSettings->PrinterResolutions[ comboPrintResolution->SelectedIndex ];
      }

      // Print the document with the specified paper size, source, and print resolution.
      printDoc->Print();
   }

private void MyButtonPrint_Click(object sender, System.EventArgs e)
{
    // Set the paper size based upon the selection in the combo box.
    if (comboPaperSize.SelectedIndex != -1) {
        printDoc.DefaultPageSettings.PaperSize = 
            printDoc.PrinterSettings.PaperSizes[comboPaperSize.SelectedIndex];
    }

    // Set the paper source based upon the selection in the combo box.
    if (comboPaperSource.SelectedIndex != -1) {
        printDoc.DefaultPageSettings.PaperSource = 
            printDoc.PrinterSettings.PaperSources[comboPaperSource.SelectedIndex];
    }
    
    // Set the printer resolution based upon the selection in the combo box.
    if (comboPrintResolution.SelectedIndex != -1) 
    {
        printDoc.DefaultPageSettings.PrinterResolution= 
            printDoc.PrinterSettings.PrinterResolutions[comboPrintResolution.SelectedIndex];
    }

    // Print the document with the specified paper size, source, and print resolution.
    printDoc.Print();
}

Private Sub MyButtonPrint_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyButtonPrint.Click

    ' Set the paper size based upon the selection in the combo box.
    If comboPaperSize.SelectedIndex <> -1 Then
        printDoc.DefaultPageSettings.PaperSize = _
        printDoc.PrinterSettings.PaperSizes.Item(comboPaperSize.SelectedIndex)
    End If

    ' Set the paper source based upon the selection in the combo box.
    If comboPaperSource.SelectedIndex <> -1 Then
        printDoc.DefaultPageSettings.PaperSource = _
        printDoc.PrinterSettings.PaperSources.Item(comboPaperSource.SelectedIndex)
    End If

    ' Set the printer resolution based upon the selection in the combo box.
    If comboPrintResolution.SelectedIndex <> -1 Then
        printDoc.DefaultPageSettings.PrinterResolution = _
        printDoc.PrinterSettings.PrinterResolutions.Item(comboPrintResolution.SelectedIndex)
    End If

    ' Print the document with the specified paper size and source.
    printDoc.Print()

End Sub

Hinweise

Ein PrinterResolution stellt die Druckerauflösung von durch die PrinterResolution.Kind -Eigenschaft dar, die einen der PrinterResolutionKind -Werte enthält.

Legen Sie die PrinterResolution -Eigenschaft für die Seite auf einen gültigen PrinterResolutionfest, der über die PrinterSettings.PrinterResolutions Auflistung verfügbar ist.

Gilt für:

Freigeben über