QStyleHints Class

Dokumentation zu Eigenschaften

[read-only, since 6.10] accessibility : const QAccessibilityHints*

Diese Eigenschaft enthält die Barrierefreiheitshinweise der Anwendung.

Die Barrierefreiheitshinweise fassen plattformabhängige Barrierefreiheitseinstellungen zusammen, beispielsweise ob der Benutzer die Anwendung im Hochkontrastmodus nutzen möchte oder nicht.

Diese Enumeration wurde in Qt 6.10 eingeführt.

Zugriffsfunktionen:

Siehe auch QAccessibilityHints.

[since 6.5] colorScheme : Qt::ColorScheme

Diese Eigenschaft enthält das von der Anwendung verwendete Farbschema.

Standardmäßig folgt es dem Standardfarbschema des Systems (auch als „Darstellung“ bezeichnet) und ändert sich, wenn sich das Farbschema des Systems ändert (z. B. bei Sonnenuntergang oder Sonnenaufgang). Wird das Farbschema auf einen expliziten Wert gesetzt, wird die Systemeinstellung überschrieben und Änderungen am Farbschema des Systems ignoriert. Dies ist jedoch nur ein Hinweis für das System, und das Überschreiben des Farbschemas wird nicht auf allen Plattformen unterstützt.

Das Zurücksetzen dieser Eigenschaft oder das Setzen auf ` Qt::ColorScheme::Unknown` hebt die Überschreibung auf und sorgt dafür, dass die Anwendung wieder der Systemstandardpalette folgt. Der Wert der Eigenschaft ändert sich auf das aktuell vom System verwendete Farbschema.

Wenn sich diese Eigenschaft ändert, liest Qt die Systempalette ein und aktualisiert die Standardpalette, überschreibt jedoch keine Paletteneinträge, die von der Anwendung explizit festgelegt wurden. Wenn das Signal `colorSchemeChange()` ausgelöst wird, ist die alte Palette noch in Kraft.

Anwendungsspezifische Farben sollten so ausgewählt werden, dass sie gut mit der aktuellen Palette harmonieren, wobei das aktuelle Farbschema zu berücksichtigen ist. Um anwendungsspezifische Farben zu aktualisieren, wenn sich die aktuelle Palette ändert, sollten die Ereignisse ` PaletteChange ` oder ` ApplicationPaletteChange ` abgefangen werden.

Diese Aufzählung wurde in Qt 6.5 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ Qt::ColorScheme“ , „ QGuiApplication::palette()“ und „ QEvent::PaletteChange “.

[since 6.8] contextMenuTrigger : Qt::ContextMenuTrigger

Mausereignis, das zum Auslösen eines Kontextmenü-Ereignisses verwendet wird.

Auf UNIX-Systemen wird das Kontextmenü standardmäßig beim Drücken der Maustaste angezeigt, während dies unter Windows beim Loslassen der Maustaste geschieht. Mit dieser Eigenschaft lässt sich das standardmäßige Plattformverhalten überschreiben.

Diese Enumeration wurde in Qt 6.8 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ Qt::ContextMenuTrigger “.

[read-only] cursorFlashTime : int

Diese Eigenschaft enthält die Blinkdauer des Textcursors in Millisekunden.

Die Blinkdauer ist die Zeit, die zum Anzeigen, Invertieren und Wiederherstellen der Caret-Anzeige benötigt wird. In der Regel wird der Textcursor für die Hälfte der Cursor-Blinkdauer angezeigt und anschließend für die gleiche Zeit ausgeblendet.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] fontSmoothingGamma : const qreal

Diese Eigenschaft enthält den Gammawert, der bei der Schriftglättung verwendet wird.

Zugriffsfunktionen:

[read-only, since 6.5] keyboardAutoRepeatRateF : const qreal

Diese Eigenschaft gibt die Rate in Ereignissen pro Sekunde an, mit der zusätzliche wiederholte Tastenanschläge automatisch generiert werden, wenn eine Taste gedrückt gehalten wird.

Diese Aufzählung wurde in Qt 6.5 eingeführt.

Zugriffsfunktionen:

[read-only] keyboardInputInterval : int

Diese Eigenschaft gibt die Zeitgrenze in Millisekunden an, die einen Tastenanschlag von zwei aufeinanderfolgenden Tastenanschlägen unterscheidet.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only, since 6.10] menuSelectionWraps : const bool

Die Menüauswahl springt zurück an den Anfang.

