2.347.1 checkbox, image, listview, menuitem und menusep

checkbox

Das Attribut .style bestimmt, ob die checkbox zwei oder drei Zustände annehmen kann.

Beim Schreibzugriff (set) können Werte vom Datentyp integer und class/enum angegeben werden. Lesezugriff (get) liefert immer einen Wert vom Datentyp integer.

Wertebereich

2 | checkbox

Die Checkbox kann die beiden Zustände an und aus annehmen.

Ihr Zustand kann über das Attribut .active abgefragt und gesetzt werden.

Interaktive Zustandsänderungen durch den Anwender lösen activate- bzw. deactivate-Ereignisse aus.

3 | tristate

Die Checkbox kann die drei Zustände an, aus und unbestimmt annehmen.

Ihr Zustand kann über das Attribut .state abgefragt und gesetzt werden.

Interaktive Zustandsänderungen durch den Anwender lösen keine activate- bzw. deactivate-Ereignisse aus.

Beim Setzen des Wertes 3 wird die Checkbox im Zustand unbestimmt dargestellt.

image (Bild)

Mit dem Attribut .style kann beim image-Objekt eingestellt werden, dass es zwei Zustände darstellen kann oder – unter Microsoft Windows – bei Mausklick ein Kontextmenü öffnet. Damit lässt sich das Objekt als individuelle Checkbox oder als bebildertes Menüelement verwenden.

Beim Schreibzugriff (set) können Werte vom Datentyp integer und class angegeben werden. Lesezugriff (get) liefert immer einen Wert vom Datentyp integer.

Wertebereich

0 | pushbutton

Das image-Objekt ist wie ein Pushbutton selektierbar.

2 | checkbox

Das image-Objekt kann zwischen den Zuständen aktiv und inaktiv umgeschaltet werden.

Jedem Zustand kann mit dem Attribut .picture[enum] ein eigenes Bild (tile-Ressource) zugeordnet werden.

3 | menubox

Das image-Objekt hat das Verhalten einer menubox. Bei einem Mausklick wird das Kontextmenü geöffnet. In diesem Stil wird kein select-Ereignis erzeugt.

Bei geöffnetem Kontextmenü werden die Bilder .picture[tile_active] bzw. .picture[tile_active_mouse_over] angezeigt.

Ist kein Kontextmenü vorhanden, wird keine Menüaktion ausgelöst. Der Zustand des image-Objekts wird dennoch entsprechend angepasst und das zum Zustand gehörende Bild aus dem .picture[enum]-Attribut angezeigt.

Der genaue Ablauf der Aktion ist abhängig vom jeweiligen Fenstersystem. Auch die Behandlung des Fokus erfolgt so, wie es für Menüs auf dem jeweiligen Fenstersystem üblich ist.

Verfügbarkeit

Nur Microsoft Windows.

listview

Dieses Attribut bestimmt die Darstellungsart des listviews.

Beim Schreibzugriff (set) können Werte vom Datentyp integer, string und text-Ressourcen angegeben werden. text-Ressourcen werden automatisch zu string gewandelt.

Lesezugriff (get) liefert immer einen Wert vom Datentyp integer.

Wertebereich

0 | "icon" | "picture"

Symbolansicht mit großen Symbolen.

Anordnung der Listeneinträge zuerst von links nach rechts, dann von oben nach unten.

Das Symbol wird über der Beschriftung des Eintrags angezeigt.

1 | "smallicon" | "smallpicture"

Symbolansicht mit kleinen Symbolen.

Anordnung der Listeneinträge zuerst von links nach rechts, dann von oben nach unten.

Das Symbol wird links von der Beschriftung des Eintrags angezeigt.

2 | "list"

Listenansicht mit kleinen Symbolen.

Anordnung der Listeneinträge zuerst von oben nach unten, dann von links nach rechts.

Das Symbol wird links von der Beschriftung des Eintrags angezeigt.

3 | "detail" | "report"

Liste mit kleinen Symbolen, bei der die Listeneinträge untereinander angeordnet werden.

Links neben der Beschriftung wird ein kleines Symbol angezeigt.

