MFC-ActiveX-Steuerelemente: Verwenden der Datenbindung in einem ActiveX-Steuerelement

Artikel
02/26/2013

Ein aus dem leistungsstarkeren Verwendung von ActiveX-Steuerelementen ist Datenbindung, die eine Eigenschaft des Steuerelements zur Bindung mit einem bestimmten Feld in einer Datenbank ermöglicht.Wenn ein Benutzer Daten in dieser gebundenen Eigenschaft geändert wird, weist das Steuerelement die Datenbank und die Anforderungen, dass das Datensatzfeld aktualisiert wird.Die Datenbank informiert dann das Steuerelement des Erfolgs oder Misserfolg zu der Anforderung.

Dieser Artikel enthält die Seite Steuerelements der Aufgabe.Die Datenbindung interaktionen mit der Datenbank zu implementieren ist die Verantwortung des Steuerelementcontainers.Wie Sie die Datenbank interaktionen im Container verwalten, liegt außerhalb des Rahmens dieser Dokumentation.Wie Sie vorbereiten, wird das Steuerelement für die Datenbindung im Rest dieses Artikels erläutert.

Konzeptionelles Diagramm eines datengebundenen Steuerelements

Datengebundenes Steuerelement

Die COleControl-Klasse stellt zweiköpfige Funktionen, die Datenbindung einen einfachen Prozess implementieren können.Die erste BoundPropertyRequestEdit-Funktion wird verwendet, um Berechtigungen anzufordern, den Eigenschaftswert zu ändern.BoundPropertyChanged, die zweite Funktion wird aufgerufen, nachdem der Eigenschaftswert erfolgreich geändert wurde.

Dieser Artikel enthält die folgenden Themen:

Eine bindbare Basiseigenschaft erstellen
Eine bindbare Get/set-Methode für erstellen

Eine bindbare Basiseigenschaft erstellen

Es ist möglich, eine datengebundene Basiseigenschaft zu erstellen, obwohl es wahrscheinlicher ist, dass Sie Rufen Sie bindbar ab, bzw. legen Sie Methode fest soll.

Hinweis
Vordefinierte Eigenschaften werden als Attribute standardmäßig bindable und requestedit.

So erstellen Sie eine bindbare Basiseigenschaft mithilfe des Assistenten zum Hinzufügen von Eigenschaften hinzufügen

Beginnen Sie ein Projekt mit MFC-ActiveX-Steuerelement-Assistent.
Klicken Sie mit der rechten Maustaste auf den Knoten Schnittstellen für das Steuerelement.

Dadurch wird das Kontextmenü.
Klicken Sie im Kontextmenü auf Hinzufügen und klicken Sie dann auf Eigenschaft hinzufügen.
Wählen Sie einen der Einträge aus der Dropdownliste aus.NameEigenschaftSie können z. B. Text auswählen.

Da Text eine Basiseigenschaft ist, werden die bindable und requestedit-Attribute bereits überprüft.
Wählen Sie die folgenden Kontrollkästchen in der IDL-Attribute Registerkarte aus: displaybind und defaultbind, um die Attribute der Eigenschaftendefinition in der IDL-Datei des Projekts einzufügen.Diese Attribute stellen dem Benutzer das Steuerelement sichtbar machen und die Basiseigenschaft die bindbare Eigenschaft.

Zu diesem Zeitpunkt kann das Steuerelement Daten aus einer Datenquelle anzeigen, aber der Benutzer kann keine Datenfelder zu aktualisieren.Wenn Sie das Steuerelement auch in der Lage sein sollen, Daten zu aktualisieren, ändern Sie die Funktion OnOcmCommandOnOcmCommand, um wie folgt aussehen:

#ifdef _WIN32
   WORD wNotifyCode = HIWORD(wParam);
#else
   WORD wNotifyCode = HIWORD(lParam);
#endif

   if(wNotifyCode==EN_CHANGE)
   {
      if(!BoundPropertyRequestEdit(DISPID_TEXT))
      {
         SetNotSupported();
      }
      else
      {
         GetText();
         // Notify container of change
         BoundPropertyChanged(DISPID_TEXT);
      }
   }

   return 0;

Sie können jetzt das Projekt erstellen, das das Steuerelement registriert.Wenn Sie das Steuerelement in einem Dialogfeld einfügen, sind die Datenfeld und Eigenschaften Datenquelle hinzugefügt, und Sie können jetzt eine Datenquelle und ein Feld auswählen, die im Steuerelement angezeigt werden sollen.

Eine bindbare Get/set-Methode für erstellen

Zusätzlich zu einem datengebundenen des Abrufens ab, bzw. legen Sie Methode erstellen, können Sie auch bindbare Basiseigenschaft fest.

Hinweis
Dieses Verfahren setzt voraus, dass Sie ein ActiveX-Steuerelement-Projekt verfügen, das ein Windows-Steuerelement unterordnet.

Um ein bindungsfähiges Rufen Sie hinzuzufügen bzw. legen Sie die Methode ab, mit dem Assistenten zum Hinzufügen von Eigenschaften fest

