Popup QML Type

このプロパティは、ポップアップにアクティブフォーカスがあるかどうかを保持します。

Qt Quick のfocus とKeyboard Focusも参照して ください。

アンカーは、他のアイテムとの関係を指定することで、アイテムを配置する方法を提供します。

一般的な使用例は、ポップアップをその親アイテムの中央に配置することです。これを行う1つの方法は、x とy プロパティを使用することです。アンカーはより便利な方法を提供します：

Pane {
    // ...

    Popup {
        anchors.centerIn: parent
    }
}

また、Overlay を使用して、ポップアップをウィンドウの中央に配置することも可能です：

ApplicationWindow {
    id: window
    // ...

    Pane {
        // ...

        Popup {
            anchors.centerIn: Overlay.overlay
        }
    }
}

これにより、どのコンポーネントからでも簡単にウィンドウの中央にポップアップを配置することができます。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Popup Positioning,anchors,Using Qt Quick Controls types in property declarationsも参照してください 。

このプロパティは、ポップアップのheight から垂直方向のパディングを差し引いた後のcontentItem で利用可能な高さを保持します。

padding,topPadding,bottomPaddingも参照 。

このプロパティは、ポップアップのwidth から水平方向のパディングを差し引いた後、contentItem で利用可能な幅を保持します。

padding,leftPadding,rightPaddingも参照 。

このプロパティは背景アイテムを保持する。

ポップアップのカスタマイズも参照してください 。

このプロパティは、背景のボトムインセットを保持します。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Popup Layout およびtopInset も参照して ください。

このプロパティは、ポップアップの下端とそのウィンドウの下端の間の距離を保持します。

負の下端マージンを持つポップアップは、それを囲むウィンドウの下端内に押し込まれません。デフォルト値は-1 です。

margins,topMargin,Popup Layoutも参照してください 。

このプロパティはボトムパディングを保持します。明示的に設定されない限り、値はverticalPadding と等しくなります。

padding プロパティは、content item のジオメトリを制御するために使用されます。

PopupはControl と同じ方法でパディングを行います。パディング・システムの視覚的な説明については、ドキュメントのControl Layout セクションを参照してください。

padding,topPadding,verticalPadding,availableHeightも参照してください 。

このプロパティは、クリッピングが有効かどうかを保持します。デフォルト値はfalse です。クリッピングは、ポップアップがそれ自身のウィンドウ内にない場合にのみ機能します。

このプロパティは、ポップアップが閉じる状況を決定します。フラグを組み合わせることで、ポップアップを閉じる方法をいくつか指定できます。

利用可能な値は以下の通りです：

CloseOnPress* とCloseOnRelease* のポリシーはポップアップの外側のイベントに対してのみ適用されます。つまり、2つのポップアップが開いていて、1つ目のポリシーがPopup.CloseOnPressOutside の場合、2つ目のポップアップをクリックしても1つ目のポップアップは閉じません。

デフォルト値はPopup.CloseOnEscape | Popup.CloseOnPressOutside です。

このプロパティは、コンテンツの子のリストを保持します。

このリストには、ポップアップの子として QML で宣言されたすべての項目が含まれます。

Item::children およびcontentDataも参照して ください。

このプロパティはコンテンツデータのリストを保持します。

このリストには、ポップアップの子として QML で宣言されたすべてのオブジェクトが含まれます。

Item::data およびcontentChildrenも参照して ください。

このプロパティはコンテンツの高さを保持します。これはポップアップの暗黙的な高さの合計を計算するために使用されます。

詳しくはPopup Sizing を参照してください。

contentWidth も参照して ください。

このプロパティはポップアップのコンテンツ項目を保持します。

コンテンツ項目はポップアップの視覚的な実装です。ポップアップが可視化されると、コンテンツアイテムは自動的にoverlay item に再配置されます。

ポップアップのカスタマイズも参照してください 。

このプロパティはコンテンツの幅を保持します。これはPopupの暗黙的な幅の合計を計算するために使用されます。

詳細はPopup Sizing を参照してください。

contentHeight も参照して ください。

このプロパティはポップアップが背景を薄暗くするかどうかを保持します。

明示的に設定しない限り、このプロパティはmodal の値に従います。 デフォルト値に戻すには、このプロパティをundefined に設定します。

modal およびOverlay.modelessも参照してください 。

このプロパティはポップアップが有効かどうかを保持します。デフォルト値はtrue です。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

visible およびItem::enabledも参照してください 。

このプロパティは、ポップアップが開いて画面に入ったときに、ポップアップ項目に適用される遷移を保持します。

次の例では、ポップアップがスクリーンに入ったときに、ポップアップの不透明度をアニメーション化します：

Popup {
    enter: Transition {
        NumberAnimation { property: "opacity"; from: 0.0; to: 1.0 }
    }
}

exitも参照してください 。

このプロパティは、ポップアップが閉じられてスクリーンから出るときにポップアップアイテムに適用される遷移を保持します。

次の例では、ポップアップがスクリーンを出るときに、ポップアップの不透明度をアニメーション化します：

Popup {
    exit: Transition {
        NumberAnimation { property: "opacity"; from: 1.0; to: 0.0 }
    }
}

enter も参照して ください。

このプロパティは、ポップアップがフォーカスを欲しているかどうかを保持する。

ポップアップが実際にフォーカスを受け取ると、activeFocus true になります。詳細については、Qt Quick の Keyboard Focus を参照してください。

デフォルト値はfalse です。

activeFocusも参照してください 。

このプロパティは、ポップアップに現在設定されているフォントを保持します。

Popup は、明示的なフォント・プロパティをその子に伝搬します。ポップアップのフォントの特定のプロパティを変更すると、そのプロパティはすべてのポップアップの子に伝わり、そのプロパティのシステムデフォルトを上書きします。

Popup {
    font.family: "Courier"

    Column {
        Label {
            text: qsTr("This will use Courier...")
        }

        Switch {
            text: qsTr("... and so will this")
        }
    }
}

Control::font およびApplicationWindow::fontも参照してください 。

このプロパティはポップアップの高さを保持します。

このプロパティは水平方向のパディングを保持します。明示的に設定されない限り、値はpadding と等しくなります。

padding プロパティはcontent item のジオメトリを制御するために使用されます。

Popup はControl と同じパディング・アプローチを使用します。padding システムの視覚的な説明については、ドキュメントのControl Layout セクションを参照してください。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

padding,leftPadding,rightPadding,verticalPaddingも参照してください 。

このプロパティは、暗黙の背景の高さを保持します。

値はbackground ? background.implicitHeight : 0 と同じです。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitBackgroundWidth およびimplicitContentHeightも参照してください 。

このプロパティは、暗黙の背景の幅を保持します。

値はbackground ? background.implicitWidth : 0 と同じです。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitBackgroundHeight およびimplicitContentWidthも参照してください 。

このプロパティは、暗黙的なコンテンツの高さを保持します。

この値は、コンテンツの子プロパティに基づいて計算されます。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitContentWidth およびimplicitBackgroundHeightも参照してください 。

このプロパティは、暗黙のコンテンツ幅を保持します。

この値は、コンテンツの子プロパティに基づいて計算されます。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitContentHeight およびimplicitBackgroundWidthも参照してください 。

このプロパティは、ポップアップの暗黙の高さを保持します。

このプロパティは、ポップアップの暗黙の幅を保持します。

このプロパティは、背景の左挿入を保持します。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Popup Layout およびrightInsetも参照してください 。

このプロパティは、ポップアップの左端とそのウィンドウの左端との間の距離を保持します。

負の左マージンを持つポップアップは、それを囲むウィンドウの左端に押し込まれません。デフォルト値は-1 です。

margins,rightMargin,Popup Layoutも参照してください 。

このプロパティは左パディングを保持します。明示的に設定されない限り、値はhorizontalPadding と等しくなります。

padding プロパティはcontent item のジオメトリを制御するために使用されます。

PopupはControl と同じ方法でパディングを行います。パディング・システムの視覚的な説明については、ドキュメントのControl Layout セクションを参照してください。

padding,rightPadding,horizontalPadding,availableWidthも参照してください 。

このプロパティはポップアップのロケールを保持します。

mirrored およびLayoutMirroring も参照して ください。

このプロパティはポップアップの端とそのウィンドウの端の間の距離を保持します。

負のマージンを持つポップアップは、囲むウィンドウの境界内に押し込まれません。デフォルト値は-1 です。

