Converter HTML por ActiveX — Incorpore a conversão de HTML em sua aplicação

Sua aplicação web precisa transformar uma página HTML em PDF, DOC ou TIFF no servidor. As opções óbvias são dolorosas: um navegador headless consome RAM e trava sob carga, um processo de linha de comando é lento para iniciar e difícil de monitorar, uma API na nuvem vaza seus dados e cobra por chamada.

Total HTML Converter X expõe uma interface ActiveX / COM completa. Instancie o objeto uma vez a partir de .NET, PHP, Python, ASP, VBScript ou qualquer runtime compatível com COM, chame Convert() e obtenha o arquivo de saída. Sem spawning de subprocessos, sem renderização de navegador, sem API externa. Os arquivos nunca saem do seu servidor.

O que a interface ActiveX oferece

• Conversão em processo. O conversor é executado dentro do espaço de processo da sua aplicação. Sem Process.Start(), sem parsing de stdout, sem processos zumbis.
• Saída em múltiplos formatos a partir de uma chamada. PDF, DOC, DOCX, XLS, TIFF, JPEG, RTF, TXT, XHTML, EMF — passe o formato como parâmetro.
• Renderização CSS completa. Estilos CSS 1 e CSS 2, imagens inline, tabelas e fontes web renderizados pelo próprio engine do conversor — sem dependência de navegador.
• Segurança PDF embutida. Senhas de proprietário e usuário, restrições de cópia/impressão, marcas d'água, assinaturas digitais — definidas como parâmetros do método.
• Tratamento de erros via HRESULT. Exceções COM aparecem como erros nativos da linguagem (exceção .NET, COMException do PHP, exceção win32 do Python). Sem parsing de logs.
• Licença única, usuários ilimitados. Instale em um servidor e atenda conversões para todos os usuários da sua aplicação.

(Avaliação de 30 dias — sem necessidade de e-mail)

Licença de servidor a partir de $249.90

O que ActiveX / COM realmente é

ActiveX é um modelo de componentes da Microsoft. Em termos práticos, isso significa que o Total HTML Converter X registra uma classe COM no Windows (HTMLConverter.HTMLConverterX) que qualquer runtime compatível com COM pode instanciar e chamar. Você não está chamando uma API REST nem um processo de linha de comando — você está carregando uma DLL em sua aplicação e invocando métodos em um objeto em processo.

Isso importa por três motivos:

• Velocidade. Sem inicialização de processo, sem IPC, sem socket. O conversor é uma DLL carregada uma única vez.
• Confiabilidade. Sem processos órfãos, sem arquivos PID, sem raspagem de logs. Se a chamada falhar, sua linguagem lança uma exceção com um HRESULT.
• Segurança. Nenhum arquivo transmitido pela rede. Sem diretório temporário compartilhado. A conversão acontece na memória ou no diretório de trabalho do próprio processo.

Qualquer linguagem que fale COM funciona: C# e VB.NET via interop .NET, C++ via CoCreateInstance, PHP via a classe COM, Python via pywin32, Classic ASP via Server.CreateObject, VBScript, JScript/WSH, Delphi, PowerShell, Ruby via win32ole e Node.js via winax.

Como integrar o Total HTML Converter X

• Passo 1. Instale o Total HTML Converter X na máquina Windows onde sua aplicação é executada. O instalador registra a classe COM automaticamente.
• Passo 2. Verifique o registro. Em um prompt de comando elevado, execute reg query HKCR\HTMLConverter.HTMLConverterX. Se a chave existir, o objeto COM está pronto.
• Passo 3. Referencie o objeto COM no seu projeto. Em .NET, adicione uma referência COM ou use Type.GetTypeFromProgID(). Em PHP, use new COM("HTMLConverter.HTMLConverterX"). Em Python, use win32com.client.Dispatch("HTMLConverter.HTMLConverterX").
• Passo 4. Chame Convert(source, destination, options). Passe o caminho do HTML de entrada, o caminho do arquivo de saída e uma string de opções com flags como -c PDF, -OwnerPassword secret, -Watermark CONFIDENCIAL.
• Passo 5. Trate o valor de retorno ou a exceção. Em caso de sucesso, o arquivo de saída é criado. Em caso de falha, a chamada COM lança uma exceção nativa da linguagem com o HRESULT e o texto do erro.
• Passo 6. Implante. Para ASP.NET ou IIS, certifique-se de que a identidade do application pool tem permissão para ler o HTML de origem, escrever no caminho de saída e acessar o registro COM. Para Python ou PHP, o usuário que executa o script precisa das mesmas permissões.

Exemplos de código

C# / .NET

var conv = Activator.CreateInstance(
    Type.GetTypeFromProgID("HTMLConverter.HTMLConverterX"));
conv.GetType().InvokeMember("Convert",
    System.Reflection.BindingFlags.InvokeMethod, null, conv,
    new object[] { @"C:\In\report.html", @"C:\Out\report.pdf",
                   "-c PDF -OwnerPassword s3cret -NoPrint" });

PHP

$c = new COM("HTMLConverter.HTMLConverterX");
$c->Convert(
    "C:\\In\\report.html",
    "C:\\Out\\report.pdf",
    "-c PDF -Watermark DRAFT -log C:\\Logs\\html.log"
);

Python (pywin32)

