Compartilhar via


Função TTEnableEmbeddingForFacename (t2embapi.h)

Adiciona ou remove nomes de face da lista de exclusão de face de tipo.

Sintaxe

LONG TTEnableEmbeddingForFacename(
  [in] LPCSTR lpszFacename,
  [in] BOOL   bEnable
);

Parâmetros

[in] lpszFacename

Ponteiro para o nome da face da fonte a ser adicionada ou removida da lista de exclusão de face de tipo.

[in] bEnable

Operação de controle booliano na lista de exclusão de face de tipo. Se não for zero, o nome do rosto será removido da lista; se zero, o nome da face será adicionado à lista.

Retornar valor

Se tiver êxito, retornará E_NONE.

O nome da face indicado por lpszFacename será adicionado ou removido da lista de exclusão de face de tipo.

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

Comentários

A função TTEnableEmbeddingForFacename usa uma lista de exclusão de face de tipo para controlar se uma fonte específica pode ser inserida. Essa lista identifica todas as fontes que NÃO devem ser inseridas e são compartilhadas por todos os clientes de criação em um único sistema.

Um cliente de criação pode inserir fontes sem referenciar a lista de exclusão de face de tipo (ou seja, sem usar TTEnableEmbeddingForFacename). A inserção de fontes em um documento resulta nas compensações a seguir.

  • Fornece todas as informações de fonte em um documento para que o cliente apropriado possa renderizar o documento.
  • Adiciona tamanho a um documento.
  • Complica as operações de leitura e gravação de streaming em um documento e usa mais largura de banda de processamento.
  • Torna um documento menos legível por outros aplicativos.
  • Pode deixar problemas de direitos autorais não gerenciados, se a lista de exclusão de tipos não for usada.
Duas funções adicionais, TTIsEmbeddingEnabled e TTIsEmbeddingEnabledForFacename, acessam a lista de exclusão de face de tipo para fornecer a habilitação de status.

A lista de exclusão de face de tipo é armazenada na chave do Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\t2embed. A lista de exclusão de face de tipo padrão deve conter as seguintes entradas de valor nomeado que representam as fontes principais do Microsoft Windows.

Nome do valor Tipo de dados Valor de dados
Arial REG_DWORD 0
Arial Bold REG_DWORD 0
Arial Bold Italic REG_DWORD 0
Arial Italic REG_DWORD 0
Courier New REG_DWORD 0
Courier New Bold REG_DWORD 0
Courier New Bold Italic REG_DWORD 0
Courier New Italic REG_DWORD 0
Times New Roman REG_DWORD 0
Times New Roman Bold REG_DWORD 0
Times New Roman Bold Italic REG_DWORD 0
Times New Roman Italic REG_DWORD 0

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

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename