MFC ActiveX-kontroller: Avancerade ämnen

Den här artikeln beskriver avancerade ämnen som rör utveckling av ActiveX-kontroller. Dessa inkluderar:

• Använda databasklasser i ActiveX-kontroller

• Implementera en parameteriserad egenskap

• Hantera fel i Din ActiveX-kontroll

• Hantera specialtangenter i kontrollenheten

• Åtkomst till dialogkontroller som är osynliga vid körning

Använda databasklasser i ActiveX-kontroller

Eftersom ActiveX-kontrollklasserna ingår i klassbiblioteket kan du använda samma procedurer och regler för att använda databasklasser i ett MFC-standardprogram för att utveckla ActiveX-kontroller som använder MFC-databasklasserna.

En allmän översikt över MFC-databasklasserna finns i MFC Database Classes (DAO och ODBC). I artikeln beskrivs både MFC ODBC-klasserna och MFC DAO-klasserna och du får mer information om någon av dem.

Implementera en parameteriserad egenskap

En parameteriserad egenskap (kallas ibland en egenskapsmatris) är en metod för att exponera en homogen samling värden som en enda egenskap för kontrollen. Du kan till exempel använda en parameteriserad egenskap för att exponera en matris eller en ordlista som en egenskap. I Visual Basic används en sådan egenskap med matrisnotation:

x = o.Array(2, 3) ' gets element of 2D array
o.Array(2, 3) = 7 ' sets element of 2D array

Använd guiden Lägg till egenskap för att implementera en parameteriserad egenskap. Guiden Lägg till egenskap implementerar egenskapen genom att lägga till ett par Get/Set-funktioner som gör att kontrollanvändaren kan komma åt egenskapen med hjälp av ovanstående notation eller på standard sätt.

På samma sätt som metoder och egenskaper har parametriserade egenskaper också en gräns för antalet tillåtna parametrar. När det gäller parameteriserade egenskaper är gränsen 15 parametrar (med en parameter reserverad för lagring av egenskapsvärdet).

Följande procedur lägger till en parameteriserad egenskap med namnet Matris, som kan nås som en tvådimensionell matris med heltal.

Så här lägger du till en parameteriserad egenskap med hjälp av guiden Lägg till egenskap

1. Läs in kontrollens projekt.

2. I Klassvy expanderar du biblioteksnoden för din kontroll.

3. Högerklicka på gränssnittsnoden för kontrollen (biblioteksnodens andra nod) för att öppna snabbmenyn.

4. På snabbmenyn klickar du på Lägg till och sedan på Lägg till egenskap.

5. I rutan Egenskapsnamn skriver du Array.

6. I rutan Egenskapstyp väljer du short.

7. För Implementeringstyp klickar du på Hämta/ange metoder.

8. I rutorna Hämta funktion och Ange funktion skriver du unika namn för Get and Set Functions eller accepterar standardnamnen.

9. Lägg till en parameter med namnet row (type short) med hjälp av kontrollerna Parameternamn och Parametertyp .

10. Lägg till en andra parameter med namnet column (type short).

11. Klicka på Finish.

Ändringar som gjorts av guiden Lägg till egenskap

När du lägger till en anpassad egenskap gör guiden Lägg till egenskap ändringar i kontrollklassrubriken (. H) och implementeringen (. CPP)-filer.

Följande rader läggs till i kontrollklassen . H-fil:

SHORT GetArray(SHORT row, SHORT column);
void SetArray(SHORT row, SHORT column, SHORT newVal);

Den här koden deklarerar två funktioner som anropas GetArray och SetArray som gör det möjligt för användaren att begära en specifik rad och kolumn vid åtkomst till egenskapen.

Dessutom lägger guiden Lägg till egenskap till följande rader i kontrolldispatchkartan, som finns i kontrollklassimplementeringen (.CPP)-filen:

DISP_PROPERTY_PARAM_ID(CMyAxUICtrl, "Array", dispidArray, GetArray, SetArray, VT_I2, VTS_I2 VTS_I2)

Slutligen läggs implementeringarna av GetArray funktionerna och SetArray till i slutet av . CPP-fil. I de flesta fall ändrar du funktionen "Get" för att returnera värdet för egenskapen. Funktionen Set innehåller vanligtvis kod som ska köras, antingen före eller efter att egenskapen har ändrats.

