IFileSaveDialog::SetProperties-Methode (shobjidl_core.h)
Bietet einen Eigenschaftenspeicher, der die Standardwerte definiert, die für das zu speichernde Element verwendet werden sollen.
Syntax
HRESULT SetProperties(
[in] IPropertyStore *pStore
);
Parameter
[in] pStore
Typ: IPropertyStore*
Zeiger auf die Schnittstelle, die den Eigenschaftenspeicher darstellt, der die zugeordneten Metadaten enthält.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Methode kann jederzeit aufgerufen werden, bevor das Dialogfeld geöffnet wird oder während der Dialog angezeigt wird. Wenn ein Element über inhärente Eigenschaften verfügt, sollte diese Methode mit diesen Eigenschaften aufgerufen werden, bevor das Dialogfeld angezeigt wird.
Wenn Sie Speichern unter verwenden, sollte die Anwendung die Eigenschaften des Elements angeben, das im Dialogfeld Speichern gespeichert wird. Diese Eigenschaften sollten durch Aufrufen von GetPropertyStore mit dem GPS_HANDLERPROPERTIESONLY-Flag aus dem ursprünglichen Element erneut entfernt werden.
Um die Eigenschaften des gespeicherten Elements abzurufen (die möglicherweise vom Benutzer geändert wurden), nachdem das Dialogfeld geschlossen wurde, rufen Sie IFileSaveDialog::GetProperties auf.
Verwenden Sie IFileSaveDialog::SetCollectedProperties, um die Eigenschaftensammlung zu aktivieren und anzugeben, welche Eigenschaften im Dialogfeld Speichern angezeigt werden sollen.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |