Aide:FileCreateShortcut.txt

Document original V3.3.6.1 :

###Function###
FileCreateShortcut

###Description###
Creates a shortcut (.lnk) to a file.

###Syntax###
FileCreateShortcut ( "file", "lnk" [, "workdir" [, "args" [, "desc" [, "icon" [, "hotkey" [, icon number [, state]]]]]]] )


###Parameters###
@@ParamTable@@
file
	Full path and file name of file to create shortcut to.
lnk
	Full path and file name of the shortcut.
workdir
	[optional] Working directory.
args
	[optional] Additional file arguments.
desc
	[optional] File Description.
icon
	[optional] Full Path/File name of icon to use.
hotkey
	[optional] Hotkey - same as the Send() key format.
icon number
	[optional] The icon instance to use (usually 0)
state
	[optional] The state the shortcut is launched in.  Use either @SW_SHOWNORMAL, @SW_SHOWMINNOACTIVE or @SW_SHOWMAXIMIZED
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0 if lnk cannot be created.
@@End@@


###Remarks###
Hotkeys for windows shortcuts are of the following form:  Ctrl+Alt+X, Ctrl+Shift+X, Shift+Alt+X, Ctrl+NumPadKey, or Alt+NumPadKey where X represents a letter, number, punctuation, or function key.  If you specify an invalid form, Windows typically defaults to Ctrl+Alt
Note that Windows distinguishes number pad keys from regular number and punctuation keys.  FileCreateShortcut allows you to create Ctrl+X and Alt+X shortcuts (which Windows normally only allows when X is a NumPadKey); however, you should avoid these assignments as they may conflict with standard application hotkeys.
Windows prohibits ESC, ENTER, TAB, SPACEBAR, PRINT SCREEN, SHIFT, or BACKSPACE from being used in hotkeys.  

FileCreateShortcut does not require a valid target, workdir, icon, or hotkey in order to "successfully" create the LNK file; however, the destination of the LNK file must be valid!  If the hotkey you choose is already in use, your new shortcut takes precedence.  Also, if you create a shortcut with the same path\name as as a pre-existing shortcut, it gets overwritten with your new version.


###Related###
FileGetShortcut, FileCreateNTFSLink


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
FileCreateShortcut

###Description###
Crée un raccourci (.lnk) vers un fichier.


###Syntax###
FileCreateShortcut ( "file", "lnk" [, "workdir" [, "args" [, "desc" [, "icon" [, "hotkey" [, icon number [, state]]]]]]] )


###Parameters###
@@ParamTable@@
file
	Nom et chemin complet du fichier sur lequel pointera le raccourci.
lnk
	Nom et chemin complet du raccourci.
workdir
	[optionnel] Répertoire de travail.
args
	[optionnel] Arguments additionnels du fichier.
desc
	[optionnel] Description du fichier
icon
	[optionnel] Nom et chemin complet de l'icône à utiliser.
hotkey
	[optionnel] Touche de raccourci - Syntaxe identique à la fonction Send()
icon number
	[optionnel] Instance de l'icône à utiliser (généralement 0).
state
	[optionnel] L'état dans lequel le programme est lancé.  Utilisez @SW_SHOWNORMAL, @SW_SHOWMINNOACTIVE ou @SW_SHOWMAXIMIZED
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne 1.
Échec:	Retourne 0 si le raccourci n'a pu être créé.
@@End@@


###Remarks###
Les raccourcis clavier sous Windows sont de la forme :  Ctrl+Alt+X, Ctrl+Shift+X, Shift+Alt+X, Ctrl+NumPadKey, ou Alt+NumPadKey où X représente une lettre, un nombre, une ponctuation, ou une touche de fonction. Si vous spécifiez une forme invalide, Windows utilisera Ctrl+Alt par défaut
Notez que Windows distingue les chiffres du pavé numérique des chiffres standard ainsi que les touches de ponctuation. FileCreateShortcut vous autorise à créer des raccourcis clavier Ctrl+X et Alt+X (alors que Windows n'autorise X que s'il est un chiffre du pavé numérique); Cependant, vous devriez éviter ce genre d'assignation, car il pourrait entrer en conflit avec des raccourcis clavier standards.
Windows interdit l'utilisation de ESC, ENTER, TAB, SPACEBAR, PRINT SCREEN, SHIFT, ou BACKSPACE dans les raccourcis clavier.

Pour créer le raccourci FileCreateShortcut ne nécessite pas que la cible, le répertoire de travail, l'icône, ou le raccourci clavier existe. Cependant, le chemin complet vers le raccourci doit d'être valide ! Si le raccourci clavier choisit existe déjà, votre nouveau raccourci aura la priorité. De plus, si vous créez un raccourci avec le même chemin complet qu'un raccourci précédent, ce dernier sera remplacé par votre nouvelle version.

###Related###
<a href="FileGetShortcut.htm">FileGetShortcut</a>, <a href="FileCreateNTFSLink.htm">FileCreateNTFSLink</a>


###Example###
@@IncludeExample@@

Traducteur : aurel2108

Contributeurs (pour les modifications avant le Wiki) : Tlem