EnterKeyAction QML Type

입력 키를 사용자 지정하기 위한 첨부 속성을 제공합니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard

첨부된 속성

상세 설명

EnterKeyAction 유형은 키보드의 입력 키 버튼을 사용자 지정할 수 있는 첨부 프로퍼티를 제공합니다.

입력 포커스를 받는 항목(예: TextInput) 내부에서 EnterKeyAction을 직접 사용해야 합니다.

예를 들어

TextInput {
    id: myInput
    EnterKeyAction.enabled: myInput.text.length > 0 || myInput.inputMethodComposing
    EnterKeyAction.label: "Next"
    Keys.onReleased: {
        if (event.key === Qt.Key_Return) {
            // execute action
        }
    }
}

첨부 속성 문서

EnterKeyAction.actionId : int

가상 키보드의 엔터 키에 대한 동작 ID를 설정합니다. 동작 ID가 설정되면 레이블보다 우선적으로 적용되며 입력 키의 아이콘이 설정됩니다.

  • EnterKeyAction.None 동작이 정의되지 않았습니다.
  • EnterKeyAction.Go 동작은 이동 작업을 수행합니다. 예를 들어 사용자가 입력한 URL로 이동합니다.
  • EnterKeyAction.Search 액션이 검색 작업을 수행합니다.
  • EnterKeyAction.Send 동작이 입력된 텍스트를 보냅니다.
  • EnterKeyAction.Next 액션은 입력 포커스를 텍스트 입력을 허용하는 다음 필드로 이동합니다.
  • EnterKeyAction.Done 모든 텍스트 입력이 완료된다는 점을 제외하면 EnterKeyAction.Next 과 동일합니다.

EnterKeyAction.enabled : bool

가상 키보드에서 입력 키 버튼을 활성화 또는 비활성화합니다.


EnterKeyAction.label : string

가상 키보드에서 입력 키의 레이블을 설정합니다.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.