Méthode IFileDialogEvents ::OnFileOk (shobjidl_core.h)

Article
03/04/2024

Appelé juste avant que la boîte de dialogue soit sur le point de revenir avec un résultat.

Syntaxe

HRESULT OnFileOk(
  [in] IFileDialog *pfd
);

Paramètres

[in] pfd

Type : IFileDialog*

Pointeur vers l’interface qui représente la boîte de dialogue.

Valeur retournée

Type : HRESULT

Les implémentations doivent retourner S_OK d’accepter le résultat actuel dans la boîte de dialogue ou S_FALSE de le refuser. Dans le cas de S_FALSE, la boîte de dialogue doit rester ouverte.

Remarques

Lorsque cette méthode est appelée, les méthodes IFileDialog ::GetResult et GetResults peuvent être appelées .

L’application peut utiliser cette méthode de rappel pour effectuer une validation supplémentaire avant la fermeture du dialogue ou pour empêcher la fermeture du dialogue. Si l’application empêche la boîte de dialogue de se fermer, elle doit afficher une interface utilisateur pour indiquer une cause. Pour obtenir un HWND parent pour l’interface utilisateur, obtenez l’interface IOleWindow via IFileDialog ::QueryInterface et appelez IOleWindow ::GetWindow.

Une application peut également utiliser cette méthode pour effectuer tout son travail entourant l’ouverture ou l’enregistrement de fichiers.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)

Partager via