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

  • Artículo

El IPrintOemUni::OutputCharStr método 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 del especificador de glifos a la que apunta pGlyph. Los valores válidos son los siguientes:

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

dwCount

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

pGlyph

Puntero proporcionado por el autor de la llamada a una matriz de especificadores de glifos, donde dwType indica el tipo de elemento de matriz.

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 está implementado.

Comentarios

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

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

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

Si la fuente especificada es una fuente de dispositivo, la matriz contiene identificadores de glifo. Los identificadores deben traducirse a códigos de caracteres o comandos y, a continuación, enviarse al cola de impresión para hacer 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 de 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 para imprimir los glifos.
Si la fuente especificada es una fuente temporal, el método simplemente puede llamar a IPrintOemDriverUni::D rvWriteSpoolBuf para enviar comandos al cola de impresión que hará que se impriman los glifos descargados previamente especificados.

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

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

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado prcomoem.h (include Prcomoem.h)