Compartir a través de


CDC::SelectObject

Seleccione un objeto en el contexto del dispositivo.

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

Parámetros

  • pPen
    Un puntero a un objeto de CPen que se seleccione.

  • pBrush
    Un puntero a un objeto de CBrush que se seleccione.

  • pFont
    Un puntero a un objeto de CFont que se seleccione.

  • pBitmap
    Un puntero a un objeto de CBitmap que se seleccione.

  • pRgn
    Un puntero a un objeto de CRgn que se seleccione.

  • pObject
    Un puntero a un objeto de CGdiObject que se seleccione.

Valor devuelto

Un puntero al objeto que se reemplaza.Esto es un puntero a un objeto de una de las clases derivadas de CGdiObject, como CPen, dependiendo de las que la versión de la función se utiliza.el valor devuelto es NULL si hay un error.esta función puede devolver un puntero a un objeto temporal.Este objeto temporal sólo es válido durante el procesamiento de un mensaje de Windows.Para obtener más información, vea CGdiObject::FromHandle.

La versión de la función miembro que toma un parámetro de región realiza la misma tarea que la función miembro de SelectClipRgn .El valor devuelto puede ser cualquiera de los siguientes:

  • La zona de recorte deCOMPLEXREGION Nuevo tiene superponer los bordes.

  • El contexto o la región del dispositivo deERROR no es válida.

  • La zona de recorte deNULLREGION New está vacía.

  • La zona de recorte deSIMPLEREGION Nuevo no tiene borde que se superpone.

Comentarios

La clase CDC proporciona cinco versiones especializadas para las clases concretas de objetos GDI, incluidos los lápices, los pinceles, fuentes, mapas de bits, y regiones.El objeto recientemente seleccionado reemplaza el objeto anterior del mismo tipo.por ejemplo, si pObject de la versión general de los puntos de SelectObject a un objeto de CPen , la función reemplaza el lápiz actual con el lápiz especificado por pObject.

Una aplicación puede seleccionar un mapa de bits en contextos de dispositivo de memoria sólo y únicamente en un contexto de dispositivo de memoria al mismo tiempo.El formato de mapa de bits debe ser monocromático o compatible con el contexto de dispositivo; si no, SelectObject devuelve un error.

Para Windows 3.1 y versiones posteriores, la función de SelectObject devuelve el mismo valor si se utiliza en un metarchivo o no.En versiones anteriores de Windows, SelectObject devolvió un valor distinto de cero para el éxito y 0 para el error cuando se utilizó en un metarchivo.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CGdiObject::DeleteObject

CGdiObject::FromHandle

CDC::SelectClipRgn

CDC::SelectPalette

SelectObject