Classe `CDC`

Articolo
10/12/2023

Definisce una classe di oggetti di un contesto di dispositivo.

Sintassi

class CDC : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
`CDC::CDC`	Costruisce un oggetto `CDC`.

Metodi pubblici

Nome	Descrizione
`CDC::AbortDoc`	Termina il processo di stampa corrente, cancellando tutto ciò che l'applicazione ha scritto nel dispositivo dall'ultima chiamata della `StartDoc` funzione membro.
`CDC::AbortPath`	Chiude e rimuove tutti i percorsi nel contesto del dispositivo.
`CDC::AddMetaFileComment`	Copia il commento da un buffer in un metafile in formato avanzato specificato.
`CDC::AlphaBlend`	Visualizza bitmap con pixel trasparenti o semitrasparenti.
`CDC::AngleArc`	Disegna un segmento di linea e un arco e sposta la posizione corrente al punto finale dell'arco.
`CDC::Arc`	Disegna un arco ellittico.
`CDC::ArcTo`	Disegna un arco ellittico. Questa funzione è simile a `Arc`, ad eccezione del fatto che la posizione corrente viene aggiornata.
`CDC::Attach`	Collega un contesto di dispositivo Windows a questo `CDC` oggetto.
`CDC::BeginPath`	Apre una parentesi di percorso nel contesto del dispositivo.
`CDC::BitBlt`	Copia una bitmap da un contesto di dispositivo specificato.
`CDC::Chord`	Disegna un accordo (figura chiusa delimitata dall'intersezione di un'ellisse e un segmento di linea).
`CDC::CloseFigure`	Chiude una figura aperta in un percorso.
`CDC::CreateCompatibleDC`	Crea un contesto di memoria-dispositivo compatibile con un altro contesto di dispositivo. È possibile usarlo per preparare le immagini in memoria.
`CDC::CreateDC`	Crea un contesto di dispositivo per un dispositivo specifico.
`CDC::CreateIC`	Crea un contesto informativo per un dispositivo specifico. In questo modo è possibile ottenere rapidamente informazioni sul dispositivo senza creare un contesto di dispositivo.
`CDC::DeleteDC`	Elimina il contesto di dispositivo Windows associato a questo `CDC` oggetto.
`CDC::DeleteTempMap`	Chiamato dal `CWinApp` gestore tempo di inattività per eliminare qualsiasi oggetto temporaneo `CDC` creato da `FromHandle`. Scollega anche il contesto del dispositivo.
`CDC::Detach`	Scollega il contesto del dispositivo Windows da questo `CDC` oggetto.
`CDC::DPtoHIMETRIC`	Converte le unità di dispositivo in `HIMETRIC` unità.
`CDC::DPtoLP`	Converte le unità di dispositivo in unità logiche.
`CDC::Draw3dRect`	Disegna un rettangolo tridimensionale.
`CDC::DrawDragRect`	Cancella e ridisegna un rettangolo mentre viene trascinato.
`CDC::DrawEdge`	Disegna i bordi di un rettangolo.
`CDC::DrawEscape`	Accede alle funzionalità di disegno di una visualizzazione video che non sono direttamente disponibili tramite l'interfaccia GDI (Graphics Device Interface).
`CDC::DrawFocusRect`	Disegna un rettangolo nello stile utilizzato per indicare lo stato attivo.
`CDC::DrawFrameControl`	Disegnare un controllo cornice.
`CDC::DrawIcon`	Disegna un'icona.
`CDC::DrawState`	Visualizza un'immagine e applica un effetto visivo per indicare uno stato.
`CDC::DrawText`	Disegna testo formattato nel rettangolo specificato.
`CDC::DrawTextEx`	Disegna testo formattato nel rettangolo specificato utilizzando altri formati.
`CDC::Ellipse`	Disegna un ellisse.
`CDC::EndDoc`	Termina un processo di stampa avviato dalla `StartDoc` funzione membro.
`CDC::EndPage`	Informa il driver di dispositivo che una pagina sta terminando.
`CDC::EndPath`	Chiude una parentesi di percorso e seleziona il percorso definito dalla parentesi quadra nel contesto del dispositivo.
`CDC::EnumObjects`	Enumera le penne e i pennelli disponibili in un contesto di dispositivo.
`CDC::Escape`	Consente alle applicazioni di accedere alle strutture che non sono direttamente disponibili da un particolare dispositivo tramite GDI. Consente anche l'accesso alle funzioni di escape di Windows. Le chiamate di escape effettuate da un'applicazione vengono convertite e inviate al driver di dispositivo.
`CDC::ExcludeClipRect`	Crea una nuova area di ritaglio costituita dall'area di ritaglio esistente meno il rettangolo specificato.
`CDC::ExcludeUpdateRgn`	Impedisce il disegno all'interno di aree non valide di una finestra escludendo un'area aggiornata nella finestra da un'area di ritaglio.
`CDC::ExtFloodFill`	Riempie un'area con il pennello corrente. Offre maggiore flessibilità rispetto alla `CDC::FloodFill` funzione membro.
`CDC::ExtTextOut`	Scrive una stringa di caratteri all'interno di un'area rettangolare utilizzando il tipo di carattere attualmente selezionato.
`CDC::FillPath`	Chiude tutte le figure aperte nel percorso corrente e riempie l'interno del percorso utilizzando la modalità corrente di riempimento del pennello e del poligono.
`CDC::FillRect`	Riempie un determinato rettangolo usando un pennello specifico.
`CDC::FillRgn`	Riempie un'area specifica con il pennello specificato.
`CDC::FillSolidRect`	Riempie un rettangolo con un colore a tinta unita.
`CDC::FlattenPath`	Trasforma tutte le curve nel percorso selezionato nel contesto di dispositivo corrente e trasforma ogni curva in una sequenza di linee.
`CDC::FloodFill`	Riempie un'area con il pennello corrente.
`CDC::FrameRect`	Disegna un bordo intorno a un rettangolo.
`CDC::FrameRgn`	Disegna un bordo intorno a un'area specifica usando un pennello.
`CDC::FromHandle`	Restituisce un puntatore a un `CDC` oggetto quando viene assegnato un handle a un contesto di dispositivo. Se un `CDC` oggetto non è collegato all'handle, viene creato e collegato un oggetto temporaneo `CDC` .
`CDC::GetArcDirection`	Restituisce la direzione dell'arco corrente per il contesto di dispositivo.
`CDC::GetAspectRatioFilter`	Recupera l'impostazione per il filtro delle proporzioni corrente.
`CDC::GetBkColor`	Recupera il colore di sfondo corrente.
`CDC::GetBkMode`	Recupera la modalità in background.
`CDC::GetBoundsRect`	Restituisce il rettangolo di delimitazione accumulato corrente per il contesto di dispositivo specificato.
`CDC::GetBrushOrg`	Recupera l'origine del pennello corrente.
`CDC::GetCharABCWidths`	Recupera le larghezze, in unità logiche, di caratteri consecutivi in un determinato intervallo dal tipo di carattere corrente.
`CDC::GetCharABCWidthsI`	Recupera le larghezze, in unità logiche, di indici glifi consecutivi in un intervallo specificato dal tipo di carattere TrueType corrente.
`CDC::GetCharacterPlacement`	Recupera vari tipi di informazioni su una stringa di caratteri.
`CDC::GetCharWidth`	Recupera le larghezze frazionarie di caratteri consecutivi in un determinato intervallo dal tipo di carattere corrente.
`CDC::GetCharWidthI`	Recupera le larghezze, in coordinate logiche, di indici glifi consecutivi in un intervallo specificato dal tipo di carattere corrente.
`CDC::GetClipBox`	Recupera le dimensioni del rettangolo di delimitazione più stretto intorno al limite di ritaglio corrente.
`CDC::GetColorAdjustment`	Recupera i valori di regolazione del colore per il contesto di dispositivo.
`CDC::GetCurrentBitmap`	Restituisce un puntatore all'oggetto attualmente selezionato `CBitmap` .
`CDC::GetCurrentBrush`	Restituisce un puntatore all'oggetto attualmente selezionato `CBrush` .
`CDC::GetCurrentFont`	Restituisce un puntatore all'oggetto attualmente selezionato `CFont` .
`CDC::GetCurrentPalette`	Restituisce un puntatore all'oggetto attualmente selezionato `CPalette` .
`CDC::GetCurrentPen`	Restituisce un puntatore all'oggetto attualmente selezionato `CPen` .
`CDC::GetCurrentPosition`	Recupera la posizione corrente della penna (in coordinate logiche).
`CDC::GetDCBrushColor`	Recupera il colore corrente del pennello.
`CDC::GetDCPenColor`	Recupera il colore corrente della penna.
`CDC::GetDeviceCaps`	Recupera un tipo specificato di informazioni specifiche del dispositivo sulle funzionalità di un determinato dispositivo di visualizzazione.
`CDC::GetFontData`	Recupera le informazioni sulle metriche dei tipi di carattere da un file di tipo di carattere scalabile. Le informazioni da recuperare vengono identificate specificando un offset nel file del tipo di carattere e la lunghezza delle informazioni da restituire.
`CDC::GetFontLanguageInfo`	Restituisce informazioni sul tipo di carattere attualmente selezionato per il contesto di visualizzazione specificato.
`CDC::GetGlyphOutline`	Recupera la curva del contorno o la bitmap per un carattere di struttura nel tipo di carattere corrente.
`CDC::GetGraphicsMode`	Recupera la modalità grafica corrente per il contesto di dispositivo specificato.
`CDC::GetHalftoneBrush`	Recupera un pennello mezzotone.
`CDC::GetKerningPairs`	Recupera le coppie di crenatura dei caratteri per il tipo di carattere attualmente selezionato nel contesto di dispositivo specificato.
`CDC::GetLayout`	Recupera il layout di un contesto di dispositivo (DC). Il layout può essere da sinistra a destra (impostazione predefinita) o da destra a sinistra (con mirroring).
`CDC::GetMapMode`	Recupera la modalità di mapping corrente.
`CDC::GetMiterLimit`	Restituisce il limite di miter per il contesto di dispositivo.
`CDC::GetNearestColor`	Recupera il colore logico più vicino a un colore logico specificato che il dispositivo specificato può rappresentare.
`CDC::GetOutlineTextMetrics`	Recupera le informazioni sulle metriche dei tipi di carattere per i tipi di carattere TrueType.
`CDC::GetOutputCharWidth`	Recupera la larghezza dei singoli caratteri in un gruppo consecutivo di caratteri dal tipo di carattere corrente usando il contesto del dispositivo di output.
`CDC::GetOutputTabbedTextExtent`	Calcola la larghezza e l'altezza di una stringa di caratteri nel contesto del dispositivo di output.
`CDC::GetOutputTextExtent`	Calcola la larghezza e l'altezza di una riga di testo nel contesto del dispositivo di output usando il tipo di carattere corrente per determinare le dimensioni.
`CDC::GetOutputTextMetrics`	Recupera le metriche per il tipo di carattere corrente dal contesto del dispositivo di output.
`CDC::GetPath`	Recupera le coordinate che definiscono gli endpoint delle linee e i punti di controllo delle curve presenti nel percorso selezionato nel contesto del dispositivo.
`CDC::GetPixel`	Recupera il valore del colore RGB del pixel in corrispondenza del punto specificato.
`CDC::GetPolyFillMode`	Recupera la modalità di riempimento poligono corrente.
`CDC::GetROP2`	Recupera la modalità di disegno corrente.
`CDC::GetSafeHdc`	Restituisce `CDC::m_hDC`, il contesto del dispositivo di output.
`CDC::GetStretchBltMode`	Recupera la modalità di estensione bitmap corrente.
`CDC::GetTabbedTextExtent`	Calcola la larghezza e l'altezza di una stringa di caratteri nel contesto del dispositivo dell'attributo.
`CDC::GetTextAlign`	Recupera i flag di allineamento del testo.
`CDC::GetTextCharacterExtra`	Recupera l'impostazione corrente per la quantità di spaziatura intercaracter.
`CDC::GetTextColor`	Recupera il colore del testo corrente.
`CDC::GetTextExtent`	Calcola la larghezza e l'altezza di una riga di testo nel contesto del dispositivo dell'attributo usando il tipo di carattere corrente per determinare le dimensioni.
`CDC::GetTextExtentExPointI`	Recupera il numero di caratteri in una stringa specificata che verrà inserita all'interno di uno spazio specificato e riempie una matrice con l'extent di testo per ognuno di questi caratteri.
`CDC::GetTextExtentPointI`	Recupera la larghezza e l'altezza della matrice specificata di indici del glifo.
`CDC::GetTextFace`	Copia il nome del carattere tipografico del tipo di carattere corrente in un buffer come stringa con terminazione Null.
`CDC::GetTextMetrics`	Recupera le metriche per il tipo di carattere corrente dal contesto del dispositivo dell'attributo.
`CDC::GetViewportExt`	Recupera gli extent x e y del riquadro di visualizzazione.
`CDC::GetViewportOrg`	Recupera le coordinate x e y dell'origine del riquadro di visualizzazione.
`CDC::GetWindow`	Restituisce la finestra associata al contesto di dispositivo di visualizzazione.
`CDC::GetWindowExt`	Recupera gli extent x e y della finestra associata.
`CDC::GetWindowOrg`	Recupera le coordinate x e y dell'origine della finestra associata.
`CDC::GetWorldTransform`	Recupera lo spazio globale corrente nella trasformazione dello spazio delle pagine.
`CDC::GradientFill`	Riempie strutture rettangolo e triangolo con un colore di gradazione.
`CDC::GrayString`	Disegna testo in grigio (grigio) nella posizione specificata.
`CDC::HIMETRICtoDP`	Converte le unità HIMETRIC in unità dispositivo.
`CDC::HIMETRICtoLP`	Converte le unità HIMETRIC in unità logiche.
`CDC::IntersectClipRect`	Crea una nuova area di ritaglio formando l'intersezione dell'area corrente e un rettangolo.
`CDC::InvertRect`	Inverte il contenuto di un rettangolo.
`CDC::InvertRgn`	Inverte i colori in un'area.
`CDC::IsPrinting`	Determina se il contesto del dispositivo viene utilizzato per la stampa.
`CDC::LineTo`	Disegna una linea dalla posizione corrente fino a, ma non include, un punto.
`CDC::LPtoDP`	Converte le unità logiche in unità dispositivo.
`CDC::LPtoHIMETRIC`	Converte le unità logiche in unità HIMETRIC.
`CDC::MaskBlt`	Combina i dati di colore per le bitmap di origine e di destinazione usando l'operazione di maschera e raster specificata.
`CDC::ModifyWorldTransform`	Modifica la trasformazione globale per un contesto di dispositivo usando la modalità specificata.
`CDC::MoveTo`	Sposta la posizione corrente.
`CDC::OffsetClipRgn`	Sposta l'area di ritaglio del dispositivo specificato.
`CDC::OffsetViewportOrg`	Modifica l'origine del riquadro di visualizzazione rispetto alle coordinate dell'origine del riquadro di visualizzazione corrente.
`CDC::OffsetWindowOrg`	Modifica l'origine della finestra rispetto alle coordinate dell'origine della finestra corrente.
`CDC::PaintRgn`	Riempie un'area con il pennello selezionato.
`CDC::PatBlt`	Crea un modello di bit.
`CDC::Pie`	Disegna una wedge a forma di torta.
`CDC::PlayMetaFile`	Riproduce il contenuto del metafile specificato nel dispositivo specificato. La versione avanzata di `PlayMetaFile` visualizza l'immagine archiviata nel metafile in formato avanzato specificato. Il metafile può essere riprodotto un numero qualsiasi di volte.
`CDC::PlgBlt`	Esegue un trasferimento bit-block dei bit dei dati di colore dal rettangolo specificato nel contesto del dispositivo di origine al parallelogramma specificato nel contesto di dispositivo specificato nel contesto di dispositivo specificato.
`CDC::PolyBezier`	Disegna una o più spline di Bzier. La posizione corrente non viene usata o aggiornata.
`CDC::PolyBezierTo`	Disegna uno o più spline di Bzier e sposta la posizione corrente al punto finale dell'ultima spline di Bzier.
`CDC::PolyDraw`	Disegna un set di segmenti di linea e spline di Bzier. Questa funzione aggiorna la posizione corrente.
`CDC::Polygon`	Disegna un poligono costituito da due o più punti (vertici) collegati da linee.
`CDC::Polyline`	Disegna un set di segmenti di linea che collegano i punti specificati.
`CDC::PolylineTo`	Disegna una o più linee rette e sposta la posizione corrente al punto finale dell'ultima linea.
`CDC::PolyPolygon`	Crea due o più poligoni riempiti usando la modalità di riempimento poligono corrente. I poligoni possono essere disgiunti o possono sovrapporsi.
`CDC::PolyPolyline`	Disegna più serie di segmenti di linea collegati. La posizione corrente non viene usata o aggiornata da questa funzione.
`CDC::PtVisible`	Specifica se il punto specificato si trova all'interno dell'area di ritaglio.
`CDC::RealizePalette`	Mappe voci della tavolozza logica corrente nella tavolozza del sistema.
`CDC::Rectangle`	Disegna un rettangolo utilizzando la penna corrente e lo riempie usando il pennello corrente.
`CDC::RectVisible`	Determina se una parte del rettangolo specificato si trova all'interno dell'area di ritaglio.
`CDC::ReleaseAttribDC`	Rilascia `m_hAttribDC`, il contesto del dispositivo dell'attributo.
`CDC::ReleaseOutputDC`	Rilascia `m_hDC`, il contesto del dispositivo di output.
`CDC::ResetDC`	Aggiornamenti il contesto del `m_hAttribDC` dispositivo.
`CDC::RestoreDC`	Ripristina il contesto del dispositivo in uno stato precedente salvato con `SaveDC`.
`CDC::RoundRect`	Disegna un rettangolo con angoli arrotondati usando la penna corrente e riempita utilizzando il pennello corrente.
`CDC::SaveDC`	Salva lo stato corrente del contesto di dispositivo.
`CDC::ScaleViewportExt`	Modifica l'extent del riquadro di visualizzazione rispetto ai valori correnti.
`CDC::ScaleWindowExt`	Modifica gli extent della finestra rispetto ai valori correnti.
`CDC::ScrollDC`	Scorre un rettangolo di bit orizzontalmente e verticalmente.
`CDC::SelectClipPath`	Seleziona il percorso corrente come area di ritaglio per il contesto di dispositivo, combinando la nuova area con qualsiasi area di ritaglio esistente usando la modalità specificata.
`CDC::SelectClipRgn`	Combina l'area specificata con l'area di ritaglio corrente usando la modalità specificata.
`CDC::SelectObject`	Seleziona un oggetto di disegno GDI, ad esempio una penna.
`CDC::SelectPalette`	Seleziona la tavolozza logica.
`CDC::SelectStockObject`	Seleziona una delle penne predefinite, i pennelli o i tipi di carattere forniti da Windows.
`CDC::SetAbortProc`	Imposta una funzione di callback fornita dal programmatore che Windows chiama se un processo di stampa deve essere interrotto.
`CDC::SetArcDirection`	Imposta la direzione del disegno da utilizzare per le funzioni arco e rettangolo.
`CDC::SetAttribDC`	Imposta `m_hAttribDC`, il contesto del dispositivo dell'attributo.
`CDC::SetBkColor`	Imposta il colore di sfondo corrente.
`CDC::SetBkMode`	Imposta la modalità di sfondo.
`CDC::SetBoundsRect`	Controlla l'accumulo di informazioni sul rettangolo di delimitazione per il contesto di dispositivo specificato.
`CDC::SetBrushOrg`	Specifica l'origine del pennello successivo selezionato in un contesto di dispositivo.
`CDC::SetColorAdjustment`	Imposta i valori di regolazione del colore per il contesto di dispositivo usando i valori specificati.
`CDC::SetDCBrushColor`	Imposta il colore corrente del pennello.
`CDC::SetDCPenColor`	Imposta il colore corrente della penna.
`CDC::SetGraphicsMode`	Imposta la modalità grafica corrente per il contesto di dispositivo specificato.
`CDC::SetLayout`	Modifica il layout di un contesto di dispositivo (DC).
`CDC::SetMapMode`	Imposta la modalità di mapping corrente.
`CDC::SetMapperFlags`	Modifica l'algoritmo utilizzato dal mapper del tipo di carattere quando esegue il mapping dei tipi di carattere logici ai tipi di carattere fisici.
`CDC::SetMiterLimit`	Imposta il limite per la lunghezza dei join di miter per il contesto di dispositivo.
`CDC::SetOutputDC`	Imposta `m_hDC`, il contesto del dispositivo di output.
`CDC::SetPixel`	Imposta il pixel in corrispondenza del punto specificato sull'approssimazione più vicina del colore specificato.
`CDC::SetPixelV`	Imposta il pixel in corrispondenza delle coordinate specificate sull'approssimazione più vicina del colore specificato. `SetPixelV` è più veloce rispetto `SetPixel` al fatto che non è necessario restituire il valore di colore del punto disegnato.
`CDC::SetPolyFillMode`	Imposta la modalità di riempimento poligono.
`CDC::SetROP2`	Imposta la modalità di disegno corrente.
`CDC::SetStretchBltMode`	Imposta la modalità di estensione bitmap.
`CDC::SetTextAlign`	Imposta i flag di allineamento del testo.
`CDC::SetTextCharacterExtra`	Imposta la quantità di spaziatura intercharacter.
`CDC::SetTextColor`	Imposta il colore del testo.
`CDC::SetTextJustification`	Aggiunge spazio ai caratteri di interruzione in una stringa.
`CDC::SetViewportExt`	Imposta gli extent x e y del riquadro di visualizzazione.
`CDC::SetViewportOrg`	Imposta l'origine del riquadro di visualizzazione.
`CDC::SetWindowExt`	Imposta gli extent x e y della finestra associata.
`CDC::SetWindowOrg`	Imposta l'origine della finestra del contesto di dispositivo.
`CDC::SetWorldTransform`	Imposta lo spazio globale corrente sulla trasformazione dello spazio delle pagine.
`CDC::StartDoc`	Informa il driver di dispositivo che è in corso l'avvio di un nuovo processo di stampa.
`CDC::StartPage`	Informa il driver di dispositivo che è in corso l'avvio di una nuova pagina.
`CDC::StretchBlt`	Sposta una bitmap da un rettangolo di origine e un dispositivo in un rettangolo di destinazione, estendendo o comprimendo la bitmap, se necessario per adattare le dimensioni del rettangolo di destinazione.
`CDC::StrokeAndFillPath`	Chiude tutte le figure aperte in un percorso, colpisce il contorno del percorso utilizzando la penna corrente e riempie l'interno utilizzando il pennello corrente.
`CDC::StrokePath`	Esegue il rendering del percorso specificato utilizzando la penna corrente.
`CDC::TabbedTextOut`	Scrive una stringa di caratteri in una posizione specificata, espandendo le schede nei valori specificati in una matrice di posizioni tabulazioni.
`CDC::TextOut`	Scrive una stringa di caratteri in una posizione specificata utilizzando il tipo di carattere attualmente selezionato.
`CDC::TransparentBlt`	Trasferisce un blocco bit di dati colore dal contesto del dispositivo di origine specificato in un contesto di dispositivo di destinazione, rendendo trasparente un colore specificato nel trasferimento.
`CDC::UpdateColors`	Aggiornamenti l'area client del contesto di dispositivo associando i colori correnti nell'area client alla tavolozza del sistema in base a pixel per pixel.
`CDC::WidenPath`	Ridefinisce il percorso corrente come area che verrebbe disegnata se il percorso fosse tracciato utilizzando la penna attualmente selezionata nel contesto del dispositivo.

Operatori pubblici

Nome	Descrizione
`CDC::operator HDC`	Recupera l'handle del contesto di dispositivo.

Membri dati pubblici

Nome	Descrizione
`CDC::m_hAttribDC`	Contesto attributo-dispositivo utilizzato da questo `CDC` oggetto.
`CDC::m_hDC`	Contesto del dispositivo di output usato da questo `CDC` oggetto.

Osservazioni:

L'oggetto CDC fornisce funzioni membro per l'utilizzo di un contesto di dispositivo, ad esempio uno schermo o una stampante, e i membri per l'utilizzo di un contesto di visualizzazione associato all'area client di una finestra.

Eseguire tutte le operazioni di disegno tramite le funzioni membro di un CDC oggetto . La classe fornisce funzioni membro per le operazioni di contesto del dispositivo, l'uso di strumenti di disegno, la selezione di oggetti GDI (Type-Safe Graphics Device Interface) e l'uso di colori e tavolozze. Fornisce inoltre funzioni membro per ottenere e impostare attributi di disegno, mapping, utilizzo del riquadro di visualizzazione, utilizzo dell'extent della finestra, conversione delle coordinate, utilizzo di aree, ritaglio, linee di disegno e disegno di forme semplici, puntini di sospensione e poligoni. Sono inoltre disponibili funzioni membro per il disegno di testo, l'uso di tipi di carattere, l'uso di escape della stampante, lo scorrimento e la riproduzione di metafile.

