다음을 통해 공유

TTEmbedFontFromFileA 함수(t2embapi.h)

  • 아티클

하위 집합 와이드 문자(16비트) 글꼴을 포함하는 글꼴 구조를 만듭니다. 외부 파일은 글꼴 정보를 제공합니다.

이 함수는 문서 스트림에 삽입하기 위해 클라이언트 정의 콜백 루틴에 데이터를 전달합니다.

구문

LONG TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

매개 변수

[in] hDC

디바이스 컨텍스트 핸들입니다.

[in] szFontFileName

포함할 글꼴 파일 이름 및 경로입니다. ANSI 문자열입니다.

[in] usTTCIndex

포함할 실제 글꼴을 식별하는 TTC(글꼴 파일)에 대한 인덱스(0부터 시작)입니다. 파일에 단일 글꼴(예: TTF 또는 OTF 개요 파일)이 포함된 경우 이 매개 변수를 0으로 설정해야 합니다.

[in] ulFlags

포함 요청을 지정하는 플래그입니다. 이 플래그는 다음 값 중 0개 이상을 가질 수 있습니다.

값 의미
TTEMBED_EMBEDEUDC
 연결된 EUDC 글꼴 파일 데이터를 글꼴 구조에 포함합니다.
TTEMBED_RAW
 압축되지 않은 전체 문자 집합을 포함하는 글꼴 구조를 반환합니다. 함수의 기본 동작입니다.
TTEMBED_SUBSET
 pusCharCodeSet 또는 pulCharCodeSet 매개 변수로 표시된 문자 모양만 포함하는 하위 집합 글꼴을 반환합니다. 이러한 문자 코드는 매개 변수에 적합한 16비트 또는 UCS-4 문자로 표시되어야 합니다.
TTEMBED_TTCOMPRESSED
 압축된 글꼴 구조를 반환합니다.

[in] ulCharSet

포함할 글꼴의 문자 집합을 지정하는 플래그입니다. 이 플래그에는 다음 값 중 하나가 있을 수 있습니다.

값 의미
CHARSET_UNICODE
 16비트 문자 인코딩이 필요한 유니코드 문자 집합입니다.
CHARSET_SYMBOL
 16비트 문자 인코딩이 필요한 기호 문자 집합입니다.

[out] pulPrivStatus

글꼴의 포함 권한을 나타내는 플래그에 대한 포인터입니다. 이 플래그에는 다음 값 중 하나가 있을 수 있습니다. 이 함수는 부여된 최소 제한 라이선스를 반환합니다.

값 의미
EMBED_PREVIEWPRINT
 미리 보기 및 인쇄 포함.
EMBED_EDITABLE
 편집 가능한 포함.
EMBED_INSTALLABLE
 설치 가능한 포함.
EMBED_NOEMBEDDING
 제한된 라이선스 포함.

[out] pulStatus

포함 요청에 대한 상태 정보가 포함된 비트 필드에 대한 포인터입니다. 이 필드는 이 함수가 완료되면 채워집니다. 현재 이 매개 변수에 대해 정의된 비트가 없습니다.

lpfnWriteToStream

글꼴 구조를 문서 스트림에 쓰는 클라이언트 정의 콜백 함수에 대한 포인터입니다. WRITEEMBEDPROC를 참조하세요.

[in] lpvWriteStream

출력 스트림을 나타내는 토큰입니다.

[in] pusCharCodeSet

하위 설정을 위한 선택적 유니코드 문자 코드가 포함된 버퍼에 대한 포인터입니다. 이 필드는 글꼴 하위 설정에만 사용되며ulFlagsfield에서 TTEMBED_SUBSET 지정하지 않으면 무시됩니다.

[in] usCharCodeCount

pusCharCodeSet으로 표시된 문자 목록의 문자 수입니다. 이 필드는 글꼴 하위 설정에만 사용되며 ulFlags 필드가 TTEMBED_SUBSET 지정하지 않으면 무시됩니다.

[in] usLanguage

하위 설정을 지정할 때 유지할 이름 테이블의 언어를 지정합니다. 모든 언어를 유지하려면 0으로 설정합니다. 이 필드는 글꼴 하위 설정에만 사용되며 ulFlags 필드가 TTEMBED_SUBSET 지정하지 않으면 무시됩니다.

[in, optional] pTTEmbedInfo

포함된 글꼴 개체를 합법적으로 참조할 수 있는 URL을 포함하는 TTEMBEDINFO 구조체에 대한 포인터입니다. pTTEmbedInfo가 NULL이면 포함된 글꼴 개체에 URL이 추가되지 않으며 클라이언트가 TTLoadEmbeddedFont 함수를 호출할 때 URL 검사가 수행되지 않습니다.

반환 값

포함에 성공하면 E_NONE 반환합니다.

글꼴 구조는 클라이언트에 의해 문서 스트림에 통합됩니다. pulPrivStatus 가 설정되어 글꼴의 포함 권한을 나타냅니다. 및 pulStatus 는 포함 작업의 결과를 제공하도록 설정됩니다.

그렇지 않으면 Embedding-Function 오류 메시지에 설명된 오류 코드를 반환합니다.

설명

이 함수는 글꼴 구조를 문서 스트림에 포함하기 위한 클라이언트 정의 콜백 루틴을 참조합니다.

클라이언트는 글꼴의 문자 집합을 확인하고 나타내는 역할을 담당합니다.

디바이스 컨텍스트에서 유니코드 문자를 포함하는 방법에 대한 자세한 내용은 TTEmbedFont; 디바이스 컨텍스트에서 UCS-4 문자를 포함하는 방법에 대한 자세한 내용은 TTEmbedFontEx를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 t2embapi.h
라이브러리 T2embed.lib
DLL T2embed.dll

추가 정보

TTEMBEDINFO

TTEmbedFont

TTEmbedFontEx

TTLoadEmbeddedFont