Compartilhar via


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)

Confira também

IPrintCoreHelper

IPrintCoreHelper::SetFontSubstitution