Per usare un CDC oggetto, crearlo e quindi chiamarne le funzioni membro che parallele funzioni di Windows che usano contesti di dispositivo.

Nota

In Windows 95/98 tutte le coordinate dello schermo sono limitate a 16 bit. Pertanto, un int oggetto passato a una CDC funzione membro deve trovarsi nell'intervallo da -32768 a 32767.

Per usi specifici, la libreria di classi Microsoft Foundation fornisce diverse classi derivate da CDC . CPaintDC incapsula le chiamate a BeginPaint e EndPaint. CClientDC gestisce un contesto di visualizzazione associato all'area client di una finestra. CWindowDC gestisce un contesto di visualizzazione associato a un'intera finestra, inclusi i relativi controlli e frame. CMetaFileDC associa un contesto di dispositivo a un metafile.

CDC fornisce due funzioni GetLayout membro e SetLayout, per ripristinare il layout di un contesto di dispositivo, che non eredita il layout da una finestra. Tale orientamento da destra a sinistra è necessario per le applicazioni scritte per le impostazioni cultura, ad esempio arabo o ebraico, in cui il layout dei caratteri non è lo standard europeo.

CDC contiene due contesti di dispositivo e m_hDCm_hAttribDC, che, alla creazione di un CDC oggetto, fanno riferimento allo stesso dispositivo. CDC indirizza tutte le chiamate GDI di output a m_hDC e la maggior parte delle chiamate GDI degli attributi a m_hAttribDC. Un esempio di chiamata di attributo è GetTextColor, mentre SetTextColor è una chiamata di output.

