작업 대화 상자
이 섹션에는 작업 대화 상자와 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다. 작업 대화 상자는 기본 메시지 상자와 유사하지만 이보다 훨씬 더 유연합니다.
개요
| 항목 | 콘텐츠 |
|---|---|
| 작업 대화 상자 정보 | 작업 대화 상자의 요소를 설명합니다. |
Functions
| 항목 | 콘텐츠 |
|---|---|
| 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 함수에서 이 구조체를 사용합니다. |