Cr�e une bo�te de dialogue qui permet � l'utilisateur de sp�cifier un lecteur, un r�pertoire et un nom d'un fichier � enregistrer
#include <WinAPIDlg.au3>
_WinAPI_SaveFileDlg ( [$sTitle = "" [, $sInitDir = "" [, $sFilters = "" [, $iDefaultFilter = 0 [, $sDefaultFilePath = "" [, $sDefaultExt = "" [, $iFlags = 0 [, $iFlagsEx = 0 [, $pOFNProc = 0 [, $pData = 0 [, $hParent = 0]]]]]]]]]]] )
| $sTitle | [optionnel] Une cha�ne � placer dans la barre de titre de la bo�te de dialogue. Si ce param�tre est la cha�ne vide (par d�faut), le syst�me utilise le titre par d�faut (c'est-�- dire "Save As"). |
| $sInitDir | [optionnel] Le r�pertoire initial. |
| $sFilters | [optionnel] Les paires de cha�nes de filtre (par exemple, "Text Files (*.txt)"). Pour sp�cifier plusieurs mod�les de filtres dans une seule cha�ne d'affichage, utilisez un point-virgule pour s�parer les mod�les (par exemple, "*.txt;*.doc;*.bak"). Ne pas inclure d'espaces dans les mod�les. Pour sp�cifier plusieurs groupes de filtres, utilisez le caract�re "|" comme s�parateur (par exemple, "Text Files (*.txt)|All Files (*.*)"). Si ce param�tre est omis ou la cha�ne vide (par d�faut), la bo�te de dialogue n'affiche pas les filtres |
| $iDefaultFilter | [optionnel] L'index, compt� � partir de 1, du filtre actuellement s�lectionn� pour initialiser le contr�le liste d�roulante. |
| $sDefaultFilePath | [optionnel] Le nom du fichier pour initialiser le contr�le d'�dition. |
| $sDefaultExt | [optionnel] L'extension par d�faut qui s'ajoute au nom de fichier si l'utilisateur ne tape pas une extension. Cette cha�ne peut �tre de n'importe quelle longueur, mais seuls les trois premiers caract�res sont ajout�s. La cha�ne ne doit pas contenir de point (.). Si ce param�tre est la cha�ne vide (par d�faut), aucune extension n'est ajout�e. |
| $iFlags | [optionnel] Un jeu de bits que vous pouvez utiliser pour initialiser la bo�te de dialogue. Ce param�tre peut �tre 0 ou une combinaison des valeurs suivantes: $OFN_ALLOWMULTISELECT $OFN_CREATEPROMPT $OFN_DONTADDTORECENT $OFN_ENABLEHOOK $OFN_ENABLEINCLUDENOTIFY $OFN_ENABLESIZING $OFN_EXPLORER $OFN_FORCESHOWHIDDEN $OFN_HIDEREADONLY $OFN_LONGNAMES $OFN_NOCHANGEDIR $OFN_NODEREFERENCELINKS $OFN_NOLONGNAMES $OFN_NONETWORKBUTTON $OFN_NOREADONLYRETURN $OFN_NOTESTFILECREATE $OFN_NOVALIDATE $OFN_OVERWRITEPROMPT $OFN_PATHMUSTEXIST $OFN_READONLY $OFN_SHAREAWARE $OFN_SHOWHELP |
| $iFlagsEx | [optionnel] Un jeu de bits que vous pouvez utiliser pour initialiser la bo�te de dialogue. Il peut �tre 0 ou la valeur suivante: $OFN_EX_NOPLACESBAR |
| $pOFNProc | [optionnel] Un pointeur sur une proc�dure hook. Ce param�tre est ignor� si le flag $OFN_ENABLEHOOK est activ�. |
| $pData | [optionnel] Pointeur sur les donn�es d�finies par l'application que le syst�me passe � la proc�dure hook. |
| $hParent | [optionnel] Le handle de la fen�tre parent de la bo�te de dialogue. |
| Succ�s: | Si le flag $OFN_ALLOWMULTISELECT n'est pas activ�, la fonction retourne le chemin complet du fichier d'entr�e, sinon toujours un tableau de chemins. L'�l�ment [0] du tableau indique le nombre de fichiers. |
| �chec: | D�finit @error <> 0, @extended contient le code d'erreur de bo�te de dialogue ($CDERR_* ou $FNERR_*). |
Les constantes sont d�finies dans WinAPIConstants.au3.
Appelez _WinAPI_GetExtended() pour obtenir la structure interne $tagOPENFILENAME contenant les informations de s�lection de l'utilisateur apr�s la fermeture de la bo�te de dialogue.
Si vous utilisez un hook, vous ne pouvez pas conserver l'interface utilisateur de la bo�te de dialogue comme dans Windows Vista ou une version ult�rieure.
Consultez GetSaveFileName dans la librairie MSDN.
#include <WinAPIDlg.au3> Local $sFile = _WinAPI_SaveFileDlg('', @WorkingDir, 'AutoIt v3 Scripts (*.au3)|All Files (*.*)', 1, 'MyScript.au3', '.', BitOR($OFN_PATHMUSTEXIST, $OFN_OVERWRITEPROMPT)) If Not @error Then ConsoleWrite($sFile & @CRLF) EndIf