Funzioni di area (GDI+)

Windows GDI+ espone un'API flat costituita da circa 600 funzioni, implementate in Gdiplus.dll e dichiarate in Gdiplusflat.h. Le funzioni nell'API flat GDI+ sono incapsulate da una raccolta di circa 40 classi C++. È consigliabile non chiamare direttamente le funzioni nell'API flat. Ogni volta che si effettuano chiamate a GDI+, è necessario chiamare i metodi e le funzioni forniti dai wrapper C++. Il Servizio Supporto Tecnico Clienti Microsoft non fornirà supporto per il codice che chiama direttamente l'API flat. Per altre informazioni sull'uso di questi metodi wrapper, vedere API GDI+ Flat.

Le funzioni API flat seguenti vengono incluse nella classe Region C++.

Funzioni region e metodi wrapper corrispondenti

Funzione flat	Wrapper, metodo	Osservazioni:
GpStatus WINGDIPAPI GdipCreateRegion(GpRegion **region)	Area::Region()	Crea un'area infinita. Questo è il costruttore predefinito.
GpStatus WINGDIPAPI GdipCreateRegionRect(GDIPCONST GpRectF *rect, GpRegion **region)	Region::Region(IN const RectF& rect)	Crea un'area definita da un rettangolo.
GpStatus WINGDIPAPI GdipCreateRegionRectI(GDIPCONST GpRect *rect, GpRegion **region)	Region::Region(IN const Rect& rect)	Crea un'area definita da un rettangolo.
GpStatus WINGDIPAPI GdipCreateRegionPath(GpPath *path, GpRegion **region)	Region::Region(IN const GraphicsPath* path)	Crea un'area definita da un oggetto GraphicsPath e ha una modalità di riempimento contenuta nell'oggetto GraphicsPath.
GpStatus WINGDIPAPI GdipCreateRegionRgnData(GDIPCONST BYTE *regionData, INT size, GpRegion **region)	Region::Region(IN const BYTE* regionData, INT size)	Crea un'area definita dai dati ottenuti da un'altra area.
GpStatus WINGDIPAPI GdipCreateRegionHrgn(HRGN hRgn, GpRegion **region)	Region::Region(IN HRGN hRgn)	Crea un'area identica all'area specificata da un handle a un'area GDI.
GpStatus WINGDIPAPI GdipCloneRegion(GpRegion *region, GpRegion **cloneRegion)	Region* Region::Clone() const	Crea una copia di questo oggetto Region e restituisce l'indirizzo del nuovo oggetto Region.
GpStatus WINGDIPAPI GdipDeleteRegion(GpRegion *region)	Area::~Region()	Rilascia le risorse usate dall'oggetto Region .
GpStatus WINGDIPAPI GdipSetInfinite(GpRegion *region)	Area di stato::MakeInfinite()	Aggiornamenti questa area a un'area infinita.
GpStatus WINGDIPAPI GdipSetEmpty(GpRegion *region)	Area di stato::MakeEmpty()	Aggiornamenti questa area in un'area vuota. In altre parole, l'area non occupa spazio nel dispositivo di visualizzazione.
GpStatus WINGDIPAPI GdipCombineRegionRect(GpRegion *region, GDIPCONST GpRectF *rect, CombineMode combineMode)	Area di stato::Intersect(IN const RectF& rect)	Aggiornamenti questa area alla parte di se stessa che interseca l'interno del rettangolo specificato. Il parametro combineMode nella funzione flat è un membro dell'enumerazione CombineMode che specifica la modalità di combinazione dell'area e del rettangolo.
GpStatus WINGDIPAPI GdipCombineRegionRectI(GpRegion *region, GDIPCONST GpRect *rect, CombineMode combineMode)	Area di stato::Intersect(IN const Rect& rect)	Aggiornamenti questa area alla parte di se stessa che interseca l'interno del rettangolo specificato. Il parametro combineMode nella funzione flat è un membro dell'enumerazione CombineMode che specifica la modalità di combinazione dell'area e del rettangolo.
GpStatus WINGDIPAPI GdipCombineRegionPath(GpRegion *region, GpPath *path, CombineMode combineMode)	Area di stato::Intersect(IN const GraphicsPath* path)	Aggiornamenti questa area alla parte di se stessa che interseca l'interno del percorso specificato. Il parametro combineMode nella funzione flat è un membro dell'enumerazione CombineMode che specifica come vengono combinati l'area e il percorso.
GpStatus WINGDIPAPI GdipCombineRegionRegion(GpRegion *region, GpRegion *region2, CombineMode combineMode)	Region::Intersect(IN const Region* region)	Aggiornamenti questa area alla parte di se stessa che interseca un'altra area. Il parametro combineMode nella funzione flat è un membro dell'enumerazione CombineMode che specifica come vengono combinate le aree.
GpStatus WINGDIPAPI GdipTranslateRegion(GpRegion *region, REAL dx, REAL dy)	Region::Translate(IN REAL dx, IN REAL dy)	Sfalsa questa area in base agli importi specificati nelle direzioni orizzontali e verticali.
GpStatus WINGDIPAPI GdipTranslateRegionI(GpRegion *region, INT dx, INT dy)	Area di stato::Translate(INT dx, IN INT dy)	Sfalsa questa area in base agli importi specificati nelle direzioni orizzontali e verticali.
GpStatus WINGDIPAPI GdipTransformRegion(GpRegion *region, GpMatrix *matrix)	Region::Transform(IN const Matrix* matrix)	Trasforma questa area moltiplicando ognuno dei relativi punti dati per una matrice specificata.
GpStatus WINGDIPAPI GdipGetRegionBounds(GpRegion *region, GpGraphics *graphics, GpRectF *rect)	Area di stato::GetBounds(OUT RectF* rect, IN const Graphics* g) const	Ottiene un rettangolo che racchiude l'area.
GpStatus WINGDIPAPI GdipGetRegionBoundsI(GpRegion *region, GpGraphics *graphics, GpRect *rect)	Area di stato::GetBounds(OUT Rect* rect, IN const Graphics* g) const	Ottiene un rettangolo che racchiude l'area.
GpStatus WINGDIPAPI GdipGetRegionHRgn(GpRegion *region, GpGraphics *graphics, HRGN *hRgn)	Area HRGN::GetHRGN(IN const Graphics* g) const	Crea un'area GDI da questa area.
GpStatus WINGDIPAPI GdipIsEmptyRegion(GpRegion *region, GpGraphics *graphics, BOOL *result)	BOOL Region::IsEmpty(IN const Graphics *g)const const	Determina se questa area è vuota.
GpStatus WINGDIPAPI GdipIsInfiniteRegion(GpRegion *region, GpGraphics *graphics, BOOL *result)	BOOL Region::IsInfinite(IN const Graphics *g)const const	Determina se questa area è infinita.
GpStatus WINGDIPAPI GdipIsEqualRegion(GpRegion *region, GpRegion *region2, GpGraphics *graphics, BOOL *result)	BoOL Region::Equals(IN const Region* region, IN const Graphics* g) const	Determina se questa area è uguale a un'area specificata.
GpStatus WINGDIPAPI GdipGetRegionDataSize(GpRegion *region, UINT * bufferSize)	UINT Region::GetDataSize() const	Ottiene il numero di byte di dati che descrivono questa area.
GpStatus WINGDIPAPI GdipGetRegionData(GpRegion *region, BYTE * buffer, UINT bufferSize, UINT * sizeFilled)	Area di stato::GetData(OUT BYTE* buffer, IN UINT bufferSize, OUT UINT* sizeFilled) const	Ottiene i dati che descrivono questa area.
GpStatus WINGDIPAPI GdipIsVisibleRegionPoint(GpRegion *region, REAL x, REAL y, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const PointF& point, IN const Graphics* g) const	Determina se un punto si trova all'interno di questa area. I parametri x e y nella funzione flat specificano le coordinate x e y di un punto che corrisponde al parametro point nel metodo wrapper.
GpStatus WINGDIPAPI GdipIsVisibleRegionPointI(GpRegion *region, INT x, INT y, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const Point& point, IN const Graphics* g) const	Determina se un punto si trova all'interno di questa area. I parametri x e y nella funzione flat specificano le coordinate x e y di un punto che corrisponde al parametro point nel metodo wrapper.
GpStatus WINGDIPAPI GdipIsVisibleRegionRect(GpRegion *region, REAL x, REAL y, REAL width, REAL height, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const RectF& rect, IN const Graphics* g) const	Determina se un rettangolo interseca questa area. I parametri x, y, width e height nella funzione flat specificano un rettangolo che corrisponde al parametro rect nel metodo wrapper.
GpStatus WINGDIPAPI GdipIsVisibleRegionRectI(GpRegion *region, INT x, INT y, INT width, INT height, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const Rect& rect, IN const Graphics* g) const	Determina se un rettangolo interseca questa area. I parametri x, y, width e height nella funzione flat specificano un rettangolo che corrisponde al parametro rect nel metodo wrapper.
GpStatus WINGDIPAPI GdipGetRegionScansCount(GpRegion *region, UINT* count, GpMatrix* matrix)	UINT Region::GetRegionScansCount(IN const Matrix* matrix) const	Ottiene il numero di rettangoli che approssimano questa area. L'area viene trasformata da una matrice specificata prima che vengano calcolati i rettangoli.
GpStatus WINGDIPAPI GdipGetRegionScans(GpRegion *region, GpRectF* rects, INT* count, GpMatrix* matrix)	Status Region::GetRegionScans( IN const Matrix* matrix, OUT RectF* rects, IN OUT INT* count) const	Ottiene una matrice di rettangoli che approssimano questa area. L'area viene trasformata da una matrice specificata prima che vengano calcolati i rettangoli.
GpStatus WINGDIPAPI GdipGetRegionScansI(GpRegion *region, GpRect* rects, INT* count, GpMatrix* matrix)	Area di stato::GetRegionScans( IN const Matrix* matrix, OUT Rect* rects, IN OUT INT* count) const	Ottiene una matrice di rettangoli che approssimano questa area. L'area viene trasformata da una matrice specificata prima che vengano calcolati i rettangoli.