winuser.h

Función DrawFrameControl

La función DrawFrameControl dibuja un control de marco del tipo y estilo especificado.

BOOL DrawFrameControl(
       HDC   hdc ,
       LPRECT re,
       UINT  uType ,
       UINT   uState 
);

Parámetros

hdc: Un manipulador del contexto de dispositivo de la ventana en la que dibujar el control.

re: Un puntero a una estructura RECT que contiene las coordenadas lógicas del rectángulo delimitador del control marco.

uType : El tipo de control de marco a dibujar. Este parámetro puede ser uno de los siguientes valores:

ValorSignificado
DFC_BUTTONBotón estándar
DFC_CAPTIONBarra de título.
DFC_MENUBarra de menú.
DFC_POPUPMENUÍtem de menú popup.
DFC_SCROLLBarra de scroll.

uState : El estado inicial del control marco. Si uType es DFC_BUTTON, uState puede ser uno de los siguientes valores:

ValorSignificado
DFCS_BUTTON3STATEBotón de tres estados.
DFCS_BUTTONCHECKCheck box.
DFCS_BUTTONPUSHPush button.
DFCS_BUTTONRADIORadio button.
DFCS_BUTTONRADIOIMAGEImagen para un radio button.
DFCS_BUTTONRADIOMASKMáscara para radio button.

Si uType es DFC_CAPTION, uState puede ser uno de los siguientes valores:

ValorSignificado
DFCS_CAPTIONCLOSEBotón de cerrar.
DFCS_CAPTIONHELPBotón de ayuda.
DFCS_CAPTIONMAXBotón de maximizar.
DFCS_CAPTIONMINBotón de minimizar.
DFCS_CAPTIONRESTOREBotón de restaurar.

Si uType es DFC_MENU, uState puede ser uno de los siguientes valores:

ValorSignificado
DFCS_MENUARROWFlecha de submenú.
DFCS_MENUARROWRIGHTFecha de submenú apuntando a la izquierda. Es usada para menús en cascada en lenguajes que se escriben de derecha a izquierda como árabe o hebreo.
DFCS_MENUBULLETBullet.
DFCS_MENUCHECKMarcha de check.

Si uType es DFC_SCROLL, uState puede ser uno de los siguientes valores:

ValorSignificado
DFCS_SCROLLCOMBOBOXBarra de desplazamiento de combo box.
DFCS_SCROLLDOWNFlecha hacia abajo de barra de scroll.
DFCS_SCROLLLEFTFlecha a la izquierda de barra de scroll.
DFCS_SCROLLRIGHTFlecha a la derecha de barra de scroll.
DFCS_SCROLLSIZEGRIPAsa de cambio de tamaño en la esquina inferior derecha de la ventana.
DFCS_SCROLLSIZEGRIPRIGHTAsa de cambio de tamaño en la esquina inferior izquierda de la ventana. Se usa con lenguajes que se escriben de derecha a izquierda, como el árabe o el hebreo.
DFCS_SCROLLUPFlecha arriba de barra de scroll.

Los siguientes estilos pueden ser usados para ajustar el rectángulo delimitador del push button:

ValorSignificado
DFCS_ADJUSTRECTEl rectángulo delimitador es ajustado para excluir el borde exterior del push button.

Uno o más de los siguientes valores pueden ser usados para asignar el estado del control a dibujar:

ValorSignificado
DFCS_CHECKEDEl botón está marcado.
DFCS_FLATEl botón tiene un borde plano.
DFCS_HOTEl botón es hot-tracked.
DFCS_INACTIVEEl botón está inactivo (grayed).
DFCS_MONOEl botón tiene un borde monocromo.
DFCS_PUSHEDEl botón está pulsado.
DFCS_TRANSPARENTEl fondo permanece sin tocar. Esta bandera solo puede ser combinada con DFCS_MENUARROWUP o DFCS_MENUARROWDOWN.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

value is nonzero.

Si la función falla, el valor de retorno es cero.

Observaciones

Si uType es DFC_MENU o DFC_BUTTON y uState no es DFCS_BUTTONPUSH, el control marco es una máscara blanco sobre negro (es decir, un control marco negro sobre un fondo blanco). En esos casos, la aplicación debe pasar un manipulador a un control de dispositivo de mapa de bits en memoria. la aplicación puede usar el mapa de bits asociado como parámetro hbmMask a la función MaskBlt, o puede usar el contexto de dispositivo como un parámetros para la función BitBlt usandp ROPs como SRCAND y SRCINVERT.

Virtualización DPI

Esta API no participa en la virtualización DPI. La entrada dada está siempre en términos de pixels físicos, y no está relacionada con el contexto que llama.