CDC::SelectObject 

CPen * SelectObject ( CPen * pp );

CBrush * SelectObject ( CBrush * pBrush );

virtuel CFont * SelectObject ( CFont * pFont );

CBitmap * SelectObject ( CBitmap * pBitmap );

int SelectObject ( CRgn * pRgn );

Valeur de retour

Pointeur vers l'objet remplacé. Il s'agit d'un pointeur vers un objet de l'une des classes dérivées de CGdiObject, comme le CPen, selon la version de la fonction est utilisée. La valeur de retour est NULL s'il y a une erreur. Cette fonction peut retourner un pointeur vers un objet temporaire. Cet objet temporaire n'est valable que pendant le traitement d'un message Windows. Pour plus d'informations, voir CGdiObject::FromHandle.

La version de la fonction membre qui prend un paramètre région effectue la même tâche que la fonction de membre SelectClipRgn . Sa valeur de retour peut être un des produits suivants:

• COMPLEXREGIO&Nnbsp ;  Nouvelle zone de découpage a se chevauchent les frontières.
  
  
• Erreur  ;  Contexte de périphérique ou de la région n'est pas valide.
  
  
• &NULLREGIONnbsp ;  Nouvelle zone de découpage est vide.
  
  
• SIMPLEREGIO&Nnbsp ;  Nouvelle région de détourage n'a pas de frontières qui se chevauchent.

Paramètres

pp

Un pointeur vers un objet CPen à être sélectionné.

pBrush

Un pointeur vers un objet CBrush à être sélectionné.

pFont

Un pointeur vers un objet CFont à être sélectionné.

pBitmap

Un pointeur vers un objet CBitmap d'être choisis.

pRgn

Un pointeur vers un objet CRgn à être sélectionné.

Remarques

Sélectionne un objet dans le contexte de périphérique. Classe CDC fournit cinq versions spécialisées pour certains types d'objets GDI, y compris les stylets, brosses, polices, images bitmap et régions. L'objet sélectionné remplace l'objet précédent du même type. Par exemple, si pObjet de la version générale de SelectObject pointe vers un objet CPen , la fonction remplace le stylet actuel avec le stylet spécifié par pObjet.

Une application peut sélectionner une image bitmap dans les contextes de périphérique de mémoire seulement et dans un contexte de périphérique de mémoire qu'un seul à la fois. Le format de l'image bitmap doit être monochrome ou compatible avec le contexte de périphérique ; Si il n'est pas le cas, SelectObject renvoie une erreur.

Pour Windows 3.1 et plus tard, la fonction SelectObject retourne la même valeur si elle est utilisée dans un métafichier ou pas. Sous les versions précédentes de Windows, SelectObject retourne une valeur différente de zéro pour le succès et 0 pour échec lorsqu'il a été utilisé dans un métafichier.

Aperçu de la CDC |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CGdiObject::DeleteObject, CGdiObject::FromHandle, CDC::SelectClipRgn, CDC::SelectPalette, :: SelectObject