Copyright: Dialog Editor Hilfe © 1994 Asymetrix Corp.


Inhaltsverzeichnis
Für weitere Hilfe setzen Sie sich mit dem Technischen Support von Asymetrix in Verbindung.

	Menübefehle Schrittweise Arbeitsverfahren TB30DLG.DLL-Referenz


Schrittweise Arbeitsverfahren
Die nachfolgenden Themen bieten schrittweise Anleitungen zum Arbeiten mit dem Dialog-Editor.

Aktivieren oder Deaktiverien von Steuerelementen (Schnellverfahren)

Aktivieren und Deaktivieren von Kontrollkästchen (Schnellverfahren)

Ändern eines Kontrollkästchens in ein Optionsfeld

Ändern eines Symbols oder einer Bitmap (Schnellverfahren)

Anpassen von Dialogfeld-Definitionen

Anzeigen eines Dialogfelds aus einem Buch heraus

Anzeigen eines Dialogfelds mit einem Menübefehl

Anzeigen eines interaktiven Dialogfelds -- dialogCallback()

Anzeigen eines statischen Dialogfelds -- dialog()

Anzeigen weiterer Optionen mit Schaltflächen

Ausrichten von Steuerelementen

Behandlungsroutinen für Dialogfelder

Behandlungsroutinen

Bestimmen der Benutzereingabe in ein interaktives Dialogfeld

Bestimmen der Benutzereingabe in ein statisches Dialogfeld

Dialog-Editor und Ansichtsobjekte: ein Vergleich

Dialogfeld-Steuerelemente

Die Schalterleiste des Dialog-Editors

Erstellen eines Ansichtsobjekts von der Dialogfeld-Definition

Erstellen eines Dialogfelds

Erstellen von mehreren Optionsfeldgruppen

Festlegen der Ausgangswerte

Festlegen der Eigenschaften eines Steuerelements

Festlegen der Größe des Dialogfelds

Festlegen der Tabulatorreihenfolge für Dialogfeld-Steuerelemente

Festlegen oder Abrufen der Auswahl in einem Kombinationsfeld (Schnellverfahren)

Festlegen oder Abrufen der Auswahl in einem Listenfeld (Schnellverfahren)

Festlegen oder Abrufen des Fokus (Schnellverfahren)

Festlegen oder Abrufen einer Schaltflächenbeschriftung (Schnellverfahren)

Gruppieren von Steuerelementen

Hinzufügen oder Löschen von Listenfeldelementen (Schnellverfahren)

Hinzufügen oder Löschen von von Kombinationsfeldelementen (Schnellverfahren)

Hinzufügen von statischem Text

Hinzufügen von veränderbarem Text

Installieren eines Dialogfelds in einem Buch

Öffnen einer Dialogfeld-Definition

Positionieren des Dialogfelds

Positionieren einer Bitmap

Positionieren eines Symbols

Ressource auswählen

Speichern einer Dialogfeld-Definition

Statische und interaktive Dialogfelder

Steuern des Standardverhaltens von Steuerelementen

TBKDialogCommand

TBKDialogDestroy

TBKDialogInit

Überprüfen der Eingabe in ein Dialogfeld

Verarbeiten der Esc- und Eingabetasten

Verarbeiten einer bestimmten Aktion

Verwenden der dialogCallback( )-Funktionen

Wie ToolBook Dialogfelder anzeigt

Wissenswertes über den Dialog-Editor

Zeichnen der Ausgangswerte in einem Dialogfeld

Zeichnen eines benutzerdefinierten Steuerelements

Zeichnen eines Gruppenfelds

Zeichnen eines Kombinationsfelds

Zeichnen eines Listenfelds

Zeichnen eines Steuerelements

Zeichnen von Kontrollkästchen

Zeichnen von Optionsfeldern

Zeichnen von Schaltflächen

Zuweisen einer Beschriftung


Menübefehle
Für Informationen zu einem Menü wählen Sie den Menünamen aus.

Datei

Bearbeiten

Steuerelement

Ansicht

Hilfe


Menübefehle
Für Informationen zu einem Menü wählen Sie den Menünamen aus.

Datei

Neu

Öffnen

Speichern

Speichern unter

Vorlage zum Buch zuweisen

Vorlage in Ansichtsobjekt umwandeln

Beenden (Alt+F4)

Bearbeiten

Steuerelement

Ansicht

Hilfe


Menübefehle
Für Informationen zu einem Menü wählen Sie den Menünamen aus.

Datei

Bearbeiten

Rückgängig

Ausschneiden

Kopieren

Einfügen

Löschen

Dialog-Inhalt löschen

Steuerelement

Ansicht

Hilfe


Menübefehle
Für Informationen zu einem Menü wählen Sie den Menünamen aus.

Datei

Bearbeiten

Steuerelement

Eigenschaften

Gruppieren

Steuerelemente ausrichten

Ansicht

Hilfe


Menübefehle
Für Informationen zu einem Menü wählen Sie den Menünamen aus.

Datei

Bearbeiten

Steuerelement

Ansicht

Dialogfeld prüfen

3D-Dialogfeld prüfen

Hilfe


Menübefehle
Für Informationen zu einem Menü wählen Sie den Menünamen aus.

Datei

Bearbeiten

Steuerelement

Ansicht

Hilfe

Schnelle Hilfe

Editor bearbeiten

Info über Dialog


TB30DLG.DLL-Funktionen
TB30DLG.DLL-Funktionsreferenz
Mit diesen Funktionen können Sie Dialogfelder im Windows-Stil anzeigen und die Werte für Dialogfeldoptionen abrufen und festlegen.

addComboBoxItem

addListBoxItem

chooseColorDlg

chooseDirectoryDlg

chooseFontDlg

colorPaletteDlg

controlIDToName

controlNameTohWnd

controlNameToID

deleteComboBoxItem

deletenComboBoxItem

deleteListBoxItem

deletenListBoxItem

dialog

dialogCallback

enableControl

endTBKDialog

enterWaitState

getControlText

getCustomColors

getDialogFocus

getFileListDlg

getFileListDlgFilterIndex

getListBoxItems

getListBoxSelection

getnListBoxSelection

getOpenFileDlgFilterIndex

getSaveAsDlgFilterIndex

getValue

isButtonChecked

isControlEnabled

leaveWaitState

listToTextline

openDlg

openFileDlg

saveAsDlg

setBitmapData

setButtonCheck

setComboBoxItems

setControlText

setCustomColors

setDialogFocus

setGroupedButtonCheck

setIconData

setListBoxItems

setListBoxSelection

setnListBoxSelection

setValue

sortList

sortTextlines

TBKDialogCommand

TBKDialogDestroy

TBKDialogInit

textlineToList


Informationen zum Technischen Support

Support per Telefon

Setzen Sie sich mit Asymetrix unter der unten aufgelisteten Telefonnummern für Informationen über Support-Verträge in Verbindung.

Australien/Ostpazifik	(61+3) 5255471
Europa (außer Frankreich und Deutschland), Naher Osten, Afrika, Russland	44-923-208-433
UK	0800-716-957 (gebührenfrei)
Frankreich	05-90-83-19 (gebührenfrei)
Deutschland	01-30-81-27-07 (gebührenfrei)
USA und der Rest der Welt	206-637-1600
Online-Dienste

Asymetrix bietet registrierten Benutzern gratis Support über Fax, den Asymetrix-Infoservice, CompuServe, America Online und das Internet. Unser Support-Personal beantwortet Ihre Online-Fragen innerhalb von 48 Stunden (montags bis freitags).

Technischer Support per Fax

Australien/Ostpazifik	(61+3) 5255-482

Europa	44-923-208-419

USA	206-454-0672

CompuServe

Windows Third Party Developer A-Forum, Abschnitt 1	go asymetrix oder go winapa

Multimedia Vendors-Forum, Abschnitt 15	go multiven

IBM Ultimedia Tools A-Forum, Abschnitt 5	go ultiatools

Internet

techsup@asymetrix.com

support@asymetrix.com


Info zum Dialog-Editor
Wissenswertes über Dialogfelder
Schritt für Schritt

Ein ToolBook-Buch kann zwei verschiedenen Arten von Dialogfeldern enthalten:

Ein ToolBook-Dialogfeld, d.h. eine Seite eines Buchs, die in einem Ansichtsobjekt angezeigt wird.

Ein Windows-Dialogfeld, das Sie mit dem Dialog-Editor erstellt und mit einem DLL-Aufruf angezeigt wird.

Diese zwei Dialogfeld-Arten weisen ein unterschiedliches Verhalten auf. Bevor Sie ein Dialogfeld erstellen und einsetzen, sollten Sie sich über die Vor- und Nachteile beider Arten informieren.

Der Dialog-Editor, eine ToolBook-Anwendung namens dialog.tbk, hat zwei Vorteile:

Er erleichtert Ihnen die Organisation der Steuerelemente in einem Dialogfeld.

Wenn das Dialogfeld das gewünschte Layout hat, wandelt er das Layout in Daten-Zeichenfolgen ( die als Vorlage bezeichnet werden), die Sie an die Windows-Dialog-DLL übergeben, wenn das Dialogfeld angezeigt werden soll. Außerdem erstellt der Dialog-Editor eine Behandlungsroutine, die Sie zum Aufrufen der DLL in Ihrer Anwendung verwenden können.

Siehe auch:

Erstellen eines Dialogfelds

Anzeigen eines Dialogfelds aus einem Buch heraus

Wie ToolBook Dialogfelder anzeigt

Installieren eines Dialogfelds in einem Buch


Wie ToolBook Dialogfelder anzeigt
Wie ToolBook Dialogfelder des Dialogfeld-Editors anzeigt
Schritt für Schritt

Dialogfelder, die mit dem Dialog-Editor erstellt werden, werden nicht als ToolBook-Objekte in der ToolBook-Anwendung gespeichert. Wenn die Anwendung ein Dialogfeld anzeigen soll, übergibt sie zwei Zeichenfolgen an eine DLL (Dynamic Link Library) mit dem Namen TB30DLG.DLL. Die eine Zeichenfolge (die sogenannte Vorlage) enthält Angaben über das Dialogfeld, z.B. seine Größe und Form, welche Steuerelemente es enthält und das Aussehen der Steuerelemente. Die andere Zeichenfolge enthält Ausgangswerte für die mit den Steuerelementen des Dialogfelds verbundenen Variablen. Die DLL verwendet die Daten, um das Dialogfeld "auf die Schnelle'" zu erstellen.

Wenn der Benutzer mit dem Dialogfeld fertig ist und es schließt, liefert die DLL eine Daten-Zeichenfolge mit den endgültigen Werten für die Steuerelemente enthält. Ihre Anwendung fragt die Werte aus dem Dialogfeld ab, um die Auswahlen und Eingaben des Benutzers zu ermitteln.

Siehe auch:

Erstellen eines Dialogfelds

Dialog boxes versus viewers

Anzeigen eines Dialogfelds aus einem Buch heraus

Installing the dialog box in your application


Windows-Dialogfelder und Ansichtsobjekte: ein Vergleich
Schritt für Schritt

Vorteile von Ansichtsobjekten zur Anzeige eines Dialogfelds:

Das Erstellen von Dialogfeldern mit Ansichtsobjekten ist allgemein schneller und einfacher als die Verwendung des Dialog-Editors.

In einem Ansichtsobjekt können Sie mehrere Schriftgrößen und Schriftarten für Text.

In einem Ansichtsobjekt können Sie Text-Funktionen wie Aktionswörter verwenden.

Objekte in einem Ansichtsobjekt können leichter angepaßt (z.B. die Schichtreihenfolge) und bearbeitet als Objekte in einem Windows-Dialogfeld.

 Ein Ansichtsobjekt ist in der .TBK-Datei Ihrer Anwendung enthalten, d.h. Sie brauchen TB30DLG.DLL nicht zusammen mit Ihrer Anwendung auszuliefern.

Windows-Dialogfelder können keine Dialogfeld-Menüs haben.

Vorteile von Windows-Dialogfeldern:

Die Dialogfelder entsprechend genau dem Windows-Standard in Bezug auf die Form der Schaltflächen.

Einige Steuerelemente, wie z.B. das "i"-Symbol, das oft mit Dialogfeldern verwendet wird, steht bei Ansichtsobjekten nicht ohne zusätzliche Arbeit zur Verfügung.

Dialogfelder verwenden automatisch dreidimensionale Steuerelemente, sofern Sie die Option ür Ihre Anwendung auswählen. Zum Einsetzen von dreidimensionalen Ansichtsobjekt-Steuerelementen in Ihrer Anwendung müssen Sie diese einzeln zeichnen; wenn Sie dann auf normale Steuerelemente wechseln wollen, müssen Sie diese wieder von neuem erstellen.

Wenn Sie mit der Verwendung des Dialog-Editors aus früheren Versionen vertraut sind, finden Sie es vielleicht leichter als das Erstellen von Erstellen von Ansichtsobjektenn.

Mit dem Dialog-Editor ist es leichter, Dialogfelder zu erstellen, die mit früheren ToolBook-Versionen konsistent sind.

Windows-Dialogfelder können weniger Speicherplatz in Ihrem Buch beanspruchen. (Sie müssen jedoch das Dialogwerkzeug TB30DLG.DLL zur Verfügung haben.)

Weitere Einzelheiten über Wissenswertes über Ansichtsobjekte finden Sie im ToolBook-Benutzerhandbuch.

Siehe auch:

Erstellen eines Dialogfelds

Anzeigen eines Dialogfelds aus einem Buch heraus

Installing the dialog box in your application


Erstellen eines Dialogfelds
Schritt für Schritt

So erstellen Sie ein Dialogfeld (allgemeines Verfahren):

1.	Öffnen Sie das Buch DIALOG.TBK.

Daraufhin erscheint das Arbeitsfenster des Dialog-Editors mit einem leeren n-Rahmen und der Hilfsmittelpalette.

2.	Wählen Sie ein Steuerelement aus der Hilfsmittelpalette und legen Sie es im Dialogfeld ab. Verwenden Sie die Standardverfahren zum Arbeiten auf Autorenebene, um das Steuerelement zu zeichnen, zu verschieben und zu positionieren.

3.	Öffnen Sie das Eigenschaften-Dialogfeld des Steuerelements und legen Sie seine Eigenschaften und Ausgangswerte fest.

4.	Wiederholen Sie Schritte 2 und 3 für weitere Steuerelemente.

5.	Wählen Sie aus dem Menü Ansicht den Befehl Dialogfeld prüfen, um das fertige Ergebnis im voraus zu prüfen.

