TCustomAdapterDispatcher.OnBeforeDispatchImage Event

Occurs before the dispatcher forwards an image request to an adapter for handling.

Pascal

property OnBeforeDispatchImage: TDispatchImageHandledEvent;

C++

__property TDispatchImageHandledEvent OnBeforeDispatchImage;

Description

Write an OnBeforeDispatchImage event handler to respond to image requests before they are forwarded to the associated adapter for handling. Note that if the request does not ask for the value of an image field, the Params parameter of the event handler is nil (Delphi) or NULL (C++).

If the OnBeforeDispatchImage event handler does not set its Handled parameter to true, the adapter dispatcher forwards the request to the identified adapter that is the value of the Image parameter. If the event handler sets Handled to false, the dispatcher does not forward the request to the adapter for handling, and does not generate an OnAfterDispatchImage event.

Tip: Use the Response property of the current Web context to access the response message from the OnBeforeDispatchImage event handler. You can obtain a reference to the Web context by calling the global WebContext function.