다음을 통해 공유

PropSheet_InsertPage 매크로(prsht.h)

  • 아티클

기존 속성 시트에 새 페이지를 삽입합니다. 지정된 인덱스 또는 지정된 페이지 뒤에 페이지를 삽입할 수 있습니다. 이 매크로를 사용하거나 PSM_INSERTPAGE 메시지를 명시적으로 보낼 수 있습니다.

통사론

BOOL PropSheet_InsertPage(
   HWND hDlg,
   HWND index,
   HWND hpage
);

매개 변수

hDlg

형식: HWND

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

index

형식: HWND

페이지를 삽입할 위치입니다. 인덱스 NULL 설정하여 새 페이지를 첫 번째 페이지로 만듭니다. 새 페이지를 삽입할 위치를 지정하려면 인덱스 또는 기존 페이지의 HPROPSHEETPAGE 핸들을 전달할 수 있습니다.

값 의미
인덱스
인덱스 MAXUSHORT(부호 없는 가장 큰 짧은 정수)보다 작으면 새 페이지의 인덱스(0부터 시작)를 지정합니다. 예를 들어 삽입된 페이지를 속성 시트의 세 번째 페이지로 만들려면 인덱스 2로 설정합니다. 첫 번째 페이지로 만들려면 인덱스 0으로 설정합니다. 인덱스 페이지 수보다 크고 MAXUSHORT보다 작은 값이 있으면 페이지가 추가됩니다.
hpageInsertAfter
인덱스 기존 페이지의 HPROPSHEETPAGE 핸들로 설정하면 새 페이지가 삽입됩니다.

hpage

형식: HWND

삽입할 페이지에 대한 핸들입니다. 먼저 CreatePropertySheetPage 함수를 호출하여 페이지를 만들어야 합니다.

반환 값

형식: BOOL

페이지가 성공적으로 삽입된 경우 0이 아닌 값을 반환하고, 그렇지 않으면 0을 반환합니다.

발언

삽입 지점 뒤의 페이지가 새 페이지를 수용하기 위해 오른쪽으로 이동합니다.

속성 시트의 크기가 새 페이지에 맞게 조정되지 않습니다. 새 페이지를 속성 시트의 가장 큰 페이지보다 크게 만들지 마세요.

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

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

다음 알림은 속성 시트 수정의 영향을 받습니다.

원하는 새 페이지를 지정하기 위해 0이 아닌 값을 반환하는 경우(DWL_MSGRESULT 통해) 이러한 알림에 대한 응답으로 페이지를 추가하거나 제거할 수 있습니다. 그러나 현재 페이지 앞에 있는 페이지(현재 페이지보다 작은 인덱스가 있음)를 삽입하면 PSN_KILLACTIVE 잘못된 페이지로 전송될 수 있습니다.
참고 이 매크로는 Aero 마법사 스타일(PSH_AEROWIZARD)을 사용할 때 지원되지 않습니다.
 

요구 사항

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