Laden Sie das Projekt des Steuerelements.
Wählen Sie auf der Seite Steuerelementeinstellungen eine Fensterklasse aus, damit das Steuerelement unterordnet.Sie können beispielsweise ein Bearbeitungssteuerelement unterordnen.
Laden Sie das Projekt des Steuerelements.
Klicken Sie mit der rechten Maustaste auf den Knoten Schnittstellen für das Steuerelement.

Dadurch wird das Kontextmenü.
Klicken Sie im Kontextmenü auf Hinzufügen und klicken Sie dann auf Eigenschaft hinzufügen.
Geben Sie den Eigenschaftennamen im Eigenschaftenname Feld ein.Verwenden Sie für dieses Beispiel MyProp.
Wählen Sie einen Datentyp aus Eigenschaftentyp Dropdown-Listenfeld aus.Verwenden Sie für dieses Beispiel short.
Für Implementierungstyp Klicken Sie auf Get/Set-Methoden.
Wählen Sie die folgenden Kontrollkästchen aus der Registerkarte IDL-Attribut aus: bindable, requestedit, displaybind und defaultbind, um die Attribute der Eigenschaftendefinition in der IDL-Datei des Projekts einzufügen.Diese Attribute stellen dem Benutzer das Steuerelement sichtbar machen und die Basiseigenschaft die bindbare Eigenschaft.
Klicken Sie auf Fertig stellen.

Ändern Sie den Text der SetMyProp-Funktion so, dass sie den folgenden Code enthält:

if(!BoundPropertyRequestEdit(1))
{
   SetNotSupported();
   return;
}
else
{
   if(AmbientUserMode()) // SendMessage only at run-time
   {
      _stprintf_s(m_strText.GetBuffer(10), 10, _T("%d"), newVal);
      SetWindowText(m_strText);
      m_strText.ReleaseBuffer();
   }
   else
   {
      InvalidateControl();
   }

   // Signal a property change
   // This is the MFC equivalent of OnChanged()
   BoundPropertyChanged(1);
   SetModifiedFlag();
}

Der Parameter, der an den BoundPropertyChanged und BoundPropertyRequestEdit-Funktionen übergeben wird, ist das dispid der Eigenschaft, die dem Parameter, der an das Attribut übergebene der id () für die Eigenschaft in der IDL-Datei.

Ändern Sie die OnOcmCommand-Funktion, sodass sie enthält den folgenden Code:

#ifdef _WIN32
   WORD wNotifyCode = HIWORD(wParam);
#else
   WORD wNotifyCode = HIWORD(lParam);
#endif

   if(wNotifyCode==EN_CHANGE)
   {
      if(!BoundPropertyRequestEdit(DISPID_TEXT))
      {
         SetNotSupported();
      }
      else
      {
         GetText();
         // Notify container of change
         BoundPropertyChanged(DISPID_TEXT);
      }
   }

   return 0;

Ändern Sie die OnDraw-Funktion so, dass sie den folgenden Code enthält:

if(!AmbientUserMode())
{
   // Draw the Text property at design-time
   pdc->FillRect(rcBounds, 
      CBrush::FromHandle((HBRUSH)GetStockObject(WHITE_BRUSH)));
   pdc->DrawText(m_strText, -1, (LPRECT)&rcBounds, 
      DT_LEFT | DT_TOP | DT_SINGLELINE);
}
else
{
   DoSuperclassPaint(pdc, rcBounds);
}

So fügen Sie die Headerdatei öffentlichen Abschnitt der Headerdatei für die Steuerelementklasse, die folgenden Definitionen (Konstruktoren) für Membervariablen hinzu:
```
CString m_strText;
short m_nMyNum;
```
Betrachten Sie die folgende Zeile die letzte Zeile in DoPropExchange arbeiten:
```
PX_String(pPX, _T("MyProp"), m_strText);
```

Ändern Sie die OnResetState-Funktion so, dass sie den folgenden Code enthält:

    COleControl::OnResetState();  // Resets defaults found in DoPropExchange
   m_strText = AmbientDisplayName();

Ändern Sie die GetMyProp-Funktion so, dass sie den folgenden Code enthält:

if(AmbientUserMode())
{
   GetWindowText(m_strText);
   m_nMyNum = (short)_ttoi(m_strText);
}
return m_nMyNum;

Freigeben über

MFC-ActiveX-Steuerelemente: Verwenden der Datenbindung in einem ActiveX-Steuerelement

Eine bindbare Basiseigenschaft erstellen

So erstellen Sie eine bindbare Basiseigenschaft mithilfe des Assistenten zum Hinzufügen von Eigenschaften hinzufügen

Eine bindbare Get/set-Methode für erstellen

Um ein bindungsfähiges Rufen Sie hinzuzufügen bzw. legen Sie die Methode ab, mit dem Assistenten zum Hinzufügen von Eigenschaften fest

Siehe auch

Referenz

Konzepte

Zusätzliche Ressourcen