Classe CGdiObject

Fornisce una classe di base per diversi generi di oggetti GDI (Graphics Device Interface) di Windows, quali bitmap, aree, pennelli, penne, tavolozze e tipi di carattere.

Sintassi

class CGdiObject : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CGdiObject::CGdiObject	Costruisce un oggetto CGdiObject.

Metodi pubblici

Nome	Descrizione
CGdiObject::Attach	Associa un oggetto Windows GDI a un CGdiObject oggetto .
CGdiObject::CreateStockObject	Recupera un handle in una delle penne predefinite, pennelli o tipi di carattere predefiniti di Windows.
CGdiObject::D eleteObject	Elimina l'oggetto GDI di Windows collegato all'oggetto CGdiObject dalla memoria liberando tutte le risorse di archiviazione di sistema associate all'oggetto .
CGdiObject::D eleteTempMap	Elimina tutti gli oggetti temporanei CGdiObject creati da FromHandle.
CGdiObject::D etach	Scollega un oggetto GDI di Windows da un CGdiObject oggetto e restituisce un handle all'oggetto GDI di Windows.
CGdiObject::FromHandle	Restituisce un puntatore a un CGdiObject oggetto dato un handle a un oggetto GDI di Windows.
CGdiObject::GetObject	Riempie un buffer con dati che descrivono l'oggetto GDI di Windows associato all'oggetto CGdiObject .
CGdiObject::GetObjectType	Recupera il tipo dell'oggetto GDI.
CGdiObject::Get Cassaforte Handle	Restituisce m_hObject a meno che non this sia NULL, nel qual caso viene restituito NULL.
CGdiObject::Unobject	Reimposta l'origine di un pennello o reimposta una tavolozza logica.

Operatori pubblici

Nome	Descrizione
CGdiObject::operator !=	Determina se due oggetti GDI sono logicamente non uguali.
CGdiObject::operator ==	Determina se due oggetti GDI sono logicamente uguali.
CGdiObject::operator HGDIOBJ	Recupera un handle all'oggetto GDI di Windows associato.

Membri dati pubblici

Nome	Descrizione
CGdiObject::m_hObject	HANDLE contenente HBITMAP, HPALETTE, HRGN, HBRUSH, HPEN o HFONT associato a questo oggetto.

Osservazioni:

Non si crea mai direttamente un oggetto CGdiObject . Invece, si crea un oggetto da una delle relative classi derivate, ad esempio CPen o CBrush.

Per altre informazioni su CGdiObject, vedere Oggetti grafici.

Gerarchia di ereditarietà

CObject

CGdiObject

Requisiti

Intestazione: afxwin.h

CGdiObject::Attach

Associa un oggetto Windows GDI a un CGdiObject oggetto .

BOOL Attach(HGDIOBJ hObject);

Parametri

hObject
Handle per un oggetto GDI di Windows, ad esempio HPEN o HBRUSH.

Valore restituito

Diverso da zero se l'allegato ha esito positivo; in caso contrario, 0.

CGdiObject::CGdiObject

Costruisce un oggetto CGdiObject.

CGdiObject();

Osservazioni:

Non si crea mai direttamente un oggetto CGdiObject . Invece, si crea un oggetto da una delle relative classi derivate, ad esempio CPen o Cbrush.

CGdiObject::CreateStockObject

Recupera un handle in uno degli oggetti GDI predefiniti di Windows GDI, pennelli o tipi di carattere predefiniti e associa l'oggetto GDI all'oggetto CGdiObject .

BOOL CreateStockObject(int nIndex);

Parametri

nIndex
Costante che specifica il tipo di oggetto stock desiderato. Per una descrizione dei valori appropriati, vedere il parametro fnObject per GetStockObject in Windows SDK.

Valore restituito

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

Osservazioni:

Chiamare questa funzione con una delle classi derivate che corrisponde al tipo di oggetto GDI di Windows, ad esempio CPen per una penna stock.

