TASKDIALOGCONFIG 구조체(commctrl.h)

아티클
08/22/2023

TASKDIALOGCONFIG 구조에는 작업 대화 상자를 표시하는 데 사용되는 정보가 포함되어 있습니다. TaskDialogIndirect 함수에서 이 구조체를 사용합니다.

구문

typedef struct _TASKDIALOGCONFIG {
  UINT                           cbSize;
  HWND                           hwndParent;
  HINSTANCE                      hInstance;
  TASKDIALOG_FLAGS               dwFlags;
  TASKDIALOG_COMMON_BUTTON_FLAGS dwCommonButtons;
  PCWSTR                         pszWindowTitle;
  union {
    HICON  hMainIcon;
    PCWSTR pszMainIcon;
  } DUMMYUNIONNAME;
  PCWSTR                         pszMainInstruction;
  PCWSTR                         pszContent;
  UINT                           cButtons;
  const TASKDIALOG_BUTTON        *pButtons;
  int                            nDefaultButton;
  UINT                           cRadioButtons;
  const TASKDIALOG_BUTTON        *pRadioButtons;
  int                            nDefaultRadioButton;
  PCWSTR                         pszVerificationText;
  PCWSTR                         pszExpandedInformation;
  PCWSTR                         pszExpandedControlText;
  PCWSTR                         pszCollapsedControlText;
  union {
    HICON  hFooterIcon;
    PCWSTR pszFooterIcon;
  } DUMMYUNIONNAME2;
  PCWSTR                         pszFooter;
  PFTASKDIALOGCALLBACK           pfCallback;
  LONG_PTR                       lpCallbackData;
  UINT                           cxWidth;
} TASKDIALOGCONFIG;

멤버

cbSize

형식: UINT

구조체 크기를 바이트 단위로 지정합니다.

hwndParent

형식: HWND

부모 창에 대한 핸들입니다. 이 멤버는 NULL일 수 있습니다.

hInstance

형식: HINSTANCE

pszMainIcon 또는 pszFooterIcon 멤버로 식별된 아이콘 리소스가 포함된 모듈에 대한 핸들입니다. pszWindowTitle, pszMainInstruction, pszContent, pszVerificationText, pszExpandedInformation, pszExpandedControlText, pszCollapsedControlText 또는 pszFooter 멤버로 식별되는 문자열 리소스와

dwFlags

형식: TASKDIALOG_FLAGS

작업 대화 상자의 동작을 지정합니다. 이 매개 변수는 다음 그룹의 플래그 조합일 수 있습니다.

