Qt Namespace

型のドキュメント

enum Qt::AlignmentFlag
flags Qt::Alignment

この列挙型は、配置を記述するために使用されます。これには、水平および垂直のフラグが含まれており、これらを組み合わせて必要な効果を生み出すことができます。

また、「TextElideMode 」列挙型は、配置されたテキストの外観を微調整するために、さまざまな場面で使用できます。

水平方向のフラグは以下の通りです：

縦方向のフラグは以下の通りです：

水平方向のフラグは、一度に1つしか使用できません。2次元フラグは1つあります：

一度に使用できる水平フラグと垂直フラグは、それぞれ最大1つずつです。Qt::AlignCenterは、水平および垂直の両方にカウントされます。

右から左へのモードで実行可能なアプリケーションでは、次の3つの列挙型値が役立ちます：

マスク:

フラグの組み合わせに矛盾がある場合、その意味は未定義となります。

Alignment 型はQFlags<AlignmentFlag> の typedef です。これは、AlignmentFlag 値の論理和（OR）の組み合わせを格納します。

enum Qt::AnchorPoint

レイアウト項目のうち、アンカー設定が可能な辺を指定します。これはQGraphicsAnchorLayout によって使用されます。

QGraphicsAnchorLayoutも参照してください 。

enum Qt::ApplicationAttribute

この列挙型は、アプリケーション全体の機能の動作を変更する属性を表します。これらは `QCoreApplication::setAttribute()` を使用して有効化または無効化され、`QCoreApplication::testAttribute()` を使用してその状態を確認できます。

この属性が true の場合、Qt はこの再マッピングを行わず、Command 修飾キーを押すとQt::MetaModifier となり、Control 修飾キーを押すとQt::ControlModifier となります。

QKeySequence::StandardKey シーケンスは常に同じ修飾キーに基づきます（つまり、設定された値に関係なく、QKeySequence::Copy は Command+C になります）が、QKeySequence::toString() の出力結果は異なります。

enum Qt::ApplicationState
flags Qt::ApplicationStates

この列挙型は、アプリケーションの現在の状態を指定するために使用されます。

状態は以下の通りです。

ApplicationStates 型は、QFlags<ApplicationState> の typedef です。これは、ApplicationState 値の論理和（OR）を格納します。

enum Qt::ArrowType

enum Qt::AspectRatioMode

この列挙型は、矩形を拡大・縮小する際にアスペクト比がどのように変化するかを定義します。

QSize::scale() およびQImage::scaled()も参照してください 。

enum Qt::Axis

この列挙型は、デカルト座標系の3つの軸を表す3つの値を定義しています。

QTransform::rotate() およびQTransform::rotateRadians()も参照してください 。

enum Qt::BGMode

バックグラウンドモード：

enum Qt::BrushStyle

この列挙型は、Qtがサポートするブラシスタイル、すなわちQPainter を使用して描画される図形の塗りつぶしパターンを定義します。

QBrushも参照してください 。

enum Qt::CaseSensitivity

enum Qt::CheckState

この列挙型は、チェック可能な項目、コントロール、およびウィジェットの状態を表します。

関連項目： QCheckBox 、Qt::ItemFlags 、およびQt::ItemDataRole 。

enum Qt::ChecksumType

この列挙型は、qChecksum() で使用される可能性のある標準を記述したものです。

enum Qt::ClipOperation

enum class Qt::ColorScheme

QGuiApplication::palette() で定義される、アプリケーションのテーマの外観を表します。

enum Qt::ConnectionType

この列挙型は、シグナルとスロット間で使用可能な接続の種類を定義します。具体的には、特定のシグナルがスロットに即座に配信されるか、それともキューに入れられて後で配信されるかを決定します。

キュー付き接続の場合、Qtは引数をコピーして内部でイベントに格納する必要があるため、パラメータはQtのメタオブジェクトシステムが認識する型でなければなりません。キュー付き接続を使用しようとして、次のようなエラーメッセージが表示された場合は：

QObject::connect: Cannot queue arguments of type 'MyType'

