QDesignerFormWindowCursorInterface Class

QDesignerFormWindowCursorInterface クラスを使用すると、フォーム・ウィンドウのウィジェット選択を照会および変更し、さらにフォームのすべてのウィジェットのプロパティを変更することができます。詳細...

Header: #include <QDesignerFormWindowCursorInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer

パブリック型

enum MoveMode { MoveAnchor, KeepAnchor }
enum MoveOperation { NoMove, Start, End, Next, Prev, …, Down }

パブリック関数

virtual ~QDesignerFormWindowCursorInterface()
virtual QWidget *current() const = 0
virtual QDesignerFormWindowInterface *formWindow() const = 0
virtual bool hasSelection() const = 0
bool isWidgetSelected(QWidget *widget) const
virtual bool movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0
virtual int position() const = 0
virtual void resetWidgetProperty(QWidget *widget, const QString &name) = 0
virtual QWidget *selectedWidget(int index) const = 0
virtual int selectedWidgetCount() const = 0
virtual void setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0
virtual void setProperty(const QString &name, const QVariant &value) = 0
virtual void setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value) = 0
virtual QWidget *widget(int index) const = 0
virtual int widgetCount() const = 0

詳細説明

QDesignerFormWindowCursorInterface は、関連するフォームウィンドウのテキストカーソルへのインターフェイスを提供する便利なクラスです。指定されたフォームウィンドウの選択範囲を照会し、定義されたモード (MoveMode) と移動 (MoveOperation) に従って選択範囲のフォーカスを変更できる関数のコレクションを提供します。また、このインターフェイスを使ってフォームのウィジェットを照会し、そのプロパティを変更することもできます。

このインターフェイスは直接インスタンス化することを意図しておらず、Qt Widgets Designerの現在のフォームウィンドウの選択とウィジェットへのアクセスを提供するものです。QDesignerFormWindowInterface は常に関連するカーソル・インターフェイスを提供します。与えられたウィジェットのフォーム・ウィンドウは、静的なQDesignerFormWindowInterface::findFormWindow() 関数を使用して取得できます。例えば

    auto *formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget);

    formWindow->cursor()->setProperty(myWidget, myProperty, newValue);

Qt Widgets Designer の現在のフォームウィンドウは、Qt Widgets Designer のform window manager から取得できます。

フォーム・ウィンドウのカーソル・インターフェースを取得したら、hasSelection() 関数を使用して、フォーム・ウィンドウに選択項目があるかどうかを確認できます。フォーム・ウィンドウの合計widgetCount() とselectedWidgetCount() を問い合わせることができます。current() またはselectedWidget() 関数を使用して、現在選択されているウィジェット (または複数のウィジェット) を取得できます。

widget() 関数を使用してフォーム・ウィンドウのウィジェットを取得し、isWidgetSelected() 関数を使用してウィジェットが選択されているかどうかを確認できます。setProperty() 関数を使用して選択されたウィジェットのプロパティを設定し、setWidgetProperty() またはresetWidgetProperty() 関数を使用して任意のウィジェットのプロパティを変更することができます。

最後に、setPosition() とmovePosition() 関数を使用して、テキスト・カーソルのposition() を変更することで、選択範囲を変更できます。

QDesignerFormWindowInterface およびQDesignerFormWindowManagerInterfaceも参照のこと

メンバ型ドキュメント

enum QDesignerFormWindowCursorInterface::MoveMode

この列挙型は、テキストカーソルが移動するときに使用されるさまざまなモードを記述します。

定数説明
QDesignerFormWindowCursorInterface::MoveAnchor0アンカーはカーソルと共に新しい位置に移動する。
QDesignerFormWindowCursorInterface::KeepAnchor1アンカーはカーソルの古い位置に残る。

enum QDesignerFormWindowCursorInterface::MoveOperation

この列挙型は、フォームウィンドウで発生する可能性のあるテキストカーソル操作のタイプを記述します。

定数説明
QDesignerFormWindowCursorInterface::NoMove0カーソルは移動しない。
QDesignerFormWindowCursorInterface::Start1カーソルをフォーカスチェーンの先頭に移動する。
QDesignerFormWindowCursorInterface::End2カーソルをフォーカスチェーンの終端に移動する。
QDesignerFormWindowCursorInterface::Next3カーソルをフォーカスチェーンの次のウィジェットに移動する。
QDesignerFormWindowCursorInterface::Prev4カーソルをフォーカス・チェインの前のウィジェットに移動する。
QDesignerFormWindowCursorInterface::Left5カーソルが左に移動する。
QDesignerFormWindowCursorInterface::Right6カーソルが右に移動する。
QDesignerFormWindowCursorInterface::Up7カーソルが上方向に移動する。
QDesignerFormWindowCursorInterface::Down8カーソルは下方向に移動する。

メンバ関数 ドキュメント

[virtual constexpr noexcept] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()

カーソルインターフェイスを破棄する。

[pure virtual] QWidget *QDesignerFormWindowCursorInterface::current() const

フォームウィンドウで現在選択されているウィジェットを返す。

selectedWidget()も参照

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowCursorInterface::formWindow() const

このカーソルインターフェースに関連付けられたフォームウィンドウインターフェースを返します。

[pure virtual] bool QDesignerFormWindowCursorInterface::hasSelection() const

フォーム・ウィンドウに選択項目がある場合は真を、ない場合は偽を返します。

bool QDesignerFormWindowCursorInterface::isWidgetSelected(QWidget *widget) const

指定されたwidget が選択されていれば真を返し、そうでなければ偽を返します。

[pure virtual] bool QDesignerFormWindowCursorInterface::movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)

指定されたmode を使用して、指定されたoperation をカーソルに対して実行し、正常に完了した場合はtrueを返し、そうでない場合はfalseを返します。

position() およびsetPosition()も参照

[pure virtual] int QDesignerFormWindowCursorInterface::position() const

カーソル位置を返します。

setPosition() およびmovePosition() も参照して ください。

[pure virtual] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)

指定されたwidget の指定されたname を持つプロパティをデフォルト値にリセットします。

setProperty() およびsetWidgetProperty() も参照して ください。

[pure virtual] QWidget *QDesignerFormWindowCursorInterface::selectedWidget(int index) const

選択されたウィジェットのリストで、指定されたindex を持つウィジェットを返します。

current() およびwidget() も参照

[pure virtual] int QDesignerFormWindowCursorInterface::selectedWidgetCount() const

フォーム・ウィンドウで選択されているウィジェットの数を返します。

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

[pure virtual] void QDesignerFormWindowCursorInterface::setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)

カーソルの移動方法を指定するためにmode を使用して、指定されたposition にカーソルの位置を設定します。

position() およびmovePosition() も参照

[pure virtual] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)

現在選択されているウィジェットの指定されたname のプロパティを、指定されたvalue に設定します。

setWidgetProperty() およびresetWidgetProperty() も参照

[pure virtual] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)

指定されたwidget の指定されたname を持つプロパティを、指定されたvalue に設定します。

resetWidgetProperty() およびsetProperty() も参照

[pure virtual] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const

フォーム・ウィンドウのウィジェット・リスト内の、指定されたindex を持つウィジェットを返します。

selectedWidget() も参照

[pure virtual] int QDesignerFormWindowCursorInterface::widgetCount() const

フォーム・ウィンドウ内のウィジェットの数を返します。

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

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 ここで提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。