PrinterSettings.InstalledPrinters Propriété

Définition

Obtient les noms de toutes les imprimantes installées sur l'ordinateur.Gets the names of all printers installed on the computer.

public:
 static property System::Drawing::Printing::PrinterSettings::StringCollection ^ InstalledPrinters { System::Drawing::Printing::PrinterSettings::StringCollection ^ get(); };
public static System.Drawing.Printing.PrinterSettings.StringCollection InstalledPrinters { get; }
member this.InstalledPrinters : System.Drawing.Printing.PrinterSettings.StringCollection
Public Shared ReadOnly Property InstalledPrinters As PrinterSettings.StringCollection

Valeur de propriété

PrinterSettings.StringCollection représentant les noms de toutes les imprimantes installées sur l'ordinateur.A PrinterSettings.StringCollection that represents the names of all printers installed on the computer.

Exceptions

Les imprimantes disponibles n'ont pas pu être énumérées.The available printers could not be enumerated.

Exemples

L’exemple de code suivant remplit la comboInstalledPrinters zone de liste déroulante avec les imprimantes installées et définit également l’imprimante PrinterName à imprimer, à l’aide de la propriété, lorsque la sélection change.The following code example populates the comboInstalledPrinters combo box with the installed printers and also sets the printer to print, using the PrinterName property, when the selection changes. La PopulateInstalledPrintersCombo routine est appelée lors de l’initialisation du formulaire.The PopulateInstalledPrintersCombo routine is called when the form is being initialized. L’exemple requiert l’existence PrintDocument d’une printDoc variable nommée et de la zone de liste déroulante spécifique.The example requires that a PrintDocument variable named printDoc exists and that the specific combo box exists.

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és pour permettre à l’utilisateur de choisir les imprimantes à imprimer.You can use the collection of installed printer names to provide the user a choice of printers to print to.

Sécurité

PrintingPermission
pour l’impression et l’accès à toutes les imprimantes sur le réseau.for printing and access to all printers on the network. Énumération associée:AllPrintingAssociated enumeration: AllPrinting

S’applique à

Voir aussi