Caixas de diálogo Abrir e Salvar como

[A partir do Windows Vista, as caixas de diálogo comuns Abrir e Salvar como foram substituídas pelo de Diálogo de Item Comum. Recomendamos que você use a API de Diálogo de Item Comum em vez dessas caixas de diálogo da Biblioteca de Caixas de Diálogo Comuns.]

A caixa de diálogo Abrir permite que o usuário especifique a unidade, o diretório e o nome de um arquivo ou conjunto de arquivos a serem abertos. Crie e exiba uma caixa de diálogo abrir inicializando uma estruturaOPENFILENAME e passando a estrutura para a função GetOpenFileName.

A caixa de diálogo Salvar como permite que o usuário especifique a unidade, o diretório e o nome de um arquivo a ser salvo. Crie e exiba uma caixa de diálogo Salvar como inicializando uma estrutura OPENFILENAME e passando a estrutura para a função GetSaveFileName.

As caixas de diálogo Open e Salvar como do Explorer fornecem recursos de interface do usuário semelhantes ao Windows Explorer. No entanto, o sistema continua a dar suporte ao estilo antigo Caixas de diálogo Abrir e Salvar como para aplicativos que devem ser consistentes com a interface do usuário de estilo antigo.

Além da diferença de aparência, as caixas de diálogo estilo Explorer e estilo antigo diferem no uso de modelos personalizados e procedimentos de gancho para personalizar as caixas de diálogo. No entanto, as caixas de diálogo estilo Explorer e estilo antigo têm o mesmo comportamento para a maioria das operações básicas, como especificar um filtro de nome de arquivo, validar a entrada do usuário e obter o nome do arquivo especificado pelo usuário. Para obter mais informações sobre as caixas de diálogo estilo Explorer e estilo antigo, consulte Abrir e Salvar comode Personalização da Caixa de Diálogo .

A ilustração a seguir mostra uma caixa de diálogo de de estilo do Explorer típica abrir.

A ilustração a seguir mostra uma caixa de diálogo estilo Explorer típica.

Se o usuário especificar um nome de arquivo e clicar no botão OK, GetOpenFileName ou GetSaveFileName retornará TRUE. O buffer apontado pelo lpstrFile membro da estruturaOPENFILENAME contém o caminho completo e o nome do arquivo especificados pelo usuário.

Se o usuário cancelar a caixa de diálogo Abrir ou Salvar como ou ocorrer um erro, a função retornará false. Para determinar a causa do erro, chame a função CommDlgExtendedError para recuperar o valor de erro estendido. Se o lpstrFile buffer for muito pequeno para receber o nome completo, CommDlgExtendedError retornará FNERR_BUFFERTOOSMALL e os dois primeiros bytes do buffer apontados pelo membro lpstrFile serão definidos como um valor inteiro especificando o tamanho necessário para receber o nome completo.

Os tópicos a seguir são discutidos nesta seção.

• nomes e diretórios de arquivos
• filtros de
• de validação de arquivo e diretório
• abrir e salvar como de personalização da caixa de diálogo
• de procedimentos de gancho deExplorer-Style
• Explorer-Style modelos personalizados
• Identificadores de controle Explorer-Style
• personalizando caixas de diálogo Old-Style

Nomes e diretórios de arquivos

As informações nesta seção se aplicam às caixas de diálogo Open e Salvar como do Explorer.

Antes de chamar as funções GetOpenFileName ou GetSaveFileName, o lpstrFile membro da estruturaOPENFILENAME deve apontar para o buffer para receber o nome do arquivo. O membro nMaxFile deve especificar o tamanho, em caracteres, do buffer lpstrFile. Para uma função ANSI, esse é o número de bytes, mas para uma função Unicode esse é o número de caracteres.

Se o usuário especificar um nome de arquivo e clicar no botão OK, a caixa de diálogo copiará a unidade, o diretório e o nome do arquivo selecionados para o buffer de lpstrFile. A função também define os membros nFileOffset e nFileExtension para os deslocamentos, em caracteres, desde o início do buffer até o nome do arquivo e para a extensão de nome de arquivo, respectivamente.

