Função ResetDCA (wingdi.h)

Artigo
11/20/2024

A função ResetDC atualiza o DC (contexto de dispositivo de plotador ou impressora) especificado usando as informações especificadas.

Sintaxe

HDC ResetDCA(
  [in] HDC            hdc,
  [in] const DEVMODEA *lpdm
);

Parâmetros

[in] hdc

Um identificador para o DC a ser atualizado.

[in] lpdm

Um ponteiro para uma estrutura de de DEVMODE que contém informações sobre o novo DC.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será um identificador para o DC original.

Se a função falhar, o valor retornado será NULL.

Observações

Um aplicativo normalmente usará a função ResetDC quando uma janela receber uma mensagem de WM_DEVMODECHANGE. ResetDC também podem ser usados para alterar a orientação de papel ou as caixas de papel durante a impressão de um documento.

A função ResetDC não pode ser usada para alterar o nome do driver, o nome do dispositivo ou a porta de saída. Quando o usuário altera a conexão de porta ou o nome do dispositivo, o aplicativo deve excluir o DC original e criar um novo DC com as novas informações.

Um aplicativo pode passar um DC de informações para a função ResetDC. Nessa situação, ResetDC sempre retornará um DC de impressora.

ICM: O perfil de cor do DC especificado pelo parâmetro hdc será redefinido com base nas informações contidas no membro lpInitData da estrutura DEVMODE.

Nota

O cabeçalho wingdi.h define ResetDC como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wingdi.h (inclua Windows.h)
biblioteca	Gdi32.lib
de DLL	Gdi32.dll

Consulte também

DEVMODE

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

deviceCapabilities

Escape

Compartilhar via