1.2.143 OptionsButtons
OptionsButtons (szTitle, szMsg, listButtons, listBeschreibung, nOption)
|
Argumente
|
szTitle
Der Skriptdialogtitel.
szMsg
Die Meldung, die im Dialogfeld angezeigt werden soll.
ListButtons
Die Liste formatierter Strings, die Grafiken spezifiziert, die auf den
Schaltflächen angezeigt werden sollen.
Siehe Anmerkungen unten.
Die Einträge
der Liste müssen mit dem Trenner abgrenzt werden.
ListDescription
Die Listenstrings, die die Beschreibungen der entsprechenden Grafiken in der
Liste listButtons darstellen.
Die Einträge der Liste müssen mit dem Trenner abgrenzt werden.
Die Trenner werden im InfraSetup –Ini – File mit Hilfe des Schlüssels
INFRADelimiter gesetzt.
NOption, n$SETUPMETHOD
In dieser Variablen werden die Benutzeraktionen zurückgeliefert.
Bei nOptions steht der Wert direkt nach dem Aufruf zur Verfügung.
Bei der globalen Variablen steht der Wert ab nächsten Skriptteil zur Verfügung.
Beispiel. Der Aufruf der Funktion erfolgt in AtStart.cpp, so kann in Stype.cpp abgefragt werden, welche Setupmethode der Benutzer gewählt hat.
|
|
Rückgabewert:
|
Keine.
|
|
Beschreibung
|
Die Funktion OptionsButtons zeigt ein Dialogfeld an, das bis zu vier grafische Schaltflächen enthält, mit Begleittext, der für die Auswahlmöglichkeiten steht. OptionsButtons eignet sich gut um dem Endanwender die Wahl der Setupmethode zu ermöglichen.
Anmerkungen:
Die Schaltfläche "Weiter" ist gesperrt.
Die grafischen Schaltflächen im Dialog OptionsButtons werden erzeugt, indem eine Stringliste von Grafik IDs als Parameter in listButtons an OptionsButtons übergeben wurde. Jedes Element der Stringliste ist ein besonders formatierter String, der so aussieht:
"@<bitmap ID>;<bitmap icon flag>;<mask color>"
Das Symbol @ beginnt jeden Grafik-ID-String.
Die <Bitmap ID> ist die ID einer Grafikressource, die Sie in _isres.dll plaziert haben. Microsoft Visual C++ 5.0 ermöglicht die Modifizierung von Grafikressourcen in _isres.dll. Grafikressourcen-Nummern müssen größer als Null sein.
Wenn Sie Ihre Grafik-Ressourcen angeben, benutzen Sie nicht den Grafik-ID 1200, denn diese ist reserviert für die Benutzung durch InstallShield. InstallShield liefert vier Grafik-Ressourcen, 12001-12004, die im Beispiel unten eingesetzt wurden.
Die <bitmap icon flag> ist entweder 1 (TRUE) oder 0 (FALSE), und zeigt an, ob die Farbe, die im Feld <mask color> spezifiziert wurde transparent sein soll oder nicht. RGB 255, 0, 255 (lila) wird sehr häufig als Maskenfarbe benutzt.
Die optimale Größe für eine Grafik die in einer Optionsschaltfläche angezeigt wird ist 28 x 28 Pixel.
|
|
Funktionsart
|
InfraSetupFunktion
|
|
Beispiel
|
String( GrafikButtons, strTextToButtons );
AssignString( GrafikButtons, "@12001>;FALSE;255,0,255|" );
AppendString( GrafikButtons, "@12004;TRUE;255,125,255" );
AssignString( strTextToButtons, "Typisch\n Einfache Installation|" );
AppendString( strTextToButtons, "Experten\nErweiterte Installation" );
OptionsButtons( "Installationsmethode", "Bitte wählen Sie eine Installationsmethode", GrafikButtons, strTextToButtons, lOption );
|