Zu jedem Listeneintrag werden Detailinformationen in mehreren Spalten angezeigt.

Die Darstellung ähnelt einer Tabelle.

4 | "tile"

Darstellung der Listeneinträge als Kacheln mit großem Symbol links sowie Beschriftung rechts.

Anordnung der Listeneinträge untereinander.

Bei ungültigen Werten wird der Standardwert 0 verwendet. Der Attributwert wird allerdings nicht geändert.

menuitem (Menüeintrag)

Das Attribut definiert die Art des Menüeintrags.

Beim Schreibzugriff (set) können Werte vom Datentyp integer und class angegeben werden. Lesezugriff (get) liefert immer einen Wert vom Datentyp integer.

Bei menuitems, die direktes Kind eines Fensters sind, wird das .style-Attribut ingnoriert.

Wertebereich

0 | pushbutton

Normaler Menüeintrag, der üblicherweise zum Auslösen einer Aktion verwendet wird.

1 | radiobutton

Menüeintrag mit zwei Zuständen und dem Verhalten eines Radiobuttons.

Im Allgemeinen werden mehrere Menüeintrage dieses Stils verwendet, um über das Menü eine von mehreren sich gegenseitig ausschließenden Optionen auszuwählen.

Eine Gruppe von menuitems mit .style = radiobutton, in der jeweils nur einer der Menüeinträge aktiviert sein kann, wird durch den Menüanfang, das Menüende oder Menüseparatoren begrenzt.

2 | checkbox

Menüeintrag mit zwei Zuständen und dem Verhalten einer Checkbox, der in der Regel dazu verwendet wird über das Menü eine Einstellung vorzunehmen.

menusep (Menüseparator)

Das Attribut definiert das Aussehen der Menütrennlinie.

Wertebereich

0

Standard-Trennlinie des jeweiligen Fenstersystems.

1

Einfache Linie.

2

Doppelte Linie.

Hinweis zum IDM für Windows

Das .style-Attribut des Menüseparators wird vom IDM für Windows ignoriert.

2.347.2 datetime, poptext und toolbar

datetime

Das Attribut bestimmt das Aussehen und die Art der Bedienung des datetime-Objekts.

Wertebereich

poptext

Zum Auswählen eines Datums kann ein Kalender geöffnet werden.

spinbox

Werte können über eine Spinbox eingestellt werden.

Hinweis

Das Ändern des Attributs im sichtbaren Zustand führt zu einem Zurücksetzen des Objekts und sollte vermieden werden.

poptext (Combobox)

Beim poptext bestimmt das .style-Attribut wie die Liste dargestellt wird und ob der Inhalt des Eingabefelds vom Anwender bearbeitet werden kann.

Wertebereich

edittext

Die Liste ist geschlossen und kann vom Anwender auf- und zugeklappt werden. Der Inhalt des Eingabefelds lässt sich bearbeiten.

Der Anwender kann einen vorhanden Eintrag aus der Liste auswählen oder einen anderen Wert eingeben.

listbox

Die Liste ist immer geöffnet und der Inhalt des Eingabefelds lässt sich bearbeiten.

Der Anwender kann einen vorhanden Eintrag aus der Liste auswählen oder einen anderen Wert eingeben.

poptext

Die Liste ist geschlossen und kann vom Anwender auf- und zugeklappt werden. Der Inhalt des Eingabefelds lässt sich nicht bearbeiten.

Der Anwender kann nur einen Eintrag auswählen, der bereits in der Liste vorhanden ist.

toolbar

Die toolbar kann unter Qt zwei unterschiedliche Ausprägungen haben, die über das Attribut .style eingestellt werden. Standardmäßig ist der Stil toolbar aktiv, der optisch den bekannten Toolbars entspricht.

Wertebereich

notepage

Toolbars verwenden einen Dock-Bereich, der zwischen Toolbars und innerem Bereich liegt. Tabbed Toolbars und Nested Toolbars sind möglich.

toolbar

Herkömmliche Toolbar, entsprechend der bekannten IDM-Toolbar.

