Compartilhar via


Icon.ExtractAssociatedIcon(String) Método

Definição

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);
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

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

Exceções

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.

Aplica-se a