QStyleHints Class

Dokumentation der Eigenschaften

[since 6.5] colorScheme : Qt::ColorScheme

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

Standardmäßig folgt dies dem Standardfarbschema des Systems (auch als Erscheinungsbild bekannt) und ändert sich, wenn sich das Farbschema des Systems ändert (z. B. während der Abend- oder Morgendämmerung). Wenn Sie das Farbschema auf einen expliziten Wert setzen, wird die Systemeinstellung außer Kraft gesetzt und Änderungen am Farbschema des Systems werden ignoriert. Dies ist jedoch ein Hinweis an das System, und das Überschreiben des Farbschemas wird nicht auf allen Plattformen unterstützt.

Wenn Sie diese Eigenschaft zurücksetzen oder sie auf Qt::ColorScheme::Unknown setzen, wird die Überschreibung aufgehoben und die Anwendung folgt wieder der Systemvorgabe. Der Eigenschaftswert ändert sich in das Farbschema, das das System aktuell hat.

Wenn sich diese Eigenschaft ändert, liest Qt die Systempalette und aktualisiert die Standardpalette, überschreibt aber nicht die Paletteneinträge, die explizit von der Anwendung gesetzt wurden. Wenn das Signal colorSchemeChange() ausgegeben wird, ist die alte Palette noch in Kraft.

Anwendungsspezifische Farben sollten so gewählt werden, dass sie gut mit der effektiven Palette zusammenarbeiten, wobei das aktuelle Farbschema berücksichtigt wird. Um anwendungsspezifische Farben zu aktualisieren, wenn sich die effektive Palette ändert, behandeln Sie PaletteChange oder ApplicationPaletteChange Ereignisse.

Diese Eigenschaft 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 es unter Windows das Ereignis zum Loslassen der Maustaste ist. Diese Eigenschaft kann verwendet werden, um das Standardverhalten der Plattform zu überschreiben.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch Qt::ContextMenuTrigger.

[read-only] cursorFlashTime : const int

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

Die Blinkzeit ist die Zeit, die zum Anzeigen, Invertieren und Wiederherstellen der Cursoranzeige verwendet wird. Normalerweise wird der Textcursor für die Hälfte der Blinkzeit des Cursors angezeigt und dann für die gleiche Zeit ausgeblendet.

Zugriffsfunktionen:

Melder-Signal:

[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 enthält die Rate in Ereignissen pro Sekunde, in der zusätzliche wiederholte Tastendrücke automatisch erzeugt werden, wenn eine Taste gedrückt wird.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Zugriffsfunktionen:

[read-only] keyboardInputInterval : const int

Diese Eigenschaft enthält die Zeitgrenze in Millisekunden, die einen Tastendruck von zwei aufeinanderfolgenden Tastendrücken unterscheidet.

Zugriffsfunktionen:

Melder-Signal:

[read-only] mouseDoubleClickDistance : const int

Diese Eigenschaft enthält den maximalen Abstand in Pixeln, den die Maus zwischen zwei aufeinanderfolgenden Mausklicks bewegt werden kann, ohne dass dies als Doppelklick erkannt wird.

Zugriffsfunktionen:

[read-only] mouseDoubleClickInterval : const int

Diese Eigenschaft enthält die Zeitgrenze in Millisekunden, die einen Doppelklick von zwei aufeinanderfolgenden Mausklicks unterscheidet.

Zugriffsfunktionen:

Melder-Signal:

[read-only] mousePressAndHoldInterval : const int

Diese Eigenschaft enthält das Zeitlimit in Millisekunden, das ein Drücken und Halten auslöst.

Zugriffsfunktionen:

Melder-Signal:

mouseQuickSelectionThreshold : const int

Schnellauswahl-Mausschwelle in QLineEdit.

Diese Eigenschaft legt fest, wie weit der Mauszeiger entlang der y-Achse bewegt werden muss, um eine Schnellauswahl während einer normalen QLineEdit Textauswahl auszulösen.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] passwordMaskCharacter : const QChar

Diese Eigenschaft enthält das Zeichen, das verwendet wird, um die in Texteingabefelder im Kennwortmodus eingegebenen Zeichen zu maskieren.

Zugriffsfunktionen:

[read-only] passwordMaskDelay : const int