Gibt „ true “ zurück, wenn die Menüauswahl umbricht. Das heißt, ob die Tasten-Navigation die Auswahl wieder zum ersten Menüpunkt bewegt, nachdem der letzte Menüpunkt erreicht wurde, und umgekehrt.

Diese Enumeration wurde in Qt 6.10 eingeführt.

Zugriffsfunktionen:

[read-only] mouseDoubleClickDistance : const int

Diese Eigenschaft gibt den maximalen Abstand in Pixeln an, um den die Maus zwischen zwei aufeinanderfolgenden Mausklicks bewegt werden kann, damit dies noch als Doppelklick erkannt wird

Zugriffsfunktionen:

[read-only] mouseDoubleClickInterval : int

Diese Eigenschaft gibt die Zeitgrenze in Millisekunden an, anhand derer ein Doppelklick von zwei aufeinanderfolgenden Mausklicks unterschieden wird.

Zugriffsfunktionen:

Notifier-Signal:

[read-only] mousePressAndHoldInterval : int

Diese Eigenschaft gibt die Zeitdauer in Millisekunden an, nach der ein „Drücken und Halten“ ausgelöst wird.

Zugriffsfunktionen:

Benachrichtigungssignal:

mouseQuickSelectionThreshold : int

Schwellenwert für die Schnellauswahl mit der Maus in „ QLineEdit “.

Diese Eigenschaft legt fest, um wie viel der Mauszeiger entlang der y-Achse verschoben werden muss, um bei einer normalen Textauswahl in „ QLineEdit “ die Schnellauswahl auszulösen.

Ist der Wert der Eigenschaft kleiner oder gleich 0, ist die Schnellauswahlfunktion deaktiviert.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] passwordMaskCharacter : const QChar

Diese Eigenschaft enthält das Zeichen, mit dem die in Texteingabefeldern im Passwortmodus eingegebenen Zeichen maskiert werden.

Zugriffsfunktionen:

[read-only] passwordMaskDelay : const int

Diese Eigenschaft gibt die Zeit in Millisekunden an, während der ein eingegebener Buchstabe in einem Texteingabefeld im Passwortmodus vollständig sichtbar angezeigt wird.

Zugriffsfunktionen:

[read-only] setFocusOnTouchRelease : const bool

Diese Eigenschaft enthält das Ereignis, das den Eingabefokus auf Fokusobjekte setzen soll.

Diese Eigenschaft ist auf „ true “ gesetzt, wenn Fokusobjekte (Eingabefelder usw.) den Eingabefokus erst nach dem Loslassen der Berührung oder der Maustaste erhalten sollen. Dies ist das normale Verhalten auf Touch-Plattformen. Auf Desktop-Plattformen ist es Standard, den Fokus bereits beim Berühren oder Klicken zu setzen.

Zugriffsfunktionen:

[read-only] showIsFullScreen : const bool

Diese Eigenschaft gibt an, ob die Plattform standardmäßig Vollbildfenster verwendet.

Diese Eigenschaft ist „ true “, wenn die Plattform standardmäßig Vollbildfenster verwendet, andernfalls „ false “.

Zugriffsfunktionen:

Siehe auch „ QWindow::show()“ und „ showIsMaximized()“.

[read-only] showIsMaximized : const bool

Diese Eigenschaft gibt an, ob die Plattform standardmäßig Fenster maximiert anzeigt.

Diese Eigenschaft ist „ true “, wenn die Plattform standardmäßig Fenster maximiert anzeigt, andernfalls „ false “.

Zugriffsfunktionen:

Siehe auch „ QWindow::show()“ und „ showIsFullScreen()“.

showShortcutsInContextMenus : bool

true wenn die Plattform normalerweise Tastenkombinationen in Kontextmenüs anzeigt, andernfalls ` false`.

Seit Qt 5.13 kann die Funktion `setShowShortcutsInContextMenus()` verwendet werden, um die Plattform-Standardeinstellung zu überschreiben.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch Qt::AA_DontShowShortcutsInContextMenus.

[read-only] singleClickActivation : const bool

Diese Eigenschaft legt fest, ob Elemente durch einen Einfach- oder Doppelklick aktiviert werden.

Diese Eigenschaft ist auf „ true “ gesetzt, wenn Elemente per Einzelklick aktiviert werden sollen, und auf „ false “, wenn sie stattdessen per Doppelklick aktiviert werden sollen.