topMargin,leftMargin,rightMargin,bottomMargin,Popup Layoutも参照してください 。

このプロパティは、ポップアップがミラーされるかどうかを保持します。

このプロパティは便宜上用意されています。つまり、右から左のロケールを使用している場合です。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

locale およびRight-to-left User Interfacesも参照してください 。

このプロパティは、ポップアップがモーダルかどうかを保持します。

モーダルポップアップは、多くの場合、Overlay.modal で定義された特徴的な背景調光効果を持ち、プレスイベントやリリースイベントをその下のアイテムに通しません。例えば、ユーザが誤ってポップアップの外側をクリックした場合、クリックされた位置でそのポップアップの下にあるアイテムはイベントを受け取りません。

デスクトッププラットフォームでは、モーダルポップアップはエスケープキーが押されたときだけ閉じられるのが一般的です。この動作を実現するには、closePolicy をPopup.CloseOnEscape に設定します。デフォルトでは、closePolicy はPopup.CloseOnEscape | Popup.CloseOnPressOutside に設定され、モーダルポップアップの外側をクリックすると閉じます。

デフォルト値はfalse です。

dimも参照してください 。

このプロパティはポップアップの不透明度を保持します。不透明度は0.0 (完全に透明) と1.0 (完全に不透明) の間の数値で指定します。デフォルト値は1.0 です。

visibleも参照してください 。

このプロパティは、ポップアップが完全に開いているかどうかを保持します。ポップアップが表示されていて、enter とexit のどちらのトランジションも実行されていない場合、ポップアップが開いているとみなされます。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

open(),close(),visibleも参照してください 。

このプロパティは、デフォルトのパディングを保持します。

padding プロパティは、content item のジオメトリを制御するために使用されます。

Popupは、Control と同じ方法でパディングを行います。パディング・システムの視覚的な説明については、ドキュメントのControl Layout セクションを参照してください。

availableWidth,availableHeight,topPadding,leftPadding,rightPadding,bottomPaddingも参照してください 。

このプロパティは、ポップアップに現在設定されているパレットを保持します。

ポップアップは、明示的なパレットプロパティをその子に伝播します。ポップアップのパレットの特定のプロパティを変更すると、そのプロパティはポップアップの全ての子に伝わり、そのプロパティのシステムデフォルトを上書きします。

Popup {
    palette.text: "red"

    Column {
        Label {
            text: qsTr("This will use red color...")
        }

        Switch {
            text: qsTr("... and so will this")
        }
    }
}

こちらも参照してください：Item::palette Window::palette,ColorGroup も参照してください、Palette

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

このプロパティは、親アイテムを保持します。

このプロパティは、優先されるポップアップのタイプを決定します。

利用可能なオプション

ポップアップが優先タイプを使用できるかどうかはプラットフォームに依存します。Popup.Item はすべてのプラットフォームでサポートされていますが、Popup.Window とPopup.Native は通常デスクトップ・プラットフォームでのみサポートされています。さらに、ポップアップがnative menubar の中のMenu である場合、メニューもネイティブになります。また、メニューが他のメニューの中のサブメニューである場合、親（またはルート）メニューがタイプを決定します。

デフォルト値はPopup.Item です。これは Qt の将来のバージョンで変更されるかもしれません。例えば、macOSのすべてのスタイルで常にネイティブメニューを使用したい場合、そうすることができます：

Menu {
    popupType: Qt.platform.os === "osx" ? Popup.Native : Popup.Window
}

また、ポップアップをカスタマイズする場合（例えば、デリゲートを変更する）、ポップアップの種類をPopup.Window に設定することを考慮する必要があります。こうすることで、あなたの変更がすべてのプラットフォームとすべてのスタイルで表示されるようになります。そうしないと、ネイティブメニューが使用されている場合、デリゲートはレンダリングに使用されません。

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

Popup typeも参照してください 。

このプロパティは、背景の右インセットを保持します。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Popup Layout およびleftInset も参照して ください。

このプロパティは、ポップアップの右端とそのウィンドウの右端の間の距離を保持します。

負の右マージンを持つポップアップは、ウィンドウの右端に押し込まれません。デフォルト値は-1 です。

margins,leftMargin,Popup Layoutも参照してください 。

このプロパティは右パディングを保持します。明示的に設定されない限り、値はhorizontalPadding と等しくなります。

