Metodo IFileSaveDialog::SetProperties (shobjidl_core.h)

Fornisce un archivio delle proprietà che definisce i valori predefiniti da usare per l'elemento salvato.

Sintassi

HRESULT SetProperties(
  [in] IPropertyStore *pStore
);

Parametri

[in] pStore

Tipo: IPropertyStore*

Puntatore all'interfaccia che rappresenta l'archivio delle proprietà contenente i metadati associati.

Valore restituito

Tipo: HRESULT

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

Commenti

Questo metodo può essere chiamato in qualsiasi momento prima dell'apertura della finestra di dialogo o durante la visualizzazione della finestra di dialogo. Se un elemento ha proprietà intrinseche, questo metodo deve essere chiamato con queste proprietà prima di visualizzare la finestra di dialogo.

Quando si usa Salva con nome, l'applicazione deve fornire le proprietà dell'elemento salvato nella finestra di dialogo Salva . Tali proprietà devono essere retreived dall'elemento originale chiamando GetPropertyStore con il flag di GPS_HANDLERPROPERTIESONLY .

Per recuperare le proprietà dell'elemento salvato (che potrebbe essere stato modificato dall'utente) dopo la chiusura della finestra di dialogo, chiamare IFileSaveDialog::GetProperties.

Per attivare la raccolta delle proprietà e indicare quali proprietà devono essere visualizzate nella finestra di dialogo Salva , usare IFileSaveDialog::SetCollectedProperties.

Requisiti

Vedi anche

IFileSaveDialog

IFileSaveDialog::GetProperties

IFileSaveDialog::SetCollectedProperties