接続を確立する前に、qRegisterMetaType() を呼び出してデータ型を登録してください。

複数のスレッドでシグナルとスロットを使用する場合は、「スレッド間のシグナルとスロット」を参照してください。

「Qt XML におけるマルチスレッド処理」、「QObject::connect()」、「qRegisterMetaType()」、および「Q_DECLARE_METATYPE()」も参照してください 。

enum Qt::ContextMenuPolicy

この列挙型は、コンテキストメニューの表示に関してウィジェットが持つことができるさまざまなポリシーを定義しています。

[since 6.8] enum class Qt::ContextMenuTrigger

この列挙型は、コンテキストメニューイベントをトリガーするために使用されるマウスイベントを定義します。

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

QStyleHints::contextMenuTriggerも参照してください 。

[since 6.10] enum class Qt::ContrastPreference

ユーザーが好むコントラスト設定を表します。スタイルでは、この設定に合わせて、前景色と背景色のコントラストを高めたり、ウィジェットやコントロールの枠線を太くしたりすることができます。

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

enum Qt::CoordinateSystem

この列挙型は座標系を指定します。

enum Qt::Corner

この列挙型は、矩形内の角を指定します：

enum Qt::CursorMoveStyle

この列挙型は、テキストカーソルで使用可能な移動スタイルを表します。オプションは以下の通りです：

enum Qt::CursorShape

この列挙型は、使用可能なさまざまなカーソルを定義しています。

標準の矢印カーソルは、通常状態のウィジェットのデフォルト設定です。

定数	定数値	説明
Qt::ArrowCursor	0	標準の矢印カーソル。
Qt::UpArrowCursor	1	上向き矢印カーソル。
Qt::CrossCursor	2	十字カーソル。通常、ユーザーが画面上の特定の点を正確に選択できるようにするために使用されます。
Qt::WaitCursor	3	砂時計または時計のカーソル。通常、ユーザーがアプリケーションを操作できない操作中に表示されます。
Qt::IBeamCursor	4	キャレットまたはiビームカーソル。ウィジェットがテキスト入力を受け付け、表示できることを示します。
Qt::SizeVerCursor	5	トップレベルウィンドウの縦方向のサイズ変更に使用される要素用のカーソル。
Qt::SizeHorCursor	6	トップレベルウィンドウの幅を水平方向に調整するために使用される要素に用いられるカーソル。
Qt::SizeBDiagCursor	7	トップレベルウィンドウの右上隅および左下隅で、対角線方向にサイズ変更を行う要素に使用されるカーソル。
Qt::SizeFDiagCursor	8	トップレベルウィンドウの左上隅および右下隅で、対角線方向にサイズ変更を行う要素に使用されるカーソル。
Qt::SizeAllCursor	9	トップレベルウィンドウを任意の方向にサイズ変更するために使用される要素で用いられるカーソル。
Qt::BlankCursor	10	空白または非表示のカーソル。通常、カーソルの形状を非表示にする必要がある場合に使用されます。
Qt::SplitVCursor	11	垂直スプリッターに使用されるカーソルで、ハンドルを水平方向にドラッグして利用可能なスペースの割り当てを調整できることを示します。
Qt::SplitHCursor	12	水平スプリッターに使用されるカーソルで、ハンドルを垂直方向にドラッグして利用可能なスペースの割り当てを調整できることを示します。
Qt::PointingHandCursor	13	通常、ハイパーリンクなどのクリック可能な要素に使用される、指を差し示す手のカーソル。
Qt::ForbiddenCursor	14	斜線付きの円カーソル。通常、ドラッグ＆ドロップ操作中に、ドラッグされたコンテンツを特定のウィジェット上や特定の領域内にドロップできないことを示すために使用されます。
Qt::OpenHandCursor	17	開いた手を表すカーソル。通常、カーソルの下にある領域が、ユーザーがクリックしてドラッグすることでスクロールできるキャンバスの表示部分であることを示すために使用されます。
Qt::ClosedHandCursor	18	握りこぶしを表すカーソル。通常、スクロールを伴うドラッグ操作が進行中であることを示すために使用されます。
Qt::WhatsThisCursor	15	疑問符付きの矢印。通常、ウィジェットに「これは何？」ヘルプがあることを示すために使用されます。
Qt::BusyCursor	16	砂時計または時計のカーソル。通常、バックグラウンドで処理が行われている間、ユーザーがアプリケーションと対話できる操作中に表示されます。
Qt::DragMoveCursor	20	通常、項目をドラッグする際に使用されるカーソル。
Qt::DragCopyCursor	19	通常、アイテムをコピーするためにドラッグする際に使用されるカーソル。
Qt::DragLinkCursor	21	通常、アイテムをドラッグしてそのアイテムへのリンクを作成する際に使用されるカーソル。
Qt::BitmapCursor	24

