Método IFileSaveDialog::SetCollectedProperties (shobjidl_core.h)
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.
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 |