Classe `CDC`

Artigo
07/05/2024

Define uma classe de objetos de contexto de dispositivo.

Sintaxe

class CDC : public CObject

Membros

Construtores públicos

Nome	Descrição
`CDC::CDC`	Constrói um objeto `CDC`.

Métodos públicos

Nome	Descrição
`CDC::AbortDoc`	Encerra o trabalho de impressão atual, apagando tudo o que o aplicativo escreveu no dispositivo desde a última chamada da função de membro `StartDoc`.
`CDC::AbortPath`	Fecha e descarta quaisquer caminhos no contexto do dispositivo.
`CDC::AddMetaFileComment`	Copia o comentário de um buffer para um meta-arquivo de formato aprimorado especificado.
`CDC::AlphaBlend`	Exibe bitmaps que têm pixels transparentes ou semitransparentes.
`CDC::AngleArc`	Desenha um segmento de linha e um arco e move a posição atual para o ponto final do arco.
`CDC::Arc`	Desenha um arco elíptico.
`CDC::ArcTo`	Desenha um arco elíptico. Essa função é semelhante a `Arc`, exceto que a posição atual é atualizada.
`CDC::Attach`	Anexa um contexto de dispositivo Windows a esse objeto `CDC`.
`CDC::BeginPath`	Abre um colchete de caminho no contexto do dispositivo.
`CDC::BitBlt`	Copia um bitmap de um contexto de dispositivo especificado.
`CDC::Chord`	Desenha uma corda (uma figura fechada delimitada pela interseção de uma elipse e um segmento de linha).
`CDC::CloseFigure`	Fecha uma figura aberta em um caminho.
`CDC::CreateCompatibleDC`	Cria um contexto de dispositivo de memória compatível com outro contexto de dispositivo. Você pode usá-lo para preparar imagens na memória.
`CDC::CreateDC`	Criar um contexto de dispositivo para um dispositivo específico.
`CDC::CreateIC`	Cria um contexto de informações para um dispositivo específico. Isso fornece uma maneira rápida de obter informações sobre o dispositivo sem criar um contexto de dispositivo.
`CDC::DeleteDC`	Exclui o contexto do dispositivo Windows associado a esse objeto `CDC`.
`CDC::DeleteTempMap`	Chamado pelo manipulador de tempo ocioso `CWinApp` para excluir qualquer objeto `CDC` temporário criado por `FromHandle`. Também desanexa o contexto do dispositivo.
`CDC::Detach`	Desanexa o contexto do dispositivo Windows desse objeto `CDC`.
`CDC::DPtoHIMETRIC`	Converte unidades de dispositivo em unidades `HIMETRIC`.
`CDC::DPtoLP`	Converte unidades de dispositivo em unidades lógicas.
`CDC::Draw3dRect`	Desenha um retângulo tridimensional.
`CDC::DrawDragRect`	Apaga e redesenha um retângulo à medida que ele é arrastado.
`CDC::DrawEdge`	Desenha as bordas de um retângulo.
`CDC::DrawEscape`	Acessa recursos de desenho de uma exibição de vídeo que não estão diretamente disponíveis por meio da GDI (interface do dispositivo gráfico).
`CDC::DrawFocusRect`	Desenha um retângulo no estilo usado para indicar o foco.
`CDC::DrawFrameControl`	Desenha um controle de quadro.
`CDC::DrawIcon`	Desenha um ícone.
`CDC::DrawState`	Exibe uma imagem e aplica um efeito visual para indicar um estado.
`CDC::DrawText`	Desenha texto formatado no retângulo especificado.
`CDC::DrawTextEx`	Desenha texto formatado no retângulo especificado usando outros formatos.
`CDC::Ellipse`	Desenha uma elipse.
`CDC::EndDoc`	Encerra um trabalho de impressão iniciado pela função de membro `StartDoc`.
`CDC::EndPage`	Informa ao driver de dispositivo que uma página está terminando.
`CDC::EndPath`	Fecha um colchete de caminho e seleciona o caminho definido pelo colchete no contexto do dispositivo.
`CDC::EnumObjects`	Enumera as canetas e pincéis disponíveis em um contexto de dispositivo.
`CDC::Escape`	Permite que os aplicativos acessem recursos que não estão diretamente disponíveis em um dispositivo específico por meio da GDI. Também permite o acesso a funções de escape do Windows. As chamadas de escape feitas por um aplicativo são traduzidas e enviadas para o driver do dispositivo.
`CDC::ExcludeClipRect`	Cria uma nova área de recorte que consiste na área de recorte existente menos o retângulo especificado.
`CDC::ExcludeUpdateRgn`	Impede o desenho dentro de áreas inválidas de uma janela excluindo uma região atualizada na janela de uma área de recorte.
`CDC::ExtFloodFill`	Preenche uma área com o pincel atual. Fornece mais flexibilidade do que a função de membro `CDC::FloodFill`.
`CDC::ExtTextOut`	Grava uma cadeia de caracteres em uma região retangular usando a fonte selecionada no atualmente.
`CDC::FillPath`	Fecha as figuras abertas no caminho atual e preenche o interior do caminho usando o pincel atual e o modo de preenchimento de polígono.
`CDC::FillRect`	Preenche um determinado retângulo usando um pincel específico.
`CDC::FillRgn`	Preenche uma região específica com o pincel especificado.
`CDC::FillSolidRect`	Preenche um retângulo com uma cor sólida.
`CDC::FlattenPath`	Transforma as curvas no caminho selecionado no contexto atual do dispositivo e transforma cada curva em uma sequência de linhas.
`CDC::FloodFill`	Preenche uma área com o pincel atual.
`CDC::FrameRect`	Desenha uma borda em torno de um retângulo.
`CDC::FrameRgn`	Desenha uma borda em torno de uma região específica usando um pincel.
`CDC::FromHandle`	Retorna um ponteiro para um objeto `CDC` quando dado um identificador para um contexto de dispositivo. Se um objeto `CDC` não estiver anexado ao identificador, um objeto temporário `CDC` será criado e anexado.
`CDC::GetArcDirection`	Retorna a direção do arco atual para o contexto do dispositivo.
`CDC::GetAspectRatioFilter`	Recupera a configuração do filtro de taxa de proporção atual.
`CDC::GetBkColor`	Recupera a cor do segundo plano atual.
`CDC::GetBkMode`	Recupera o modo em segundo plano.
`CDC::GetBoundsRect`	Retorna o retângulo delimitador acumulado atual para o contexto do dispositivo especificado.
`CDC::GetBrushOrg`	Recupera a origem do pincel atual.
`CDC::GetCharABCWidths`	Recupera as larguras, em unidades lógicas, de caracteres consecutivos em um determinado intervalo da fonte atual.
`CDC::GetCharABCWidthsI`	Recupera as larguras, em unidades lógicas, de índices de glifo consecutivos em um intervalo especificado da fonte TrueType atual.
`CDC::GetCharacterPlacement`	Recupera vários tipos de informações em uma cadeia de caracteres.
`CDC::GetCharWidth`	Recupera as larguras fracionais de caracteres consecutivos em um determinado intervalo da fonte atual.
`CDC::GetCharWidthI`	Recupera as larguras, em coordenadas lógicas, de índices de glifo consecutivos em um intervalo especificado da fonte atual.
`CDC::GetClipBox`	Recupera as dimensões do retângulo delimitador mais apertado ao redor do limite de recorte atual.
`CDC::GetColorAdjustment`	Recupera os valores de ajuste de cor para o contexto do dispositivo.
`CDC::GetCurrentBitmap`	Retorna um ponteiro para o objeto `CBitmap` selecionado atualmente.
`CDC::GetCurrentBrush`	Retorna um ponteiro para o objeto `CBrush` selecionado atualmente.
`CDC::GetCurrentFont`	Retorna um ponteiro para o objeto `CFont` selecionado atualmente.
`CDC::GetCurrentPalette`	Retorna um ponteiro para o objeto `CPalette` selecionado atualmente.
`CDC::GetCurrentPen`	Retorna um ponteiro para o objeto `CPen` selecionado atualmente.
`CDC::GetCurrentPosition`	Recupera a posição atual da caneta (em coordenadas lógicas).
`CDC::GetDCBrushColor`	Recupera a cor atual do pincel.
`CDC::GetDCPenColor`	Recupera a cor atual da caneta.
`CDC::GetDeviceCaps`	Recupera um tipo especificado de informações específicas do dispositivo sobre os recursos de um determinado dispositivo de exibição.
`CDC::GetFontData`	Recupera informações de métrica de fonte de um arquivo de fonte escalonável. As informações a serem recuperadas são identificadas especificando um deslocamento para o arquivo de fonte e o comprimento das informações a serem retornadas.
`CDC::GetFontLanguageInfo`	Retorna informações sobre a fonte selecionada no momento para o contexto de exibição especificado.
`CDC::GetGlyphOutline`	Recupera a curva da estrutura de tópicos ou o bitmap para um caractere de estrutura de tópicos na fonte atual.
`CDC::GetGraphicsMode`	Recupera o modo gráfico atual para o contexto do dispositivo especificado.
`CDC::GetHalftoneBrush`	Recupera um pincel de meio tom.
`CDC::GetKerningPairs`	Recupera os pares de kerning de caracteres para a fonte selecionada no momento no contexto do dispositivo especificado.
`CDC::GetLayout`	Recupera o layout de um contexto de dispositivo (DC). O layout pode ser da esquerda para a direita (padrão) ou da direita para a esquerda (espelhado).
`CDC::GetMapMode`	Recupera o modo de mapeamento atual.
`CDC::GetMiterLimit`	Retorna o limite de malhete para o contexto do dispositivo.
`CDC::GetNearestColor`	Recupera a cor lógica mais próxima de uma cor lógica especificada que o dispositivo determinado pode representar.
`CDC::GetOutlineTextMetrics`	Recupera informações de métrica de fonte para fontes TrueType.
`CDC::GetOutputCharWidth`	Recupera as larguras de caracteres individuais em um grupo consecutivo de caracteres da fonte atual usando o contexto do dispositivo de saída.
`CDC::GetOutputTabbedTextExtent`	Calcula a largura e a altura de uma cadeia de caracteres no contexto do dispositivo de saída.
`CDC::GetOutputTextExtent`	Calcula a largura e a altura de uma linha de texto no contexto do dispositivo de saída usando a fonte atual para determinar as dimensões.
`CDC::GetOutputTextMetrics`	Recupera as métricas da fonte atual do contexto do dispositivo de saída.
`CDC::GetPath`	Recupera as coordenadas que definem os pontos de extremidade das linhas e os pontos de controle das curvas encontradas no caminho selecionado no contexto do dispositivo.
`CDC::GetPixel`	Recupera o valor de cor RGB do pixel no ponto especificado.
`CDC::GetPolyFillMode`	Recupera o modo de preenchimento de polígono atual.
`CDC::GetROP2`	Recupera o modo de desenho atual.
`CDC::GetSafeHdc`	Retorna `CDC::m_hDC`, o contexto do dispositivo de saída.
`CDC::GetStretchBltMode`	Recupera o modo de alongamento de bitmap atual.
`CDC::GetTabbedTextExtent`	Calcula a largura e a altura de uma cadeia de caracteres no contexto do dispositivo de atributo.
`CDC::GetTextAlign`	Recupera os sinalizadores de alinhamento de texto.
`CDC::GetTextCharacterExtra`	Recupera a configuração atual para a quantidade de espaçamento entre caracteres.
`CDC::GetTextColor`	Recupera a cor do texto atual.
`CDC::GetTextExtent`	Calcula a largura e a altura de uma linha de texto no contexto do dispositivo de atributo usando a fonte atual para determinar as dimensões.
`CDC::GetTextExtentExPointI`	Recupera o número de caracteres em uma cadeia de caracteres especificada que se ajustará a um espaço especificado e preenche uma matriz com a extensão de texto para cada um desses caracteres.
`CDC::GetTextExtentPointI`	Recupera a largura e a altura da matriz especificada de índices de glifo.
`CDC::GetTextFace`	Copia o nome de tipo da fonte atual em um buffer como uma cadeia de caracteres terminada em nulo.
`CDC::GetTextMetrics`	Recupera as métricas da fonte atual do contexto do dispositivo de atributo.
`CDC::GetViewportExt`	Recupera as extensões x e y do visor.
`CDC::GetViewportOrg`	Recupera as coordenadas x e y da origem do visor.
`CDC::GetWindow`	Retorna a janela associada ao contexto do dispositivo de exibição.
`CDC::GetWindowExt`	Recupera as extensões x e y da janela associada.
`CDC::GetWindowOrg`	Recupera as coordenadas x e y da origem da janela associada.
`CDC::GetWorldTransform`	Recupera o espaço do mundo atual para a transformação de espaço de página.
`CDC::GradientFill`	Preenche estruturas de retângulo e triângulo com uma cor de classificação.
`CDC::GrayString`	Desenha texto esmaecido (acinzentado) no local especificado.
`CDC::HIMETRICtoDP`	Converte unidades HIMETRIC em unidades de dispositivo.
`CDC::HIMETRICtoLP`	Converte unidades HIMETRIC em unidades lógicas.
`CDC::IntersectClipRect`	Cria uma nova área de recorte formando a interseção da região atual e um retângulo.
`CDC::InvertRect`	Inverte o conteúdo de um retângulo.
`CDC::InvertRgn`	Inverte as cores em uma região.
`CDC::IsPrinting`	Determina se o contexto do dispositivo está sendo usado para impressão.
`CDC::LineTo`	Desenha uma linha da posição atual até, mas não incluindo, um ponto.
`CDC::LPtoDP`	Converte unidades lógicas em unidades de dispositivo.
`CDC::LPtoHIMETRIC`	Converte unidades lógicas em unidades HIMETRIC.
`CDC::MaskBlt`	Combina os dados de cor para os bitmaps de origem e destino usando a operação de máscara e varredura dados.
`CDC::ModifyWorldTransform`	Altera a transformação do mundo para um contexto de dispositivo usando o modo especificado.
`CDC::MoveTo`	Move a posição atual.
`CDC::OffsetClipRgn`	Move a área de recorte do dispositivo especificado.
`CDC::OffsetViewportOrg`	Modifica a origem do visor em relação às coordenadas da origem do visor atual.
`CDC::OffsetWindowOrg`	Modifica a origem da janela em relação às coordenadas da origem da janela atual.
`CDC::PaintRgn`	Preenche uma região com o pincel selecionado.
`CDC::PatBlt`	Cria um padrão de bit.
`CDC::Pie`	Desenha uma borda em forma de torta.
`CDC::PlayMetaFile`	Reproduz o conteúdo do meta-arquivo especificado no dispositivo especificado. A versão aprimorada de `PlayMetaFile` exibe a imagem armazenada no meta-arquivo de formato aprimorado especificado. O meta-arquivo pode ser reproduzido várias vezes.
`CDC::PlgBlt`	Executa uma transferência de bloco de bits dos bits de dados de cor do retângulo especificado no contexto do dispositivo de origem para o paralelograma especificado no contexto de dispositivo fornecido.
`CDC::PolyBezier`	Desenha um ou mais splines Bzier. A posição atual não é usada ou atualizada.
`CDC::PolyBezierTo`	Desenha um ou mais splines Bzier, e move a posição atual para o ponto final do último spline Bzier.
`CDC::PolyDraw`	Desenha um conjunto de segmentos de linha e splines Bzier. Essa função atualiza a posição atual.
`CDC::Polygon`	Desenha um polígono que consiste em dois ou mais pontos (vértices) conectados por linhas.
`CDC::Polyline`	Desenha um conjunto de segmentos de linha que conectam os pontos especificados.
`CDC::PolylineTo`	Desenha uma ou mais linas retas, e move a posição atual para o ponto final da última linha.
`CDC::PolyPolygon`	Cria dois ou mais polígonos que são preenchidos usando o modo de preenchimento de polígono atual. Os polígonos podem ser desarticulados ou podem se sobrepor.
`CDC::PolyPolyline`	Desenha várias séries de segmentos de linha conectados. A posição atual não é usada ou atualizada por essa função.
`CDC::PtVisible`	Especifica se o ponto determinado está dentro da área de recorte.
`CDC::RealizePalette`	Mapeia as entradas de paleta na paleta lógica atual para a paleta do sistema.
`CDC::Rectangle`	Desenha um retângulo usando a caneta atual e a preenche usando o pincel atual.
`CDC::RectVisible`	Determina se alguma parte do retângulo determinado está dentro da área de recorte.
`CDC::ReleaseAttribDC`	Libera `m_hAttribDC`, o contexto de dispositivo de atributo.
`CDC::ReleaseOutputDC`	Libera `m_hDC`, o contexto de dispositivo de saída.
`CDC::ResetDC`	Atualiza o contexto de dispositivo `m_hAttribDC`.
`CDC::RestoreDC`	Restaura o contexto de dispositivo para um estado anterior salvo com `SaveDC`.
`CDC::RoundRect`	Desenha um retângulo com cantos arredondados usando a caneta atual e preenchido usando o pincel atual.
`CDC::SaveDC`	Salva o estado atual do contexto de dispositivo.
`CDC::ScaleViewportExt`	Modifica a extensão do visor em relação aos valores atuais.
`CDC::ScaleWindowExt`	Modifica as extensões de janela relativas aos valores atuais.
`CDC::ScrollDC`	Percorre um retângulo de bits horizontal e verticalmente.
`CDC::SelectClipPath`	Seleciona o caminho atual como uma área de recorte para o contexto do dispositivo, combinando a nova área com qualquer área de recorte existente usando o modo especificado.
`CDC::SelectClipRgn`	Combina a área fornecida com a área de recorte atual usando o modo especificado.
`CDC::SelectObject`	Seleciona um objeto de desenho de GDI, como uma caneta.
`CDC::SelectPalette`	Seleciona a paleta lógica.
`CDC::SelectStockObject`	Seleciona uma das canetas de estoque predefinidas, pincéis ou fontes fornecidas pelo Windows.
`CDC::SetAbortProc`	Define uma função de retorno de chamada fornecida pelo programador que o Windows chama se um trabalho de impressão precisar ser anulado.
`CDC::SetArcDirection`	Define a direção do desenho a ser usada para funções de arco e retângulo.
`CDC::SetAttribDC`	Define `m_hAttribDC`, o contexto de dispositivo de atributo.
`CDC::SetBkColor`	Define a cor do segundo plano atual.
`CDC::SetBkMode`	Define o modo em segundo plano.
`CDC::SetBoundsRect`	Controla o acúmulo de informações delimitador-retângulo para o contexto do dispositivo especificado.
`CDC::SetBrushOrg`	Especifica a origem do próximo pincel selecionado em um contexto de dispositivo.
`CDC::SetColorAdjustment`	Define os valores de ajuste de cor para o contexto do dispositivo usando os valores especificados.
`CDC::SetDCBrushColor`	Define a cor atual do pincel.
`CDC::SetDCPenColor`	Define a cor atual da caneta.
`CDC::SetGraphicsMode`	Define o modo gráfico atual para o contexto do dispositivo especificado.
`CDC::SetLayout`	Altera o layout de um contexto de dispositivo (DC).
`CDC::SetMapMode`	Define o modo de mapeamento atual.
`CDC::SetMapperFlags`	Altera o algoritmo que o mapeador de fontes usa quando mapeia fontes lógicas para fontes físicas.
`CDC::SetMiterLimit`	Define o limite para o comprimento das junções de malhete para o contexto de dispositivo.
`CDC::SetOutputDC`	Define `m_hDC`, o contexto do dispositivo de saída.
`CDC::SetPixel`	Define o pixel no ponto especificado como a aproximação mais próxima da cor especificada.
`CDC::SetPixelV`	Define o pixel nas coordenadas especificadas como a aproximação mais próxima da cor especificada. `SetPixelV` é mais rápido do que `SetPixel` porque não precisa retornar o valor de cor do ponto pintado.
`CDC::SetPolyFillMode`	Define o modo de preenchimento de polígono.
`CDC::SetROP2`	Define o modo de desenho atual.
`CDC::SetStretchBltMode`	Define o modo de alongamento de bitmap.
`CDC::SetTextAlign`	Define os sinalizadores de alinhamento de texto.
`CDC::SetTextCharacterExtra`	Define a quantidade de espaçamento entre caracteres.
`CDC::SetTextColor`	Define a cor do texto.
`CDC::SetTextJustification`	Adiciona espaço aos caracteres de quebra em uma cadeia de caracteres.
`CDC::SetViewportExt`	Define as extensões x e y do visor.
`CDC::SetViewportOrg`	Define a origem do visor.
`CDC::SetWindowExt`	Define as extensões x e y da janela associada.
`CDC::SetWindowOrg`	Define a origem da janela do contexto do dispositivo.
`CDC::SetWorldTransform`	Define o espaço do mundo atual para a transformação de espaço de página.
`CDC::StartDoc`	Informa ao driver do dispositivo que um novo trabalho de impressão está sendo iniciado.
`CDC::StartPage`	Informa ao driver do dispositivo que uma nova página está sendo iniciada.
`CDC::StretchBlt`	Move um bitmap de um retângulo de origem e um dispositivo para um retângulo de destino, alongando-o ou compactando-o, se necessário, para ajustá-lo às dimensões do retângulo de destino.
`CDC::StrokeAndFillPath`	Fecha as figuras abertas em um caminho, atinge a estrutura de tópicos do caminho usando a caneta atual e preenche seu interior usando o pincel atual.
`CDC::StrokePath`	Renderiza o caminho especificado usando a caneta atual.
`CDC::TabbedTextOut`	Grava uma cadeia de caracteres em um local especificado, expandindo guias para os valores especificados em uma matriz de posições tab-stop.
`CDC::TextOut`	Grava uma cadeia de caracteres em um local especificado usando a fonte selecionada no momento.
`CDC::TransparentBlt`	Transfere um bloco de bits de dados de cor do contexto do dispositivo de origem especificado para um contexto de dispositivo de destino, renderizando uma cor especificada transparente na transferência.
`CDC::UpdateColors`	Atualiza a área do cliente do contexto do dispositivo, combinando as cores atuais na área do cliente com a paleta do sistema em uma base pixel a pixel.
`CDC::WidenPath`	Redefine o caminho atual como a área que seria pintada se o caminho fosse traçado usando a caneta selecionada atualmente no contexto do dispositivo.

