QKeySequence Class

メンバ関数のドキュメント

QKeySequence::QKeySequence()

空のキーシーケンスを作成します。

QKeySequence::QKeySequence(QKeySequence::StandardKey key)

指定されたkey に対するQKeySequenceオブジェクトを生成します。結果は、現在実行中のプラットフォームによって異なります。

生成されるオブジェクトは、key のキーバインディングリストの最初の要素に基づいて作成されます。

QKeySequence::QKeySequence(const QString &key, QKeySequence::SequenceFormat format = NativeText)

format に基づいて、key という文字列からキーシーケンスを作成します。

たとえば、「Ctrl+O」と指定すると、CTRL+'O' となります。「Ctrl」、「Shift」、「Alt」、「Meta」という文字列は、「QShortcut 」コンテキストにおけるそれらの変換済み相当語（QObject::tr() を使用）と同様に認識されます。

最大4つのキーコードをカンマで区切って指定できます。例：「Alt+X,Ctrl+S,Q」。

このコンストラクタは通常、tr() と共に使用され、翻訳時にショートカットキーを置き換えることができます：

QMenu *file = new QMenu(this);
file->addAction(tr("&Open..."), QKeySequence(tr("Ctrl+O", "File|Open")),
                this, &MainWindow::open);

「File|Open」という翻訳者向けコメントに注意してください。これは決して必須ではありませんが、人間の翻訳者にとって文脈を理解する助けとなります。

QKeySequence::QKeySequence(QKeyCombination k1, QKeyCombination k2 = QKeyCombination::fromCombined(0), QKeyCombination k3 = QKeyCombination::fromCombined(0), QKeyCombination k4 = QKeyCombination::fromCombined(0))

最大4つのキー（k1 、k2 、k3 、k4 ）からなるキーシーケンスを生成します。

QKeyCombinationも参照してください 。

QKeySequence::QKeySequence(int k1, int k2 = 0, int k3 = 0, int k4 = 0)

最大4つのキー（k1 、k2 、k3 、k4 ）からなるキーシーケンスを生成します。

キーコードはQt::Key に記載されており、Qt::ShiftModifier 、Qt::ControlModifier 、Qt::AltModifier 、Qt::MetaModifier などの修飾子（Qt::KeyboardModifier を参照）と組み合わせることができます。

QKeySequence::QKeySequence(const QKeySequence &keysequence)

コピーコンストラクタ。keysequence のコピーを作成します。

[noexcept] QKeySequence::~QKeySequence()

キーシーケンスを破棄します。

int QKeySequence::count() const

キーシーケンスに含まれるキーの数を返します。最大値は 4 です。

[static] QKeySequence QKeySequence::fromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)

format に基づいて、文字列 `str ` から `QKeySequence ` を返します。

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

bool QKeySequence::isEmpty() const

キーのシーケンスが空の場合、true を返します。それ以外の場合は false を返します。

[static] QList<QKeySequence> QKeySequence::keyBindings(QKeySequence::StandardKey key)

指定されたkey に対するキーバインディングのリストを返します。この関数を呼び出した際の結果は、ターゲットプラットフォームによって異なります。リストの最初の要素は、指定されたプラットフォームにおける主要なショートカットを示します。結果に複数の項目が含まれている場合、それらは指定されたkey に対する、同じプラットフォーム上の代替ショートカットとみなすことができます。

[static] QList<QKeySequence> QKeySequence::listFromString(const QString &str, QKeySequence::SequenceFormat format = PortableText)

format に基づいて、文字列str からQKeySequence のリストを返します。

fromString() およびlistToString()も参照してください 。

[static] QString QKeySequence::listToString(const QList<QKeySequence> &list, QKeySequence::SequenceFormat format = PortableText)

format に基づいて、list の文字列表現を返します。

toString() およびlistFromString()も参照してください 。

QKeySequence::SequenceMatch QKeySequence::matches(const QKeySequence &seq) const

