Help Version 19.0.2017.10.27
References ▼
#include "Ltwrappr.h"
L_INT LRasterPaint::RegionScale(nHScaleFactor, nVScaleFactor, nAlignment, phDestRgn)
L_INT nHScaleFactor; |
horizontal scale factor |
L_INT nVScaleFactor; |
vetical scale factor |
PAINTALIGNMENT nAlignment; |
alignment type |
pHRGN phDestRgn; |
pointer to the region handle |
Scales a region.
| Parameter | Description | |
| nHScaleFactor | Horizontal scale factor. Valid values are between 1 and 10000. For example: | |
| Value | Meaning | |
| 100 | The same dimensions. | |
| 110 | 1.1 times the original dimensions. | |
| 120 | 1.2 times the original dimensions. | |
| 10000 | 100 times the original dimensions. | |
| 99 | 0.99 times the original dimensions. | |
| 98 | 0.98 times the original dimensions. | |
| 1 | 0.01 times the original dimensions. | |
| nVScaleFactor | Vertical scale factor. Valid values are between 1 and 10000. For example: | |
| Value | Meaning | |
| 100 | The same dimensions. | |
| 110 | 1.1 times the original dimensions | |
| 120 | 1.2 times the original dimensions. | |
| 10000 | 100 times the original dimensions. | |
| 99 | 0.99 times the original dimensions. | |
| 98 | 0.98 times the original dimensions. | |
| 1 | 0.01 times the original dimensions. | |
| nAlignment | A value that determines how the scaled region will be aligned with respect to the original region. For a list of possible values, refer to PAINTALIGNMENT. | |
| phDestRgn | Pointer to the region to be translated. After translation, the toolkit will delete the old region and replace it with the new one. | |
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes |
The user is responsible for deleting the resulting region.
Required DLLs and Libraries
LTPNT For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application |
L_INT LRasterPaint_RegionScaleExample( CWnd* pWnd ){L_INT nRet;LRasterPaint rstp;CDC* pDC = pWnd->GetDC() ;RECT rcRegion ;HRGN hDestRgn ;/* Initiate the Paint toolkit */nRet = rstp.Initialize ( );if(nRet != SUCCESS)return nRet;/* Set the coordinates with respect to the DC dimensions*/SetRect ( &rcRegion, 250, 110, 350, 210 ) ;/* Use the current region properties and the current paintingtransformations to create an ellipse region */nRet = rstp.RegionEllipse ( pDC->m_hDC, &rcRegion, &hDestRgn ) ;if(nRet != SUCCESS)return nRet;/* Display the resulted region */FrameRgn ( pDC->m_hDC, hDestRgn, ( HBRUSH ) GetStockObject ( BLACK_BRUSH ), 1, 1 ) ;/* Scale the region */nRet = rstp.RegionScale (300, 300,( PAINTALIGNMENT ) (PAINT_ALIGNMENT_HCENTER | PAINT_ALIGNMENT_VCENTER),&hDestRgn ) ;if(nRet != SUCCESS)return nRet;/* Display the scaled region */FrameRgn ( pDC->m_hDC, hDestRgn, ( HBRUSH ) GetStockObject ( BLACK_BRUSH ), 1, 1 ) ;/*Delete the region */DeleteObject ( hDestRgn ) ;/* Free the paint tools handle */nRet = rstp.Free ( ) ;if(nRet != SUCCESS)return nRet;pWnd->ReleaseDC( pDC ) ;return SUCCESS ;}