PrinterSettings.InstalledPrinters プロパティ

.NET Framework クラス ライブラリ リファレンス

PrinterSettings.InstalledPrinters プロパティ

コンピュータにインストールされているすべてのプリンタの名前を取得します。

名前空間: System.Drawing.Printing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Shared ReadOnly Property
 InstalledPrinters As StringCollection

Visual Basic (使用法)

Dim value As StringCollection

value = PrinterSettings.InstalledPrinters

C#

public static StringCollection InstalledPrinters
 { get; }

C++

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

J#

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

JScript

public static function get
 InstalledPrinters () : StringCollection

プロパティ値
コンピュータにインストールされているすべてのプリンタの名前を表す PrinterSettings.StringCollection。

例外

例外の種類	条件
Win32Exception	使用できるプリンタを列挙できませんでした。

解説

インストールされているプリンタの名前のコレクションを使用して、ユーザーが印刷先のプリンタを選択できるようにします。

使用例

インストールされているプリンタを comboInstalledPrinters コンボ ボックスに表示し、選択内容が変更されたときに、PrinterName プロパティを使用して印刷を行うプリンタを設定するコード例を次に示します。フォームが初期化されると、PopulateInstalledPrintersCombo ルーチンが呼び出されます。この例では、printDoc という名前の PrintDocument 変数と、特定のコンボ ボックスが存在することが必要です。

Visual Basic

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

C#

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;
    }

}

C++

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;
      }
   }

J#

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 のセキュリティ

• PrintingPermission  (印刷を行うため、およびネットワーク上のすべてのプリンタにアクセスするために必要なアクセス許可)。PrintingPermissionLevel.AllPrinting (関連する列挙体)

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PrinterSettings クラス
PrinterSettings メンバ
System.Drawing.Printing 名前空間
PrinterName