Sdílet prostřednictvím


CDC::SelectObject

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.

Požadavky

Záhlaví: afxwin.h

Viz také

Referenční dokumentace

Třída Nemocnosti

Graf hierarchie

CGdiObject::DeleteObject

CGdiObject::FromHandle

CDC::SelectClipRgn

CDC::SelectPalette

SelectObject