Estrutura DTTOPTS (uxtheme.h)

  • Artigo

Define as opções para a função DrawThemeTextEx .

Sintaxe

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;

Membros

dwSize

Tipo: DWORD

Tamanho da estrutura.

dwFlags

Tipo: DWORD

Uma combinação de sinalizadores que especificam se determinados valores da estrutura DTTOPTS foram especificados e como interpretar esses valores. Esse membro pode ser uma combinação do seguinte.

Valor Significado
DTT_TEXTCOLOR
 O valor do membro crText é válido.
DTT_BORDERCOLOR
 O valor do membro crBorder é válido.
DTT_SHADOWCOLOR
 O valor do membro crShadow é válido.
DTT_SHADOWTYPE
 O valor do membro iTextShadowType é válido.
DTT_SHADOWOFFSET
 O valor do membro ptShadowOffset é válido.
DTT_BORDERSIZE
 O valor do membro iBorderSize é válido.
DTT_FONTPROP
 O valor do membro iFontPropId é válido.
DTT_COLORPROP
 O valor do membro iColorPropId é válido.
DTT_STATEID
 O valor do membro iStateId é válido.
DTT_CALCRECT
 O parâmetro pRect da função DrawThemeTextEx que usa essa estrutura será usado como um parâmetro de entrada e saída. Depois que a função retornar, o parâmetro pRect conterá o retângulo que corresponde à região calculada a ser desenhada.
DTT_APPLYOVERLAY
 O valor do membro fApplyOverlay é válido.
DTT_GLOWSIZE
 O valor do membro iGlowSize é válido.
DTT_CALLBACK
 O valor do membro pfnDrawTextCallback é válido.
DTT_COMPOSITED
 Desenha texto com alfa suavizado. O uso desse sinalizador requer uma seção DIB de cima para baixo. Esse sinalizador só funcionará se o HDC passar para a função DrawThemeTextEx tiver uma seção DIB de cima para baixo selecionada no momento. Para obter mais informações, consulte Bitmaps independentes do 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 a cor do texto que será desenhado.

crBorder

Tipo: COLORREF

Especifica a cor da estrutura de tópicos que será desenhada ao redor do texto.

crShadow

Tipo: COLORREF

Especifica a cor da sombra que será desenhada por trás do texto.

iTextShadowType

Tipo: int

Especifica o tipo da sombra que será desenhada por trás do texto. Esse membro pode ter um dos valores a seguir.

Valor Significado
TST_NONE
 Nenhuma sombra será desenhada.
TST_SINGLE
 A sombra será desenhada para aparecer detalhada abaixo do texto.
TST_CONTINUOUS
 A sombra será desenhada para parecer desfocada abaixo do texto.

ptShadowOffset

Tipo: POINT

Especifica a quantidade de deslocamento, em coordenadas lógicas, entre a sombra e o texto.

iBorderSize

Tipo: int

Especifica o raio da estrutura de tópicos que será desenhada ao redor do texto.

iFontPropId

Tipo: int

Especifica uma propriedade de fonte alternativa a ser usada ao desenhar texto. Para obter uma lista de valores possíveis, consulte GetThemeSysFont.

iColorPropId

Tipo: int

Especifica uma propriedade de cor alternativa a ser usada ao desenhar texto. Se esse valor for válido e o sinalizador correspondente for definido em dwFlags, esse valor substituirá o valor de crText. Consulte os valores listados em GetSysColor para o parâmetro nIndex .

iStateId

Tipo: int

Especifica um estado alternativo a ser usado. Esse membro não é usado por DrawThemeTextEx.

fApplyOverlay

Tipo: BOOL

Se TRUE, o texto será desenhado sobre os efeitos de sombra e estrutura de tópicos. Se FALSE, apenas os efeitos de sombra e estrutura de tópicos serão desenhados.

iGlowSize

Tipo: int

Especifica o tamanho de um brilho que será desenhado na tela de fundo antes de qualquer texto ser desenhado.

pfnDrawTextCallback

Tipo: DTT_CALLBACK_PROC

Ponteiro para a função de retorno de chamada para DrawThemeTextEx.

lParam

Tipo: LPARAM

Parâmetro para função de retorno de chamada especificada por pfnDrawTextCallback.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho uxtheme.h