CSpinButtonCtrl 클래스
Windows의 공용 스핀 단추 컨트롤의 기능을 제공합니다.
구문
class CSpinButtonCtrl : public CWnd
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CSpinButtonCtrl::CSpinButtonCtrl | CSpinButtonCtrl 개체를 생성합니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CSpinButtonCtrl::Create | 스핀 단추 컨트롤을 만들어 개체에 CSpinButtonCtrl 연결합니다. |
| CSpinButtonCtrl::CreateEx | 지정된 Windows 확장 스타일을 사용하여 스핀 단추 컨트롤을 만들고 개체에 CSpinButtonCtrl 연결합니다. |
| CSpinButtonCtrl::GetAccel | 스핀 단추 컨트롤에 대한 가속 정보를 검색합니다. |
| CSpinButtonCtrl::GetBase | 스핀 단추 컨트롤의 현재 베이스를 검색합니다. |
| CSpinButtonCtrl::GetBuddy | 현재 버디 창에 대한 포인터를 검색합니다. |
| CSpinButtonCtrl::GetPos | 스핀 단추 컨트롤의 현재 위치를 검색합니다. |
| CSpinButtonCtrl::GetRange | 스핀 단추 컨트롤의 상한 및 하한(범위)을 검색합니다. |
| CSpinButtonCtrl::SetAccel | 스핀 단추 컨트롤의 가속을 설정합니다. |
| CSpinButtonCtrl::SetBase | 스핀 단추 컨트롤의 기본을 설정합니다. |
| CSpinButtonCtrl::SetBuddy | 스핀 단추 컨트롤의 버디 창을 설정합니다. |
| CSpinButtonCtrl::SetPos | 컨트롤의 현재 위치를 설정합니다. |
| CSpinButtonCtrl::SetRange | 스핀 단추 컨트롤의 상한 및 하한(범위)을 설정합니다. |
설명
"스핀 단추 컨트롤"(업다운 컨트롤이라고도 함)은 스크롤 위치 또는 도우미 컨트롤에 표시되는 숫자와 같은 값을 증가 또는 감소하기 위해 클릭할 수 있는 화살표 단추 쌍입니다. 스핀 단추 컨트롤과 연결된 값을 현재 위치라고 부릅니다. 스핀 단추 컨트롤은 "버디 창"이라고 하는 도우미 컨트롤과 함께 가장 자주 사용됩니다.
이 컨트롤(따라서 CSpinButtonCtrl 클래스)은 Windows 95/98 및 Windows NT 버전 3.51 이상에서 실행되는 프로그램에서만 사용할 수 있습니다.
사용자에게 스핀 단추 컨트롤과 해당 버디 창은 종종 단일 컨트롤처럼 보입니다. 스핀 단추 컨트롤이 자동으로 버디 창 옆에 위치하도록 지정하고 버디 창의 캡션 현재 위치로 자동으로 설정하도록 지정할 수 있습니다. 편집 컨트롤과 함께 스핀 단추 컨트롤을 사용하여 사용자에게 숫자 입력을 묻는 메시지를 표시할 수 있습니다.
위쪽 화살표를 클릭하면 현재 위치가 최대값으로 이동하고 아래쪽 화살표를 클릭하면 현재 위치가 최소값으로 이동합니다. 기본적으로 최소값은 100이고 최대값은 0입니다. 최소 설정이 최대 설정보다 클 때마다(예: 기본 설정을 사용하는 경우) 위쪽 화살표를 클릭하면 위치 값이 감소하고 아래쪽 화살표를 클릭하면 증가합니다.
버디 창이 없는 스핀 단추 컨트롤은 일종의 간소화된 스크롤 막대로 작동합니다. 예를 들어 탭 컨트롤은 사용자가 추가 탭을 보기로 스크롤할 수 있도록 스핀 단추 컨트롤을 표시하는 경우가 있습니다.
사용에 CSpinButtonCtrl대한 자세한 내용은 Controls 및 Using CSpinButtonCtrl을 참조하세요.
상속 계층 구조
CSpinButtonCtrl
요구 사항
헤더: afxcmn.h
CSpinButtonCtrl::Create
스핀 단추 컨트롤을 만들어 개체에 CSpinButtonCtrl 연결합니다.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
매개 변수
dwStyle
스핀 단추 컨트롤의 스타일을 지정합니다. 스핀 단추 컨트롤 스타일의 조합을 컨트롤에 적용합니다. 이러한 스타일은 Windows SDK의 업다운 컨트롤 스타일 에 설명되어 있습니다.
rect
스핀 단추 컨트롤의 크기와 위치를 지정합니다. CRect 개체 또는 RECT 구조체일 수 있습니다.
pParentWnd
스핀 단추 컨트롤의 부모 창에 대한 포인터(일반적으로 .CDialog NULL이 아니어야 합니다.
nID
스핀 단추 컨트롤의 ID를 지정합니다.
Return Value
초기화에 성공하면 0이 아닌 값입니다. 그렇지 않으면 0입니다.
설명
먼저 두 단계로 개체를 CSpinButtonCtrl 생성하고 생성자를 호출 Create한 다음 호출합니다. 그러면 스핀 단추 컨트롤이 만들어지고 개체에 CSpinButtonCtrl 연결됩니다.
확장 창 스타일을 사용하여 스핀 단추 컨트롤을 만들려면 대신 CSpinButtonCtrl::CreateExCreate를 호출합니다.
CSpinButtonCtrl::CreateEx
컨트롤(자식 창)을 만들어 개체와 연결 CSpinButtonCtrl 합니다.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
매개 변수
dwExStyle
만들 컨트롤의 확장 스타일을 지정합니다. 확장된 Windows 스타일 목록은 Windows SDK의 CreateWindowEx에 대한 dwExStyle 매개 변수를 참조하세요.
dwStyle
스핀 단추 컨트롤의 스타일을 지정합니다. 스핀 단추 컨트롤 스타일의 조합을 컨트롤에 적용합니다. 이러한 스타일은 Windows SDK의 업다운 컨트롤 스타일 에 설명되어 있습니다.
rect
pParentWnd의 클라이언트 좌표에서 만들 창의 크기와 위치를 설명하는 RECT 구조체에 대한 참조입니다.
pParentWnd
컨트롤의 부모 창에 대한 포인터입니다.
nID
컨트롤의 자식 창 ID입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다.
설명
Windows 확장 스타일 서문 WS_EX_ 지정된 확장 Windows 스타일을 적용하려면 만들기 대신 사용합니다CreateEx.
CSpinButtonCtrl::CSpinButtonCtrl
CSpinButtonCtrl 개체를 생성합니다.
CSpinButtonCtrl();
CSpinButtonCtrl::GetAccel
스핀 단추 컨트롤에 대한 가속 정보를 검색합니다.
UINT GetAccel(
int nAccel,
UDACCEL* pAccel) const;
매개 변수
nAccel
pAccel로 지정된 배열의 요소 수입니다.
pAccel
가속 정보를 수신하는 UDACCEL 구조의 배열에 대한 포인터입니다.
Return Value
검색된 가속기 구조의 수입니다.
CSpinButtonCtrl::GetBase
스핀 단추 컨트롤의 현재 베이스를 검색합니다.
UINT GetBase() const;
Return Value
현재 기준 값입니다.
CSpinButtonCtrl::GetBuddy
현재 버디 창에 대한 포인터를 검색합니다.
CWnd* GetBuddy() const;
Return Value
현재 버디 창에 대한 포인터입니다.
CSpinButtonCtrl::GetPos
스핀 단추 컨트롤의 현재 위치를 검색합니다.
int GetPos() const; int GetPos32(LPBOOL lpbError = NULL) const;
매개 변수
lpbError
값이 성공적으로 검색되면 0으로 설정되고 오류가 발생하면 0이 아닌 부울 값에 대한 포인터입니다. 이 매개 변수가 NULL로 설정되면 오류가 보고되지 않습니다.
Return Value
첫 번째 버전은 낮은 순서의 단어에서 16비트 현재 위치를 반환합니다. 오류가 발생한 경우 상위 단어는 0이 아닌 단어입니다.
두 번째 버전은 32비트 위치를 반환합니다.
설명
반환된 값을 처리할 때 컨트롤은 버디 창의 캡션 따라 현재 위치를 업데이트합니다. 이 컨트롤은 버디 창이 없거나 캡션 잘못된 값 또는 범위를 벗어난 값을 지정하는 경우 오류를 반환합니다.
CSpinButtonCtrl::GetRange
스핀 단추 컨트롤의 상한 및 하한(범위)을 검색합니다.
DWORD GetRange() const;
void GetRange(
int& lower,
int& upper) const;
void GetRange32(
int& lower,
int &upper) const;
매개 변수
lower
컨트롤의 하한을 받는 정수에 대한 참조입니다.
upper
컨트롤의 상한을 받는 정수에 대한 참조입니다.
Return Value
첫 번째 버전은 상한 및 하한을 포함하는 32비트 값을 반환합니다. 낮은 순서 단어는 컨트롤의 상한이고 상위 단어는 하한입니다.
설명
멤버 함수 GetRange32 는 스핀 단추 컨트롤의 범위를 32비트 정수로 검색합니다.
CSpinButtonCtrl::SetAccel
스핀 단추 컨트롤의 가속을 설정합니다.
BOOL SetAccel(
int nAccel,
UDACCEL* pAccel);
매개 변수
nAccel
pAccel로 지정된 UDACCEL 구조체의 수입니다.
pAccel
가속 정보를 포함하는 UDACCEL 구조의 배열에 대한 포인터입니다. 요소는 멤버에 따라 nSec 오름차순으로 정렬되어야 합니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다.
CSpinButtonCtrl::SetBase
스핀 단추 컨트롤의 기본을 설정합니다.
int SetBase(int nBase);
매개 변수
nBase
컨트롤의 새 베이스 값입니다. 10진수의 경우 10, 16은 16이 될 수 있습니다.
Return Value
성공한 경우 이전 기본 값이거나 잘못된 기준이 지정된 경우 0입니다.
설명
기준 값은 버디 창에 숫자를 10진수 또는 16진수로 표시하는지 여부를 결정합니다. 16진수는 항상 부호가 지정되지 않습니다. 10진수로 서명됩니다.
CSpinButtonCtrl::SetBuddy
스핀 단추 컨트롤의 버디 창을 설정합니다.
CWnd* SetBuddy(CWnd* pWndBuddy);
매개 변수
pWndBuddy
새 버디 창에 대한 포인터입니다.
Return Value
이전 버디 창에 대한 포인터입니다.
설명
스핀 컨트롤은 거의 항상 일부 콘텐츠를 표시하는 편집 컨트롤과 같은 다른 창과 연결됩니다. 이 다른 창을 스핀 컨트롤의 "버디"라고 합니다.
CSpinButtonCtrl::SetPos
스핀 단추 컨트롤의 현재 위치를 설정합니다.
int SetPos(int nPos);
int SetPos32(int nPos);
매개 변수
Npos
컨트롤의 새 위치입니다. 이 값은 컨트롤의 상한 및 하한으로 지정된 범위에 있어야 합니다.
Return Value
이전 위치(16비트 전체 자릿수 SetPos, 32비트 전체 자릿수)입니다 SetPos32.
설명
SetPos32 는 32비트 위치를 설정합니다.
CSpinButtonCtrl::SetRange
스핀 단추 컨트롤의 상한 및 하한(범위)을 설정합니다.
void SetRange(
short nLower,
short nUpper);
void SetRange32(
int nLower,
int nUpper);
매개 변수
nLower 및 nUpper
컨트롤의 상한 및 하한입니다. 두 SetRange제한 모두 UD_MAXVAL보다 크거나 UD_MINVAL 작을 수 없습니다. 또한 두 제한 간의 차이는 UD_MAXVAL 초과할 수 없습니다. SetRange32 는 제한에 제한을 두지 않습니다. 는 정수만 사용합니다.
설명
멤버 함수 SetRange32 는 스핀 단추 컨트롤의 32비트 범위를 설정합니다.
참고 항목
스핀 단추의 기본 범위는 최대값을 0으로 설정하고 최소값은 100으로 설정합니다. 최대값이 최소값보다 작기 때문에 위쪽 화살표를 클릭하면 위치가 줄어들고 아래쪽 화살표를 클릭하면 증가합니다. 이러한 값을 조정하는 데 사용합니다 CSpinButtonCtrl::SetRange .
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기