속성 시트

이 섹션에는 속성 시트와 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다.

개요

항목 콘텐츠
속성 시트 정보 속성 시트는 사용자가 항목의 속성을 보고 편집할 수 있는 창입니다.
마법사 만들기 마법사는 프로시저를 통해 사용자를 안내하는 간단하고 강력한 방법을 제공하는 속성 시트 형식입니다.
속성 시트 사용 이 섹션에서는 속성 시트를 사용하기 위한 구현 세부 정보 및 예제 코드를 제공합니다.

Functions

항목 콘텐츠
AddPropSheetPageProc 속성 시트 확장에서 속성 시트에 페이지를 추가하는 데 사용하는 애플리케이션 정의 콜백 함수를 지정합니다.
CreatePropertySheetPage 속성 시트에 대한 새 페이지를 만듭니다.
DestroyPropertySheetPage 속성 시트 페이지를 삭제합니다. 애플리케이션에서 PropertySheet 함수에 전달되지 않은 페이지에 대해 이 함수를 호출해야 합니다.
PropertySheet 속성 시트를 만들고 지정된 속성 시트 헤더 구조체에 정의된 페이지를 추가합니다.
PropSheetPageProc 페이지를 만들 때와 페이지를 제거하려고 할 때 속성 시트에서 호출하는 애플리케이션 정의 콜백 함수를 지정합니다. 애플리케이션은 이 함수를 사용하여 페이지에 대한 초기화 및 정리 작업을 수행할 수 있습니다.
PropSheetProc 속성 시트를 만들고 초기화할 때 시스템에서 호출하는 애플리케이션 정의 콜백 함수입니다.

메시지

