Partilhar via


Mensagem FILEOKSTRING

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

Uma caixa de diálogo Abrir ou Salvar como envia a mensagem registrada FILEOKSTRING para o procedimento de gancho , OFNHookProc, quando o usuário especifica um nome de arquivo e clica no botão OK . O procedimento de gancho pode aceitar o nome do arquivo e permitir que a caixa de diálogo feche ou rejeitar o nome do arquivo e forçar a caixa de diálogo a permanecer aberta.

#define FILEOKSTRING TEXT("commdlg_FileNameOK")

Parâmetros

wParam

Este parâmetro não é usado.

lParam

Um ponteiro para uma estrutura OPENFILENAME . O membro lpstrFile dessa estrutura contém a unidade, o caminho e o nome do arquivo especificados pelo usuário.

Valor retornado

Se o procedimento de gancho retornar zero, a caixa de diálogo Abrir ou Salvar como aceitará o nome do arquivo especificado e fechará.

Se o procedimento de gancho retornar um valor diferente de zero, a caixa de diálogo Abrir ou Salvar como rejeitará o nome do arquivo especificado e permanecerá aberta.

Comentários

O procedimento de gancho deve especificar a constante FILEOKSTRING em uma chamada para a função RegisterWindowMessage para obter o identificador da mensagem enviada pela caixa de diálogo.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Commdlg.h (inclua Windows.h)
Nomes Unicode e ANSI
FILEOKSTRINGW (Unicode) e FILEOKSTRINGA (ANSI)

Confira também

Referência

CDN_FILEOK

OPENFILENAME

Registerwindowmessage

Conceitual

Biblioteca de caixas de diálogo comuns