QStyleHints Class

プロパティ・ドキュメント

[since 6.5] colorScheme : Qt::ColorScheme

このプロパティは、アプリケーションが使用する配色を保持します。

デフォルトでは、これはシステムのデフォルトの配色(外観としても知られている)に従い、システムの配色が変更されると変更されます(例えば、夕暮れや夜明けの間)。カラースキームを明示的な値に設定すると、システムの設定が上書きされ、システムのカラースキームの変更は無視されます。しかし、これはシステムに対するヒントであり、配色の上書きはすべてのプラットフォームでサポートされているわけではありません。

このプロパティをリセットするか、Qt::ColorScheme::Unknown に設定すると、オーバーライドが解除され、アプリケーションは再びシステムのデフォルトに従うようになります。プロパティの値は、システムが現在持つ配色に変更されます。

このプロパティが変更されると、Qt はシステム・パレットを読み込んでデフォルト・パレットを更新しますが、アプリケーションが明示的に設定したパレット・エントリを上書きすることはありません。colorSchemeChange()シグナルが発せられると、古いパレットが有効になります。

アプリケーション固有の色は、現在の配色を考慮して、有効なパレットでうまく動作するように選択する必要があります。有効パレットが変更されたときにアプリケーション固有の色を更新するには、PaletteChange またはApplicationPaletteChange イベントを処理します。

このプロパティはQt 6.5で導入されました。

アクセス関数

Notifier シグナル：

Qt::ColorScheme 、QGuiApplication::palette()、QEvent::PaletteChangeも参照してください 。

[since 6.8] contextMenuTrigger : Qt::ContextMenuTrigger

コンテキストメニューイベントのトリガーに使われるマウスイベント。

UNIXシステムでのデフォルトは、マウス・ボタン押下イベントでコンテキスト・メニューを表示し、Windowsではマウス・ボタン離しイベントです。このプロパティを使用すると、デフォルトのプラットフォームの動作をオーバーライドすることができます。

このプロパティは Qt 6.8 で導入されました。

アクセス関数

Notifier シグナル：

Qt::ContextMenuTriggerも参照してください 。

[read-only] cursorFlashTime : const int

このプロパティは、テキストカーソルのフラッシュ（点滅）時間をミリ秒単位で保持する。

点滅時間は、キャレット表示の表示、反転、復元に使用される時間である。通常、テキストカーソルはカーソルフラッシュタイムの半分の時間表示され、その後同じ時間非表示になる。

アクセス機能：

ノーティファイア信号

[read-only] fontSmoothingGamma : const qreal

このプロパティは、フォントスムージングに使用されるガンマ値を保持する。

アクセス関数：

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

このプロパティは、キーが押下されたままになっている場合に、追加のキー反復押下が自動的に生成されるレートを、1秒あたりのイベント数で保持します。

このプロパティは Qt 6.5 で導入されました。

アクセス関数です：

[read-only] keyboardInputInterval : const int

このプロパティは、1回のキー押下と2回連続のキー押下を区別するための制限時間をミリ秒単位で保持する。

アクセス関数：

ノーティファイアシグナル

[read-only] mouseDoubleClickDistance : const int

このプロパティは、連続する2回のマウスクリックの間にマウスを移動させても、ダブルクリックとして検出される最大距離をピクセル単位で保持します。

アクセス関数：

[read-only] mouseDoubleClickInterval : const int

このプロパティは、ダブルクリックと連続した2回のマウスクリックを区別する制限時間をミリ秒単位で保持する。

アクセス関数

通知シグナル

[read-only] mousePressAndHoldInterval : const int

このプロパティは、長押しが有効になる制限時間をミリ秒単位で保持する。

アクセス関数

通知シグナル

mouseQuickSelectionThreshold : const int

QLineEdit におけるクイック選択マウスしきい値。

このプロパティは、通常のQLineEdit テキスト選択中にクイック選択をトリガーするために、マウスカーソルをy軸に沿ってどれだけ移動させるかを定義します。

プロパティ値が0以下の場合、クイック選択機能は無効になります。

アクセス関数：

通知シグナル：

[read-only] passwordMaskCharacter : const QChar

このプロパティは、パスワードモードでテキスト入力フィールドに入力された文字をマスクするために使用される文字を保持する。

アクセス関数：

[read-only] passwordMaskDelay : const int

このプロパティは、パスワードモードにおいて、入力された文字がテキスト入力フィールドに遮蔽されずに表示される時間をミリ秒単位で保持する。

アクセス関数：

[read-only] setFocusOnTouchRelease : const bool

このプロパティは、フォーカスオブジェクトに入力フォーカスを設定するイベントを保持する。