Para recuperar apenas o nome e a extensão do arquivo, defina o lpstrFileTitle membro para apontar para um buffer e defina o membro nMaxFileTitle para o tamanho, em caracteres, do buffer. Como alternativa, você pode passar o buffer lpstrFile em uma chamada para a funçãoGetFileTitlepara obter o nome de exibição do arquivo selecionado. No entanto, observe que o nome do arquivo que GetFileTitle retorna incluirá uma extensão somente se essa for a preferência do usuário para exibir nomes de arquivo.

A caixa de diálogo usa o diretório atual para o processo de chamada como o diretório inicial do qual exibir arquivos e diretórios. Use as funções GetCurrentDirectory e SetCurrentDirectory para obter e alterar o diretório atual de um processo. Para especificar um diretório inicial diferente sem alterar o diretório atual, use o membro lpstrInitialDir para especificar o nome de um diretório. A caixa de diálogo altera automaticamente o diretório atual quando o usuário seleciona uma unidade ou diretório diferente. Para impedir que a caixa de diálogo altere o diretório atual, defina o sinalizador OFN_NOCHANGEDIR. Esse sinalizador não impede que o usuário altere diretórios para localizar um arquivo.

Para especificar uma extensão de nome de arquivo padrão, use o membro lpstrDefExt. Se o usuário especificar um nome de arquivo que não tenha uma extensão, a caixa de diálogo adicionará sua extensão padrão. Se você especificar uma extensão padrão e o usuário especificar um nome de arquivo com uma extensão diferente, a caixa de diálogo definirá o sinalizador OFN_EXTENSIONDIFFERENT.

Para permitir que o usuário selecione mais de um arquivo de um diretório, defina o sinalizador OFN_ALLOWMULTISELECT. Para compatibilidade com aplicativos mais antigos, a caixa de diálogo de seleção múltipla padrão usa a interface do usuário de estilo antigo. Para exibir uma caixa de diálogo de seleção múltipla no estilo Explorer, você também deve definir o sinalizador OFN_EXPLORER.

Se o usuário selecionar mais de um arquivo, o buffer apontado pelo membro lpstrFile retornará o caminho para o diretório atual seguido pelos nomes de arquivo dos arquivos selecionados. O membro nFileOffset é o deslocamento para o nome do primeiro arquivo e o membro nFileExtension não é usado. A tabela a seguir descreve a diferença entre as caixas de diálogo estilo Explorer e estilo antigo no retorno de vários nomes de arquivo.

Você pode usar a função FindFirstFile para converter entre nomes de arquivo longos e curtos.

Se você especificar OFN_ALLOWMULTISELECT e o usuário selecionar apenas um arquivo, o lpstrFile cadeia de caracteres não terá um separador entre o caminho e o nome do arquivo.

Filtros

As informações nesta seção se aplicam ao estilo explorer e ao estilo antigo caixas de diálogo Abrir e Salvar como.

Você pode fornecer filtros de nome de arquivo para ajudar o usuário a limitar os nomes de arquivo exibidos pela caixa de diálogo. Um filtro de nome de arquivo consiste em um par de cadeias de caracteres terminadas em nulo, uma descrição e um padrão, um concatenado para o outro. A caixa de diálogo exibe a descrição para permitir que o usuário escolha qual filtro usar; e usa o padrão para selecionar os arquivos a serem exibidos.

Para especificar os filtros, defina o lpstrFilter membro da estruturaOPENFILENAME para apontar para um buffer que contém uma matriz de pares de cadeia de caracteres de filtro. A última cadeia de caracteres na matriz deve ser seguida por um caractere nulo extra.

Uma cadeia de caracteres padrão pode ser uma combinação de caracteres de nome de arquivo válidos e o asterisco (*). O asterisco é um curinga que representa qualquer combinação de caracteres de nome de arquivo válidos. A caixa de diálogo exibe apenas os arquivos que correspondem ao padrão. Para especificar vários padrões para a mesma descrição, você deve usar um ponto e vírgula (;) para separar os padrões. Observe que os caracteres de espaço na cadeia de caracteres padrão podem produzir resultados inesperados.

