Compartir a través de


Método IPrintCoreHelperUni::GetFontSubstitution (prcomoem.h)

IPrintCoreHelperUni::GetFontSubstitution método indica qué fuente del dispositivo, si existe, se usa como fuente de sustitución para una fuente TrueType especificada.

Sintaxis

HRESULT GetFontSubstitution(
  [in]  IN PCWSTR  pszTrueTypeFontName,
  [out] OUT PCWSTR *ppszDevFontName
);

Parámetros

[in] pszTrueTypeFontName

Puntero a una cadena Unicode terminada en null que contiene el nombre de una fuente TrueType.

[out] ppszDevFontName

Puntero a una variable que recibe la dirección de una cadena Unicode terminada en null. Esta cadena contiene el nombre de la fuente del dispositivo que se usará en lugar de la fuente TrueType especificada en el parámetro pszFontName . Si no hay ninguna fuente de dispositivo que pueda servir como sustituto de la fuente TrueType especificada, este parámetro se establecerá en NULL.

Valor devuelto

IPrintCoreHelperUni::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

Si una aplicación intenta imprimir texto que usa la fuente TrueType especificada en el parámetro pszTrueTypeFontName , ese texto se imprimirá en la fuente del dispositivo especificada en el parámetro ppszDevFontName . El nombre de fuente del dispositivo debe ser el de una fuente válida instalada.

Una fuente se identifica mediante su nombre de cara de fuente, que aparece en el miembro lfFaceName de la estructura LOGFONT .

Para obtener una lista de fuentes disponibles, cree un contexto de información para la impresora actual y llame a SetGraphicsMode(hIC, GM_ADVANCED). A continuación, enumerar las fuentes del dispositivo mediante una llamada a EnumFontFamilies. El parámetro de devolución de llamada (vea EnumFontFamProc) 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) no es cero.

Requisitos

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

Consulte también

IPrintCoreHelperUni

IPrintCoreHelperUni::SetFontSubstitution