CGdiObject::D eleteObject

Elimina l'oggetto GDI di Windows collegato dalla memoria liberando tutte le risorse di archiviazione di sistema associate all'oggetto GDI di Windows.

BOOL DeleteObject();

Valore restituito

Diverso da zero se l'oggetto GDI è stato eliminato correttamente; in caso contrario, 0.

Osservazioni:

Lo spazio di archiviazione associato all'oggetto CGdiObject non è interessato da questa chiamata. Un'applicazione non deve chiamare DeleteObject su un CGdiObject oggetto attualmente selezionato in un contesto di dispositivo.

Quando un pennello di motivo viene eliminato, la bitmap associata al pennello non viene eliminata. La bitmap deve essere eliminata in modo indipendente.

CGdiObject::D eleteTempMap

Chiamato automaticamente dal CWinApp gestore tempo di inattività, DeleteTempMap elimina tutti gli oggetti temporanei CGdiObject creati da FromHandle.

static void PASCAL DeleteTempMap();

Osservazioni:

DeleteTempMap scollega l'oggetto GDI di Windows collegato a un oggetto temporaneo CGdiObject prima di eliminare l'oggetto CGdiObject .

Esempio

// DeleteTempMap() is a static member and so does not need to
// be called within the scope of an instantiated CGdiObject object.
CGdiObject::DeleteTempMap();

CGdiObject::D etach

Scollega un oggetto GDI di Windows da un CGdiObject oggetto e restituisce un handle all'oggetto GDI di Windows.

HGDIOBJ Detach();

Valore restituito

Oggetto HANDLE per l'oggetto GDI di Windows scollegato; in caso contrario, NULL se non è associato alcun oggetto GDI.

CGdiObject::FromHandle

Restituisce un puntatore a un CGdiObject oggetto dato un handle a un oggetto GDI di Windows.

static CGdiObject* PASCAL FromHandle(HGDIOBJ hObject);

Parametri

hObject
Handle per un oggetto GDI di Windows.

Valore restituito

Puntatore a un CGdiObject oggetto che può essere temporaneo o permanente.

Osservazioni:

Se un CGdiObject oggetto non è già collegato all'oggetto GDI di Windows, viene creato e associato un oggetto temporaneo CGdiObject .

Questo oggetto temporaneo CGdiObject è valido solo fino alla successiva esecuzione del tempo di inattività dell'applicazione nel ciclo di eventi, in cui vengono eliminati tutti gli oggetti grafici temporanei. Un altro modo per dire questo è che l'oggetto temporaneo è valido solo durante l'elaborazione di un messaggio di finestra.

CGdiObject::GetObject

Riempie un buffer con dati che definiscono un oggetto specificato.

int GetObject(
    int nCount,
    LPVOID lpObject) const;

Parametri

nCount
Specifica il numero di byte da copiare nel buffer lpObject .

lpObject
Punta a un buffer fornito dall'utente che deve ricevere le informazioni.

Valore restituito

Numero di byte recuperati; in caso contrario, 0 se si verifica un errore.

Osservazioni:

La funzione recupera una struttura di dati il cui tipo dipende dal tipo di oggetto grafico, come illustrato nell'elenco seguente:

Oggetto	Tipo di buffer
CPen	LOGPEN
CBrush	LOGBRUSH
CFont	LOGFONT
CBitmap	BITMAP
CPalette	WORD
CRgn	Non supportato

Se l'oggetto è un CBitmap oggetto, GetObject restituisce solo le informazioni sul formato di larghezza, altezza e colore della bitmap. I bit effettivi possono essere recuperati usando CBitmap::GetBitmapBits.

Se l'oggetto è un CPalette oggetto , GetObject recupera un oggetto WORD che specifica il numero di voci nella tavolozza. La funzione non recupera la struttura LOGPALETTE che definisce la tavolozza. Un'applicazione può ottenere informazioni sulle voci del riquadro chiamando CPalette::GetPaletteEntries.

