CSnapInPropertyPageImpl Sınıfı

Bu sınıf, ek bileşen özellik sayfası nesnesi uygulamak için yöntemler sağlar.

Önemli

Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.

Sözdizimi

template <class T, bool bAutoDelete = true>
class ATL_NO_VTABLE CSnapInPropertyPageImpl : public CDialogImplBase

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl	Oluşturucu.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CSnapInPropertyPageImpl::CancelToClose	Tamam ve İptal düğmelerinin durumunu değiştirir.
CSnapInPropertyPageImpl::Create	Yeni oluşturulan CSnapInPropertyPageImpl bir nesneyi başlatır.
CSnapInPropertyPageImpl::OnApply	Kullanıcı sihirbaz türü özellik sayfası kullanırken Şimdi Uygula düğmesine tıkladığında çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnHelp	Kullanıcı sihirbaz türü özellik sayfası kullanırken Yardım düğmesine tıkladığında çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnKillActive	Geçerli sayfa artık etkin olmadığında çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnQueryCancel	Kullanıcı İptal düğmesine tıkladığında ve iptal gerçekleşmeden önce çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnReset	Kullanıcı sihirbaz türü özellik sayfası kullanırken Sıfırla düğmesine tıkladığında çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnSetActive	Geçerli sayfa etkin olduğunda çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnWizardBack	Kullanıcı sihirbaz türü özellik sayfası kullanırken Geri düğmesine tıkladığında çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnWizardFinish	Kullanıcı sihirbaz türündeki bir özellik sayfası kullanırken Son düğmesine tıkladığında çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::OnWizardNext	Kullanıcı bir sihirbaz türü özellik sayfası kullanırken İleri düğmesine tıkladığında çerçeve tarafından çağrılır.
CSnapInPropertyPageImpl::QuerySiblings	Geçerli iletiyi özellik sayfasının tüm sayfalarına iletir.
CSnapInPropertyPageImpl::SetModified	Şimdi Uygula düğmesini etkinleştirmek veya devre dışı bırakmak için arayın.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
CSnapInPropertyPageImpl::m_psp	Nesnesi tarafından CSnapInPropertyPageImpl kullanılan Windows PROPSHEETPAGE yapısı.

Açıklamalar

CSnapInPropertyPageImpl ek bileşen özellik sayfası nesnesi için temel bir uygulama sağlar. Ek bileşen özellik sayfasının temel özellikleri birkaç farklı arabirim ve eşleme türü kullanılarak uygulanır.

Devralma Hiyerarşisi

CDialogImplBase

CSnapInPropertyPageImpl

Gereksinimler

Üst bilgi: atlsnap.h

CSnapInPropertyPageImpl::CancelToClose

Kalıcı özellik sayfasının bir sayfasındaki verilerde kurtarılamaz bir değişiklik yapıldıktan sonra bu işlevi çağırın.

void CancelToClose();

Açıklamalar

Bu işlev Tamam düğmesini Kapat olarak değiştirir ve İptal düğmesini devre dışı bırakır. Bu değişiklik, kullanıcıyı bir değişikliğin kalıcı olduğu ve değişikliklerin iptal edilemeyeceği konusunda uyarır.

Modeless CancelToClose özellik sayfasında varsayılan olarak İptal düğmesi olmadığından üye işlevi, modeless özellik sayfasında hiçbir şey yapmaz.

CSnapInPropertyPageImpl::CSnapInPropertyPageImpl

Bir CSnapInPropertyPageImpl nesne oluşturur.

CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);

Parametreler

lpszTitle
[in] Özellik sayfasının başlığı.

Açıklamalar

Temel alınan yapıyı başlatmak için CSnapInPropertyPageImpl::Create öğesini çağırın.

CSnapInPropertyPageImpl::Create

Özellik sayfasının temel yapısını başlatmak için bu işlevi çağırın.

HPROPSHEETPAGE Create();

Dönüş Değeri

