PA_GetAreaRect

version 2003

PA_GetAreaRect (params) → PA_Rect

The routine PA_GetAreaRect returns the local coordinates of the area in the host form.

The plug-in usually calls this function when it needs to draw the area or when the eAE_Scroll event is received. This routine is essential for drawing in the area; it returns a rectangle expressed in local coordinates to the window that owns the area.

The RECT structure uses long as coordinates since a PA_Rect uses short (like a regular Rect MacOS structure). If the rectangle is used in Windows API's routine, you should convert it (see example below)

Get an area rectangle and convert it to a Windows RECT structure.

   void DoSomethingWithTheAreaRect(PA_PluginParameters params)
   {
      RECT   wRect;
 
      ConvertPA_RectToRect( PA_GEtAreaRect(params), &wRect);
      /* . . . OK, the RECT structure is OK now, we can use it (DrawText ie) . . . */
   }
 
   void ConvertPA_RectToRect(PA_Rect source, RECT *dest)
   {
      if(dest)
      {
         dest->top = source.fTop;
         dest->left = source.fLeft;
         dest->bottom = source.fBottom;
         dest->right = source.fRight;
      }
   }

Create and use an external area , PA_GetAreaEvent , PA_GetAreaName .