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

추가 정보

글꼴 및 텍스트 함수

글꼴 및 텍스트 개요

GetTextMetrics

OUTLINETEXTMETRIC