Freigeben über

PrinterSettings.InstalledPrinters-Eigenschaft

  • Artikel

Ruft die Namen aller auf dem Computer installierten Drucker ab.

Namespace: System.Drawing.Printing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Shared ReadOnly Property InstalledPrinters As StringCollection
'Usage
Dim value As StringCollection

value = PrinterSettings.InstalledPrinters

public static StringCollection InstalledPrinters { get; }

public:
static property StringCollection^ InstalledPrinters {
    StringCollection^ get ();
}

/** @property */
public static StringCollection get_InstalledPrinters ()

public static function get InstalledPrinters () : StringCollection

Eigenschaftenwert

Eine PrinterSettings.StringCollection, die die Namen aller auf dem Computer installierten Drucker darstellt.

Ausnahmen

Ausnahmetyp Bedingung

Win32Exception

Die verfügbaren Drucker konnten nicht aufgezählt werden.

Hinweise

Mit der Auflistung der Namen der installierten Drucker können Sie Benutzern eine Auswahl von Druckern bieten, auf denen gedruckt werden kann.

Beispiel

Im folgenden Codebeispiel wird das comboInstalledPrinters-Kombinationsfeld mit den installierten Druckern aufgefüllt. Zudem wird der Drucker, mit dem gedruckt werden soll, mithilfe der PrinterName-Eigenschaft festgelegt, wenn sich die Auswahl ändert. Die PopulateInstalledPrintersCombo-Routine wird aufgerufen, wenn das Formular initialisiert wird. Im Beispiel müssen eine PrintDocument-Variable mit dem Namen printDoc und das bestimmte Kombinationsfeld vorhanden sein.

Private Sub PopulateInstalledPrintersCombo()
    ' Add list of installed printers found to the combo box.
    ' The pkInstalledPrinters string will be used to provide the display string.
    Dim i as Integer
    Dim pkInstalledPrinters As String

    For i = 0 to PrinterSettings.InstalledPrinters.Count - 1
        pkInstalledPrinters = PrinterSettings.InstalledPrinters.Item(i)
        comboInstalledPrinters.Items.Add(pkInstalledPrinters)
    Next
End Sub

Private Sub comboInstalledPrinters_SelectionChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles comboInstalledPrinters.SelectedIndexChanged
    ' Set the printer to a printer in the combo box when the selection changes.

    If comboInstalledPrinters.SelectedIndex <> -1 Then
        ' The combo box's Text property returns the selected item's text, which is the printer name.
        printDoc.PrinterSettings.PrinterName = comboInstalledPrinters.Text
    End If


End Sub

private void PopulateInstalledPrintersCombo()
{
    // Add list of installed printers found to the combo box.
    // The pkInstalledPrinters string will be used to provide the display string.
    String pkInstalledPrinters;
    for (int i = 0; i < PrinterSettings.InstalledPrinters.Count; i++){
        pkInstalledPrinters = PrinterSettings.InstalledPrinters[i];
        comboInstalledPrinters.Items.Add(pkInstalledPrinters);
    }
}

private void comboInstalledPrinters_SelectionChanged(object sender, System.EventArgs e)
{

    // Set the printer to a printer in the combo box when the selection changes.

    if (comboInstalledPrinters.SelectedIndex != -1) 
    {
        // The combo box's Text property returns the selected item's text, which is the printer name.
        printDoc.PrinterSettings.PrinterName= comboInstalledPrinters.Text;
    }

}

private:
   void PopulateInstalledPrintersCombo()
   {
      // Add list of installed printers found to the combo box.
      // The pkInstalledPrinters String will be used to provide the display String.
      String^ pkInstalledPrinters;
      for ( int i = 0; i < PrinterSettings::InstalledPrinters->Count; i++ )
      {
         pkInstalledPrinters = PrinterSettings::InstalledPrinters[ i ];
         comboInstalledPrinters->Items->Add( pkInstalledPrinters );
      }
   }

   void comboInstalledPrinters_SelectionChanged( Object^ sender, System::EventArgs^ e )
   {
      // Set the printer to a printer in the combo box when the selection changes.
      if ( comboInstalledPrinters->SelectedIndex != -1 )
      {
         // The combo box's Text property returns the selected item's text, which is the printer name.
         printDoc->PrinterSettings->PrinterName = comboInstalledPrinters->Text;
      }
   }

private void PopulateInstalledPrintersCombo()
{
    // Add list of installed printers found to the combo box.
    // The pkInstalledPrinters string will be used to provide the 
    // display string.
    String pkInstalledPrinters;
    for (int i = 0; i < PrinterSettings.get_InstalledPrinters().
        get_Count(); i++) {
        pkInstalledPrinters = PrinterSettings.get_InstalledPrinters().
            get_Item(i);
        comboInstalledPrinters.get_Items().Add(pkInstalledPrinters);
    }
} //PopulateInstalledPrintersCombo

private void comboInstalledPrinters_SelectionChanged(Object sender, 
    System.EventArgs e)
{
    // Set the printer to a printer in the combo box when the 
    // selection changes.
    if (comboInstalledPrinters.get_SelectedIndex() != -1) {
        // The combo box's Text property returns the selected item's
        // text, which is the printer name.
        printDoc.get_PrinterSettings().
            set_PrinterName(comboInstalledPrinters.get_Text());
    }
} //comboInstalledPrinters_SelectionChanged

.NET Framework-Sicherheit

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PrinterSettings-Klasse
PrinterSettings-Member
System.Drawing.Printing-Namespace
PrinterName