항목 콘텐츠
PSM_ADDPAGE 기존 속성 시트의 끝에 새 페이지를 추가합니다. 이 메시지를 명시적으로 보내거나 PropSheet_AddPage 매크로를 사용하여 보낼 수 있습니다.
PSM_APPLY 하나 이상의 페이지가 변경되었으며 변경 내용의 유효성을 검사하고 기록해야 함을 나타내는 적용 단추의 선택을 시뮬레이션합니다.
PSM_CANCELTOCLOSE 취소할 수 없는 최근 PSN_APPLY 알림 이후 변경이 수행된 경우 애플리케이션에서 보냅니다. 이 메시지를 명시적으로 보내거나 PropSheet_CancelToClose 매크로를 사용하여 보낼 수 있습니다.
PSM_CHANGED 페이지의 정보가 변경되었음을 속성 시트에 알립니다. 이 메시지를 명시적으로 보내거나 PropSheet_Changed 매크로를 사용하여 보낼 수 있습니다.
PSM_ENABLEWIZBUTTONS Aero 마법사에서 표준 단추를 사용하거나 사용하지 않도록 설정합니다. 이 메시지를 명시적으로 보내거나 PropSheet_EnableWizButtons 매크로를 사용할 수 있습니다.
PSM_GETCURRENTPAGEHWND 속성 시트의 현재 페이지 창에 대한 핸들을 검색합니다. 이 메시지를 명시적으로 보내거나 PropSheet_GetCurrentPageHwnd 매크로를 사용하여 보낼 수 있습니다.
PSM_GETRESULT PropertySheet에 의해 모달 속성 시트에 반환된 정보를 검색하기 위해 모덜리스 속성 시트에서 사용됩니다. 이 메시지를 명시적으로 보내거나 PropSheet_GetResult 매크로를 사용할 수 있습니다.
PSM_GETTABCONTROL 속성 시트의 탭 컨트롤에 대한 핸들을 검색합니다. 이 메시지를 명시적으로 보내거나 PropSheet_GetTabControl 매크로를 사용하여 보낼 수 있습니다.
PSM_HWNDTOINDEX 속성 시트 페이지의 창 핸들을 가져와서 인덱스(0부터 시작)를 반환합니다. 이 메시지를 명시적으로 보내거나 PropSheet_HwndToIndex 매크로를 사용할 수 있습니다.
PSM_IDTOINDEX 속성 시트 페이지의 리소스 ID를 가져와서 인덱스(0부터 시작)를 반환합니다. 이 메시지를 명시적으로 보내거나 PropSheet_IdToIndex 매크로를 사용할 수 있습니다.
PSM_INDEXTOHWND 속성 시트 페이지의 인덱스를 가져와서 해당 창 핸들을 반환합니다. 이 메시지를 명시적으로 보내거나, PropSheet_IndexToHwnd 매크로를 사용할 수 있습니다.
PSM_INDEXTOID 속성 시트 페이지의 인덱스를 가져와서 해당 리소스 ID를 반환합니다. 이 메시지를 명시적으로 보내거나, PropSheet_IndexToId 매크로를 사용할 수 있습니다.
PSM_INDEXTOPAGE 속성 시트 페이지의 인덱스를 가져오고 해당 HPROPSHEETPAGE 핸들을 반환합니다. 이 메시지를 명시적으로 보내거나 PropSheet_IndexToPage 매크로를 사용할 수 있습니다.
PSM_INSERTPAGE 기존 속성 시트에 새 페이지를 삽입합니다. 페이지는 지정된 인덱스 또는 지정된 페이지 뒤에 삽입할 수 있습니다. 이 메시지를 명시적으로 보내거나 PropSheet_InsertPage 매크로를 사용하여 보낼 수 있습니다.
PSM_ISDIALOGMESSAGE 속성 시트 대화 상자에 메시지를 전달하고 대화 상자에서 메시지를 처리했는지 여부를 나타냅니다. 이 메시지를 명시적으로 보내거나 PropSheet_IsDialogMessage 매크로를 사용하여 보낼 수 있습니다.
PSM_PAGETOINDEX 속성 시트 페이지의 HPROPSHEETPAGE 핸들을 가져와서 인덱스(0부터 시작)를 반환합니다. 이 메시지를 명시적으로 보내거나 PropSheet_PageToIndex 매크로를 사용할 수 있습니다.
PSM_PRESSBUTTON 속성 시트 단추의 선택을 시뮬레이션합니다. 이 메시지를 명시적으로 보내거나, PropSheet_PressButton 매크로를 사용하여 보낼 수 있습니다.
PSM_QUERYSIBLINGS 속성 시트로 보낸 다음 각 페이지로 메시지를 전달합니다. 이 메시지를 명시적으로 보내거나 PropSheet_QuerySiblings 매크로를 사용하여 보낼 수 있습니다.
PSM_REBOOTSYSTEM 변경 내용을 적용하려면 시스템을 다시 시작해야 함을 나타냅니다. 명시적으로 또는 PropSheet_RebootSystem 매크로를 사용하여 PSM_REBOOTSYSTEM 메시지를 보낼 수 있습니다.
PSM_RECALCPAGESIZES 페이지가 추가되거나 제거된 후 표준 또는 마법사 속성 시트의 페이지 크기를 다시 계산합니다. 이 메시지를 명시적으로 보내거나 PropSheet_RecalcPageSizes 매크로를 사용할 수 있습니다.
PSM_REMOVEPAGE 속성 시트에서 페이지를 제거합니다. 이 메시지를 명시적으로 보내거나 PropSheet_RemovePage 매크로를 사용하여 보낼 수 있습니다.
PSM_RESTARTWINDOWS 변경 내용을 적용하려면 Windows를 다시 시작해야 함을 나타냅니다.
PSM_SETBUTTONTEXT Aero 마법사에서 단추의 텍스트를 설정합니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetButtonText 매크로를 사용하여 보낼 수 있습니다.
PSM_SETCURSEL 속성 시트에서 지정된 페이지를 활성화합니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetCurSel 매크로를 사용하여 보낼 수 있습니다.
PSM_SETCURSELID 페이지의 리소스 식별자를 기반으로 속성 시트에서 지정된 페이지를 활성화합니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetCurSelByID 매크로를 사용하여 보낼 수 있습니다.
PSM_SETFINISHTEXT 마법사에서 마침 단추의 텍스트를 설정하고, 이 단추를 표시하고 사용하도록 설정하며, 다음뒤로 단추를 숨깁니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetFinishText 매크로를 사용하여 보낼 수 있습니다.
PSM_SETHEADERBITMAP 이 메시지는 구현되지 않았습니다.
PSM_SETHEADERBITMAPRESOURCE 이 메시지는 구현되지 않았습니다.
PSM_SETHEADERSUBTITLE 마법사 내부 페이지의 헤더에 대한 부제 텍스트를 설정합니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetHeaderSubTitle 매크로를 사용할 수 있습니다.
PSM_SETHEADERTITLE 마법사 내부 페이지의 헤더에 대한 제목 텍스트를 설정합니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetHeaderTitle 매크로를 사용할 수 있습니다.
PSM_SETNEXTTEXT 마법사에서 다음 단추의 텍스트를 설정합니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetNextText 매크로를 사용하여 보낼 수 있습니다.
PSM_SETTITLE 속성 시트의 제목을 설정합니다. 이 메시지를 명시적으로 보내거나 PropSheet_SetTitle 매크로를 사용하여 보낼 수 있습니다.
PSM_SETWIZBUTTONS 마법사에서 뒤로, 다음마침 단추를 사용하거나 사용하지 않도록 설정합니다. PropSheet_SetWizButtons 매크로를 사용하여 메시지를 게시할 수도 있습니다.
PSM_SHOWWIZBUTTONS 마법사에서 단추를 표시하거나 숨깁니다. 이 메시지를 명시적으로 보내거나 PropSheet_ShowWizButtons 매크로를 사용하여 보낼 수 있습니다.
PSM_UNCHANGED 페이지의 정보가 이전에 저장된 상태로 되돌아갔음을 속성 시트에 알립니다. 이 메시지를 명시적으로 보내거나 PropSheet_UnChanged 매크로를 사용하여 보낼 수 있습니다.