Ad esempio, il framework usa questi due contesti di dispositivo per implementare un CMetaFileDC oggetto che invierà l'output a un metafile durante la lettura degli attributi da un dispositivo fisico. L'anteprima di stampa viene implementata nel framework in modo simile. È anche possibile usare i due contesti di dispositivo in modo analogo nel codice specifico dell'applicazione.

In alcuni casi potrebbero essere necessarie informazioni sulle metriche di testo dai contesti di m_hDC dispositivo e m_hAttribDC . Le coppie di funzioni seguenti offrono questa funzionalità:

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

Per altre informazioni su CDC, vedere Contesti di dispositivo.

Gerarchia di ereditarietà

CObject

CDC

Requisiti

Intestazione:afxwin.h

`CDC::AbortDoc`

Termina il processo di stampa corrente e cancella tutto ciò che l'applicazione ha scritto nel dispositivo dall'ultima chiamata alla StartDoc funzione membro.

int AbortDoc();

Valore restituito

Valore maggiore o uguale a 0 se ha esito positivo o negativo se si è verificato un errore. L'elenco seguente mostra i valori di errore comuni e i relativi significati:

SP_ERROR Errore generale.
SP_OUTOFDISK Spazio su disco insufficiente attualmente disponibile per lo spooling e non sarà più disponibile spazio.
SP_OUTOFMEMORY Memoria insufficiente per lo spooling.
SP_USERABORT L'utente ha terminato il processo tramite Gestione stampa.

