IFileSaveDialog::SetCollectedProperties-Methode (shobjidl_core.h)

Gibt an, welche Eigenschaften im Dialogfeld "Speichern" erfasst werden.

Syntax

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

Parameter

[in] pList

Typ: IPropertyDescriptionList*

Zeiger auf die Schnittstelle, die die Liste der zu sammelnden Eigenschaften darstellt. Dieser Parameter kann NULL sein.

[in] fAppendDefault

Typ: BOOL

TRUE , um standardeigenschaften für den aktuell ausgewählten Dateityp zusätzlich zu den von pList angegebenen Eigenschaften anzuzeigen. FALSE , um nur von pList angegebene Eigenschaften anzuzeigen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die aufrufende Anwendung kann die PSGetPropertyDescriptionListFromString-Funktion verwenden, um eine IPropertyDescriptionList aus einer Zeichenfolge wie "prop:Comments; Betreff;".

Weitere Informationen zu Eigenschaftenschemas finden Sie unter Eigenschaftenschemas.

IFileSaveDialog::SetCollectedProperties kann jederzeit aufgerufen werden, bevor das Dialogfeld angezeigt wird oder solange es sichtbar ist. Wenn je nach ausgewähltem Dateityp verschiedene Eigenschaften erfasst werden sollen, kann IFileSaveDialog::SetCollectedProperties als Reaktion auf OnTypeChange aufgerufen werden.

Hinweis Standardmäßig werden im Dialogfeld "Speichern" keine Eigenschaften erfasst.

 

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h

Weitere Informationen

IFileSaveDialog

IFileSaveDialog::SetProperties