값	의미
TDF_ENABLE_HYPERLINKS	pszContent, pszExpandedInformation 및 pszFooter 멤버에 지정된 문자열에 대해 하이퍼링크 처리를 사용하도록 설정합니다. 사용하도록 설정하면 이러한 멤버는 다음 형식의 하이퍼링크가 포함된 문자열을 가리킬 수 있습니다. `<A HREF="executablestring">Hyperlink Text</A>` 경고: 안전하지 않은 원본의 콘텐츠를 사용할 때 하이퍼링크를 사용하도록 설정하면 보안 취약성이 발생할 수 있습니다. 참고 작업 대화 상자는 실제로 하이퍼링크를 실행하지 않습니다. 하이퍼링크 실행은 pfCallback으로 지정된 콜백 함수에서 처리해야 합니다. 자세한 내용은 TaskDialogCallbackProc을 참조하세요.
TDF_USE_HICON_MAIN	대화 상자에서 hMainIcon 멤버의 핸들에서 참조하는 아이콘을 작업 대화 상자의 기본 아이콘으로 사용해야 임을 나타냅니다. 이 플래그를 지정하면 pszMainIcon 멤버가 무시됩니다.
TDF_USE_HICON_FOOTER	대화 상자에서 hFooterIcon 멤버의 핸들에서 참조하는 아이콘을 작업 대화 상자의 바닥글 아이콘으로 사용해야 임을 나타냅니다. 이 플래그를 지정하면 pszFooterIcon 멤버가 무시됩니다.
TDF_ALLOW_DIALOG_CANCELLATION	dwCommonButtons 또는 pButtons 멤버에 취소 단추가 지정되지 않은 경우에도 Alt-F4, 이스케이프 및 제목 표시줄의 닫기 단추를 사용하여 대화 상자를 닫을 수 있어야 했음을 나타냅니다.
TDF_USE_COMMAND_LINKS	pButtons 멤버에 지정된 단추가 누름 단추 대신 명령 링크(표준 작업 대화 상자 문자 모양 사용)로 표시됨을 나타냅니다. 명령 링크를 사용하는 경우 pszButtonText 멤버의 첫 번째 줄 문자까지의 모든 문자는 명령 링크의 기본 텍스트로 처리되고 나머지는 명령 링크의 메모로 처리됩니다. cButtons 멤버가 0이면 이 플래그는 무시됩니다.
TDF_USE_COMMAND_LINKS_NO_ICON	pButtons 멤버에 지정된 단추가 누름 단추 대신 명령 링크(문자 모양 없음)로 표시되어야 했음을 나타냅니다. 명령 링크를 사용하는 경우 pszButtonText 멤버의 첫 번째 줄 문자까지의 모든 문자는 명령 링크의 기본 텍스트로 처리되고 나머지는 명령 링크의 메모로 처리됩니다. cButtons 멤버가 0이면 이 플래그는 무시됩니다.
TDF_EXPAND_FOOTER_AREA	pszExpandedInformation 멤버가 지정한 문자열이 대화 상자 내용 바로 뒤가 아니라 대화 상자 바닥글 영역의 맨 아래에 표시됨을 나타냅니다. pszExpandedInformation 멤버가 NULL인 경우 이 플래그는 무시됩니다.
TDF_EXPANDED_BY_DEFAULT	대화 상자가 처음 표시될 때 pszExpandedInformation 멤버가 지정한 문자열이 표시됨을 나타냅니다. pszExpandedInformation 멤버가 NULL인 경우 이 플래그는 무시됩니다.
TDF_VERIFICATION_FLAG_CHECKED	대화 상자가 처음 표시될 때 대화 상자의 확인 확인란이 선택됨을 나타냅니다. pszVerificationText 매개 변수가 NULL인 경우 이 플래그는 무시됩니다.
TDF_SHOW_PROGRESS_BAR	진행률 표시줄이 표시될 것임을 나타냅니다.
TDF_SHOW_MARQUEE_PROGRESS_BAR	선택 윤곽 진행률 표시줄이 표시될 것임을 나타냅니다.
TDF_CALLBACK_TIMER	작업 대화 상자의 콜백이 약 200밀리초마다 호출됨을 나타냅니다.
TDF_POSITION_RELATIVE_TO_WINDOW	hwndParent에서 지정한 창을 기준으로 작업 대화 상자가 위치(가운데)임을 나타냅니다. 플래그가 제공되지 않거나 hwndParent 멤버가 지정되지 않은 경우 작업 대화 상자는 모니터를 기준으로 배치(가운데 맞춤)됩니다.
TDF_RTL_LAYOUT	텍스트가 오른쪽에서 왼쪽으로 읽는 것으로 표시됨을 나타냅니다.
TDF_NO_DEFAULT_RADIO_BUTTON	기본 항목이 선택되지 않음을 나타냅니다.
TDF_CAN_BE_MINIMIZED	작업 대화 상자를 최소화할 수 있음을 나타냅니다.
TDIF_SIZE_TO_CONTENT	이 플래그는 더 이상 사용되지 않습니다. 대신 TDF_SIZE_TO_CONTENT 사용합니다.
TDF_SIZE_TO_CONTENT	작업 대화 상자의 너비가 콘텐츠 영역의 너비에 따라 결정됨을 나타냅니다. cxWidth가 0으로 설정되지 않은 경우 이 플래그는 무시됩니다.

dwCommonButtons

형식: TASKDIALOG_COMMON_BUTTON_FLAGS

작업 대화 상자에 표시되는 푸시 단추를 지정합니다. 일반 단추를 지정하지 않고 cButtons 및 pButtons 멤버를 사용하여 사용자 지정 단추를 지정하지 않으면 작업 대화 상자에는 기본적으로 확인 단추가 포함됩니다. 이 매개 변수는 다음 그룹의 플래그 조합일 수 있습니다.

값	의미
TDCBF_OK_BUTTON	작업 대화 상자에는 확인이라는 푸시 단추가 포함되어 있습니다.
TDCBF_YES_BUTTON	작업 대화 상자에는 예라는 푸시 단추가 포함되어 있습니다.
TDCBF_NO_BUTTON	작업 대화 상자에는 누름 단추가 포함되어 있습니다. 아니요.
TDCBF_CANCEL_BUTTON	작업 대화 상자에는 취소라는 푸시 단추가 포함되어 있습니다. 이 단추를 지정하면 작업 대화 상자가 일반적인 취소 작업(Alt-F4 및 이스케이프)에 응답합니다.
TDCBF_RETRY_BUTTON	작업 대화 상자에는 다시 시도라는 푸시 단추가 포함되어 있습니다.
TDCBF_CLOSE_BUTTON	작업 대화 상자에는 닫기 단추가 포함되어 있습니다.

pszWindowTitle

형식: PCWSTR

작업 대화 상자 제목에 사용할 문자열을 참조하는 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다. 이 매개 변수가 NULL이면 실행 프로그램의 파일 이름이 사용됩니다.

DUMMYUNIONNAME

DUMMYUNIONNAME.hMainIcon

형식: HICON

작업 대화 상자에 표시할 아이콘에 대한 핸들입니다. TDF_USE_HICON_MAIN 플래그를 지정하지 않으면 이 멤버는 무시됩니다. 이 멤버가 NULL 이고 TDF_USE_HICON_MAIN 지정되면 아이콘이 표시되지 않습니다.

DUMMYUNIONNAME.pszMainIcon

형식: PCWSTR

작업 대화 상자에 표시할 아이콘을 참조하는 포인터입니다. USE_HICON_MAIN 플래그가 지정된 경우 이 매개 변수는 무시됩니다. 그렇지 않으면 이 매개 변수가 NULL 이거나 hInstance 매개 변수가 NULL이면 아이콘이 표시되지 않습니다. 이 매개 변수는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자이거나 다음 미리 정의된 값 중 하나여야 합니다.

값	의미
TD_ERROR_ICON	작업 대화 상자에 중지 기호 아이콘이 나타납니다.
TD_WARNING_ICON	느낌표 아이콘이 작업 대화 상자에 나타납니다.
TD_INFORMATION_ICON	원 안에 있는 소문자 i로 구성된 아이콘이 작업 대화 상자에 나타납니다.
TD_SHIELD_ICON	작업 대화 상자에 방패 아이콘이 나타납니다.

pszMainInstruction

형식: PCWSTR

기본 명령에 사용할 문자열을 참조하는 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다.

pszContent

형식: PCWSTR

대화 상자의 기본 콘텐츠에 사용할 문자열을 참조하는 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다. dwFlags 멤버에 대해 ENABLE_HYPERLINKS 플래그를 지정하면 이 문자열에 HREF="executablestring">Hyperlink Text</A> 형식<의 하이퍼링크가 포함될 수 있습니다. 경고: 안전하지 않은 원본의 콘텐츠를 사용할 때 하이퍼링크를 사용하도록 설정하면 보안 취약성이 발생할 수 있습니다.

cButtons

형식: UINT

작업 대화 상자에서 단추 또는 명령 링크를 만드는 데 사용되는 pButtons 배열의 항목 수입니다. 이 멤버가 0이고 dwCommonButtons 멤버를 사용하여 일반 단추를 지정하지 않은 경우 작업 대화 상자에 하나의 확인 단추가 표시됩니다.

pButtons

형식: const TASKDIALOG_BUTTON*

작업 대화 상자에 표시할 사용자 지정 단추의 정의를 포함하는 TASKDIALOG_BUTTON 구조체 배열에 대한 포인터입니다. 이 배열에는 cButtons 멤버가 지정한 항목 수가 적어도 포함되어야 합니다.

nDefaultButton

형식: int

작업 대화 상자의 기본 단추입니다. pButtons 배열의 TASKDIALOG_BUTTON 구조체 중 하나의 nButtonID 멤버에 지정된 값 또는 dwCommonButtons 멤버에 지정된 단추에 해당하는 ID 중 하나일 수 있습니다.

IDCANCEL	취소 단추를 기본값으로 설정합니다.
IDNO	아니요 단추를 기본값으로 설정합니다.
IDOK	확인 단추를 기본값으로 설정합니다.
IDRETRY	다시 시도 단추를 기본값으로 설정합니다.
IDYES	예 단추를 기본값으로 설정합니다.
IDCLOSE	닫기 단추를 기본값으로 설정합니다.

이 멤버가 0이거나 해당 값이 대화 상자의 단추 ID와 일치하지 않는 경우 대화 상자의 첫 번째 단추가 기본값이 됩니다.

cRadioButtons

형식: UINT

작업 대화 상자에서 라디오 단추를 만드는 데 사용되는 pRadioButtons 배열의 항목 수입니다.

pRadioButtons

형식: const TASKDIALOG_BUTTON*

작업 대화 상자에 표시할 라디오 단추의 정의를 포함하는 TASKDIALOG_BUTTON 구조체 배열에 대한 포인터입니다. 이 배열에는 cRadioButtons 멤버가 지정한 항목 수가 적어도 포함되어야 합니다. 이 매개 변수는 NULL일 수 있습니다.

nDefaultRadioButton

형식: int

기본적으로 선택된 라디오 단추의 단추 ID입니다. 이 값이 단추 ID에 해당하지 않으면 배열의 첫 번째 단추가 기본적으로 선택됩니다.

pszVerificationText

형식: PCWSTR

확인 확인란에 레이블을 지정하는 데 사용할 문자열을 참조하는 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다. 이 매개 변수가 NULL이면 확인 확인란이 작업 대화 상자에 표시되지 않습니다. TaskDialogIndirect의 pfVerificationFlagChecked 매개 변수가 NULL이면 확인란을 사용할 수 없습니다.

pszExpandedInformation

형식: PCWSTR

추가 정보를 표시하는 데 사용할 문자열을 참조하는 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다. 추가 정보는 TDF_EXPAND_FOOTER_AREA 플래그가 지정되었는지 여부에 따라 콘텐츠 바로 아래 또는 바닥글 텍스트 아래에 표시됩니다. dwFlags 멤버에 대해 TDF_ENABLE_HYPERLINKS 플래그를 지정하면 이 문자열에 HREF="executablestring">Hyperlink Text</A> 형식<의 하이퍼링크가 포함될 수 있습니다. 경고: 안전하지 않은 원본의 콘텐츠를 사용할 때 하이퍼링크를 사용하도록 설정하면 보안 취약성이 발생할 수 있습니다.

pszExpandedControlText

형식: PCWSTR

확장 가능한 정보를 축소하기 위해 단추에 레이블을 지정하는 데 사용할 문자열을 참조하는 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다. pszExpandedInformation 멤버가 NULL인 경우 이 멤버는 무시됩니다. 이 멤버가 NULL 이고 pszCollapsedControlText 가 지정된 경우 pszCollapsedControlText 값도 이 멤버에 사용됩니다.

pszCollapsedControlText

형식: PCWSTR

확장 가능한 정보를 확장하기 위한 단추에 레이블을 지정하는 데 사용할 문자열을 참조하는 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다. pszExpandedInformation 멤버가 NULL인 경우 이 멤버는 무시됩니다. 이 멤버가 NULL 이고 pszCollapsedControlText 가 지정된 경우 pszCollapsedControlText 값도 이 멤버에 사용됩니다.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.hFooterIcon

형식: HICON

작업 대화 상자의 바닥글에 표시할 아이콘에 대한 핸들입니다. TDF_USE_HICON_FOOTER 플래그가 지정되고 pszFooterIcon 이 지정되지 않는 한 이 멤버는 무시됩니다. 이 멤버가 NULL 이고 TDF_USE_HICON_FOOTER 지정되면 아이콘이 표시되지 않습니다.

DUMMYUNIONNAME2.pszFooterIcon

형식: PCWSTR

작업 대화 상자의 바닥글 영역에 표시할 아이콘을 참조하는 포인터입니다. 이 매개 변수는 TDF_USE_HICON_FOOTER 플래그를 지정하거나 pszFooter 가 NULL인 경우 무시됩니다. 그렇지 않으면 이 매개 변수가 NULL 이거나 hInstance 매개 변수가 NULL이면 아이콘이 표시되지 않습니다. 이 매개 변수는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자이거나 pszMainIcon에 대해 나열된 미리 정의된 값 중 하나여야 합니다.

pszFooter

형식: PCWSTR

작업 대화 상자의 바닥글 영역에 사용할 문자열에 대한 포인터입니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다. dwFlags 멤버에 대해 TDF_ENABLE_HYPERLINKS 플래그를 지정하면 이 문자열에 이 형식의 하이퍼링크가 포함될 수 있습니다.

<A HREF="executablestring">Hyperlink Text</A>

경고 안전하지 않은 원본의 콘텐츠를 사용할 때 하이퍼링크를 사용하도록 설정하면 보안 취약성이 발생할 수 있습니다.

pfCallback

형식: PFTASKDIALOGCALLBACK

애플리케이션 정의 콜백 함수에 대한 포인터입니다. 자세한 내용은 TaskDialogCallbackProc을 참조하세요.

lpCallbackData

형식: LONG_PTR

애플리케이션 정의 참조 데이터에 대한 포인터입니다. 이 값은 호출자에 의해 정의됩니다.

cxWidth

형식: UINT

작업 대화 상자의 클라이언트 영역 너비(대화 상자 단위)입니다. 0이면 작업 대화 상자 관리자가 이상적인 너비를 계산합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	commctrl.h

TASKDIALOGCONFIG 구조체(commctrl.h)

구문

멤버

요구 사항

피드백

피드백

추가 리소스