PA_CallPluginAreaMethod

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_CallPluginAreaMethod (params)

ParameterTypeDescription
paramsPA_PluginParametersParameters 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.


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next