6.	Wenn das Dialogfeld wie gewünscht aussieht, speichern Sie es in einer Datei.

7.	Weisen Sie das Dialogfeld einer Anwendung zu.

Die ToolBook-Hilfsmittelpalette wird im Dialog-Editor nie angezeigt; Sie können jedoch das Befehlsfenster auf gewohnte Weise einsetzen. Sie können auch das Skript-Fenster verwenden; allerkings werden die von Ihnen definierten Skripten nicht in das neue Dialogfeld aufgenommen.

Siehe auch:

Ausrichten von Steuerelementen

Zuweisen einer Beschriftung

Dialogfeld-Steuerelemente

Gruppieren von Steuerelementen

Zeichnen eines Steuerelements

Festlegen der Ausgangswerte für ein Steuerelement

Festlegen der Eigenschaften eines Steuerelements

Menübefehle

Positionieren des Dialogfelds

Prüfen des Dialogfelds im voraus

Speichern einer Dialogfeld-Definition

Festlegen der Eigenschaften des Dialogfeld-Rahmens

Festlegen der Tabulatorreihenfolge von Steuerelementen

Festlegen der Größe des Dialogfelds

Die Schalterleiste des Dialog-Editors


Dialogfeld-Steuerelemente

Es stehen 11 Steuerelemente zur Verwendung in einem Dialogfelder. Sieben davon sind ToolBook ToolBook Standard-Steuerelemente; vier davon sind spezielle Windows-Dialogfelder.

Die Steuerelemente werden durch Symbole in der Hilfsmittelpalette dargestellt. Das zwölfte Symbol ist für die Auswahl-Hilfsmittel.)

Wenn Sie weitere Einzelheiten zu den Merkmalen, Einsatzmöglichkeiten, Eigenschaften und Ausgangswerten eines Steuerelements klicken Sie auf das unten abgebildete Steuerelemten und wählen Sie die gewünschten Informationen aus.

Siehe auch:

Erstellen eines Dialogfelds

Dialog frame properties


Auswahl-Hilfsmittel

Verwenden Sie das Auswahlhilfsmittel, um Steuerelemente auszuwählen und ihre Größe und Position zu ändern.


Druckschalter

(ToolBook Standard-Steuerelement.)

Druckschalter werden normalerweise für die Schaltflächen "OK" und "Abbrechen" verwendet. OK-Schaltflächen werden verwendet, um Benutzerauswahlen aufzunehmen und das Dialogfeld zu schließen; Abbrechen-Schaltfläche schließen das Dialogfeld, ohne die Benutzereingaben zu akzeptieren. In einem interaktiven Dialogfeld werden Druckschalter auch zum Auslösen anderer Ereignisse verwendet, z.B. das Speichern einer Datei oder das Anzeigen weiterer Optionen.

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Zeichnen eines Druckschalters

Eigenschaften und Ausgangswerte von Druckschaltern


Optionsfeld

(ToolBook Standard-Steuerelement.)

Verwenden Sie ein Optionsfeld, wenn Sie wollen, daß der Benutzer ein einzelnes Element aus einer Gruppe von Optionen auswählen. Vergleichen Sie diese Aktion mit einem Kontrollkästchen, mit dem mehrere Elemente aus einer Gruppe ausgewählt werden können.

Beim Entwerfen des Dialogfeld können Sie zwar einen Ausgangswert von true für mehrere Optionsfelder festlegen, allerdings kann beim Öffnen des Dialogfelds in Ihrer Anwendung zu einem gegebenen Zeitpunkt nur ein Optionsfeld ausgewählt  (true) sein.

Hinweis: Alle Optionsfelder im Dialogfeld werden anfangs zusammen gruppiert und weisen Einzelauswahl-Verhalten auf. Zum Erstellen von mehreren Optionsfeldgruppen siehe Gruppieren von Steuerelementen.

Siehe auch:

Zeichnen eines Optionsfelds

Eigenschaften und Ausgangswerte von Optionsfeldern


Kontrollkästchen

(ToolBook Standard-Steuerelement.)

Verwenden Sie ein Kontrollkästchen , wenn Sie wollen, daß der Benutzer eine beliebige Anzahl von Elementen oder keine Elemente aus einer Optionsgruppe wähle. Vergleichen Sie diese Aktion mit dem Optionsfeld, das zum Auswählen von nur einem Element aus einer Gruppe mit mehreren Elementen verwendet wird.

Siehe auch:

Kontrollkästcheneigenschaften and initial values

Zeichnen eines Kontrollkästchen


Statischer Text

(ToolBook Standard-Steuerelement.)

Mit dem Statischen Text-Hilfsmittel können Sie Text, z.B. Beschriftungen oder Anweisungen, an beliebiger Position im Dialogfeld anlegen. Der Text wird in einem Rechteck beliebiger Größe mit oder Rahmen angezeigt. Der Text kann vom Benutzer nicht verändert werden.

Siehe auch:

Hinzufügen von statischem Text

Eigenschaften und Ausgangswerte von statischem Text


Veränderbarer Text

(ToolBook Standard-Steuerelement.)

Verwenden Sie das Veränderbarer Text-Hilfsmittel, um Text an beliebiger Stelle im Dialogfeld abzulegen und Benutzern einen Eingabebereich für längere Eingaben bereitzustellen. Der Text kann durch den Benutzer verändert werden. Der Text wird in einem Rechteck beliebiger Größe mit oder ohne Bildlaufleisten angezeigt, und kann in einer einzelnen Zeile oder in mehreren Zeilen angezeigt werden. Der Zeilenumbruch kann ein oder ausgeschaltet werden, der eingegebene Text kann als Sternchen (z.B. bei Kennwörtern) angezeigt werden und die Bentuzereingaben können auf ganze Zahlen eingeschränkt werden.

Siehe auch:

Hinzufügen von veränderbarem Text

Editable text Eigenschaften und Ausgangswerte von


Listenfeld

(ToolBook Standard-Steuerelement.)

Verwenden Sie ein Listenfeld, um dem Benutzer eine Liste von Optionen zur Verfügung zu stellen. Der Benutzer kann dann eine oder mehrere Optionen auswählen. Benutzer können ihre eigenen Einträge nicht eingeben. Vergleichen Sie diese Aktion mit einem Kombinationsfeld.

Sie können das Auswahlverhalten auf Einzelauswahl, Mehrfachauswahl oder Auswahlerweiterung festlegen und die Liste automatisch sortieren lassen. Wenn die Liste länger als das Feld ist, kann der Bildlauf durchgeführt werden.

Siehe auch:

Zeichnen eines Listenfelds

Eigenschaften und Ausgangswerte von Listenfeldern


Kombinationsfeld

(ToolBook Standard-Steuerelement.)

Mit dem Kombinationsfeld können dem Benutzer eine Liste von Optionen bereitstellen. Das Kombinationsfeld erscheint als Auswahlfeld mit einem einzelnen Element und einem Pfeil am rechten Rand. Der Benutzer kann den Wert im Feld akzeptieren oder einen Wert eingeben, der mit den Elementen im Dropdown-Listenfeld verglichen wird. Der Benutzer kann auch auf den Pfeil klicken, um eine Liste mit weiteren Auswahlmöglichkeiten aufzuklappen. Vergleichen Sie diese Aktion mit einem Listenfeld.

Sie können die Lisste automatisch sortieren und Bildlaufleisten im Listenfeld anzeigen lassen.

Siehe auch:

Eigenschaften und Ausgangswerte von Kombinationsfeldern

Zeichnen eines Kombinationsfelds


Anwender-Steuerelement

(Windows Dialogfeld-Steuerelement.)

Ein Anwender-Steuerelement (custom control) kann ein beliebiges Windows-Steuerelement (einschließlich der Standard-Steuerelemente in der Hilfsmittelpalette) sein. Zum Beispiel ist die Symbolleiste in Word für Windows ein Anwender-Steuerelement. Anwender-Steuerelemente werden in C oder einer anderen Sprache geschrieben und in die ausführbare Datei oder eine DLL kompiliert. Das The Bitmap-Steuerelement in der Hilfsmittelpalette ist ein Anwender-Steuerelement, das in TB30DLG.DLL integriert wurde.

Vor der Anzeige eines Anwender-Steuerelements muß seine Klasse mit Windows registriert werden.

Weitere Einzelheiten über das Erstellen und Verwenden von Anwender-Steuerelementen finden Sie in der Dokumentation zum Windows SDK.

Siehe auch:

Anwender-Steuerelement Eigenschaften und Ausgangswerte von

Zeichnen eines benutzerdefinierten Steuerelements


Gruppenfeld

(Windows Dialogfeld-Steuerelement.)

Ein Gruppenfeld dient lediglich zum Zwecke der visuellen Gestaltung; es hat keine eigene Steuerfunktion. Sie können Steuerelemente in einem Gruppenfeld, um den Benutzer darauf hinzuweisen, daß die Steuerelemente miteinander zusammenhängen. Das Verwenden eines Gruppenfelds ist nicht mit dem Gruppieren von Steuerelementen zu verwechseln.

Siehe auch:

Zeichnen eines Gruppenfelds

Eigenschaften von Gruppenfeldern


Bitmap

(Windows Dialogfeld-Steuerelement.)

Das Bitmap-Steuerelement wird verwendet, um eine Bitmap in das Dialogfeld aufzunehmen. Die Bitmap hat keine eigene Steuerungsfunktion.

Um eine Bitmap im Dialogfeld anzeigen zu können, muß diese zuerst als Ressource im Buch vorhanden sein, in dem das Dialogfeld verwendet wird. Sie können ein Bitmap-Steuerelement zu einem Dialogfeld zuweisen, ohne ihm auch eine Bitmap zuzuweisen, aber beim Öffnen des Dialogfelds in einer Anwendung erscheint nichts.

Der Dialog-Editor zeigt eine Bitmap nicht genauso an, wie sie in der Anwendung angezeigt wird. Die Bitmap wird bei Anzeige des Dialogfelds in der Anwendung innerhalb des Begrenzungsfelds des Steuerelements zentriert angezeigt. Wenn das Begrenzungsfeld größer als die Bitmap ist, wird diese zugeschnitten; ist sie größer, so erscheint ein Leerbereich zwischen dem Rand der Bitmap und dem Begrenzungsfeld. Mit dem Befehl Dialogfeld prüfen im Menü Ansicht können Sie sehen, wie die Bitmap in der Anwendung angezeigt wird.

Wenn Sie die Größe der Bitmap anpassen wollen, tun Sie dies in einem Grafikprogramm und speichern Sie die Bitmap in der Größe, in der sie angezeigt werden soll.

Siehe auch:

Bitmap-Eigenschaften

Positionieren einer Bitmap


Symbol

(Windows Dialogfeld-Steuerelement.)

Das Symbol-Steuerelement wird verwendet, um ein Symbol wie das bekannte eingekreiste "i"-Symbol im Dialogfeld ab. Das Symbol hat keine Steuerfunktion.

Um ein Symbol im Dialogfeld anzeigen zu können, muß es  zuerst als Ressource im Buch vorhanden sein, in dem das Dialogfeld verwendet wird. Sie können ein Symbol-Steuerelement zu einem Dialogfeld zuweisen, ohne eine bestimmte Ressource anzugeben, allerdings wird beim Öffnen des Dialogfelds in einer Anwendung nichts erscheinen.

Siehe auch:

Symboleigenschaften

Positionieren eines Symbols


Die Schalterleiste des Dialog-Editors

Klicken Sie auf eine Schaltfläche, um weitere Informationen zu erhalten.

Siehe auch:

Erstellen eines Dialogfelds

Dialogfeld-Steuerelemente

Menübefehle


Zeichnen eines Steuerelements
Schritt für Schritt

Verwenden Sie die Standardverfahren zum Arbeiten auf Autorenebene, um das Steuerelement zu zeichnen, zu verschieben und zu positionieren.

So zeichnen Sie ein Steuerelement:

1.	Wählen Sie das Steuerelement aus der Hilfsmittelpalette.

Beim Bewegen des Cursors über dem Editor-Fenster ändert er sich in ein Fadenkreuz.

2.	Klicken Sie auf die Stelle im Dialogfeld, an der die obere linke Ecke des Steuerelements stehen soll. Halten Sie die linke Maustasten gedrückt, während Sie den Cursor nach unten und rechts ziehen.

Der Cursor dehnt sich beim Ziehen aus.

3.	Wenn das Steuerelement die gewünschte Größe hat, lassen Sie die Maustasten los.

Siehe auch:

Erstellen eines Dialogfelds

Prüfen des Dialogfelds im voraus


Festlegen der Größe des Dialogfelds
Schritt für Schritt

Zum Ändern der Größe des Dialogfelds halten Sie die STRG-TASTE gedrückt, während Sie an den Seiten oder den Ecken des Felds ziehen.

Siehe auch:

Erstellen eines Dialogfelds

Prüfen des Dialogfelds im voraus


Ausrichten von Steuerelementen
Schritt für Schritt

So richten Sie Steuerelemente aus:

1.	Wählen Sie die Steuerelemente aus, die ausgerichtet werden sollen.

2.	Wählen Sie aus dem Menü Steuerelement den Befehl Steuerelement ausrichten.

3.	Wählen Sie einen der folgenden Befehle:

Links. Richtet die linken Seiten aller Steuerelemente mit der linken Seite des Steuerelements aus, das am weitesten links steht.

Oben. Richtet die oberen Ränder aller Steuerelemente mit dem oberen Rand des obersten Steuerelements aus.

Rechts. Richtet die rechten Seiten aller Steuerelemente mit der rechten Seite des am weitesten rechts stehenden Steuerelements.

Unten. Richtet die unteren Ränder aller Steuerelemente mit dem unteren Rand des untersten Steuerelements aus.

Siehe auch:

Erstellen eines Dialogfelds

Dialogfeld-Steuerelemente

Menübefehle

Prüfen des Dialogfelds im voraus


Festlegen der Tabulatorreihenfolge von Steuerelementen
Schritt für Schritt

Die Tabulatorreihenfolge ist die Reihenfolge, in der Steuerelemente den Fokus erhalten, wenn der Benutzer die TABULATORTASTE drückt, Die Tabulatorreihenfolge wird über die Schichtnummern der Steuerelemente gesteuert; der Fokus springt der Reihe nach von der niedrigsten Schichtnummer zur höchsten. Zum Anpassen der Tabulatorreihenfolge ändern Sie die Schichtnummern im Eigenschaften-Dialogfeld der jeweiligen Steuerelemente.

