Método IFileSaveDialog::SetProperties (shobjidl_core.h)
Fornece um repositório de propriedades que define os valores padrão a serem usados para o item que está sendo salvo.
Sintaxe
HRESULT SetProperties(
[in] IPropertyStore *pStore
);
Parâmetros
[in] pStore
Tipo: IPropertyStore*
Ponteiro para a interface que representa o repositório de propriedades que contém os metadados associados.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Esse método pode ser chamado a qualquer momento antes que a caixa de diálogo seja aberta ou enquanto a caixa de diálogo estiver sendo exibida. Se um item tiver propriedades inerentes, esse método deverá ser chamado com essas propriedades antes de mostrar a caixa de diálogo.
Ao usar Salvar como, o aplicativo deve fornecer as propriedades do item que está sendo salvo na caixa de diálogo Salvar . Essas propriedades devem ser retiradas do item original chamando GetPropertyStore com o sinalizador GPS_HANDLERPROPERTIESONLY .
Para recuperar as propriedades do item salvo (que pode ter sido modificado pelo usuário) após o fechamento da caixa de diálogo, chame IFileSaveDialog::GetProperties.
Para ativar a coleção de propriedades e indicar quais propriedades devem ser exibidas na caixa de diálogo Salvar , use IFileSaveDialog::SetCollectedProperties.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shobjidl_core.h |