Método IPrintCoreHelper::GetFontSubstitution (prcomoem.h)
O método IPrintCoreHelper::GetFontSubstitution indica qual fonte do 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.
Retornar valor
IPrintCoreHelper::GetFontSubstitution deve retornar um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O método lê 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 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. |
Comentários
Se um aplicativo tentar imprimir o 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 pelo nome do rosto da fonte, que aparece no membro lfFaceName da estrutura LOGFONT .
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, enumere fontes de dispositivo por meio de uma chamada para EnumFontFamilies. O parâmetro de retorno de chamada (consulte EnumFontFamProc) de EnumFontFamilies deve filtrar para fontes de dispositivo incrementando um contador para cada fonte para a qual o resultado AND bit a bit (FontType & TRUETYPE_FONTTYPE) não é zero.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | prcomoem.h (inclua Prcomoem.h) |