seq で指定されたシーケンスと一致するかどうかを判定します。一致した場合は `ExactMatch ` を返し、seq との一致が不完全な場合は `PartialMatch ` を返し、シーケンス間に共通点がない場合は `NoMatch ` を返します。seq がより短い場合は `NoMatch ` を返します。

[static] QKeySequence QKeySequence::mnemonic(const QString &text)

text に指定されたニーモニックに対応するショートカットキーのシーケンスを返します。ニーモニックが見つからない場合は、空のキーシーケンスを返します。

たとえば、mnemonic("E&xit") は `Qt::ALT+Qt::Key_X` を返し、mnemonic("&Quit") は `ALT+Key_Q` を返し、mnemonic("Quit") は空の `QKeySequence` を返します。

[noexcept] void QKeySequence::swap(QKeySequence &other)

このキーシーケンスを「other 」と入れ替えます。この操作は非常に高速で、失敗することはありません。

QString QKeySequence::toString(QKeySequence::SequenceFormat format = PortableText) const

format に基づいて、キーシーケンスの文字列表現を返します。

たとえば、Qt::CTRL+Qt::Key_O という値の場合、結果は "Ctrl+O" となります。キーシーケンスに複数のキーコードが含まれる場合、返される文字列ではそれぞれがコンマで区切られます（例: "Alt+X, Ctrl+Y, Z"）。 「Ctrl」、「Shift」などの文字列は、「QShortcut 」コンテキストでQObject::tr() を使用して変換されます。

キーシーケンスにキーが含まれていない場合、空の文字列が返されます。

Apple プラットフォームでは、format がQKeySequence::NativeText に設定されている場合、返される文字列はメニューバーに表示されるシーケンスに似ています。それ以外の場合は、ファイルへの書き込みに適した「ポータブル」形式の文字列が使用されます。

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

QKeySequence::operator QVariant() const

キーシーケンスをQVariant

bool QKeySequence::operator!=(const QKeySequence &other) const

このキーシーケンスが `other ` のキーシーケンスと等しくない場合は `true ` を返し、等しい場合は `false` を返します。

bool QKeySequence::operator<(const QKeySequence &other) const

このキーシーケンスとother のキーシーケンスとの間で、任意の比較を行います。保証されるのは、両方のキーシーケンスが等しい場合に演算子がfalse を返し、キーシーケンスが等しくない場合に(ks1 < ks2) == !(ks2 < ks1)となることだけです。

この関数は、例えば、QKeySequence オブジェクトをQMap のキーとして使用したい場合など、特定の状況で役立ちます。

operator==()、operator!=()、operator>()、operator<=()、およびoperator>=()も参照してください 。

bool QKeySequence::operator<=(const QKeySequence &other) const

このキーシーケンスがother のキーシーケンス以下である場合はtrue を返し、そうでない場合はfalse を返します。

operator==()、operator!=()、operator<()、operator>()、およびoperator>=()も参照してください 。

[noexcept] QKeySequence &QKeySequence::operator=(QKeySequence &&other)

other をこのQKeySequence インスタンスに割り当てます。

QKeySequence &QKeySequence::operator=(const QKeySequence &other)

代入演算子。このオブジェクトに「other 」というキーシーケンスを代入します。

bool QKeySequence::operator==(const QKeySequence &other) const

このキーシーケンスがother のキーシーケンスと等しい場合はtrue を返し、そうでない場合はfalse を返します。

bool QKeySequence::operator>(const QKeySequence &other) const

このキーシーケンスがother のキーシーケンスよりも大きい場合はtrue を返し、そうでない場合はfalse を返します。

operator==()、operator!=()、operator<()、operator<=()、およびoperator>=()も参照してください 。

bool QKeySequence::operator>=(const QKeySequence &other) const

このキーシーケンスがother のキーシーケンス以上である場合はtrue を返し、そうでない場合はfalse を返します。

operator==()、operator!=()、operator<()、operator>()、およびoperator<=()も参照してください 。

QKeyCombination QKeySequence::operator[](uint index) const

キーシーケンス内の位置index にある要素への参照を返します。これは要素を読み取る目的でのみ使用できます。