CBasePropertyPage.OnConnect-Methode
Die OnConnect -Methode stellt einen IUnknown-Zeiger auf das Der Eigenschaftenseite zugeordnete Objekt zur Seite.
Syntax
virtual HRESULT OnConnect(
IUnknown *pUnknown
);
Parameter
-
pUnknown
-
Zeiger auf die IUnknown-Schnittstelle des -Objekts.
Rückgabewert
Die Basisklassenimplementierung gibt S _ OK zurück.
Hinweise
Die CBasePropertyPage::SetObjects-Methode ruft die OnConnect -Methode auf. Überschreiben Sie diese Methode, um einen Zeiger auf das von pUnknown angegebene Objekt zu speichern. Sie können entweder den pUnknown-Zeiger selbst speichern oder diesen Zeiger für andere Schnittstellen abfragen. Wenn Sie den pUnknown-Zeiger speichern, rufen Sie AddRef auf, bevor zurückgegeben OnConnect wird.
Verwenden Sie in der CBasePropertyPage::OnActivate-Methode den gespeicherten Zeiger (oder Zeiger), um Anfangswerte für die Dialogeigenschaften abzurufen. Wenden Sie in der CBasePropertyPage::OnApplyChanges-Methode alle Änderungen zurück auf das -Objekt an. Geben Sie alle Zeiger in der CBasePropertyPage::OnDisconnect-Methode frei.
Beispiele
HRESULT CMyProp::OnConnect(IUnknown *pUnk)
{
ASSERT(m_pOwningFilter == NULL);
HRESULT hr;
// Query pUnk for the filter's custom interface.
hr = pUnk->QueryInterface(IID_ISomeCustomInterface,
reinterpret_cast<void**>(&m_pOwningFilter));
return hr;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|