CDC::SelectObject 

CPen * SelectObject ( CPen * pPen );

CBrush * SelectObject ( CBrush * pBrush );

virtual CFont * SelectObject ( CFont * pFont );

CBitmap * SelectObject ( CBitmap * pBitmap );

int SelectObject ( CRgn * pRgn );

Valor devuelto

Un puntero al objeto de ser reemplazado. Esto es un puntero a un objeto de una de las clases derivadas de CGdiObject, como CPen, dependiendo de la versión de la función se utiliza. El valor devuelto es NULL si se produce un error. Esta función puede devolver un puntero a un objeto temporal. Este objeto temporal sólo es válida durante el procesamiento de un mensaje de Windows. Para obtener más información, consulte CGdiObject::FromHandle.

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

Parámetros

pPen

Un puntero a un objeto CPen para ser seleccionado.

pBrush

Un puntero a un objeto CBrush para ser seleccionado.

pFont

Un puntero a un objeto CFont para ser seleccionado.

pBitmap

Un puntero a un objeto CBitmap para ser seleccionado.

pRgn

Un puntero a un objeto CRgn para ser seleccionado.

Observaciones

Selecciona un objeto en el contexto de dispositivo. Clase CDC proporciona cinco versiones especialización para tipos particulares de objetos GDI, incluyendo lápices, pinceles, fuentes, mapas de bits y las regiones. El objeto recién seleccionado sustituye el objeto anterior del mismo tipo. Por ejemplo, si pObject de la versión general de SelectObject apunta a un objeto CPen , la función reemplaza la pluma 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 en contexto de dispositivo de memoria sólo uno a la vez. El formato de mapa de bits debe ser monocromo o compatible con el contexto de dispositivo; Si no es así, SelectObject devuelve un error.

Para Windows 3.1 y más tarde, la función SelectObject devuelve el mismo valor si se utiliza en un metarchivo o no. En versiones anteriores de Windows, SelectObject regresó un valor distinto de cero para el éxito y 0 para fracaso cuando fue usado en un metarchivo.

Visió&n General de CDC |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CGdiObject::DeleteObject, CGdiObject::FromHandle, CDC::SelectClipRgn, CDC::SelectPalette, :: SelectObject

Index