L_PntDlgRegion

#include "ltpdg.h"

L_LTPDG_API L_INT L_PntDlgRegion(hWnd, pRegionDlgInfo)

L_HWND hWnd;

/*owner of the dialog */

pPAINTDLGREGIONINFO pRegionDlgInfo;

/* pointer to a structure */

Brings up the region properties dialog box.

Parameter

Description

hWnd

Handle of the window that owns the dialog.

pRegionDlgInfo

Pointer to a PAINTDLGREGIONINFO structure that contains region information. The values present in pRegionDlgInfo when the function is called are used to initialize the dialog, if PAINT_DLG_REGION_INITUSEDEFAULT is not set in the dwFlags member of pRegionDlgInfo. When this function returns, this parameter is updated with the values entered through the dialog.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Required DLLs and Libraries

LTPDG

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_PntGetProperty, L_PntSetProperty, L_PntRegionBorder, L_PntRegionColor, L_PntRegionEllipse, L_PntRegionPolygon, L_PntRegionRect, L_PntRegionRoundRect, L_PntRegionScale, L_PntRegionSurface, L_PntRegionTranslate

Topics:

DigitalPaint Functions: DigitalPaint Common Dialogs

 

Using the DigitalPaint Common Dialogs

Example

This example will display the Region common dialog.

 L_INT PntDlgRegionExample( HWND hWnd, L_BOOL fUseDef)
{
   L_INT nRet;
   PAINTDLGREGIONINFO dlgRegionInfo;

   memset(&dlgRegionInfo, 0, sizeof(dlgRegionInfo));

   if ( fUseDef == TRUE ) 
   {
      dlgRegionInfo.dwFlags = PAINT_DLG_REGION_SHOWALL       |
                                PAINT_DLG_REGION_INITUSEDEFAULT;
   }
   else
   {
      dlgRegionInfo.nSize                     = sizeof ( PAINTDLGREGIONINFO ) ;
      dlgRegionInfo.dwFlags                   = PAINT_DLG_REGION_SHOWLOWERTOLERANCE |
                                                  PAINT_DLG_REGION_SHOWUPPERTOLERANCE |
                                                  PAINT_DLG_REGION_SHOWELLIPSEWIDTH   |
                                                  PAINT_DLG_REGION_SHOWELLIPSEHEIGHT  ;

      dlgRegionInfo.pszTitle                  = TEXT("Lead Region Common Dialog ") ;
      dlgRegionInfo.crLowerTolerance          = RGB ( 10, 10, 10 ) ;
      dlgRegionInfo.crUpperTolerance          = RGB ( 10, 10, 10 ) ;
      dlgRegionInfo.nRoundRectEllipseWidth    = 20 ;
      dlgRegionInfo.nRoundRectEllipseHeight   = 20 ;
   }
   nRet = L_PntDlgRegion ( hWnd, &dlgRegionInfo  ) ;
   if(nRet != SUCCESS)
      return nRet;
   
   return SUCCESS;
}