Eigenschapsbladen gebruiken in uw toepassing

Voer de volgende stappen uit om een eigenschappenvenster in uw toepassing te gebruiken:

1. Maak een dialoogsjabloon voor elke pagina met eigenschappen. Houd er rekening mee dat de gebruiker van de ene pagina naar de andere kan overschakelen, zodat u elke pagina zo consistent mogelijk indeelt.

   De dialoogvenstersjablonen voor alle pagina's hoeven niet dezelfde grootte te hebben. Het framework gebruikt de grootte van de grootste pagina om te bepalen hoeveel ruimte er moet worden toegewezen in het eigenschappenvenster voor de eigenschappenpagina's.

   Wanneer u de dialoogvenstersjabloonresource voor een eigenschappenpagina maakt, moet u de volgende stijlen opgeven in het eigenschappenvenster Dialoogvenstereigenschappen:

   • Stel het invoervak Bijschrift op de pagina Algemeen in op de tekst die u wilt weergeven op het tabblad voor deze pagina.

   • Stel de keuzelijst Stijl op de pagina Stijlen in op Kind.

   • Stel de keuzelijst Rand op de pagina Stijlen in op Dun.

   • Zorg ervoor dat het selectievakje Titelbalk op de pagina Stijlen is ingeschakeld.

   • Zorg ervoor dat het selectievakje Uitgeschakeld op de pagina Meer stijlen is ingeschakeld.

2. Maak een CPropertyPage-afgeleide klasse die overeenkomt met elke dialoogvenstersjabloon voor eigenschappenpagina's. Zie Een klasse toevoegen. Kies CPropertyPage als de basisklasse.

3. Maak lidvariabelen om de waarden op te slaan voor deze eigenschapspagina. Het proces voor het toevoegen van lidvariabelen aan een eigenschappenpagina is precies hetzelfde als het toevoegen van lidvariabelen aan een dialoogvenster, omdat een eigenschappenpagina een speciaal dialoogvenster is. Zie Ledenvariabelen definiëren voor dialoogvensterbesturingselementen voor meer informatie.

4. Maak een CPropertySheet-object in uw broncode. Meestal maakt u het CPropertySheet object in de handler voor de opdracht die het eigenschappenvenster weergeeft. Dit object vertegenwoordigt het hele eigenschappenvenster. Als u een modaal eigenschappenvenster maakt met de functie DoModal , levert het framework standaard drie opdrachtknoppen: OK, Annuleren en Toepassen. Het framework maakt geen opdrachtknoppen voor modeless eigenschappenbladen die zijn gemaakt met de functie Create. U hoeft geen klasse af te leiden van CPropertySheet tenzij u andere controls (zoals een voorbeeldvenster) wilt toevoegen of een modeless eigenschappenvenster wilt weergeven. Deze stap is nodig voor niet-modale eigenschappenbladen omdat ze geen standaardbesturingselementen bevatten die kunnen worden gebruikt om het eigenschappenblad te sluiten.

5. Ga als volgt te werk om elke pagina toe te voegen aan het eigenschappenvenster:

   • Maak één object voor elke CPropertyPageafgeleide klasse die u eerder in dit proces hebt gemaakt.

   • Roep CPropertySheet::AddPage aan voor elke pagina.

   Normaal gesproken creëert het object dat de CPropertySheet maakt, ook de CPropertyPage-objecten in deze stap. Als u echter een CPropertySheet-afgeleide klasse implementeert, kunt u de CPropertyPage objecten in het CPropertySheet object insluiten en elke pagina aanroepen AddPage vanuit de CPropertySheet-afgeleide klasseconstructor. AddPage voegt het CPropertyPage object toe aan de lijst met pagina's van het eigenschappenvenster, maar maakt het venster voor die pagina niet daadwerkelijk. Daarom is het niet nodig om te wachten totdat het eigenschappenvenster is gemaakt om AddPage aan te roepen; u kunt AddPage vanuit de constructor van het eigenschappenvenster aanroepen.

   Als een eigenschappenvenster standaard meer tabbladen heeft dan in één rij van het eigenschappenvenster past, worden de tabbladen in meerdere rijen gestapeld. Als u stacking wilt uitschakelen, roept u CPropertySheet::EnableStackedTabs aan met de parameter ingesteld op FALSE. U moet aanroepen EnableStackedTabs wanneer u het eigenschappenvenster maakt.

6. Roep CPropertySheet::DoModal of Aanmaken aan om het eigenschappenvenster weer te geven. Roep DoModal aan om een eigenschappenvenster als een modaal dialoogvenster te maken. Roep Maken aan om het eigenschappenblad als een modeless dialoogvenster te maken.

7. Gegevens uitwisselen tussen eigenschapspagina's en de eigenaar van het eigenschappenblad. Dit wordt uitgelegd in het artikel Gegevens uitwisselen.

Zie de MFC General Sample PROPDLG voor een voorbeeld van het gebruik van eigenschappenvensters.

Zie ook

eigenschappenvensters