IPrintOemUni::OutputCharStr 메서드(prcomoem.h)

  • 아티클

메서드 IPrintOemUni::OutputCharStr 를 사용하면 렌더링 플러그 인이 글꼴 문자 모양 인쇄를 제어할 수 있습니다.

구문

HRESULT OutputCharStr(
  PDEVOBJ     pdevobj,
  PUNIFONTOBJ pUFObj,
  DWORD       dwType,
  DWORD       dwCount,
  PVOID       pGlyph
);

매개 변수

pdevobj

DEVOBJ 구조체에 대한 호출자 제공 포인터입니다.

pUFObj

UNIFONTOBJ 구조체에 대한 호출자 제공 포인터입니다.

dwType

pGlyph가 가리키는 문자 모양 지정자 배열의 형식을 나타내는 호출자 제공 값입니다. 유효한 값은 다음과 같습니다.

값 정의
TYPE_GLYPHHANDLE pGlyph 배열 요소는 HGLYPH 형식의 문자 모양 핸들입니다.
TYPE_GLYPHID pGlyph 배열 요소는 DWORD 형식의 문자 모양 식별자입니다.

dwCount

pGlyph가 가리키는 배열의 문자 모양 지정자 수를 나타내는 호출자 제공 값입니다.

pGlyph

문자 모양 지정자의 배열에 대한 호출자 제공 포인터입니다. 여기서 배열 요소 형식은 dwType으로 표시됩니다.

반환 값

메서드는 다음 값 중 하나를 반환해야 합니다.

반환 코드 Description
S_OK
 작업에 성공했습니다.
E_FAIL
 작업이 실패했습니다.
E_NOTIMPL
 메서드가 구현되지 않았습니다.

설명

메서드는 IPrintOemUni::OutputCharStr Unidrv에서 지원하는 PCL, CAPSL 또는 PPDS 형식 문자 출력 명령을 인식하지 못하는 프린터를 지원하는 데 사용됩니다. 그 목적은 렌더링 플러그 인이 글꼴의 문자 모양 인쇄를 제어하고 필요한 경우 문자 모양 대체를 제공 할 수 있도록하는 것입니다.

렌더링 플러그 인이 메서드를 구현 IPrintOemUni::OutputCharStr 하는 경우 Unidrv는 문자열을 스풀링할 준비가 될 때마다 메서드를 호출합니다.

메서드는 문자 모양 지정자의 배열을 받습니다. dwType에 대해 받은 값은 식별자 형식을 나타냅니다.

지정된 글꼴이 디바이스 글꼴인 경우 배열에 문자 모양 핸들이 포함됩니다. 핸들을 문자 코드 또는 명령으로 변환한 다음 인쇄 스풀러로 전송하여 디바이스 문자 모양을 인쇄해야 합니다.

지정된 글꼴이 소프트(TrueType) 글꼴인 경우 배열에는 문자 모양 식별자가 포함됩니다. 식별자는 인쇄해야 하는 이전에 다운로드한 문자 모양을 나타냅니다.

지정된 글꼴이 디바이스 글꼴인 경우 메서드는 다음을 수행해야 합니다.

  1. dwTypeIn이 TYPE_GLYPHHANDLE 설정되고 dwTypeOut이 TYPE_TRANSDATA 설정된 GETINFO_GLYPHSTRING 구조체를 할당합니다.
  2. UNIFONTOBJ_GetInfo 함수를 호출하여 GETINFO_GLYPHSTRING 구조를 입력으로 전달하여 문자 모양 변환을 TRANSDATA 구조체 콘텐츠로 가져옵니다.
  3. 문자 모양을 인쇄하기 위해 IPrintOemDriverUni::D rvWriteSpoolBuf 를 호출하여 TRANSDATA 구조체 콘텐츠를 인쇄 스풀러로 보냅니다.
지정된 글꼴이 소프트 글꼴인 경우 메서드는 IPrintOemDriverUni::D rvWriteSpoolBuf 를 호출하여 이전에 다운로드한 지정된 문자 모양이 인쇄되도록 하는 명령을 인쇄 스풀러로 보낼 수 있습니다.

메서드는 IPrintOemUni::OutputCharStr 선택 사항입니다. 렌더링 플러그 인이 이 메서드를 구현하는 경우 플러그 인의 IPrintOemUni::GetImplementedMethod 메서드는 "OutputCharStr"를 입력으로 수신할 때 S_OK 반환해야 합니다.

자세한 내용은 사용자 지정된 글꼴 관리를 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 prcomoem.h(Prcomoem.h 포함)