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

Confira também

IFileSaveDialog

IFileSaveDialog::GetProperties

IFileSaveDialog::SetCollectedProperties