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) |