Método IPrintCoreHelper::SetFontSubstitution (prcomoem.h)

  • Artigo

O método IPrintCoreHelper::SetFontSubstitution especifica a fonte do dispositivo a ser impressa no lugar de uma determinada fonte TrueType.

Sintaxe

HRESULT SetFontSubstitution(
  [in] IN PCWSTR pszTrueTypeFontName,
  [in] IN PCWSTR pszDevFontName
);

Parâmetros

[in] pszTrueTypeFontName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém um nome de fonte TrueType válido. Esse parâmetro não deve ser NULL.

[in] pszDevFontName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da fonte do dispositivo.

Retornar valor

IPrintCoreHelper::SetFontSubstitution 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 aqui O driver principal parece estar em um estado inválido. O chamador deve retornar um código de falha.

Comentários

A configuração de uma fonte de dispositivo a ser usada no lugar de uma fonte TrueType especificada só pode ocorrer durante a sessão de folhas de propriedades do dispositivo e somente se a substituição completa da interface do usuário estiver habilitada. A fonte representada pelo parâmetro pszTrueTypeFontName deve ser uma fonte TrueType válida e deve ser instalada na impressora. A fonte do dispositivo representada pelo parâmetro pszDevFontName deve ser uma fonte válida para esta impressora.

Se um mapeamento de substituição para a fonte TrueType especificada já existir nessa fila, o método SetFontSubstitution substituirá silenciosamente o mapeamento. Para remover um mapeamento de substituição, chame esse método com o nome da fonte TrueType especificado em pszTrueTypeFontName e com NULL especificado em pszDevFontName.

Para obter uma lista de fontes de dispositivo válidas, 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 fontes de dispositivo incrementando um contador para cada fonte para a qual o resultado AND bit a bit (FontType & TRUETYPE_FONTTYPE) é diferente de zero.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintCoreHelper

IPrintCoreHelper::GetFontSubstitution