Share via

PropSheet_InsertPage 매크로(prsht.h)

  • 아티클

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

구문

void PropSheet_InsertPage(
   hDlg,
   index,
   hpage
);

매개 변수

hDlg

형식: HWND

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

index

형식: HWND

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

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

hpage

형식: HWND

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

반환 값

없음

설명

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

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

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

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

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

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

요구 사항

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