Form Tutorial/de: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | 1 | Zurück zu den [[Additional information/de|Zusätzlichen Informationen]].\ | |
| 3 | - | ||
| 2 | + | ||
| 4 | 3 | Eine kleine Einführung, wie man Formulare in Lazarus nutzt. | |
| 5 | 4 | ||
| 6 | 5 | ## Was ist ein Formular | |
| 7 | 6 | ||
| 8 | 7 | Das Formular (engl. Form, Klasse [[TForm/de|TForm]]) wird auch im Deutschen öfters (fälschlicherweise) als Form bezeichnet. Es stellt ein Fenster oder ein Dialogfeld dar, welches die Benutzeroberfläche einer Anwendung bildet. Es ist der Container, auf dem alle weiteren Komponenten (z.B. Buttons, Labels, Edit-Felder, Images etc.) eingefügt werden. | |
| 9 | 8 | ||
| 10 | 9 | ## Einstieg, die erste GUI-Anwendung | |
| 11 | 10 | ||
| 12 | 11 | Schon nachdem Sie Lazarus erfolgreich installiert haben, wird nach dem Start von Lazarus ein neues Projekt mit einem leeren Formular *Form1* erstellt. Ansonsten können Sie, unter dem Hauptmenueintrag Projekt -\> Neues Projekt -\> Anwendung, eine neue [[Overview of Free Pascal and Lazarus/de|GUI Anwendung]] erstellen. | |
| 13 | 12 | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 13 | + |  | |
| 18 | 14 | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 15 | + |  | |
| 23 | 16 | ||
| 24 | 17 | Jetzt haben Sie schon ein neues, funktionstüchtiges Projekt mit einem Formular erstellt: | |
| 25 | 18 | ||
| 26 | - | ||
| 27 | - | ||
| 28 | - | ||
| 29 | - | ||
| 19 | + |  | |
| 30 | 20 | ||
| 31 | 21 | Um das neu erstellte Projekt zu starten, können Sie einfach die Taste \[F9\] drücken oder mit der Maus auf das Hauptmenu-Symbol  klicken (oder Hauptmenü: Start -\> Start). Das Projekt wird nun im Normalfall kompiliert und gestartet. | |
| 32 | 22 | ||
| 33 | 23 | Es passiert nichts wirklich aufregendes, das Formular *Form1* verändert jedoch geringfügig sein Aussehen und wird die Punkte vom Raster-Gitter (Hilfe für Positionierung einzelner Komponenten) verlieren (solange die Gitterpunkte sichtbar sind, wissen Sie auch, dass Sie sich noch im Entwurfsmodus befinden): | |
| 34 | 24 | ||
| 35 | 25 |  -\>  | |
| 36 | 26 | ||
| 37 | 27 | Kehren Sie wieder in den Entwurfsmodus zurück und legen als nächstes ein [[TButton/de|TButton]] (Schaltknopf) auf dem Formular ab. Dieser soll später das Öffnen eines zweiten Formulars ermöglichen: | |
| 38 | 28 | ||
| 39 | 29 | - Unter der Standard-Komponentenpalette den TButton auswählen | |
| 40 | 30 | ||
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 31 | + |  | |
| 45 | 32 | ||
| 46 | 33 | - auf das Formular klicken: Es wird ein Button auf *Form1* abgelegt mit dem Namen und Bezeichnung (Caption) *Button1*. | |
| 47 | 34 | ||
| 48 | 35 | Damit dieser Button auch einen Sinn bekommt, müssen Sie diesem mitteilen, dass er etwas tun soll, wenn auf ihn geklickt wird. Dieses Klicken kann man vereinfacht als ein [Ereignis](http://de.wikipedia.org/wiki/Ereignis_%28Programmierung%29) (engl. Event) betrachten. Dafür benötigt man [[Event order/de|Ereignisbehandlungsroutinen]] (engl. listener, observer, event handler), die nach dem Klick aufgerufen werden. Der Eventhandler für ein Mausklick kann recht einfach erreicht werden, indem Sie auf den einfügten *Button1* doppelklicken (oder im Objektinspektor -\> Button1 -\> Reiter Ereignisse -\> OnClick auf den Button \[...\] klicken). Es wird nun im Quelltexteditor eine Procedure **`TForm1.Button1Click`** erstellt, die immer aufgerufen wird (zur Laufzeit, nicht im Desingnmodus), wenn *Button1* geklickt wird: | |
| 49 | 36 | ||
| 50 | - | ||
| 51 | - | ||
| 52 | - | ||
| 53 | - | ||
| 37 | + |  | |
| 54 | 38 | ||
| 55 | 39 | Damit die Anwendung nach dem Klick von *Button1* etwas zu tun bekommt, fügen Sie einfach zwischen **begin** und **end** der Procedure *TForm1.Button1Click* etwas Code, wie | |
| 56 | 40 | ||
| 57 | 41 | ``` pascal | |
| 58 | 42 | procedure TForm1.Button1Click(Sender: TObject); | |
| 59 | 43 | begin | |
| 60 | 44 | Caption:='Mein erstes Formular'; //Caption von Form1 wird geändert (Text im Formularkopf) | |
| 61 | 45 | //oder | |
| 62 | 46 | Button1.Caption:='Hallo'; //Caption vom Button1 wird geändert (angezeigter Text des Buttons) | |
| 63 | 47 | end; | |
| 64 | 48 | ``` | |
| 65 | 49 | ||
| 66 | 50 | ein. Jetzt können Sie Ihre Anwendung starten (mit Taste \[F9\]) und sich freuen... | |
| 67 | 51 | ||
| 68 | 52 | Nachdem Sie nun Ihre erste GUI-Anwendung erstellt haben, können Sie nun ein wenig experimentieren und die Standardkomponenten kennen lernen. Für den Einstieg würde ich Ihnen empfehlen, Beispiele folgender Komponenten auszuprobieren: | |
| 69 | 53 | ||
| 70 | 54 | - [[TButton/de|TButton]] | |
| 71 | 55 | - [[TLabel/de|TLabel]] | |
| 72 | 56 | - [[TEdit/de|TEdit]] | |
| 73 | 57 | - [[TMemo/de|TMemo]] | |
| 74 | 58 | - [[TToggleBox/de|TToggleBox]] | |
| 75 | 59 | - [[TRadioButton/de|TRadioButton]] | |
| 76 | 60 | - [[TListBox/de|TListBox]] | |
| 77 | 61 | - [[TComboBox/de|TComboBox]] | |
| 78 | 62 | - [[TScrollBar/de|TScrollBar]] | |
| 79 | 63 | ||
| 80 | 64 | hilfreiche Informationen finden Sie auch im [[Lazarus Tutorial/de|Lazarus Tutorial]] | |
| 81 | 65 | ||
| 82 | 66 | ## Verwendung eines zweiten Formulars | |
| 83 | 67 | ||
| 84 | 68 | Das Tutorial zeigt, wie Sie mehrere Formulare in einem Projekt nutzen können. Im Beispiel werden nur zwei Formulare (Hauptformular *Form1* und *Form2*) erstellt, für weitere Formulare können Sie analog verfahren. | |
| 85 | 69 | ||
| 86 | 70 | Kongret erstellen Sie eine Hauptformular mit einem Button (Knopf), durch dessen Klicken sich die neues Formular öffnet. Das neue Formular erhält ebenfalls einen Button, durch dessen Klicken sich das neue Formular wieder schließt und Sie zum Hauptformular zurück gelangen. | |
| 87 | 71 | ||
| 88 | 72 | Wenn Sie das Tutorial [[Form Tutorial/de|Einstieg, die erste GUI-Anwendung]] durchgearbeitet haben, müssten Sie den Code zwischen **begin** und **end** der Procedure *TForm1.Button1Click* löschen. Ansonsten müssten Sie ein neues Projekt (Anwendung) erstellen, einen Button auf dem Formular ablegen und den OnClick-Eventhandler von diesem Button1 erstellen.\ | |
| 89 | 73 | Diesem Button geben Sie noch eine andere Caption (sichtbarer Text auf dem Button). Dazu den Button anwählen (einfach einmal anklicken) und im Objektinspektor unter Eigenschaften -\> Caption den Text "Form2 öffnen" eingeben. | |
| 90 | 74 | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 94 | - | ||
| 75 | + |  | |
| 95 | 76 | ||
| 96 | 77 | Unter dem Hauptmenupunkt Datei -\> neues Formular können Sie nun ein zweites Formular (Form2) dem Projekt hinzufügen. Auf diesem legen Sie ebenfalls einen Button (Button1) ab und erstellen den OnClick-Eventhandler von diesem. Die Caption von diesem Button ändern Sie analog oben zu *Schließen*.\ | |
| 97 | - | ||
| 78 | + | ||
| 98 | 79 | Jetzt hat das Projekt zwei Formulare, welche jeweils mit dem Hauptmenueintrag Projekt -\> Formulare (oder Tastenkombination \[Shift\]+\[F12\]) ausgewählt und angezeigt werden können. Hilfsweise können Sie auch im Quelltexteditor den Reiter der jeweiligen zum Formular zugehörigen [[Unit/de|Unit]] auswählen und mit \[F12\] das entsprechende Formular anzeigen (mit \[F12\] wechselt man zwischen Quelltexteditor und Formular). | |
| 99 | 80 | ||
| 100 | 81 | Im Quelltexteditor gehen Sie jetzt auf die zu *Form1* gehörende [[Unit/de|Unit]] (Unit1) und fügen der Uses-Klausel **Unit2** hinzu: | |
| 101 | 82 | ||
| 102 | 83 | ``` pascal | |
| 103 | 84 | uses | |
| 104 | 85 | Classes, SysUtils, ... , Unit2; //wichtig ist dass die einzelnen Units mit einem Komma voneinander getrennt sind | |
| 105 | 86 | //und die Uses-Klausel mit einem Semikolon beendet wird | |
| 106 | 87 | ``` | |
| 107 | 88 | ||
| 108 | 89 | Nun ist *Unit2* und damit *Form2* von der *Unit1* aus aufrufbar. | |
| 109 | 90 | ||
| 110 | 91 | Als nächstes bearbeiten Sie noch die OnClick-Events der Buttons der jeweiligen Formulare: | |
| 111 | 92 | ||
| 112 | 93 | ``` pascal | |
| 113 | 94 | unit Unit1; | |
| 114 | 95 | ... | |
| 115 | 96 | procedure TForm1.Button1Click(Sender: TObject); | |
| 116 | 97 | begin | |
| 117 | 98 | Form2.ShowModal; //Zeigt Form2 an, der Focus wird auf Form2 gesetzt | |
| 118 | 99 | end; | |
| 119 | 100 | ``` | |
| 120 | 101 | ||
| 121 | 102 | ``` pascal | |
| 122 | 103 | unit Unit2; | |
| 123 | 104 | ... | |
| 124 | 105 | procedure TForm2.Button1Click(Sender: TObject); | |
| 125 | 106 | begin | |
| 126 | 107 | Close; //Schließt Form2 | |
| 127 | 108 | end; | |
| 128 | 109 | ``` | |
| 129 | 110 | ||
| 130 | 111 | Jetzt können Sie das Projekt starten und von *Form1* mittels Buttonklick *Form2* öffnen. | |
| 131 | 112 | ||
| 132 | 113 | ### Unterschied zwischen Show und ShowModal | |
| 133 | 114 | ||
| 134 | 115 | Beide Methoden *Show* und *ShowModal* machen ein Formular sichtbar. An einem kleinen Beispiel können Sie erfahren, was der Unterschied dieser ist: | |
| 135 | 116 | ||
| 136 | 117 | - Fügen Sie zu dem vorherigen Beispiel [[Form Tutorial/de|Verwendung eines zweiten Formulars]] der *Form1* noch einen zweiten TButton hinzu. | |
| 137 | 118 | - Ändern Sie von *Button1* die Eigenschaften *Name* zu *btnShow* und *Caption* zu *Show*. | |
| 138 | 119 | - Ändern Sie von *Button2* die Eigenschaften *Name* zu *btnShowModal* und *Caption* zu *ShowModal*. | |
| 139 | 120 | - Erstellen Sie (bzw. ändern Sie) die *OnClick*-Eventhandler der beiden Buttons wie folgt: | |
| 140 | 121 | ||
| 141 | 122 | ``` pascal | |
| 142 | 123 | procedure TForm1.btnShowClick(Sender: TObject); | |
| 143 | 124 | begin | |
| 144 | 125 | Form2.Show; | |
| 145 | 126 | ShowMessage('Form2 wurde geöffnet!'); | |
| 146 | 127 | end; | |
| 147 | 128 | ||
| 148 | 129 | procedure TForm1.btnShowModalClick(Sender: TObject); | |
| 149 | 130 | begin | |
| 150 | 131 | Form2.ShowModal; | |
| 151 | 132 | ShowMessage('Form2 wurde geöffnet und schon wieder geschlossen!'); | |
| 152 | 133 | end; | |
| 153 | 134 | ``` | |
| 154 | 135 | ||
| 155 | 136 | - Starten und beobachten Sie den Unterschied!\ | |
| 156 | 137 | ||
| 157 | - | ||
| 158 | 138 | **Show:**\ | |
| 159 | 139 | Diese Procedure macht ein Formular sichtbar und arbeitet den Code des aufrufenden Controls (bei uns *Form1*) weiter ab. In unserem Beispiel wird die Mitteilung (ShowMessage) fast gleichzeitig zur *Form2* angezeigt. Sie können auch weiterhin das aufrufende Formular *Form1* nutzen, dieses zum Beispiel verschieben oder den Button *Show* nochmals klicken (jedoch nicht bei *ShowModal*).\ | |
| 160 | 140 | Sie könnten statt **`<myForm>.Show;`** auch **`<myForm>.Visible:=True;`** schreiben. Die Procedure *Show* macht nichts anderes: | |
| 161 | 141 | ||
| 162 | 142 | ``` pascal | |
| 163 | 143 | procedure TCustomForm.Show; | |
| 164 | 144 | begin | |
| 165 | 145 | Visible := True; | |
| 166 | 146 | BringToFront; | |
| 167 | 147 | end; | |
| 168 | 148 | ``` | |
| 169 | 149 | ||
| 170 | 150 | Der einzigste Unterschied wäre, falls das Formular von einem anderen überdeckt würde, dieses weiter davor bleiben würde.\ | |
| 171 | - | ||
| 151 | + | ||
| 172 | 152 | **ShowModal:**\ | |
| 173 | 153 | Durch diese Methode wird die Codeverarbeitung des aufrufende Controls (bei uns *Form1*) unterbrochen und erst weiter abgearbeitet, wenn das neu geöffnete Formular wieder geschlossen wurde. In unserem Beispiel wird die Mitteilung (ShowMessage) erst ausgegeben, wenn das Formular *Form2* wieder geschlossen wurde. Das aufrufende Formular *Form1* ist wie eingefroren. Sie können es weder verschieben noch Buttons klicken.\ | |
| 174 | 154 | ShowModal ist eine Funktion und gibt als Ergebnis einen Integer zurück, siehe [[doc:lcl/forms/tmodalresult.html|TModalResult]]. Damit können Sie, je nachdem, wie das Formular geschlossen wurde, unterschiedlichen weiteren Code ausführen lassen.\ | |
| 175 | 155 | ||
| 176 | 156 | ## Zwei Formulare, die sich gegenseitig aufrufen können | |
| 177 | 157 | ||
| 178 | 158 | Generell ist es günstig (gutes Programmdesign), wenn von einem Formular nicht dessen Hauptformular aufgerufen wird. Besser ist es, entsprechend vorherigem Beispiel, von einem Hauptformular aus, immer nachfolgende Formulare aufzurufen und durch das Schließen dieser, wieder zum Hauptformular zurückzukehren. Somit entgeht man dem Problem einer [zirkulären Unit - Referenz](http://de.wikipedia.org/wiki/Zirkul%C3%A4re_Abh%C3%A4ngigkeit). Dass es theoretisch trotzdem geht, sehen Sie hier. | |
| 179 | 159 | ||
| 180 | 160 | Entweder Sie modifizieren die Formulare vom Beispiel [[Form Tutorial/de|Verwendung eines zweiten Formulars]] oder Sie müssen ein neues Projekt erstellen, mit zwei Formulare und jeweils einem Button (Knopf). Caption von Form1.Button1 sollte *Form2 öffnen* lauten, die von Form2.Button1 müssten Sie nach *Form1 öffnen* umändern. | |
| 181 | 161 | ||
| 182 | 162 | Diesmal können Sie nicht einfach in die vorhandene Uses-Clause von *Unit2* (wie im vorherigen Beispiel - im Interfaceteil der [[Unit/de|Unit]]) "Unit1" einfügen, da sonst eine zirkuläre Unit-Referenz entstehen würde. "Unit2" müssten Sie somit auch wieder aus der Interface-Uses-Klausel von *Unit1* entfernen. | |
| 183 | 163 | ||
| 184 | 164 | Statt dessen fügen Sie eine Uses-Klausel in den Implementation-Teilen der Units ein: | |
| 185 | 165 | ||
| 186 | 166 | ``` pascal | |
| 187 | 167 | unit Unit1; | |
| 188 | 168 | ... | |
| 189 | 169 | implementation | |
| 190 | 170 | ||
| 191 | 171 | uses | |
| 192 | 172 | Unit2; | |
| 193 | 173 | ... | |
| 194 | 174 | ``` | |
| 195 | 175 | ||
| 196 | 176 | ``` pascal | |
| 197 | 177 | unit Unit2; | |
| 198 | 178 | ... | |
| 199 | 179 | implementation | |
| 200 | 180 | ||
| 201 | 181 | uses | |
| 202 | 182 | Unit1; | |
| 203 | 183 | ... | |
| 204 | 184 | ``` | |
| 205 | 185 | ||
| 206 | 186 | Jetzt ändern Sie noch die hinter den OnClick-Events der Buttons befindlichen Eventhandler zu: | |
| 207 | 187 | ||
| 208 | 188 | ``` pascal | |
| 209 | 189 | unit Unit1; | |
| 210 | 190 | ... | |
| 211 | 191 | procedure TForm1.Button1Click(Sender: TObject); | |
| 212 | 192 | begin | |
| 213 | 193 | Form2.Show; //Zeigt Form2 | |
| 214 | 194 | end; | |
| 215 | 195 | ``` | |
| 216 | 196 | ||
| 217 | 197 | ``` pascal | |
| 218 | 198 | unit Unit2; | |
| 219 | 199 | ... | |
| 220 | 200 | procedure TForm2.Button1Click(Sender: TObject); | |
| 221 | 201 | begin | |
| 222 | 202 | Form1.Show; //Zeigt Form1 | |
| 223 | 203 | end; | |
| 224 | 204 | ``` | |
| 225 | 205 | ||
| 226 | 206 | ## Übergabe von Variablen in andere Formulare | |
| 227 | 207 | ||
| 228 | 208 | Entsprechend Beispiel [[Form Tutorial/de|Verwendung eines zweiten Formulars]] könnte man im Interface-Teil der [[Unit/de|Unit]] *Unit2* eine [[Global variables|globale Variable]] deklarieren. Damit hätte man Zugriff in der *Unit1* und *Unit2* auf ein und die selbe [[Variable]] (da in der *Unit1* unter `uses` die *Unit2* mit einbunden wurde, werden alle im Interface-Teil der *Unit2* deklarierten Variablen auch in *Unit1* nutzbar). Dieses Vorgehen sollten Sie aber auf ein Minimum beschränken, da man bei größeren Projekten schnell nicht mehr weiss, was die einzelnen Variablen für eine Bedeutung haben bzw. wo man überall darauf zugreift (Fehlerquote erhöht sich). | |
| 229 | 209 | ||
| 230 | 210 | Besser ist es lokale Variablen zu nutzen, diese als [[Object Oriented Programming with Free Pascal and Lazarus|Property]] in einer [[Class/de|Klasse]] oder hilfsweise als Variable in einer Klasse zu definieren und auf diese zuzugreifen.\ | |
| 231 | - | ||
| 211 | + | ||
| 232 | 212 | Im nachfolgenden Projekt wird per Buttonklick ein zweites Formular geöffnet. Dabei wird in der Unit des Hauptformulars gezählt, wie oft dieses angezeigt wurde. In diesem zweiten Formular können Sie sich per Buttonklick zeigen lassen, wie oft es geöffnet wurde: | |
| 233 | 213 | ||
| 234 | 214 | - erstellen Sie ein neues Projekt mit zwei Formularen, jeweils ein Button darauf und die Eventhandler zu deren OnClick-Events | |
| 235 | 215 | ||
| 236 | 216 | - nun erstellen Sie im [[Class/de|Public-Teil]] der [[Class/de|Klasse]] *TForm2* (Unit2) eine Variable (in diesem Fall eine [[Const/de|Konstante]], die Sie als definierte Variable missbrauchen) vom Typ Integer mit dem Namen *Zaehler*: | |
| 237 | 217 | ||
| 238 | 218 | ``` pascal | |
| 239 | 219 | unit Unit2; | |
| 240 | 220 | ... | |
| 241 | 221 | TForm2 = class(TForm) | |
| 242 | 222 | Button1: TButton; | |
| 243 | 223 | procedure Button1Click(Sender: TObject); | |
| 244 | 224 | private | |
| 245 | 225 | { private declarations } | |
| 246 | 226 | public | |
| 247 | 227 | { public declarations } | |
| 248 | 228 | const Zaehler: Integer = 0; //hier Zaehler definieren | |
| 249 | 229 | end; | |
| 250 | 230 | ``` | |
| 251 | 231 | ||
| 252 | 232 | - jetzt müssen noch die Button-Eventhandler entsprechend anpassen: | |
| 253 | 233 | ||
| 254 | 234 | ``` pascal | |
| 255 | 235 | unit Unit1; | |
| 256 | 236 | ... | |
| 257 | 237 | procedure TForm1.Button1Click(Sender: TObject); | |
| 258 | 238 | begin | |
| 259 | 239 | inc(Form2.Zaehler); //Bei jedem Aufruf von Form2 den Zähler um 1 erhöhen | |
| 260 | 240 | Form2.ShowModal; //Form2 anzeigen | |
| 261 | 241 | end; | |
| 262 | 242 | ``` | |
| 263 | 243 | ||
| 264 | 244 | ``` pascal | |
| 265 | 245 | unit Unit2; | |
| 266 | 246 | ... | |
| 267 | 247 | procedure TForm2.Button1Click(Sender: TObject); | |
| 268 | 248 | begin | |
| 269 | 249 | ShowMessage('Form2 wurde insgesamt '+IntToStr(Zaehler)+' mal aufgerufen'); | |
| 270 | 250 | end; | |
| 271 | 251 | ``` | |
| 272 | 252 | ||
| 273 | 253 | Auf diese Weise können Sie in *Unit1* auf alle in *Unit2* öffentlichen (public) Variablen/Properties/Funktionen/Proceduren (allgemein Methoden) zugreifen. | |
| 274 | 254 | ||
| 275 | 255 | ## Sonstiges im Umgang mit Formularen | |
| 276 | 256 | ||
| 277 | 257 | ### Anderes Formular als HauptFormular verwenden | |
| 278 | 258 | ||
| 279 | 259 | Stellen Sie nach einer Weile fest, dass Sie lieber ein anderes oder ein neues Formular zur Ansicht beim Programmstart angezeigt haben wollen, können Sie, unter dem Mainmenu Projekt -\> Projekteinstellungen -\> Formulare, die Reihenfolge der Formulare ändern: | |
| 280 | 260 | ||
| 281 | - | ||
| 282 | - | ||
| 283 | - | ||
| 284 | - | ||
| 261 | + |  | |
| 285 | 262 | ||
| 286 | 263 | Alternativ können Sie sich, unter Hauptmenu Projekt -\> .lpr-Datei anzeigen, die Projekt.lpr (Pascal-Quelltext des Hauptprogramms) anzeigen lassen und dort das zuerst anzuzeigende Formular als erstes erstellen lassen: | |
| 287 | 264 | ||
| 288 | 265 | ``` pascal | |
| 289 | 266 | program Project1; | |
| 290 | 267 | ... | |
| 291 | 268 | Application.CreateForm(TForm2, Form2); //Form2 wird als erstes erstellt und damit beim Start der Anwendung gezeigt | |
| 292 | 269 | Application.CreateForm(TForm1, Form1); | |
| 293 | 270 | ``` | |
| 294 | 271 | ||
| 295 | 272 | ### Eigenschaft eines Formulars bei Programmende speichern | |
| 296 | 273 | ||
| 297 | 274 | Bei manchen Anwendungen ist es schön, wenn die vom User geänderte Einstellungen bezüglich Position und Größe des Formulars bei Programmende gespeichert werden und bei Programmstart wieder so hergestellt werden. Dafür stellt Ihnen Lazarus von Haus aus eine recht einfache Möglichkeit mittels [[TXMLPropStorage/de|TXMLPropStorage]] oder [[TINIPropStorage/de|TIniPropStorage]] zur Verfügung. | |
| 298 | 275 | ||
| 299 | 276 | Ein einfaches Beispiel soll die Funktionsweise verdeutlichen: | |
| 300 | 277 | ||
| 301 | 278 | - neue Anwendung erstellen (Hauptmenu Projekt -\> Neues Projekt -\> Anwendung) | |
| 302 | 279 | - eine TXMLPropStorage Komponente auf das Formular ablegen (Zu finden ist sie auf dem Tab Misc in der Komponentenpalette) | |
| 303 | 280 | ||
| 304 | - | ||
| 305 | - | ||
| 306 | - | ||
| 307 | - | ||
| 281 | + |  | |
| 308 | 282 | ||
| 309 | 283 | - im Objektinspektor: XMLPropStorage1 -\> FileName auf z.B. "session.xml" setzen | |
| 310 | 284 | - im Objektinspektor: Form1 -\> SessionProperties bearbeiten (einfach den Button \[...\] anklicken) | |
| 311 | 285 | - nun jeweils die Properties Left;Top;Width;Height von der *Komponente Form1* auswählen und den *Selected Properties* hinzufügen | |
| 312 | 286 | - mit OK bestätigen und Projekt starten, das Formular in der Größe verändern und verschieben, beim nächsten Start hat es wieder diese Einstellung | |
| 313 | 287 | ||
| 314 | 288 | Weitere Informationen unter [[TXMLPropStorage/de|TXMLPropStorage]] | |
| 315 | 289 | ||
| 316 | 290 | ## Formular dynamisch erzeugen | |
| 317 | 291 | ||
| 318 | 292 | ### Von Lazarus designtes Formular dynamisch erstellen | |
| 319 | 293 | ||
| 320 | 294 | Sie müssen nicht alle Formulare, die während der Laufzeit einer Anwendung möglicherweise aufgerufen werden, immer bei Programmstart erstellen lassen. Manche Entwickler halten generell nichts davon und löschen den, bei Einfügen eines neuen Formulars in ein Projekt automatisch erstellten, Code aus der Projekt.lpr sofort heraus. Sobald Sie z.B. eine Library schreiben wollen, die ein paar GUIs enthält, kommen Sie um die dynamische Erstellung von Formularen nicht herum. | |
| 321 | 295 | ||
| 322 | 296 | Ein Beispiel: | |
| 323 | 297 | ||
| 324 | 298 | - erstellen Sie ein neue Anwendung mit zwei Formularen, fügen *Form1* einen TButton hinzu und nehmen in die Uses-Klausel von *Unit1*, "Unit2" mit auf | |
| 325 | 299 | - öffnen Sie die Projekt.lpr (Projekt -\> .lpr-Datei anzeigen) | |
| 326 | 300 | - löschen Sie die Zeile " Application.CreateForm(TForm2, Form2);" | |
| 327 | 301 | - im OnClick-Ereignis von *Form1 Button1* müssten Sie folgenden Code einfügen: | |
| 328 | 302 | ||
| 329 | 303 | ``` pascal | |
| 330 | 304 | procedure TForm1.Button1Click(Sender: TObject); | |
| 331 | 305 | begin | |
| 332 | 306 | Form2:=TForm2.Create(Nil); //Form2 wird erstellt | |
| 333 | 307 | Form2.ShowModal; //Form2 wird angezeigt | |
| 334 | 308 | FreeAndNil(Form2); //Form2 wieder freigeben | |
| 335 | 309 | end; | |
| 336 | 310 | ``` | |
| 337 | 311 | ||
| 338 | 312 | - nun können Sie die Anwendung starten | |
| 339 | 313 | ||
| 340 | 314 | ### Neues Formular dynamisch erstellen | |
| 341 | 315 | ||
| 342 | 316 | Folgendes Beispiel soll demonstrieren, wie neue Formulare per Hand, ohne den Formulardesigner, erzeugt werden können. | |
| 343 | 317 | ||
| 344 | 318 | Mit einem Buttonklick soll sich ein weiteres Formular öffnen, das einen Button enthält, bei dessen Klick eine Warnmeldung erscheint, dass sich das Formular schließen wird und daraufhin das Formular geschlossen wird. | |
| 345 | 319 | ||
| 346 | 320 | - erstellen Sie eine neue Anwendung mit einem Formular und einem Button | |
| 347 | 321 | - im OnClick-Ereignis von *Form1 Button1* müssen Sie folgenden Code einfügen: | |
| 348 | 322 | ||
| 349 | 323 | ``` pascal | |
| 350 | 324 | procedure TForm1.Button1Click(Sender: TObject); | |
| 351 | 325 | var | |
| 352 | 326 | MyForm: TForm; | |
| 353 | 327 | MyButton: TButton; | |
| 354 | 328 | begin | |
| 355 | 329 | MyForm:=TForm.Create(nil); // Formular erzeugen | |
| 356 | 330 | MyForm.SetBounds(100, 100, 220, 150); // Größe des Formulars | |
| 357 | 331 | MyForm.Caption:='Mein dynamisch erstelltes Formular'; | |
| 358 | 332 | ||
| 359 | 333 | MyButton:=TButton.create(MyForm); // Den Button erstellen, der Owner wird MyForm | |
| 360 | 334 | MyButton.Caption:='Schließe meines Formulars'; | |
| 361 | 335 | MyButton.SetBounds(10, 10, 200, 30); | |
| 362 | 336 | MyButton.Parent:=MyForm; // Festlegen, auf welchem Formular der Button platziert wird | |
| 363 | 337 | ||
| 364 | 338 | MyButton.OnClick:=@MyButtonClick; // Wird gleich noch erstellt... | |
| 365 | 339 | ||
| 366 | 340 | MyForm.ShowModal; // MyForm anzeigen | |
| 367 | 341 | ||
| 368 | 342 | FreeAndNil(MyForm); // MyForm (und MyButton) wieder freigeben | |
| 369 | 343 | end; | |
| 370 | 344 | ``` | |
| 371 | 345 | ||
| 372 | 346 | > **Note:** Wenn eine Komponente mit einem Owner erzeugt wurde (TButton.Create(Owner: TComponent)), gehört sie dem Owner, der dann dafür zuständig ist,\ | |
| 373 | 347 | > die Komponente freizugeben. Somit wird MyButton bei der Freigabe von MyForm automatisch mit freigegeben. | |
| 374 | 348 | ||
| 375 | 349 | - jetzt müssen Sie noch der Eventhandler von MyButtonClick erstellen | |
| 376 | 350 | - dazu im private-Abschnitt der Klasse *TForm1* folgende Procedure hineinschreiben und \[Strg\]+\[Shift\]+\[C\] (Codevervollständigung) drücken: | |
| 377 | 351 | ||
| 378 | 352 | ``` pascal | |
| 379 | 353 | TForm1 = class(TForm) | |
| 380 | 354 | ... | |
| 381 | 355 | private | |
| 382 | 356 | { private declarations } | |
| 383 | 357 | procedure MyButtonClick(Sender: TObject); | |
| 384 | 358 | ``` | |
| 385 | 359 | ||
| 386 | 360 | - und folgenden Code dort einfügen: | |
| 387 | 361 | ||
| 388 | 362 | ``` pascal | |
| 389 | 363 | procedure TForm1.MyButtonClick(Sender: TObject); | |
| 390 | 364 | begin | |
| 391 | 365 | Showmessage('Achtung, mein dynamisch erstelltes Formular wird geschlossen!'); | |
| 392 | 366 | if Sender is TButton then | |
| 393 | 367 | TForm(TButton(Sender).Parent).Close; | |
| 394 | 368 | end; | |
| 395 | 369 | ``` | |
| 396 | 370 | ||
| 397 | 371 | - nun können Sie das Projekt kompilieren und starten | |
| 398 | 372 | ||
| 399 | 373 | Ein paar Tipps für die [[LCL Tips/de|manuelle Erzeugung von Bedienelementen]] | |
| 400 | 374 | ||
| 401 | 375 | ## Weitere Informationen | |
| 402 | 376 | ||
| 403 | 377 | - [[LCL Tips/de|Beispiel, wie Sie eine komplette GUI Anwendung per Code erstellen können]] | |
| 404 | 378 | - [[Testing, if form exists/de|Testen, ob ein Formular existiert]] | |
| 405 | 379 | - [[Canvas draw vertical line on form/de|Eine vertikale Line auf einem Formular zeichnen]] | |
| 406 | 380 | - [[Drawing with canvas/de|Mit Canvas auf einem Formular zeichnen]] | |
| 407 | 381 | - [[user should not be able to close form/de|Verhindern, dass ein Anwender das Formular schliessen kann]] | |
| 408 | 382 | - [[LCL Tips/de|Ein nicht-rechteckiges Fenster oder Steuerelement erstellen]] | |
| 409 | 383 | ||
| 410 | 384 | --- | |
| 411 | 385 | *From the Free Pascal wiki, page "Form Tutorial/de", as it stood on 2020-02-15 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |