Método IPrintCoreHelperPS::SetFontSubstitution (prcomoem.h)

El método IPrintCoreHelperPS::SetFontSubstitution especifica la fuente del dispositivo que se va a imprimir en lugar de una fuente TrueType determinada.

Sintaxis

HRESULT SetFontSubstitution(
  [in] IN PCWSTR pszTrueTypeFontName,
  [in] IN PCWSTR pszDevFontName
);

Parámetros

[in] pszTrueTypeFontName

Puntero a una cadena Unicode terminada en null que contiene un nombre de fuente TrueType válido. Este parámetro no debe ser NULL.

[in] pszDevFontName

Puntero a una cadena Unicode terminada en null que contiene el nombre de la fuente del dispositivo.

Valor devuelto

IPrintCoreHelperPS::GetFontSubstitution debe devolver uno de los siguientes valores.

Código devuelto	Descripción
S_OK	El método lee la opción de la característica especificada.
E_FAIL	La fuente solicitada no existe o no era una fuente TrueType.
E_INVALIDARG	Uno o varios argumentos no son válidos.
E_OUTOFMEMORY	El controlador principal no pudo atender la solicitud porque no había memoria suficiente.
E_UNEXPECTED u otros códigos de retorno que no aparecen aquí	El controlador principal parece estar en un estado no válido. El autor de la llamada debe devolver un código de error.

Comentarios

Establecer una fuente de dispositivo que se usará en lugar de una fuente TrueType especificada solo puede producirse durante la sesión de hojas de propiedades del dispositivo y solo si está habilitada la sustitución completa de la interfaz de usuario. La fuente representada por el parámetro pszTrueTypeFontName debe ser una fuente TrueType válida y debe instalarse en la impresora. La fuente del dispositivo representada por el parámetro pszDevFontName debe ser una fuente válida para esta impresora.

Si ya existe una asignación de sustitución para la fuente TrueType especificada en esta cola, el método SetFontSubstitution reemplazará silenciosamente la asignación. Para quitar una asignación de sustitución, llame a este método con el nombre de fuente TrueType especificado en pszTrueTypeFontName y con NULL especificado en pszDevFontName.

Para obtener una lista de fuentes de dispositivo válidas, cree un contexto de información para la impresora actual y llame a SetGraphicsMode(hIC, GM_ADVANCED). A continuación, enumFontFamilies se enumeran las fuentes del dispositivo. El parámetro de devolución de llamada (consulte EnumFontFamProc en la documentación de Microsoft Windows SDK) de EnumFontFamilies debe filtrar las fuentes del dispositivo incrementando un contador para cada fuente para la que el resultado AND bit a bit (FontType & TRUETYPE_FONTTYPE) es distinto de cero. Las funciones SetGraphicsMode, EnumFontFamilies y EnumFontFamProc se describen en la documentación de Windows SDK.

Requisitos

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

Consulte también

IPrintCoreHelperPS

IPrintCoreHelperPS::GetFontSubstitution