1.2.5 AddFolderIcon – Anlegen eines Ordners für Programmsymbole
AddFolderIcon (strProgramFolder, strItemName, strCommandLine, strWorkingDir, strIconPath, nIcon, strShortCutKey, nFlag);
|
Argumente
|
strProgramFolder
Gibt den Namen des Ordners an, in dem Sie das Symbol hinzufügen möchten.
Um ein Symbol für eine Verknüpfung in das Startmenü von Windows einzufügen, übergeben Sie hier einen Null-String (““) als Parameter.
Sie können einen vollen Pfad eingeben, wie: "C:\\WINDOWS\\STARTMENU\\PROGRAMS\\ACCESSORIES\\GAMES
Sie können auch eine InstallShield Systemvariable benutzen:
| ||||||||
|
|
str$FOLDER_DESKTOP
Fügt das Symbol dem Desktop hinzu.
| ||||||||
|
|
str$FOLDER_STARTMENU
Fügt das Symbol dem Startmenü-Ordner hinzu.
| ||||||||
|
|
str$FOLDER_STARTUP
Fügt das Symbol dem Startmenü -Ordner hinzu.
| ||||||||
|
|
str$FOLDER_PROGRAMS
Fügt das Symbol dem Startmenü\Programmordner hinzu.
Oder Sie benutzen einen verwandten Pfad, wie:
FOLDER_STARTMENU ^ "ACCESSORIES\\GAMES"
Existiert der angegebene Ordner nicht, legt ihn InstallShield an.
| ||||||||
|
|
Ordner, die mit AddFolderIcon in 16-Bit Setups angelegt werden, werden nicht für die Deinstallation protokolliert.
In 16-Bit Setups, rufen Sie CreateProgramFolder auf. um den Ordner anzulegen, bevor Sie AddFolderIcon aufrufen.
Damit stellen Sie sicher, dass ein neu angelegter Ordner für die Deinstallation protokolliert wird.
| ||||||||
|
|
strItemName
Geben Sie den Namen des Symbols ein, das Sie dem Ordner oder Windows 95 Programmstarmenü hinzufügen.
Der Name erscheint unter dem Symbol. Unter Windows 95, erzeugt der Aufruf AddFolderIcon um ein Symbol hinzuzufügen sich eine Link-Datei im Verzeichnis Links spezifiziert von strCommandLine (unten).
Um Sonderzeichen, wie Kommata und Klammern in den Namen der Programmsymbole im Programm-Manager zu benutzen, setzen Sie das Namens-String zwischen zusätzlichen Anführungszeichen, wie im folgenden
Beispiel '"Add, Edit, or Delete (Line)"'
Unter Windows 95 und Windows NT 4.0 ist kein besonderes Format nötig. Beachten Sie jedoch, dass der Explorer folgende Zeichen in Elementennamen nicht unterstützt: /, \, :, ?, <, >, or |.
| ||||||||
|
|
strCommandLine
Geben Sie eines der folgenden ein:xxx
Der vollständige Name der Programmdatei im Zusammenhang mit dem Symbol, inklusive Befehlszeilen Parameter.
Siehe unten unter Anmerkungen für weitere Informationen. Um einen Shortcut unter dem Windows 95 Programmstartmenü hinzuzufügen, geben Sie die vollständige Pfadangabe des Link-Verzeichnis an.
Das Link-Verzeichnis ist das, in dem die Anwendung die Symbollinkdateien speichert.
Die vollständige Pfadangabe wenn strItemName ein Unterordner ist (nur Windows 95 und Windows NT 4.0).
| ||||||||
|
|
strWorkingDir
Gibt das Verzeichnis an, indem sich die Programmdateien Ihrer Anwendungen befinden.
(Trifft nicht zu, wenn strItemName ein Untermenü ist.) Wenn Sie ein Null-String eingeben (""), wird das Verzeichnis mit der Programmdatei das Arbeitsverzeichnis.
Siehe unter Anmerkungen für weitere Informationen.
| ||||||||
|
|
strIconPath
Gibt den Dateinamen für das Symbol an, das angezeigt werden soll.
(Trifft nicht zu, wenn strItemName ein Untermenü ist.)
Siehe Anmerkungen unten, für weitere Informationen.
| ||||||||
|
|
nIcon
Enter the icon ordinal in the Windows executable specified in strIconPath. (Trifft nicht zu, wenn strItemName ein Untermenü ist.) Symbolnumerierungen beginnen bei 0, um also das erste Symbol in der Programmdatei anzuzeigen, geben Sie 0 ein; für das zweite 1 usw.
Wenn sie kein Windows Symbol benutzen geben Sie 0 in diesen Parameter ein.
| ||||||||
|
|
strShortCutKey
Gibt den Shortcut (in Form eines String) an, der es ermöglicht,
Ihre Anwendung schnell zu starten.
Zum Beispiel Wenn Sie Ihre Anwendung mit "Ctrl," "Alt," und "1" starten möchten, geben Sie "Ctrl + Alt + 1" in diesem Parameter ein. (Trifft nicht zu, wenn strItemName ein Untermenü ist.)
| ||||||||
|
|
nFlag
Mit diesem Parameter spezifizieren Sie das Erscheinungsbild des Symbols.
Sie können Konstante kombinieren mit dem OR-Operator ( | ).
Übergeben
Sie hier eine der folgenden vorgegebenene Konstanten als Parameter:
| ||||||||
|
|
n$REPLACE
Zeigt an, dass das aktuelle Symbol oder Element im Ordner ersetzt wurde.
| ||||||||
|
|
n$RUN_MAXIMIZED
Zeigt an, dass das Programm beim Aufruf maximiert angezeigt werden soll.
Beachten Sie, dass das Symbol nicht angelegt wird, wenn Sie diese Konstante in einem Setup ansgegeben haben, dass im Programm-Manager ausgeführt wird.
Wenn das Setup AddFolderIcon aufruft und in nFlag diese Konstante als Parameter übergibt, dann rufen Sie zuerst QueryShellMgr auf, um die aktuelle Shell zu bestimmen:
Wenn der Programm-Manager die aktuelle Shell ist, dann weisen Sie nFlag eine der anderen Konstanten zu.
| ||||||||
|
|
n$RUN_MINIMIZED
Zeigt an, dass das Programm verkleinert werden soll, wenn es aufgerufen wird.
| ||||||||
|
|
n$RUN_SEPARATEMEMORY
Trifft nur bei 16-Bit Anwendungen unter Windows NT zu.
Überprüft das Kontrollkästchen "Run in Separate Memory Space" auf der Eigenschaftenseite des Symbols.
Dies weist das Betriebssystem an, dass die 16-Bit Anwendung ihren eigenen Speicher ausführen muss.
| ||||||||
|
Beschreibung
|
Die Funktion AddFolderIcon fügt oder ersetzt ein Symbol im Programmordner spezifiziert von strProgramFolder ein.
Existiert dieser Programmordner nicht, legt AddFolderIcon ihn an. strProgramFolder kann einen Unterordner in einem überlappenden Menü mit mehreren Ebenen spezifizieren.
Existiert der Ordner nicht, wird AddFolderIcon den Unterordner anlegen und, falls nötig, die übergeordneten Ordner.
Beim Hinzufügen von Symbolen zu Gruppen unter Windows NT, rufen Sie ProgDefGroupType zuerst auf, um die Gruppe als COMMON oder PERSONAL zu bestimmen.
Standardmäßig wird das Symbol unter COMMON hinzugefügt.
Aus der globalen Variable n$INFRAFolderGroup kann der Wert COMMON oder PERSONAL, der im infraSetup – IniFile unter dem gleichnamigen Schlüssel gesetzt wurde, entnommen werden.
Enthält der Pfad zu Ihrer Anwendungs-Programmdatei lange Pfadnamen, müssen sie den vollen Dateinamen in einfache oder Doppelanführungszeichen setzen. (Wurde dem Dateinamen eine Variable zugeordnet, übergeben Sie die Variable an LongPathToQuote zum Einfügen in Anführungszeichen.)
Beachten Sie, dass Befehlszeilenparameter nicht in Anführungszeichen gesetzt werden müssen.
Aus dem Grund ist es ratsam, den CommandLine String aus zwei Strings zu erzeugen.
Beachten Sie auch, dass wenn das Programm in strCommandLine eine 16-Bit Anwendung ist, jeder Pfad- oder Dateiname, der an das Programm übergeben wird in Kurzform sein muss.
Rufen Sie LongPathToShortPath auf, wenn nötig, um lange Dateinamen zu kurzen zu konvertieren.
|
|
Funktionsart
|
infraSetupFunktion
|