GetOpenFileName

O GetOpenFileName função cria uma Abrir caixa de diálogo comum que permite que o usuário especifique a unidade, directório e o nome de um arquivo ou conjunto de arquivos a serem abertos.

(BOOL GetOpenFileName LPOPENFILENAME  lpofn / / endereço da estrutura com inicialização / / dados);
 

Parâmetros

lpofn
Ponteiro para um OPENFILENAME estrutura que contém informações usadas para inicializar a caixa de diálogo. Quando GetOpenFileName retorna, essa estrutura contém informações sobre arquivo seleção do usuário.

Retornar valores

Se o usuário especifica um nome de arquivo e clica no botão OK , o valor de retorno é diferente de zero. A reserva apontada pelo lpstrFile membro das OPENFILENAME estrutura contém os caminho completo e nome do arquivo especificado pelo usuário.

Se o usuário cancela ou fecha a caixa de diálogo Abrir ou ocorre um erro, o valor de retorno é zero. Para obter informações de erro estendidas, chamar o CommDlgExtendedError função, que pode retornar uma dos seguinte valores:

CDERR_FINDRESFAILURE CDERR_NOHINSTANCE
CDERR_INITIALIZATION CDERR_NOHOOK
CDERR_LOCKRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE FNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILURE FNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILURE FNERR_SUBCLASSFAILURE

Observações

Começando com Windows 95 e Windows NT versão 4.0, a caixa de diálogo Abrir padrão fornece recursos de interface do usuário semelhantes do Windows Explorer. Você pode fornecer um procedimento de gancho de OFNHookProc de um Explorer-estilo Abrir caixa de diálogo. Para habilitar o procedimento gancho, definir os sinalizadores OFN_EXPLORER e OFN_ENABLEHOOK in o sinalizadores membro das OPENFILENAME estrutura e especificar o endereço do procedimento de gancho na lpfnHook membro.

Windows 95 e Windows NT continuam a apoiar a antiga caixa de diálogo Abrir para os aplicativos que desejam manter uma interface de usuário compatível com o Windows 3.1 ou Windows NT 3.51-interface do usuário. Para exibir a antiga caixa de diálogo Abrir , activar um procedimento de gancho de OFNHookProcOldStyle e verifique se o Sinalizar OFN_EXPLORER não está definido.

Para exibir uma caixa de diálogo que permite que o usuário selecionar um diretório em vez de um arquivo, chamar o SHBrowseForFolder função.

Windows CE: Nem todos os membros das OPENFILENAME estrutura são definidos em Windows CE. Para obter informações sobre os membros definidos, consulte o tópico de referência para a estrutura OPENFILENAME.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Use comdlg32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comum, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

Index