このプロパティは、タッチ/マウスを離した後にフォーカスオブジェクト（行編集など）が入力フォーカスを受け取る必要がある場合、true 。これはタッチプラットフォームでは通常の動作です。デスクトップ・プラットフォームでは、タッチ/マウス押下時にすでにフォーカスが設定されているのが標準です。

アクセス関数：

[read-only] showIsFullScreen : const bool

このプロパティは、プラットフォームがフルスクリーンウィンドウをデフォルトとするかどうかを保持する。

このプロパティは、プラットフォームがウィンドウをフルスクリーンにすることをデフォルトとしている場合はtrue となり、そうでない場合はfalse となります。

アクセス関数：

QWindow::show() およびshowIsMaximized()も参照してください 。

[read-only] showIsMaximized : const bool

このプロパティは、プラットフォームがウィンドウを最大化することをデフォルトとするかどうかを保持する。

このプロパティは、プラットフォームがウィンドウを最大化することをデフォルトとしている場合はtrue となり、そうでない場合はfalse となる。

アクセス関数：

QWindow::show() およびshowIsFullScreen()も参照のこと 。

showShortcutsInContextMenus : bool

true プラットフォームが通常コンテキストメニューにショートカットキーシーケンスを表示する場合、そうでない場合は 。false

Qt 5.13 以降、 setShowShortcutsInContextMenus() 関数を使用すると、プラットフォームのデフォルトをオーバーライドできます。

アクセス関数

Notifier シグナル：

Qt::AA_DontShowShortcutsInContextMenusも参照してください 。

[read-only] singleClickActivation : const bool

このプロパティは、アイテムがシングルクリックとダブルクリックのどちらでアクティブ化されるかを保持する。

このプロパティは、アイテムがシングルクリックで活性化されるべき場合はtrue 、代わりにダブルクリックで活性化されるべき場合はfalse 。

アクセス関数：

[read-only] startDragDistance : const int

このプロパティは、ドラッグ＆ドロップ操作を開始する前に、ボタンを押したままマウスを移動させなければならない距離をピクセル単位で保持します。

アプリケーションでドラッグ＆ドロップをサポートし、ユーザーがボタンを押したままカーソルを一定距離移動させた後にドラッグ＆ドロップ操作を開始したい場合、このプロパティの値を必要最小距離として使用する必要があります。

例えば、クリックしたマウスの位置がstartPos 、現在の位置（マウス移動イベントなど）がcurrentPos の場合、ドラッグを開始すべきかどうかは、次のようなコードで調べることができます：

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

アクセス関数：

通知シグナル：

startDragTime 、QPoint::manhattanLength()、ドラッグ・アンド・ドロップも参照 。

[read-only] startDragTime : const int

このプロパティは、ドラッグ・アンド・ドロップ操作を開始するまでにマウス・ボタンを押し続けなければならない時間をミリ秒単位で保持します。

アプリケーションでドラッグ＆ドロップをサポートしており、ユーザーがマウスボタンを一定時間押し続けた後にドラッグ＆ドロップ操作を開始したい場合は、このプロパティの値を遅延時間として使用する必要があります。

アクセス関数

Notifierシグナル：

startDragDistance 、ドラッグ＆ドロップも参照して ください。

[read-only] startDragVelocity : const int

このプロパティは、ドラッグ＆ドロップ操作を開始するために、ボタンを押したままマウスを移動させることができる速度の制限を、ピクセル/秒で保持します。値が0の場合、そのような制限はありません。

アクセス関数：

startDragDistance 、ドラッグ＆ドロップも参照してください 。

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

このプロパティは、タブキー押下時のフォーカスの動作を保持する。

アクセス関数

ノーティファイアシグナル

[read-only] touchDoubleTapDistance : const int

このプロパティは、2つの連続したタップの間に指を動かしても、ダブルタップとして検出される最大距離をピクセル単位で保持します。

アクセス関数：

useHoverEffects : bool

このプロパティは、UI 要素がホバー効果を使用するかどうかを保持する。

UI要素がホバー効果を使用する場合、このプロパティはtrue 。これは、マウスポインタのあるデスクトッププラットフォームでの標準的な動作であり、タッチプラットフォームでは、ホバーイベント配信のオーバーヘッドを回避することができます。

アクセス関数：

通知シグナル：

[read-only] useRtlExtensions : const bool

このプロパティは、書き込み方向を保持する。

このプロパティは、右から左への書き込み方向が有効な場合はtrue となり、そうでない場合はfalse となる。

アクセス関数：

[read-only] wheelScrollLines : const int

ホイールクリックごとにデフォルトでスクロールする行数。

アクセス機能

通知シグナル