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::MoveAnchor | 0 | アンカーはカーソルと共に新しい位置に移動する。 |
QDesignerFormWindowCursorInterface::KeepAnchor | 1 | アンカーはカーソルの古い位置に残る。 |
enum QDesignerFormWindowCursorInterface::MoveOperation
この列挙型は、フォームウィンドウで発生する可能性のあるテキストカーソル操作のタイプを記述します。
定数 | 値 | 説明 |
---|---|---|
QDesignerFormWindowCursorInterface::NoMove | 0 | カーソルは移動しない。 |
QDesignerFormWindowCursorInterface::Start | 1 | カーソルをフォーカスチェーンの先頭に移動する。 |
QDesignerFormWindowCursorInterface::End | 2 | カーソルをフォーカスチェーンの終端に移動する。 |
QDesignerFormWindowCursorInterface::Next | 3 | カーソルをフォーカスチェーンの次のウィジェットに移動する。 |
QDesignerFormWindowCursorInterface::Prev | 4 | カーソルをフォーカス・チェインの前のウィジェットに移動する。 |
QDesignerFormWindowCursorInterface::Left | 5 | カーソルが左に移動する。 |
QDesignerFormWindowCursorInterface::Right | 6 | カーソルが右に移動する。 |
QDesignerFormWindowCursorInterface::Up | 7 | カーソルが上方向に移動する。 |
QDesignerFormWindowCursorInterface::Down | 8 | カーソルは下方向に移動する。 |
メンバ関数 ドキュメント
[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 を持つウィジェットを返します。
[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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。