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