Partilhar via


CComControl::FireOnRequestEdit

Notifica o coletor do recipiente que uma propriedade de controle está prestes a alterar e que o objeto está solicitando o coletor como proceder.

HRESULT FireOnRequestEdit(
   DISPID dispID 
);

Parâmetros

  • dispID
    [in] Identificador da propriedade sobre a alterar.

Valor de retorno

Um dos valores HRESULT padrão.

Comentários

Se sua classe de controle deriva de IPropertyNotifySink, este método chama CFirePropNotifyEvent::FireOnRequestEdit para notificar todos conectados IPropertyNotifySink interfaces que a propriedade do controle especificado está prestes a ser alterada. Se sua classe de controle não deriva de IPropertyNotifySink, esse método retorna S_OK.

Esse método é seguro chamar o mesmo se o controle não oferecer suporte a pontos de conexão.

Exemplo

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

Requisitos

Cabeçalho: atlctl.h

Consulte também

Referência

Classe CComControl

CComControl::FireOnChanged

Outros recursos

CComControl membros