enum Qt::DateFormat

ISODate 形式の場合、各y 、M 、およびd は、日付を指定するために使用される年、月、日の各桁を表します。各H 、m 、およびs は、時刻を指定するために使用される時（最大24）、分、秒の各桁を表します。 24を時として、その他の時間フィールドをすべて0とした場合は、翌日の開始とみなされます。.zzz は、先行するフィールドの分数の接尾辞を表し、そのフィールドとは、コンマ',' または図に示すドット'.' によって区切られます。ミリ秒を超える精度は受け入れられますが、破棄され、表現可能な最も近いミリ秒に丸められます。 リテラル文字「T 」は、日付と時刻の両方が指定されている場合に、これらを区切るために使用されます。TextDate およびRFC2822Date 形式では、「ddd 」は曜日の名称の最初の3文字を、「MMM 」は月の名称の最初の3文字を表します。曜日および月の名称は、ユーザーの設定やシステム設定にかかわらず、常に英語（Cロケール）で表記されます。 その他のフォーマット文字は、ISODate 形式の場合と同じ意味を持ちますが、24 が時刻として受け入れられない点が異なります。角括弧で囲まれたフォーマットの一部[...] は省略可能です。角括弧自体はフォーマットの一部を構成しません。ここでのプラスまたはマイナスの記号'±' は、いずれの符号も表します。'-' はマイナス、'+' はプラスを表します。

関連項目： QDate::toString()、QTime::toString()、QDateTime::toString()、QDate::fromString()、QTime::fromString()、およびQDateTime::fromString()。

enum Qt::DayOfWeek

enum Qt::DockWidgetArea
flags Qt::DockWidgetAreas

QDockWidget を接続できる場所を示しています。

DockWidgetAreas 型は、QFlags<DockWidgetArea> の typedef です。これは、DockWidgetArea 値の論理和 (OR) を格納します。

QDockWidget::setAllowedAreas およびQDockWidget::isAreaAllowedも参照してください 。

enum Qt::DropAction
flags Qt::DropActions

DropActions 型は、QFlags<DropAction> の typedef です。これは、DropAction 値の論理和（OR）の組み合わせを格納します。

enum Qt::Edge
flags Qt::Edges

この列挙型は、矩形内の辺を指定します：

Edges 型は、QFlags<Edge> の typedef です。Edge 値の論理和（OR）を格納します。

enum Qt::EnterKeyType

これを使用すると、オンスクリーンキーボード上の「Return」キーの外観を変更することができます。

enum Qt::EventPriority

この列挙型は、イベントの優先度を指定するために使用できます。

イベントの優先度は、INT_MAX からINT_MIN までの任意の値（両端を含む）に設定できるため、これらの値はあくまで便宜上提供されているものであることに注意してください。たとえば、互いに相対的なカスタム優先度を次のように定義することができます。

enum CustomEventPriority
{
    // An important event
    ImportantEventPriority = Qt::HighEventPriority,

    // A more important event
    MoreImportantEventPriority = ImportantEventPriority + 1,

    // A critical event
    CriticalEventPriority = 100 * MoreImportantEventPriority,

    // Not that important
    StatusEventPriority = Qt::LowEventPriority,

    // These are less important than Status events
    IdleProcessingDoneEventPriority = StatusEventPriority - 1
};

