CHOOSEFONTW 구조체(commdlg.h)
ChooseFont 함수가 글꼴 대화 상자를 초기화하는 데 사용하는 정보를 포함합니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조에서 사용자의 선택에 대한 정보를 반환합니다.
통사론
typedef struct tagCHOOSEFONTW {
DWORD lStructSize;
HWND hwndOwner;
HDC hDC;
LPLOGFONTW lpLogFont;
INT iPointSize;
DWORD Flags;
COLORREF rgbColors;
LPARAM lCustData;
LPCFHOOKPROC lpfnHook;
LPCWSTR lpTemplateName;
HINSTANCE hInstance;
LPWSTR lpszStyle;
WORD nFontType;
WORD ___MISSING_ALIGNMENT__;
INT nSizeMin;
INT nSizeMax;
} CHOOSEFONTW;
회원
lStructSize
형식: DWORD
구조체의 길이(바이트)입니다.
hwndOwner
형식: HWND
대화 상자를 소유하는 창에 대한 핸들입니다. 이 멤버는 유효한 창 핸들이거나 대화 상자에 소유자가 없는 경우 NULL
hDC
형식: HDC
이 멤버는 ChooseFont 함수에서 무시됩니다.
Windows Vista 및 Windows XP/2000: 대화 상자에 글꼴이 나열될 프린터의 디바이스 컨텍스트 또는 정보 컨텍스트에 대한 핸들을 . 이 멤버는 Flags 멤버가 CF_PRINTERFONTS 또는 CF_BOTH 플래그를 지정하는 경우에만 사용됩니다. 그렇지 않으면 이 멤버가 무시됩니다.
lpLogFont
형식: LPLOGFONT
LOGFONT 구조체에 대한 포인터입니다. Flags 멤버에서 CF_INITTOLOGFONTSTRUCT 플래그를 설정하고 다른 멤버를 초기화하는 경우 ChooseFont 함수는 LOGFONT 멤버와 일치하는 글꼴로 대화 상자를 초기화합니다. 사용자가 확인 단추를 클릭하면 ChooseFont 사용자의 선택에 따라 LOGFONT 구조체의 멤버를 설정합니다.
iPointSize
형식: INT
선택한 글꼴의 크기(점의 1/10 단위)입니다. ChooseFont 함수는 사용자가 대화 상자를 닫은 후 이 값을 설정합니다.
Flags
형식: DWORD
글꼴 대화 상자를 초기화하는 데 사용할 수 있는 비트 플래그 집합입니다. 대화 상자가 반환되면 이러한 플래그를 설정하여 사용자 입력을 나타냅니다. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.
| 값 | 의미 |
|---|---|
|
대화 상자에 적용 단추가 표시되도록 합니다. 적용 단추에 대한 WM_COMMAND 메시지를 처리하는 후크 프로시저를 제공해야 합니다. 후크 프로시저는 대화 상자에 WM_CHOOSEFONT_GETLOGFONT 메시지를 보내 글꼴에 대한 현재 선택 항목이 포함된 구조체의 주소를 검색할 수 있습니다. |
|
이 플래그는 사용되지 않습니다. OEM 또는 기호 문자 집합을 사용하는 스크립트를 제외한 모든 스크립트로 글꼴 선택을 제한하려면 CF_SCRIPTSONLY사용합니다. 원래 CF_ANSIONLY 동작을 얻으려면 CF_SELECTSCRIPT 사용하고 lpLogFont가리키는 LOGFONT 구조의 lfCharSet 멤버에 ANSI_CHARSET 지정합니다. |
|
글꼴 열거형에서는 이 플래그가 무시됩니다.
Windows Vista 및 Windows XP/2000: 대화 상자에서 사용 가능한 프린터 및 화면 글꼴을 나열합니다. hDC 멤버는 프린터와 연결된 디바이스 컨텍스트 또는 정보 컨텍스트에 대한 핸들입니다. 이 플래그는 CF_SCREENFONTS 플래그와 CF_PRINTERFONTS 플래그의 조합입니다. |
|
사용자가 취소선, 밑줄 및 텍스트 색 옵션을 지정할 수 있도록 하는 컨트롤이 대화 상자에 표시되도록 합니다. 이 플래그가 설정된 경우 rgbColors 멤버를 사용하여 초기 텍스트 색을 지정할 수 있습니다. lpLogFont 가리키는 구조체의 lfStrikeOut 및 lfUnderline 멤버를 사용하여 취소선 및 밑줄 확인란의 초기 설정을 지정할 수 있습니다. ChooseFont 이러한 멤버를 사용하여 사용자의 선택을 반환할 수 있습니다. |
|
이 구조체의 lpfnHook 멤버에 지정된 후크 프로시저를 사용하도록 설정합니다. |
|
hInstance 및 lpTemplateName 멤버가 기본 템플릿 대신 사용할 대화 상자 템플릿을 지정함을 나타냅니다. |
|
hInstance 멤버가 미리 로드된 대화 상자 템플릿을 포함하는 데이터 블록을 식별함을 나타냅니다. 이 플래그가 지정된 경우 시스템에서 lpTemplateName 멤버를 무시합니다. |
|
ChooseFont 열거하고 고정 피치 글꼴만 선택할 수 있도록 허용해야 합니다. |
|
사용자가 대화 상자에 나열되지 않은 글꼴 또는 스타일을 선택하려고 하면 SelectFont 오류 조건을 나타내야 합니다. |
|
ChooseFont 글꼴 제어판에서 숨기기로 설정된 글꼴을 추가로 표시해야 합니다. Windows Vista 및 Windows XP/2000: 이 플래그는 Windows 7까지 지원되지 않습니다. |
|
ChooseFontlpLogFont 멤버가 가리키는 구조를 사용하여 대화 상자 컨트롤을 초기화해야 합니다. |
|
|
|
CF_NOVECTORFONTS 플래그와 동일합니다. |
|
LOGFONT 구조를 사용하여 대화 상자 컨트롤을 초기화하는 경우 이 플래그를 사용하여 대화 상자에 글꼴 이름 콤보 상자에 대한 초기 선택 항목이 표시되지 않도록 합니다. 텍스트 선택에 적용되는 글꼴 이름이 하나도 없는 경우에 유용합니다. |
|
스크립트 콤보 상자를 사용하지 않도록 설정합니다. 이 플래그를 설정하면 ChooseFont 반환되면 LOGFONT 구조체의 lfCharSet 멤버가 DEFAULT_CHARSET 설정됩니다. 이 플래그는 대화 상자를 초기화하는 데만 사용됩니다. |
|
ChooseFont 글꼴 시뮬레이션을 표시하거나 선택할 수 없습니다. |
|
구조체를 사용하여 대화 상자 컨트롤을 초기화하는 경우 이 플래그를 사용하여 대화 상자에 글꼴 크기 콤보 상자에 대한 초기 선택 항목이 표시되지 않도록 합니다. 텍스트 선택에 적용되는 단일 글꼴 크기가 없는 경우에 유용합니다. |
|
LOGFONT 구조체를 사용하여 대화 상자 컨트롤을 초기화하는 경우 이 플래그를 사용하여 글꼴 스타일 콤보 상자에 대한 초기 선택 항목이 대화 상자에 표시되지 않도록 합니다. 텍스트 선택에 적용되는 단일 글꼴 스타일이 없는 경우에 유용합니다. |
|
ChooseFont 벡터 글꼴 선택을 허용하면 안 됩니다. |
|
글꼴 대화 상자가 가로 방향 글꼴만 나열하도록 합니다. |
|
글꼴 열거형에서는 이 플래그가 무시됩니다.
Windows Vista 및 Windows XP/2000: hDC 멤버로 식별된 디바이스 컨텍스트 또는 정보 컨텍스트와 연결된 프린터에서 지원하는 글꼴만 대화 상자에 나열합니다. 또한 글꼴 형식 설명 레이블이 글꼴 대화 상자의 아래쪽에 표시됩니다. |
|
ChooseFont 확장 가능한 글꼴 선택만 허용하도록 지정합니다. 확장 가능한 글꼴에는 벡터 글꼴, 확장 가능한 프린터 글꼴, TrueType 글꼴 및 다른 기술로 확장된 글꼴이 포함됩니다. |
|
글꼴 열거형에서는 이 플래그가 무시됩니다.
Windows Vista 및 Windows XP/2000: 대화 상자에 시스템에서 지원하는 화면 글꼴만 나열합니다. |
|
ChooseFont 모든 비 OEM 및 기호 문자 집합과 ANSI 문자 집합에 대한 글꼴 선택을 허용해야 합니다. 그러면 CF_ANSIONLY 값이 대체됩니다. |
|
입력에 지정하면 LOGFONT 구조체의 lfCharSet 멤버에서 식별된 문자 집합이 있는 글꼴만 표시됩니다. 사용자는 스크립트 콤보 상자에 지정된 문자 집합을 변경할 수 없습니다. |
|
대화 상자에 도움말 단추가 표시되도록 합니다. hwndOwner 멤버는 사용자가 도움말 단추를 클릭할 때 대화 상자에서 보내는 HELPMSGSTRING 등록된 메시지를 받을 창을 지정해야 합니다. |
|
ChooseFont TrueType 글꼴만 열거하고 선택하도록 허용해야 합니다. |
|
lpszStyle 멤버는 글꼴 스타일 콤보 상자를 초기화하는 데 사용해야 ChooseFont 스타일 데이터가 포함된 버퍼에 대한 포인터입니다. 사용자가 대화 상자를 닫으면 ChooseFont 사용자가 선택한 스타일 데이터를 이 버퍼에 복사합니다.
참고 애플리케이션을 세계화하려면 lpLogFont가리키는 LOGFONT 구조의 lfWeight 및 lfItalic 멤버를 사용하여 스타일을 지정해야 합니다. 시스템 사용자 인터페이스 언어에 따라 스타일 이름이 변경 될 수 있습니다.
|
|
되지 않는.
ChooseFont 이 플래그를 무시합니다.
Windows Vista 및 Windows XP/2000: ChooseFont 프린터와 디스플레이 모두에서 사용할 수 있는 글꼴 선택만 허용해야 합니다. 이 플래그를 지정하면 CF_SCREENSHOTS 및 CF_PRINTERFONTS또는 CF_BOTH 플래그도 지정해야 합니다. |
rgbColors
형식: COLORREF
CF_EFFECTS 플래그가 설정되면 rgbColors 초기 텍스트 색을 지정합니다. ChooseFont 성공적으로 반환되면 이 멤버는 사용자가 선택한 텍스트 색의 RGB 값을 포함합니다. COLORREF 색 값을 만들려면 RGB 매크로를 사용합니다.
lCustData
형식: LPARAM
시스템에서 lpfnHook 멤버로 식별된 후크 프로시저에 전달하는 애플리케이션 정의 데이터입니다. 시스템에서 후크 프로시저에 WM_INITDIALOG 메시지를 보내면 메시지의 lParam 매개 변수는 대화 상자를 만들 때 지정된 CHOOSEFONT 구조체에 대한 포인터입니다. 후크 프로시저는 이 포인터를 사용하여 lCustData 값을 가져올 수 있습니다.
lpfnHook
형식: LPCFHOOKPROC
대화 상자에 대한 메시지를 처리할 수 있는 CFHookProc 후크 프로시저에 대한 포인터입니다. CF_ENABLEHOOK 플래그가 Flags 멤버에 설정되지 않으면 이 멤버는 무시됩니다.
lpTemplateName
형식: LPCTSTR
hInstance 멤버로 식별되는 모듈의 대화 상자 템플릿 리소스 이름입니다. 이 템플릿은 표준 대화 상자 템플릿으로 대체됩니다. 번호가 매겨진 대화 상자 리소스의 경우 lpTemplateNameMAKEINTRESOURCE 매크로에서 반환된 값일 수 있습니다. Flags 멤버에서 CF_ENABLETEMPLATE 플래그를 설정하지 않으면 이 멤버는 무시됩니다.
hInstance
형식: HINSTANCE
CF_ENABLETEMPLATEHANDLE 플래그가 Flags 멤버에 설정된 경우 hInstance 대화 상자 템플릿을 포함하는 메모리 개체에 대한 핸들입니다. CF_ENABLETEMPLATE 플래그가 설정되면 hInstancelpTemplateName 멤버로 명명된 대화 상자 템플릿이 포함된 모듈에 대한 핸들입니다. CF_ENABLETEMPLATEHANDLE 또는 CF_ENABLETEMPLATE 설정되지 않은 경우 이 멤버는 무시됩니다.
lpszStyle
형식: LPTSTR
스타일 데이터입니다. CF_USESTYLE 플래그를 지정하면 ChooseFont 이 버퍼의 데이터를 사용하여 글꼴 스타일 콤보 상자를 초기화합니다. 사용자가 대화 상자를 닫으면 ChooseFont글꼴 스타일 콤보 상자의 문자열을 이 버퍼에 복사합니다.
nFontType
형식: WORD
SelectFont 반환할 때
| 값 | 의미 |
|---|---|
|
글꼴 두께가 굵게 표시됩니다. 이 정보는 LOGFONT 구조체의 lfWeight 멤버에서 복제되며 FW_BOLD동일합니다. |
|
기울기 글꼴 특성이 설정됩니다. 이 정보는 LOGFONT 구조의 lfItalic 멤버에 복제됩니다. |
|
글꼴이 프린터 글꼴입니다. |
|
글꼴 두께는 보통입니다. 이 정보는 LOGFONT 구조체의 lfWeight 멤버에서 복제되며 FW_REGULAR동일합니다. |
|
글꼴이 화면 글꼴입니다. |
|
글꼴은 GDI(그래픽 디바이스 인터페이스)에 의해 시뮬레이션됩니다. |
___MISSING_ALIGNMENT__
nSizeMin
형식: INT
사용자가 선택할 수 있는 최소 지점 크기입니다. ChooseFontCF_LIMITSIZE 플래그가 지정된 경우에만 이 멤버를 인식합니다.
nSizeMax
형식: INT
사용자가 선택할 수 있는 최대 포인트 크기입니다. ChooseFontCF_LIMITSIZE 플래그가 지정된 경우에만 이 멤버를 인식합니다.
발언
메모
commdlg.h 헤더는 SELECTFONT를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 헤더 | commdlg.h |
참고 항목
개념
메이킨트레소스
참조