För att den här egenskapen ska vara användbar kan du deklarera en tvådimensionell matrismedlemsvariabel i kontrollklassen, av typen short, för att lagra värden för den parameteriserade egenskapen. Du kan sedan ändra funktionen Get för att returnera värdet som lagras på rätt rad och kolumn, enligt parametrarna, och ändra funktionen Set för att uppdatera värdet som refereras av rad- och kolumnparametrarna.

Hantera fel i Din ActiveX-kontroll

Om feltillstånd uppstår i kontrollen kan du behöva rapportera felet till kontrollcontainern. Det finns två metoder för att rapportera fel, beroende på i vilken situation felet inträffar. Om felet uppstår i en egenskaps get- eller set-funktion, eller inom implementeringen av en OLE Automation-metod, bör kontrollen anropa COleControl::ThrowError, som signalerar till kontrollanvändaren att ett fel har inträffat. Om felet inträffar vid någon annan tidpunkt bör kontrollen anropa COleControl::FireError, som utlöser en lagerfelhändelse.

För att ange vilken typ av fel som har inträffat måste kontrollen skicka en felkod till ThrowError eller FireError. En felkod är en OLE-statuskod som har ett 32-bitars värde. När det är möjligt väljer du en felkod från standarduppsättningen med koder som definierats i OLECTL. H-huvudfil. I följande tabell sammanfattas dessa koder.

Felkoder för ActiveX-kontroll

Om det behövs använder du makrot CUSTOM_CTL_SCODE för att definiera en anpassad felkod för ett villkor som inte omfattas av någon av standardkoderna. Parametern för det här makrot ska vara ett heltal mellan 1000 och 32767, inklusive. Till exempel:

#define MYCTL_E_SPECIALERROR CUSTOM_CTL_SCODE(1000)

Om du skapar en ActiveX-kontroll för att ersätta en befintlig VBX-kontroll definierar du felkoderna för ActiveX-kontrollen med samma numeriska värden som VBX-kontrollen använder för att säkerställa att felkoderna är kompatibla.

Hantera speciella tangenter i kontrollen

I vissa fall kanske du vill hantera vissa tangenttryckningskombinationer på ett speciellt sätt. Infoga till exempel en ny rad när RETUR-tangenten trycks in i en textrutekontroll med flera rader eller flyttas mellan en grupp med redigeringskontroller när ett riktningsnyckel-ID trycktes in.

Om basklassen för ActiveX-kontrollen är COleControlkan du åsidosätta CWnd::P reTranslateMessage för att hantera meddelanden innan containern bearbetar dem. När du använder den här tekniken returnerar du alltid TRUE om du hanterar meddelandet i åsidosättningen av PreTranslateMessage.

I följande kodexempel visas ett möjligt sätt att hantera meddelanden som är relaterade till riktningsnycklarna.

BOOL CMyAxUICtrl::PreTranslateMessage(MSG* pMsg)
{
   BOOL bHandleNow = FALSE;

   switch (pMsg->message)
   {
   case WM_KEYDOWN:
      switch (pMsg->wParam)
      {
      case VK_UP:
      case VK_DOWN:
      case VK_LEFT:
      case VK_RIGHT:
         bHandleNow = TRUE;
         break;
      }
      if (bHandleNow)
      {
         OnKeyDown((UINT)pMsg->wParam, LOWORD(pMsg->lParam), HIWORD(pMsg->lParam));
      }
      break;
   }
   return bHandleNow;
}

Mer information om hur du hanterar tangentbordsgränssnitt för en ActiveX-kontroll finns i ActiveX SDK-dokumentationen.

Åtkomst till dialogkontroller som är osynliga vid körning

Du kan skapa dialogkontroller som inte har något användargränssnitt och som är osynliga vid körning. Om du lägger till en osynlig ActiveX-kontroll vid körning i en dialogruta och använder CWnd::GetDlgItem för att komma åt kontrollen fungerar inte kontrollen korrekt. I stället bör du använda någon av följande tekniker för att hämta ett objekt som representerar kontrollen:

• Med hjälp av guiden Lägg till medlemsvariabel väljer du Kontrollvariabel och sedan kontrollens ID. Ange ett medlemsvariabelnamn och välj kontrollens omslutningsklass som kontrolltyp.

  -eller-

• Deklarera en lokal variabel och underklass som dialogobjekt. Infoga kod som liknar följande (CMyCtrl är omslutningsklassen IDC_MYCTRL1 är kontrollens ID):

  CCirc myCirc;
  myCirc.SubclassDlgItem(IDC_CIRCCTRL2, this);
  // ... use myCirc ...
  myCirc.UnsubclassWindow();
  

Se även

MFC ActiveX-kontroller