A caixa de diálogo Abrir permite que o usuário especifique a unidade, directório e o nome de um arquivo ou conjunto de arquivos a serem abertos. Criar e exibir uma caixa de diálogo Abrir ao inicializar uma estrutura OPENFILENAME e passando a estrutura para o GetOpenFileName função.
A caixa de diálogo Salvar como permite que o usuário especifique a unidade, o diretório e o nome de um arquivo para salvar. Criar e exibir uma caixa de diálogo Salvar como , ao inicializar uma estrutura OPENFILENAME e passando a estrutura para a função GetSaveFileName.
Começando com Windows 95 e Windows NT versão 4.0, uma nova versão das caixas de diálogo Abrir e Salvar como oferece recursos de interface do usuário semelhantes do Windows Explorer. No entanto, o sistema continua a oferecer suporte as caixas de diálogo Abrir e Salvar como de estilo antigo para aplicativos que devem ser compatíveis com a interface do usuário mais antiga.
Além da diferença na aparência, o estilo do Explorer e caixas de diálogo do estilo antigo diferem em termos de modelos personalizados em gancho procedimentos para personalizar as caixas de diálogo. No entanto, o estilo do Explorer e caixas de diálogo do estilo antigo têm o mesmo comportamento para operações mais básicas, tais como especificar um filtro de nome de arquivo, Validando a entrada do usuário e recebendo o nome de arquivo especificado pelo usuário. Para obter mais informações sobre o estilo do Explorer e caixas de diálogo do estilo antigo, consulte Abrir e salvar como caixa de diálogo caixa de personalização.
A ilustração a seguir mostra uma típica caixa de diálogo estilo do Explorer Abrir.
A ilustração a seguir mostra uma típica caixa de diálogo estilo do Explorer Salvar como.
Se o usuário especifica um nome de arquivo e clica no botão OK , GetOpenFileName ou GetSaveFileName retorna TRUE. 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 cancelar a caixa de diálogo Abrir ou Salvar como ou se ocorrer um erro, a função retorna FALSE. Para determinar a causa do erro, chame o CommDlgExtendedError função para recuperar o valor de erro estendidas. Se a lpstrFile reserva é muito pequena para receber o nome completo, CommDlgExtendedError retorna FNERR_BUFFERTOOSMALL e os primeiros 2 bytes da reserva apontado pelo lpstrFile membro são definidos como um valor inteiro especificando o tamanho exigido para receber o nome completo.
Caixas de diálogo do estilo do explorador só estão disponíveis para aplicativos de 32 bits. aplicativos de 16 bits não podem usar a conversão para exibir uma caixa de diálogo do estilo do Explorer.
Windows 95 e Windows 98: Aplicativos baseados em Win32 que usam as caixas de diálogo do estilo antigo fazem-lo usando uma conversão. Isso significa que qualquer ponteiro passado para o procedimento de gancho é uma cópia não persistente dos dados. Por exemplo, o ponteiro OPENFILENAME transmitido o WM_INITDIALOG mensagem não é um ponteiro para a reserva que você especificou originalmente. Se você precisar passar dados privados para o procedimento gancho, ele do pacote em uma estrutura e armazenar um ponteiro para a estrutura in a lCustData membro das OPENFILENAME estrutura.