Diese Eigenschaft gibt die Zeit in Millisekunden an, in der ein getippter Buchstabe in einem Texteingabefeld im Passwortmodus unverhüllt angezeigt wird.

Zugriffsfunktionen:

[read-only] setFocusOnTouchRelease : const bool

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

Diese Eigenschaft ist true, wenn Fokusobjekte (Zeilenbearbeitungen usw.) den Eingabefokus nach einer Berührung/Mausfreigabe erhalten sollen. Dies ist das normale Verhalten auf Touch-Plattformen. Auf Desktop-Plattformen ist es Standard, den Fokus bereits bei Berührung/Mausdruck 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 Fenster im Vollbildmodus anzeigt, andernfalls false.

Zugriffsfunktionen:

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

[read-only] showIsMaximized : const bool

Diese Eigenschaft legt fest, ob die Plattform standardmäßig maximierte Fenster verwendet.

Diese Eigenschaft ist true, wenn die Plattform standardmäßig Fenster in maximierter Größe 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 Standardeinstellung der Plattform außer Kraft zu setzen.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch Qt::AA_DontShowShortcutsInContextMenus.

[read-only] singleClickActivation : const bool

Diese Eigenschaft gibt an, ob Elemente durch Einfach- oder Doppelklick aktiviert werden.

Diese Eigenschaft ist true, wenn Elemente durch einfachen Klick aktiviert werden sollen, false, wenn sie stattdessen durch Doppelklick aktiviert werden sollen.

Zugriffsfunktionen:

[read-only] startDragDistance : const int

Diese Eigenschaft gibt die Entfernung in Pixeln an, die die Maus bei gedrückter Taste zurückgelegt werden muss, bevor ein Drag&Drop-Vorgang gestartet wird.

Wenn Sie in Ihrer Anwendung Drag&Drop unterstützen und einen Drag&Drop-Vorgang starten möchten, nachdem der Benutzer den Cursor bei gedrückter Taste über eine bestimmte Distanz bewegt hat, sollten Sie den Wert dieser Eigenschaft als Mindestabstand verwenden.

Wenn z.B. die Mausposition des Klicks in startPos gespeichert ist und die aktuelle Position (z.B. im Mausbewegungsereignis) currentPos ist, können Sie mit Code wie diesem herausfinden, ob ein Ziehen gestartet werden soll:

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

Zugriffsfunktionen:

Benachrichtigungssignal:

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

[read-only] startDragTime : const int

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

Wenn Sie in Ihrer Anwendung Drag&Drop unterstützen und einen Drag&Drop-Vorgang 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:

Benachrichtigungssignal:

Siehe auch startDragDistance und Drag and Drop.

[read-only] startDragVelocity : const int

Diese Eigenschaft gibt die Höchstgeschwindigkeit in Pixeln pro Sekunde an, mit der die Maus bei gedrückter Taste bewegt werden darf, um einen Drag&Drop-Vorgang zu starten. Ein Wert von 0 bedeutet, dass es keine solche Grenze gibt.

Zugriffsfunktionen:

Siehe auch startDragDistance und Ziehen und Ablegen.

[read-only] tabFocusBehavior : const Qt::TabFocusBehavior

Diese Eigenschaft bestimmt das Verhalten des Fokus beim Drücken der Tabulator-Taste.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] touchDoubleTapDistance : const int

Diese Eigenschaft gibt die maximale Entfernung in Pixeln an, die ein Finger zwischen zwei aufeinanderfolgenden Antippen bewegt werden kann, ohne dass dies als Doppeltippen erkannt wird.

Zugriffsfunktionen:

useHoverEffects : bool

Diese Eigenschaft gibt an, ob UI-Elemente Hover-Effekte verwenden.

Diese Eigenschaft ist true, wenn UI-Elemente Hover-Effekte verwenden sollen. Dies ist das Standardverhalten auf Desktop-Plattformen mit einem Mauszeiger, während auf Touch-Plattformen der Overhead der Hover-Ereignisübermittlung 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, ansonsten false.

Zugriffsfunktionen:

[read-only] wheelScrollLines : const int

Anzahl der Zeilen, die standardmäßig bei jedem Mausklick durchlaufen werden.

Zugriffsfunktionen:

Benachrichtigungssignal: