다음을 통해 공유

CTaskDialog::SetOptions

  • 아티클

구성 옵션에는 CTaskDialog.

void SetOptions(
   int nOptionFlag
);

매개 변수

  • [in] nOptionFlag
    일련의 플래그를 사용 하 여 CTaskDialog.

설명

이 메서드는 현재 모든 옵션을 지웁니다는 CTaskDialog.현재 옵션을 유지 하 여 처음으로 검색 해야 CTaskDialog::GetOptions 다음 설정 옵션을 결합 합니다.

다음 표는 모든 유효한 옵션입니다.

  • TDF_ENABLE_HYPERLINKS
    하이퍼링크에 사용 된 CTaskDialog.

  • TDF_USE_HICON_MAIN
    구성 된 CTaskDialog 사용 하는 HICON 주 아이콘에 대 한.대신 사용 하는 것은 LPCWSTR.

  • TDF_USE_HICON_FOOTER
    구성 된 CTaskDialog 사용 하는 HICON 바닥글 아이콘.대신 사용 하는 것은 LPCWSTR.

  • TDF_ALLOW_DIALOG_CANCELLATION
    사용자가 닫을 수는 CTaskDialog 대화 상자의 오른쪽 위 모서리에 있는 아이콘을 사용 하 여 또는 키보드를 사용 하 여 경우에는 취소 단추를 사용할 수 없습니다.이 플래그가 설정 되어 있지 않으면, 취소 단추를 사용할 수 없습니다, 사용자가 Alt + f 4를 Esc 키를 사용 하 여 대화 상자를 닫을 수 없습니다 또는 제목 표시줄의 닫기 단추.

  • TDF_USE_COMMAND_LINKS
    구성 된 CTaskDialog 명령 단추 컨트롤을 사용 합니다.

  • TDF_USE_COMMAND_LINKS_NO_ICON
    구성 된 CTaskDialog 컨트롤 옆에 아이콘을 표시 하지 않고 명령 단추 컨트롤을 사용 합니다.TDF_USE_COMMAND_LINKS는 TDF_USE_COMMAND_LINKS_NO_ICON를 재정의합니다.

  • TDF_EXPAND_FOOTER_AREA
    현재 확장 영역 확장을 나타냅니다.

  • TDF_EXPANDED_BY_DEFAULT
    기본적으로 확장 영역 확장 되는지 여부를 결정 합니다.

  • TDF_VERIFICATION_FLAG_CHECKED
    나타내는 현재 확인 확인란을 선택 합니다.

  • TDF_SHOW_PROGRESS_BAR
    구성 된 CTaskDialog 진행률 표시줄을 표시 합니다.

  • TDF_SHOW_MARQUEE_PROGRESS_BAR
    움직이는 진행률 표시줄에 진행률 표시줄을 구성 합니다.설정 해야이 옵션을 사용 하면 TDF_SHOW_PROGRESS_BAR 에 예상 되는 동작입니다.

  • TDF_CALLBACK_TIMER
    CTaskDialog 콜백 간격 약 200 밀리초로 설정 됩니다.

  • TDF_POSITION_RELATIVE_TO_WINDOW
    구성 된 CTaskDialog 부모 창을 기준으로 가운데에.이 플래그를 사용 하지 않으면 있는 CTaskDialog 모니터를 기준으로 가운데에 맞춥니다.

  • TDF_RTL_LAYOUT
    구성 된 CTaskDialog 를 오른쪽에서 왼쪽으로 읽기.

  • TDF_NO_DEFAULT_RADIO_BUTTON
    없음 라디오 단추 선택 되었음을 나타냅니다 때의 CTaskDialog 나타납니다.

  • TDF_CAN_BE_MINIMIZED
    최소화할 수 있는 CTaskDialog.이 옵션을 지원 하 여 CTaskDialog 모달 수 없습니다.MFC는 모덜리스 폼을 지원 하지 않으므로이 옵션을 MFC 지원 하지 않습니다 CTaskDialog.

예제

// TODO: Replace the strings below with the appropriate message, 
// main instruction, and dialog title
CString message("This is an important message to the user.");
CString mainInstruction("Important!\nPlease read!");
CString title("Alert Dialog");

CTaskDialog taskDialog(message, mainInstruction, title, 
    TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON );

// Setting new information to be able to reuse the dialog resource
taskDialog.SetWindowTitle(L"New title for the task dialog");
taskDialog.SetContent(L"New message to show the user.");
taskDialog.SetMainInstruction(L"Even more important!");
taskDialog.SetMainIcon(TD_ERROR_ICON);
taskDialog.SetDialogWidth(300);

// Add a footer
taskDialog.SetFooterText(L"Footer information for the dialog.");
taskDialog.SetFooterIcon(TD_INFORMATION_ICON);

// Add expansion information
taskDialog.SetExpansionArea(L"Additional information\non two lines.",
    L"Click here for more information.",
    L"Click here to hide the extra information.");

// Change the options to show the expanded information by default.
// It is necessary to retrieve the current options first.
int options = taskDialog.GetOptions();
options |= TDF_EXPANDED_BY_DEFAULT;
taskDialog.SetOptions(options);

taskDialog.DoModal();

요구 사항

헤더: afxtaskdialog.h

참고 항목

참조

CTaskDialog 클래스

계층 구조 차트

CTaskDialog::GetOptions