Operadores públicos

Nome	Descrição
`CDC::operator HDC`	Recupera o identificador do contexto do dispositivo.

Membros de Dados Públicos

Nome	Descrição
`CDC::m_hAttribDC`	O contexto atributo-dispositivo usado por esse objeto `CDC`.
`CDC::m_hDC`	O contexto saída-dispositivo usado por esse objeto `CDC`.

Comentários

O CDC objeto fornece funções de membro para trabalhar com um contexto de dispositivo, como uma exibição ou impressora, e membros para trabalhar com um contexto de exibição associado à área do cliente de uma janela.

Faça todo o desenho pelas funções de membro de um objeto CDC. A classe fornece funções membro para operações de contexto de dispositivo, trabalhando com ferramentas de desenho, seleção de objeto GDI (interface de dispositivo gráfico) com segurança de tipo e trabalhando com cores e paletas. Ele também fornece funções membros para obter e definir atributos de desenho, mapeamento, trabalhar com o visor, trabalhar com a extensão da janela, converter coordenadas, trabalhar com regiões, recortes, linhas de desenho e desenhar formas simples, elipses e polígonos. As funções membro também são fornecidas para desenhar texto, trabalhar com fontes, usar escapes de impressora, rolagem e reprodução de meta-arquivos.

Para usar um objeto CDC, construa-o e, em seguida, chame suas funções de membro que funções paralelas do Windows que usam contextos de dispositivo.

