CComControl::FireOnChanged

Notifies the container's sink that a control property has changed.

HRESULT FireOnChanged(
   DISPID dispID 
);

Parameters

  • dispID
    [in] Identifier of the property that has changed.

Return Value

One of the standard HRESULT values.

Remarks

If your control class derives from IPropertyNotifySink, this method calls CFirePropNotifyEvent::FireOnChanged to notify all connected IPropertyNotifySink interfaces that the specified control property has changed. If your control class does not derive from IPropertyNotifySink, this method returns S_OK.

This method is safe to call even if your control doesn't support connection points.

Example

STDMETHODIMP CMyControl::put_MyText(BSTR newVal)
{
   // store newVal in CComBstr member
   m_bstrMyText = newVal;

   // note the DISPID for the MyText property is 3 in this example
   FireOnChanged(3);

   return S_OK;
}

Requirements

Header: atlctl.h

See Also

Reference

CComControl Class

CComControl::FireOnRequestEdit

Other Resources

CComControl Members