Metodo IFileDialog::SetFolder (shobjidl_core.h)

Articolo
03/05/2024

Imposta una cartella sempre selezionata quando viene aperta la finestra di dialogo, indipendentemente dall'azione dell'utente precedente.

Sintassi

HRESULT SetFolder(
  [in] IShellItem *psi
);

Parametri

[in] psi

Tipo: IShellItem*

Puntatore all'interfaccia che rappresenta la cartella.

Valore restituito

Tipo: HRESULT

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

Commenti

Questa cartella esegue l'override di qualsiasi cartella "più recente usata". Se questo metodo viene chiamato mentre viene visualizzata la finestra di dialogo, la finestra di dialogo passa alla cartella specificata.

In generale, non è consigliabile usare questo metodo. Se si chiama SetFolder prima di visualizzare la finestra di dialogo, la posizione più recente in cui l'utente è stato salvato o aperto non viene visualizzato. A meno che non ci sia un motivo molto specifico per questo comportamento, non è un'esperienza utente valida o prevista e deve quindi essere evitata. In quasi tutte le istanze, IFileDialog::SetDefaultFolder è il metodo migliore.

A partire da Windows 7, se il percorso della cartella specificato tramite psi è il percorso predefinito di una cartella nota, il percorso corrente della cartella nota viene usato nella finestra di dialogo. Tale percorso potrebbe non essere uguale al percorso specificato in psi; ad esempio, se la cartella nota è stata reindirizzata. Se la cartella nota è una raccolta (cartelle virtuali Documenti, Musica, Immagini e Video), il percorso della libreria viene usato nella finestra di dialogo. Se la libreria specificata è nascosta (come per impostazione predefinita come Windows 8.1), il percorso di salvataggio predefinito della libreria viene usato nella finestra di dialogo, ad esempio la cartella Documenti di Microsoft OneDrive per la raccolta Documenti. A causa di questi mapping, il percorso della cartella usato nella finestra di dialogo potrebbe non essere esattamente come specificato quando si chiama questo metodo.

Requisiti

Requisito	Valore
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 (include Shobjidl.h)

Condividi tramite