Observação

No Windows 95/98, todas as coordenadas de tela são limitadas a 16 bits. Portanto, um int passado para uma função de membro CDC deve estar no intervalo -32768 a 32767.

Para usos específicos, a Biblioteca de classes do Microsoft Foundation fornece várias classes derivadas de CDC. CPaintDC encapsula chamadas para BeginPaint e EndPaint. CClientDC gerencia um contexto de exibição associado à área de cliente de uma janela. CWindowDC gerencia um contexto de exibição associado a uma janela inteira, incluindo seu quadro e controles. CMetaFileDC associa um contexto de dispositivo a um meta-arquivo.

CDC fornece duas funções GetLayout de membro e SetLayout, para reverter o layout de um contexto de dispositivo, que não herda seu layout de uma janela. Essa orientação da direita para a esquerda é necessária para aplicativos escritos para culturas, como árabe ou hebraico, onde o layout de caracteres não é o padrão europeu.

CDC contém dois contextos de dispositivo, m_hDC e m_hAttribDC que, na criação de um objeto CDC, referem-se ao mesmo dispositivo. CDC direciona todas as chamadas GDI de saída para m_hDC e a maioria das chamadas GDI de atributo para m_hAttribDC. (Um exemplo de uma chamada de atributo é GetTextColor, enquanto SetTextColor é uma chamada de saída.)

