작업 대화 상자
이 섹션에는 작업 대화 상자와 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다. 작업 대화 상자 기본 메시지 상자보다 훨씬 유연하지만 유사합니다.
개요
| 주제 | 목차 |
|---|---|
| 작업 대화 정보 | 작업 대화 상자의 요소를 설명합니다. |
함수
| 주제 | 목차 |
|---|---|
| TaskDialog | 작업 대화 상자를 만들고, 표시하고, 작동합니다. 작업 대화 상자에는 애플리케이션에서 정의한 메시지 텍스트와 제목, 아이콘 및 미리 정의된 누름 단추의 조합이 포함됩니다. 이 함수는 알림을 받기 위한 콜백 함수 등록을 지원하지 않습니다. |
| TaskDialogCallbackProc |
TaskDialogIndirect 함수와 함께 사용되는 애플리케이션 정의 함수입니다. 다양한 이벤트가 발생할 때 작업 대화 상자에서 메시지를 받습니다. PFTASKDIALOGCALLBACK 형식은 이 콜백 함수에 대한 포인터를 정의합니다. TaskDialogCallbackProc 애플리케이션 정의 함수 이름의 자리 표시자입니다. |
| TaskDialogIndirect | 작업 대화 상자를 만들고, 표시하고, 작동합니다. 작업 대화 상자에는 애플리케이션 정의 아이콘, 메시지, 제목, 확인 확인란, 명령 링크, 누름 단추 및 라디오 단추가 포함됩니다. 이 함수는 콜백 함수를 등록하여 알림 메시지를 받을 수 있습니다. |
메시지
| 주제 | 목차 |
|---|---|
| TDM_CLICK_BUTTON | 작업 대화 상자에서 단추 클릭 동작을 시뮬레이션합니다. |
| TDM_CLICK_RADIO_BUTTON | 작업 대화 상자에서 라디오 단추 클릭 동작을 시뮬레이션합니다. |
| TDM_CLICK_VERIFICATION | 작업 대화 상자에서 확인 확인란 클릭 동작을 시뮬레이션합니다. |
| TDM_ENABLE_BUTTON | 작업 대화 상자에서 누름 단추를 사용하거나 사용하지 않도록 설정합니다. |
| TDM_ENABLE_RADIO_BUTTON | 작업 대화 상자에서 라디오 단추를 사용하거나 사용하지 않도록 설정합니다. |
| TDM_NAVIGATE_PAGE | 여러 페이지 마법사의 기능을 시뮬레이션하여 새 내용으로 작업 대화 상자를 다시 만듭니다. |
| TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE | 지정된 작업 대화 상자 단추 또는 명령 링크에 UAC(사용자 계정 컨트롤) 방패 아이콘이 있어야 하는지 여부를 지정합니다. 즉, 단추에서 호출하는 작업에 상승이 필요한지 여부입니다. |
| TDM_SET_ELEMENT_TEXT | 작업 대화 상자에서 텍스트 요소를 업데이트합니다. |
| TDM_SET_MARQUEE_PROGRESS_BAR | 호스트된 진행률 표시줄을 선택 윤곽 모드로 표시할지 여부를 나타냅니다. |
| TDM_SET_PROGRESS_BAR_MARQUEE | 진행률 표시줄의 선택 윤곽 표시를 시작하고 중지하고 선택 윤곽의 속도를 설정합니다. |
| TDM_SET_PROGRESS_BAR_POS | 진행률 표시줄의 현재 위치를 설정합니다. |
| TDM_SET_PROGRESS_BAR_RANGE | 호스트된 진행률 표시줄의 최소값과 최대값을 설정합니다. |
| TDM_SET_PROGRESS_BAR_STATE | 진행률 표시줄의 현재 상태를 설정합니다. |
| TDM_UPDATE_ELEMENT_TEXT | 작업 대화 상자에서 텍스트 요소를 업데이트합니다. |
| TDM_UPDATE_ICON | 작업 대화 상자의 아이콘을 새로 고칩니다. |
알림을
| 주제 | 목차 |
|---|---|
| TDN_BUTTON_CLICKED | 사용자가 작업 대화 상자에서 단추 또는 명령 링크를 선택할 때 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_CREATED | 작업 대화 상자가 만들어진 후 및 표시되기 전에 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_DESTROYED | 작업 대화 상자가 제거되고 창 핸들이 더 이상 유효하지 않을 때 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_DIALOG_CONSTRUCTED | 작업 대화 상자가 만들어진 후 및 표시되기 전에 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_EXPANDO_BUTTON_CLICKED | 사용자가 작업 대화 상자의 확장 단추를 클릭할 때 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_HELP | 작업 대화 상자에 포커스가 있는 동안 사용자가 키보드에서 F1 키를 누르면 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_HYPERLINK_CLICKED | 사용자가 작업 대화 상자 콘텐츠에서 하이퍼링크를 클릭할 때 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_NAVIGATED | 탐색이 발생했을 때 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_RADIO_BUTTON_CLICKED | 사용자가 작업 대화 상자에서 단추 또는 명령 링크를 선택할 때 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_TIMER | 작업 대화 상자에서 약 200밀리초마다 전송됩니다. 이 알림 코드는 TaskDialogIndirect 함수에 전달된 TASKDIALOGCONFIG 구조체의 dwFlags 멤버에서 TDF_CALLBACK_TIMER 플래그가 설정된 경우 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
| TDN_VERIFICATION_CLICKED | 사용자가 작업 대화 상자 확인 확인란을 클릭하면 작업 대화 상자에서 전송됩니다. 이 알림 코드는 TaskDialogIndirect 메서드를 사용하여 등록할 수 있는 작업 대화 상자 콜백 함수를 통해서만 수신됩니다. |
구조
| 주제 | 목차 |
|---|---|
| TASKDIALOG_BUTTON | 작업 대화 상자에 단추를 표시하는 데 사용되는 정보를 포함합니다.
TASKDIALOGCONFIG 구조체는 이 구조를 사용합니다. |
| taskDIALOGCONFIG | 작업 대화 상자를 표시하는 데 사용되는 정보를 포함합니다.
TaskDialogIndirect 함수는 이 구조를 사용합니다. |