Icon.ExtractAssociatedIcon(String) Icon.ExtractAssociatedIcon(String) Icon.ExtractAssociatedIcon(String) Icon.ExtractAssociatedIcon(String) Method

정의

지정된 파일에 들어 있는 이미지의 아이콘 표현을 반환합니다.Returns an icon representation of an image that is contained in the specified file.

public:
 static System::Drawing::Icon ^ ExtractAssociatedIcon(System::String ^ filePath);
public static System.Drawing.Icon ExtractAssociatedIcon (string filePath);
static member ExtractAssociatedIcon : string -> System.Drawing.Icon
Public Shared Function ExtractAssociatedIcon (filePath As String) As Icon

매개 변수

filePath
String String String String

이미지가 들어 있는 파일에 대한 경로입니다.The path to the file that contains an image.

반환

지정된 파일에 들어 있는 이미지의 Icon 표현입니다.The Icon representation of the image that is contained in the specified file.

예외

filePath가 유효한 파일을 나타내지 않는 경우The filePath does not indicate a valid file.

또는-or- filePath가 UNC(Universal Naming Convention) 경로를 나타내는 경우The filePath indicates a Universal Naming Convention (UNC) path.

예제

다음 코드 예제에서는 ExtractAssociatedIcon 메서드를 사용하는 방법을 보여 줍니다.The following code example demonstrates how to use the ExtractAssociatedIcon method. 이 예제를 실행 하려면 호출을 Windows Form에 코드를 붙여넣은 ExtractAssociatedIconEx 폼의 생성자에서 또는 Load 이벤트 처리기입니다.To run this example, paste the code into a Windows Form and call ExtractAssociatedIconEx from the form's constructor or Load event handler.

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

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

End Sub

설명

상대 경로 현재 작업 디렉터리를 기준으로 간주 됩니다.A relative path is assumed to be relative to the current working directory.

ExtractAssociatedIcon 는 비트맵을 사용 하 여 썸네일 이미지를 반환 될 수 있습니다 아이콘 대신 시스템에 있는 경우 애플리케이션을 실행 하는 비트맵 파일 미리 보기 이미지로 표시 하는 레지스트리 설정 합니다.When ExtractAssociatedIcon is used with bitmaps, a thumbnail image may be returned instead of an icon if the system that is running the application has a registry setting that causes bitmap files to be shown as thumbnail images.

적용 대상