Osservazioni:

Questa funzione membro sostituisce l'escape della ABORTDOC stampante.

AbortDoc deve essere usato per terminare quanto segue:

Operazioni di stampa che non specificano una funzione di interruzione tramite SetAbortProc.
Operazioni di stampa che non hanno ancora raggiunto la prima NEWFRAME chiamata di escape o NEXTBAND .

Se un'applicazione rileva un errore di stampa o un'operazione di stampa annullata, non deve tentare di terminare l'operazione utilizzando le EndDoc funzioni membro o AbortDoc della classe CDC. GDI termina automaticamente l'operazione prima di restituire il valore di errore.

Se l'applicazione visualizza una finestra di dialogo per consentire all'utente di annullare l'operazione di stampa, deve chiamare AbortDoc prima di eliminare definitivamente la finestra di dialogo.

Se Gestione stampa è stato usato per avviare il processo di stampa, la chiamata AbortDoc cancella l'intero processo di spooling, ovvero la stampante non riceve nulla. Se Print Manager non è stato utilizzato per avviare il processo di stampa, è possibile che i dati siano stati inviati alla stampante prima AbortDoc della chiamata. In questo caso, il driver della stampante avrebbe reimpostato la stampante (quando possibile) e chiuso il processo di stampa.

Esempio

