.NET Framework クラス ライブラリ
Icon.ExtractAssociatedIcon メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したファイルに含まれるイメージのアイコン表現を返します。

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

構文

Visual Basic (宣言)
Public Shared Function ExtractAssociatedIcon ( _
    filePath As String _
) As Icon
Visual Basic (使用法)
Dim filePath As String
Dim returnValue As Icon

returnValue = Icon.ExtractAssociatedIcon(filePath)
C#
public static Icon ExtractAssociatedIcon (
    string filePath
)
C++
public:
static Icon^ ExtractAssociatedIcon (
    String^ filePath
)
J#
public static Icon ExtractAssociatedIcon (
    String filePath
)
JScript
public static function ExtractAssociatedIcon (
    filePath : String
) : Icon

パラメータ

filePath

イメージを含むファイルのパス。

戻り値

指定したファイルに含まれるイメージの Icon 表現。
例外

例外の種類条件

ArgumentException

filePath に、有効なファイルが示されていません。

または

filePath は、UNC (Universal Naming Convention) パスを示します。

解説

相対パスは、現在の作業ディレクトリを基準とします。

アプリケーションを実行しているシステムのレジストリでビットマップ ファイルをサムネイル イメージとして表示するように設定されている場合、ビットマップに対して ExtractAssociatedIcon を使用すると、アイコンの代わりにサムネイル イメージが返されます。

使用例

ExtractAssociatedIcon メソッドを使用する方法を次のコード例に示します。この例を実行するには、コードを Windows フォームに貼り付け、フォームのコンストラクタまたは Load のイベント処理メソッドから、ExtractAssociatedIconEx を呼び出します。

Visual Basic
Private Sub ExtractAssociatedIconEx()
    Dim ico As Icon = Icon.ExtractAssociatedIcon("C:\WINDOWS\system32\notepad.exe")
    Me.Icon = ico

End Sub
C#
private void ExtractAssociatedIconEx()
{
    Icon ico =
        Icon.ExtractAssociatedIcon(@"C:\WINDOWS\system32\notepad.exe");
    this.Icon = ico;

}
プラットフォーム

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
参照

タグ :


Page view tracker