Por exemplo, a estrutura usa esses dois contextos de dispositivo para implementar um objeto CMetaFileDC que enviará a saída para um meta-arquivo durante a leitura de atributos de um dispositivo físico. A visualização de impressão é implementada na estrutura de forma semelhante. Você também pode usar os dois contextos de dispositivo de maneira semelhante no código específico do aplicativo.

Há ocasiões em que você pode precisar de informações de métrica de texto dos contextos de dispositivo m_hDC e m_hAttribDC. Os seguintes pares de funções fornecem essa funcionalidade:

Usa m_hAttribDC	Usa m_hDC
`GetTextExtent`	`GetOutputTextExtent`
`GetTabbedTextExtent`	`GetOutputTabbedTextExtent`
`GetTextMetrics`	`GetOutputTextMetrics`
`GetCharWidth`	`GetOutputCharWidth`

Para mais informações sobre CDC, confira Contextos de dispositivo.

Hierarquia de herança

CObject

CDC

Requisitos

Cabeçalho: afxwin.h

`CDC::AbortDoc`

Encerra o trabalho de impressão atual e apaga tudo o que o aplicativo escreveu no dispositivo desde a última chamada para a função de membro StartDoc.

int AbortDoc();

Valor de retorno

Um valor maior ou igual a 0 se tiver êxito ou um valor negativo se ocorreu um erro. A lista a seguir mostra valores de erro comuns e seus significados:

