Functions > FileDirDisk >

FileCreateShortcut

Cr�e un raccourci (.lnk) vers un fichier.

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

Param�tres

file Chemin complet et nom du fichier sur lequel pointera le raccourci.
lnk Chemin complet et nom du raccourci.
workdir [optionnel] R�pertoire de travail.
args [optionnel] Arguments additionnels du fichier.
desc [optionnel] Description du fichier
icon [optionnel] Chemin complet et nom de l'ic�ne � utiliser.
hotkey [optionnel] Touche de raccourci - m�me format de touche que pour la fonction Send()
icon number [optionnel] Instance de l'ic�ne � utiliser (g�n�ralement 0).
state [optionnel] L'�tat dans lequel le raccourci est lanc�. Utilisez @SW_SHOWNORMAL, @SW_SHOWMINNOACTIVE ou @SW_SHOWMAXIMIZED

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 si le raccourci n'a pu �tre cr��.

Remarques

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 standards ainsi que les touches de ponctuation. FileCreateShortcut() vous autorise de 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.

FileCreateShortcut() ne n�cessite pas que la cible soit valide, le r�pertoire de travail, l'ic�ne, ou le raccourci clavier cr�e avec succ�s un fichier LNK; cependant, la destination du fichier LNK doit d'�tre valide! Si le raccourci clavier que vous choisissez existe d�j�, votre nouveau raccourci aura la priorit�. De plus, si vous cr�ez un raccourci avec le m�me chemin/nom qu'un raccourci pr�c�dent, ce dernier sera remplac� par votre nouvelle version.

En relation

FileCreateNTFSLink, FileGetShortcut

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Cr�e une constante locale avec le nom complet du fichier de raccourci.
    Local Const $sFilePath = @DesktopDir & "\FileCreateShortcutExample.lnk"

    ; Cr�e un raccourci sur le bureau pour explorer.exe et d�finit la combinaison de touches Ctrl+Alt+T ou dans AutoIt ^!t au raccourci.
    FileCreateShortcut(@WindowsDir & "\explorer.exe", $sFilePath, @WindowsDir, "/e,c:\", _
            "Description du raccourci.", @SystemDir & "\shell32.dll", "^!t", "15", @SW_SHOWMAXIMIZED)

    ; Obtient des caract�ristiques du raccourci.
    Local $aDetails = FileGetShortcut($sFilePath)
    If Not @error Then
        MsgBox($MB_SYSTEMMODAL, "", "Path: " & $aDetails[0] & @CRLF & _
                "R�pertoire de travail: " & $aDetails[1] & @CRLF & _
                "Arguments: " & $aDetails[2] & @CRLF & _
                "Description: " & $aDetails[3] & @CRLF & _
                "Nom de l'ic�ne: " & $aDetails[4] & @CRLF & _
                "Index de l'ic�ne: " & $aDetails[5] & @CRLF & _
                "Etat du raccourci: " & $aDetails[6] & @CRLF)
    EndIf

    ; Supprime le raccourci.
    FileDelete($sFilePath)
EndFunc   ;==>Example