PrinterSettings.InstalledPrinters Propriété

Définition

Espace de noms:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

PrinterSettings.cs

Obtient les noms de toutes les imprimantes installées sur l'ordinateur.

public:
 static property System::Drawing::Printing::PrinterSettings::StringCollection ^ InstalledPrinters { System::Drawing::Printing::PrinterSettings::StringCollection ^ get(); };

public static System.Drawing.Printing.PrinterSettings.StringCollection InstalledPrinters { get; }

static member InstalledPrinters : System.Drawing.Printing.PrinterSettings.StringCollection

Public Shared ReadOnly Property InstalledPrinters As PrinterSettings.StringCollection

Valeur de propriété

PrinterSettings.StringCollection

PrinterSettings.StringCollection représentant les noms de toutes les imprimantes installées sur l'ordinateur.

Exceptions

Win32Exception

Les imprimantes disponibles n'ont pas pu être énumérées.

Exemples

L’exemple de code suivant remplit la comboInstalledPrinters zone de liste modifiable avec les imprimantes installées et définit également l’imprimante à imprimer, à l’aide de la PrinterName propriété , lorsque la sélection change. La PopulateInstalledPrintersCombo routine est appelée lors de l’initialisation du formulaire. L’exemple exige qu’une PrintDocument variable nommée printDoc existe et que la zone de liste modifiable spécifique existe.

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.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 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

Remarques

Vous pouvez utiliser la collection de noms d’imprimantes installées pour fournir à l’utilisateur un choix d’imprimantes sur lesquelles imprimer.

Voir aussi

• PrinterName