MFC ActiveX-kontroller: Egenskapssidor

Med egenskapssidor kan en ActiveX-kontrollanvändare visa och ändra ActiveX-kontrollegenskaper. Dessa egenskaper nås genom att anropa en dialogruta för kontrollegenskaper, som innehåller en eller flera egenskapssidor som tillhandahåller ett anpassat grafiskt gränssnitt för att visa och redigera kontrollegenskaperna.

ActiveX-kontrollegenskapssidor visas på två sätt:

• När kontrollens egenskapsverb (OLEIVERB_PROPERTIES) anropas öppnar kontrollen en dialogruta för en modal egenskap som innehåller kontrollens egenskapssidor.

• Containern kan visa en egen lägeslös dialogruta som visar egenskapssidorna för den valda kontrollen.

Dialogrutan Egenskaper (illustreras i följande bild) består av ett område för att visa den aktuella egenskapssidan, flikar för att växla mellan egenskapssidor och en samling knappar som utför vanliga uppgifter, till exempel att stänga dialogrutan egenskapssida, avbryta eventuella ändringar som gjorts eller omedelbart tillämpa ändringar i ActiveX-kontrollen.

Dialogrutan Egenskaper

Den här artikeln beskriver ämnen som rör användning av egenskapssidor i en ActiveX-kontroll. Dessa inkluderar:

• Implementera standardegenskapssidan för en ActiveX-kontroll

• Lägga till kontroller på en egenskapssida

• Anpassa funktionen DoDataExchange

Mer information om hur du använder egenskapssidor i en ActiveX-kontroll finns i följande artiklar:

• MFC ActiveX-kontroller: Lägga till en annan anpassad egenskapssida

• MFC ActiveX-kontroller: Använda standardegenskapssidor

Information om hur du använder egenskapsblad i ett annat MFC-program än en ActiveX-kontroll finns i Egenskapsblad.

Implementera standardegenskapssidan

Om du använder ActiveX-kontrollguiden för att skapa kontrollprojektet tillhandahåller Guiden ActiveX-kontroll en standardklass för egenskapssidan för kontrollen som härleds från COlePropertyPage-klassen. Till en början är den här egenskapssidan tom, men du kan lägga till valfri dialogrutekontroll eller uppsättning kontroller i den. Eftersom ActiveX-kontrollguiden endast skapar en egenskapssidaklass som standard måste ytterligare egenskapssidasklasser (även härledda från COlePropertyPage) skapas med hjälp av klassvyn. Mer information om den här proceduren finns i MFC ActiveX-kontroller: Lägga till en annan anpassad egenskapssida.

Att implementera en egenskapssida (i det här fallet standardvärdet) är en process i tre steg:

Så här implementerar du en egenskapssida

1. Lägg till en COlePropertyPage-derived-klass i kontrollprojektet. Om projektet skapades med hjälp av ActiveX-kontrollguiden (som i det här fallet) finns standardegenskapssidans klass redan.

2. Använd dialogredigeraren för att lägga till kontroller i mallen för egenskapssidan.

3. Anpassa DoDataExchange-funktionen i den COlePropertyPage-härledda klassen för att utbyta värden mellan egenskapssidans kontroll och ActiveX-kontrollen.

I följande procedurer används till exempel en enkel kontroll (med namnet "Sample"). Exemplet skapades med hjälp av ActiveX-kontrollguiden och innehåller endast den standardegenskapen Rubrik.

Lägga till kontroller på en egenskapssida

Så här lägger du till kontroller på en egenskapssida

1. Öppna Resursvy när kontrollprojektet är öppet.

2. Dubbelklicka på katalogikonen Dialog .

3. Öppna dialogrutan IDD_PROPPAGE_SAMPLE.

   ActiveX-kontrollguiden lägger till namnet på projektet i slutet av dialog-ID:t, i det här fallet Exempel.

4. Dra och släpp den markerade kontrollen från verktygslådan till dialogruteområdet.

5. I det här exemplet räcker det med textetikettkontrollen "Caption :" och en redigeringsrutekontroll med en IDC_CAPTION identifierare.

6. Spara ändringarna genom att klicka på Spara i verktygsfältet.

Nu när användargränssnittet har ändrats måste du länka redigeringsrutan med egenskapen Bildtext. Detta görs i följande avsnitt genom att redigera CSamplePropPage::DoDataExchange funktionen.

Anpassa DoDataExchange-funktionen

Med funktionen CWnd::D oDataExchange kan du länka egenskapssidans värden med de faktiska värdena för egenskaperna i kontrollen. Om du vill upprätta länkar måste du mappa lämpliga egenskapssidafält till respektive kontrollegenskaper.

Dessa mappningar implementeras med hjälp av egenskapssidan DDP_ funktioner. De DDP_ funktionerna fungerar som de DDX_ funktioner som används i MFC-standarddialogrutor, med ett undantag. Förutom referensen till en medlemsvariabel tar DDP_ funktioner namnet på kontrollegenskapen. Följande är en typisk post i DoDataExchange-funktionen för en egenskapssida.

DDP_Text(pDX, IDC_CAPTION, m_caption, _T("Caption"));

Den här funktionen associerar egenskapssidans medlemsvariabel m_caption med bildtext, med hjälp av DDP_TEXT-funktionen.

När du har infogat egenskapssidans kontroll måste du upprätta en länk mellan egenskapssidans kontroll, IDC_CAPTION och den faktiska kontrollegenskapen, Bildtext, med hjälp av funktionen enligt beskrivningen DDP_Text ovan.

Egenskapssidor är tillgängliga för andra dialogkontrolltyper, till exempel kryssrutor, alternativknappar och listrutor. Tabellen nedan visar hela uppsättningen egenskapssida DDP_ funktioner och deras syften:

Funktioner för egenskapssida

Se även

MFC ActiveX-kontroller
COlePropertyPage-klass