QStyleHints Class

プロパティ Documentation

[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 およびDrag and Dropも参照してください 。

[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

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

アクセス関数：

通知シグナル：