Zugriffsfunktionen:

[read-only] startDragDistance : int

Diese Eigenschaft gibt die Entfernung in Pixeln an, um die die Maus bei gedrückter Taste bewegt werden muss, bevor ein Drag-and-Drop-Vorgang beginnt.

Wenn Sie Drag-and-Drop in Ihrer Anwendung unterstützen und einen Drag-and-Drop-Vorgang erst dann starten möchten, wenn der Benutzer den Cursor bei gedrückter Taste um eine bestimmte Strecke bewegt hat, sollten Sie den Wert dieser Eigenschaft als erforderliche Mindeststrecke verwenden.

Wenn beispielsweise die Mausposition des Klicks in ` startPos ` gespeichert ist und die aktuelle Position (z. B. im Mausbewegungsereignis) ` currentPos` lautet, können Sie mit folgendem Code feststellen, ob ein Drag-Vorgang gestartet werden soll:

if ((startPos - currentPos).manhattanLength() >=
        QApplication::startDragDistance())
    startTheDrag();

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ startDragTime“ , „ QPoint::manhattanLength()“ und „Drag and Drop“.

[read-only] startDragTime : int

Diese Eigenschaft gibt die Zeit in Millisekunden an, die eine Maustaste gedrückt gehalten werden muss, bevor ein Drag-and-Drop-Vorgang beginnt.

Wenn Sie Drag-and-Drop in Ihrer Anwendung unterstützen und einen Drag-and-Drop-Vorgang erst dann starten möchten, nachdem der Benutzer eine Maustaste eine bestimmte Zeit lang gedrückt gehalten hat, sollten Sie den Wert dieser Eigenschaft als Verzögerung verwenden.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ startDragDistance “ und „Drag & Drop“.

[read-only] startDragVelocity : const int

Diese Eigenschaft legt die Obergrenze für die Geschwindigkeit in Pixeln pro Sekunde fest, mit der die Maus bei gedrückter Taste bewegt werden darf, damit ein Drag-and-Drop-Vorgang gestartet wird. Der Wert 0 bedeutet, dass es keine solche Begrenzung gibt.

Zugriffsfunktionen:

Siehe auch „ startDragDistance “ und „Drag & Drop“.

[read-only] tabFocusBehavior : Qt::TabFocusBehavior

Diese Eigenschaft legt das Fokusverhalten beim Drücken der Tabulatortaste fest.

Zugriffsfunktionen:

Benachrichtigungssignal:

[since 6.12] toolTipWakeUpDelay : std::chrono::milliseconds

Diese Eigenschaft legt die Verzögerung fest, nach der Tooltips angezeigt werden sollen.

Diese Aufzählung wurde in Qt 6.12 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch QWidget::toolTip und QtQuick.Controls::ToolTip::delay.

[read-only, since 6.12] toolTipWakeUpDelayAsMSec : int

Diese Eigenschaft legt die Verzögerung in Millisekunden fest, nach der Tooltips angezeigt werden sollen.

Diese Enumeration wurde in Qt 6.12 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch toolTipWakeUpDelay und QtQuick.Controls::ToolTip::delay.

[read-only] touchDoubleTapDistance : const int

Diese Eigenschaft gibt den maximalen Abstand in Pixeln an, um den ein Finger zwischen zwei aufeinanderfolgenden Antippvorgängen bewegt werden kann, damit dies noch als Doppeltipp erkannt wird

Zugriffsfunktionen:

useHoverEffects : bool

Diese Eigenschaft legt fest, ob UI-Elemente Hover-Effekte verwenden.

Diese Eigenschaft ist auf „ true “ gesetzt, wenn UI-Elemente Hover-Effekte verwenden sollen. Dies ist das Standardverhalten auf Desktop-Plattformen mit einem Mauszeiger, während auf Touch-Plattformen der Mehraufwand durch die Auslösung von Hover-Ereignissen vermieden werden kann.

Zugriffsfunktionen:

Notifier-Signal:

[read-only] useRtlExtensions : const bool

Diese Eigenschaft gibt die Schreibrichtung an.

Diese Eigenschaft ist „ true “, wenn die Schreibrichtung von rechts nach links aktiviert ist, andernfalls „ false “.

Zugriffsfunktionen:

[read-only] wheelScrollLines : int

Anzahl der Zeilen, um die standardmäßig bei jedem Radklick gescrollt wird.

Zugriffsfunktionen:

Benachrichtigungssignal: