Método IPrintCoreHelperUni::SetFontSubstitution (prcomoem.h)
O método IPrintCoreHelperUni::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.
Valor de retorno
IPrintCoreHelperUni::SetFontSubstitution deve retornar um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
O método leu a opção para o recurso especificado. |
|
A fonte solicitada não existe ou não era uma fonte TrueType. |
|
Um ou mais dos argumentos são inválidos. |
|
O driver principal não pôde atender à solicitação porque não havia memória suficiente. |
|
O driver principal parece estar em um estado inválido. O chamador deve retornar um código de falha. |
Observações
A configuração de uma fonte de dispositivo a ser usada no lugar de uma fonte TrueType especificada só poderá 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, enumera fontes de dispositivo chamando EnumFontFamilies. O parâmetro de retorno de chamada (consulte EnumFontFamProc na documentação do SDK do Microsoft Windows) 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. As funções SetGraphicsMode, EnumFontFamiliese EnumFontFamProc são descritas na documentação do SDK do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | prcomoem.h (inclua Prcomoem.h) |