O fragmento de código a seguir especifica dois filtros. O filtro com a descrição "Origem" tem dois padrões. Se o usuário selecionar esse filtro, a caixa de diálogo exibirá apenas os arquivos que têm o . C e . Extensões CXX. Observe que, na linguagem de programação C, uma cadeia de caracteres entre aspas duplas é terminada em nulo.

OPENFILENAME ofn;       // common dialog box structure

ofn.lpstrFilter = "Source\0*.C;*.CXX\0All\0*.*\0"
ofn.nFilterIndex = 1;

O nFilterIndex membro da estruturaOPENFILENAME especifica um índice que indica qual filtro a caixa de diálogo usa inicialmente. O primeiro filtro no buffer tem o índice 1, o segundo 2 e assim por diante. Se o usuário alterar o filtro ao usar a caixa de diálogo, o membro nFilterIndex será definido como o índice do filtro selecionado no retorno.

Você pode criar um filtro personalizado definindo o membro lpstrCustomFilter para o endereço de um buffer que contém um único filtro e definindo o membro nMaxCustFilter para o tamanho do buffer, em caracteres ou bytes. A caixa de diálogo sempre coloca o filtro personalizado no início da lista de filtros e, no retorno, sempre atualiza a parte padrão do filtro com o padrão do filtro selecionado pelo usuário.

Para caixas de diálogo no estilo Explorer, a extensão padrão poderá ser alterada se o usuário selecionar um filtro diferente. Se o usuário selecionar um filtro cujo primeiro padrão é do formulário *.xxx (ou seja, a extensão não inclui um caractere curinga), a caixa de diálogo usa xxx como a extensão padrão. Isso ocorre somente se você especificou uma extensão padrão no lpstrDefExt membro da estruturaOPENFILENAME. Por exemplo, se o usuário selecionar "Origem\0*. C;*. Filtro CXX\0", a extensão padrão muda para "C". No entanto, se você tiver definido o filtro como "Source\0*. C*\0", a extensão padrão não seria alterada porque a extensão inclui um curinga.

A mensagem de notificação CDN_INCLUDEITEM fornece outra maneira de filtrar os nomes exibidos pela caixa de diálogo. Para usar essa mensagem, forneça um procedimento de gancho de OFNHookProc e especifique o sinalizador OFN_ENABLEINCLUDENOTIFY na estruturaOPENFILENAME ao criar a caixa de diálogo. Sempre que o usuário abre uma pasta, a caixa de diálogo envia uma notificação CDN_INCLUDEITEM para o procedimento de gancho para cada item na pasta recém-aberta. O valor retornado do procedimento de gancho indica se a caixa de diálogo deve exibir o item na lista de itens da pasta.

Validação de arquivo e diretório

Exceto conforme observado, as informações nesta seção se aplicam às caixas de diálogo Open e Salvar como do Explorer.

A caixa de diálogo valida automaticamente os nomes de arquivo digitado pelo usuário para garantir que os nomes contenham apenas caracteres válidos. Para substituir a validação do caractere de nome de arquivo, defina o sinalizador OFN_NOVALIDATE.

Para forçar a caixa de diálogo a verificar se o usuário especificou o nome de um arquivo existente, defina o sinalizador OFN_FILEMUSTEXIST. Para forçar a verificação de que o caminho especificado existe, defina o sinalizador OFN_PATHMUSTEXIST. Se você definir o sinalizador OFN_CREATEPROMPT, a caixa de diálogo solicitará ao usuário permissão para criar um arquivo inexistente. Se esse sinalizador estiver definido e o usuário optar por criar um novo arquivo, a caixa de diálogo será fechada e a função retornará o nome especificado. Caso contrário, a caixa de diálogo permanecerá aberta.

