Método IFileSaveDialog::SetProperties (shobjidl_core.h)
Proporciona un almacén de propiedades que define los valores predeterminados que se van a usar para el elemento que se está guardando.
Sintaxis
HRESULT SetProperties(
[in] IPropertyStore *pStore
);
Parámetros
[in] pStore
Tipo: IPropertyStore*
Puntero a la interfaz que representa el almacén de propiedades que contiene los metadatos asociados.
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
Se puede llamar a este método en cualquier momento antes de que se abra el diálogo o mientras se muestra el diálogo. Si un elemento tiene propiedades inherentes, se debe llamar a este método con esas propiedades antes de mostrar el cuadro de diálogo.
Al usar Guardar como, la aplicación debe proporcionar las propiedades del elemento que se va a guardar en el cuadro de diálogo Guardar . Esas propiedades deben recuperarse del elemento original llamando a GetPropertyStore con la marca GPS_HANDLERPROPERTIESONLY .
Para recuperar las propiedades del elemento guardado (que puede haber sido modificado por el usuario) después de cerrar el cuadro de diálogo, llame a IFileSaveDialog::GetProperties.
Para activar la colección de propiedades e indicar qué propiedades deben mostrarse en el cuadro de diálogo Guardar , use IFileSaveDialog::SetCollectedProperties.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h |