Partager via


CComControl::FireOnRequestEdit

Informe le récepteur du conteneur qu'une propriété de contrôle est sur le point de modifier et que l'objet est demandant au récepteur comment continuer.

HRESULT FireOnRequestEdit( 
   DISPID dispID  
);

Paramètres

  • dispID
    [in] Identificateur de la propriété sur à modifier.

Valeur de retour

L'une des valeurs HRESULT standard.

Notes

Si votre classe de contrôle dérive d' IPropertyNotifySink, cette méthode appelle CFirePropNotifyEvent::FireOnRequestEdit pour signaler toutes les interfaces connectées d' IPropertyNotifySink que la propriété de contrôle spécifiée est sur le point de modifier. Si votre classe de contrôle ne dérive pas d' IPropertyNotifySink, retourne S_OKde cette méthode.

Il est sécurisée appeler cette méthode même si votre contrôle ne prend pas en charge les points de connexion.

Exemple

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;
}

Configuration requise

Header: atlctl.h

Voir aussi

Référence

CComControl, classe

CComControl::FireOnChanged