가상 키보드 숨기기 함수

이 문서에서는 게임이 실행되는 장치에서 가상 키보드를 숨기는 데 사용되는 keyboard_virtual_hide 함수에 대해 설명합니다. 이 함수는 Windows에서 IME(입력기)를 비활성화하며, 다시 활성화하려면 keyboard_virtual_show 함수를 호출해야 합니다.

함수 설명

• 함수 이름: keyboard_virtual_hide
• 기능: 가상 키보드를 숨깁니다.
• Windows에서의 동작: IME를 비활성화합니다.
• 이벤트 발생: 이 함수를 호출하면 System Asynchronous Event가 생성되며, async_loadDS 맵에 다음과 같은 키/값 쌍이 채워집니다.
• "event_type": 가상 키보드 함수에 의해 트리거될 때 "virtual keyboard status"로 설정됩니다.
• "screen_height": 가상 키보드의 높이(픽셀 단위). 키보드가 보이지 않으면 0으로 설정됩니다.
• "keyboard_status": 키보드의 현재 상태로, 다음 문자열 중 하나로 반환됩니다.
  • "hiding"
  • "hidden"
  • "showing"
  • "visible"

문법

keyboard_virtual_hide();

반환값

• N/A (반환값 없음)

활용 예제

다음은 가상 키보드를 숨기는 간단한 예제입니다.

if (input == true) {
    input = false;
    keyboard_virtual_hide();
}

위 코드는 주어진 변수가 false로 설정되지 않은 경우 운영 체제의 가상 키보드를 숨깁니다.

추가 활용 예제

// 예제 1: 버튼 클릭 시 가상 키보드 숨기기
if (button_clicked) {
    keyboard_virtual_hide();
}

// 예제 2: 텍스트 필드 포커스 잃을 때 가상 키보드 숨기기
if (!text_field_has_focus) {
    keyboard_virtual_hide();
}

// 예제 3: 화면 전환 시 가상 키보드 숨기기
if (screen_transition) {
    keyboard_virtual_hide();
}

// 예제 4: 입력 완료 시 가상 키보드 숨기기
if (input_complete) {
    keyboard_virtual_hide();
}