Ao usar a caixa de diálogo Salvar como, você pode direcionar a caixa de diálogo para solicitar permissão ao usuário para substituir um arquivo existente definindo o sinalizador OFN_OVERWRITEPROMPT.

Por padrão, a caixa de diálogo cria um arquivo de teste de comprimento zero para determinar se um novo arquivo pode ser criado no diretório selecionado. Para impedir a criação desse arquivo de teste, defina o sinalizador de OFN_NOTESTFILECREATE.

Se você habilitar um procedimento de gancho, a caixa de diálogo notificará o procedimento de gancho quando ocorrer uma violação de compartilhamento de rede para o nome do arquivo especificado pelo usuário. Se você definir o sinalizador OFN_EXPLORER, a caixa de diálogo enviará a mensagem CDN_SHAREVIOLATION para o procedimento de gancho. Se você não definir OFN_EXPLORER, a caixa de diálogo enviará o SHAREVISTRING mensagem registrada para o procedimento de gancho. Para impedir que a caixa de diálogo envie notificações para violações de compartilhamento, defina o sinalizador OFN_SHAREAWARE.

Se o usuário marcar a caixa de seleção somente leitura, a caixa de diálogo definirá o sinalizador OFN_READONLY no retorno. Para ocultar a caixa de seleção Abrir como Somente Leitura, defina o sinalizador OFN_HIDEREADONLY. Para impedir que a caixa de diálogo retorne nomes de arquivos existentes que têm o atributo somente leitura, defina o sinalizador OFN_NOREADONLYRETURN.

Para impedir que a caixa de diálogo desrefera arquivos de link, defina o valor OFN_NODEREFERENCELINKS. Nesse caso, a caixa de diálogo retorna o nome do arquivo de link em vez do nome do arquivo referenciado pelo arquivo de link.

Abrir e salvar como personalização da caixa de diálogo

Você pode personalizar uma caixa de diálogo Abrir ou Salvar como fornecendo um procedimento de gancho, um modelo personalizado ou ambos. No entanto, as versões de estilo explorer e de estilo antigo das caixas de diálogo diferem no uso de modelos personalizados e procedimentos de gancho.

Para obter informações sobre como personalizar uma caixa de diálogo no estilo Explorer, consulte Explorer-Style procedimentos de gancho, Explorer-Style modelos personalizadose Explorer-Style identificadores de controle. Para obter informações sobre como personalizar uma caixa de diálogo de estilo antigo, consulte Personalizando caixas de diálogo Old-Style.

A tabela a seguir resume as diferenças entre os dois estilos.

O título padrão para caixas de diálogo estilo Explorer e estilo antigo é "Open" ou "Save As". Para alterar o título, especifique o novo título no lpstrTitle membro da estruturaOPENFILENAME.

O hive do registro HKEY_CURRENT_USER de um usuário pode conter valores que personalizam o conteúdo das caixas de diálogo Abrir e Salvar como no estilo Explorer. Essas entradas do Registro afetam apenas as caixas de diálogo exibidas para o usuário associado ao hive do Registro.

Para ocultar os recursos de de estilo Explorer, abra e caixas de diálogo Salvar como, um administrador pode definir os valores na tabela a seguir nesta subchave:

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies
                  Comdlg32

O conteúdo da barra Locais é determinado pelo conteúdo da seguinte subchave:

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies
                  Comdlg32
                     Placesbar

Atualmente, só pode haver cinco entradas sob essa chave e o índice de valor/nome é baseado em zero. Os nomes das entradas devem ser Place0, Place1, Place2, Place3 e Place4. Os valores das entradas podem ser REG_DWORD, REG_SZou REG_EXPAND_SZ valores que identificam os locais a serem incluídos na barra de locais.

Procedimentos de gancho de Explorer-Style

