Método IFileSaveDialog::SetCollectedProperties (shobjidl_core.h)

  • Artigo

Especifica quais propriedades serão coletadas na caixa de diálogo salvar.

Sintaxe

HRESULT SetCollectedProperties(
  [in] IPropertyDescriptionList *pList,
  [in] BOOL                     fAppendDefault
);

Parâmetros

[in] pList

Tipo: IPropertyDescriptionList*

Ponteiro para a interface que representa a lista de propriedades a serem coletadas. Este parâmetro pode ser NULL.

[in] fAppendDefault

Tipo: BOOL

TRUE para mostrar as propriedades padrão para o tipo de arquivo selecionado no momento, além das propriedades especificadas por pList. FALSE para mostrar apenas as propriedades especificadas por pList.

Valor retornado

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

O aplicativo de chamada pode usar a função PSGetPropertyDescriptionListFromString para construir um IPropertyDescriptionList de uma cadeia de caracteres como "prop:Comments; Assunto;".

Para obter mais informações sobre esquemas de propriedade, consulte Esquemas de propriedade.

IFileSaveDialog::SetCollectedProperties pode ser chamado a qualquer momento antes que a caixa de diálogo seja exibida ou enquanto estiver visível. Se propriedades diferentes forem coletadas dependendo do tipo de arquivo escolhido, IFileSaveDialog::SetCollectedProperties poderá ser chamado em resposta a OnTypeChange.

Nota Por padrão, nenhuma propriedade é coletada na caixa de diálogo salvar.
 

Requisitos

   
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

Confira também

IFileSaveDialog

IFileSaveDialog::SetProperties