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	Commdlg.h (inclua Windows.h)

Confira também

Referência

Getopenfilename

Getsavefilename

OPENFILENAME

Conceitual

Biblioteca de caixas de diálogo comuns