Functions > FileDirDisk >

FileInstall

Inclut/extrait un fichier embarqu� dans un script compil�.

FileInstall ( "source", "dest" [, flag = 0] )

Param�tres

source Le chemin et le nom du fichier � inclure � la compilation. Il doit �tre une cha�ne litt�rale et ne peut pas �tre une variable ou le r�sultat d'un appel de fonction. Il peut contenir un chemin relatif (en utilisant .\ ou ..\ dans le chemin) du fichier source (.au3).
dest Le chemin de destination du fichier termin� par antislash, si un r�pertoire seul est utilis�. Il peut �tre une variable.
flag [optionnel] Ce param�tre d�termine s'il faut �craser les fichiers existants:
    $FC_NOOVERWRITE (0) = (d�faut) n'�crase pas les fichiers existants
    $FC_OVERWRITE (1) = �crase les fichiers existants

Les constantes sont d�finies dans FileConstants.au3

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0.

Remarques

La fonction FileInstall() sert � inclure des fichiers dans un script AutoIt compil�. Ces fichiers peuvent ensuite �tre "extrait" au cours de l'ex�cution du script compil� si l'instruction est ex�cut�e. Gardez � l'esprit que des fichiers tel que des images peuvent consid�rablement augmenter la taille d'un script compil�.
Le fichier source doit �tre sp�cifi� en utilisant une cha�ne litt�rale et ne peut pas �tre une variable, une macro, un calcul, ou un appel de fonction. Le fichier doit pouvoir �tre trouv� lors de la compilation, alors que les variables, calculs et appels de fonction ne seront pas r�solus tant que le script lui-m�me ne sera pas ex�cut�, longtemps apr�s la compilation, les rendant inutilisable pour d�finir le fichier source.
La source ne peut pas contenir de wildcards (caract�res sp�ciaux).

La seule exception � ce qui pr�c�de est le cas o� le fichier source est dans @ScriptFullPath - vous pouvez alors inclure le script source.
Lorsque cette fonction est utilis�e � partir d'un script non compil�, une op�ration de copie est ex�cut�e (afin de faciliter les tests de pr�-compilation).
Les fichiers conservent leur date de cr�ation/modification originales lorsqu'ils sont install�s.

Le chemin du r�pertoire de destination doit d�j� exister avant d'appeler cette fonction, ou FileInstall() �chouera, en retournant 0 et sans cr�er le fichier, ni le chemin. Consultez DirCreate() pour plus d'informations sur la cr�ation du chemin de r�pertoire.

Les attributs d'un fichier existant peuvent emp�cher l'�crasement de celui-ci. Utilisez FileDelete() or FileSetAttrib() pour vous assurer que le fichier peut �tre install� sans probl�me.

En relation

DirCreate, FileDelete, FileSetAttrib

Exemple


Example()

func Example()

    FileInstall("c:\Program Files (x86)\autoIt3\Examples\HelpFile\Extras\compass.bmp", ".\")

    GUICreate("", 300, 300)
    GUICtrlCreatePic(".\compass.bmp", 0, 0, 300, 300)
    GUISetState()
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example

#cs
Ce code source est con�u pour �tre compil� avec l'image 'compass.bmp' en un fichier ex�cutable puis
'distribu�' c'est-�-dire ex�cut� dans un autre dossier ou sur un autre ordinateur.

-Le premier param�tre de FileInstall indique le nom complet de l'image sur votre disque
-Le second indique l'emplacement o� le fichier image sera extrait de l'ex�cutable sur
 le disque de l'utilisateur lors de la premi�re ex�cution.

Etape 1: compilation
  Copiez dans Scite, le code source ci-dessus, sauvegardez-le, puis
  allez dans "Outils > Compiler" et pr�cisez dans l'onglet "Res Add Files", bo�te d'�dition
  "Extra Files", que vous souhaitez compiler, avec le script, le fichier
  "c:\Program Files (x86)\autoIt3\Examples\HelpFile\Extras\compass.bmp"

  Cliquez sur le bouton "Compile Script" de l'onglet "AutoIt2/Aut2Exe"
  Le compilateur cr�e un ex�cutable.

Etape 2: distribution
D�placez cet ex�cutable sur un autre ordinateur ou un autre dossier et ex�cutez-le. L'instruction FileInstall extrait le fichier image dans un dossier qui doit exister et qui est donn� par le second param�tre de FileInstall, � savoir dans notre exemple,le dossier courant ".\" de l'ex�cutable.

Remarques:
 -Il faudra autant de ligne FileInstall que de fichiers � ajouter � l'ex�cutable.

 -Pour d�finir une ic�ne qui repr�sentera l'ex�cutable, il est inutile d'utiliser FileInstall(), indiquez directement le chemin et le nom de l'ic�ne dans l'onglet "AutoIt2/Aut2Exe" de la fen�tre
 du compilateur.
#ce