padding プロパティはcontent item のジオメトリを制御するために使用されます。

PopupはControl と同じ方法でパディングを行います。パディング・システムの視覚的な説明については、ドキュメントのControl Layout セクションを参照してください。

padding,leftPadding,horizontalPadding,availableWidthも参照して ください。

このプロパティはポップアップのスケールファクターを保持します。デフォルト値は1.0 です。

スケールが1.0 より小さい場合、ポップアップは小さいサイズでレンダリングされ、スケールが1.0 より大きい場合、ポップアップは大きいサイズでレンダリングされます。負のスケールはサポートされていません。

このプロパティは間隔を保持します。

スペーシングは、複数または繰り返しの構成ブロックを持つポップアップに便利です。例えば、Dialog のヘッダ、コンテンツ、フッタの間の距離を決定するためにスペーシングを使用するスタイルもあります。スペーシングは Popup によって強制されるものではないので、各スタイルによって解釈が異なり、完全に無視するものもあります。

このプロパティは QtQuick.Controls 2.1 (Qt 5.8) で導入されました。

このプロパティは、背景のトップインセットを保持します。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Popup Layout およびbottomInsetも参照してください 。

このプロパティは、ポップアップの上端からウィンドウの上端までの距離を保持します。

負の上マージンを持つポップアップは、囲んでいるウィンドウの上端に押し込まれません。デフォルト値は-1 です。

margins,bottomMargin,Popup Layoutも参照してください 。

このプロパティはトップパディングを保持します。明示的に設定されない限り、値はverticalPadding と等しくなります。

padding プロパティはcontent item のジオメトリを制御するために使用されます。

PopupはControl と同じ方法でパディングを行います。パディング・システムの視覚的な説明については、ドキュメントのControl Layout セクションを参照してください。

padding,bottomPadding,verticalPadding,availableHeightも参照してください 。

このプロパティは、出入りのトランジションにおけるトランスフォームの原点を保持します。

以下の画像に示すように、9つのトランスフォーム原点が利用可能です。デフ ォル ト の変換原点はPopup.Center です。

enter ・exit ・Item::transformOriginも参照 。

このプロパティは垂直方向のパディングを保持します。明示的に設定 さ れていない限 り 、 こ の値はpadding に等 し い。

padding プロパティはcontent item のジオメトリを制御するために使用されます。

PopupはControl と同じ方法でパディングを行います。padding システムの視覚的な説明については、ドキュメントのControl Layout セクションを参照してください。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

padding,topPadding,bottomPadding,horizontalPaddingも参照してください 。

このプロパティは、ポップアップが表示されているかどうかを保持します。デフォルト値はfalse です。

open()、close()、openedも参照して ください。

このプロパティは、ポップアップの幅を保持します。

このプロパティはポップアップの x 座標を保持します。

y およびz も参照して ください。

このプロパティはポップアップのy座標を保持します。

x とz も参照して ください。

このプロパティはポップアップの Z 値を保持します。Z値はポップアップの積み重ね順序を決定します。

表示されている2つのポップアップが同じZ値を持つ場合、最後に開かれたものが上になります。

もしポップアップが開かれたときにZ値が明示的に設定されておらず、すでに開いているポップアップの子である場合、そのポップアップは親の上にスタックされます。これにより、子が親の下に隠れることはありません。

ポップアップがそれ自身のウィンドウを持っている場合、z値が代わりにウィンドウのスタック順序を決定します。

デフォルトのz値は0 です。

x およびyも参照して ください。

このシグナルはポップアップが非表示になるときに発せられます。

closed()も参照して ください。

このシグナルはポップアップが表示されようとしているときに発せられます。

opened() も参照して ください。

このシグナルはポップアップが閉じられたときに発せられます。

aboutToHide() も参照して ください。

このシグナルはポップアップが開かれたときに発せられます。

aboutToShow()も参照して ください。

ポップアップを閉じます。

visibleも参照して ください。

与えられたreason を持つポップアップにアクティブフォーカスを強制します。

このメソッドはポップアップにフォーカスを設定し、オブジェクト階層内のすべての祖先FocusScope オブジェクトにもfocus が与えられるようにします。

activeFocus およびQt::FocusReasonも参照して ください。

ポップアップを開きます。

visibleも参照して ください。