import win32com.client
conv = win32com.client.Dispatch("HTMLConverter.HTMLConverterX")
conv.Convert(
    r"C:\In\report.html",
    r"C:\Out\report.pdf",
    "-c PDF -OwnerPassword secret -NoPrint"
)

Classic ASP / VBScript

Set Conv = Server.CreateObject("HTMLConverter.HTMLConverterX")
Conv.Convert _
    "C:\In\report.html", _
    "C:\Out\report.pdf", _
    "-c PDF -Watermark ""COMPANY CONFIDENTIAL"""
Set Conv = Nothing

Opções de formato de saída

O terceiro argumento de Convert() é uma string de flags separadas por espaços. A flag principal é -c FORMAT. Altere-a e você muda a saída:

Você pode combinar com flags de segurança e layout:

• -OwnerPassword secret — senha de proprietário do PDF (controla permissões)
• -UserPassword open123 — senha de abertura do PDF
• -NoPrint / -NoCopy / -NoModify — restrições de permissão do PDF
• -Watermark "CONFIDENCIAL" — carimba o texto da marca d'água em cada página
• -PageSize A4 / Letter / Legal — tamanho do papel
• -log C:\Logs\html.log — grava o log de conversão para monitoramento

ActiveX vs Linha de comando vs Navegador headless

Quando usar a integração ActiveX

1. Aplicações web de alto throughput. Um site ASP.NET ou Classic ASP converte prévias de e-mails HTML, faturas ou extratos em PDF a cada requisição. O ActiveX elimina a sobrecarga de spawn de processos — cada conversão é uma chamada de método, não um subprocesso.
2. Fluxos de documentos personalizados. Um serviço Windows coleta arquivos HTML de uma pasta monitorada, converte-os em PDF com marcas d'água da empresa e entrega os resultados a um sistema de gestão de documentos. O serviço hospeda o objeto COM diretamente; sem shell-out, sem arquivos batch.
3. Backends SaaS multi-tenant. Cada tenant envia templates HTML que precisam de conversão. A interface ActiveX permite que seu backend enfileire e processe conversões com o mesmo modelo de concorrência do restante do seu pipeline.
4. Ambientes isolados (air-gapped). Implantações on-premises onde APIs de conversão em nuvem são bloqueadas ou proibidas. O componente ActiveX é executado inteiramente dentro do perímetro da rede.
5. Arquiteturas existentes baseadas em COM. Aplicações legadas construídas em Classic ASP, VB6 ou C++ com COM já sabem trabalhar com componentes ActiveX. O Total HTML Converter X se encaixa da mesma forma.
6. Substituindo pipelines de navegador headless. Equipes migrando de Puppeteer ou PhantomJS por causa da pressão de memória, churn de atualizações ou frequência de travamentos mudam para o ActiveX para obter uso de recursos previsível.

Por que Total HTML Converter X

Projetado para servidores

Sem GUI, sem caixas de confirmação, sem prompts "Salvar como". Executa sob IIS, dentro de serviços Windows ou a partir de tarefas agendadas sem usuário logado.

Engine de renderização próprio

Sem necessidade de navegador. O conversor analisa HTML e CSS com seu próprio código. Isso significa que atualizações do Chrome não quebram seu pipeline, sem perfis de navegador, sem incompatibilidades de versão de driver.

Licença única por servidor

Ao contrário de preços por usuário ou por conversão, o Total HTML Converter X é licenciado por servidor. Atenda milhares de usuários com uma única licença.

Projetos de exemplo inclusos

O instalador vem com projetos de exemplo funcionais em ASP, PHP e C++. Abra-os no Visual Studio, em uma IDE de sua escolha ou em um editor de texto e adapte-os às suas necessidades.

Avaliação de 30 dias, totalmente funcional

Sem marca d'água, sem limite de conversão, sem necessidade de e-mail para baixar. Integre-o ao seu protótipo, comprove que funciona e então licencie.

(Avaliação de 30 dias — sem necessidade de e-mail)

Licença de servidor a partir de $249.90

Conversor de arquivos HTML para servidores Avaliações de Clientes 2026

"Substituí um pipeline com Puppeteer que consumia 2 GB de RAM por worker e travava toda noite. A chamada ActiveX se encaixa no nosso serviço worker .NET existente — uma chamada de método, sem subprocesso, sem navegador headless para reiniciar. O uso de memória fica estável. A qualidade de saída em PDF é melhor do que o Chromium nos entregava, especialmente em CSS com tabelas."

Daniel Park Senior Backend Engineer

"Operamos um portal de cobrança PHP sob IIS. As faturas são geradas como templates HTML, convertidas em PDF em tempo real e enviadas por e-mail aos clientes. A integração COM são três linhas de PHP. Sem API na nuvem, sem arquivos saindo do nosso servidor. A licença única de $249.90 se pagou na primeira semana de uso em comparação com a API por documento que estávamos avaliando."

Amira Hassan Web Applications Developer

"Integrado com uma aplicação Classic ASP que está em operação há mais de 15 anos. <code>Server.CreateObject("HTMLConverter.HTMLConverterX")</code> funcionou na primeira tentativa sob IIS. Bom que os registros de 32 bits e 64 bits sejam separados &mdash; eu precisava da build de 32 bits. A documentação poderia ter mais exemplos específicos para VB6, mas o exemplo em ASP foi perto o suficiente para adaptar."

Victor Rossi IT Integration Lead

FAQ ▼