Compartilhar via

Função TTEmbedFont (t2embapi.h)

  • Artigo

Cria uma estrutura de fonte que contém a fonte de caractere largo subsetted (16 bits). A fonte atual do contexto do dispositivo (hDC) fornece as informações de fonte.

Essa função passa os dados para uma rotina de retorno de chamada definida pelo cliente para inserção no fluxo de documentos.

Sintaxe

LONG TTEmbedFont(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

Parâmetros

[in] hDC

Identificador de contexto do dispositivo.

[in] ulFlags

Sinalizador que especifica a solicitação de inserção. Esse sinalizador pode ter zero ou mais dos valores a seguir.

Valor Significado
TTEMBED_EMBEDEUDC
 Inclua os dados de arquivo de fonte EUDC associados à estrutura da fonte.
TTEMBED_RAW
 Retornar uma estrutura de fonte que contém o conjunto de caracteres completo, não compactado. Esse é o comportamento padrão da função.
TTEMBED_SUBSET
 Retornar uma fonte subsetted que contém apenas os glifos indicados pelo parâmetro pusCharCodeSet ou pulCharCodeSet . Esses códigos de caractere devem ser indicados como caracteres UCS-4 ou de 16 bits, conforme apropriado para o parâmetro .
TTEMBED_TTCOMPRESSED
 Retornar uma estrutura de fonte compactada.

[in] ulCharSet

Sinalizador que especifica o conjunto de caracteres da fonte a ser inserida. Esse sinalizador pode ter um dos valores a seguir.

Valor Significado
CHARSET_UNICODE
 Conjunto de caracteres Unicode, exigindo codificação de caracteres de 16 bits.
CHARSET_SYMBOL
 Conjunto de caracteres de símbolo, exigindo codificação de caracteres de 16 bits.

[out] pulPrivStatus

Ponteiro para sinalizador que indica privilégios de inserção da fonte. Esse sinalizador pode ter um dos valores a seguir. Essa função retorna a licença menos restritiva concedida.

Valor Significado
EMBED_PREVIEWPRINT
 Visualizar e imprimir inserção.
EMBED_EDITABLE
 Inserção Editável.
EMBED_INSTALLABLE
 Inserção instalável.
EMBED_NOEMBEDDING
 Inserção de licença restrita.

[out] pulStatus

Ponteiro para um campo de bits que contém status informações sobre a solicitação de inserção. Esse campo é preenchido após a conclusão dessa função. Nenhum bit está definido no momento para esse parâmetro.

lpfnWriteToStream

Ponteiro para a função de retorno de chamada definida pelo cliente, que grava a estrutura da fonte no fluxo do documento. Consulte WRITEEMBEDPROC.

[in] lpvWriteStream

Um token para representar o fluxo de saída.

[in] pusCharCodeSet

Ponteiro para o buffer que contém os códigos de caractere Unicode opcionais para subconfiguração. Esse campo só é usado para subconfigurar uma fonte e será ignorado se o campo ulFlags não especificar TTEMBED_SUBSET.

[in] usCharCodeCount

O número de caracteres na lista de caracteres indicados por pusCharCodeSet. Esse campo só é usado para subconfigurar uma fonte e será ignorado se o campo ulFlags não especificar TTEMBED_SUBSET.

[in] usLanguage

Especifica qual idioma na tabela de nomes manter ao subconfigurar. Defina como 0 para manter todos os idiomas. Esse campo só é usado para subconfigurar uma fonte e será ignorado se o campo ulFlags não especificar TTEMBED_SUBSET.

[in, optional] pTTEmbedInfo

Ponteiro para uma estrutura TTEMBEDINFO que contém as URLs das quais o objeto de fonte inserido pode ser legitimamente referenciado. Se pTTEmbedInfo for NULL, nenhuma URL será adicionada ao objeto de fonte inserido e nenhuma verificação de URL ocorrerá quando o cliente chamar TTLoadEmbeddedFont.

Retornar valor

Se a inserção for bem-sucedida, retornará E_NONE.

A estrutura de fonte é incorporada ao fluxo de documentos pelo cliente. pulPrivStatus é definido, indicando os privilégios de inserção da fonte; e pulStatus é definido para fornecer resultados da operação de inserção.

Caso contrário, retornará um código de erro descrito em Mensagens de Erro da Função de Inserção.

Comentários

Os clientes são responsáveis por determinar e indicar o conjunto de caracteres da fonte.

Para obter informações sobre como inserir caracteres UCS-4, consulte TTEmbedFontEx. Para obter informações sobre como inserir caracteres de fonte de um arquivo, consulte TTEmbedFontFromFileA.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho t2embapi.h
Biblioteca T2embed.lib
DLL T2embed.dll

Confira também

TTEMBEDINFO

TTEmbedFontEx

TTEmbedFontFromFileA

TTLoadEmbeddedFont