Método IPrintCoreHelper::GetFontSubstitution (prcomoem.h)
O método IPrintCoreHelper::GetFontSubstitution indica qual fonte de dispositivo, se houver, é usada como uma fonte de substituição para uma fonte TrueType especificada.
Sintaxe
HRESULT GetFontSubstitution(
[in] IN PCWSTR pszTrueTypeFontName,
[out] OUT PCWSTR *ppszDevFontName
);
Parâmetros
[in] pszTrueTypeFontName
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome de uma fonte TrueType.
[out] ppszDevFontName
Um ponteiro para uma variável que recebe o endereço de uma cadeia de caracteres Unicode terminada em nulo. Essa cadeia de caracteres contém o nome da fonte do dispositivo que será usada no lugar da fonte TrueType especificada no parâmetro pszFontName. Se não houver nenhuma fonte de dispositivo que possa servir como um substituto para a fonte TrueType especificada, esse parâmetro será definido como NULL.
Valor de retorno
IPrintCoreHelper::GetFontSubstitution deve retornar um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O método leu a opção para o recurso especificado. |
| E_FAIL | A fonte solicitada não existe ou não era uma fonte TrueType. |
| E_INVALIDARG | Um ou mais dos argumentos são inválidos. |
| E_OUTOFMEMORY | O driver principal não pôde atender à solicitação porque não havia memória suficiente. |
| E_UNEXPECTED ou outros códigos de retorno não listados em outro lugar nesta tabela | O driver principal parece estar em um estado inválido. O chamador deve retornar um código de falha. |
Observações
Se um aplicativo tentar imprimir texto que usa a fonte TrueType especificada no parâmetro pszTrueTypeFontName, esse texto será impresso na fonte do dispositivo especificada no parâmetro ppszDevFontName. O nome da fonte do dispositivo deve ser o de uma fonte instalada válida.
Uma fonte é identificada por seu nome de rosto de fonte, que aparece no membro lfFaceName da estrutura deLOGFONT.
Para obter uma lista de fontes disponíveis, crie um contexto de informações para a impressora atual e chame SetGraphicsMode (hIC, GM_ADVANCED). Em seguida, enumera fontes de dispositivo por meio de uma chamada para EnumFontFamilies. O parâmetro de retorno de chamada (consulte EnumFontFamProc) de EnumFontFamilies deve filtrar fontes de dispositivo incrementando um contador para cada fonte para a qual o resultado E bit a bit (FontType & TRUETYPE_FONTTYPE) não é zero.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | prcomoem.h (inclua Prcomoem.h) |