Vedere l'esempio per CDC::StartDoc.

`CDC::AbortPath`

Chiude e rimuove tutti i percorsi nel contesto del dispositivo.

BOOL AbortPath();

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario, 0.

Osservazioni:

Se nel contesto del dispositivo è presente una parentesi di percorso aperta, la parentesi di percorso viene chiusa e il percorso viene rimosso. Se nel contesto del dispositivo è presente un percorso chiuso, il percorso viene rimosso.

`CDC::AddMetaFileComment`

Copia il commento da un buffer in un metafile in formato avanzato specificato.

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

Parametri

nDataSize
Specifica la lunghezza in byte del buffer dei commenti.

pCommentData
Punta al buffer che contiene il commento.

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario, 0.

Osservazioni:

Un commento può includere informazioni private, ad esempio l'origine dell'immagine e la data di creazione. Un commento deve iniziare con una firma dell'applicazione, seguita dai dati. I commenti non devono contenere dati specifici della posizione. I dati specifici della posizione specificano la posizione di un record e non devono essere inclusi perché un metafile può essere incorporato all'interno di un altro metafile. Questa funzione può essere usata solo con metafile avanzati.

`CDC::AlphaBlend`

Chiamare questa funzione membro per visualizzare bitmap con pixel trasparenti o semitrasparenti.

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

Parametri

xDest
Specifica la coordinata x, in unità logiche, dell'angolo superiore sinistro del rettangolo di destinazione.

yDest
Specifica la coordinata y, in unità logiche, dell'angolo superiore sinistro del rettangolo di destinazione.

nDestWidth
Specifica la larghezza, in unità logiche, del rettangolo di destinazione.

nDestHeight
Specifica l'altezza, in unità logiche, del rettangolo di destinazione.

pSrcDC
Puntatore al contesto del dispositivo di origine.

xSrc
Specifica la coordinata x, in unità logiche, dell'angolo superiore sinistro del rettangolo di origine.

ySrc
Specifica la coordinata y, in unità logiche, dell'angolo superiore sinistro del rettangolo di origine.

nSrcWidth
Specifica la larghezza, in unità logiche, del rettangolo di origine.

nSrcHeight
Specifica l'altezza, in unità logiche, del rettangolo di origine.

blend
Specifica una BLENDFUNCTION struttura.

Valore restituito

TRUE se l'esito è positivo; in caso contrario, FALSE.

Osservazioni:

Per altre informazioni, vedere AlphaBlend in Windows SDK.

`CDC::AngleArc`

Disegna un segmento di linea e un arco.

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

Parametri

x
Specifica la coordinata x logica del centro del cerchio.