CGdiObject::GetObjectType

Recupera il tipo dell'oggetto GDI.

UINT GetObjectType() const;

Valore restituito

Tipo dell'oggetto, se riuscito; in caso contrario, 0. Il valore può essere uno dei seguenti:

• OBJ_BITMAP Bitmap

• pennello OBJ_BRUSH

• tipo di carattere OBJ_FONT

• tavolozza OBJ_PAL

• penna OBJ_PEN

• OBJ_EXTPEN penna estesa

• area OBJ_REGION

• OBJ_DC Contesto dispositivo

• OBJ_MEMDC contesto del dispositivo memoria

• OBJ_METAFILE Metafile

• OBJ_METADC contesto di dispositivo Metafile

• OBJ_ENHMETAFILE metafile avanzato

• OBJ_ENHMETADC contesto di dispositivo metafile avanzato

CGdiObject::Get Cassaforte Handle

Restituisce m_hObject a meno che non this sia NULL, nel qual caso viene restituito NULL.

HGDIOBJ GetSafeHandle() const;

Valore restituito

Handle all'oggetto GDI di Windows collegato; in caso contrario, NULL se non è associato alcun oggetto.

Osservazioni:

Questo fa parte del paradigma dell'interfaccia handle generale ed è utile quando NULL è un valore valido o speciale per un handle.

Esempio

Vedere l'esempio per CWnd::IsWindowEnabled.

CGdiObject::m_hObject

HANDLE contenente HBITMAP, HRGN, HBRUSH, HPEN, HPALETTE o HFONT associato a questo oggetto.

HGDIOBJ m_hObject;

CGdiObject::operator !=

Determina se due oggetti GDI sono logicamente non uguali.

BOOL operator!=(const CGdiObject& obj) const;

Parametri

obj
Puntatore a un oggetto esistente CGdiObject.

Osservazioni:

Determina se un oggetto GDI a sinistra non è uguale a un oggetto GDI a destra.

CGdiObject::operator ==

Determina se due oggetti GDI sono logicamente uguali.

BOOL operator==(const CGdiObject& obj) const;

Parametri

obj
Riferimento a un oggetto esistente CGdiObject.

Osservazioni:

Determina se un oggetto GDI a sinistra è uguale a un oggetto GDI a destra.

CGdiObject::operator HGDIOBJ

Recupera un handle all'oggetto GDI di Windows collegato; in caso contrario, NULL se non è associato alcun oggetto.

operator HGDIOBJ() const;

CGdiObject::Unobject

Reimposta l'origine di un pennello o reimposta una tavolozza logica.

BOOL UnrealizeObject();

Valore restituito

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

Osservazioni:

Mentre UnrealizeObject è una funzione membro della CGdiObject classe , deve essere richiamata solo su CBrush oggetti o CPalette .

Per CBrush gli oggetti, UnrealizeObject indirizza il sistema a reimpostare l'origine del pennello specificato alla successiva selezione in un contesto di dispositivo. Se l'oggetto è un CPalette oggetto, UnrealizeObject indirizza il sistema a realizzare la tavolozza come se non fosse stata realizzata in precedenza. La volta successiva che l'applicazione chiama la funzione CDC::RealizePalette per la tavolozza specificata, il sistema esegue completamente il mapping della tavolozza logica alla tavolozza di sistema.

La UnrealizeObject funzione non deve essere usata con oggetti stock. La UnrealizeObject funzione deve essere chiamata ogni volta che viene impostata una nuova origine pennello (tramite la funzione CDC::SetBrushOrg ). La UnrealizeObject funzione non deve essere chiamata per il pennello attualmente selezionato o la tavolozza attualmente selezionata di qualsiasi contesto di visualizzazione.

Vedi anche

Grafico della gerarchia
Classe CBitmap
Classe CBrush
Classe CFont
Classe CPalette
Classe CPen
Classe CRgn