PrinterSettings.PrinterResolutions プロパティ

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

PrinterSettings.PrinterResolutions プロパティ

プリンタでサポートされている解像度をすべて取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 PrinterResolutions As PrinterResolutionCollection

Visual Basic (使用法)

Dim instance As PrinterSettings
Dim value As PrinterResolutionCollection

value = instance.PrinterResolutions

C#

public PrinterResolutionCollection PrinterResolutions { get;
 }

C++

public:
property PrinterResolutionCollection^ PrinterResolutions {
    PrinterResolutionCollection^ get ();
}

J#

/** @property */
public PrinterResolutionCollection get_PrinterResolutions ()

JScript

public function get PrinterResolutions
 () : PrinterResolutionCollection

プロパティ値
プリンタでサポートされている解像度を表す PrinterSettings.PrinterResolutionCollection。

解説

PrinterSettings.PrinterResolutionCollection には、PrinterResolution.Kind プロパティを通じてサポートされるプリンタ解像度を表す PrinterResolution インスタンスが格納されていて、PrinterResolutionKind 値のいずれかが含まれています。

通常、ページの給紙方法は、PageSettings.PrinterResolution プロパティを使用して、PrinterResolutions コレクションで取得できる有効な PrinterResolution に設定します。

PrinterResolutionKind が Custom の場合は、X プロパティと Y プロパティを使用して、それぞれ水平方向と垂直方向のカスタム プリンタ解像度を決定します。

使用例

サポートされている解像度を comboPrintResolution コンボ ボックスに表示するコード例を次に示します。この例では、printDoc という名前の PrintDocument 変数と、特定のコンボ ボックスが存在することが必要です。

Visual Basic

' Add list of printer resolutions found on the printer to the combobox.
' The PrinterResolution's ToString() method will be used to provide
 the display string.
Dim pkResolution As PrinterResolution
For i = 0 to printDoc.PrinterSettings.PrinterResolutions.Count
 - 1
    pkResolution = printDoc.PrinterSettings.PrinterResolutions.Item(i)
    comboPrintResolution.Items.Add(pkResolution)
Next

C#

// Add list of printer resolutions found on the printer to the combobox.
// The PrinterResolution's ToString() method will be used to provide
 the display string.

PrinterResolution pkResolution;
for (int i = 0; i < printDoc.PrinterSettings.PrinterResolutions.Count;
 i++){
    pkResolution = printDoc.PrinterSettings.PrinterResolutions[i];
    comboPrintResolution.Items.Add(pkResolution);
}

C++

// Add list of printer resolutions found on the printer to the combobox.
// The PrinterResolution's ToString() method will be used to provide
 the display String.
PrinterResolution^ pkResolution;
for ( int i = 0; i < printDoc->PrinterSettings->PrinterResolutions->Count;
 i++ )
{
   pkResolution = printDoc->PrinterSettings->PrinterResolutions[ i ];
   comboPrintResolution->Items->Add( pkResolution );
}

J#

// Add list of printer resolutions found on the printer to the combobox.
// The PrinterResolution's ToString() method will be used to 
// provide the display string.
PrinterResolution pkResolution;
for (int i = 0; i < printDoc.get_PrinterSettings().
    get_PrinterResolutions().get_Count(); i++) {
    pkResolution = printDoc.get_PrinterSettings().
        get_PrinterResolutions().get_Item(i);
    comboPrintResolution.get_Items().Add(pkResolution);
}

プラットフォーム

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 名前空間
PrinterResolution クラス
PrinterSettings.PrinterResolutionCollection
PrinterSettings.InstalledPrinters プロパティ
PrinterSettings.PaperSizes プロパティ
PrinterSettings.PaperSources プロパティ