GetFontData 함수(wingdi.h)
GetFontData 함수는 TrueType 글꼴에 대한 글꼴 메트릭 데이터를 검색합니다.
구문
DWORD GetFontData(
[in] HDC hdc,
[in] DWORD dwTable,
[in] DWORD dwOffset,
[out] PVOID pvBuffer,
[in] DWORD cjBuffer
);
매개 변수
[in] hdc
디바이스 컨텍스트에 대한 핸들입니다.
[in] dwTable
글꼴 데이터를 검색할 글꼴 메트릭 테이블의 이름입니다. 이 매개 변수는 Microsoft Corporation에서 게시한 TrueType 글꼴 파일 사양에 설명된 메트릭 테이블 중 하나를 식별할 수 있습니다. 이 매개 변수가 0이면 TrueType 글꼴 파일의 파일 시작 또는 현재 선택한 TrueType 컬렉션 파일 글꼴에 대한 데이터 시작부터 정보가 검색됩니다. TrueType 컬렉션 파일에 대한 파일의 시작 부분에서 데이터를 검색하려면 'ttcf'(0x66637474)를 지정합니다.
[in] dwOffset
글꼴 메트릭 테이블의 시작부터 함수가 정보 검색을 시작해야 하는 위치까지의 오프셋입니다. 이 매개 변수가 0이면 dwTable 매개 변수로 지정된 테이블의 시작 부분에서부터 정보가 검색됩니다. 이 값이 테이블 크기보다 크거나 같으면 오류가 발생합니다.
[out] pvBuffer
글꼴 정보를 수신하는 버퍼에 대한 포인터입니다. 이 매개 변수가 NULL이면 함수는 글꼴 데이터에 필요한 버퍼의 크기를 반환합니다.
[in] cjBuffer
검색할 정보의 길이(바이트)입니다. 이 매개 변수가 0이면 GetFontData 는 dwTable 매개 변수에 지정된 데이터의 크기를 반환합니다.
반환 값
함수가 성공하면 반환 값은 반환된 바이트 수입니다.
함수가 실패하면 반환 값이 GDI_ERROR.
설명
이 함수는 글꼴 조작 애플리케이션을 통해 글꼴 파일에서 직접 TrueType 글꼴 정보를 검색하는 데 사용됩니다. 글꼴 포함에 대한 자세한 내용은 글 꼴 포함 참조를 참조하세요.
경우에 따라 애플리케이션에서 GetFontData 함수를 사용하여 문서에 TrueType 글꼴을 저장할 수 있습니다. 이를 위해 애플리케이션은 OUTLINETEXTMETRIC 구조의 otmfsType 멤버를 확인하여 글꼴을 포함할 수 있는지 여부를 결정합니다. otmfsType의 비트 1이 설정된 경우 글꼴에 포함할 수 없습니다. 비트 1이 명확하면 글꼴을 포함할 수 있습니다. 비트 2가 설정된 경우 포함은 읽기 전용입니다. 포함이 허용되는 경우 애플리케이션은 dwTable, dwOffset 및 cbData 매개 변수에 대해 0을 지정하여 전체 글꼴 파일을 검색할 수 있습니다.
애플리케이션이 이 함수를 사용하여 TrueType이 아닌 글꼴에 대한 정보를 검색하려고 하면 오류가 발생합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h(Windows.h 포함) |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |