PSM_INSERTPAGE 메시지
기존 속성 시트에 새 페이지를 삽입합니다. 페이지는 지정된 인덱스 또는 지정된 페이지 뒤에 삽입할 수 있습니다. 이 메시지를 명시적으로 보내거나 PropSheet_InsertPage 매크로를 사용하여 보낼 수 있습니다.
매개 변수
-
wParam
-
페이지를 삽입할 위치입니다. 새 페이지를 첫 번째 페이지로 만들려면 이 매개 변수를 NULL로 설정합니다. 새 페이지를 삽입할 위치를 지정하려면 인덱스 또는 기존 페이지의 HPROPSHEETPAGE 핸들을 전달할 수 있습니다.
값 의미 - 인덱스
wParam 매개 변수가 MAXUSSHORT(부호 없는 가장 큰 짧은 정수)보다 작은 경우 wParam은 새 페이지에 대해 인덱스(0부터 시작)를 지정합니다. 예를 들어, 삽입된 페이지를 속성 시트의 세 번째 페이지로 만들려면 wParam을 2로 설정합니다. 첫 번째 페이지로 만들려면 wParam을 0으로 설정합니다. wParam의 값이 페이지 수보다 크고 MAXUSSHORT보다 작은 경우 페이지가 추가됩니다. - hpageInsertAfter
wParam 매개 변수를 기존 페이지의 HPROPSHEETPAGE 핸들로 설정하면 새 페이지가 그 뒤에 삽입됩니다. -
lParam
-
삽입할 페이지에 대한 핸들입니다. 먼저 CreatePropertySheetPage 함수를 호출하여 페이지를 만들어야 합니다.
반환 값
페이지가 성공적으로 삽입된 경우 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.
설명
삽입 지점 뒤의 페이지는 새 페이지를 수용하기 위해 오른쪽으로 이동합니다.
속성 시트는 새 페이지에 맞게 크기가 조정되지 않습니다. 새 페이지를 속성 시트의 가장 큰 페이지보다 크게 만들지 마세요.
속성 시트가 페이지 목록을 조작하는 동안 여러 메시지와 하나의 함수 호출이 발생합니다. 이 작업이 수행되는 동안 페이지 목록을 수정하려고 하면 예측할 수 없는 결과가 발생합니다. 따라서 PropSheetPageProc 구현에서 또는 다음 알림 및 Windows 메시지를 처리하는 동안 PSM_INSERTPAGE 메시지를 사용하면 안 됩니다.
이러한 메시지 중 하나를 처리하는 동안 또는 PropSheetPageProc가 작동하는 동안 속성 시트 페이지를 수정해야 하는 경우 프라이빗 Windows 메시지를 게시합니다. 애플리케이션은 속성 시트 관리자가 작업을 완료할 때까지 해당 메시지를 수신하지 않습니다. 그런 다음 페이지 목록을 수정할 수 있습니다.
다음 알림도 속성 시트 수정의 영향을 받습니다.
원하는 새 페이지를 지정하기 위해(DWL_MSGRESULT를 통해) 0이 아닌 값을 반환하는 경우 이러한 알림에 대한 응답으로 페이지를 추가하거나 제거할 수 있습니다. 그러나 현재 페이지보다 인덱스가 작은 페이지를 현재 페이지보다 앞에 있는 페이지를 삽입하면 PSN_KILLACTIVE가 잘못된 페이지로 전송될 수 있습니다.
참고
이 메시지는 Aero 마법사 스타일(PSH_AEROWIZARD)을 사용할 때 지원되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|