Win32_API - 문자열 출력해보기(TextOutW / TextOutA)

서론

기존에 배웠던 지식들을 활용해 Windows 응용 프로그래밍에서 문자열을 출력하기 위한 함수를 알아보고 활용해 보도록 합시다. 

 

문자를 출력하기 위한 함수 TextOutA / TextOutW

사실 두 녀석은 동일한 역할을 하는 함수입니다. 문자열을 윈도우 프로그래밍 안에 출력하기 위한 함수입니다. 

다만 마지막 A와 W는 유니코드를 사용할 것이냐 아스키 코드를 사용할 것이냐입니다.

 

함수의 원형을 살펴보면 아래와 같습니다.

BOOL TextOutW(
  [in] HDC     hdc,
  [in] int     x,
  [in] int     y,
  [in] LPCWSTR lpString,
  [in] int     c
);
BOOL TextOutA(
  [in] HDC    hdc,
  [in] int    x,
  [in] int    y,
  [in] LPCSTR lpString,
  [in] int    c
);

• HDC - 어떤 윈도에 그리기를 할지 지정해 줍니다
• x, y - 좌표 상태의 위치를 지정해 줍니다. (windows의 경우 해당 윈도의 좌측 상단이 0,0에서 증가하는 식으로 됩니다)
• LPCSTR / LPCWSTR - 문자열을 저장합니다.
• c - 문자열의 크기를 입력합니다.

실습 코드와 동작 해석

기존에 만들었던 실습 코드를 활용하여 간단하게 위의 함수로 코드를 작성하고 실행해 보도록 합시다.

#include <windows.h>

#include <stdlib.h>
#include <malloc.h>
#include <memory.h>
#include <tchar.h>


HINSTANCE hInst;

// 이 코드 모듈에 포함된 함수의 선언을 전달합니다:
LRESULT CALLBACK    WndProc(HWND, UINT, WPARAM, LPARAM);


int APIENTRY wWinMain(_In_ HINSTANCE hInstance,
                     _In_opt_ HINSTANCE hPrevInstance,
                     _In_ LPWSTR    lpCmdLine,
                     _In_ int       nCmdShow)
{

    //윈도우 창 구조체 정의 및 적용
    WNDCLASSEXW 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 = NULL;
    wcex.hCursor = LoadCursor(nullptr, IDC_ARROW);
    wcex.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
    wcex.lpszMenuName = NULL;
    wcex.lpszClassName = L"Test";
    wcex.hIconSm = NULL;
    RegisterClassExW(&wcex);

    //적용한 윈도우 생성 및 업데이트
    hInst = hInstance; // 인스턴스 핸들을 전역 변수에 저장합니다.
    HWND hWnd = CreateWindowW(L"Test", L"Test", WS_OVERLAPPEDWINDOW,
        CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, nullptr, nullptr, hInstance, nullptr);
    if (!hWnd)
    {
        return FALSE;
    }
    ShowWindow(hWnd, nCmdShow);
    UpdateWindow(hWnd);
    MSG msg;

    // 기본 메시지 루프입니다:
    while (GetMessage(&msg, nullptr, 0, 0))
    {
            TranslateMessage(&msg);
            DispatchMessage(&msg);
    }

    return (int) msg.wParam;
}

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    HDC hdc;
    switch (message)
    {
    case WM_LBUTTONDOWN:
        hdc = GetDC(hWnd); //DC을얻는 방법 1

        ReleaseDC(hWnd, hdc);
    case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hWnd, &ps);
            // TODO: 여기에 hdc를 사용하는 그리기 코드를 추가합니다...
            TextOutW(hdc, 100, 100, L"Hello World", 12);
            TextOutA(hdc, 200, 200, "Hello World", 12);
            EndPaint(hWnd, &ps);
        }
        break;
    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

주요 해석 부분

    case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hWnd, &ps);
            // TODO: 여기에 hdc를 사용하는 그리기 코드를 추가합니다...
            TextOutW(hdc, 100, 100, L"Hello World", 12);
            TextOutA(hdc, 200, 200, "Hello World", 12);
            EndPaint(hWnd, &ps);
        }

• HDC에 그리기 위한 준비를 마칩니다. (사용할 윈도 및 그리기 도구)
• 해당 TextOutW, TextA에 규칙에 맞게 인자를 넣어 텍스트를 출력합니다.

해당 결과로 보아

좌표는 좌측 상단부터 시작한다는 것을 유추할 수 있습니다.