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