CSnapInPropertyPageImpl 클래스
이 클래스는 스냅인 속성 페이지 개체를 구현하기 위한 메서드를 제공합니다.
Important
이 클래스와 해당 멤버는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다.
구문
CSnapInPropertyPageImpl : public CDialogImplBase
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CSnapInPropertyPageImpl::CSnapInPropertyPageImpl | 생성자입니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CSnapInPropertyPageImpl::CancelToClose | 확인 및 취소 단추의 상태를 변경합니다. |
| CSnapInPropertyPageImpl::Create | 새로 만든 CSnapInPropertyPageImpl 개체를 초기화합니다. |
| CSnapInPropertyPageImpl::OnApply | 마법사 유형 속성 시트를 사용하는 동안 사용자가 지금 적용 단추를 클릭할 때 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnHelp | 사용자가 마법사 유형 속성 시트를 사용하는 동안 도움말 단추를 클릭할 때 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnKillActive | 현재 페이지가 더 이상 활성화되지 않은 경우 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnQueryCancel | 사용자가 취소 단추를 클릭하고 취소가 발생하기 전에 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnReset | 마법사 유형 속성 시트를 사용하는 동안 사용자가 다시 설정 단추를 클릭할 때 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnSetActive | 현재 페이지가 활성화될 때 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnWizardBack | 사용자가 마법사 유형 속성 시트를 사용하는 동안 뒤로 단추를 클릭할 때 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnWizardFinish | 마법사 유형 속성 시트를 사용하는 동안 사용자가 마침 단추를 클릭할 때 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::OnWizardNext | 마법사 유형 속성 시트를 사용하는 동안 사용자가 다음 단추를 클릭할 때 프레임워크에서 호출됩니다. |
| CSnapInPropertyPageImpl::QuerySiblings | 현재 메시지를 속성 시트의 모든 페이지로 전달합니다. |
| CSnapInPropertyPageImpl::SetModified | 지금 적용 단추를 활성화하거나 비활성화하기 위해 호출합니다. |
공용 데이터 멤버
| 속성 | 설명 |
|---|---|
| CSnapInPropertyPageImpl::m_psp | 개체에서 사용하는 Windows PROPSHEETPAGE 구조체입니다 CSnapInPropertyPageImpl . |
설명
CSnapInPropertyPageImpl 는 스냅인 속성 페이지 개체에 대한 기본 구현을 제공합니다. 스냅인 속성 페이지의 기본 기능은 여러 인터페이스 및 맵 형식을 사용하여 구현됩니다.
상속 계층 구조
CDialogImplBase
CSnapInPropertyPageImpl
요구 사항
헤더: atlsnap.h
CSnapInPropertyPageImpl::CancelToClose
모달 속성 시트 페이지의 데이터를 복구할 수 없는 변경이 수행된 후 이 함수를 호출합니다.
void CancelToClose();
설명
이 함수는 확인 단추를 닫도록 변경하고 취소 단추를 사용하지 않도록 설정합니다. 이 변경은 사용자에게 변경 내용이 영구적이며 수정을 취소할 수 없음을 경고합니다.
모덜리스 속성 시트에는 CancelToClose 기본적으로 취소 단추가 없으므로 멤버 함수는 모덜리스 속성 시트에서 아무 작업도 수행하지 않습니다.
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl
CSnapInPropertyPageImpl 개체를 생성합니다.
CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);
매개 변수
lpszTitle
[in] 속성 페이지의 제목입니다.
설명
기본 구조를 초기화하려면 CSnapInPropertyPageImpl::Create를 호출 합니다.
CSnapInPropertyPageImpl::Create
이 함수를 호출하여 속성 페이지의 기본 구조를 초기화합니다.
HPROPSHEETPAGE Create();
Return Value
새로 만든 속성 시트의 특성을 포함하는 구조체에 대한 핸들 PROPSHEETPAGE 입니다.
설명
이 함수를 호출하기 전에 먼저 CSnapInPropertyPageImpl::CSnapInPropertyPageImpl을 호출해야 합니다.
CSnapInPropertyPageImpl::m_psp
m_psp 는 멤버가 .의 특성을 저장하는 구조체입니다 PROPSHEETPAGE.
PROPSHEETPAGE m_psp;
설명
이 구조를 사용하여 속성 페이지가 생성된 후의 모양을 초기화합니다.
멤버 목록을 포함하여 이 구조에 대한 자세한 내용은 Windows SDK의 PROPSHEETPAGE를 참조하세요.
CSnapInPropertyPageImpl::OnApply
이 멤버 함수는 사용자가 확인 또는 지금 적용 단추를 클릭할 때 호출됩니다.
BOOL OnApply();
Return Value
변경 내용이 허용되는 경우 0이 아닌 경우 그렇지 않으면 0입니다.
설명
프레임워크에서 호출하려면 먼저 OnApply 해당 매개 변수를 호출 SetModified 하고 TRUE로 설정해야 합니다. 그러면 사용자가 속성 페이지를 변경하는 즉시 지금 적용 단추가 활성화됩니다.
이 멤버 함수를 재정의하여 사용자가 지금 적용 단추를 클릭할 때 프로그램에서 수행하는 작업을 지정합니다. 재정의할 때 함수는 변경 내용을 수락하려면 TRUE를 반환하고 변경 내용이 적용되지 않도록 FALSE를 반환해야 합니다.
반환 TRUE의 OnApply 기본 구현입니다.
CSnapInPropertyPageImpl::OnHelp
이 멤버 함수는 사용자가 속성 페이지의 도움말 단추를 클릭할 때 호출됩니다.
void OnHelp();
설명
속성 페이지에 대한 도움말을 표시하려면 이 멤버 함수를 재정의합니다.
CSnapInPropertyPageImpl::OnKillActive
이 멤버 함수는 페이지가 더 이상 활성 페이지가 아니어도 호출됩니다.
BOOL OnKillActive();
Return Value
데이터가 성공적으로 업데이트된 경우 0이 아닌 경우 그렇지 않으면 0입니다.
설명
특수 데이터 유효성 검사 작업을 수행하려면 이 멤버 함수를 재정의합니다.
CSnapInPropertyPageImpl::OnQueryCancel
이 멤버 함수는 사용자가 취소 단추를 클릭하고 취소 작업이 수행되기 전에 호출됩니다.
BOOL OnQueryCancel();
Return Value
취소 작업을 허용하는 0이 아닌 경우 그렇지 않으면 0입니다.
설명
이 멤버 함수를 재정의하여 사용자가 취소 단추를 클릭할 때 프로그램에서 수행하는 작업을 지정합니다.
반환 TRUE의 OnQueryCancel 기본 구현입니다.
CSnapInPropertyPageImpl::OnReset
이 멤버 함수는 사용자가 취소 단추를 클릭할 때 호출됩니다.
void OnReset();
설명
이 함수가 호출되면 사용자가 이전에 [지금 적용] 단추를 클릭했을 때 변경한 모든 속성 페이지가 삭제되고 속성 시트에 포커스가 유지됩니다.
이 멤버 함수를 재정의하여 사용자가 취소 단추를 클릭할 때 프로그램에서 수행하는 작업을 지정합니다.
CSnapInPropertyPageImpl::OnSetActive
이 멤버 함수는 사용자가 페이지를 선택하고 활성 페이지가 될 때 호출됩니다.
BOOL OnSetActive();
Return Value
페이지가 활성으로 설정된 경우 0이 아닌 경우 그렇지 않으면 0입니다.
설명
페이지가 활성화될 때 작업을 수행하도록 이 멤버 함수를 재정의합니다. 이 멤버 함수의 재정의는 다른 처리가 완료되기 전에 기본 버전을 호출해야 합니다.
기본 구현은 TRUE를 반환합니다.
CSnapInPropertyPageImpl::OnWizardBack
이 멤버 함수는 사용자가 마법사에서 뒤로 단추를 클릭할 때 호출됩니다.
BOOL OnWizardBack();
Return Value
이전 페이지로 자동 이동하려면 0입니다.
페이지가 변경되지 않도록 하려면 -1입니다.
다음 페이지가 아닌 다른 페이지로 이동하려면 표시할 대화 상자의 식별자를 반환합니다.
설명
뒤로 단추를 클릭할 때 사용자가 수행해야 하는 작업을 지정하려면 이 멤버 함수를 재정의합니다.
CSnapInPropertyPageImpl::OnWizardFinish
이 멤버 함수는 사용자가 마법사에서 마침 단추를 클릭할 때 호출됩니다.
BOOL OnWizardFinish();
Return Value
마법사가 완료될 때 속성 시트가 제거되면 0이 아닙니다. 그렇지 않으면 0입니다.
설명
마침 단추를 클릭할 때 사용자가 수행해야 하는 작업을 지정하려면 이 멤버 함수를 재정의합니다.
CSnapInPropertyPageImpl::OnWizardNext
이 멤버 함수는 사용자가 마법사에서 다음 단추를 클릭할 때 호출됩니다.
BOOL OnWizardNext();
Return Value
자동으로 다음 페이지로 이동하려면 0입니다.
페이지가 변경되지 않도록 하려면 -1입니다.
다음 페이지가 아닌 다른 페이지로 이동하려면 표시할 대화 상자의 식별자를 반환합니다.
설명
다음 단추를 클릭할 때 사용자가 수행해야 하는 작업을 지정하려면 이 멤버 함수를 재정의합니다.
CSnapInPropertyPageImpl::QuerySiblings
이 멤버 함수를 호출하여 속성 시트의 각 페이지에 메시지를 전달합니다.
LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);
매개 변수
wParam
[in] 추가 메시지 종속 정보를 지정합니다.
lParam
[in] 추가 메시지 종속 정보를 지정합니다.
Return Value
메시지를 다음 속성 페이지로 전달해서는 안 되는 경우 0이 아닙니다. 그렇지 않으면 0입니다.
설명
페이지가 0이 아닌 값을 반환하는 경우 속성 시트는 메시지를 후속 페이지로 보내지 않습니다.
CSnapInPropertyPageImpl::SetModified
속성 페이지의 설정을 적절한 외부 개체에 적용해야 하는지 여부에 따라 지금 적용 단추를 사용하거나 사용하지 않도록 설정하려면 이 멤버 함수를 호출합니다.
void SetModified(BOOL bChanged = TRUE);
매개 변수
bChanged
[in] 속성 페이지 설정이 마지막으로 적용된 이후 수정되었음을 나타내려면 TRUE입니다. 속성 페이지 설정이 적용되었거나 무시되어야 함을 나타내는 FALSE입니다.
설명
속성 시트는 "더티", 즉 호출 SetModified( TRUE )한 속성 페이지를 추적합니다. 페이지 중 하나를 호출 SetModified( TRUE ) 하는 경우 지금 적용 단추가 항상 사용하도록 설정됩니다. 지금 적용 단추는 페이지 중 하나를 호출 SetModified( FALSE ) 할 때 비활성화되지만 다른 페이지가 "더티"가 아닌 경우에만 사용할 수 없습니다.