Yeni oluşturulan özellik sayfasının özniteliklerini içeren bir PROPSHEETPAGE yapı tanıtıcısı.

Açıklamalar

Bu işlevi çağırmadan önce CSnapInPropertyPageImpl::CSnapInPropertyPageImpl çağrısı yapmalısınız.

CSnapInPropertyPageImpl::m_psp

m_psp üyeleri özelliklerini depolayan bir yapıdır PROPSHEETPAGE.

PROPSHEETPAGE m_psp;

Açıklamalar

Bir özellik sayfası oluşturulurken görünümünü başlatmak için bu yapıyı kullanın.

Üyelerinin listesi de dahil olmak üzere bu yapı hakkında daha fazla bilgi için bkz . Windows SDK'sında PROPSHEETPAGE .

CSnapInPropertyPageImpl::OnApply

Kullanıcı Tamam'a veya Şimdi Uygula düğmesine tıkladığında bu üye işlevi çağrılır.

BOOL OnApply();

Dönüş Değeri

Değişiklikler kabul edilirse sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve tarafından çağrılmadan önce OnApply öğesini çağırmış SetModified ve parametresini TRUE olarak ayarlamış olmanız gerekir. Bu, kullanıcı özellik sayfasında bir değişiklik yapar yapmaz Şimdi Uygula düğmesini etkinleştirir.

Kullanıcı Şimdi Uygula düğmesine tıkladığında programınızın hangi eylemi gerçekleştireceğini belirtmek için bu üye işlevini geçersiz kılın. Geçersiz kılma sırasında işlev değişiklikleri kabul etmek için TRUE, değişikliklerin etkili olmasını önlemek için YANLIŞ döndürmelidir.

varsayılan uygulaması OnApply TRUE döndürür.

CSnapInPropertyPageImpl::OnHelp

Bu üye işlevi, kullanıcı özellik sayfasının Yardım düğmesine tıkladığında çağrılır.

void OnHelp();

Açıklamalar

Özellik sayfasının yardımını görüntülemek için bu üye işlevini geçersiz kılın.

CSnapInPropertyPageImpl::OnKillActive

Bu üye işlevi, sayfa artık etkin sayfa olmadığında çağrılır.

BOOL OnKillActive();

Dönüş Değeri

Veriler başarıyla güncelleştirildiyse sıfır olmayan; aksi takdirde 0.

Açıklamalar

Özel veri doğrulama görevleri gerçekleştirmek için bu üye işlevini geçersiz kılın.

CSnapInPropertyPageImpl::OnQueryCancel

Bu üye işlevi, kullanıcı İptal düğmesine tıkladığında ve iptal eylemi gerçekleşmeden önce çağrılır.

BOOL OnQueryCancel();

Dönüş Değeri

İptal işlemine izin vermek için sıfır olmayan; aksi takdirde 0.

Açıklamalar

Kullanıcı İptal düğmesine tıkladığında program tarafından gerçekleştirilen bir eylemi belirtmek için bu üye işlevini geçersiz kılın.

varsayılan uygulaması OnQueryCancel TRUE döndürür.

CSnapInPropertyPageImpl::OnReset

Kullanıcı İptal düğmesine tıkladığında bu üye işlevi çağrılır.

void OnReset();

Açıklamalar

Bu işlev çağrıldığında, kullanıcı tarafından daha önce Şimdi Uygula düğmesine tıklandığında yapılan tüm özellik sayfalarında yapılan değişiklikler atılır ve özellik sayfası odağı korur.

Kullanıcı İptal düğmesine tıkladığında programın hangi eylemi gerçekleştireceğini belirtmek için bu üye işlevini geçersiz kılın.

CSnapInPropertyPageImpl::OnSetActive

Bu üye işlevi, sayfa kullanıcı tarafından seçildiğinde ve etkin sayfaya dönüştüğünde çağrılır.

BOOL OnSetActive();

Dönüş Değeri

