다음을 통해 공유


PropSheet_AddPage 매크로(prsht.h)

기존 속성 시트의 끝에 새 페이지를 추가합니다. 이 매크로를 사용하거나 PSM_ADDPAGE 메시지를 명시적으로 보낼 수 있습니다.

통사론

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

매개 변수

hDlg

형식: HWND

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

hpage

형식: HPROPSHEETPAGE

추가할 페이지에 대한 핸들입니다. 이 페이지는 CreatePropertySheetPage 함수에 대한 이전 호출에 의해 만들어졌어야 합니다.

반환 값

형식: BOOL

성공하면 TRUE 반환하거나, 그렇지 않으면 FALSE .

발언

속성 시트의 크기가 새 페이지에 맞게 조정되지 않으므로 새 페이지는 현재 속성 시트에서 가장 큰 페이지보다 크지 않아야 합니다.

속성 시트가 페이지 목록을 조작하는 동안 여러 메시지와 하나의 함수 호출이 발생합니다. 이 작업이 진행되는 동안 페이지 목록을 수정하려고 하면 예측할 수 없는 결과가 발생합니다. 따라서 PropSheetPageProc 구현하거나 다음 알림 및 Microsoft Windows 메시지를 처리하는 동안에는 PropSheet_AddPage 매크로를 사용하면 안 됩니다.

이러한 메시지 중 하나를 처리하는 동안 또는 propSheetPageProc 작업 중인 동안 속성 시트 페이지를 수정해야 하는 경우 개인 Windows 메시지를 게시합니다. 속성 시트 관리자가 작업을 완료할 때까지 애플리케이션에서 해당 메시지를 수신하지 않습니다. 그런 다음 페이지 목록을 수정할 수 있습니다.

요구 사항

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