영어로 읽기

다음을 통해 공유


속성 시트

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

개요

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

함수

주제 목차
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 속성 시트 알림 코드에 대한 정보를 포함합니다.