Sayfa başarıyla etkin olarak ayarlandıysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bir sayfa etkinleştirildiğinde görevleri gerçekleştirmek için bu üye işlevini geçersiz kılın. Bu üye işlevini geçersiz kılmanız, diğer işlemler yapılmadan önce varsayılan sürümü çağırmalıdır.

Varsayılan uygulama TRUE döndürür.

CSnapInPropertyPageImpl::OnWizardBack

Kullanıcı sihirbazdaki Geri düğmesine tıkladığında bu üye işlevi çağrılır.

BOOL OnWizardBack();

Dönüş Değeri

• 0 ile otomatik olarak önceki sayfaya ilerleyin.

• Sayfanın değişmesini önlemek için -1.

Sonrakinden başka bir sayfaya atlamak için görüntülenecek iletişim kutusunun tanımlayıcısını döndürebilirsiniz.

Açıklamalar

Geri düğmesine tıklandığında kullanıcının gerçekleştirmesi gereken bazı eylemleri belirtmek için bu üye işlevini geçersiz kılın.

CSnapInPropertyPageImpl::OnWizardFinish

Kullanıcı sihirbazdaki Son düğmesine tıkladığında bu üye işlevi çağrılır.

BOOL OnWizardFinish();

Dönüş Değeri

Sihirbaz tamamlandığında özellik sayfası yok edilirse sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Son düğmesine tıklandığında kullanıcının gerçekleştirmesi gereken bazı eylemleri belirtmek için bu üye işlevini geçersiz kılın.

CSnapInPropertyPageImpl::OnWizardNext

Kullanıcı bir sihirbazda İleri düğmesine tıkladığında bu üye işlevi çağrılır.

BOOL OnWizardNext();

Dönüş Değeri

• bir sonraki sayfaya otomatik olarak ilerlemek için 0.

• Sayfanın değişmesini önlemek için -1.

Sonrakinden başka bir sayfaya atlamak için görüntülenecek iletişim kutusunun tanımlayıcısını döndürebilirsiniz.

Açıklamalar

İleri düğmesine tıklandığında kullanıcının gerçekleştirmesi gereken bazı eylemleri belirtmek için bu üye işlevini geçersiz kılın.

CSnapInPropertyPageImpl::QuerySiblings

Özellik sayfasındaki her sayfaya bir ileti iletmek için bu üye işlevini çağırın.

LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);

Parametreler

wParam
[in] İletiye bağımlı ek bilgileri belirtir.

lParam
[in] İletiye bağımlı ek bilgileri belirtir.

Dönüş Değeri

İletinin sonraki özellik sayfasına iletilmemesi gerekiyorsa sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Sayfa sıfır olmayan bir değer döndürürse, özellik sayfası iletiyi sonraki sayfalara göndermez.

CSnapInPropertyPageImpl::SetModified

Özellik sayfasındaki ayarların uygun dış nesneye uygulanması gerekip gerekmediğine bağlı olarak Şimdi Uygula düğmesini etkinleştirmek veya devre dışı bırakmak için bu üye işlevini çağırın.

void SetModified(BOOL bChanged = TRUE);

Parametreler

bChanged
[in] Özellik sayfası ayarlarının son kez uygulandığından beri değiştirildiğini belirtmek için DOĞRU; Özellik sayfası ayarlarının uygulandığını veya yoksayılması gerektiğini belirtmek için YANLIŞ.

Açıklamalar

Özellik sayfası, hangi sayfaların "kirli" olduğunu, diğer bir ifadeyle çağırdığınız SetModified( TRUE )özellik sayfalarını izler. Sayfalardan birini ararsanız SetModified( TRUE ) Şimdi Uygula düğmesi her zaman etkinleştirilir. Sayfalardan birini aradığınızda SetModified( FALSE ) Şimdi Uygula düğmesi devre dışı bırakılır, ancak yalnızca diğer sayfalardan hiçbiri "kirli" değilse devre dışı bırakılır.

Ayrıca bkz.

Sınıfa Genel Bakış