다음을 통해 공유


슬라이더 컨트롤 멤버 함수

애플리케이션은 슬라이더 컨트롤의 멤버 함수를 호출하여 슬라이더 컨트롤(CSliderCtrl)에 대한 정보를 검색하고 특성을 변경할 수 있습니다.

슬라이더의 위치(즉, 사용자가 선택한 값)를 검색하려면 GetPos 멤버 함수를 사용합니다. 슬라이더의 위치를 설정하려면 SetPos 멤버 함수를 사용합니다. 언제든지 멤버 함수를 VerifyPos 사용하여 슬라이더가 최소값과 최대값 사이에 있는지 확인할 수 있습니다.

슬라이더 컨트롤의 범위는 슬라이더 컨트롤이 나타낼 수 있는 연속 값 집합입니다. 대부분의 애플리케이션은 SetRange 멤버 함수를 사용하여 처음 만들 때 슬라이더 컨트롤의 범위를 설정합니다. 애플리케이션은 SetRangeMaxSetRangeMin 멤버 함수를 사용하여 슬라이더 컨트롤을 만든 후 범위를 동적으로 변경할 수 있습니다. 범위를 동적으로 변경할 수 있는 애플리케이션은 일반적으로 사용자가 슬라이더 컨트롤 작업을 마쳤을 때 최종 범위 설정을 검색합니다. 이러한 설정을 검색하려면 GetRange, GetRangeMaxGetRangeMin 멤버 함수를 사용합니다.

애플리케이션은 TBS_AUTOTICKS 스타일을 사용하여 슬라이더 컨트롤의 눈금 표시를 자동으로 표시할 수 있습니다. 그러나 애플리케이션이 눈금 표시의 위치 또는 빈도를 제어해야 하는 경우 여러 멤버 함수를 사용할 수 있습니다.

눈금의 위치를 설정하기 위해 애플리케이션은 SetTic 멤버 함수를 사용할 수 있습니다. SetTicFreq 멤버 함수를 사용하면 애플리케이션이 슬라이더 컨트롤 범위에서 정기적으로 나타나는 눈금 표시를 설정할 수 있습니다. 예를 들어 애플리케이션은 이 멤버 함수를 사용하여 1에서 100까지의 범위에서 10개의 눈금 표시만 표시할 수 있습니다.

눈금에 해당하는 범위에서 인덱스 검색하려면 GetTic 멤버 함수를 사용합니다. GetTicArray 멤버 함수는 이러한 인덱스의 배열을 검색합니다. 눈금의 위치를 검색하려면 클라이언트 좌표에서 GetTicPos 멤버 함수를 사용합니다. 애플리케이션은 GetNumTics 멤버 함수를 사용하여 눈금 수를 검색할 수 있습니다 .

ClearTics 멤버 함수는 슬라이더 컨트롤의 눈금 표시를 모두 제거합니다.

슬라이더 컨트롤의 줄 크기는 애플리케이션이 TB_LINEDOWN 또는 TB_LINEUP 알림 메시지를 받을 때 슬라이더가 이동하는 정도를 결정합니다. 마찬가지로 페이지 크기는 TB_PAGEDOWN 및 TB_PAGEUP 알림 메시지에 대한 응답을 결정합니다. 애플리케이션은 GetLineSize, SetLineSize, GetPageSize 및 SetPageSize 멤버 함수를 사용하여 줄 및 페이지 크기 값을 검색하고 설정할 수 있습니다.

애플리케이션은 멤버 함수를 사용하여 슬라이더 컨트롤의 차원을 검색할 수 있습니다. GetThumbRect 멤버 함수는 슬라이더의 경계 사각형을 검색합니다. GetChannelRect 멤버 함수는 슬라이더 컨트롤의 채널에 대한 경계 사각형을 검색합니다. (채널은 슬라이더가 이동하는 영역이며 범위를 선택할 때 강조 표시가 포함됩니다.)

슬라이더 컨트롤에 TBS_ENABLESELRANGE 스타일이 있는 경우 사용자는 해당 컨트롤에서 연속 값의 범위를 선택할 수 있습니다. 여러 멤버 함수를 사용하면 선택 범위를 동적으로 조정할 수 있습니다. SetSelection 멤버 함수는 선택 영역의 시작 및 끝 위치를 설정합니다. 사용자가 선택 범위 설정을 완료하면 애플리케이션은 GetSelection 멤버 함수를 사용하여 설정을 검색할 수 있습니다. 사용자의 선택을 취소하려면 ClearSel 멤버 함수를 사용합니다.

참고 항목

CSliderCtrl 사용
컨트롤