Compartir a través de


Estructura DTTOPTS (uxtheme.h)

Define las opciones de la función DrawThemeTextEx .

Sintaxis

typedef struct _DTTOPTS {
  DWORD             dwSize;
  DWORD             dwFlags;
  COLORREF          crText;
  COLORREF          crBorder;
  COLORREF          crShadow;
  int               iTextShadowType;
  POINT             ptShadowOffset;
  int               iBorderSize;
  int               iFontPropId;
  int               iColorPropId;
  int               iStateId;
  BOOL              fApplyOverlay;
  int               iGlowSize;
  DTT_CALLBACK_PROC pfnDrawTextCallback;
  LPARAM            lParam;
} DTTOPTS, *PDTTOPTS;

Miembros

dwSize

Tipo: DWORD

Tamaño de la estructura.

dwFlags

Tipo: DWORD

Combinación de marcas que especifican si se han especificado determinados valores de la estructura DTTOPTS y cómo interpretar estos valores. Este miembro puede ser una combinación de lo siguiente.

Valor Significado
DTT_TEXTCOLOR
El valor del miembro crText es válido.
DTT_BORDERCOLOR
El valor del miembro crBorder es válido.
DTT_SHADOWCOLOR
El valor del miembro crShadow es válido.
DTT_SHADOWTYPE
El valor del miembro iTextShadowType es válido.
DTT_SHADOWOFFSET
El valor del miembro ptShadowOffset es válido.
DTT_BORDERSIZE
El valor del miembro iBorderSize es válido.
DTT_FONTPROP
El valor del miembro iFontPropId es válido.
DTT_COLORPROP
El valor del miembro iColorPropId es válido.
DTT_STATEID
El valor del miembro iStateId es válido.
DTT_CALCRECT
El parámetro pRect de la función DrawThemeTextEx que usa esta estructura se usará como parámetro in y out. Una vez que se devuelve la función, el parámetro pRect contendrá el rectángulo que corresponde a la región calculada que se va a dibujar.
DTT_APPLYOVERLAY
El valor del miembro fApplyOverlay es válido.
DTT_GLOWSIZE
El valor del miembro iGlowSize es válido.
DTT_CALLBACK
El valor del miembro pfnDrawTextCallback es válido.
DTT_COMPOSITED
Dibuja texto con alfa suavizado. El uso de esta marca requiere una sección de DIB de arriba abajo. Esta marca solo funciona si el HDC pasado a la función DrawThemeTextEx tiene una sección diB de arriba abajo seleccionada actualmente en ella. Para obtener más información, consulte Mapas de bits independientes del dispositivo.
DTT_VALIDBITS
DTT_TEXTCOLOR | DTT_BORDERCOLOR | DTT_SHADOWCOLOR | DTT_SHADOWTYPE | DTT_SHADOWOFFSET | DTT_BORDERSIZE | DTT_FONTPROP | DTT_COLORPROP | DTT_STATEID | DTT_CALCRECT | DTT_APPLYOVERLAY | DTT_GLOWSIZE | DTT_COMPOSITED.

crText

Tipo: COLORREF

Especifica el color del texto que se dibujará.

crBorder

Tipo: COLORREF

Especifica el color del contorno que se dibujará alrededor del texto.

crShadow

Tipo: COLORREF

Especifica el color de la sombra que se dibujará detrás del texto.

iTextShadowType

Tipo: int

Especifica el tipo de la sombra que se dibujará detrás del texto. Este miembro puede tener uno de los valores siguientes.

Valor Significado
TST_NONE
No se dibujará ninguna sombra.
TST_SINGLE
La sombra se dibujará para que aparezca detallada debajo del texto.
TST_CONTINUOUS
La sombra se dibujará para que aparezca borrosa debajo del texto.

ptShadowOffset

Tipo: POINT

Especifica la cantidad de desplazamiento, en coordenadas lógicas, entre la sombra y el texto.

iBorderSize

Tipo: int

Especifica el radio del contorno que se dibujará alrededor del texto.

iFontPropId

Tipo: int

Especifica una propiedad de fuente alternativa que se usará al dibujar texto. Para obtener una lista de los valores posibles, consulte GetThemeSysFont.

iColorPropId

Tipo: int

Especifica una propiedad de color alternativa que se usará al dibujar texto. Si este valor es válido y la marca correspondiente se establece en dwFlags, este valor invalidará el valor de crText. Consulte los valores enumerados en GetSysColor para el parámetro nIndex .

iStateId

Tipo: int

Especifica un estado alternativo que se va a usar. DrawThemeTextEx no usa este miembro.

fApplyOverlay

Tipo: BOOL

Si es TRUE, el texto se dibujará sobre los efectos de sombra y contorno. Si es FALSE, solo se dibujarán los efectos de sombra y contorno.

iGlowSize

Tipo: int

Especifica el tamaño de un iluminado que se dibujará en el fondo antes de dibujar cualquier texto.

pfnDrawTextCallback

Tipo: DTT_CALLBACK_PROC

Puntero a la función de devolución de llamada para DrawThemeTextEx.

lParam

Tipo: LPARAM

Parámetro para la función de devolución de llamada especificada por pfnDrawTextCallback.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado uxtheme.h