Você pode personalizar uma caixa de diálogo Abrir ou Salvar como fornecendo um procedimento de gancho, um modelo personalizado ou ambos. Se você fornecer um procedimento de gancho para uma caixa de diálogo no estilo Explorer, o sistema criará uma caixa de diálogo que é filho da caixa de diálogo padrão. O procedimento de gancho atua como o procedimento de diálogo da caixa de diálogo filho. Essa caixa de diálogo filho é baseada no modelo personalizado ou em um modelo padrão, se nenhum for fornecido. Para obter mais informações, consulte Explorer-Style modelos personalizados.

Para habilitar um procedimento de gancho para um open ou caixa de diálogo Salvar como, use a estruturaOPENFILENAME ao criar a caixa de diálogo. Defina os sinalizadores OFN_ENABLEHOOK e OFN_EXPLORER no membro sinalizadores do e especifique o endereço de um procedimento de gancho de OFNHookProc no membro do lpfnHook. Se você fornecer um procedimento de gancho e omitir o sinalizador de OFN_EXPLORER, deverá usar um procedimento OFNHookProcOldStyle hook e obterá a interface do usuário de estilo antigo. Para obter mais informações, consulte Personalizando caixas de diálogo Old-Style.

Um procedimento de gancho no estilo Explorer recebe uma variedade de mensagens enquanto a caixa de diálogo está aberta. Estes incluem o seguinte:

• A mensagem WM_INITDIALOG e outras mensagens da caixa de diálogo padrão, como a mensagem de cor de controle WM_CTLCOLORDLG.
• Um conjunto de mensagens de notificação WM_NOTIFY indicando ações executadas pelo usuário ou outros eventos da caixa de diálogo.
• Mensagens para quaisquer controles adicionais que você definiu especificando um modelo de caixa de diálogo filho.

Além disso, há um conjunto de mensagens que você pode enviar para uma caixa de diálogo estilo Explorer para obter informações ou para controlar o comportamento e a aparência da caixa de diálogo.

Se você fornecer um procedimento de gancho para uma caixa de diálogo no estilo Explorer, o procedimento da caixa de diálogo padrão criará uma caixa de diálogo filho quando o procedimento de diálogo padrão estiver processando sua mensagem de WM_INITDIALOG. O procedimento de gancho atua como o procedimento de diálogo da caixa de diálogo filho. Neste momento, o procedimento de gancho recebe sua própria mensagem de WM_INITDIALOG com o parâmetro lParam definido como o endereço da estruturaOPENFILENAME usada para inicializar a caixa de diálogo. Depois que a caixa de diálogo filho terminar de processar seu próprio WM_INITDIALOG mensagem, o procedimento de diálogo padrão move os controles padrão, se necessário, para abrir espaço para quaisquer controles adicionais da caixa de diálogo filho. O procedimento de caixa de diálogo padrão envia a mensagem de notificação CDN_INITDONE para o procedimento de gancho.

O procedimento de gancho recebe mensagens de notificação WM_NOTIFY indicando as ações executadas pelo usuário na caixa de diálogo. Você pode usar algumas dessas mensagens para controlar o comportamento da caixa de diálogo. Por exemplo, o procedimento de gancho recebe a mensagem de CDN_FILEOK quando o usuário escolhe um nome de arquivo e clica no botão OK. Em resposta a essa mensagem, o procedimento de gancho pode usar a função SetWindowLong para rejeitar o nome selecionado e forçar a caixa de diálogo a permanecer aberta.

O parâmetro lParam para cada mensagem WM_NOTIFY é um ponteiro para uma estruturaOFNOTIFY ouOFNOTIFYEX que define a ação. O código membro no cabeçalho dessa estrutura contém uma das mensagens de notificação a seguir.

Essas mensagens WM_NOTIFY substituem o FILEOKSTRING, LBSELCHSTRING, SHAREVISTRING e HELPMSGSTRING mensagens registradas usadas por versões anteriores das caixas de diálogo Abrir e Salvar como. No entanto, o procedimento de gancho também receberá a mensagem substituída após a mensagem WM_NOTIFY se o processamento de WM_NOTIFY não usar SetWindowLong para definir um valor de DWL_MSGRESULT diferente de zero.

