CDC::DrawState

Artículo
06/10/2015

Llame a esta función miembro para mostrar una imagen y aplicar un efecto visual para indicar un estado, como un estado deshabilitado o predeterminada.

Nota

Para todos los estados de nFlag excepto DSS_NORMAL, la imagen se convierte en monocromático antes de que se aplique el efecto visual.

BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   HBITMAP hBitmap, 
   UINT nFlags, 
   HBRUSH hBrush = NULL  
); 
BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   CBitmap* pBitmap, 
   UINT nFlags, 
   CBrush* pBrush = NULL  
); 
BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   HICON hIcon, 
   UINT nFlags, 
   HBRUSH hBrush = NULL  
); 
BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   HICON hIcon, 
   UINT nFlags, 
   CBrush* pBrush = NULL  
); 
BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   LPCTSTR lpszText, 
   UINT nFlags, 
   BOOL bPrefixText = TRUE, 
   int nTextLen = 0, 
   HBRUSH hBrush = NULL  
); 
BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   LPCTSTR lpszText, 
   UINT nFlags, 
   BOOL bPrefixText = TRUE, 
   int nTextLen = 0, 
   CBrush* pBrush = NULL  
); 
BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   DRAWSTATEPROC lpDrawProc, 
   LPARAM lData, 
   UINT nFlags, 
   HBRUSH hBrush = NULL  
); 
BOOL DrawState( 
   CPoint pt, 
   CSize size, 
   DRAWSTATEPROC lpDrawProc, 
   LPARAM lData, 
   UINT nFlags, 
   CBrush* pBrush = NULL  
);

Parámetros

pt
especifica la ubicación de la imagen.
size
Especifica el tamaño de la imagen.
hBitmap
un identificador a un mapa de bits.
nFlags
Marca que especifica el tipo de imagen y estado. Vea DrawState en Windows SDK para los tipos y los posibles estados de nFlags .
hBrush
Un identificador a un pincel.
pBitmap
un puntero a un objeto de CBitmap.
pBrush
un puntero a un objeto de CBrush.
hIcon
Identificador de un icono.
lpszText
Un puntero al texto.
bPrefixText
Texto que puede contener un mnemónico de aceleradores. El parámetro de lData especifica la dirección de la cadena, y el parámetro de nTextLen especifica la longitud. Si nTextLen es 0, la cadena se asume que terminada en null.
nTextLen
La longitud de la cadena de texto al que lpszText. Si nTextLen es 0, la cadena se asume que terminada en null.
lpDrawProc
Un puntero a una función de devolución de llamada utilizada para representar una imagen. se requiere este parámetro si el tipo de imagen en nFlags es DST_COMPLEX. es opcional y puede ser NULL si el tipo de imagen es DST_TEXT. para el resto de los tipos de imagen, se omite este parámetro. Para obtener más información sobre la función de devolución de llamada, vea la función de DrawStateProc en Windows SDK.
lData
especifica la información sobre la imagen. El significado de este parámetro depende del tipo de imagen.