FlatSB_SetScrollProp 함수(commctrl.h)

  • 아티클

플랫 스크롤 막대의 속성을 설정합니다.

구문

BOOL FlatSB_SetScrollProp(
  HWND    unnamedParam1,
  UINT    index,
  INT_PTR newValue,
  BOOL    unnamedParam4
);

매개 변수

unnamedParam1

형식: HWND

플랫 스크롤 막대가 포함된 창에 대한 핸들입니다. 이 창 핸들은 InitializeFlatSB 호출에서 이전에 전달되어야 합니다.

index

형식: UINT

newValue가 나타내는 항목과 설정되는 속성을 결정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
WSB_PROP_CXHSCROLL
 newValue 는 가로 스크롤 막대의 방향 단추 너비를 픽셀 단위로 나타내는 INT_PTR 값입니다.
WSB_PROP_CXHTHUMB
 newValue 는 가로 스크롤 막대에서 엄지 손가락의 너비를 픽셀 단위로 나타내는 INT_PTR 값입니다.
WSB_PROP_CXVSCROLL
 newValue 는 세로 스크롤 막대의 너비(픽셀)를 나타내는 INT_PTR 값입니다.
WSB_PROP_CYHSCROLL
 newValue 는 가로 스크롤 막대의 높이를 픽셀 단위로 나타내는 INT_PTR 값입니다.
WSB_PROP_CYVSCROLL
 newValue 는 세로 스크롤 막대의 방향 단추 높이를 픽셀 단위로 나타내는 INT_PTR 값입니다.
WSB_PROP_CYVTHUMB
 newValue 는 세로 스크롤 막대에서 엄지 손가락의 높이(픽셀)를 나타내는 INT_PTR 값입니다.
WSB_PROP_HBKGCOLOR
 newValue 는 가로 스크롤 막대의 배경색을 나타내는 COLORREF 값입니다.
WSB_PROP_HSTYLE
 newValue 는 가로 스크롤 막대의 시각적 효과를 변경하는 다음 값 중 하나입니다.
FSB_ENCARTA_MODE
표준 플랫 스크롤 막대가 표시됩니다. 마우스가 방향 단추이나 엄지 위로 이동하면 스크롤 막대의 해당 부분이 3D로 표시됩니다.
FSB_FLAT_MODE
표준 플랫 스크롤 막대가 표시됩니다. 방향 단추 또는 엄지를 마우스로 가리키면 스크롤 막대의 해당 부분이 반전된 색으로 표시됩니다.
FSB_REGULAR_MODE
일반 비플랫 스크롤 막대가 표시됩니다. 특별한 시각 효과는 적용되지 않습니다.
WSB_PROP_PALETTE
 newValue 는 그리기 시 스크롤 막대가 사용해야 하는 새 팔레트를 나타내는 HPALETTE 값입니다.
WSB_PROP_VBKGCOLOR
 newValue 는 세로 스크롤 막대의 배경색을 나타내는 COLORREF 값입니다.
WSB_PROP_VSTYLE
 newValue 는 세로 스크롤 막대의 시각적 효과를 변경하는 다음 값 중 하나입니다.
FSB_ENCARTA_MODE
표준 플랫 스크롤 막대가 표시됩니다. 마우스가 방향 단추이나 엄지 위로 이동하면 스크롤 막대의 해당 부분이 3D로 표시됩니다.
FSB_FLAT_MODE
표준 플랫 스크롤 막대가 표시됩니다. 방향 단추 또는 엄지를 마우스로 가리키면 스크롤 막대의 해당 부분이 반전된 색으로 표시됩니다.
FSB_REGULAR_MODE
일반 비플랫 스크롤 막대가 표시됩니다. 특별한 시각 효과는 적용되지 않습니다.

newValue

형식: INT_PTR

설정할 새 값입니다. 이 매개 변수는 인덱스에 전달된 플래그에 따라 달라집니다.

unnamedParam4

형식: BOOL

변경 내용을 반영하기 위해 스크롤 막대를 즉시 다시 그릴지 여부를 지정합니다. 이 매개 변수가 TRUE이면 스크롤 막대가 다시 그려집니다. FALSE이면 스크롤 막대가 다시 그려지지 않습니다.

반환 값

형식: BOOL

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.

설명

참고 플랫 스크롤 막대 함수는 Comctl32.dll 버전 4.71에서 5.82까지 구현됩니다. Comctl32.dll 버전 6.00 이상은 플랫 스크롤 막대를 지원하지 않습니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h
라이브러리 Comctl32.lib
DLL Comctl32.dll(버전 4.71 이상)