Impressão de aplicações para desktop

Esta secção descreve como imprimir a partir de um programa de ambiente de trabalho nativo do Windows.

Visão geral

Para fornecer a melhor experiência de usuário quando você imprime a partir de um programa nativo do Windows, o programa deve ser projetado para imprimir a partir de um thread dedicado. Em um programa nativo do Windows, o programa é responsável por gerenciar eventos e mensagens da interface do usuário. As operações de impressão podem exigir períodos de computação intensa à medida que o conteúdo do aplicativo é renderizado para a impressora, o que pode impedir que o programa responda à interação do usuário se esse processamento for executado no mesmo thread que o processamento de eventos da interação do usuário.

Se você já estiver familiarizado com como escrever um programa nativo do Windows multi-threaded, vá diretamente para Como imprimir a partir de um aplicativo do Windows e aprenda como adicionar funcionalidade de impressão ao seu programa.

Requisitos básicos do programa Windows

Para obter o melhor desempenho e a capacidade de resposta do programa, não execute o processamento do trabalho de impressão de um programa no thread que processa a interação do usuário.

Essa separação entre impressão e interação do usuário influenciará como o programa gerencia os dados do aplicativo. Você deve entender completamente essas implicações antes de começar a escrever o aplicativo. Os tópicos a seguir descrevem os requisitos básicos de manipulação de impressão em um thread separado de um programa.

Noções básicas do programa do Windows

Um programa nativo do Windows deve fornecer o procedimento de janela principal para processar as mensagens de janela que recebe do sistema operacional. Cada janela em um programa do Windows tem uma função correspondente WndProc que processa essas mensagens de janela. O thread no qual essa função é executada é chamado de thread da interface do usuário, ou UI.

Use recursos para cadeias de caracteres.
Use recursos de cadeia de caracteres do arquivo de recursos do programa em vez de constantes de cadeia de caracteres para cadeias de caracteres que talvez precisem ser alteradas quando você oferecer suporte a outro idioma. Antes que um programa possa usar um recurso de cadeia de caracteres como uma cadeia de caracteres, o programa deve recuperar o recurso do arquivo de recurso e copiá-lo para um buffer de memória local. Isso requer alguma programação adicional no início, mas permite uma modificação, tradução e localização mais fáceis do programa no futuro.
Processar dados em etapas.
Processe o trabalho de impressão em etapas que podem ser interrompidas. Esse design possibilita que o usuário cancele uma longa operação de processamento antes que ela seja concluída e impede que o programa bloqueie outros programas que possam estar sendo executados ao mesmo tempo.
Usar dados do utilizador da interface.
As aplicações de impressão geralmente têm várias janelas e threads. Para manter os dados disponíveis entre threads e etapas de processamento sem usar variáveis estáticas e globais, faça referência às estruturas de dados por um ponteiro de dados que faz parte da janela na qual elas são usadas.

O exemplo de código a seguir mostra um ponto de entrada principal para um aplicativo de impressão. Este exemplo mostra como usar recursos de cadeia de caracteres em vez de constantes de cadeia de caracteres e também mostra o loop de mensagem principal que processa as mensagens de janela do programa.

int APIENTRY 
wWinMain(
        HINSTANCE hInstance, 
        HINSTANCE hPrevInstance, 
        LPWSTR lpCmdLine, 
        int nCmdShow
)
{
    UNREFERENCED_PARAMETER(hPrevInstance);
    UNREFERENCED_PARAMETER(lpCmdLine);

    MSG msg;
    HACCEL hAccelTable;
    HRESULT hr = S_OK;

    // Register the main window class name
    WCHAR szWindowClass[MAXIMUM_RESOURCE_STRING_LENGTH];            
    LoadString(
        hInstance, 
        IDC_PRINTSAMPLE, 
        szWindowClass, 
        MAXIMUM_RESOURCE_STRING_LENGTH);
    MyRegisterClass(hInstance, szWindowClass);

    // Perform application initialization:
    if (!InitInstance (hInstance, nCmdShow))
    {
        // Unable to initialize this instance of the application
        //  so display error message and exit
        MessageBoxWithResourceString (
            hInstance, 
            GetDesktopWindow(), 
            IDS_ERROR_INSTINITFAIL, 
            IDS_CAPTION_ERROR, 
            (MB_OK | MB_ICONEXCLAMATION));
        return FALSE;
    }    
    
    // Init COM for printing interfaces
    if (FAILED(hr = CoInitializeEx(0, COINIT_MULTITHREADED)))
    {
        // Unable to initialize COM
        //  so display error message and exit
        MessageBoxWithResourceString (
            hInstance, 
            GetDesktopWindow(), 
            IDS_ERROR_COMINITFAIL, 
            IDS_CAPTION_ERROR, 
            (MB_OK | MB_ICONEXCLAMATION));
        return FALSE;
    }

    hAccelTable = LoadAccelerators(
                    hInstance, 
                    MAKEINTRESOURCE(IDC_PRINTSAMPLE));

    // Main message handling loop
    while (GetMessage(&msg, NULL, 0, 0))
    {
        if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg))
        {
            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }
    }

    // Uninitialize (close) the COM interface
    CoUninitialize();

    return (int) msg.wParam;
}

Informação do documento

Os programas nativos do Windows que imprimem devem ser projetados para processamento multiencadeado. Um dos requisitos de um design multi-threaded é proteger os elementos de dados do programa para que eles sejam seguros para vários threads usarem ao mesmo tempo. Você pode proteger elementos de dados usando objetos de sincronização e organizando os dados para evitar conflitos entre os threads. Ao mesmo tempo, o programa deve impedir alterações nos dados do programa enquanto ele está sendo impresso. O programa de exemplo utiliza várias técnicas diferentes de programação multithread.

Eventos de sincronização
O programa de exemplo usa eventos, identificadores de thread e funções de espera para sincronizar o processamento entre o thread de impressão e o programa principal e para indicar que os dados estão em uso.
Application-Specific Mensagens do Windows
O programa de exemplo usa mensagens de janela específicas do aplicativo para tornar o programa mais compatível com outros programas nativos do Windows. Dividir o processamento em etapas menores e enfileirar essas etapas no loop de mensagens da janela torna mais fácil para o Windows gerenciar o processamento sem bloquear outros aplicativos que também podem estar em execução no computador.
Estruturas de Dados
O programa de exemplo não é escrito em um estilo orientado a objeto usando objetos e classes, embora agrupe elementos de dados em estruturas de dados. O exemplo não usa uma abordagem orientada a objetos para evitar implicar que uma abordagem é melhor ou pior do que outra.
Você pode usar as funções e estruturas de dados do programa de exemplo como um ponto de partida ao projetar seu programa. Se você decidir projetar um programa orientado a objeto ou não, a consideração de design importante a ser lembrada é agrupar os elementos de dados relacionados para que você possa usá-los com segurança em diferentes threads, conforme necessário.

Contexto do dispositivo da impressora

Ao imprimir, talvez você queira renderizar o conteúdo a ser impresso em um contexto de dispositivo. Como: Recuperar um contexto de dispositivo de impressora descreve as diferentes maneiras de obter um contexto de dispositivo de impressora.

Tópicos relacionados

Como imprimir a partir de um aplicativo do Windows