Para recuperar informações sobre o status da caixa de diálogo ou para controlar o comportamento e a aparência da caixa de diálogo, o procedimento de gancho pode enviar as seguintes mensagens para a caixa de diálogo.

Explorer-Style modelos personalizados

Para definir controles adicionais para um open ou caixa de diálogo Salvar como, use a estruturaOPENFILENAME para especificar um modelo para uma caixa de diálogo filho que contenha os controles adicionais. Se o modelo de caixa de diálogo filho for um recurso em um aplicativo ou biblioteca de vínculo dinâmico, defina o sinalizador OFN_ENABLETEMPLATE no membro sinalizadores do e use o hInstance e lpTemplateName membros da estrutura para identificar o módulo e o nome do recurso. Se o modelo já estiver na memória, defina o sinalizador OFN_ENABLETEMPLATEHANDLE e use o hInstance membro para identificar o objeto de memória que contém o modelo. Ao fornecer um modelo de caixa de diálogo filho para uma caixa de diálogo no estilo Explorer, você também deve definir o sinalizador OFN_EXPLORER; caso contrário, o sistema pressupõe que você esteja fornecendo um modelo de substituição para uma caixa de diálogo de estilo antigo. Normalmente, se você fornecer controles adicionais, também deverá fornecer um procedimento de gancho no estilo Explorer para processar mensagens para os novos controles.

Você pode criar seu modelo de caixa de diálogo filho como faz com qualquer outro modelo, exceto que você deve especificar os estilos WS_CHILD e WS_CLIPSIBLINGS e deve especificar os estilos DS_3DLOOK e DS_CONTROL. O sistema requer o estilo WS_CHILD porque seu modelo define uma caixa de diálogo filho da caixa de diálogo Abrir ou Salvar como padrão. O estilo WS_CLIPSIBLINGS garante que a caixa de diálogo filho não pinte nenhum dos controles na caixa de diálogo padrão. O estilo DS_3DLOOK garante que a aparência dos controles na caixa de diálogo filho seja consistente com os controles na caixa de diálogo padrão. O estilo DS_CONTROL garante que o usuário possa usar o TAB e outras chaves de navegação para se mover entre todos os controles, padrão ou personalizado, na caixa de diálogo personalizada.

Para abrir espaço para os novos controles, o sistema expande a caixa de diálogo padrão pela largura e altura da caixa de diálogo personalizada. Por padrão, todos os controles da caixa de diálogo personalizada são posicionados abaixo dos controles na caixa de diálogo padrão. No entanto, você pode substituir esse posicionamento padrão incluindo um controle de texto estático em seu modelo de caixa de diálogo personalizada e atribuindo-lhe o valor do identificador de controle de stc32. (Esse valor é definido no arquivo de cabeçalho Dlgs.h.) Nesse caso, o sistema usa o controle como ponto de referência para determinar onde posicionar os novos controles. Todos os novos controles acima e à esquerda da stc32 controle são posicionados na mesma quantidade acima e à esquerda dos controles na caixa de diálogo padrão. Novos controles abaixo e à direita do stc32 controle são posicionados abaixo e à direita dos controles padrão. Em geral, cada novo controle é posicionado para que ele tenha a mesma posição em relação aos controles padrão que tinha para o controle stc32. Para abrir espaço para esses novos controles, o sistema adiciona espaço à esquerda, à direita, à parte inferior e à parte superior da caixa de diálogo padrão, conforme necessário.

O sistema requer que o procedimento de gancho processe todas as mensagens destinadas à caixa de diálogo personalizada e, portanto, envia as mesmas mensagens de janela para o procedimento de gancho como para qualquer outro procedimento de caixa de diálogo. Por exemplo, o procedimento de gancho recebe mensagens WM_COMMAND quando o usuário clica em controles de botão na caixa de diálogo personalizada. O procedimento de gancho é responsável por inicializar esses controles e recuperar valores dos controles quando a caixa de diálogo é fechada. Observe que, quando o procedimento de gancho recebe a mensagem WM_INITDIALOG, o sistema ainda não moveu os controles para suas posições finais.

