CDM_GETFILEPATH mensagem
[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.]
Recupera o caminho e o nome do arquivo selecionado em uma caixa de diálogo Abrir ou Salvar como no estilo Explorer. A caixa de diálogo deve ter sido criada com o sinalizador OFN_EXPLORER ; caso contrário, a mensagem falhará.
#define WM_USER 0x0400
#define CDM_FIRST (WM_USER + 100)
#define CDM_GETFILEPATH (CDM_FIRST + 0x0001)
Parâmetros
-
wParam
-
O tamanho, em caracteres, do buffer lParam . Para a versão ANSI, esse é o número de bytes; para a versão Unicode, esse é o número de caracteres.
-
lParam
-
Um ponteiro para o buffer que recebe o nome e o caminho do arquivo.
Valor retornado
Se a mensagem for bem-sucedida, o valor retornado será o tamanho, em caracteres, do nome do arquivo e da cadeia de caracteres de caminho, incluindo o caractere NULL de terminação. Esse é o número de bytes ou caracteres copiados para o buffer ou o tamanho do buffer necessário se o buffer for muito pequeno.
Se ocorrer um erro, o valor retornado será menor que zero.
Comentários
A macro correspondente é a seguinte:
int CommDlg_OpenSave_GetFilePath(hwnd, lparam, wparam);
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 |
|
Confira também
-
Referência
-
Conceitual