[WinAPI] Edit Control에서 Enter키 입력 받기
WinAPI의 Edit control은 사용자의 입력을 받는 컨트롤 중 하나입니다.
때때로는 설계 방식에 따라, 이 입력 도중 Enter키를 통해 특정 상호작용을 해야 할 때가 있습니다.
이번 글에서는 그에 대해 다루어 보도록 하겠습니다.
1. UI 설정
글에서 목표하는 바는 Edit control에서 Enter키가 개행 이외의 방법으로 작동 되게 하는 것 입니다.
이를 위해 간단하게 Edit Control이 있는 UI를 만들어 보도록 하겠습니다.
코드 및 형태는 아래와 같습니다.
#include <stdlib.h>
#include <string.h>
#include <tchar.h>
#include <string>
#include <Windows.h>
#define ID_EDIT 100
static TCHAR szWindowClass[] = _T("DesktopApp");
static TCHAR szTitle[] = _T("Simple APP");
LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
HWND hEdit;
int WINAPI WinMain(
_In_ HINSTANCE hInstance,
_In_opt_ HINSTANCE hPrevInstance,
_In_ LPSTR lpCmdLine,
_In_ int nCmdShow
) {
WNDCLASSEX wcex;
wcex.cbSize = sizeof(WNDCLASSEX);
wcex.style = CS_HREDRAW | CS_VREDRAW;
wcex.lpfnWndProc = WndProc;
wcex.cbClsExtra = 0;
wcex.cbWndExtra = 0;
wcex.hInstance = hInstance;
wcex.hIcon = LoadIcon(wcex.hInstance, IDI_APPLICATION);
wcex.hCursor = LoadCursor(NULL, IDC_ARROW);
wcex.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
wcex.lpszMenuName = NULL;
wcex.lpszClassName = szWindowClass;
wcex.hIconSm = LoadIcon(wcex.hInstance, IDI_APPLICATION);
if (!RegisterClassEx(&wcex)) {
MessageBox(NULL,
_T("Call to RegisterClassEx failed!"),
_T("Simple APP"),
NULL);
return 1;
}
HWND hWnd = CreateWindowEx(
WS_EX_OVERLAPPEDWINDOW,
szWindowClass,
szTitle,
WS_OVERLAPPEDWINDOW,
10, 10,
310, 510,
NULL,
NULL,
hInstance,
NULL
);
if (!hWnd) {
MessageBox(NULL,
_T("Call to CreateWindow failed!"),
_T("Windows Desktop Guided Tour"),
NULL);
return 1;
}
ShowWindow(hWnd, nCmdShow);
UpdateWindow(hWnd);
MSG msg;
while (GetMessage(&msg, NULL, 0, 0)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
return (int)msg.wParam;
}
LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
switch (uMsg) {
case WM_CREATE:
hEdit = CreateWindowEx(
0, L"EDIT",
NULL,
WS_CHILD | WS_VISIBLE | WS_BORDER |
ES_LEFT | ES_MULTILINE | ES_AUTOVSCROLL | ES_WANTRETURN,
10, 410,
270, 50,
hWnd,
(HMENU)ID_EDIT,
(HINSTANCE)GetWindowLongPtr(hWnd, GWLP_HINSTANCE),
NULL);
break;
case WM_DESTROY:
PostQuitMessage(0);
break;
default:
return DefWindowProc(hWnd, uMsg, wParam, lParam);
break;
}
return DefWindowProc(hWnd, uMsg, wParam, lParam);
}
위 실행 화면 하단부의 Edit control에서 사용자의 입력을 받고, Enter키가 입력되었을 경우 특정 행동을 하도록 (이 글에서는 화면 상단에 기록이 남도록)해 보도록 하겠습니다.
2. Enter 키 반응
Edit control에 포커스가 있는 동안에는 특정 키 입력이 되지 않습니다.
이는 Edit control에 추가적인 Procedure를 설정하는 것으로 해결할 수 있습니다.
기본 UI 코드가 긴 관계로, 추가되는 코드만 작성하도록 하겠습니다.
WNDPROC DefEditProc;
LRESULT CALLBACK SubEditProc(HWND, UINT, WPARAM, LPARAM);
LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
switch (uMsg) {
case WM_CREATE:
DefEditProc = (WNDPROC)SetWindowLongPtr(hEdit, GWLP_WNDPROC, (LONG_PTR)SubEditProc);
...
}
...
}
LRESULT CALLBACK SubEditProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
HDC hdc;
PAINTSTRUCT ps;
RECT rt = { 10, 10, 100, 100 };
switch (uMsg) {
case WM_KEYDOWN:
switch (wParam) {
case VK_RETURN:
//
// Code
//
break;
}
break;
default:
return CallWindowProc(DefEditProc, hWnd, uMsg, wParam, lParam);
}
return FALSE;
}Edit control을 생성하고, Edit control에 대하여 적용되는 추가적인 Procedure를 정의한 모습입니다.
Enter키에 해당하는 파라미터인 VK_RETURN에 대하여 행동을 정의하는 것으로, Enter키 입력을 받을 수 있습니다.
3. Not Ctrl + Enter
Enter키를 입력으로 받는 몇몇 프로그램의 경우, Enter키를 조합하여 사용하는 키(Alt, Ctrl 등)에 대하여는 Enter키와 다른 기능을 하는 경우가 대부분입니다.
이 경우는, Enter키 입력을 처리하기 전에 다른 키가 중복되어 입력되어 있는지 확인하는 것으로 구현할 수 있습니다.
switch (wParam) {
case VK_RETURN:
if (!GetAsyncKeyState(VK_CONTROL)) {
//
// Code
//
}
break;
}GetAsyncKeyState는 인자로 받은 키의 입력 여부를 반환합니다.
위 코드는 부정 연산자를 사용함으로써, Ctrl이 눌리지 않았을 경우의 Enter 입력에 대하여 작동하는 코드입니다.
위 문단에서 정의한 Edit control에 ES_MULTILINE옵션은 Edit control에 대한 여러 줄 입력을 허용하는 옵션입니다.
위와 같은 코드를 작성함으로써, Enter키에 대하여는 특정 동작을 수행하고, Ctrl + Enter에 대하여는 개행을 할 수 있도록 구현할 수 있습니다.
4. Write text
위 문단의 내용을 통해 Enter키에 대해 특정 행동을 할 수 있는 조건문을 만들었습니다.
이제 이 조건문 내부에 특정 행동을 정의하면 됩니다.
이 글에서는 첫 문단의 내용대로 입력한 텍스트를 지우고, 상단에 출력하도록 하는 코드를 작성하도록 하겠습니다.
HDC hdc;
RECT rt;
if (!GetAsyncKeyState(VK_CONTROL)) {
hdc = GetDC(GetParent(hEdit));
GetClientRect(GetParent(hEdit), &rt);
TCHAR buff[1024];
GetWindowText(hEdit, buff, 1024);
SetWindowText(hEdit, 0);
DrawText(hdc, buff, -1, &rt, DT_CENTER);
ReleaseDC(GetParent(hEdit), hdc);
}구현하는 방법은 여러가지가 있겠지만, 위와 같은 방식으로 Edit control의 텍스트를 지우고 이용할 수 있습니다.
5. Issue : CRLF
위 문단의 코드에는 아쉬운 문제점이 하나 있습니다.
Enter키를 입력해서 텍스트를 지우게 될 때, 개행문자는 지워지지 않는 문제가 있습니다.
이 문제의 원인은 개행 문자의 입력과 조건문 사이의 서순이 원인입니다.
깔끔한 해답은 찾지 못 했지만, 제가 찾은 두 가지 해결책을 공유하도록 하겠습니다.
첫 번째 방법은 서순을 변경하는 것 입니다.
이것은 Procedure의 Message를 변경하는 것으로 간단하게 해결 가능합니다.
// Before
switch (uMsg) {
case WM_KEYDOWN:
...
break;
...
}
// After
switch (uMsg) {
case WM_KEYUP:
...
break;
...
}위 문단의 WM_KEYDOWN을 WM_KEYUP으로 변경하면 입력 이후 개행 문자가 남아있는 문제를 해결할 수 있습니다.
하지만, KEYUP 이전에 개행 문자가 삽입되고, 입력 기능이 동작하기 전에 추가적인 키보드 입력이 발생할 수 있다는 점에서 시각적, 기능적으로 깔끔하지 못 한 경향이 있습니다.
두 번째 방법은 Edit control을 새로 생성하는 것 입니다.
#define MY_CLEAR (WM_USER + 1)
LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
switch (uMsg) {
...
case MY_CLEAR:
//RemovePropW(hEdit, 0);
SendMessage(hEdit, WM_CLOSE, 0, 0);
hEdit = CreateWindowEx(
0, L"EDIT", // predefined class
NULL, // no window title
WS_CHILD | WS_VISIBLE | WS_BORDER |
ES_LEFT | ES_MULTILINE | ES_AUTOVSCROLL,
10, 410,
270, 50, // set size in WM_SIZE message
hWnd, // parent window
(HMENU)ID_EDIT, // edit control ID
(HINSTANCE)GetWindowLongPtr(hWnd, GWLP_HINSTANCE),
NULL); // pointer not needed
DefEditProc = (WNDPROC)SetWindowLongPtr(hEdit, GWLP_WNDPROC, (LONG_PTR)SubEditProc);
SetFocus(hEdit);
break;
...
}
}
LRESULT CALLBACK SubEditProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
switch (uMsg) {
...
case WM_KEYDOWN:
switch (wParam) {
case VK_RETURN:
if (!GetAsyncKeyState(VK_CONTROL)) {
...
...
SendMessage(GetParent(hEdit), MY_CLEAR, 0, 0);
}
}
...
}
}Edit control을 새로 생성하는 메시지를 위한 커스텀 메시지를 정의합니다.
WndProc에 커스텀 메시지를 수신할 경우 Edit control을 제거하고, 새 Edit control을 생성하는 코드를 작성합니다.
이 때, 입력 커서가 사라질 경우 자연스럽지 못 하므로 SetFocus를 통해 커서를 유지시킵니다.
위 기능을 Enter키 입력 동작의 마지막에 호출하는 것으로 개행 문자를 제거할 수 있습니다.
이 구현은 시각적으로는 깔끔할 수 있으나, 사용자가 입력할 때 마다 Control을 새로 생성해야 하므로 성능적인 이슈가 발생할 수 있습니다.
두 방법 모두 명확한 단점이 존재하기 때문에 사용하는 것에 부담감이 있습니다.
이후 더 나은 구현법을 찾을 경우 추가로 작성하도록 하겠습니다.
Win32를 다루는 것이 이번이 처음이라, 구조적인 부분에서 이해도가 많이 부족합니다.
그렇지만 제가 겪은 이슈에 대하여 이후에 참고하거나, 공유하고자 이 글을 작성합니다.
이 글이 지금 겪고계신 이슈와 관련이 있고, 도움이 되길 바랍니다.
감사합니다.