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

Especifica qué propiedades se recopilarán en el cuadro de diálogo guardar.

Sintaxis

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

Parámetros

[in] pList

Tipo: IPropertyDescriptionList*

Puntero a la interfaz que representa la lista de propiedades que se van a recopilar. Este parámetro puede ser NULL.

[in] fAppendDefault

Tipo: BOOL

TRUE para mostrar las propiedades predeterminadas del tipo de archivo seleccionado actualmente, además de las propiedades especificadas por pList. FALSE para mostrar solo las propiedades especificadas por pList.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La aplicación que llama puede usar la función PSGetPropertyDescriptionListFromString para construir un IPropertyDescriptionList a partir de una cadena como "prop:Comments; Subject;".

Para obtener más información sobre los esquemas de propiedades, vea Esquemas de propiedades.

Se puede llamar a IFileSaveDialog::SetCollectedProperties en cualquier momento antes de que se muestre el cuadro de diálogo o mientras esté visible. Si se van a recopilar propiedades diferentes en función del tipo de archivo elegido, se puede llamar a IFileSaveDialog::SetCollectedProperties en respuesta a OnTypeChange.

Requisitos

Consulte también

IFileSaveDialog

IFileSaveDialog::SetProperties