MFC-ActiveX-Steuerelemente: Weiterführende Eigenschaftenimplementierung
In diesem Artikel werden die Themen, die zum Implementieren von erweiterten Eigenschaften in einem ActiveX-Steuerelement verknüpft werden:
Schreibgeschützt und lesegeschützte Eigenschaften
Rückgabe von Fehlercodes aus einer Eigenschaft
Schreibgeschützt und lesegeschützte Eigenschaften
Der Assistent zum Hinzufügen von Eigenschaften bietet eine Zeit sparende und einfache Methode, schreib- oder lesegeschützte Eigenschaften für das Steuerelement implementieren bereit.
So ein schreibgeschütztes oder eine lesegeschützte Eigenschaft implementieren
Laden Sie das Projekt des Steuerelements.
Erweitern Sie in der Klassenansicht den Bibliotheksknoten des Steuerelements.
Klicken Sie auf den Schnittstellenknoten für das Steuerelement (der zweite Knoten des Bibliotheksknotens) mit der rechten Maustaste um das Kontextmenü zu öffnen.
Klicken Sie im Kontextmenü auf Hinzufügen und dann auf Eigenschaft hinzufügen.
Dadurch wird unter Assistent zum Hinzufügen von Eigenschaften.
Im Feld Eigenschaftenname geben Sie den Namen der Eigenschaft ein.
Für Implementierungstyp auf Get/Set-Methoden.
Im Feld Eigenschaftentyp wählen Sie den richtigen Typ für die Eigenschaft aus.
Wenn Sie eine schreibgeschützte Eigenschaft soll, löschen Sie den festgelegten Funktionsnamen. Wenn Sie eine lesegeschützte Eigenschaft soll, löschen Sie den Abrufensfunktionsnamen.
Klicken Sie auf Fertig stellen.
Wenn Sie dies tun, fügt der Assistent zum Hinzufügen von Eigenschaften die Funktion SetNotSupported oder GetNotSupported im Dispatchzuordnungseintrag anstelle eines normalen Menge ein oder ruft Funktion ab.
Wenn Sie einer vorhandenen Eigenschaft ändern möchten, um schreibgeschützt oder lesegeschützt sein, können Sie die Dispatchzuordnung manuell bearbeiten und den unnötigen Satz entfernen oder Funktion von der Control-Klasse abrufen.
Wenn Sie eine Eigenschaft bedingt schreibgeschützt oder lesegeschützt sein sollen (beispielsweise, nur, wenn das Steuerelement in einem bestimmten Modus) funktioniert, können Sie den Satz bereitstellen oder Funktion, z Normal abrufen und rufen die SetNotSupported oder Funktion bei GetNotSupported auf. Beispiel:
void CMyAxUICtrl::SetMyProperty(SHORT newVal)
{
AFX_MANAGE_STATE(AfxGetStaticModuleState());
if (m_bReadOnlyMode) // some control-specific state
{
SetNotSupported();
}
else
{
m_iPropVal = newVal; // set property as normal
SetModifiedFlag();
}
}
Dieses Codebeispiel ruft SetNotSupported auf, wenn der m_bReadOnlyMode - Datenmember TRUE ist. Wenn FALSE, anschließend die Eigenschaft auf den neuen Wert festgelegt wird.
Rückgabe von Fehlercodes aus einer Eigenschaft
Um anzugeben, dass ein Fehler beim Versuch abzurufen, aufgetreten ist, oder, eine Eigenschaft festzulegen, die COleControl::ThrowError verwenden Sie die Funktion, SCODE (Statuscode) als Parameter akzeptiert. Sie können vordefinierte SCODE verwenden oder eine eigene definiert. Eine Liste vordefinierter SCODEs und Anweisungen zum Definieren von benutzerdefiniertem SCODEs, finden Sie im Artikel Fehlerbehandlung im ActiveX-Steuerelement in ActiveX-Steuerelemente: Weiterführende Themen.
Hilfsfunktionen sind für die gängigsten vordefinierte SCODEs, wie COleControl::SetNotSupported, COleControl::GetNotSupported und COleControl::SetNotPermitted.
Hinweis
ThrowError gilt, nur als Mittel zur Rückgabe eines Fehlers aus einer Eigenschaft verwendet werden abrufen oder festlegen Funktion oder eine Automatisierungsmethode.Dies sind die einzigen vorkommen, dass der entsprechende Ausnahmehandler auf dem Stapel vorhanden ist.
Weitere Informationen über Berichterstellungsausnahmen in anderen Bereichen des Codes, finden Sie unter COleControl::FireError und im Abschnitt Fehlerbehandlung im ActiveX-Steuerelement im Artikel ActiveX-Steuerelemente: Weiterführende Themen.