알림

항목 콘텐츠
PSN_APPLY 속성 시트의 모든 페이지에 전송되어 사용자가 확인, 닫기 또는 적용 단추를 클릭했으며 모든 변경 내용을 적용하기를 원함을 나타냅니다. 이 알림은 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_GETOBJECT 커서가 탭 컨트롤의 단추 중 하나를 지나갈 때 놓기 대상 개체를 요청하기 위해 속성 시트에서 전송됩니다.
PSN_HELP 사용자가 도움말 단추를 클릭했음을 페이지에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_KILLACTIVE 다른 페이지가 활성화 중이거나 사용자가 확인 단추를 클릭했기 때문에 활성화가 손실될 예정임을 페이지에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_QUERYCANCEL 사용자가 속성 시트를 취소했음을 나타냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_QUERYINITIALFOCUS 초기 포커스를 받아야 하는 대화 상자 컨트롤을 지정할 수 있는 기회를 속성 시트 페이지에 제공하기 위해 속성 시트에서 보냅니다. 이 알림은 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_RESET 속성 시트가 제거될 예정임을 페이지에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_SETACTIVE 활성화될 예정임을 페이지에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_TRANSLATEACCELERATOR 키보드 메시지가 수신되었음을 속성 시트에 알립니다. 페이지에 프라이빗 키보드 가속기 번역을 수행할 수 있는 기회를 제공합니다. 이 알림은 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_WIZBACK 마법사에서 사용자가 뒤로 단추를 클릭했음을 페이지에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_WIZFINISH 마법사에서 사용자가 마침 단추를 클릭했음을 페이지에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
PSN_WIZNEXT 마법사에서 사용자가 다음 단추를 클릭했음을 페이지에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.

구조체

항목 콘텐츠
PROPSHEETHEADER 속성 시트의 프레임과 페이지를 정의합니다.
PROPSHEETPAGE 속성 시트의 페이지를 정의합니다.
PSHNOTIFY 속성 시트 알림 코드에 대한 정보를 포함합니다.