PropSheet_SetWizButtons 매크로(prsht.h)

PSM_SETWIZBUTTONS 메시지를 게시하여 마법사에서 뒤로, 다음 및 마침 단추를 사용하거나 사용하지 않도록 설정합니다. 이 매크로를 사용하거나 PSM_SETWIZBUTTONS 메시지를 명시적으로 보낼 수 있습니다.

구문

void PropSheet_SetWizButtons(
   hDlg,
   dwFlags
);

매개 변수

hDlg

형식: HWND

속성 시트에 대한 핸들입니다.

dwFlags

형식: DWORD

사용할 마법사 단추를 지정하는 값입니다. 다음 플래그 중 하나 이상을 결합할 수 있습니다.

값	의미
PSWIZB_BACK	뒤로 단추를 사용하도록 설정합니다. 이 플래그를 설정하지 않으면 뒤로 단추가 사용하지 않도록 설정된 것으로 표시됩니다.
PSWIZB_DISABLEDFINISH	비활성화된 마침 단추를 표시합니다.
PSWIZB_FINISH	활성화된 마침 단추를 표시합니다.
PSWIZB_NEXT	다음 단추를 사용하도록 설정합니다. 이 플래그를 설정하지 않으면 다음 단추가 사용하지 않도록 설정된 것으로 표시됩니다.

반환 값

없음

설명

이 매크로는 PostMessage를 사용하여 PSM_SETWIZBUTTONS 메시지를 보냅니다. 알림 처리기가 PropSheet_SetWizButtons 호출하는 경우 처리기가 반환될 때까지 창 포커스에 영향을 주는 작업을 수행하지 않습니다. 예를 들어 PropSheet_SetWizButtons 호출한 직후 MessageBox를 호출하면 메시지 상자에 포커스가 표시됩니다. PostMessage와 함께 보낸 메시지는 메시지 큐의 헤드에 도달할 때까지 배달되지 않으므로 마법사가 메시지 상자에 포커스를 잃을 때까지 PSM_SETWIZBUTTONS 메시지가 배달되지 않습니다. 결과적으로 속성 시트는 단추에 대한 포커스를 제대로 설정할 수 없습니다.

마법사는 각 페이지 아래에 3개 또는 4개의 단추를 표시합니다. 이 메시지는 사용하도록 설정된 단추를 지정하는 데 사용됩니다. 마법사는 일반적으로 뒤로, 취소 및 다음 또는 마침 단추를 표시합니다. 일반적으로 시작 페이지에는 다음 단추, 내부 페이지에는 다음 및 뒤로 단추, 완료 페이지에는 뒤로 및 마침 단추만 사용하도록 설정합니다. 취소 단추는 항상 사용하도록 설정되어 있습니다. 일반적으로 PSWIZB_FINISH 또는 PSWIZB_DISABLEDFINISH를 설정하면 다음 단추가 마침 단추로 바꿔집니다. 다음 및 마침 단추를 동시에 표시하려면 마법사를 만들 때 마법사 PROPSHEETHEADER 구조체의 dwFlags 멤버에서 PSH_WIZARDHASFINISH FLAG를 설정합니다. 그러면 모든 페이지에 네 개의 단추가 모두 표시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	prsht.h