QCoreApplication::postEvent()も参照してください 。

enum Qt::FillRule

パスやポリゴンを塗りつぶす際に使用する方法を指定します。

enum Qt::FindChildOption
flags Qt::FindChildOptions

FindChildOptions 型は、QFlags<FindChildOption> の typedef です。これは、FindChildOption 値の OR 組み合わせを格納します。

enum Qt::FocusPolicy

この列挙型は、ウィジェットがキーボードフォーカスを取得する際に採用できるさまざまなポリシーを定義しています。

enum Qt::FocusReason

この列挙型は、フォーカスが変更された理由を指定します。これはQWidget::setFocus を通じて渡され、フォーカス変更時にウィジェットに送信されるQFocusEvent 内で取得できます。

「ウィジェットにおけるキーボードフォーカス」も参照してください 。

enum Qt::GestureFlag
flags Qt::GestureFlags

この列挙型は、ジェスチャーを購読する際に使用できる追加のフラグを表します。

GestureFlags 型は、QFlags<GestureFlag> の typedef です。これは、GestureFlag 値の OR 組み合わせを格納します。

QWidget::grabGesture() およびQGraphicsObject::grabGesture()も参照してください 。

enum Qt::GestureState

この列挙型は、ジェスチャーの状態を表します。

QGestureも参照してください 。

enum Qt::GestureType

この列挙型は、標準的なジェスチャーを表します。

ユーザー定義のジェスチャは、QGestureRecognizer::registerRecognizer() 関数で登録されます。この関数は、Qt::CustomGesture フラグが設定されたカスタムジェスチャ ID を生成します。

QGesture 、QWidget::grabGesture()、およびQGraphicsObject::grabGesture()も参照してください 。

enum Qt::GlobalColor

Qtの定義済みQColor オブジェクト：

QColorも参照してください 。

Qt::HANDLE

システムオブジェクト用のハンドル型。すべてのプラットフォームでvoid * として定義されています。

enum class Qt::HighDpiScaleFactorRoundingPolicy

この列挙型は、High-DPI スケール係数の丸め処理方針を定義するものであり、整数でないスケール係数（Windows の 150% など）をどのように扱うかを決定します。

有効なポリシーは、アプリケーションオブジェクトが作成される前にQGuiApplication::setHighDpiScaleFactorRoundingPolicy()を呼び出すことで設定されます。

QGuiApplication::setHighDpiScaleFactorRoundingPolicy()も参照してください 。

enum Qt::HitTestAccuracy

この列挙型には、QTextDocument クラスがテキスト文書上のマウスクリックを検出する際に使用できる精度の種類が含まれています。

enum Qt::ImageConversionFlag
flags Qt::ImageConversionFlags

リスト内の他の値が指定されていない場合、「(デフォルト)」とマークされたオプションが設定されます（デフォルト値はゼロであるため）。

カラー／モノクロの設定（QBitmap では無視されます）：

ディザリングモードの設定:

1 ビットアルファマスク用のディザリングモード設定：

色合わせとディザリングの優先度:

ImageConversionFlags 型は、QFlags<ImageConversionFlag> の typedef です。これは、ImageConversionFlag 値の論理和（OR）の組み合わせを格納します。

enum Qt::InputMethodHint
flags Qt::InputMethodHints

動作を変更するフラグ：

なお、AndroidのIMEでは、パスワード入力欄では意図的にラテン文字/ASCII文字のみの入力に制限されています。

Qt フレームワークはこれを「表示されているパスワード」として扱うことに注意してください。この場合、Android IME は意図的にラテン文字および ASCII 文字のみの入力に制限しています。

入力を制限するフラグ（排他的フラグ）：

マスク：

InputMethodHints 型は、QFlags<InputMethodHint> の typedef です。これは、InputMethodHint 値の OR 結合を格納します。

QGraphicsItem::inputMethodHints()も参照してください 。

enum Qt::InputMethodQuery
flags Qt::InputMethodQueries

マスク:

