CDC::SelectObject
Sélectionne un objet dans le contexte de périphérique.
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
);
Paramètres
pPen
Un pointeur vers un objet de CPen à sélectionner.pBrush
Un pointeur vers un objet de CBrush à sélectionner.pFont
Un pointeur vers un objet de CFont à sélectionner.pBitmap
Un pointeur vers un objet de CBitmap à sélectionner.pRgn
Un pointeur vers un objet de CRgn à sélectionner.pObject
Un pointeur vers un objet de CGdiObject à sélectionner.
Valeur de retour
Pointeur vers l'objet qui est remplacé.C'est un pointeur vers un objet d'une des classes dérivées d' CGdiObject, tel qu' CPen, en fonction de la version de la fonction est utilisée.La valeur de retour est NULL si une erreur.Cette fonction peut retourner un pointeur vers un objet temporaire.Cet objet temporaire est uniquement valide pendant le traitement d'une boîte de message windows.Pour plus d'informations, consultez CGdiObject::FromHandle.
La version de la fonction membre qui prend un paramètre de zone effectue la même tâche que la fonction membre d' SelectClipRgn .Sa valeur de retour peut être l'un des éléments suivants :
La zone de découpage deCOMPLEXREGION a superposer des zones.
Le contexte ou la zone du périphérique deerreur est pas valide.
La zone de découpage deNULLREGION est vide.
La zone de découpage deSIMPLEREGION n'a aucun superposés zone.
Notes
La classe CDC fournit cinq versions spécialisées pour les types particuliers d'objets GDI, y compris des stylets, les pinceaux, les polices, des images, des zones.L'objet sélectionné récemment remplace l'objet précédent du même type.Par exemple, si pObject de la version générale des points d' SelectObject à un objet de CPen , la fonction remplace le stylet actuel par le stylet spécifié par pObject.
Une application peut sélectionner une image bitmap dans des contextes de périphérique mémoire uniquement et dans un seul contexte de périphérique à la fois.Le format de la bitmap doit être monochrome ou compatible avec le contexte de périphérique ; s'il n'est pas, SelectObject retourne une erreur.
Pour Windows 3.1 et versions ultérieures, la fonction d' SelectObject retourne la même valeur, qu'elle soit utilisée dans un métafichier ou pas.Dans les versions antérieures de windows, SelectObject est retourné une valeur différente de zéro de succès et 0 de l'échec lorsqu'il a été utilisé dans un métafichier.
Configuration requise
Header: afxwin.h