CComControl::FireOnRequestEdit

 

Veröffentlicht: Juli 2016

Benachrichtigt die Senke des Containers, dass eine Steuerelementeigenschaft im Begriff ist zu ändern und das Objekt ist, die Senke fragend, wie fortgesetzt wird.

Syntax

      HRESULT FireOnRequestEdit(
   DISPID dispID 
);

Parameter

  • dispID
    [in] Bezeichner der Eigenschaft ungefähr zu ändern.

Rückgabewert

Einer der Werte des Standards HRESULT.

Hinweise

Wenn die Steuerelementklasse von IPropertyNotifySink berechnet, diesem Methodenaufrufe CFirePropNotifyEvent::FireOnRequestEdit, um alle verbundenen IPropertyNotifySink-Schnittstellen zu benachrichtigen, dass die angegebene Steuerelementeigenschaft im Begriff ist zu ändern. Wenn die Steuerelementklasse nicht von IPropertyNotifySink berechnet, gibt S_OK dieser Methode.

Diese Methode ist sicher aufzurufen, wenn das Steuerelement nicht Verbindungspunkte unterstützt.

Beispiel

STDMETHODIMP CMyControl::put_MyTitle(BSTR newVal)
{
   // the DISPID for MyTitle in this example is 4
   DISPID dispID = 4;

   // make sure we can change the property
   if (FireOnRequestEdit(dispID) == S_FALSE)
      return S_FALSE;

   // store newVal in CComBstr member
   m_bstrMyTitle = newVal;

   // signal that the property has been changed
   FireOnChanged(dispID);

   return S_OK;
}

Anforderungen

Header: atlctl.h

Siehe auch

CComControl Class
CComControl::FireOnChanged