InputMethodQueries 型は、QFlags<InputMethodQuery> の typedef です。これは、InputMethodQuery 値の OR 結合を格納します。

QInputMethodQueryEventも参照してください 。

enum Qt::ItemDataRole

モデル内の各項目には、それに関連付けられた一連のデータ要素があり、それぞれに固有の役割があります。これらの役割は、ビューがモデルに対して、どのようなタイプのデータが必要かを示すために使用されます。カスタムモデルは、これらのタイプのデータを返す必要があります。

汎用的な役割（およびそれに関連する型）は以下の通りです：

外観およびメタデータを記述するロール（関連する型付き）：

アクセシビリティロール（関連する型付き）：

ユーザーロール:

ユーザーロールについては、どの型を使用するかを決定し、コンポーネントがデータへのアクセスや設定を行う際に正しい型を使用するように確保するのは、開発者の責任です。

enum Qt::ItemFlag
flags Qt::ItemFlags

この列挙型は、アイテムのプロパティを表します：

チェック可能なアイテムには、適切なフラグのセットと、そのアイテムがチェックされているかどうかを示す初期状態の両方を指定する必要があることに注意してください。これはモデル/ビューコンポーネントでは自動的に処理されますが、QListWidgetItem 、QTableWidgetItem 、およびQTreeWidgetItem のインスタンスについては明示的に設定する必要があります。

なお、QAbstractItemModel::hasChildren を再実装して、インデックスに Qt::ItemNeverHasChildren フラグが設定されている場合にそのインデックスに対して true を返すようにすることは、未定義の挙動となります。

ItemFlags 型はQFlags<ItemFlag> の typedef です。これは ItemFlag 値の論理和（OR）の組み合わせを格納します。

QAbstractItemModelも参照してください 。

enum Qt::ItemSelectionMode

この列挙型は、QGraphicsItem 、QGraphicsScene 、およびQGraphicsView で、アイテムの選択方法や、図形とアイテムの衝突判定方法を指定するために使用されます。

関連項目： QGraphicsScene::items()、QGraphicsScene::collidingItems()、QGraphicsView::items()、QGraphicsItem::collidesWithItem()、およびQGraphicsItem::collidesWithPath()。

enum Qt::ItemSelectionOperation

この列挙型は、QGraphicsScene において、選択領域を設定する際に、現在選択されている項目をどのように扱うかを指定するために使用されます。

QGraphicsScene::setSelectionArea()も参照してください 。

enum Qt::Key

Qt.で使用される主要な名前。

QKeyEvent::key()も参照してください 。

enum Qt::KeyboardModifier
flags Qt::KeyboardModifiers

この列挙型は、修飾キーを表します。

KeyboardModifiers 型は、QFlags<KeyboardModifier> の typedef です。これは、KeyboardModifier 値の OR 組み合わせを格納します。

MouseButton およびModifierも参照してください 。

enum Qt::LayoutDirection

Qt のレイアウトおよびテキスト処理の方向を指定します。

右から左へのレイアウトは、アラビア語やヘブライ語など、特定の言語で必要です。

LayoutDirectionAuto には 2 つの目的があります。ウィジェットやレイアウトと組み合わせて使用する場合、親ウィジェットまたは `QApplication` で設定されたレイアウト方向を使用することを意味します。これは、QWidget::unsetLayoutDirection() と同じ効果があります。

LayoutDirectionAuto をテキストのレイアウトと組み合わせて使用する場合、テキストの方向性は、レイアウト対象の文字列の内容から決定されることを意味します。

QGuiApplication::setLayoutDirection()、QWidget::setLayoutDirection()、QTextOption::setTextDirection()、およびQString::isRightToLeft()も参照してください 。

enum Qt::MaskMode

この列挙型は、QPixmap::createMaskFromColor() およびQImage::createMaskFromColor() 関数の動作を指定します。

enum Qt::MatchFlag
flags Qt::MatchFlags

この列挙型は、モデル内の項目を検索する際に使用できる一致条件の種類を表します。

