CDC::SelectObject

Artykuł
02/27/2013

Zaznacza obiekt do kontekstu urządzenia.

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
Wskaźnik do CPen obiektów, które mają być wybrane.
pBrush
Wskaźnik do CBrush obiektów, które mają być wybrane.
pFont
Wskaźnik do CFont obiektów, które mają być wybrane.
pBitmap
Wskaźnik do CBitmap obiektów, które mają być wybrane.
pRgn
Wskaźnik do CRgn obiektów, które mają być wybrane.
pObject
Wskaźnik do CGdiObject obiektów, które mają być wybrane.

Wartość zwracana

Wskaźnik do obiektu jest zastąpiony.To jest wskaźnik do obiektu z jednej z klas pochodnych CGdiObject, takich jak CPen, w zależności od wersji funkcji jest używany.Zwracana jest wartość NULL , jeśli wystąpi błąd.Ta funkcja może zwrócić wskaźnik tymczasowy obiekt.Ten tymczasowy obiekt jest prawidłowa tylko podczas przetwarzania jednego komunikatu systemu Windows.Aby uzyskać więcej informacji, zobacz CGdiObject::FromHandle.

Wersja funkcji Członkowskich przyjmuje parametr regionu wykonuje to samo zadanie SelectClipRgn funkcji składowej.Swojej zwracanej wartości może być dowolną z następujących czynności:

COMPLEXREGION nowy region odcinania ma nakładających się obramowanie.
Błąd kontekstu urządzenia lub region jest nieprawidłowy.
NULLREGION nowy region przycinania jest pusty.
SIMPLEREGION nowy region przycinania nie ma nakładających się obramowania.

Uwagi

Klasa CDC zawiera pięć wersji specjalistyczne dla szczególnych rodzajów obiektów GDI, łącznie z piór, pędzle, czcionki, bitmapy i regionów.Nowo wybrany obiekt zastępuje poprzedni obiekt tego samego typu.Na przykład jeśli pObject wersji ogólne SelectObject wskazuje na CPen obiektu, funkcja zamienia bieżącego pióra Pióro określonej przez pObject.

Aplikacji można wybrać mapę bitową do kontekstów urządzeń pamięci i do kontekstu urządzenia pamięci tylko jeden naraz.Format mapy bitowej musi być czarno-białe lub zgodny z kontekstu urządzenia; Jeśli nie jest SelectObject zwraca błąd.

Dla systemu Windows 3.1 i nowszych SelectObject czy też nie jest używany w metapliku, funkcja zwraca taką samą wartość.W poprzednich wersjach systemu Windows SelectObject zwracana wartość różną od zera w przypadku sukcesu i 0 w przypadku awarii, gdy został użyty w metapliku.