Método IPrintOemUni::OutputCharStr (prcomoem.h)

El método IPrintOemUni::OutputCharStr permite que un complemento de representación controle la impresión de glifos de fuente.

Sintaxis

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

Parámetros

pdevobj

Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ.

pUFObj

Puntero proporcionado por el autor de la llamada a una estructura UNIFONTOBJ.

dwType

Valor proporcionado por el autor de la llamada que indica el tipo de matriz de especificador de glifos a la que apunta pGlyph. Los valores válidos son los siguientes:

Valor	Definición
TYPE_GLYPHHANDLE	Los pGlyph elementos de matriz son controladores de glifo de tipo HGLYPH.
TYPE_GLYPHID	Los pGlyph elementos de matriz son identificadores de glifo de tipo DWORD.

dwCount

Valor proporcionado por el autor de la llamada que representa el número de especificadores de glifos en la matriz a la que apunta pGlyph.

pGlyph

Puntero proporcionado por el llamador a una matriz de especificadores de glifos, donde el tipo de elemento de matriz se indica mediante dwType.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no se implementa.

Observaciones

El método IPrintOemUni::OutputCharStr se usa para admitir impresoras que no reconocen los comandos de salida de caracteres con formato PCL, CAPSL o PPDS compatibles con Unidrv. Su propósito es permitir que un complemento de representación controle la impresión de glifos de una fuente y proporcione sustituciones de glifos si es necesario.

Si un complemento de representación implementa el método IPrintOemUni::OutputCharStr, Unidrv llama al método cada vez que una cadena de caracteres está lista para ser puesta en cola.

El método recibe una matriz de especificadores de glifos. El valor recibido para dwType indica el tipo de identificador.

Si la fuente especificada es una fuente del dispositivo, la matriz contiene identificadores de glifo. Los identificadores deben traducirse a comandos o códigos de caracteres y, a continuación, enviarse al administrador de trabajos de impresión para que se impriman glifos de dispositivo.

Si la fuente especificada es una fuente temporal (TrueType), la matriz contiene identificadores de glifo. Los identificadores representan glifos descargados previamente que deben imprimirse.

Si la fuente especificada es una fuente del dispositivo, el método debe hacer lo siguiente:

1. Asigne una estructura de GETINFO_GLYPHSTRING con dwTypeIn establecido en TYPE_GLYPHHANDLE y dwTypeOut establecido en TYPE_TRANSDATA.
2. Llame a la función UNIFONTOBJ_GetInfo, pasando la estructura GETINFO_GLYPHSTRING como entrada, para obtener traducciones de glifo como contenido de la estructura TRANSDATA.
3. Llame a IPrintOemDriverUni::D rvWriteSpoolBuf para enviar el contenido de la estructura TRANSDATA al administrador de trabajos de impresión, con el fin de imprimir los glifos.

Si la fuente especificada es una fuente suave, el método simplemente puede llamar a IPrintOemDriverUni::D rvWriteSpoolBuf para enviar comandos al colado de impresión que hará que se impriman los glifos descargados previamente especificados.

El método IPrintOemUni::OutputCharStr es opcional. Si un complemento de representación implementa este método, el método IPrintOemUni::GetImplementedMethod debe devolver S_OK cuando recibe "OutputCharStr" como entrada.

Para obtener más información, consulte Administración de fuentes personalizadas.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)