O procedimento da caixa de diálogo padrão manipula mensagens para todos os controles na caixa de diálogo padrão, mas o procedimento de gancho recebe as mensagens de notificação para ações do usuário nesses controles, conforme descrito em Explorer-Style Procedimentos de Gancho.

Identificadores de controle Explorer-Style

O SDK (Windows Software Development Kit) fornece o modelo de caixa de diálogo padrão para as caixas de diálogo de estilo antigo, mas não inclui o modelo padrão para as caixas de diálogo estilo Explorer. Isso ocorre porque as caixas de diálogo estilo Explorer permitem adicionar seus próprios controles, mas não dão suporte à modificação do modelo para os controles padrão. No entanto, em alguns casos, talvez seja necessário conhecer os identificadores de controle usados nos modelos padrão. Por exemplo, as mensagens CDM_HIDECONTROL e CDM_SETCONTROLTEXT exigem um identificador de controle.

A tabela a seguir mostra os identificadores dos controles padrão no estilo Explorer Caixas de diálogo Abrir e Salvar como. Os identificadores são constantes definidas em Dlgs.h e Winuser.h.

Personalizando caixas de diálogo Old-Style

Você pode personalizar uma caixa de diálogo Open ou Salvar como, fornecendo um procedimento de ganchoOFNHookProcOldStyle que recebe mensagens ou notificações destinadas ao procedimento de caixa de diálogo padrão. Você também pode fornecer um modelo personalizado para usar no lugar do modelo padrão. Os procedimentos de gancho e os modelos usados com as caixas de diálogo de estilo antigo são semelhantes aos usados com as outras caixas de diálogo comuns. Para obter mais informações, consulte Procedimentos de gancho para caixas de diálogo comuns e modelos personalizados.

Para habilitar um procedimento de gancho para um de estilo antigo, abra ou caixa de diálogo Salvar como, use a estruturaOPENFILENAME ao criar a caixa de diálogo. Defina o sinalizador OFN_ENABLEHOOK no membro do sinalizadores do e especifique o endereço de um procedimento de gancho OFNHookProcOldStyle no membro do lpfnHook. O procedimento da caixa de diálogo envia uma mensagem WM_INITDIALOG para o procedimento de gancho com o parâmetro Param definido como o endereço da estrutura OPENFILENAME usada para inicializar a caixa de diálogo.

Você pode usar a estruturaOPENFILENAME para especificar um modelo personalizado para a caixa de diálogo Abrir ou Salvar como para usar no lugar do modelo padrão. Se o modelo personalizado for um recurso em um aplicativo ou biblioteca de vínculo dinâmico, defina o sinalizador OFN_ENABLETEMPLATE no membro sinalizadores do e use o hInstance e lpTemplateName membros da estrutura para identificar o módulo e o nome do recurso. Se o modelo personalizado já estiver na memória, defina o sinalizador OFN_ENABLETEMPLATEHANDLE e use o hInstance membro para identificar o objeto de memória que contém o modelo. Crie o modelo personalizado modificando o modelo padrão especificado no arquivo Fileopen.dlg. Os identificadores de controle usados nos modelos de diálogo Localizar e Substituir padrão são definidos no arquivo Dlgs.h.

Por padrão, as funçõesGetOpenFileNamee GetSaveFileName exibem as caixas de diálogo estilo Explorer. Se você quiser exibir uma caixa de diálogo de estilo antigo, forneça um procedimento de ganchoOFNHookProcOldStylee verifique se o sinalizador de OFN_EXPLORER não está definido no Flags membro da estrutura OPENFILENAME.

Se você definir o sinalizador OFN_EXPLORER, o sistema tratará um procedimento de gancho ou um modelo personalizado como uma personalização no estilo Explorer. Para obter informações sobre como personalizar uma caixa de diálogo no estilo Explorer, consulte Explorer-Style Modelos Personalizados.

Consulte também

• Arquivo está em uso de exemplo