CDC::SelectObject

Makale
02/26/2013

Bir nesnenin aygıt içeriğini seçer.

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

Parametreler

pPen
Bir işaretçi bir CPen Seçilecek nesne.
pBrush
Bir işaretçi bir CBrush Seçilecek nesne.
pFont
Bir işaretçi bir CFont Seçilecek nesne.
pBitmap
Bir işaretçi bir CBitmap Seçilecek nesne.
pRgn
Bir işaretçi bir CRgn Seçilecek nesne.
pObject
Bir işaretçi bir CGdiObject Seçilecek nesne.

Dönüş Değeri

Değiştirilen nesne için bir işaretçi. Bu türetilen sınıflardan biri, bir nesneye bir işaretçi, CGdiObject, aþaðýdaki gibi CPen, işlevin hangi sürümünün kullanıldığını bağlı olarak. Dönüş değeri null bir hata olduğunda. Bu işlev, geçici bir nesne işaretçisi döndürebilir. Bu geçici nesnesi, yalnızca tek bir Windows ileti işleme sırasında geçerlidir. Daha fazla bilgi için bkz. CGdiObject::FromHandle.

Bir bölge parametre üye işlev sürümü olarak aynı görevi yapar SelectClipRgn üye işlevi. Dönüş değeri aşağıdakilerden biri olabilir:

COMPLEXREGION yeni kırpma bölgesi olan kenarlıklar üst üste.
HATA aygıt içeriğini veya bölge geçerli değil.
NULLREGION yeni kırpma bölgesini boştur.
SIMPLEREGION yeni kırpma bölgesini örtüşen bir kenarlık vardır.

Notlar

Sınıf CDC beş sürümlerine GDI nesnelerini kalemler, Fırçalar, yazı tipleri, bit eşlemler ve bölgeleri de dahil olmak üzere, belirli türde özelleştirilmiş sağlar. Önceki nesne aynı türde yeni seçilen nesneyi değiştirir. Örneğin, pObject genel sürümünün SelectObject işaret eden bir CPen nesne işlevi tarafından belirtilen kalemiyle geçerli kalemin değiştirir pObject.

Bir uygulama bir bitmap bellek aygıtı bağlamlarına yalnızca ve yalnızca bir bellek aygıtı bağlam içine teker teker seçebilirsiniz. Bit eşlem biçimi ya da tek renkli ya da aygıt içeriği ile uyumlu olmalıdır; değilse SelectObject bir hata döndürür.

Windows 3.1 ve daha sonra SelectObject işlevi veya bir meta kullanılır olup olmadığını aynı değeri döndürür. Windows'un önceki sürümleri altında SelectObject meta dosyası kullanıldığında başarı için sıfır dışında bir değere ve başarısızlık için 0 döner.