GetOpenFileName (Win32)


BOOL GetOpenFileName(lpofn)

LPOPENFILENAME lpofn;	/* adresse de la structure OPENFILENAME	*/




La fonction GetOpenFileName crée une boîte de dialogue un peu spéciale, celle-ci permet à 
l'utilisateur de choisir un fichier pour l'ouvrir. 



Paramètre   Description

lpofn 	    Pointe sur une structure OPENFILENAME, laquelle contient les informations qui 
	    servent à définir la boîte de dialogue. Après que la fonction GetOpenFileName 
	    retourne, cette structure contient en plus les informations sur le fichier 
	    choisit par l'utilisateur. (Comme le nom du fichier, son chemin…) 


Retours

La valeur de retour est TRUE si l'utilisateur choisit un fichier pour l'ouvrir. 
Par contre la valeur sera FALSE si une erreur s'est produite, si l'utilisateur choisit le 
bouton 'Annuler', si l'utilisateur choisit la commande 'Fermer' de la boîte de dialogue, ou 
bien si le Buffer identifié par le paramètre lpstrFile de la structure OPENFILENAME est trop 
petit pour contenir la chaîne de caractères qui indique le fichier choisi. 


Erreurs

Employez la fonction CommDlgExtendedError pour retrouver la valeur de l'erreur, qui peut être 
une des valeurs suivantes : 

CDERR_FINDRESFAILURE 
CDERR_INITIALIZATION 
CDERR_LOCKRESFAILURE 
CDERR_LOADRESFAILURE 
CDERR_LOADSTRFAILURE 
CDERR_MEMALLOCFAILURE 
CDERR_MEMLOCKFAILURE 
CDERR_NOHINSTANCE 
CDERR_NOHOOK 
CDERR_NOTEMPLATE 
CDERR_STRUCTSIZE 
FNERR_BUFFERTOOSMALL 
FNERR_INVALIDFILENAME 
FNERR_SUBCLASSFAILURE 


Commentaires

Si la fonction de Hook (sur laquelle pointe le membre lpfnHook de structure OPENFILENAME) 
traite le message WM_CTLCOLOR, cette fonction doit renvoyer le handle de la brosse qui doit 
être employée pour peindre le fond du Control (la DialogBox).

Retour