Siehe auch:

Festlegen der Ausgangswerte für ein Steuerelement

Festlegen der Eigenschaften eines Steuerelements

Prüfen des Dialogfelds im voraus


Festlegen der Eigenschaften eines Steuerelements
Schritt für Schritt

So legen Sie die Eigenschaften eines Steuerelements fest:

1.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

2.	Geben Sie die erforderlichen Informationen und treffen Sie die nötigen Auswahlen im Dialogfeld. Wenn Sie fertig sind, klicken Sie auf "OK".

Jeder Steuerelementtyp hat ein eigenes Eigenschaften-Dialogfeld. Wenn Sie weitere Informationen zu einem bestimmten Steuerelement erhalten wollen, klicken Sie auf den gewünschten Steuerelementnamen in der nachfolgenden Tabelle.

Druckschalter

Optionsfeld

Kontrollkästchen

Statischer Text

Veränderbarer Text

Listenfeld

Kombinationsfeld

Gruppenfeld

Symbol

Bitmap

Anwender-Steuerelement

Siehe auch:

Erstellen eines Dialogfelds

Dialogfeld-Steuerelemente


Festlegen der Ausgangswerte für ein Steuerelement
Schritt für Schritt

So legen Sie die Ausgangswerte für ein Steuerelement fest:

1.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

2.	Geben Sie die erforderlichen Informationen und treffen Sie die nötigen Auswahlen im Dialogfeld. Wenn Sie fertig sind, klicken Sie auf "OK".

Hinweis: Mit den Funktionen in TB30DLG.DLL können Sie veranlassen, daß die Anwendung andere Werte im Dialogfeld anzeigt als die Ausgangswert, die Sie im Eigenschaften-Dialogfeld festgelegt haben.

Jeder Steuerelementtyp hat ein eigenes Eigenschaften-Dialogfeld. Wenn Sie weitere Informationen zu einem bestimmten Steuerelement erhalten wollen, klicken Sie auf den gewünschten Steuerelementnamen in der nachfolgenden Tabelle.

Druckschalter

Optionsfeld

Kontrollkästchen

Statischer Text

Veränderbarer Text

Listenfeld

Kombinationsfeld

Anwender-Steuerelement

Siehe auch:

Erstellen eines Dialogfelds

Dialogfeld-Steuerelemente

Anzeigen eines Dialogfelds aus einem Buch heraus


Speichern einer Dialogfeld-Definition
Schritt für Schritt

Die Dialogfeld-Definition wird als Textdatei mit der Erweiterung .DIA gespeichert. Nachdem Sie die Datei gespeichert haben, können Sie sie jedem beliebigen Buch oder Büchern zuweisen. Sie könne die Datei auch zum Archivieren und Ändern des Dialogfelds im Dialog-Editor verwenden.

So speichern Sie eine Dialogfeld-Definition in einer Textdatei:

1.	Wählen Sie aus dem Menü Datei im Dialog-Editor den Befehl Speichern unter.

Daraufhin erscheint das Dialogfeld Speichern unter.

2.	Geben Sie einen Dateinamen ein und wählen Sie das Verzeichnis zum Speichern der Datei aus. Klicken Sie anschließend auf "OK".

Wenn Sie keinen Dateinamen angeben, fügt ToolBook die Erweiterung .DIA automatisch hinzu und speichert die Dialogfeld-Definition in einer Textdatei.

Die .DIA-Textdatei besteht aus den Werten aus der Dialogfeld-Vorlage, gefolgt von einem einzelnen Steuerzeichen und den Ausgangswerten der Steuerelemente.

Hinweis: Sie brauchen die Definiton nicht in einer Textdatei zu speichern, bevor Sie das Dialogfeld einem Buch zuweisen.

Siehe auch:

Erstellen eines Dialogfelds

Anzeigen eines Dialogfelds aus einem Buch heraus

Installieren eines Dialogfelds in einem Buch


Öffnen eines Dialogfelds im Dialog-Editor
Schritt für Schritt

Sie können ein vorhandenes Dialogfeld im Dialog-Editor anzeigen, indem Sie die .DIA-Datei mit dessen Definition öffnen, oder Sie können ein Dialogfeld öffnen, das einem Buch zugewiesen ist.

So öffnen Sie die .DIA-Datei eines Dialogfelds:

1.	Wählen Sie aus dem Menü Datei den Befehl Öffnen.

Daraufhin erscheint das Dialogfeld Öffnen.

2.	Wählen Sie im Feld "Dateiformat" die Option "Dialog-Vorlage" aus ( [image].DIA).

3.	Wählen Sie im Feld "Verzeichnisse" das Verzeichnis aus, in dem sich die zu öffnende Datei befindet.

4.	Wählen Sie die Datei aus dem Feld "Dateien" und klicken Sie dann auf "OK".

Wenn der Dialogfeld-Rahmen im Dialog-Editor nicht leer ist, werden Sie mit einer Meldung gefragt, ob Sie den Rahmen löschen wollen. Wenn Sie "Nein" wählen, werden die neuen Steuerelemente zu den vorhandenen hinzugefügt.

So öffnen Sie ein Dialogfeld, das einem Buch zugewiesen ist:

1.	Wählen Sie aus dem Menü Datei den Befehl Öffnen.

Daraufhin erscheint das Dialogfeld Öffnen.

2.	Wählen Sie im Feld "Dateiformat" die Option "ToolBook-Buch ( [image].TBK).

3.	Wählen Sie im Feld "Verzeichnisse" das Verzeichnis aus, in dem sich das gewünschte Buch befindet.

4.	Wählen Sie die Buchdatei aus dem Feld "Dateien" und klicken Sie dann auf "OPK".

Daraufhin erscheint das Dialogfeld Dialogfeld-Vorlage laden.

5.	Wählen Sie in Dialogfeld Dialogfelder im Buch den Namen des zu öffnenden Dialogfelds und klicken Sie dann auf "OK".

Wenn der Dialogfeld-Rahmen im Dialog-Editor nicht leer ist, werden Sie mit einer Meldung gefragt, ob Sie den Rahmen löschen wollen. Wenn Sie "Nein" wählen, werden die neuen Steuerelemente zu den bereits vorhandenen hinzugefügt.

Siehe auch:

Zuweisen eines Dialogfelds zu einem Buch

Erstellen eines Dialogfelds

Anzeigen eines Dialogfelds aus einem Buch heraus

Speichern einer Dialogfeld-Definition


Zeichnen von Druckschaltern
Schritt für Schritt

So zeichnen Sie einen Druckschalter:

1.	Wählen Sie aus der Hilfsmittelpalette das Druckschalter-Steuerelement.

2.	Zeichnen Sie den Druckschalter unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5. 	Wiederholen Sie diese Schritte, um weitere Druckschalter im Dialogfeld zu zeichnen.

Siehe auch:

Erstellen eines Dialogfelds


Schaltflächeneigenschaften
Eigenschaften und Ausgangswerte von Druckschaltern

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Zeichnen von Optionsfeldern
Schritt für Schritt

So zeichnen Sie ein Optionsfeld:

1.	Wählen Sie aus der Hilfsmittelpalette das Optionsfeld-Steuerelement.

2.	Zeichnen Sie das Optionsfeld unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5. 	Wiederholen Sie diese Schritte, um weitereOptionsfelder im Dialogfeld zu erstellen.

Alle Optionsfelder in einem Optionsfelder weisen standardmäßig Einzelauswahl-Verhalten auf, d.h. es kann zu einem gegebenen Zeitpunkt nur ein Optionsfeld ausgewählt sein. Wenn Sie mehrere Optionsfelder gleichzeitig auswählen wollen, können Sie die Optionsfelder in Gruppen organisieren.

Siehe auch:

Erstellen eines Dialogfelds


Eigenschaften und Ausgangswerte von Optionsfeldern

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Ändern eines Optionsfelds in ein Kontrollkästchen

Erstellen eines Dialogfelds


Erstellen von mehreren Optionsfeldgruppen
Schritt für Schritt

Optionsfelder in einem Dialogfeld werden standardmäßig als Teil einer einzelnen Gruppe behandelt, ohne Rücksicht auf die Position. Deshalb kann nur ein Optionsfeld zu einem gegebenen Zeitpunkt ausgewählt sein.

Sie können den Befehl Gruppieren im Menü Steuerelement verwenden, um Optionsfelder zu gruppieren. So kann nur ein Schalter/Schaltfläche in der Gruppe ausgewählt sein..

Weitere Einzelheiten über das Gruppieren von Steuerelementen finden Sie unter Gruppieren von Steuerelementen und im ToolBook-Benutzerhandbuch.

Hinweis: Durch Gruppieren mehrerer Optionsfelder werden diese nicht funktionell gruppiert, sondern gibt nur einen visuellen Hinweis, daß die Optionsfelder zusammenhängen.

Siehe auch:

Erstellen eines Dialogfelds


Gruppieren von Steuerelementen
Schritt für Schritt

Alle Optionsfelder in einem Dialogfeld weisen standardmäßig Einzelauswahl-Verhalten auf; es kann nur ein Optionsfeld zu einem gegebenen Zeitpunkt ausgewählt sein. Wenn Sie mehrere Optionsfelder gleichzeitig auswählen wollen, können Sie sie in Gruppen organisieren. (Beim Gruppieren einer Reihe von Optionsfeldern funktionieren alle anderen Optionsfeldern im Dialogfeld so, als ob sie Teil einer anderen Gruppe wären).

So gruppieren Sie Optionsfelder:

1.	Wählen Sie die Optionsfelder, die in die Gruppe aufgenommen werden sollen.

2.	Wählen Sie aus dem Menü Steuerelement den Befehl Gruppieren.

Die Begrenzungsfelder um die einzelnen Optionsfelder werden durch ein einzelnes Begrenzungsfeld, das alle Optionsfelder in der Gruppe einschließt.

Hinweis:  Das Gruppenfeld-Steuerelement führt die Gruppieren-Funktion nicht durch, sonder zeichnet nur einen Rahmen um die ausgewählten Steuerelemente als visuellen Hinweis, daß sie miteinander zusammenhängen.

Siehe auch:

Erstellen eines Dialogfelds


Ändern eines Kontrollkästchens in ein Optionsfeld
Ändern eines Optionsfelds in ein Kontrollkästchen
Schritt für Schritt

Zum Ändern eines Kontrollkästchens in ein Optionsfeld oder umgekehrt ändern Sie dessen Stileigenschaft. Weitere Informationen finden Sie unter Optionsfeldeigenschaften or Kontrollkästcheneigenschaften.

Siehe auch:

Erstellen eines Dialogfelds

Zeichnen von Kontrollkästchen

Zeichnen von Optionsfeldern


Zeichnen von Kontrollkästchen
Schritt für Schritt

So zeichnen Sie ein Kontrollkästchen:

1.	Wählen Sie aus der Hilfsmittelpalette das Kontrollkästchen-Steuerelement.

2.	Zeichnen Sie das Kontrollkästchen unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest.. Wenn Sie fertig sind, klicken Sie auf "OK".

5. 	Wiederholen Sie diese Schritte, um weitere Kontrollkästchen  im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Kontrollkästcheneigenschaften
Eigenschaften und Ausgangswerte von Kontrollkästchen

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen..

Siehe auch:

Ändern eines Kontrollkästchens in ein Optionsfeld

Erstellen eines Dialogfelds


Hinzufügen von statischem Text
Schritt für Schritt

So fügen Sie statischen Text hinzu:

1.	Wählen Sie aus der Hilfsmittelpalette das Statische Text-Steuerelement.

2.	Zeichnen Sie das statische Text-Steuerelement unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5.	Nachdem Sie den Text fur das Feld eingegeben haben, müssen Sie evtl. seine Größe und Form anpassen.

6. 	Wiederholen Sie diese Schritte, um weitere statische Text-Steuerelemente im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Statische Text-Eigenschaften
Eigenschaften von statischem Text und Ausgangswerte

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Hinzufügen von veränderbarem Text
Schritt für Schritt

So fügen Sie veränderbaren Text hinzu:

1.	Wählen Sie aus der Hilfsmittelpalette das veränderbare Text-Steuerelement.

2.	Zeichnen Sie das veränderbare Text-Steuerelement unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5.	Nachdem Sie den Text fur das Feld eingegeben haben, müssen Sie evtl. seine Größe und Form anpassen.

6. 	Wiederholen Sie diese Schritte, um weitere veränderbare Text-Steuerelemente im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Veränderbare Text-Eigenschaften
Eigenschaften und Ausgangswerte von veränderbarem Text

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Zeichnen eines Listenfelds
Schritt für Schritt

So zeichnen Sie ein Listenfeld:

1.	Wählen Sie aus der Hilfsmittelpalette das Listenfeld-Steuerelement.

2.	Zeichnen Sie das Listenfeld unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5.	Nachdem Sie den Text fur das Feld eingegeben haben, müssen Sie evtl. seine Größe und Form anpassen.

6. 	Wiederholen Sie diese Schritte, um weitere Listenfeld-Steuerelemente im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Listenfeldeigenschaften
Eigenschaften und Ausgangswerte von Listenfeldern

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Zeichnen eines Kombinationsfelds
Schritt für Schritt

So zeichnen Sie ein Kombinationsfeld:

1.	Wählen Sie aus der Hilfsmittelpalette das Kombinationsfeld-Steuerelement.

2.	Zeichnen Sie das Kombinationsfeld unter Verwendung von ToolBooks Standard-Zeichenverfahren..

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5.	Nachdem Sie den Text für das Kombinationsfeld eingegeben haben, müssen Sie sein Größe und Form evtl. anpassen.

6. 	Wiederholen Sie diese Schritte, um weitere Kombinationsfeld-Steuerelemente im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Kombinationsfeldeigenschaften
Eigenschaften und Ausgangswerte von Kombinationsfeldern

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Zeichnen eines Anwender-Steuerelements
Schritt für Schritt

So zeichnen Sie ein Anwender-Steuerelement:

1.	Wählen Sie aus der Hilfsmittelpalette das Anwender-Steuerelement.

2.	Zeichnen Sie das Anwender-Steuerelement unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften und Ausgangswerte des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5.	Wiederholen Sie diese Schritte, um weitere Anwender-Steuerelemente im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Anwender-Steuerelement-Eigenschaften
Eigenschaften und Ausgangswerte von Anwender-Steuerelementen

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

.

Siehe auch:

Erstellen eines Dialogfelds


Zeichnen eines Gruppenfelds
Schritt für Schritt

So zeichnen Sie ein Gruppenfeld:

