Funktionsreferenz

FileCreateShortcut

Erstellt eine Verknüpfung (*.lnk).

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

 

Parameter

file Vollständiger Pfad und Dateiname der Datei, auf die die Verknüpfung verweisen soll.
lnk Vollständiger Pfad und Dateiname der Verknüpfung.
workdir [optional] Arbeitsverzeichnis.
args [optional] Zusätzliche Dateiargumente.
desc [optional] Dateibeschreibung.
icon [optional] Vollständiger Pfad und Dateiname des zu verwendenden Icons.
hotkey [optional] Hotkey - im selben Format wie bei der Funktion "Send".
icon number [optional] Die Nummer des Icons (normalerweise 0).
state [optional] Der Status, in dem die Datei aufgerufen wird. Es ist entweder @SW_SHOWNORMAL, @SW_SHOWMINNOACTIVE oder @SW_SHOWMAXIMIZED zu verwenden.

 

Rückgabewert

Erfolg: Gibt 1 zurück.
Fehler: Gibt 0 zurück, wenn die .lnk-Datei nicht erstellt werden konnte.

 

Bemerkungen

Hotkeys für Windows-Verknüpfungen haben folgende Form: Strg + Alt + X, Strg + Shift + X, Shift + Alt + X, Strg + Ziffernblocktaste oder Alt + Ziffernblocktaste, wobei X einen Buchstaben, eine Zahl, Interpunktionszeichen oder eine Funktionstaste repräsentiert. Wenn eine ungültige Form verwendet wird, verwendet Windows typischerweise Strg + Alt.
Es ist zu beachten, dass Windows die Ziffernblockzahlen von den normalen Zahlen- und Interpunktionstasten unterscheidet.
FileCreateShortcut erlaubt es auch, Hotkeys in der Form Strg + X und Alt + X anzulegen, die Windows normalerweise nur zulässt, wenn X eine Ziffernblocktaste ist. Trotzdem sollte dies vermieden werden, da solche Zuweisungen Konflikte mit Shortcuts von Standardanwendungen hervorrufen können.
Windows verbietet ESC, ENTER, TAB, SPACEBAR (Leertaste), PRINT SCREEN (Drucken), SHIFT und BACKSPACE als Bestandteil von Hotkeys.

FileCreateShortcut benötigt kein gültiges Ziel, Arbeitsverzeichnis, Icon und keinen gültigen Hotkey, um die .lnk-Datei "erfolgreich" anzulegen. Der Ort der Verknüpfungsdatei muss aber gültig sein! Wenn der gewählte Hotkey schon verwendet wird, bekommt die neue Verknüpfung Vorrang. Ebenso überschreibt eine Verknüpfung mit dem selben Pfad und Namen, wie eine schon existierende, die alte Verknüpfung.

 

Verwandte Funktionen

FileGetShortcut, FileCreateNTFSLink

 

Beispiel


; Verknüpfung mit ctrl+alt+t als Tastenkombination
FileCreateShortcut(@WindowsDir & "\Explorer.exe",@DesktopDir & "\Shortcut Test.lnk",@WindowsDir,"/e,c:\", "Dies ist ein Explorerlink", @SystemDir & "\shell32.dll", "^!t", "15", @SW_MINIMIZE)