작업 대화 상자

아티클
06/13/2023

이 섹션에는 작업 대화 상자와 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다. 작업 대화 상자는 기본 메시지 상자와 유사하지만 이보다 훨씬 더 유연합니다.

개요

항목	콘텐츠
작업 대화 상자 정보	작업 대화 상자의 요소를 설명합니다.

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 함수에서 이 구조체를 사용합니다.