Inhaltsverzeichnis
18.3 SidePanel (gb.qt4)
Das Steuerelement SidePanel implementiert einen Container, der versteckt oder in der Größe verändert werden kann. Ein SidePanel wird entsprechend der Orientation-Eigenschaft angezeigt.
- Ein SidePanel wird ein- oder ausgeblendet, wenn der Benutzer auf eine der beiden kleinen Pfeiltasten an seiner Grenze klickt. Sie sehen die kleinen Pfeiltasten aber nur dann, wenn die Eigenschaft SidePanel.Transparent den Wert False hat.
- Ein SidePanel wird in seiner Größe kontinuierlich verändert, wenn der Benutzer auf der Grenze zwischen den Tasten klickt und mit gedrückter Maustaste die Maus bewegt.
Abbildung 18.3.1: Einsatzfeld Sidepanel in der Gambas-IDE
Bei den mit (1) und (2) bezeichneten Steuerelementen in der Gambas-IDE handelt es sich um 2 SidePanele mit unterschiedlichen Eigenschaften für SidePanel.Orientation. In den Kreisen sehen Sie die Griffe zum Verstecken oder Aufziehen des linken Sidepanel sowie dessen Tooltipp-Text 'Projekt'. Den Text sehen Sie aber nur, wenn das SidePanel auch angezeigt wird. Auch die Anzeige der Objekt-Eigenschaften und die Hierarchie der Objekte sind jeweils in ein SidePanel eingebettet.
18.3.1 Eigenschaften SidePanel
Ausgewählte Eigenschaften eines SidePanels werden in der folgenden Tabelle aufgeführt und beschrieben:
| Eigenschaft | Typ | Default | Beschreibung |
|---|---|---|---|
| Action | String | Null | Setzt den Aktionsstring oder gibt diesen zurück. Der Aktionswert ist True, wenn das Sidepanel sichtbar ist und False, wenn es versteckt ist. Bei einem SidePanel wird in Action.Value die Sichtbarkeit des SidePanels zurückgegeben → Action[„action-string“].Value |
| Border | Boolean | False | Setzt einen eingesunkenen Rand oder gibt den Rand-Wert zurück. |
| Hidden | Boolean | False | Gibt an, ob das Sidepanel versteckt ist oder nicht. |
| Orientation | Integer | 19 | Setzt den Wert der Ausrichtung 1) oder gibt diesen zurück. (Align.Top » 19) |
| Separator | Boolean | False | Gibt an, ob am Rand des Sidepanels ein Separator (hellgraue Linie) angezeigt wird oder nicht. |
| Settings | Variant[ ] | - | Gibt eine Zeichenkette zurück oder legt die Geometrie des SidePanel fest. Diese Eigenschaft wird von Settings.Write und Settings.Read zum Speichern und Abrufen der Geometrie des Steuerelements verwendet. |
| Transparent | Boolean | False | Ist SidePanel.Transparent = True, dann sehen Sie die kleine Pfeiltaste nur dann, wenn sich der Mauszeiger über dem Splitter befindet. |
| Value | Boolean | False | Diese Eigenschaft ist das genaue Gegenteil der Hidden-Eigenschaft. |
Tabelle 18.3.1.1: Ausgewählte Eigenschaften des Steuerelementes SidePanel
18.3.2 Ereignisse SidePanel
- Hide: Das Ereignis wird ausgelöst, nachdem das SidePanel ausgeblendet wurde.
- Show: Das Ereignis wird ausgelöst, kurz bevor das SidePanel angezeigt wird.
- Resize: Das Ereignis wird ausgelöst, wenn das SidePanel in der Größe geändert wird.
18.3.3 Beispiel
Im folgenden Beispiel wird das SidePanel beim Programm-Start links angezeigt (mit PictureBox) und kann dann aus- oder eingeblendet werden:
Abbildung 18.3.3.1: Sidepanel → Show
Abbildung 18.3.3.1: Sidepanel → Hide
Ein kleines Projekt, das den Einsatz eines SidePanels zeigt, finden Sie als Archiv im Download-Bereich.