1.	Wählen Sie aus der Hilfsmittelpalette das Gruppenfeld-Steuerelement.

2.	Zeichnen Sie das Gruppenfeld-Steuerelement unter Verwendung von ToolBooks Standard-Zeichenverfahren.

Das Gruppenfeld wird beim Bewegen des Cursors größer. Das Gruppenfeld ist nicht durchsichtig und verdeckt die dahinter befindlichen Steuerelemente.

3.	Um die Steuerelemente hinter dem Gruppenfeld sichtbar zu machen, verwenden Sie den Schalter fur Ganz nach hinten in der Schalterleiste.

4.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

5.	Legen Sie die Eigenschaften des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

6.	Wiederholen Sie diese Schritte, um weitere Gruppenfeld-Steuerelements im Dialogfeld zu erstellen.

Hinweis: Durch Gruppieren mehrerer Optionsfelder werden diese nicht funktionell gruppiert, sondern gibt nur einen visuellen Hinweis, daß die Optionsfelder zusammenhängen. Weitere Informationen finden Sie unter Gruppieren von Steuerelementen.

Siehe auch:

Erstellen eines Dialogfelds


Gruppenfeldeigenschaften
Group box properties

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Positionieren einer Bitmap
Schritt für Schritt

So positionieren Sie eine Bitmap:

1.	Wählen Sie aus der Hilfsmittelpalette das Bitmap-Steuerelement.

2.	Zeichnen Sie das Bitmap-Steuerelement unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5.	Wiederholen Sie diese Schritte, um weitere Bitmap-Steuerelement im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Bitmap-Eigenschaften

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Positionieren eines Symbols
Schritt für Schritt

So positionieren Sie ein Symbol:

1.	Wählen Sie aus der Hilfsmittelpalette das Symbol-Steuerelement.

2.	Zeichnen Sie das Symbol-Steuerelement unter Verwendung von ToolBooks Standard-Zeichenverfahren.

3.	Doppelklicken Sie mit der linken Maustaste auf das Steuerelement.

Das Eigenschaften-Dialogfeld des Steuerelements erscheint.

4.	Legen Sie die Eigenschaften des Steuerelements fest. Wenn Sie fertig sind, klicken Sie auf "OK".

5.	Wiederholen Sie diese Schritte, um weitere Symbol-Steuerelemente im Dialogfeld zu erstellen.

Siehe auch:

Erstellen eines Dialogfelds


Symboleigenschaften

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Dialograhmen-Eigenschaften

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.

Siehe auch:

Erstellen eines Dialogfelds


Schaltfläche "OK"

Klicken Sie auf diese Schaltfläche, um die Änderungen zu akzeptieren und das Eigenschaften-Dialogfeld zu schließen.


Feld für Symbolname

Der Name der Symbolressource im Buch, in dem das Dialogfeld verwendet wird.


Standardwert

Optionsfelder und Kontrollkästchen  können Standardwerte von true oder false haben. Bei true ist das Optionsfeld bzw. Kontrollkästchen bei Anzeige des Dialogfelds aktiviert bzw. abgehakt; bei false, hat das Optionsfeld bzw. Kontrollkästchen bei Anzeige keine Auswahl.

Sie können true als Standardwert für mehrere Optionsfelder festlegen, aber beim Öffnen des Dialogfeld weist nur eines davon den Wert true auf.


Kombinationfeldelemente

Die Elemente, die im Dropdown-Menü erscheinen. Wenn Sie ein kaufmännisches Et-Zeichen vor ein Element setzen, erscheint es im Feld, wenn das Dialogfeld geöffnet wird. Andernfalls erscheint das Feld leer.


Schichtnummer

Schichtnummern steuern die Tabulatorreihenfolge zwischen mehreren Steuerelementen (das Steuerelement mit der niedrigsten Nummer ist das erste). Sie bestimmt außerdem, welches Steuerelement sichtbar ist, wenn sich zwei Steuerelemente überlappen (das Steuerelement mit der höchsten Zahl verdeckt das andere). Schichtnummer werden automatisch entsprechend der Reihenfolge zugewiesen, in der die Steuerelemente im Dialogfeld angelegt wurden. Sie können sie ändern, um die Tabulatorreihenfolge und das Aussehen anzupassen.


Schalter für Ganz nach vorne

Klicken Sie auf diese Schaltfläche, um das ausgewählte Steuerelement auf die vorderste Schicht zu verschieben. Dies entspricht das Festlegen der Schichtnummer des Steuerelements auf die höchste Schichtnummer aller Objekte im Dialogfeld. Wenn das Steuerelement andere Steuerelemente überlagert, werden diese verdeckt.


Mehrzeilig

Aktivieren Sie dieses Kontrollkästchen, wenn der Text zwischen den Rändern des Textfelds auf die nächste Zeile umbrochen werden soll. Falls dieses Kontrollkästchen nicht aktiviert ist, erscheint der Text auf einer einzelnen Zeile, gleichgültig, wie breit das Feld ist. Text, der über den rechten Rand hinausgeht, wird abgeschnitten.


vertikaler Auto-Bildlauf

Aktivieren Sie dieses Kontrollkästchen, um Bildlauf automatisch im Feld durchführen zu lassen, wenn der Benutzer den Cursor über den unteren Feldrand hinauszieht. Diese Funktion funktioniert nur, wenn Mehrzeilig ausgewählt ist.


Ganz nach hinten

Verschiebt das ausgewählte Steuerelement auf die hinterste Schicht. Dies entspricht dem Festlegen seiner Schichtnummer auf den niedrigsten Wert aller Objekte im Dialogfeld. Wenn das Steuerelement andere Steuerelemente überlagert, werden diese verdeckt.


Bitmap

Die Bitmap, die im Dialogfeld angezeigt werden soll.


Symbol

Das Symbol, das im Dialogfeld angezeigt werden soll.


Datei speichern

Speichert die aktuelle Dialogfeld-Vorlage als Textdatei. Falls die Vorlage noch nicht gespeichert wurde, erscheint ein Dialogfeld, in dem Sie die Datei benennen können.


Schaltflächenstil

Wählen Sie Kontrollkästchen  oder Optionsfeld aus. Optionsfelder in derselben Gruppe weisen Einzelauswahl-Verhalten auf (nur ein Optionsfeld kann zu einem gegebenen Zeitpunkt ausgewählt sein. Kontrollkästchen weisen normales Auswahlverhalten auf.


Datei öffnen

Öffnet das Dialogfeld Öffnen, mit dem Sie ein Verzeichnis und eine Datei zum Öffnen auswählen können.


Ausrichtung

Hier wählen Sie, wie der Text im Feld ausgerichtet wird:

Links. Am linken Rand ausgerichtet, rechts unregelmäßig

Rechts. LinksbündigAm linkenEven on the right and ragged on the left

Mitte. Symmetric about the center of the box, ragged on the left and right


Kein Zeilenumbruch

Wählen Sie dieses Kontrollkästchen, um zu verhindern, daß Wörter automatisch auf die nächste Zeile umbruchen werden. Um die Zeile zu umbrechen, müssen Sie ein Wagenrücklaufzeichen eingeben.


Duplizieren

Legt eine Kopie des ausgewählten Steuerelements im Dialogfeld ab.


Kennwort

Wenn Sie dieses Kontrollkästchen aktivieren, werden nur  [image] s erscheinen, wenn der Benutzer eine Eingabe im Feld tätigt. Diese Funktion wird meistens nur dann verwendet, wenn der Benutzer ein Kennwort eingeben muß, damit das Kennwort selbst nicht auf dem Bildschirm erscheint.


Rückgängig/Wiederherstellen

Wählen Sie dieses Element, um die zuletzt durchgeführte Aktion rückgängig zu machen. Wählen Sie es erneut, um die Aktion wiederherzustellen.


Dropdown-Länge

Die Anzahl der Zeilen, die erscheint, wenn die Liste aufgeklappt wird. Nur ganze Zeilen werden angezeigt.


Bitmap-Name

Der Name der Bitmap-Ressource im Buch, in dem das Dialogfeld verwendet wird. Nachdem Sie eine Ressource ausgewählt haben, müssen Sie ihr einen Namen zuweisen oder den bereits vorhandenen Namen verwenden.


Optionen

Aktivieren Sie die Kontrollkästchen  fur die gewünschten Optionen:

Elemente sortieren. Sortiert die Elemente in der Liste.

Bildlaufleiste. Zeigt eine vertikale Bildlaufleiste am rechten Rand der Liste an.

Veränderbar. Ermöglicht dem Benutzer, einen neuen Wert einzugeben oder den vorhandenen Wert im Feld zu bearbeiten. Bei der Eingabe wird der Bildlauf automatisch zur nächsten Zeite durchgeführt, die mit dem eingegebenen Text übereinstimmt.


Symbol auswählen

Klicken Sie auf diese Schaltfläche, um das Dialogfeld Ressource auswählen zu öffnen, mit dem Sie das Symbol auswählen können ,das Sie im Dialogfeld verwenden wollen.


Steuerelement-Klasse

Die Windows-Klasse des Steuerelements.


Zeichenformat

Öffnet das Dialogfeld Zeichen, mit dem Sie Schritart, Schriftgröße und andere Attribute auswählen können.


Elemente sortieren

Aktivieren Sie dieses Kontrollkästchen, um die Elemente im Listenfeld in aufsteigender Reihenfolge sortieren zu lassen.


Rahmen

Aktivieren Sie dieses Kontrollkästchen, um einen Rahmen um das Textfeld hinzuzufügen.


Name

Ein Name, den Sie dem Steuerelement zur Verwendung in Skripten und Behandlungsroutinen zuweisen können. Optional.


Stil

Die Art der Auswahl, die vom Benutzer getroffen werden kann.

Einfach. Nur ein Element kann ausgewählt sein.

Mehrfach. Der Benutzer kann mehrere Elemente auswählen. Die Auswahlen müssen nicht unbedingt direkt nebeneinanderstehen.

Erweitern. Der Benutzer kann ein Element auswählen und den Cursor dann nach oben oder nach unten ziehen, um benachbarte Elemente auszuwählen. Alternativ kann der Benutzer auf ein Element, dann auf ein anderes klicken, um die angeklickten Elemente und alle dazwischenstehenden Elemente auszuwählen.


Eigenschaften öffnen

Öffnt das Eigenschaften-Dialogfeld des ausgewählten Steuerelements. Dies entspricht dem Doppelklicken auf das Steuerelement.


Statischer Text

Geben oder fügen Sie den Text ein, der auf dem Dialogfeld erscheinen soll. Sie können bis zu 32.000 Zeichen eingeben.

Tip: Drücken Sie die EINGABETASTE nicht, wenn Sie an den rechten Feldrand gelangen; sonst wird der Text beim Ändern der Felddimensionen nicht mehr automatisch angepaßt.


Listenfeldelemente

Die Elemente, die dem Benutzer zur Auswahl stehen.


Vertikale Bildlaufleiste

Aktivieren Sie dieses Kontrollkästchen, um eine vertikale Bildlaufleiste am rechten Textfeldrand hinzuzufügen. Die Bildlaufleiste wird hinzugefügt, auch wenn der Text breiter als das Feld ist. Die Bildlaufleiste erscheint nicht, während Sie das Dialogfeld entwerfen, wird jedoch in der Prüfansicht angezeigt. Sie befindet sich innerhalb des Rahmens des Textfelds.


Steuerelement-Stil

Der Windows-Steuerelement-Stil; muß ein Dezimalwert sein. Weitere Einzelheiten hierzu finden Sie in der Dokumentation zum Windows SDK.


Steuerelement-Text

Text, der im Steuerelement angegeben werden muß, z.B. eine Beschriftung auf einer Schaltfläche.


Abbrechen

Wählen Sie diese Schaltfläche, um die Änderungen abzubrechen und das Eigenschaften-Dialogfeld zu schließen.


Nur ganze Zahl

Aktivieren Sie dieses Kontrollkästchen, um die Eingabe von Zeichen zu unterbinden, die keine ganze Zahlen sind. Sie können weiterhin alphabetische Zeichen für den Anfangstext eingeben; dem Benutzer kann dies jedoch nicht.


Prüfansicht

Zeigt eine Beispiel , wie das Dialogfeld in der Anwendung aussehen wird. Sie können normale oder #D-Gestaltung auswählen.


 Ausgangstext

Geben Sie den Text, der erscheinen soll, wenn das Dialogfeld angezeigt wird. Optional. Dieser Text kann vom Benutzer bearbeitet werden. Sie können bis zu 32.000 Zeichen eingeben.

Tip: Drücken Sie nicht die EINGABETASTE, wenn Sie am rechten Feldrand gelangen; sonst wird der Text beim Ändern der Dimensionen nicht automatisch angepaßt.


Horizontale Bildlaufleiste

Aktivieren Sie dieses Kontrollkästchen, um eine horizontale  Bildlaufleiste am rechten Textfeldrand hinzuzufügen. Die Bildlaufleiste wird hinzugefügt, auch wenn der Text breiter als das Feld ist. Die Bildlaufleiste erscheint nicht, während Sie das Dialogfeld entwerfen, wird jedoch in der Prüfansicht angezeigt. Sie befindet sich innerhalb des Rahmens des Textfelds.

Check this box to have a horizontal scroll bar added to the bottom of the text box. The scroll bar is added regardless of whether the text is wider than the box. Die Bildlaufleiste erscheint nicht, während Sie das Dialogfeld entwerfen, wird jedoch in der Prüfansicht angezeigt. Sie befindet sich innerhalb des Rahmens des Textfelds.

Wenn Sie "Kein Zeilenumbruch" auswählen, benötigen Sie auch eine horiztonale Bildlaufleiste, ansonsten verschwindet der Text hinter der rechten Seite des Textfelds.


Schaltflächen-Aktion

 Die Aktion, die stattfindet, wenn die Schaltfläche ausgewählt wird. Änderungen am Dialogfeld werde übernommen und das Dialogfeld wird geschlossen; oder die Änderungen werden abgebrochen und das Dialogfeld wird geschlossen.

Dies ist die eingebaute Funktionsweise des Druckschalters. Soll die Schaltfläche ein anderes Verhalten aufweisen, verwenden Sie die Callback-Funktion. Siehe hierzu Anzeigen eines Dialogfelds aus einem Buch heraus.


Standard-Druckschalter

Wenn dieses Feld ausgewählt ist, wird die Schaltfläche beim Drücken der EINGABETASTE aktiviert. Dieses Kontrollkästchen kann zu einem gegebenen Zeitpunkt nur für eine Schaltfläche aktiviert werden.


Steuerelement-Kennummer

Die Kennummer, die automatisch zugewiesen wird. Sie können auf die Kennummer das Steuerelement in Behandlungsroutinen und Skripten verweisen.

Steht nur für Druckschalter zur Verfügung. Bei Auswahl von ID_OK im Kombinationsfeld "Steuerelementkennummer" wird die Schaltfläche aktiviert, sobald der Benutzer die EINGABETASTE drückt.; wird ID_CANCEL ausgewählt, so wird die Schaltfläche aktiviert, wenn der Benutzer die ESC-TASTE drückt.


Beschriftung

Eine Beschriftung, die auf der Schaltfläche erscheint. Optional.

Wenn Sie ein kaufmännisches Et-Zeichen vor einen Buchstaben in der Beschriftung eingeben, erscheint dieser Buchstabe auf der Schaltfläche unterstrichen, und die Schaltfläche kann deaktivert werden, indem man die ALT-TASTE drückt und den Buchstaben eingibt.


Beschriftung

Eine Beschriftung, die am oberen Rand des Felds erscheint. Optional.


Bitmap auswählen

Klicken Sie auf diese Schaltfläche, um das Dialogfeld Ressource auswählen anzuzeigen, mit dem Sie die Bitmap zur Verwendung im Dialogfeld auswählen können.


Choose resource
Ressource auswählen

Klicken Sie auf ein Feld oder eine Schaltfläche, um weitere Informationen anzuzeigen.


Position

Die Position des Dialogfelds relativ zur oberen linken Ecke seines übergeordneten Objekts. Falls diese Position wegen der Position des übergeordneten Objekts nicht möglich ist, wird es auf dem Bildschirm so nah wie möglich angezeigt.


Größe

Die Größe des Begrenzungsfelds des Steuerelements, gemessen in Windows-Dialogeinheiten.


X-Position

Die horiztonale Position der oberen linken Ecke des Dialogfelds relativ zur oberen linken Ecke des Fensters. Die Position wird in Windows-Dialogeinheiten gemessen.


Y-Position

Die vertikale Position der oberen linken Ecke des Dialogfelds relativ zur oberen linken Ecke des Fensters. Die Position wird in Windows-Dialogeinheiten gemessen.


Beispiel-Behandlungsroutine

Die show<Name>-Behandlungsroutine verknüpft mit den Funktionen in TB30DLG.DLL, legt die Ausgangswerte für das Dialogfeld fest und zeigt dieses an.

to handle showDepartim

--linkDLL-Anweisung in enterBook-Behandlungsroutine verschieben

linkDLL "TB30DLG.dll"

string dialog(string, string)

string setValue(string, string, string)

string getValue(string, string)

end

set init to DepartimInit of this book

--set init to setValue(init,"","") --DLL-Funktion

set retValue to dialog(DepartimBOX of this book, init)

--get getValue(retValue, "") --DLL-Funktion

end

Weitere Einzelheiten hierzu finden Sie unter Anzeigen eines Dialogfelds aus einem Buch heraus.


Prüfen des Dialogfelds im voraus

Wählen Sie aus dem Menü Ansicht den Befehl Dialogfeld prüfen. Sie können eine normale oder eine #D-Gestaltung auswählen.


Assigning a caption
Zuweisen einer Beschriftung
Schritt für Schritt

So weisen Sie einem Dialogfeld eine Beschriftung zu:

1.	Klicken Sie auf die Titelleiste des Dialogfelds, um den Dialogfeld-Rahmen auszuwählen.

2.	Öffnen Sie das Eigenschaften-Dialogfeld für den Dialogfeldrahmen.

3.	Geben Sie die Beschriftung in das Feld "Beschriftung" ein..

4.	Klicken Sie auf "OK"..


Positioning the dialog box
Positionieren des Dialogfelds
Schritt für Schritt

So positionieren Sie das Dialogfeld:

1.	Klicken Sie auf die Titelleiste des Dialogfelds, um den Dialogfeld-Rahmen auszuwählen.

2.	Öffnen Sie das Eigenschaften-Dialogfeld für den Dialogfeldrahmen.

3.	Geben Sie dei X-Position und die Y-Position in die jeweiligen Felder ein.

4.	Klicken Sie auf "OK".


Windows-Dialogeinheit

Eine horizontale Windows-Dialogeinheit entspricht einen Viertl der Breite eines Zeichens mit der im Dialogfeld verwendeten Schriftart und Größe. Ein vertikales Window-Dialogeinheit entspricht einem Achtel der Höhe eines Zeichens.

Hinweis: Das äquivalente Maß in Zoll oder Zentimeter hängt vom verwendeten Anzeigegerät ab.


Neu

Öffnet einen neuen, leeren Dialogfeld-Rahmen. Falls ein Dialogfeld bereits geöffnet ist, wird es geschlossen. Vergessen Sie nicht, zu speichern, bevor Sie ein neuen Dialogfeld öffnen.


Öffnen

Öffnet das Dialogfeld Öffnen, mit dem Sie eine Datei zum Öffnen auswählen können.


Speichern

Speichert das Dialogfeld als .DIA-Datei. Wenn das Dialogfeld leer ist, steht dieser Befehl nicht zur Verfügung.

Falls das Dialogfeld noch nicht gespeichert wurde, erscheint das Dialogfeld Speichern, damit Sie der Datei einen Namen zuweisen können.


Speichern unter

Öffnet das Dialogfeld Speichern unter, damit Sie der Datei einen vollständigen Namen zuweisen und sie als .DIA-Datei speichern können.

Wenn das Dialogfeld leer ist, steht dieser Befehl nicht zur Verfügung.


Vorlage zum Buch zuweisen

Öffnet das Dialogfeld Zielbuch fur Dialog-Vorlage, mit dem Sie das Buch auswählen, dem die Vorlage zugewiesen werden soll. Nachdem Sie das Buch ausgewählt und auf "OK" geklickt haben, werden Sie zur Angabe eines Namens für das Dialogfeld aufgefordert. Dann erscheint eine Meldung, die das Zuweisen der Vorlage zum Buch bestätigt, Ihnen den Namen der Behandlungsroutine mitteilt und Anweisungen zur Anzeige des Dialogfelds im Buch anzeigt.


Vorlage und Ansichtsobjekt umwandeln

Ermöglicht Ihnen, ein mit dem Dialog-Editor erstelltes Dialogfeld in eine ToolBook-Seite und entsprechendes Ansichtsobjekt umzuwandeln, damit das Dialogfeld angezeigt werden kann.


Beenden

Schließt den Dialog-Editor. Falls Sie die Änderungen am aktuellen Dialogfeld noch nicht gespeichert haben, werden Sie hierzu aufgefordert.


Rückgängig/Wiederherstellen

Wählen Sie diesen Befehl unmittelbar nach einer Aktion, um diese rückgäng zu machen. Nachdem Sie eine Aktion rückgängig gemacht haben, ändert sich der Befehlsname in Wiederherstellen. Wählen Sie unmittelbar den Befehl Wiederherstellen, um die letzte Aktion wiederherzustellen.

Einige Aktionen (z.B. das Zeichnen eines Steuerelements) können nicht rückgängig gemacht werden. Bei solchen Aktionen ändert sich der Befehlsname in Rückgängig nicht möglich.


Ausschneiden

Entfernt das ausgewählte Objekt aus dem Dialogfeld und legt es in der Zwischenablage ab. Das Objekt kann in dasselbe oder in ein anderes Dialogfeld eingefügt werden.


Kopieren

Legt eine Kopie des ausgewählten Objekts in der Zwischenablage ab und läßt das Orignal unverändert. Die Kopie kann in dasselbe oder in ein anderes Dialogfeld eingefügt werden.


Einfügen

Fügt den Inhalt der Zwischenablage in das geöffnete ein. Wenn Sie ein Steuerelement auswählen, den Befehl Kopieren und anschließend den Befehl Einfügen wählen, wird das neue Steuerelement direkt über dem Original eingefügt.


Löschen

Entfernt das ausgewählte Steuerelement aus dem Dialogfeld. Das Steuerelement wird nicht in die Zwischenablage übertragen und kann nicht wiederhergestellt werden, außer mit dem Befehl Rückgängig.


Dialogfeld-Inhalt löschen

Entfernt alle Steuerelemente aus dem Dialogfeld und stellt das Dialogfeld auf die Standardgröße wiederher.


Eigenschaften

Öffnt das Eigenschaften-Dialogfeld des ausgewählten Steuerelements.


Gruppieren

Schließt die ausgewählten Optionsfelder in eine Gruppe ein. Die Steuerelemente in der Gruppe weisen Einzelauswahl-Verhalten auf, d.h. es kann nur Optionsfeld zu einem gegebenen Zeitpunkt ausgewählt sein.

Wenn Sie ein Steuerelement wählen, das sich bereits in einer Gruppe befindet, ändert sich der Befehlsname in Gruppe auflösen. Durch Wählen von Gruppe auflösen werden alle Steuerelemente aus der Gruppe entfernt.


Steuerelemente ausrichten

Richtet die ausgewählten Steuerelemente miteinander aus. Weitere Einzelheiten finden Sie unter Ausrichten von Steuerelementen.


Dialogfeld prüfen

Zeigt ein Beispiel an, das veranschaulicht, wie das Dialogfeld und die Steuerelemente in der Anwendung aussehen und funktionieren werden.


3D-Dialogfeld prüfen

Weist dem Dialogfeld den Windows 3D-Stil in der Prüfansicht zu.


Schnelle Hilfe

Öffnet ein Hilfefenster, die kurze Anweisungen für einige grundlegende Aufgaben im Dialog-Editor anzeigt.


Editor bearbeiten

Übersetzt alle Windows-Botschaften zurück, aktiviert die rechte Maustaste und den Zugriff auf das Befehlsfenster. Wir empfehlen, daß Sie die Skripten nicht modifizieren.


Info über Dialog

Zeigt den Bildschirm Info über Dialog an.


Initialisierungswerte

Eine Textzeichenfolge, die Ausgangswerte enthält, die in die Steuerelemente des Dialogfelds abgelegt werden, wenn dieses angezeigt wird. Der Dialog-Editor speichert diese Zeichenfolge in einer Benutzereigenschaft des Buchs, wenn Sie das Dialogfeld einem Buch zuweisen.


Dialogfeld-Vorlage

Eine TextzeichenfolgeA, die die Spezifikation enthält, die Windows zum Zeichnen des Dialogfelds verwendet. Der Dialog-Editor speichert diese Zeichenfolge in einer Benutzereigenschaft des Buchs, wenn Sie das Dialogfeld einem Buch zuweisen.


Eigenschaften-Dialogfeld

Ein Dialogfeld, mit dem Sie verschiedene Eigenschaften eines Steuerelements (und des Dialogfeld-Rahmens) festlegen können. Jeder Steuerelementtyp hat unterschiedliche Eigenschaften. Weitere Einzelheiten über Steuerelemente und ihre Eigenschaften finden Sie unter Dialogfeld-Steuerelemente.


dlgBox

Die Benutzereigenschaft des Buchs, das die Dialogfeld-Vorlage enthält. Diese Daten werden bei Anzeige des Dialogfelds an Windows übergeben und werden von Windows verwendet, um das Dialogfeld zu zeichnen.


dlgInit

Die Benutzereigenschaft des Buchs, die die Ausgangswerte der Steuerelemente in einem Dialogfeld enthält. Diese Daten werden bei Anzeige des Dialogfelds an Windows übergeben, es sei denn, sie werden bei Anzeige durch andere Werte ersetzt.


Fensterzugriffsnummer

Die Fensterzugriffsnummer des Fensters, das das Dialogfeld aufruft.


Objekt benachrichtigen

Das Zielobjekt der Behandlungsroutinen to get TBKDialogInit, to get TBKDialogCommand und to get TBKDialogDestroy.


Schaltfläche "Bearbeiten"

Wählen Sie ein Symbol oder eine Bitmap aus dem Listenfeld "Ressourcen" und klicken Sie dann auf diese Schaltfläche, um die Ressource zu bearbeiten. Ein Editor zur Beabeiung des Symbols bzw. der Bitmap erscheint.


Ressourcenliste

Eine Liste aller Symbole oder Bitmaps, die im Buch zur Verfügung stehen, dem das Dialogfeld zugewiesen werden soll.


Kombinationsfeld Ressource

Die einzige Auswahlmöglichkeit ist der Typ des Steuerlements, der zum Dialogfeld hinzugefügt werden soll: Symbol oder Bitmap.


Schaltfläche "Importieren"

Wählen Sie diese Schaltfläche, um eine Bitmap oder ein Symbol aus einem anderen Buch zu importieren.


Schaltfläche "Hilfe"

Wählen Sie diese Schaltfläche, um eine Beschreibung der Dialogfeld-Steuerelemente aufzurufen.


Schaltfläche "Neu"

Wählen Sie diese Schaltfläche, wenn Sie ein neues Symbol oder eine neue Bitmap erstellen wollen. Ein Editor erschein, mit dem Sie das Objekt bearbeiten können.


Installieren eines Dialogfelds in einem Buch
Schritt für Schritt

So installieren Sie ein Dialogfeld in eine Anwendung

1.	Start Sie den Dialog-Editor und öffnen Sie das Dialogfeld.

2.	Wählen Sie im Menü Datei den Befehl Vorlage zum Buch zuweisen.

Daraufhin erscheint das Dialogfeld Zielbuch auswählen.

3.	Wählen Sie das Buch aus, in dem Sie das Dialogfeld installieren wollen, und klicken Sie auf "OK".

Sie werden zur Eingabe eines Namens für das Dialogfeld aufgefordert.

4.	Geben Sie den Namen in das Feld ein und klicken Sie auf "OK".

Sie werden mit einer Meldung mitgeteilt, daß die Dialogfeld-Vorlage und Initialisierungswerte als Benutzereigenschaft zum Buch hinzugefügt und daß eine Behandlungsroutine für die Botschaft  show<Dialogfeldname> zum Buchskript hinzugefügt wurde.

Siehe auch:

Erstellen eines Ansichtsobjekts von der Dialogfeld-Definition

Anzeigen eines Dialogfelds aus einem Buch heraus

Anpassen von Dialogfeld-Definitionen


Anpassen von Dialogfeld-Definitionen
Schritt für Schritt

So bearbeiten Sie eine Dialogfeld-Definition:

1.	Öffnen Sie das Dialogfeld im Dialog-Editor.

2.	Nehmen Sie die gewünschten Änderungen vor.

3.	Speichern Sie die .DIA-Datei.

4.	Wählen Sie aus dem Menü Datei den Befehl Vorlage zum Buch zuweisen. Weisen Sie das Dialogfeld dem Buch erneut zu.

Falls das Dialogfeld bereits zum Buch zugewiesen wurde, erscheint das folgende Dialogfeld:

5.	Wenn Sie das Dialogfeld mit einem anderen Namen speichern (und das ursprüngliche Dialogfeld im Buch beibehalten) wollen, klicken Sie auf die Schaltfläche "Umbenennen". Geben Sie einen neuen Namen ein und klicken Sie dann auf "OK".

Klicken Sie auf "Fortfahren", um das Dialogfeld mit demselben Namen zuzuweisen.

Sie werden mit einer Meldung mitgeteilt, daß das Dialogfeld dem Buch zugewiesen wurde.

6.	Klicken Sie auf "OK"..

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Installieren eines Dialogfelds in einem Buch

Öffnen einer Dialogfeld-Definition


Erstellen eines Ansichtsobjekts aus der Dialofeld-Definition
Schritt für Schritt

So erstellen Sie ein Ansichtsobjekt aus der Dialogfeld-Definition:

1.	Erstellen Sie das Dialogfeld oder öffnen Sie die .DIA-Datei des Dialogfelds im Dialog-Editor.

2.	 Wählen Sie aus dem Menü Datei den Befehl Vorlage in Ansichtsobjekt umwandeln.

Daraufhin erscheint das Dialogfeld Zielbuch des Dialogfeld-Ansichtsobjekts.

3.	Wählen Sie das Buch aus, in dem Sie das Ansichtsobjekt erstellen wollen, und klicken Sie auf "OK".

Sie werden mit einer Meldung mitgeteilt, daß das Dialog-Ansichtsobjekt <Name> und die Behandlungsroutine show<Name> im Buch erstellt wurden.

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus


Anzeigen eines Dialogfelds aus einem Buch heraus
Schritt für Schritt

Wenn Sie das Dialogfeld zu einem Buch zuweisen, wird eine Behandlungsroutinen (Beispiel) zum Buchskript hinzugefügt, die die Botschaft show<Name> verarbeitet, wobei Name für den Namen des Dialogfelds steht. Beim Aufruf der Behandlungsroutine führt diese drei Aktionen durch:

Verknüpfen mit den Funktionen in tb30dlg.dll.

Anzeigen des Anzeiges mit den Ausgangswerten, die Sie beim Erstellen des Dialogfelds festgelegt haben.

Fragt die Dialogfeldwerte beim Schließen des Dialogfelds ab.

Diese Behandlungsroutinen zeigt ein statisches Dialogfeld an, das nicht über die Anwendung gesteuert wird, wenn es geöffnet ist. Sie können ein Dialogfeld auch interaktiv einsetzen, wobei die Anwendung die Aktionen des Benutzers feststellen und das Dialogfeld anpassen muß, während es noch geöffnet ist. Wenn Sie ein Dialogfeld interaktiv einsetzen wollen, benötigen Sie zusätzliche Behandlungsroutinen, um die vom Benutzer durchgeführten Aktionen zu verarbeiten. Weitere Einzelheiten hierzu finden Sie unter Statische und interaktive Dialogfelder.

Zum Anzeigen des Dialogfelds senden Sie dei Botschaft  show<Name> an das Buch.

Das gewöhnliche Verfahren zum Senden der show<Name>-Botschaft ist durch Hinzufügen einer Schaltfläche zum Buch, die ein Skript wie das folgende enthält (in diesem Beispiel wird ein Dialogfeld namens "Routen" angezeigt):

to handle buttonDown

send showRouten

end

Zur Anzeige des Dialogfelds müssen Sie nicht unbedingt eine Schaltfläche verwenden; jedes ToolBook-Ereignis, das eine Botschaft auslöst, kann auch verwendet werden. Wenn Sie z.B. ein Kennwort-Dialogfeld gleich beim Öffnen des Buchs (d.h. beim Senden der enterApplication-Botschaft) senden wollen, könnten Sie ein Skript wie das folgende zum Buch hinzufügen:

to handle enterApplication

send showPass

end

Dadurch wird ein Dialogfeld namens Pass angezeigt, in das der Benutzer ein Kennwort eingibt.

Sie können ein Dialogfeld auch mit einem Menübefehl anzeigen.

Hinweis: Stellen Sie sicher, daß sysLockScreen auf false gesetzt ist, bevor Sie Dialogfelder anzeigen, die mit dem Dialog-Editor erstellt wurden. Sonst wird das ToolBook-Fenster nicht ordnungsgemäß gezeichnet, wenn der Benutzer das Dialogfeld verschiebt oder ein anderes Fenster aktiviert.

Siehe auch:

Displaying a static dialog box -- dialog( )

Displaying an interactive dialog box -- dialogCallback( )


Anzeigen eines Dialogfelds durch Menüauswahl
Schritt für Schritt

Mit dem add menuItem-Befehl können Sie einem Menü einen Befehl zur Anzeige des Dialogfelds hinzufügen. Weisen Sie dem Menübefehl den Alias show<Dialogfeldname> zu.

Wenn der Benutzer den Befehl aus dem Menü wählt, sendet ToolBook den show<Dialogfeldname>- Befehl. Daraufhin erscheint das Dialogfeld.

Weitere Einzelheiten über das Erstellen von Menüs finden Sie in Kapitel 13 des ToolBook-Benutzerhandbuchs.

Hinweis: Stellen Sie sicher, daß sysLockScreen auf false gesetzt ist, bevor Sie Dialogfelder anzeigen, die mit dem Dialog-Editor erstellt wurden. Sonst wird das ToolBook-Fenster nicht ordnungsgemäß gezeichnet, wenn der Benutzer das Dialogfeld verschiebt oder ein anderes Fenster aktiviert.

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus


Statische und interaktive Dialogfelder
Schritt für Schritt

Ein Dialogfeld kann entweder im statischen oder im interaktiven Modus verwendet werden. Bei beiden Modi ist das Design des Dialogfelds gleich, also kann dasselbe Dialogfeld auf zwei verschiedene Arten eingesetzt werden. Zur Anzeige des Dialogfelds im statischen Modus rufen Sie die Funktion dialog( ) in TB30DLG.DLL auf. Zur Anzeige eines interaktiven Dialogfelds rufen Sie die FuktiondialogCallback( ) auf.

Beim Einsatz im statischen Modus nimmt das Dialogfeld die Auswahlen bzw. Eingaben des Benutzers in seine Steuerelemente auf. Abgesehen davon ändern sich das Dialogfeld nicht in Reaktion auf die Aktionen des Benutzers. Wenn der Benutzer das Dialogfeld schließt, werden die Auswahlen und Eingaben an die Behandlungsroutinen zurückgegeben, die das Dialogfeld geöffnet hat.

Im interaktiven Modus sendet das Dialogfeld die Botschaften an das Objekt zurück, das es geöffnet hat:

wenn es geöffnet wird.

wenn der Benutzer eine Auswahl trifft oder eine Eingabe tätigt.

wenn es geschlossen wird.

Durch Schreiben von Behandlungsroutinen zum Verarbeiten dieser Botschaften können Sie das Dialogfeld in Reaktion auf die Aktionen des Benutzers anpassen.

Zum Beispiel könnte Ihr Dialogfeld eine Gruppe von Optionsfeldern namens "Jet," "Bus," und "Zug" sowie ein Listenfeld namens "Abfahrt." Wenn der Benutzer ein Verkehrsmittel auswählen, ändern sich die Listenfeldeinträge in die Einträge des ausgewählten Verkehrsmittels. Ein anderes Beispiel: der Benutzer könnte zur Eingabe eines Kennworts aufgefordert werden, wobei das Programm dann die Eingabe prüfen könnte, um die Richtigkeit der Eingabe zu prüfen, bevor die weiteren Steuerelemente im Dialogfeld aktiviert wurden.

In beiden Modi können Sie die Ausgangswerte des Dialogfeld-Steuerelements ändern, bevor Sie das Dialogfeld öffnen, und Sie können die Werte abfragen, die aus den Benutzerauswahlen und -eingaben entstehen. In beiden Modi verwenden Sie Behandlungsroutinen, um das Dialogfeld anzuzeigen und zu steuern.

Siehe auch:

Behandlungsroutinen für Dialogfelder

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


Behandlungsroutinen
Schritt für Schritt

Zum Verwenden dieses Dialogfelds im statischen oder interaktiven& Modus benötigen Sie Behandlungsroutinen. Sie benötigen mindestens eine Routine zum Verknüpfen mit der Dialog-DLL (TB30DLG.DLL,) und zum Deklarieren der zu verwendenden DLL-Funktionen, und eine andere Behandlungsroutine, die das Dialogfeld anzeigt.

Der Dialog-Editor erstellt eine grundlegende Behandlungsroutine, die mit der DLL verknüpft und die Funktion dialog( ) zur Anzeige des statischen Dialogfelds aufruft. Dieses Skript und die Behandlungsroutinen werden im Buch abgelegt, dem Sie das Dialogfeld zuweisen.

Im folgenden finden Sie ein Beispiel für ein Skript und eine Behandlungsroutine (für das Dialogfeld "Routen"), die vom Dialog-Editor erstellt wurden:

to handle showRouten

--Verschiebt die linkDLL-Anweisung in die enterBook-Routine

linkDLL "tb30dlg.dll"

string dialog(string, string)

string setValue(string, string, string)

string getValue(string, string)

end

set init to RoutenInit of this book

--set init to setValue(init,"","")  --DLL-Funktion

set Rückwert to dialog(RoutenBOX of this book, init)

--get getValue(Rückwert, "")  --DLL-Funktion

end

Bei einem statischen k sollten Sie Anweisungen zur Verwendung der Werte in den Steuerelementen, nachdem der Benutzer das Dialogfeld geschlossen hat. Diese Anweisungen gehören in die Behandlungsroutine, die das Dialogfeld nach get getValue(Rückwert, "") anzeigt.

Zur Verwendung eines Dialogfelds im interaktiven Modus müssen Sie das Verknüpfungsskript und die Behandlungsroutine anpassen und müssen mindestens ein Skript zum Verarbeiten von Botschaften aus dem Dialogfeld hinzufügen. Weitere Einzelheiten über Skripten im interaktiven Modus finden Sie unter Anzeigen eines interaktiven Dialogfelds

Siehe auch:

Behandlungsroutinen für Dialogfelder

Anzeigen eines Dialogfelds aus einem Buch heraus

Statische und interaktive Dialogfelder

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


Anzeigen eines statischen Dialogfelds -- dialog( )-Beispiel
Schritt für Schritt

Mit der dialog( )-Funktion in TB30DLG.DLL können Sie ein statisches Dialogfeld anzeigen.

to handle showDepartim

--Move linkDLL statement to enterBook handler

linkDLL "TB30DLG.dll"

string dialog(string, string)

string setValue(string, string, string)

string getValue(string, string)

end

set init to DepartimInit of this book

--set init to setValue(init,"","")  --DLL-Funktion

set Rückwert to dialog(DepartimBox of this book, init)

--get getValue(Rückwert, "")  --DLL-Funktion

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Anzeigen eines interaktiven Dialogfelds -- dialogCallback( )-Beispiel
Schritt für Schritt

Das folgende Beispiel zeigt die Elemente eines interaktiven Dialogfelds. Die erste Behandlungsroutine verknüpft und initialisiert einige Funktionen in TB30DLG.DLL. Anschließend wird dialogCallback( ) aufgerufen, um das Dialogfeld anzuzeigen. Weitere Behandlungsroutinen verarbeiten Botschaften aus dem Dialogfeld. In diesem Beispiel ändern sich die Beschriftungen unter "Abfahrt aus" und die Abfahrtszeiten im Listenfeld, sobald der Benutzer das Verkehrsmittel auswählt.

to handle showDepartim

--Verschiebt die linkDLL-Anweisung in die enterBook-

--Behandlungsroutine

linkDLL "TB30DLG.dll"

string dialogCallback(word, string, string, string)

string setValue(string, string, string)

string getValue(string, string)

string getControlText (word, string)

int setControlText (word, string, string)

int setListBoxItems (word, string, string)

end

set init to DepartimInit of this book

--set init to setValue(init,"","")  --DLL-Funktion

set Rückwert to dialogCallback( windowHandle of this window, \

DepartimBox of this book, init, self)

--get getValue(Rückwert, "")  --DLL-Funktion

end

-- Behandlungsroutinen für Benachrichtigungsbotschaften, die

-- über Dialog-Callback gesendet wurden

to get tbkDialogInit hDlg

--beim Erstellen des Dialogfelds (WM_INITDIALOG)

return 1

end

to get tbkDialogCommand	hDlg, CtrlID, hWndCtrl, Msg, CtrlName

conditions

when CtrlName = "BUTTON air_button"

get setControlText( hDlg, "BUTTON Stadt_1", "Bremen" )

get setControlText( hDlg, "BUTTON Stadt_2", "Zürich" )

get setControlText( hDlg, "BUTTON Stadt_3", "Nürnberg" )

get setListBoxItems( hDlg, "LISTBOX Abfahrtszeiten", \

"7 a.m."&crlf&"8.30 Uhr"&crlf&"10.00 Uhr"&crlf& \

"12 noon"&crlf&"13.30 Uhr "&crlf&"15 Uhr"&crlf& \

"17 Uhr"&crlf&"19 Uhr")

when CtrlName = "BUTTON Train_button"

get setControlText( hDlg, "BUTTON city_one", "Freiburg" )

get setControlText( hDlg, "BUTTON city_two", "Karlsruhe" )

get setControlText( hDlg, "BUTTON city_three", "Stuttgart" )

get setListBoxItems( hDlg, "LISTBOX depart_times", \

"7.30 Uhr"&crlf&10 Uhr"&crlf&"17 Uhr")

end conditions

return 1

end

to get tbkdialogDestroy

--(WM_DESTROY)

return 1

end

Siehe auch:

Behandlungsroutinen für Dialogfelder

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


Festlegen der Ausgangswerte
Schritt für Schritt

Die Werte, die Sie beim Erstellen der Steuerelemente im Dialogfeld sind in der dlgInit-Zeichenfolge gespeichert. Wenn Sie das Dialogfeld einem Buch zuweisen, wird diese Zeichenfolge in einer Benutzereigenschaft des Buchs gespeichert. Die show<name> Behandlungsroutine übergibt diese Zeichenfolge an Windows, wenn das Dialogfeld geöffnet wird.

Wenn Sie das Dialogfeld mit anderen Ausgangswerten öffnen wollen, können Sie sie mit der Funktion setValue ändern.

to handle showDepartim

--Verschiebt die linkDLL-Anweisung in die
--enterBook-Behandlungsroutinen

linkDLL "TB30DLG.dll"

string dialog(string, string)

string setValue(string, string, string)

string getValue(string, string)

end

set init to DepartimInit of this book

--set init to setValue(init,"Stadt_1","Bremen")  --DLL-Funktion

set Rückwert to dialog(DepartimBOX of this book, init)

--get getValue(Rückwert, "")  --DLL-Funktion

end

Hinweis:  Wenn Sie das Dialogfeld interaktiv verwenden, können Sie statt der setValue( )-Funktion eine to get tbkDialogInit-Behandlungsroutine verwenden, um die Ausgangswerte zu ändern, bevor das Dialogfeld angezeigt wird.

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Bestimmen der Benutzereingabe in einem statischen Dialogfeld
Schritt für Schritt

Mit einem statischen Dialogfeld stellen Sie die Benutzereingaben erst nach dem Schließen des Dialogfelds fest. Der Rückgabewert (Rückwert) enthält die Werte aller Steuerelemente zum Zeitpunkt des Schließens des Dialogfelds.

Sie können die Funktion getValue, um die Werte bestimmter Steuerelemente zu ermitteln.

to handle showDepartim

--Verschiebt die linkDLL-Anweisung in die enterBook-Behandlungsroutinen

linkDLL "TB30DLG.dll"

string dialog(string, string)

string setValue(string, string, string)

string getValue(string, string)

end

set init to DepartimInit of this book

--set init to setValue(init,"","")  --DLL-Funktion

set Rückwert to dialog(DepartimBOX of this book, init)

get getValue(Rückwert, "nListBox depart_times")  --DLL@@function

request "Ausgewählte Elementnummer" && It

end

Siehe auch:

Bestimmen der Benutzereingabe in einem interaktiven Dialogfeld

Anzeigen eines Dialogfelds aus einem Buch heraus

Statische und interaktive Dialogfelder


Bestimmen der Benutzereingabe in einem interaktiven Dialogfeld
Schritt für Schritt

Bei einem interaktiven Dialogfeld können Sie die Benutzereingabe bzw. -auswahl sofort abrufen, während die Schaltfläche noch geöffnet ist.

Hierzu schreiben Sie Behandlungsroutinen für Callback-Botschaften, die die Botschaften aus dem Dialogfeld verarbeiten. Diese Behandlungsroutinen können auf bestimmte Aktionen reagieren, wie z.B. das Klicken auf eine bestimmte Schaltfläche oder Bildlaufleiste.

Siehe auch:

Bestimmen der Benutzereingabe in ein statisches Dialogfeld

Anzeigen eines Dialogfelds aus einem Buch heraus

Statische und interaktive Dialogfelder

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


Behandlungsroutinen für Dialogfelder
Behandlungsroutinen für Callback-Botschaften
Schritt für Schritt

Beim interaktiven Einsatz eines Dialogfeld sendet dieses Botschaften zu drei verschiedenen Zeitpunkten:

Beim Öffnen des Dialogfelds (WM_INITDIALOG)

Wenn der Benutzer eine Aktion im Dialogfeld durchführt (WM_COMMAND)

Wenn das Dialogfeld geschlossen wird (WM_DESTROY)

Sie verwenden drei Behandlungsroutinen, um diese Botschaften zu verarbeiten:

to get TBKDialogInit (für Botschaften beim Öffnen des Dialogfelds)

to get TBKDialogCommand (für Botschaften, die durch Benutzeraktionen ausgelöst werden)

to get TBKDialogDestroy (für Botschaften beim Schließen des Dialogfelds)

Sie brauchen nur Behandlungsroutinen für die Arten vo Botschaften zu schreiben, die Sie verarbeiten wollen.

Oft löst eine einzelne Benutzeraktion mehrere Benachtichtigungsbotschaften aus. Wenn der Benutzer z.B. auf das Bearbeitungsfeld eines Kombinationsfelds klickt, werden drei Botschaften gesendet:

10 -- Die Benutzerauswahl sollte abgebrochen werden.

4 -- Das Listenfeld erhält den Eingabefokus.

3 -- Das Kombinationsfeld erhält den Eingabefokus.

Ihre Botschaftsbehandlungsroutine kann eine bestimmte, durch eine Benachrichtigungsbotschaft gekennzeichnete Aktion verarbeiten oder es kann einfach auf das Auftreten einer Aktion reagieren, ganz gleich, welche Aktion es war.

Siehe auch:

Bestimmen der Benutzereingabe in einem interaktiven Dialogfeld

Anzeigen eines Dialogfelds aus einem Buch heraus

Verarbeiten einer bestimmten Aktion

Verarbeiten der Esc- und Eingabetasten

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


Verarbeiten einer bestimmten Aktion
Verarbeiten einer bestimmten Aktion (nur dialogCallback( ))
Schritt für Schritt

Zum Verarbeiten einer bestimmten Aktion sollte die Behandlungsroutine die mit der Benachrichtigungsbotschaft übergebene Botschaftsnummer prüfen und eine Aktion durchführen, wenn die richtige Botschaft empfangen wird:

to get tbkDialogCommand hDlg, CtrlID, hWndCtrl, Msg, CtrlName

if msg = 0 and CtrlName = "Button Help"	-- msg 0 = BN_CLICKED

show viewer "SchnelleHilfe" as modal

if isOpen of viewer "SchnelleHilfe"

close viewer "SchnelleHilfe"

end

return 1 	-- Liefert 1, damit das Dialogfeld nicht
--geschlossen wird

else

return 0

end

Siehe auch:

Steuern des Standardverhaltens von Steuerelementen

Bestimmen der Benutzereingabe in einem interaktiven Dialogfeld

Anzeigen eines Dialogfelds aus einem Buch heraus

Verarbeiten der Esc- und Eingabetasten

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


Steuern des Standardverhaltens von Steuerelementen
Steuern des Standardverhaltens von Dialogfenstern
Schritt für Schritt

Folgende Aktionen bewirken, daß das Dialogfeld geschlossen wird:

Das Klicken auf einen beliebigen Druckschalter im Dialogfeld

Das Doppelkllicken auf ein Einzelauswahl-Listenfeld

Das Drücken der ESC-TASTE auf der Tastatur

Das Drücken der EINGABETASTE  auf der Tastatur

Beim interaktiven Einsatz eines Dialogfelds können Sie diese Standardaktionen übergehen.

Hinweis: Sie können dei Standardaktion eines Steuerelements nicht übergehen. Die Standardaktion eines Druckschalters bestimmt z.B., daß er beim Klicken invertiert erscheint und wieder in den Normalzustand zurückkehrt, sobald der Benutzer die Maustaste losläßt. Sie können diese Aktion nicht übergehen, Sie können jedoch verhindern, daß das Dialogfeld geschlossen wird, nachdem die Schalter/Schaltfläche geklickt wurde.

Wenn Sie verhindern wollen, daß das Dialogfeld beim Auftreten eines dieser Ereignisse geschlossen wird, schreiben Sie eine Behandlungsroutine für eine Callback-Botschaft, die auf das jeweilige Ereignis reagiert. Diese Behandlungsroutine kann jede beliebige, von Ihnen gewünschte Aktion oder aber gar keine Aktion durchführen. Hierzu soll die Behandlungsroutine 0 liefern.  (Die Rückgabe eines Werts von 1 erlaubt das Auftreten des Standardverhaltens.)

Siehe auch:

Bestimmen der Benutzereingabe in einem interaktiven Dialogfeld

Anzeigen eines Dialogfelds aus einem Buch heraus

Respond to a specific action

Verarbeiten der Esc- und Eingabetasten

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


Verwenden der dialogCallback( )-Funktionen
Schritt für Schritt

Im folgenden werden Operationen aufgelistet, die Sie mit den Funktionen der TB30DLG.DLL. durchführen können. Klicken Sie auf eine Operation, um ein Beispielskript zu sehen.

Hinweis: Zum Aufrufen einer DLL-Funktion müssen Sie sie zuerst in der Behandlungsroutine deklarieren, die die DLL verknüpft.

Hinzufügen oder Löschen von von Kombinationsfeldelementen (Schnellverfahren)

Hinzufügen oder Löschen von Listenfeldelementen (Schnellverfahren)

Ändern eines Symbols oder einer Bitmap (Schnellverfahren)

Aktivieren und Deaktivieren von Kontrollkästchen (Schnellverfahren)

Verfügbarmachen und Sperren von Steuerelementen (Schnellverfahren)

Aktivieren oder Deaktivieren von Kontrollkästchen (Schnellverfahren)

Festlegen oder Abrufen einer Schaltflächenbeschriftung (Schnellverfahren)

Festlegen oder Abrufen des Fokus (Schnellverfahren)

Festlegen oder Abrufen der Auswahl in einem Kombinationsfeld (Schnellverfahren)

Festlegen oder Abrufen der Auswahl in einem Listenfeld (Schnellverfahren)

Festlegen oder Abrufen des Text eines Felds (Schnellverfahren)

Anzeigen weiterer Optionen mit Schaltflächen

Überprüfen der Eingabe in ein Dialogfeld

Siehe auch:

Bestimmen der Benutzereingabe in einem interaktiven Dialogfeld

Anzeigen eines Dialogfelds aus einem Buch heraus

Verarbeiten einer bestimmten Aktion

Verarbeiten der Esc- und Eingabetasten

TB30DLG.DLL functions

Windows-Benachrichtigungsbotschaften


Hinzufügen oder Löschen von von Kombinationsfeldelementen (Schnellverfahren)
Schritt für Schritt

SetComboBoxItems( ) legt den Text eines Elements oder mehrerer Elemente im Dropdown-Listenfeld eines Kombinationsfeld-Steuerelements.

AddComboBoxItem( ) Fügt ein Element zum Drowdown-Listenfeld eines Kombinationsfeld-Steuerelements hinzu.

DeleteComboBoxItem( ) Löscht ein Element aus dem Dropdown-Listenfeld eines Kombinationsfeld-Steuerelements.

DeletenComboBoxItem( ) Löscht ein Element aus dem Dropdown-Listenfeld eines Kombinationsfeld-Steuerelements anhand der Indexnummer in der Liste (löscht z.B. das 9te Element in der Liste).

Rufen Sie die Funktion einmal für jedes Element, das hinzugefügt bzw. gelöscht werden soll.

setComboboxItems( )

to get TBKDialogInit hDlg, CtrlID, hWndCtrl, message, ctrlName

-- Initialisiert Kombinationsfeldelemente mit den Auswahlen
-- aus einem Feld auf der Seite "Setup"

get setComboboxItems(hDlg,"Combobox Titel",text of field "Titel"\ 	of page "setup")

end

addComboboxItem( )

deleteComboboxItem( )

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Fügt ein neues Element in die sortierte Position in der

--Liste der Kombinationsfeldelemente und entfernt oldTitle

-- aus der Dropdown-Elementliste

if update = 1

index = -1

sortFlag = 1

get addComboboxItem(hDlg,"Combobox Titel","OS-Handbuch", index,\ 	softFlag)

get DeleteComboboxItem(hDlg,"Combobox Titel","Benutzerhandbuch")

end

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Festlegen oder Abrufen der Auswahl in einem Kombinationsfeld (Schnellverfahren)
Schritt für Schritt

Die  getControlText( )-Funktion liefert den Text des Bearbeitungsfelds des Kombinationsfelds, was normalerweise dem ausgewählten Element entspricht.

The setControlText( ) function sets the corresponding text.

to get TBKDialogInit hDlg, hWndFocus

get setControlText(hDlg, "combobox Ziel","Texas")

return 0

end get

to get TBKDialogCommand hDlg, ctrlID, hWndCtrl, message, ctrlName

conditions

when getControlText(hDlg,"combobox Ziel") = "Austin"

request "Austin Texas"

return 0

else

return 1

end conditions

end get

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Hinzufügen oder Löschen von Listenfeldelementen (Schnellverfahren)
Schritt für Schritt

Die addListBoxItem( )-Funktion fügt ein Element zu einem Listenfeld-Steuerelement hinzu.

Die deleteListBoxItem( )-Funktion löscht ein Element aus einem Listenfeld-Steuerelement.

Die deletenListBoxItem( )-Funktion löscht ein Element aus einem Listenfeld-Steuerelement anhand seiner Indexnummer in der Liste (z.B. wird das nte Element in der Liste gelöscht).

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Wenn ein Element im Listenfeld nicht existiert,

--wird es an der sortierten Positin hinzugefügt und

--das alte Element geloscht

index = -1

softFlag = 1

newItem = "Setting"

oldDelete = "Spiking"

CurrentItems = getListBoxItems(hDlg,"Listbox VolleyballSkills")

if newItem is not in CurrentItems

get addListBoxItem(hDlg,"Listbox VolleyballSkills",newItem,\ 	index,sortFlag)

end

get deleteListBoxItem(hDlg,"Listbox VolleyballSkills",oldItem)

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Festlegen oder Abrufen der Auswahl in einem Listenfeld (Schnellverfahren)
Schritt für Schritt

Die getListBoxSelection( )Funktion liefert den Text der ausgewählten Zeile bzw. Zeilen in einem Listenfeld-Steuerelement.

Die getnListBoxSelection( )Funktion liefert die Indexnummer bzw. -nummern der ausgewählten Zeilen in einem Listenfeld.

Die setListBoxSelection( )-Funktion liefert die ausgewählte Zeile bzw. Zeilen in einem Listenfeld.

Die setnListBoxSelection( )-Funktion liefert die ausgewählte Zeile bzw. Zeilen in einem Listenfeld anhand ihrer Indexnummern (z.B. wählt es das nte Elemente in der Liste aus).

getListboxSelection( )

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Ruft den Text der ausgewählten Zeile eines Listenfelds ab

SelectedPlayer =  getListBoxSelection(hDlg,"Listbox PlayerNames")

end

getnListboxSelection( )

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Ermittelt die Nummer der Textzeile der Auswahl in
--einem Listenfeld

SelectedPlayersPosition =  getnListBoxSelection(hDlg,\

"Listbox PlayerNames")

end

setListboxSelection( )

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Hebt die vom Benutzer getroffene Auswahl in
--einem Listenfeld hervor

get setListboxSelection (hDlg,"Listbox PlayerNames","ToolBook")

end

setnListboxSelection( )

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Hebt die Textzeilen eines Listenfelds hervor

textlineNumbers = "1,3,5,7"

get setnListboxSelection (hDlg,"Listbox PlayerNames",\

textlineNumbers)

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Ändern eines Symbols oder einer Bitmap (Schnellverfahren)
Schritt für Schritt

Die setBitmapData( )-Funktion gibt eine Bitmap-Ressource zur Verwendung in einem Bitmap-Steuerelement an.

Die setIconData( )-Funktion gibt eine Symbolressource zur Verwendung in einem Symbol-Steuerelement an.

setBitmapData( )

to get TBKDialogInit hDlg, CtrlID, hWndCtrl, message, ctrlName

conditions

when pageNumber = 1

bitmapName = "bitmap" & pageNumber

hBitmap = GDIHandle(bitmapName)

get setBitmapData(hDlg,"BITMAP BitmapBox",hBitmap)

end

end

end

setIconData( )

to get TBKDialogInit hDlg, CtrlID, hWndCtrl, message, ctrlName

--Legt das im Dialogfeld angezeigte Symbol per Zufall fest

IconNum = random(6)

Iconname = "icon" & IconNum

hIcon = GDIHandle(Icon IconName)

get setIconData(hDlg,"ICON IconBox",hIcon)

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Using dialogCallback() functions


Aktivieren und Deaktivieren von Kontrollkästchen (Schnellverfahren)
Schritt für Schritt

Die isButtonChecked( )-Funktion teilt Ihnen mit, ob das Kontrollkästchen  abgehakt oder ob ein Optionsfeld ausgewählt ist.

Die setButtonCheck( )-Funktion aktiviert bzw. deaktiviert ein Kontrollkästchen-Steuerelement bzw. Optionsfeld-Steuerelement.

Wenn ein Optionsfeld ausgewählt ist und Sie ein anderes auswählen, wird das erste deaktiviert.

Der dritte Parameter ändert das Steuerelement. Wenn er 0 ist, wird das Häkchen bzw. die Auswahl entfernt; wenn er den Wert 1 hat, wird das Häkchen bzw. die Auswahl hinzugefügt.

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Wenn die Schaltfläche "SystemDefaults" abgehakt ist, werden

--die Schaltflächen TabWidth8 und SaveOnClose ebenfalls abgehakt;

--die Schaltfläche "Display Rulers" wird dagegen deaktiviert.

if isButtonChecked (hDlg,"Button SystemDefaults") = 1

get setButtonCheck(hDlg,"Button TabWidth8",1)

get setButtonCheck(hDlg,"Button SaveOnClose",1)

get setButtonCheck(hDlg,"Button DisplayRulers",0)

end

end

----------

to get TBKDialogCommand hDlg, ctrlID, hWndCtrl, message, ctrlName

conditions

when ctrlName = "button choice" and message = 0

get setButtonCheck(hDlg, "button option3", 1)

return 1

end conditions

end get

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Verfügbarmachen und Sperren von Steuerelementen (Schnellverfahren)
Schritt für Schritt

Die  enableControl( )Funktion macht ein Steuerelement verfügbar bzw. sperrt ein Steuerelement.

Die  isControlEnabled( )-Funktion liefert 1, wenn das angegebene Steuerelement verfügbar ist, oder 0, falls es gesperrt ist.

Der dritte Parameter, <enable> macht das Steuerelement verfügbar oder sperrt es. Wenn dr Parameter den Wert 0 hat, ist das Steuerelement gesperrt. Wenn er den Wert 1hat, ist das Steuerelement verfügbar.

enableSteuerelement( )

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

conditions

when ctrlName = "EDIT Notes"

if getControlText(hDlg,ctrlName) = null

get enableControl (hDlg,"Button AddText",0)

   	else

get enableControl (hDlg,"Button AddText",1)

end

end

end

isSteuerelementEnabled( )

to get TBKDialogInit hDlg, CtrlID, hWndCtrl, message, ctrlName

--Bei Anzeige des Dialogfelds sicherstellen, daß die

--richtigen Steuerelemente verfügbar sind: die init-

--Schaltfläche ist verfügbar und die exit-Schaltfläche ist gesperrt

if isControlEnabled(hDlg,"Button Init") = 0

get enableControl(hDlg,"Button Init",1)

get enableControl(hDlg,"Button Exit",0)

end

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Festlegen oder Abrufen einer Schaltflächenbeschriftung (Schnellverfahren)
Schritt für Schritt

Die  getControlText( )-Funktion liefert den Text des angegebenen Steuerelements. Bei Schaltflächen liefert die Funktion den Text der Schaltflächenbeschriftung. Bei Kombinationsfeldern liefert die Funktion den Text des Bearbeitungsfelds des Kombinationsfelds, was normalerweise dem ausgewählten Element entspricht. Bei Feldern liefert diese Funktion den Feldtext.

Die setControlText( )-Funktion legt den entsprechenden Text fest.

to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, message, ctrlName

--Ermittelt den Dateinamen, den der Benutzer in das Steuerelement eingegeben hat EDIT FileField

FileToFind = getControlText (hDlg,"EDIT FileField")

if FileToFind = "hilfe.doc"

get setControlText(hDlg,"BUTTON Topics","Nothilfe-Verfahren")

end

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Festlegen oder Abrufen des Fokus (Schnellverfahren)
Schritt für Schritt

Die  getDialogFocus( )Funktion liefert den Namen des Steuerelements mit dem Eingabefokus im Dialogfeld.

Die setDialogFocus( )-Funktion legt den Eingabefokus auf das angegebene Steuerelement fest.

getDialogFocus( )

to get TBKDialogInit hDlg, CtrlID, hWndCtrl, message, ctrlName

-- Verhindert, daß Benutzer Vornamen eingeben, ohne
-- zuerst den Nachnamen einzugeben

if getDialogFocus(hDlg,"EDIT Vorname") = 1 and \

   getControlText(hDlg,"EDIT Nachname") = null

request "Bitte geben Sie den Nachnamen ein"

end

end

setDialogFocus( )

to get TBKDialogInit hDlg, CtrlID, hWndCtrl, message, ctrlName

--Immer wenn das Dialogfeld erscheint, hat ein bestimmtes
--Feld den Fokus

get setDialogFocus(hDlg,"edit Nachname")

end

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Anzeigen weiterer Optionen mit Schaltflächen
Schritt für Schritt

to get TBKDialogCommand hDlg, ctrlID, hWndCtrl, message, ctrlName

conditions

when ctrlName = "delete" and message = 0

request "Wollen Sie das Element wirklich löschen?"

return 0

else

return 1

end conditions

end get

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Überprüfen der Eingabe in ein Dialogfeld
Schritt für Schritt

to get TBKDialogCommand hDlg, ctrlID, hWndCtrl, message, ctrlName

conditions

when getControlText(hDlg,"title") <> "Angestellt"

request "Nur Angestellte dürfen diese Funtion verwenden."

get endTBKDialog(hDlg,1)

return 0

else

return 1

end conditions

end get

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


Windows-Benachrichtgungsbotschaften

Die nachstehende Tabelle zeigt die Windows-Benachrichtgungsbotschaften, ihre Botschaftsnummern und eine Beschreibung der Botschaft.

Botschaftsnummer

Windows-Botschaft	Hex	Dezimal	Bedeutung

BN_CLICKED	0x0000	0	Der Benutzer hat auf einer Schaltfläche geklickt.
BN_DISABLE	0x0004	4	Eine Schaltfläche ist gesperrt.
BN_DOUBLECLICKED	0x0005	5	Der Benutzer hat auf eine Schaltfläche doppelklickt.
BN_HILITE	0x0002	2	Der Benutzer hat eine Schaltfläche hervorgehoben.
BN_PAINT	0x0001	1	Die Schaltfläche soll gezeichnet werden.
BN_UNHILITE	0x0003	3	Die Hervorhebung soll entfernt werden.
CBN_CLOSEUP	0x0008	8	Das Dropdown-Listenfeld eines Kombinationsfelds wurde geschlossen.
CBN_DBLCLK	0x0002	2	Der Benutzer hat auf eine Zeichenfolge doppelklickt.
CBN_DROPDOWN	0x0007	7	Das Dropdown-Listenfeld eines Kombinationsfelds wird augefklappt.
CBN_EDITCHANGE	0x0005	5	Der Benutzer hat Text im Bearbeitungsfeld geändert.
CBN_EDITUPDATE	0x0006	6	Modifizierter Text wird angezeigt.
CBN_ERRSPACE	0xFFFF	65535	Dem Kombinationsfeld steht kein Speicher mehr zur Verfügung.
CBN_KILLFOCUS	0x0004	4	Das Kombinationsfeld verliert den Eingabefokus.
CBN_SELCHANGE	0x0001	1	Ein neues Listenelement in Kombinationsfeld ist ausgewählt.
CBN_SELENDCANCEL	0x000A	10	Die Benutzerauswahl soll abgebrochen werden.
CBN_SELENDOK	0x0009	9	Die Benutzerauswahl ist ungültig.
CBN_SETFOCUS	0x0003	3	Das Kombinationsfeld erhält den Eingabefokus.
EN_CHANGE	0x0300	768	Die Anzeige wird nach Textänderung aktualisiert.
EN_ERRSPACE	0x0500	1280	Dem Bearbeitungssteuerelement steht kein Speicher mehr zur Verfügung.
EN_HSCROLL	0x0601	1537	Der Benutzer hat clicked the scroll bar.
EN_KILLFOCUS	0x0200	512	Das Bearbeitungssteuerelement verliert den Fokus.
EN_MASTEXT	0x0501	1281	Der Einfügevorgang wurde abgeschnitten.
EN_SETFOCUS	0x0100	256	Das Bearbeitungssteuerelement erhält den Eingabefokus.
EN_UPDATE	0x0400	1024	Das Bearbeitungssteuerelement zeigt modifizierten Text an.
EN_VSCROLL	0x0602	1538	Der Benutzer hat auf die vertikale Bildlaufleiste geklickt.
LBN_DBLCLK	0x0002	2	Der Benutzer hat auf eine Zeichenfolge doppelklickt.
LBN_ERRSPACE	0xFFFE	65534	Dem Listenfeld steht kein Speicher mehr zur Verfügung.
LBN_KILLFOCUS	0x0005	5	Das Listenfeld verliert den Eingabefokus.
LBN_SELCANCEL	0x0003	3	Die Sitzung ist abgebrochen.
LBN_SELCHANGE	0x0001	1	Die Auswahl wird geändert.
LBN_SETFOCUS	0x0004	4	Das Listenfeld erhält den Eingabefokus.
Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen


TBKDialogInit

Syntax	TBKDialogInit(<hDlg>, <hWndFucus>)

Deklaration	to get TBKDialogInit hDlg, hWndFocus

Parameter	<hDlg>	Die Fensterzugriffsnummer des Dialogfelds.

<hWndFocus>	Die Fensterzugriffsnummer des Steuerelements mit dem Fokus.

Beschreibung	OpenScript to get-Behandlungsroutine, die bei WM_INITDIALOG ausgewertet wird.

Rückgabewert	0	Keine Standardverarbeitung.
1	Standardverarbeitung wird erwartet.

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


TBKDialogCommand

Syntax	TBKDialogCommand(<hDlg>, <Steuerelementkennummer>, <control window handle>, <notification message>, <control name>)

Deklaration	to get TBKDialogCommand hDlg, CtrlID, hWndCtrl, Msg, CtrlName

Parameter	<hDlg>	Fensterzugriffsnummer des Dialogfelds.

<Steuerelementkennummer>	Kennummer des Steuerelements, das die Benachrichtigungsbotschaft sendet.

<SE-Fensterzugriffsnummer>	Fensterzugriffsnummer des Steuerelements, das die Benachrichtungsbotschaft sendet.

<BenachrichtBotschaft>	Nummer der Benachrichtigungsbotschaft.

<Steuerelementname>	NAME des Steuerelements, das die Benachrichtigungsbotschaft sendet.

Beschreibung	OpenScript to get-Behandlungsroutine, die bei WM_COMMAND ausgewertet wird.

Rückgabewert	0	Keine Standardverarbeitung.

1	Standardverarbeitung wird erwartet.

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


TBKDialogDestroy

Syntax	TBKDialogDestroy(<hDlg>)

Deklaration	to get TBKDialogDestroy hDlg

Parameter	<hDlg>	Fensterzugriffsnummer des Dialogfelds.

Beschreibung	OpenScript to get-Behandlungsroutine, die bei WM_DESTROY ausgewertet wird.

Rückgabewert	0	Keine Standardverarbeitung.

1	Standardverarbeitung wird erwartet.

Siehe auch:

Anzeigen eines Dialogfelds aus einem Buch heraus

Verwenden der dialogCallback( )-Funktionen

Windows-Benachrichtigungsbotschaften


TB30DLG.DLL

Die Windows-DLL fur Dialogfeld-Funktionen, die mit ToolBook geliefert wird. Sie enthält viele Funktionen, mit denen Sie Dialogfelder unter Verwendung des Dialog-Editors anzeigen und einsetzen können.


.DIA-Datei

Eine Textdatei, die die Dialogfeld-Vorlage und die Ausgangswerte für Dialogfeld-Steuerelemente enthält.


Verarbeiten der Esc- und Eingabetasten
Schritt für Schritt

Wenn die ESC- bzw. EINGABETASTE  gedrückt wird, wird eine Botschaft an die Behandlungsroutine TBKDialogCommand-Behandlungsroutinen gesendet. Der <CtrlID>-Parameter der Botschaft ist 1, falls die EINGABETASTE gedrückt wurde, oder 2, falls die ESC-TASTE gedrückt wurde.

Wenn die EINGABETASTE gedrückt wurde und sich ein Druckschalter-Steuerelement mit einer ID von OK im Dialogfeld befindet, werden die Parameter <hwndCtrl> und <Steuerelementname>  der Botschaft so festgelegt, als ob der Druckschalter ausgewählt wurde.

Wenn die ESC-TASTE gedrückt wurde und sich ein Druckschalter-Steuerelement mit einer ID von Cancel im Dialogfeld befindet, werden die Parameter <hwndCtrl> und <Steuerelementname>  der Botschaft so festgelegt, als ob der Druckschalter ausgewählt wurde.

Wenn kein Steuerelement vorhanden ist, dessen ID mit dem  <CtrlID>-Parameter der Botschaft übereinstimmt, werden die <hwndCtrl> und <controlName>-Parameter der Botschaft jeweils auf 0 und " " festgelegt.