CDC::SelectObject

Článek
03/04/2013

Vybere objekt do kontextu zařízení.

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

Parametry

pPen
Ukazatel CPen vybraného objektu.
pBrush
Ukazatel CBrush vybraného objektu.
pFont
Ukazatel CFont vybraného objektu.
pBitmap
Ukazatel CBitmap vybraného objektu.
pRgn
Ukazatel CRgn vybraného objektu.
pObject
Ukazatel CGdiObject vybraného objektu.

Vrácená hodnota

Ukazatel na objekt nahrazovaného.Toto je ukazatel na objekt jedné třídy odvozené z CGdiObject , jako například CPen v závislosti na verzi funkce se používá.Vrácená hodnota je NULL Pokud dojde k chybě.Tato funkce může vrátit ukazatel dočasný objekt.Tento dočasný objekt je platná pouze během zpracování jedné zprávy systému Windows.Další informace naleznete v tématu CGdiObject::FromHandle.

Verze členské funkce, která přebírá parametr regionu provádí stejné úkoly, jako SelectClipRgn členské funkce.Hodnoty mohou být následující:

COMPLEXREGION novou oblast oříznutí má překrývající se okraje.
Chyba kontext zařízení nebo oblasti není platný.
NULLREGION novou oblast oříznutí je prázdný.
SIMPLEREGION novou oblast oříznutí nemá překrývající se okraje.

Poznámky

Třída CDC obsahuje pět verzí specializované pro určité druhy objekty GDI, včetně per, stopy, písma, bitmapy a regionech.Nově vybraný objekt nahradí předchozí objekt stejného typu.Například pokud pObject obecné verze SelectObject odkazuje CPen objektu funkci nahradí aktuální pera pera určené pObject .

Aplikaci můžete vybrat rastrový obrázek do paměti zařízení kontexty pouze a do paměti pouze jeden kontext zařízení současně.Formát rastrového obrázku musí být monochromatický nebo kompatibilní s kontext zařízení; Pokud ne, SelectObject vrátí chybu.

Pro systém Windows 3.1 a později SelectObject funkce vrací stejnou hodnotu, zda je používána v metasouboru či nikoli.V předchozích verzích systému Windows SelectObject vrátil nenulovou hodnotu pro úspěch a 0 selhání při byla použita v metasouboru.