PA_CallPluginAreaMethod

version 2003

PA_CallPluginAreaMethod (params)

Parameter	Type		Description
params	PA_PluginParameters	→	Parameters received in PluginMain

Description

The routine PA_CallPluginAreaMethod tells 4D to execute the area method object if its event On Plug in Area is checked.

This routine is available only if the current event is of type eAE_MouseDown , eAE_KeyDown , or eAE_Idle . All other events are ignored and PA_CallPluginAreaMethod returns eAE_BadEventCall in PA_GetLastError .

As an example, if the area event "On mouse down" is unchecked, the object method could still be executed at mouse down if:

	- the event `On Plug in Area` is checked,
	- 4D code is entered for this event in the object method,
	- the area calls `PA_CallPluginAreaMethod` when it receives a `eAE_MouseDown` Event.

Example

The area has only the On Plug in Area

event active, and its code is in 4D:

   If (Form event = On Plug in Area)
      BEEP  
   End if

The code of the area contains:

   void MyArea (PA_PluginParameters params)
   {
   /* ... usual dispatch of the event. ... */
 
      case eAE_MouseDown:
         PA_CallPluginAreaMethod (params);
         break;
 
   /* ... usual dispatch of the event. ... */
   }

With this code, the method object is called and 4D beeps when the user clicks in the area.