다음을 통해 공유

DTTOPTS 구조체(uxtheme.h)

  • 아티클

DrawThemeTextEx 함수에 대한 옵션을 정의합니다.

구문

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;

멤버

dwSize

형식: DWORD

구조체의 크기입니다.

dwFlags

형식: DWORD

DTTOPTS 구조체의 특정 값이 지정되었는지 여부와 이러한 값을 해석하는 방법을 지정하는 플래그의 조합입니다. 이 멤버는 다음의 조합일 수 있습니다.

값 의미
DTT_TEXTCOLOR
 crText 멤버 값이 유효합니다.
DTT_BORDERCOLOR
 crBorder 멤버 값이 유효합니다.
DTT_SHADOWCOLOR
 crShadow 멤버 값이 유효합니다.
DTT_SHADOWTYPE
 iTextShadowType 멤버 값이 유효합니다.
DTT_SHADOWOFFSET
 ptShadowOffset 멤버 값이 유효합니다.
DTT_BORDERSIZE
 iBorderSize 멤버 값이 유효합니다.
DTT_FONTPROP
 iFontPropId 멤버 값이 유효합니다.
DTT_COLORPROP
 iColorPropId 멤버 값이 유효합니다.
DTT_STATEID
 iStateId 멤버 값이 유효합니다.
DTT_CALCRECT
 이 구조를 사용하는 DrawThemeTextEx 함수의 pRect 매개 변수는 in 및 out 매개 변수 모두로 사용됩니다. 함수가 반환된 후 pRect 매개 변수는 그릴 계산된 영역에 해당하는 사각형을 포함합니다.
DTT_APPLYOVERLAY
 fApplyOverlay 멤버 값이 유효합니다.
DTT_GLOWSIZE
 iGlowSize 멤버 값이 유효합니다.
DTT_CALLBACK
 pfnDrawTextCallback 멤버 값이 유효합니다.
DTT_COMPOSITED
 앤티앨리어스 알파를 사용하여 텍스트를 그립니다. 이 플래그를 사용하려면 하향식 DIB 섹션이 필요합니다. 이 플래그는 DrawThemeTextEx 함수에 전달된 HDC에 현재 선택된 하향식 DIB 섹션이 있는 경우에만 작동합니다. 자세한 내용은 디바이스 독립적 비트맵을 참조하세요.
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

형식: COLORREF

그릴 텍스트의 색을 지정합니다.

crBorder

형식: COLORREF

텍스트 주위에 그릴 윤곽선의 색을 지정합니다.

crShadow

형식: COLORREF

텍스트 뒤에 그릴 그림자의 색을 지정합니다.

iTextShadowType

형식: int

텍스트 뒤에 그릴 그림자의 유형을 지정합니다. 이 멤버는 다음 값 중 하나를 가질 수 있습니다.

값 의미
TST_NONE
 그림자는 그려지지 않습니다.
TST_SINGLE
 그림자는 텍스트 아래에 자세히 표시되도록 그려집니다.
TST_CONTINUOUS
 그림자가 그려져 텍스트 아래에 흐리게 표시됩니다.

ptShadowOffset

형식: POINT

그림자와 텍스트 사이의 오프셋 양(논리적 좌표)을 지정합니다.

iBorderSize

형식: int

텍스트 주위에 그릴 윤곽선의 반경을 지정합니다.

iFontPropId

형식: int

텍스트를 그릴 때 사용할 대체 글꼴 속성을 지정합니다. 가능한 값 목록은 GetThemeSysFont를 참조하세요.

iColorPropId

형식: int

텍스트를 그릴 때 사용할 대체 색 속성을 지정합니다. 이 값이 유효하고 해당 플래그가 dwFlags로 설정된 경우 이 값은 crText 값을 재정의합니다. nIndex 매개 변수는 GetSysColor에 나열된 값을 참조하세요.

iStateId

형식: int

사용할 대체 상태를 지정합니다. 이 멤버는 DrawThemeTextEx에서 사용되지 않습니다.

fApplyOverlay

형식: BOOL

TRUE이면 그림자 및 윤곽선 효과 위에 텍스트가 그려집니다. FALSE이면 그림자 및 윤곽선 효과만 그려집니다.

iGlowSize

형식: int

텍스트를 그리기 전에 배경에 그릴 네온의 크기를 지정합니다.

pfnDrawTextCallback

형식: DTT_CALLBACK_PROC

DrawThemeTextEx의 콜백 함수에 대한 포인터입니다.

lParam

형식: LPARAM

pfnDrawTextCallback에서 지정한 콜백 함수에 대한 매개 변수입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 uxtheme.h