Compartilhar via

Função TTEmbedFontFromFileA (t2embapi.h)

  • Artigo

Cria uma estrutura de fonte que contém a fonte de caractere largo subsetted (16 bits). Um arquivo externo 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 TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [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] szFontFileName

O nome do arquivo de fonte e o caminho para inserir. Esta é uma cadeia de caracteres ANSI.

[in] usTTCIndex

Índice baseado em zero no arquivo de fonte (TTC) que identifica a fonte física a ser inserida. Se o arquivo contiver uma única fonte (como um arquivo de estrutura de tópicos TTF ou OTF), esse parâmetro deverá ser definido como 0.

[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 com a 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 de 16 bits ou UCS-4, 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 o 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. No momento, nenhum bit está definido 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ó será usado para subconfigurar uma fonte e será ignorado se theulFlagsfield não especificar TTEMBED_SUBSET.

[in] usCharCodeCount

O número de caracteres na lista de caracteres indicados por pusCharCodeSet. Esse campo só será 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ó será 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 a função TTLoadEmbeddedFont .

Valor retornado

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

A estrutura da 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

Essa função faz referência a uma rotina de retorno de chamada definida pelo cliente para inserir a estrutura da fonte no fluxo do documento.

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

Para obter informações sobre como inserir caracteres Unicode de um contexto de dispositivo, consulte TTEmbedFont; para obter informações sobre como inserir caracteres UCS-4 de um contexto de dispositivo, consulte TTEmbedFontEx.

Requisitos

   
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

TTEmbedFont

TTEmbedFontEx

TTLoadEmbeddedFont