Der Stil notepage erlaubt ein Verschachteln mehrerer toolbars in einem Dockbereich und ihre Anordnung in Form von Registerkarten (siehe Kapitel „Besonderheiten des Fensters unter Qt“ beim Objekt window in der „Objektreferenz“ für die entsprechenden Steuerungsoptionen). Die Toolbars haben dann eine Titelzeile und können über ihre Titelschaltflächen ausgedockt und geschlossen werden.

toolbars unterschiedlichen Stils, die im selben Dockbereich definiert werden, können nicht gemischt werden und werden entsprechend ihrem Stil gruppiert angeordnet. Dabei werden Toolbars mit dem Stil toolbar immer am äußeren Fensterrand positioniert und Toolbars mit dem Stil notepage immer zwischen dem Clientbereich des Fensters und den Toolbars mit dem Stil toolbar (siehe „Abbildung 1-2“).

Verfügbarkeit

Das Attribut .style wird bei der toolbar nur vom IDM für Qt unterstützt.

Siehe auch

Objekte toolbar, window

Attribut .options[enum]

2.347.3 filereq (Filerequestor)

Das Attribut bestimmt den angezeigten System-Dialog und damit den Verwendungszweck (Modus) des Filerequestors.

Wertebereich

fr_directory

System-Dialog zur Auswahl eines Verzeichnisses.

fr_load

System-Dialog zum Öffnen von Dateien.

fr_save

System-Dialog zum Speichern von Dateien.

Besonderheiten des IDM für Windows

Für die verschiedenen Modi werden unterschiedliche Systemdialoge verwendet. Deren Merkmale wie Beschriftung (z.B. der Schaltflächen), Farbe und Font sind überwiegend für den jeweiligen Verwendungszweck vorgegeben und nicht redefinierbar.

Der Modus fr_directory ist restriktiver in der Behandlung der Attribute .directory und .pattern. Außerdem erlaubt er keine Eingabe eines noch nicht vorhandenen Verzeichnisses.

2.347.4 font

Bei der font-Ressource bestimmt das Attribut .style, welcher Schriftstil (Schriftschnitt) des ausgewählten Zeichensatzes verwendet wird. Um bessere Unabhängigkeit und Kombinationen zwischen Face/Slant und Weight zu gewährleisten, wurde das Attribut .style auf die beiden Attribute .face und .weight umgestellt. Das .style-Attribute kann aber weiterhin verwendet werden.

Wertebereich

face_default

Normale, unveränderte Zeichendarstellung.

face_light

Leichgewichtige Zeichendarstellung.

face_normal

Normale, unveränderte Zeichendarstellung.

face_medium

Schriftstärke zwischen face_normal und face_demibold.

face_demibold

Schriftstärke zwischen medium und bold.

face_bold

Fette Zeichendarstellung.

face_black

Extra fette Zeichendarstellung.

face_italic

Kursive Zeichendarstellung.

Im Unterschied zu face_oblique werden meist spezielle, kursive Zeichen verwendet.

face_oblique

Geneigte, schräge Zeichendarstellung.

Im Unterschied zu face_italic werden die geneigten Zeichendarstellungen meist aus den regulären Zeichen abgeleitet.

face_oblique entspricht unter Microsoft Windows face_italic.

face_roman

Aufrechte, gerade Zeichendarstellung (wird unter Microsoft Windows ignoriert).

2.347.5 spinbox

Bei der spinbox definiert das Attribut .style die Art der angezeigten Werte.

Wertebereich

integer

Es werden die Zahlenwerte aus dem Intervall .minvalue … .maxvalue angezeigt.

Der aktuelle Wert kann mit dem Attribut .curvalue abgefragt und gesetzt werden.

string

Es werden die Texte aus dem Attribut .text[integer] angezeigt.

Der Index des aktuellen Wertes kann mit dem Attribut .activeitem abgefragt und gesetzt werden.

void

Die Anzeige im Kindobjekt wird von der Anwendung gesteuert.

Das Weiterschalten der Werte erfolgt wie bei .style = integer, allerdings wird der im Kindobjekt (edittext bzw. statictext) angezeigte Wert nicht automatisch geändert sondern muss von der Anwendung gesetzt werden.