Windows API로 UI를 만들 경우 폰트가 다음과 같이 투박하게 보여짐을 확인할 수 있다.
기본적으로 투박한 폰트로 보여지는 Windows API 윈도우
본 포스팅에서는 Windows API로 작성한 윈도우에 폰트를 적용하는 방법에 대해 정리하겠다.
시스템 정의 기본 폰트 사용하기
시스템 정의 기본 폰트는 제목 표시줄, 메시지 박스, 메뉴, 상태 표시줄, 캡션 표시줄 등에 사용되기 위해 미리 정의된 폰트이다. 이를 불러오기 위해서는 SystemParametersInfo 함수를 SPI_GETNONCLIENTMETRICS 매개변수를 적용하여 호출한다.
WndProc 콜백 프로시저의 WM_CREATE 섹션에 다음과 같이 적는다.
/* WndProc: HWND, UINT, WPARAM, LPARAM */
// 새로 지정할 폰트 핸들
static HFONT s_hFont = (HFONT)NULL;
// 시스템 정의 폰트는 NONCLIENTMETRICS라는 구조체를 통해 전달된다.
NONCLIENTMETRICS nonClientMetrics;
/* ... */
// 구조체의 내용을 0으로 리셋한다.
ZeroMemory(&nonClientMetrics, sizeof(NONCLIENTMETRICS));
// cbSize 필드만 특별히 구조체의 크기로 지정한다.
nonClientMetrics.cbSize = sizeof(NONCLIENTMETRICS);
// 구조체를 통해 전달되는 폰트는 LOGFONT 형식이다.
// GDI에서 사용하기 위해 LOGFONT에서 기술된 폰트 정보를 바탕으로 HFONT를 생성한다.
s_hFont = CreateFontIndirect(&nonClientMetrics.lfCaptionFont);
// 창 스스로에게 WM_SETFONT 메시지를 전달한다.
SendMessage(hWnd, WM_SETFONT, (WPARAM)s_hFont, (LPARAM)MAKELONG(TRUE, 0));
자기 자신에게 WM_SETFONT를 전달했으므로 WndProc에서 WM_SETFONT 섹션을 추가하여 이벤트를 처리해보겠다. 다음은 그 예이다.
/* WndProc: HWND, UINT, WPARAM, LPARAM */
// 새로 지정할 폰트 핸들
static HFONT s_hFont = (HFONT)NULL;
// 시스템 정의 폰트는 NONCLIENTMETRICS라는 구조체를 통해 전달된다.
NONCLIENTMETRICS nonClientMetrics;
/* ... */
lResult = DefWindowProc(hWnd, uMessage, wParam, lParam);
// Static 윈도우에 폰트 변경 메시지를 보낸다.
SendMessage(s_hwndStatic, WM_SETFONT, wParam, lParam);
/* ... */
다음과 같이 윈도우의 폰트가 변경되었음을 확인할 수 있다.
시스템 정의 기본 폰트로 변경된 모습
LOGFONT 직접 지정하기
시스템 기본 폰트 외에 다른 폰트를 지정해보겠다. LOGFONT 구조체의 각 멤버들을 직접 지정하면 다양한 폰트들을 얻어서 윈도우에 적용 가능하다.
위와 같이 레이아웃을 구성한 다음 [찾아보기(B)...] 버튼(ID_BUTTON, s_hwndButton)을 클릭하여 폴더 다이얼로그를 띄우도록 하겠다. WM_COMMAND에서 LOWORD(wParam) 값이 ID_BUTTON인 경우에 다음과 같이 이벤트를 처리한다.
/* WndProc: HWND, UINT, WPARAM, LPARAM */
case WM_COMMAND:
switch (LOWORD(wParam))
{
case ID_BUTTON:
{
BROWSEINFO browseInfo;
ITEMIDLIST * pidlBrowse = NULL;
TCHAR szPath[MAX_PATH];
TCHAR szDisplayName[MAX_PATH];
ZeroMemory(&browseInfo, sizeof(BROWSEINFO));
// 본 다이얼로그를 소유한 창의 핸들이다.
browseInfo.hwndOwner = hWnd;
// 여기서 지정한 특정 폴더 이하의 경로만 선택 가능하다.
browseInfo.pidlRoot = (LPCITEMIDLIST)NULL;
// 폴더의 실제 이름과 보여지는 이름이 다를 때 지정한 버퍼로 보여지는 이름을 전달한다.
browseInfo.pszDisplayName = szDisplayName;
// 폴더 다이얼로그를 통해 사용자에게 보여질 메시지를 지정한다.
browseInfo.lpszTitle = TEXT("선택하고 싶은 폴더를 선택합니다...");
// 각종 옵션을 지정한다.
browseInfo.ulFlags =
BIF_NEWDIALOGSTYLE | // 새로운 형식의 다이얼로그([새 폴더 만들기] 버튼 있는 창)
BIF_RETURNONLYFSDIRS | // 로컬 경로의 디렉토리만 선택 가능하도록 함
BIF_EDITBOX; // 폴더 이름을 타자로도 입력할 수 있도록 텍스트 상자 제공함
// 다이얼로그 창에 대한 콜백을 지정한다.
browseInfo.lpfn = BrowseProc;
// 콜백 함수에 전달할 추가적인 데이터가 있다면 이것을 통해 전달한다.
browseInfo.lParam = (LPARAM)NULL;
// 폴더 열기 다이얼로그를 실행한다.
pidlBrowse = SHBrowseForFolder(&browseInfo);
if (pidlBrowse != NULL)
{
// 다이얼로그에서 선택한 폴더 항목을 문자열 경로로 변환한다.
if (SHGetPathFromIDList(pidlBrowse, szPath))
{
// 경로를 Edit로 출력하고
SetWindowText(s_hwndEdit, szPath);
// 선택한 폴더의 DisplayName도 Static으로 출력한다.
SetWindowText(s_hwndStatic3, szDisplayName);
}
else
{
OutputDebugString(TEXT("Invalid Path\n"));
}
}
}
break;
/* ... */
BIF_NEWDIALOGSTYLE를 적용한 다이얼로그BIF_NEWDIALOGSTYLE를 적용하지 않은 다이얼로그
콜백 프로시저
다이얼로그의 콜백 프로시저는 다음과 같이 선언한다.
int CALLBACK BrowseProc(HWND hWnd, UINT uMsg, LPARAM lParam, LPARAM lpData)
다음은 콜백 함수의 구현 예시이다.
/* BrowseProc: HWND, UINT, LPARAM, LPARAM */
int CALLBACK BrowseProc(HWND hWnd, UINT uMsg, LPARAM lParam, LPARAM lpData)
{
static TCHAR s_szPath[MAX_PATH];
int iResult = 0;
switch (uMsg)
{
case BFFM_INITIALIZED:
// 다이얼로그 상자가 이제 막 떴을 때 처리할 내용은 이 곳에 적는다.
// BFFM_SETSELECTION: 기본 값으로 선택하고 있을 폴더가 있을 때 사용한다.
// lParam은 선택하고 있을 폴더이다.
// lParam이 텍스트 형식의 경로라면 wParam = TRUE
// lParam이 PIDL 형식의 객체라면 wParam = FALSE
SendMessage(hWnd, BFFM_SETSELECTION, TRUE, lParam);
// BFFM_SEROKTEXT: [확인] 버튼의 텍스트를 변경한다.
// lParam은 [확인] 버튼에 새로 넣을 텍스트이다.
SendMessage(hWnd, BFFM_SETOKTEXT, 0, (LPARAM)TEXT("이걸로"));
break;
case BFFM_SELCHANGED:
if (SHGetPathFromIDList((LPITEMIDLIST)lParam, s_szPath))
{
if (_tcsstr(s_szPath, TEXT("blocked")))
{
// 예를 들어,
// 경로 중 일부 문자에 "blocked"가 포함되면 확인버튼 비활성화.
// BFFM_ENABLEOK: [확인] 버튼을 활성화/비활성화 한다.
// lParam은 [확인] 버튼의 활성화(TRUE) / 비활성화(FALSE) 여부이다.
SendMessage(hWnd, BFFM_ENABLEOK, 0, FALSE);
}
else
{
SendMessage(hWnd, BFFM_ENABLEOK, 0, TRUE);
// BFFM_SETSTATUSTEXT: 현재 선택한 폴더 경로를 다이얼로그의 Text 속성으로 지정함.
// lParam은 새로 선택된 폴더 경로
SendMessage(hWnd, BFFM_SETSTATUSTEXT, 0, (LPARAM)s_szPath);
}
}
break;
case BFFM_VALIDATEFAILED:
// 다이얼로그에 전달된 문자열이 잘못되었을 때 처리할 내용은 이 곳에 적는다.
// 다이얼로그를 계속 띄우고 있으려면 콜백이 Non-zero를 반환한다.
// 다이얼로그를 닫으려면 콜백이 0을 반환한다.
break;
}
return 0;
}
실행 결과
위 그림은 C:\Users를 선택한 후 [확인] 버튼을 누른 결과이다. 해당 폴더의 실제 이름은 Users이지만 한국어 모드에서는 사용자라는 이름으로 표시된다. 이것은 BROWSERINFO.pszDisplayName멤버로 전달된다.
