Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Opmerking
De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Deze klasse biedt methoden voor het implementeren van een modulepaginaobject voor eigenschappen.
Belangrijk
Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.
Syntaxis
template <class T, bool bAutoDelete = true>
class ATL_NO_VTABLE CSnapInPropertyPageImpl : public CDialogImplBase
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CSnapInPropertyPageImpl::CSnapInPropertyPageImpl | Bouwer. |
Openbare methoden
| Naam | Description |
|---|---|
| CSnapInPropertyPageImpl::CancelToClose | Hiermee wijzigt u de status van de knoppen OK en Annuleren . |
| CSnapInPropertyPageImpl::Create | Initialiseert een nieuw gemaakt CSnapInPropertyPageImpl object. |
| CSnapInPropertyPageImpl::OnApply | Wordt aangeroepen door het framework wanneer de gebruiker op de knop Nu toepassen klikt terwijl u een eigenschappenvenster van het wizardtype gebruikt. |
| CSnapInPropertyPageImpl::OnHelp | Wordt aangeroepen door het framework wanneer de gebruiker op de knop Help klikt terwijl u een eigenschappenvenster van het wizardtype gebruikt. |
| CSnapInPropertyPageImpl::OnKillActive | Aangeroepen door het framework wanneer de huidige pagina niet meer actief is. |
| CSnapInPropertyPageImpl::OnQueryCancel | Wordt door het framework aangeroepen wanneer de gebruiker op de knop Annuleren klikt en voordat de annulering heeft plaatsgevonden. |
| CSnapInPropertyPageImpl::OnReset | Aangeroepen door het framework wanneer de gebruiker op de knop Opnieuw instellen klikt terwijl een eigenschappenvenster van het wizardtype wordt gebruikt. |
| CSnapInPropertyPageImpl::OnSetActive | Aangeroepen door het framework wanneer de huidige pagina actief wordt. |
| CSnapInPropertyPageImpl::OnWizardBack | Aangeroepen door het framework wanneer de gebruiker op de knop Vorige klikt terwijl een eigenschappenvenster van het wizardtype wordt gebruikt. |
| CSnapInPropertyPageImpl::OnWizardFinish | Aangeroepen door het framework wanneer de gebruiker op de knop Voltooien klikt terwijl een eigenschappenvenster van het wizardtype wordt gebruikt. |
| CSnapInPropertyPageImpl::OnWizardNext | Aangeroepen door het framework wanneer de gebruiker op de knop Volgende klikt terwijl u een eigenschappenvenster van het wizardtype gebruikt. |
| CSnapInPropertyPageImpl::QuerySiblings | Stuurt het huidige bericht door naar alle pagina's van het eigenschappenvenster. |
| CSnapInPropertyPageImpl::SetModified | Oproep om de knop Nu toepassen te activeren of deactiveren. |
Publieke dataleden
| Naam | Description |
|---|---|
| CSnapInPropertyPageImpl::m_psp | De Windows-structuur PROPSHEETPAGE die door het CSnapInPropertyPageImpl object wordt gebruikt. |
Opmerkingen
CSnapInPropertyPageImpl biedt een eenvoudige implementatie voor een eigenschapspaginaobject van een module. De basisfuncties van een module-eigenschappenpagina worden geïmplementeerd met behulp van verschillende interfaces en kaarttypen.
Overnamehiërarchie
CDialogImplBase
CSnapInPropertyPageImpl
Requirements
Koptekst: atlsnap.h
CSnapInPropertyPageImpl::CancelToClose
Roep deze functie aan nadat een onherstelbare wijziging is aangebracht in de gegevens op een pagina van een modaal eigenschappenvenster.
void CancelToClose();
Opmerkingen
Met deze functie wordt de knop OK gewijzigd om de knop Annuleren te sluiten en uit te schakelen. Deze wijziging waarschuwt de gebruiker dat een wijziging permanent is en de wijzigingen niet kunnen worden geannuleerd.
De CancelToClose lidfunctie doet niets in een eigenschappenvenster zonder modus, omdat een eigenschappenvenster zonder modus standaard geen knop Annuleren heeft.
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl
Maakt een CSnapInPropertyPageImpl-object.
CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);
Parameterwaarden
lpszTitle
[in] De titel van de eigenschappenpagina.
Opmerkingen
Als u de onderliggende structuur wilt initialiseren, roept u CSnapInPropertyPageImpl::Create aan.
CSnapInPropertyPageImpl::Create
Roep deze functie aan om de onderliggende structuur van de eigenschappenpagina te initialiseren.
HPROPSHEETPAGE Create();
Retourwaarde
Een ingang naar een PROPSHEETPAGE structuur met de kenmerken van het zojuist gemaakte eigenschappenvenster.
Opmerkingen
U moet eerst CSnapInPropertyPageImpl::CSnapInPropertyPageImpl aanroepen voordat u deze functie aanroept.
CSnapInPropertyPageImpl::m_psp
m_psp is een structuur waarvan leden de kenmerken van PROPSHEETPAGE.
PROPSHEETPAGE m_psp;
Opmerkingen
Gebruik deze structuur om het uiterlijk van een eigenschappenpagina te initialiseren nadat deze is gemaakt.
Zie PROPSHEETPAGE in de Windows SDK voor meer informatie over deze structuur, inclusief een lijst met leden.
CSnapInPropertyPageImpl::OnApply
Deze lidfunctie wordt aangeroepen wanneer de gebruiker op ok of de knop Nu toepassen klikt.
BOOL OnApply();
Retourwaarde
Niet-nul als de wijzigingen worden geaccepteerd; anders 0.
Opmerkingen
Voordat OnApply u door het framework kunt worden aangeroepen, moet u de parameter ervan hebben aangeroepen SetModified en instellen op TRUE. Hiermee wordt de knop Nu toepassen geactiveerd zodra de gebruiker een wijziging aanbrengt op de eigenschappenpagina.
Overschrijf deze lidfunctie om op te geven welke actie uw programma uitvoert wanneer de gebruiker op de knop Nu toepassen klikt. Bij het overschrijven moet de functie TRUE retourneren om wijzigingen te accepteren en ONWAAR om te voorkomen dat wijzigingen van kracht worden.
De standaard implementatie van OnApply retourneert TRUE.
CSnapInPropertyPageImpl::OnHelp
Deze lidfunctie wordt aangeroepen wanneer de gebruiker op de knop Help voor de eigenschappenpagina klikt.
void OnHelp();
Opmerkingen
Overschrijf deze lidfunctie om help voor de eigenschappenpagina weer te geven.
CSnapInPropertyPageImpl::OnKillActive
Deze lidfunctie wordt aangeroepen wanneer de pagina niet langer de actieve pagina is.
BOOL OnKillActive();
Retourwaarde
Niet-nul als de gegevens zijn bijgewerkt; anders 0.
Opmerkingen
Overschrijf deze lidfunctie om speciale gegevensvalidatietaken uit te voeren.
CSnapInPropertyPageImpl::OnQueryCancel
Deze lidfunctie wordt aangeroepen wanneer de gebruiker op de knop Annuleren klikt en voordat de actie Annuleren heeft plaatsgevonden.
BOOL OnQueryCancel();
Retourwaarde
Niet-nul om de annuleringsbewerking toe te staan; anders 0.
Opmerkingen
Overschrijf deze lidfunctie om een actie op te geven die het programma uitvoert wanneer de gebruiker op de knop Annuleren klikt.
De standaard implementatie van OnQueryCancel retourneert TRUE.
CSnapInPropertyPageImpl::OnReset
Deze lidfunctie wordt aangeroepen wanneer de gebruiker op de knop Annuleren klikt.
void OnReset();
Opmerkingen
Wanneer deze functie wordt aangeroepen, worden wijzigingen in alle eigenschappenpagina's die door de gebruiker zijn aangebracht eerder op de knop Nu toepassen verwijderd en behoudt het eigenschappenvenster de focus.
Overschrijf deze lidfunctie om op te geven welke actie het programma uitvoert wanneer de gebruiker op de knop Annuleren klikt.
CSnapInPropertyPageImpl::OnSetActive
Deze lidfunctie wordt aangeroepen wanneer de pagina wordt gekozen door de gebruiker en de actieve pagina wordt.
BOOL OnSetActive();
Retourwaarde
Niet-nul als de pagina actief is ingesteld; anders 0.
Opmerkingen
Overschrijf deze lidfunctie om taken uit te voeren wanneer een pagina wordt geactiveerd. Uw onderdrukking van deze lidfunctie moet de standaardversie aanroepen voordat andere verwerkingen worden uitgevoerd.
De standaard implementatie retourneert TRUE.
CSnapInPropertyPageImpl::OnWizardBack
Deze lidfunctie wordt aangeroepen wanneer de gebruiker op de knop Vorige in een wizard klikt.
BOOL OnWizardBack();
Retourwaarde
0 om automatisch naar de vorige pagina te gaan.
-1 om te voorkomen dat de pagina wordt gewijzigd.
Als u naar een andere pagina wilt gaan dan de volgende, retourneert u de id van het dialoogvenster dat moet worden weergegeven.
Opmerkingen
Overschrijf deze lidfunctie om een actie op te geven die de gebruiker moet uitvoeren wanneer op de knop Vorige wordt geklikt.
CSnapInPropertyPageImpl::OnWizardFinish
Deze lidfunctie wordt aangeroepen wanneer de gebruiker op de knop Voltooien in een wizard klikt.
BOOL OnWizardFinish();
Retourwaarde
Niet-nul als het eigenschappenvenster wordt vernietigd wanneer de wizard is voltooid; anders nul.
Opmerkingen
Overschrijf deze lidfunctie om een actie op te geven die de gebruiker moet uitvoeren wanneer op de knop Voltooien wordt geklikt.
CSnapInPropertyPageImpl::OnWizardNext
Deze lidfunctie wordt aangeroepen wanneer de gebruiker op de knop Volgende in een wizard klikt.
BOOL OnWizardNext();
Retourwaarde
0 om automatisch naar de volgende pagina te gaan.
-1 om te voorkomen dat de pagina wordt gewijzigd.
Als u naar een andere pagina wilt gaan dan de volgende, retourneert u de id van het dialoogvenster dat moet worden weergegeven.
Opmerkingen
Overschrijf deze lidfunctie om een actie op te geven die de gebruiker moet uitvoeren wanneer op de knop Volgende wordt geklikt.
CSnapInPropertyPageImpl::QuerySiblings
Roep deze lidfunctie aan om een bericht door te sturen naar elke pagina in het eigenschappenvenster.
LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);
Parameterwaarden
wParam
[in] Hiermee geeft u aanvullende berichtafhankelijke informatie op.
lParam
[in] Hiermee geeft u aanvullende berichtafhankelijke informatie op.
Retourwaarde
Niet-nul als het bericht niet mag worden doorgestuurd naar de volgende eigenschappenpagina; anders nul.
Opmerkingen
Als een pagina een niet-nulwaarde retourneert, verzendt het eigenschappenvenster het bericht niet naar de volgende pagina's.
CSnapInPropertyPageImpl::SetModified
Roep deze lidfunctie aan om de knop Nu toepassen in of uit te schakelen, op basis van of de instellingen op de eigenschappenpagina moeten worden toegepast op het juiste externe object.
void SetModified(BOOL bChanged = TRUE);
Parameterwaarden
bChanged
[in] WAAR om aan te geven dat de instellingen van de eigenschappenpagina zijn gewijzigd sinds de laatste keer dat ze zijn toegepast; FALSE om aan te geven dat de instellingen van de eigenschappenpagina zijn toegepast of moeten worden genegeerd.
Opmerkingen
In het eigenschappenvenster wordt bijgehouden welke pagina's 'vuil' zijn, dat wil gezegd eigenschappenpagina's waarvoor u hebt gebeld SetModified( TRUE ). De knop Nu toepassen wordt altijd ingeschakeld als u een van de pagina's aanroept SetModified( TRUE ) . De knop Nu toepassen wordt uitgeschakeld wanneer u een van de pagina's belt SetModified( FALSE ) , maar alleen als geen van de andere pagina's 'vuil' is.