Icon.ExtractAssociatedIcon(String) Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Icon.cs

Retorna uma representação de ícone de uma imagem que está contida no arquivo especificado.

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

Parâmetros

filePath

String

O caminho para o arquivo que contém uma imagem.

Retornos

Icon

A representação Icon da imagem que está contida no arquivo especificado.

Exceções

ArgumentException

O filePath não indica um arquivo válido.

- ou -

O filePath indica um caminho UNC.

Exemplos

O exemplo de código a seguir demonstra como usar o ExtractAssociatedIcon método . Para executar este exemplo, cole o código em um Windows Form e chame ExtractAssociatedIconEx do construtor ou Load manipulador de eventos do formulário.

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

Comentários

Supõe-se que um caminho relativo seja relativo ao diretório de trabalho atual.

Quando ExtractAssociatedIcon é usado com bitmaps, uma imagem em miniatura pode ser retornada em vez de um ícone se o sistema que está executando o aplicativo tiver uma configuração de registro que faz com que arquivos bitmap sejam mostrados como imagens em miniatura.