MatchFlags 型は、QFlags<MatchFlag> の typedef です。これは、MatchFlag 値の OR 組み合わせを格納します。

QString::compare() およびQRegularExpressionも参照してください 。

enum Qt::Modifier
flags Qt::Modifiers

この列挙型は、Qtがサポートするキーボードの修飾キーに対して、より短い名称を提供します。

Modifiers 型は、QFlags<Modifier> の typedef です。これは、Modifier 値の論理和 (OR) 組み合わせを格納します。

KeyboardModifier およびMouseButtonも参照してください 。

[since 6.12] enum class Qt::MotionPreference

アニメーションや動きに関するユーザーの好みの設定を表します。コントロール、スタイル、およびアプリケーションは、この設定に従い、列挙型の値に応じてアニメーションの量を制限することができます。

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

enum Qt::MouseButton
flags Qt::MouseButtons

この列挙型は、さまざまなマウスボタンを表します。

MouseButtons 型は、QFlags<MouseButton> の typedef です。これは、MouseButton 値の論理和（OR）の組み合わせを格納します。

KeyboardModifier およびModifierも参照してください 。

enum Qt::MouseEventFlag
flags Qt::MouseEventFlags

この列挙型は、QMouseEvent に関する追加情報を提供します。

MouseEventFlags型は、QFlags<MouseEventFlag>のtypedefです。これは、MouseEventFlag値の論理和（OR）の組み合わせを格納します。

enum Qt::MouseEventSource

この列挙型は、マウスイベントの発生源を表しており、そのイベントがタッチスクリーンなどの別のデバイスに由来する人工的なマウスイベントであるかどうかを判断するのに役立ちます。

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

enum Qt::NativeGestureType

この列挙型は、ジェスチャーの種類を返します。

enum Qt::Orientation
flags Qt::Orientations

この型は、オブジェクトの向きを表すために使用されます。

Orientation は、例えば `QScrollBar ` と共に使用されます。

Orientations 型は、QFlags<Orientation> の typedef です。これは、Orientation 値の OR 組み合わせを格納します。

enum Qt::PenCapStyle

この列挙型は、Qtがサポートするペンキャップのスタイル、すなわちQPainter を使用して描画できる線の端のキャップを定義します。

Qt::SquareCap	Qt::FlatCap	Qt::RoundCap

QPenも参照してください 。

enum Qt::PenJoinStyle

この列挙型は、Qtがサポートする線の接続スタイル、すなわちQPainter を使用して2本の接続された線の間にどのような接続線を描画できるかを定義します。

Qt::BevelJoin	Qt::MiterJoin	Qt::RoundJoin

QPenも参照してください 。

enum Qt::PenStyle

この列挙型は、QPainter を使用して描画できるペンスタイルを定義します。スタイルは以下の通りです：

Qt::SolidLine	Qt::DashLine	Qt::DotLine
Qt::DashDotLine	Qt::DashDotDotLine	Qt::CustomDashLine

QPenも参照してください 。

[since 6.5] enum class Qt::PermissionStatus

この列挙型は、権限の取り得るステータスを定義しています。

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

QCoreApplication::requestPermission()、QCoreApplication::checkPermission()、および「アプリケーションの権限」も参照してください 。

enum Qt::ReturnByValueConstant

これは、ユーザーが特定の非推奨APIから後継APIへ移行できるよう支援するために設計されたダミー型です。

QCursor::bitmap()、QCursor::mask()、QLabel::picture()、およびQLabel::pixmap()も参照してください 。

enum Qt::ScreenOrientation
flags Qt::ScreenOrientations

この列挙型は、画面が取り得るさまざまな向きを指定します。

ScreenOrientations 型は、QFlags<ScreenOrientation> の typedef です。これは、ScreenOrientation 値の論理和（OR）の組み合わせを格納します。

enum Qt::ScrollBarPolicy

この列挙型は、QAbstractScrollArea のスクロールバーのさまざまなモードを表します。

（水平および垂直のスクロールバーのモードは互いに独立しています。）

enum Qt::ScrollPhase

この列挙型は、スクロールのフェーズを表します。