QStyleHints Class

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

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

このプロパティには、アプリケーションのアクセシビリティヒントが格納されます。

アクセシビリティヒントには、ユーザーがアプリケーションを高コントラスト表示にするかどうかといった、プラットフォームに依存するアクセシビリティ設定がカプセル化されています。

この列挙型は Qt 6.10 で導入されました。

アクセス関数:

関連項目: QAccessibilityHints 。

[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 : int

このプロパティには、テキストカーソルの点滅時間がミリ秒単位で格納されます。

点滅時間は、キャレットの表示、反転、および元の状態への復元にかかる時間です。通常、テキストカーソルは点滅時間の半分だけ表示され、その後、同じ時間だけ非表示になります。

アクセス関数：

通知シグナル：

[read-only] fontSmoothingGamma : const qreal

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

アクセス関数：

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

このプロパティは、キーが押し続けられている場合に、追加の繰り返しキー入力が自動的に生成される頻度（1秒あたりのイベント数）を指定します。

この列挙型は Qt 6.5 で導入されました。

アクセス関数：

[read-only] keyboardInputInterval : int

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

アクセス関数：

通知シグナル:

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

メニューの選択がループするかどうか。

メニューの選択範囲がループするかどうかをtrue で返します。つまり、最後のメニュー項目に到達した後、キー操作によって選択範囲が最初のメニュー項目に戻るかどうか、およびその逆の動作を行うかどうかを示します。

この列挙型は Qt 6.10 で導入されました。

アクセス関数：

[read-only] mouseDoubleClickDistance : const int

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

アクセス関数：

[read-only] mouseDoubleClickInterval : int

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

アクセス関数:

通知シグナル:

[read-only] mousePressAndHoldInterval : int

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

アクセス関数：

通知シグナル：

mouseQuickSelectionThreshold : 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 : int

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

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

たとえば、クリック時のマウス位置が `startPos ` に格納されており、現在の位置（マウス移動イベント内など）が `currentPos` である場合、次のようなコードでドラッグを開始すべきかどうかを判断できます。

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

アクセス関数：

Notifierシグナル:

関連項目： startDragTime 、QPoint::manhattanLength()、およびドラッグ＆ドロップ。

[read-only] startDragTime : int

このプロパティは、ドラッグ＆ドロップ操作が開始されるまでにマウスボタンを押し続ける必要がある時間をミリ秒単位で保持します。

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

アクセス関数：

Notifierシグナル:

「 startDragDistance 」 および「ドラッグ＆ドロップ」も参照してください 。

[read-only] startDragVelocity : const int

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

アクセス関数：

「 startDragDistance 」 および「ドラッグ＆ドロップ」も参照してください 。

[read-only] tabFocusBehavior : Qt::TabFocusBehavior

このプロパティは、Tabキーが押された際のフォーカス動作を制御します。

アクセス関数：

通知シグナル:

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

このプロパティは、ツールチップが表示されるまでの遅延時間を指定します。

この列挙型は Qt 6.12 で導入されました。

アクセス関数：

Notifier シグナル:

関連項目: QWidget::toolTip およびQtQuick.Controls::ToolTip::delay 。

[read-only, since 6.12] toolTipWakeUpDelayAsMSec : int

このプロパティは、ツールチップが表示されるまでの遅延時間をミリ秒単位で指定します。

この列挙型は Qt 6.12 で導入されました。

アクセス関数：

Notifierシグナル:

関連項目： toolTipWakeUpDelay およびQtQuick.Controls::ToolTip::delay 。

[read-only] touchDoubleTapDistance : const int

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

アクセス関数：

useHoverEffects : bool

このプロパティは、UI 要素でホバー効果を使用するかどうかを指定します。

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

アクセス関数：

Notifierシグナル:

[read-only] useRtlExtensions : const bool

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

このプロパティは、右から左への書き込み方向が有効な場合は `true `、それ以外の場合は `false` となります。

アクセス関数：

[read-only] wheelScrollLines : int

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

アクセス関数：

Notifierシグナル：