SP_ERROR Erro geral.
SP_OUTOFDISK No momento, não há espaço em disco suficiente disponível para spooling e não haverá mais espaço disponível.
SP_OUTOFMEMORY Não há memória suficiente disponível para spooling.
SP_USERABORT O usuário encerrou o trabalho por meio do Gerenciador de impressão.

Comentários

Essa função membro substitui o escape da impressora ABORTDOC.

AbortDoc deve ser usado para encerrar o seguinte:

Operações de impressão que não especificam uma função de anulação usando SetAbortProc.
Operações de impressão que ainda não atingiram sua primeira chamada de escape NEWFRAME ou NEXTBAND.

Se um aplicativo encontrar um erro de impressão ou uma operação de impressão cancelada, ele não deverá tentar encerrar a operação usando as funções ou as funções de membro EndDoc ou AbortDoc da classe CDC. A GDI encerra automaticamente a operação antes de retornar o valor de erro.

Se o aplicativo exibir uma caixa de diálogo para permitir que o usuário cancele a operação de impressão, ele deverá chamar AbortDoc antes de destruir a caixa de diálogo.

Se o Gerenciador de Impressão foi usado para iniciar o trabalho de impressão, chamar AbortDoc apaga todo o trabalho de spool — a impressora não recebe nada. Se o Gerenciador de Impressão não foi usado para iniciar o trabalho de impressão, os dados podem ter sido enviados para a impressora antes AbortDoc de serem chamados. Nesse caso, o driver da impressora teria redefinido a impressora (quando possível) e fechado o trabalho de impressão.

