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);

"파일|열기" 번역기 주석을 참고하세요. 반드시 필요한 것은 아니지만 인간 번역가에게 약간의 컨텍스트를 제공합니다.

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 에 있는 니모닉에 대한 바로가기 키 시퀀스를 반환하거나 니모닉이 없는 경우 빈 키 시퀀스를 반환합니다.

예를 들어, 니모닉("E&xit")은 Qt::ALT+Qt::Key_X, 니모닉("&Quit")은 ALT+Key_Q, 니모닉("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 인 경우 메뉴 표시줄에 표시되는 시퀀스와 유사하며, 그렇지 않으면 파일에 쓰기에 적합한 "portable" 형식을 사용합니다.

fromString()도 참조하세요 .

QVariant 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)을 반환한다는 것만 보장됩니다.

이 함수는 QMap 에서 QKeySequence 객체를 키로 사용하려는 경우와 같이 일부 상황에서 유용합니다.

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 위치에 있는 요소에 대한 참조를 반환합니다. 이 함수는 엘리먼트를 읽는 데만 사용할 수 있습니다.