Icon.ExtractAssociatedIcon メソッド

.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

参照

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