단추(Windows 컨트롤)
이 섹션에는 단추 컨트롤과 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다. 단추 사용자가 애플리케이션에 입력을 제공 하려면 클릭할 수 있는 컨트롤입니다.
개요
| 주제 | 목차 |
|---|---|
| 단추 메시지 | 이 항목에서는 단추와 함께 사용되는 메시지에 대해 설명합니다. |
| 단추 상태 | 이 섹션에서는 단추를 선택하면 상태가 어떻게 변경되고 애플리케이션이 응답해야 하는지에 대해 설명합니다. |
| 단추 형식 | 이 항목에서는 다양한 종류의 단추에 대해 설명합니다. |
| 단추 사용하여 | 이 섹션에서는 단추와 관련된 특정 작업을 수행하는 방법을 설명합니다. |
함수
| 주제 | 목차 |
|---|---|
| CheckDlgButton | 단추 컨트롤의 확인 상태를 변경합니다. |
| CheckRadioButton | 그룹의 지정된 라디오 단추에 확인 표시를 추가하고 그룹의 다른 모든 라디오 단추에서 확인 표시를 제거합니다(지우기). |
| IsDlgButtonChecked |
IsDlgButtonChecked 함수는 단추 컨트롤이 선택되어 있는지 또는 3개 상태 단추 컨트롤을 선택했는지, 선택 취소되었는지 또는 확정되지 않았는지를 결정합니다. |
매크로
| 주제 | 목차 |
|---|---|
| Button_Enable | 단추를 사용하거나 사용하지 않도록 설정합니다. |
| Button_GetCheck | 라디오 단추 또는 확인란의 확인란을 가져옵니다. 이 매크로를 사용하거나 BM_GETCHECK 메시지를 명시적으로 보낼 수 있습니다. |
| Button_GetIdealSize | 이미지 목록이 있는 경우 텍스트 및 이미지에 가장 적합한 단추의 크기를 가져옵니다. 이 매크로를 사용하거나 BCM_GETIDEALSIZE 메시지를 명시적으로 보낼 수 있습니다. |
| Button_GetImageList | 단추 컨트롤에 대해 설정된 이미지 목록을 설명하는 BUTTON_IMAGELIST 구조를 가져옵니다. 이 매크로를 사용하거나 BCM_GETIMAGELIST 메시지를 명시적으로 보낼 수 있습니다. |
| Button_GetNote | 명령 링크 단추와 연결된 메모의 텍스트를 가져옵니다. 이 매크로를 사용하거나 BCM_GETNOTE 메시지를 명시적으로 보낼 수 있습니다. |
| Button_GetNoteLength | 명령 링크에 대한 설명에 표시될 수 있는 메모 텍스트의 길이를 가져옵니다. 이 매크로를 사용하거나 BCM_GETNOTELENGTH 메시지를 명시적으로 보냅니다. |
| Button_GetSplitInfo | 지정된 분할 단추 컨트롤에 대한 정보를 가져옵니다. 이 매크로를 사용하거나 BCM_GETSPLITINFO 메시지를 명시적으로 보냅니다. |
| Button_GetState | 라디오 단추 또는 확인란의 확인란을 가져옵니다. 이 매크로를 사용하거나 BM_GETSTATE 메시지를 명시적으로 보낼 수 있습니다. |
| Button_GetText | 단추의 텍스트를 가져옵니다. |
| Button_GetTextLength | 단추 텍스트의 문자 수를 가져옵니다. |
| Button_GetTextMargin | 단추 컨트롤에서 텍스트를 그리는 데 사용되는 여백을 가져옵니다. 이 매크로를 사용하거나 BCM_GETTEXTMARGIN 메시지를 명시적으로 보낼 수 있습니다. |
| Button_SetCheck | 라디오 단추 또는 확인란의 확인 상태를 설정합니다. 이 매크로를 사용하거나 BM_SETCHECK 메시지를 명시적으로 보낼 수 있습니다. |
| Button_SetDropDownState | 스타일이 BS_SPLITBUTTON지정된 단추의 드롭다운 상태를 설정합니다. 이 매크로를 사용하거나 BCM_SETDROPDOWNSTATE 메시지를 명시적으로 보냅니다. |
| Button_SetElevationRequiredState | 관리자 권한 아이콘을 표시하기 위해 지정된 단추 또는 명령 링크에 대한 권한 상승 필수 상태를 설정합니다. 이 매크로를 사용하거나 BCM_SETSHIELD 메시지를 명시적으로 보냅니다. |
| Button_SetImageList | 단추 컨트롤에 이미지 목록을 할당합니다. 이 매크로를 사용하거나 BCM_SETIMAGELIST 메시지를 명시적으로 보낼 수 있습니다. |
| Button_SetNote | 지정된 명령 링크 단추와 연결된 메모의 텍스트를 설정합니다. 이 매크로를 사용하거나 BCM_SETNOTE 메시지를 명시적으로 보낼 수 있습니다. |
| Button_SetSplitInfo | 지정된 분할 단추 컨트롤에 대한 정보를 설정합니다. 이 매크로를 사용하거나 BCM_SETSPLITINFO 메시지를 명시적으로 보냅니다. |
| Button_SetState | 단추의 강조 표시 상태를 설정합니다. 강조 표시 상태는 사용자가 단추를 누름한 것처럼 단추가 강조 표시되어 있는지 여부를 나타냅니다. 이 매크로를 사용하거나 BM_SETSTATE 메시지를 명시적으로 보낼 수 있습니다. |
| Button_SetStyle | 단추의 스타일을 설정합니다. 이 매크로를 사용하거나 BM_SETSTYLE 메시지를 명시적으로 보낼 수 있습니다. |
| Button_SetText | 단추의 텍스트를 설정합니다. |
| Button_SetTextMargin | 단추 컨트롤에서 텍스트를 그리기 위한 여백을 설정합니다. 이 매크로를 사용하거나 BCM_SETTEXTMARGIN 메시지를 명시적으로 보낼 수 있습니다. |
메시지
| 주제 | 목차 |
|---|---|
| BCM_GETIDEALSIZE | 이미지 목록이 있는 경우 텍스트 및 이미지에 가장 적합한 단추의 크기를 가져옵니다. 이 메시지를 명시적으로 보내거나 Button_GetIdealSize 매크로를 사용할 수 있습니다. |
| BCM_GETIMAGELIST | 단추 컨트롤에 할당된 이미지 목록을 설명하는 BUTTON_IMAGELIST 구조를 가져옵니다. 이 메시지를 명시적으로 보내거나 Button_GetImageList 매크로를 사용할 수 있습니다. |
| BCM_GETNOTE | 명령 링크 단추와 연결된 메모의 텍스트를 가져옵니다. 이 메시지를 명시적으로 보내거나 Button_GetNote 매크로를 사용할 수 있습니다. |
| BCM_GETNOTELENGTH | 명령 링크 단추에 대한 설명에 표시될 수 있는 메모 텍스트의 길이를 가져옵니다. 이 메시지를 명시적으로 보내거나 Button_GetNoteLength 매크로를 사용하여 보냅니다. |
| BCM_GETSPLITINFO | 분할 단추 컨트롤에 대한 정보를 가져옵니다. 이 메시지를 명시적으로 보내거나 Button_GetSplitInfo 매크로를 사용하여 보냅니다. |
| BCM_GETTEXTMARGIN | 단추 컨트롤에서 텍스트를 그리는 데 사용되는 여백을 가져옵니다. 이 메시지를 명시적으로 보내거나 Button_GetTextMargin 매크로를 사용할 수 있습니다. |
| BCM_SETDROPDOWNSTATE | 스타일 TBSTYLE_DROPDOWN있는 단추의 드롭다운 상태를 설정합니다. 이 메시지를 명시적으로 보내거나 Button_SetDropDownState 매크로를 사용하여 보냅니다. |
| BCM_SETIMAGELIST | 단추 컨트롤에 이미지 목록을 할당합니다. 이 메시지를 명시적으로 보내거나 Button_SetImageList 매크로를 사용할 수 있습니다. |
| BCM_SETNOTE | 명령 링크 단추와 연결된 메모의 텍스트를 설정합니다. 이 메시지를 명시적으로 보내거나 Button_SetNote 매크로를 사용할 수 있습니다. |
| BCM_SETSHIELD | 관리자 권한 아이콘을 표시하기 위해 지정된 단추 또는 명령 링크에 대한 권한 상승 필수 상태를 설정합니다. 이 메시지를 명시적으로 보내거나 Button_SetElevationRequiredState 매크로를 사용하여 보냅니다. |
| BCM_SETSPLITINFO | 분할 단추 컨트롤에 대한 정보를 설정합니다. 이 메시지를 명시적으로 보내거나 Button_SetSplitInfo 매크로를 사용하여 보냅니다. |
| BCM_SETTEXTMARGIN |
BCM_SETTEXTMARGIN 메시지는 단추 컨트롤에서 텍스트를 그리기 위한 여백을 설정합니다. |
| BM_CLICK | 단추를 클릭하는 사용자를 시뮬레이션합니다. 이 메시지를 사용하면 단추가 WM_LBUTTONDOWN 및 WM_LBUTTONUP 메시지를 수신하고 단추의 부모 창에서 BN_CLICKED 알림 코드를 받습니다. |
| BM_GETCHECK | 라디오 단추 또는 확인란의 확인란을 가져옵니다. 이 메시지를 명시적으로 보내거나 Button_GetCheck 매크로를 사용할 수 있습니다. |
| BM_GETIMAGE | 단추와 연결된 이미지(아이콘 또는 비트맵)에 대한 핸들을 검색합니다. |
| BM_GETSTATE | 단추 또는 확인란의 상태를 검색합니다. 이 메시지를 명시적으로 보내거나 Button_GetState 매크로를 사용할 수 있습니다. |
| BM_SETCHECK | 라디오 단추 또는 확인란의 확인 상태를 설정합니다. 이 메시지를 명시적으로 보내거나 Button_SetCheck 매크로를 사용하여 보낼 수 있습니다. |
| BM_SETDONTCLICK | 단추가 포커스를 받을 때 BN_CLICKED 메시지 생성을 제어하는 라디오 단추의 플래그를 설정합니다. |
| BM_SETIMAGE | 새 이미지(아이콘 또는 비트맵)를 단추와 연결합니다. |
| BM_SETSTATE | 단추의 강조 표시 상태를 설정합니다. 강조 표시 상태는 사용자가 단추를 누름한 것처럼 단추가 강조 표시되어 있는지 여부를 나타냅니다. 이 메시지를 명시적으로 보내거나 Button_SetState 매크로를 사용할 수 있습니다. |
| BM_SETSTYLE | 단추의 스타일을 설정합니다. 이 메시지를 명시적으로 보내거나 Button_SetStyle 매크로를 사용할 수 있습니다. |
알림을
| 주제 | 목차 |
|---|---|
| BCN_DROPDOWN | 사용자가 단추의 드롭다운 화살표를 클릭하면 전송됩니다. 컨트롤의 부모 창은 이 알림 코드를 WM_NOTIFY 메시지 형식으로 받습니다. |
| BCN_HOTITEMCHANGE | 단추 컨트롤 소유자에게 마우스가 단추 컨트롤의 클라이언트 영역에 들어오거나 나가는 것을 알립니다. 단추 컨트롤은 이 알림 코드를 WM_NOTIFY 메시지 형식으로 보냅니다. |
| BN_CLICKED | 사용자가 단추를 클릭할 때 전송됩니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_CLICKED 알림 코드를 받습니다. |
| BN_DBLCLK | 사용자가 단추를 두 번 클릭할 때 전송됩니다. 이 알림 코드는 BS_USERBUTTON, BS_RADIOBUTTON및 BS_OWNERDRAW 단추에 대해 자동으로 전송됩니다. 다른 단추 형식은 BS_NOTIFY 스타일이 있는 경우에만 BN_DBLCLK 보냅니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_DBLCLK 알림 코드를 받습니다. |
| BN_DISABLE | 단추를 사용할 수 없는 경우 전송됩니다.
참고: 이 알림 코드는 버전 3.0 이전의 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 애플리케이션은 이 작업에 BS_OWNERDRAW 단추 스타일과 DRAWITEMSTRUCT 구조를 사용해야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_DISABLE 알림 코드를 받습니다. |
| BN_DOUBLECLICKED | 사용자가 단추를 두 번 클릭할 때 전송됩니다. 이 알림 코드는 BS_USERBUTTON, BS_RADIOBUTTON및 BS_OWNERDRAW 단추에 대해 자동으로 전송됩니다. 다른 단추 형식은 BS_NOTIFY 스타일이 있는 경우에만 BN_DOUBLECLICKED 보냅니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_DOUBLECLICKED 알림 코드를 받습니다. |
| BN_HILITE | 사용자가 단추를 선택할 때 전송됩니다.
참고: 이 알림 코드는 버전 3.0 이전의 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 애플리케이션은 이 작업에 BS_OWNERDRAW 단추 스타일과 DRAWITEMSTRUCT 구조를 사용해야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_HILITE 알림 코드를 받습니다. |
| BN_KILLFOCUS | 단추가 키보드 포커스를 잃을 때 전송됩니다. 이 알림 코드를 보내려면 단추에 BS_NOTIFY 스타일이 있어야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_KILLFOCUS 알림 코드를 받습니다. |
| BN_PAINT | 단추를 그려야 할 때 전송됩니다.
참고: 이 알림 코드는 버전 3.0 이전의 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 애플리케이션은 이 작업에 BS_OWNERDRAW 단추 스타일과 DRAWITEMSTRUCT 구조를 사용해야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_PAINT 알림 코드를 받습니다. |
| BN_PUSHED | 단추의 푸시 상태가 푸시되도록 설정된 경우 전송됩니다.
참고: 이 알림 코드는 버전 3.0 이전의 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 애플리케이션은 이 작업에 BS_OWNERDRAW 단추 스타일과 DRAWITEMSTRUCT 구조를 사용해야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_PUSHED 알림 코드를 받습니다. |
| BN_SETFOCUS | 단추가 키보드 포커스를 받을 때 전송됩니다. 이 알림 코드를 보내려면 단추에 BS_NOTIFY 스타일이 있어야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_SETFOCUS 알림 코드를 받습니다. |
| BN_UNHILITE | 단추에서 강조 표시를 제거해야 하는 경우 전송됩니다.
참고: 이 알림 코드는 버전 3.0 이전의 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 애플리케이션은 이 작업에 BS_OWNERDRAW 단추 스타일과 DRAWITEMSTRUCT 구조를 사용해야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_UNHILITE 알림 코드를 받습니다. |
| BN_UNPUSHED | 단추의 푸시 상태가 게시 취소됨으로 설정된 경우 전송됩니다.
참고: 이 알림 코드는 버전 3.0 이전의 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 애플리케이션은 이 작업에 BS_OWNERDRAW 단추 스타일과 DRAWITEMSTRUCT 구조를 사용해야 합니다. 단추의 부모 창은 WM_COMMAND 메시지를 통해 BN_UNPUSHED 알림 코드를 받습니다. |
| NM_CUSTOMDRAW(단추) | 단추 컨트롤의 부모 창에 단추의 사용자 지정 그리기 작업에 대해 알립니다. 단추 컨트롤은 이 알림 코드를 WM_NOTIFY 메시지 형식으로 보냅니다. |
| WM_CTLCOLORBTN |
WM_CTLCOLORBTN 메시지는 단추를 그리기 전에 단추의 부모 창으로 전송됩니다. 부모 창은 단추의 텍스트 및 배경색을 변경할 수 있습니다. 그러나 소유자가 그린 단추만 이 메시지를 처리하는 부모 창에 응답합니다. |
구조
| 주제 | 목차 |
|---|---|
| BUTTON_IMAGELIST | 단추 컨트롤과 함께 사용되는 이미지 목록에 대한 정보를 포함합니다. |
| BUTTON_SPLITINFO | 분할 단추(BS_SPLITBUTTON 및 BS_DEFSPLITBUTTON 스타일)를 정의하는 정보를 포함합니다.
BCM_GETSPLITINFO 및 BCM_SETSPLITINFO 메시지와 함께 사용됩니다. |
| NMBCDROPDOWN |
BCN_DROPDOWN 알림에 대한 정보를 포함합니다. |
| NMBCHOTITEM | 단추 컨트롤을 마우스로 이동하는 방법에 대한 정보를 포함합니다. |
상수
| 주제 | 목차 |
|---|---|
| 단추 스타일 | 단추 스타일의 조합을 지정합니다.
CreateWindow 또는 CreateWindowEx 함수와 함께 BUTTON 클래스를 사용하여 단추를 만드는 경우 아래에 나열된 단추 스타일을 지정할 수 있습니다. |