CDC::SelectObject
Wählt ein Objekt in den Gerätekontext aus.
CPen* SelectObject(
CPen* pPen
);
CBrush* SelectObject(
CBrush* pBrush
);
virtual CFont* SelectObject(
CFont* pFont
);
CBitmap* SelectObject(
CBitmap* pBitmap
);
int SelectObject(
CRgn* pRgn
);
CGdiObject* SelectObject(
CGdiObject* pObject
);
Parameter
pPen
Ein Zeiger auf einen ausgewählt werden CPen-Objekt.pBrush
Ein Zeiger auf einen ausgewählt werden CBrush-Objekt.pFont
Ein Zeiger auf einen ausgewählt werden CFont-Objekt.pBitmap
Ein Zeiger auf einen ausgewählt werden CBitmap-Objekt.pRgn
Ein Zeiger auf einen ausgewählt werden CRgn-Objekt.pObject
Ein Zeiger auf einen ausgewählt werden CGdiObject-Objekt.
Rückgabewert
Ein Zeiger auf das Objekt, das ersetzt wird. Dies ist ein Zeiger auf ein Objekt aus einer der Klassen, die von CGdiObject, wie CPen abgeleitet werden, je nach Version der Funktion verwendet wird. Der Rückgabewert ist NULL, wenn ein Fehler auftritt. Diese Funktion gibt möglicherweise einen Zeiger auf einen temporären Objekt zurück. Dieses temporäre Objekt ist während der Verarbeitung von einer Windows-Meldung nur gültig. Weitere Informationen finden Sie unter CGdiObject::FromHandle.
Die Version der Memberfunktion, die einen Bereichsparameter akzeptiert, führt die gleiche Funktion wie die SelectClipRgn-Memberfunktion aus. Der Rückgabewert kann eine der folgenden sein:
Neuer Clippingbereich COMPLEXREGION hat überlappende Rahmen.
ERROR Gerätekontext oder -Bereich ist ungültig.
Neuer Clippingbereich NULLREGION ist leer.
Neuer Clippingbereich SIMPLEREGION hat keine überlappenden Rahmen.
Hinweise
- Klasse CDC stellt fünf Versionen bereit, die für bestimmte Arten von GDI-Objekten, einschließlich Stifte, Pinsel, Schriftarten, Bitmaps und Bereiche spezialisiert werden. Das neu ausgewählte Objekt ersetzt das vorherige Objekt desselben Typs. Wenn pObject der allgemeinen Version von SelectObject zu einem CPen-Objekt verweist, ersetzt die Funktion den aktuellen Stift durch den Stift, der von pObject angegeben wird.
Eine Anwendung kann eine Bitmap in nur Speichergerätekontexte und in nur einen Speichergerätekontext gleichzeitig auswählen. Das Format der Bitmap muss entweder mit dem Gerätekontext monochrom oder kompatibel sein; wenn nicht ist, gibt SelectObject einen Fehler zurück.
Für Windows 3.1 und höher, gibt die Funktion SelectObject den gleichen Wert zurück, ob in einer Metadatei oder verwendet wird. In früheren Versionen von Windows, wurden SelectObject einen Wert ungleich 0 für Erfolg und 0 für Fehler zurück, als in einer Metadatei verwendet wurde.
Anforderungen
Header: afxwin.h