Metodo IFileSaveDialog::SetCollectedProperties (shobjidl_core.h)

Specifica le proprietà che verranno raccolte nella finestra di dialogo di salvataggio.

Sintassi

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

Parametri

[in] pList

Tipo: IPropertyDescriptionList*

Puntatore all'interfaccia che rappresenta l'elenco di proprietà da raccogliere. Questo parametro può essere NULL.

[in] fAppendDefault

Tipo: BOOL

TRUE per visualizzare le proprietà predefinite per il tipo di file attualmente selezionato oltre alle proprietà specificate da pList. FALSE per visualizzare solo le proprietà specificate da pList.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'applicazione chiamante può usare la funzione PSGetPropertyDescriptionListFromString per costruire un oggetto IPropertyDescriptionList da una stringa come "prop:Comments; Oggetto;".

Per altre informazioni sugli schemi delle proprietà, vedere Schemi delle proprietà.

IFileSaveDialog::SetCollectedProperties può essere chiamato in qualsiasi momento prima che venga visualizzata la finestra di dialogo o mentre è visibile. Se devono essere raccolte proprietà diverse a seconda del tipo di file scelto, IFileSaveDialog::SetCollectedProperties può essere chiamato in risposta a OnTypeChange.

Nota Per impostazione predefinita, nella finestra di dialogo di salvataggio non vengono raccolte proprietà.

 

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h

Vedi anche

IFileSaveDialog

IFileSaveDialog::SetProperties