Exemplo

Confira o exemplo de CDC::StartDoc.

`CDC::AbortPath`

Fecha e descarta quaisquer caminhos no contexto do dispositivo.

BOOL AbortPath();

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0.

Comentários

Se houver um colchete de caminho aberto no contexto do dispositivo, o colchete de caminho será fechado e o caminho será descartado. Se houver um caminho fechado no contexto do dispositivo, o caminho será descartado.

`CDC::AddMetaFileComment`

Copia o comentário de um buffer para um meta-arquivo de formato aprimorado especificado.

BOOL AddMetaFileComment(
    UINT nDataSize,
    const BYTE* pCommentData);

Parâmetros

nDataSize
E especifica o comprimento do buffer de comentário em bytes.

pCommentData
Aponta para o buffer que contém o comentário.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0.

Comentários

Um comentário pode incluir qualquer informação privada, por exemplo, a origem da imagem e a data em que ela foi criada. Um comentário deve começar com uma assinatura de aplicativo, seguida pelos dados. Os comentários não devem conter dados específicos da posição. Os dados específicos da posição especificam o local de um registro e não devem ser incluídos porque um metafilo pode ser incorporado a outro metarquivo. Essa função só pode ser usada com meta-arquivos aprimorados.

`CDC::AlphaBlend`

