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

El método IPrintCoreHelper::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

IPrintCoreHelper::SetFontSubstitution 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 para usarla 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 mediante una llamada a . El parámetro callback ((see EnumFontFamProc) of EnumFontFamilies should filter for device fonts by incrementing a counter for each font for each font for which the bitwise AND result (FontType & TRUETYPE_FONTTYPE) is nonzero.

Requisitos

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

Consulte también

IPrintCoreHelper

IPrintCoreHelper::GetFontSubstitution