y
Specifica la coordinata y logica del centro del cerchio.

nRadius
Specifica il raggio del cerchio in unità logiche. Questo valore deve essere positivo.

fStartAngle
Specifica l'angolo iniziale in gradi rispetto all'asse x.

fSweepAngle
Specifica l'angolo di sweep in gradi rispetto all'angolo iniziale.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Il segmento di linea viene disegnato dalla posizione corrente all'inizio dell'arco. L'arco viene disegnato lungo il perimetro di un cerchio con il raggio e il centro specificati. La lunghezza dell'arco è definita dagli angoli iniziale e spazza specificati.

AngleArc sposta la posizione corrente al punto finale dell'arco. L'arco disegnato da questa funzione può sembrare ellittico, a seconda della modalità di trasformazione e mapping corrente. Prima di disegnare l'arco, questa funzione disegna il segmento di linea dalla posizione corrente all'inizio dell'arco. L'arco viene disegnato creando un cerchio immaginario con il raggio specificato intorno al punto centrale specificato. Il punto iniziale dell'arco è determinato misurando in senso antiorario dall'asse x del cerchio in base al numero di gradi nell'angolo iniziale. Il punto finale si trova in modo analogo misurando in senso antiorario dal punto iniziale in base al numero di gradi nell'angolo di sweep.

Se l'angolo di sweep è maggiore di 360 gradi, l'arco viene spazzato più volte. Questa funzione disegna linee utilizzando la penna corrente. La figura non viene riempita.

`CDC::Arc`

Disegna un arco ellittico.

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);

Parametri

x1
Specifica la coordinata x dell'angolo superiore sinistro del rettangolo di delimitazione (in unità logiche).

y1
Specifica la coordinata y dell'angolo superiore sinistro del rettangolo di delimitazione (in unità logiche).

x2
Specifica la coordinata x dell'angolo inferiore destro del rettangolo di delimitazione (in unità logiche).

y2
Specifica la coordinata y dell'angolo inferiore destro del rettangolo di delimitazione (in unità logiche).

x3
Specifica la coordinata x del punto che definisce il punto iniziale dell'arco (in unità logiche). Questo punto non deve trovarsi esattamente sull'arco.

y3
Specifica la coordinata y del punto che definisce il punto iniziale dell'arco (in unità logiche). Questo punto non deve trovarsi esattamente sull'arco.

x4
Specifica la coordinata x del punto che definisce l'endpoint dell'arco (in unità logiche). Questo punto non deve trovarsi esattamente sull'arco.

y4
Specifica la coordinata y del punto che definisce l'endpoint dell'arco (in unità logiche). Questo punto non deve trovarsi esattamente sull'arco.

lpRect
Specifica il rettangolo di delimitazione (in unità logiche). È possibile passare un LPRECT oggetto o CRect per questo parametro.

ptStart
Specifica le coordinate x e y del punto che definisce il punto iniziale dell'arco (in unità logiche). Questo punto non deve trovarsi esattamente sull'arco. È possibile passare una POINT struttura o un CPoint oggetto per questo parametro.

ptEnd
Specifica le coordinate x e y del punto che definisce il punto finale dell'arco (in unità logiche). Questo punto non deve trovarsi esattamente sull'arco. È possibile passare una POINT struttura o un CPoint oggetto per questo parametro.

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario, 0.

Osservazioni:

L'arco disegnato utilizzando la funzione è un segmento dell'ellisse definita dal rettangolo di delimitazione specificato.

Il punto iniziale effettivo dell'arco è il punto in cui un raggio disegnato dal centro del rettangolo di delimitazione attraverso il punto iniziale specificato interseca l'ellisse. Il punto finale effettivo dell'arco è il punto in cui un raggio disegnato dal centro del rettangolo di delimitazione attraverso il punto finale specificato interseca l'ellisse. L'arco viene disegnato in direzione antiorario. Poiché un arco non è una figura chiusa, non viene riempito. Sia la larghezza che l'altezza del rettangolo devono essere maggiori di 2 unità e inferiori a 32.767 unità.

Esempio

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`

Disegna un arco ellittico.

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);