Chame essa função de membro para exibir bitmaps com pixels transparentes ou semitransparentes.

BOOL AlphaBlend(
    int xDest,
    int yDest,
    int nDestWidth,
    int nDestHeight,
    CDC* pSrcDC,
    int xSrc,
    int ySrc,
    int nSrcWidth,
    int nSrcHeight,
    BLENDFUNCTION blend);

Parâmetros

xDest
Especifica a coordenada x, em unidades lógicas, do canto esquerdo superior do retângulo de destino.

yDest
Especifica a coordenada y, em unidades lógicas, do canto esquerdo superior do retângulo de destino.

nDestWidth
Especifica a largura, em unidades lógicas, do retângulo de destino.

nDestHeight
Especifica a altura, em unidades lógicas, do retângulo de destino.

pSrcDC
Um ponteiro para o contexto de dispositivo de origem.

xSrc
Especifica a coordenada x, em unidades lógicas, do canto esquerdo superior do retângulo de origem.

ySrc
Especifica a coordenada y, em unidades lógicas, do canto esquerdo superior do retângulo de origem.

nSrcWidth
Especifica a largura, em unidades lógicas, do retângulo de origem.

nSrcHeight
Especifica a altura, em unidades lógicas, do retângulo de origem.

blend
Especifica uma estrutura BLENDFUNCTION.

Valor de retorno

TRUE se for bem-sucedido, caso contrário, FALSE.

Comentários

Confira AlphaBlend no SDK do Windows para mais informações.

`CDC::AngleArc`

Desenha um segmento de linha e um arco.

BOOL AngleArc(
    int x,
    int y,
    int nRadius,
    float fStartAngle,
    float fSweepAngle);

Parâmetros

x
Especifica a coordenada x lógica do centro do círculo.

y
Especifica a coordenada y lógica do centro do círculo.

nRadius
Especifica o raio do círculo em unidades lógicas. Esse valor deve ser positivo.

fStartAngle
Especifica o ângulo inicial em graus relativos ao eixo x.

fSweepAngle
Especifica o ângulo de varredura em graus em relação ao ângulo inicial.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

O segmento de linha é desenhado da posição atual para o início do arco. O arco é desenhado ao longo do perímetro de um círculo com o raio e o centro determinados. O comprimento do arco é definido pelos ângulos de início e varredura fornecidos.

AngleArc move a posição atual para o ponto final do arco. O arco desenhado por essa função pode parecer elíptico, dependendo do modo de transformação e mapeamento atual. Antes de desenhar o arco, essa função desenha o segmento de linha da posição atual até o início do arco. O arco é desenhado pela construção de um círculo imaginário com o raio especificado ao redor do ponto central especificado. O ponto de partida do arco é determinado medindo no sentido anti-horário do eixo x do círculo pelo número de graus no ângulo inicial. O ponto final é localizado da mesma forma medindo no sentido anti-horário do ponto de partida pelo número de graus no ângulo de varredura.

Se o ângulo de varredura for maior que 360 graus, o arco será varrido várias vezes. Essa função desenha linhas usando a caneta atual. A figura não está preenchida.

`CDC::Arc`

Desenha um arco elíptico.

BOOL Arc(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL Arc(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);

Parâmetros

x1
Especifica a coordenada x do canto esquerdo superior do retângulo delimitador (em unidades lógicas).

y1
Especifica a coordenada y do canto esquerdo superior do retângulo delimitador (em unidades lógicas).

x2
Especifica a coordenada x do canto direito inferior do retângulo delimitador (em unidades lógicas).

y2
Especifica a coordenada y do canto direito inferior do retângulo delimitador (em unidades lógicas).

x3
Especifica a coordenada x do ponto que define o ponto de partida do arco (em unidades lógicas). Este ponto não precisa estar exatamente no arco.

y3
Especifica a coordenada y do ponto que define o ponto de partida do arco (em unidades lógicas). Este ponto não precisa estar exatamente no arco.

x4
Especifica a coordenada x do ponto que define o ponto final do arco (em unidades lógicas). Este ponto não precisa estar exatamente no arco.

y4
Especifica a coordenada y do ponto que define o ponto final do arco (em unidades lógicas). Este ponto não precisa estar exatamente no arco.

lpRect
Especifica o retângulo delimitador (em unidades lógicas). Você pode passar um objeto LPRECT ou CRect para esse parâmetro.

ptStart
Especifica as coordenadas x e y do ponto que define o ponto de partida do arco (em unidades lógicas). Este ponto não precisa estar exatamente no arco. Você pode passar uma POINT estrutura ou um CPoint objeto para esse parâmetro.

ptEnd
Especifica as coordenadas x e y do ponto que define o ponto final do arco (em unidades lógicas). Este ponto não precisa estar exatamente no arco. Você pode passar uma POINT estrutura ou um CPoint objeto para esse parâmetro.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0.

Comentários

O arco desenhado usando a função é um segmento da elipse definido pelo retângulo delimitador especificado.

O ponto de partida real do arco é o ponto em que um raio extraído do centro do retângulo delimitador através do ponto de partida especificado cruza a elipse. O ponto final real do arco é o ponto em que um raio extraído do centro do retângulo delimitador através do ponto final especificado cruza a elipse. O arco é desenhado em uma direção no sentido anti-horário. Como um arco não é uma figura fechada, ele não é preenchido. A largura e a altura do retângulo devem ser maiores que 2 unidades e menos de 32.767 unidades.

Exemplo

void CDCView::DrawArc(CDC *pDC)
{
   // Fill the client area with a thin circle. The circle's
   // interior is not filled. The circle's perimeter is
   // blue from 6 o'clock to 3 o'clock and red from 3
   // o'clock to 6 o'clock.

   // Get the client area.
   CRect rectClient;
   GetClientRect(rectClient);

   // Make a couple of pens.
   CPen penBlue;
   CPen penRed;
   CPen *pOldPen;

   penBlue.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(0, 0, 255));
   penRed.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(255, 0, 0));

   // Draw from 3 o'clock to 6 o'clock, counterclockwise,
   // in a blue pen.

   pOldPen = pDC->SelectObject(&penBlue);

   pDC->Arc(rectClient,
            CPoint(rectClient.right, rectClient.CenterPoint().y),
            CPoint(rectClient.CenterPoint().x, rectClient.right));

   // Draw from 6 o'clock to 3 o'clock, counterclockwise,
   // in a red pen.
   pDC->SelectObject(&penRed);

   // Keep the same parameters, but reverse start
   // and end points.
   pDC->Arc(rectClient,
            CPoint(rectClient.CenterPoint().x, rectClient.right),
            CPoint(rectClient.right, rectClient.CenterPoint().y));

   // Restore the previous pen.
   pDC->SelectObject(pOldPen);
}

`CDC::ArcTo`

Desenha um arco elíptico.

BOOL ArcTo(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL ArcTo(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);