Fonctions de région (GDI+)
Windows GDI+ expose une API plate qui se compose d’environ 600 fonctions, qui sont implémentées dans Gdiplus.dll et déclarées dans Gdiplusflat. h. les fonctions de l’API plate GDI+ sont encapsulées par une collection d’environ 40 classes C++. Il est recommandé de ne pas appeler directement les fonctions dans l’API plate. chaque fois que vous effectuez des appels à GDI+, vous devez le faire en appelant les méthodes et les fonctions fournies par les wrappers C++. Les services de support technique Microsoft ne fournissent pas de prise en charge du code qui appelle l’API plate directement. pour plus d’informations sur l’utilisation de ces méthodes wrapper, consultez GDI+ l’API plate.
Les fonctions d’API plates suivantes sont encapsulées par la classe C++ de la région .
Fonctions de région et méthodes Wrapper correspondantes
| Fonction plate | Méthode Wrapper | Notes |
|---|---|---|
| GpStatus WINGDIPAPI GdipCreateRegion ( * * région GpRegion) |
Region :: Region () |
Crée une région qui est infinie. Il s'agit du constructeur par défaut. |
| GpStatus WINGDIPAPI GdipCreateRegionRect (GDIPCONST GpRectF * Rect, GpRegion * * Region) |
Region :: Region (dans const RectF& Rect) |
Crée une région qui est définie par un rectangle. |
| GpStatus WINGDIPAPI GdipCreateRegionRectI (GDIPCONST GpRect * Rect, GpRegion * * Region) |
Region :: Region (dans const Rect& Rect) |
Crée une région qui est définie par un rectangle. |
| GpStatus WINGDIPAPI GdipCreateRegionPath (GpPath * Path, GpRegion * * Region) |
Region :: Region (dans le * chemin d’accès const GraphicsPath) |
Crée une région qui est définie par un objet GraphicsPath et possède un mode de remplissage contenu dans l’objet GraphicsPath. |
| GpStatus WINGDIPAPI GdipCreateRegionRgnData (GDIPCONST BYTE * regionData, int size, GpRegion * * Region) |
Region :: Region (dans const BYTE * regionData, en taille int) |
Crée une région qui est définie par les données obtenues à partir d’une autre région. |
| GpStatus WINGDIPAPI GdipCreateRegionHrgn (HRGN hRgn, * * région GpRegion) |
Region :: Region (dans HRGN hRgn) |
Crée une région qui est identique à la région spécifiée par un handle vers une région GDI. |
| GpStatus WINGDIPAPI GdipCloneRegion ( * région GpRegion, GpRegion * * cloneRegion) |
Région Region * :: Clone () const |
Effectue une copie de cet objet de région et retourne l’adresse du nouvel objet de région. |
| GpStatus WINGDIPAPI GdipDeleteRegion ( * région GpRegion) |
Region :: ~ Region () |
Libère les ressources utilisées par l’objet Region . |
| GpStatus WINGDIPAPI GdipSetInfinite ( * région GpRegion) |
État Region :: MakeInfinite () |
Met à jour cette région vers une région infinie. |
| GpStatus WINGDIPAPI GdipSetEmpty ( * région GpRegion) |
État Region :: MakeEmpty () |
Met à jour cette région vers une région vide. En d’autres termes, la région n’occupe aucun espace sur le périphérique d’affichage. |
| GpStatus WINGDIPAPI GdipCombineRegionRect ( * région GpRegion, GDIPCONST GpRectF * Rect, CombineMode CombineMode) |
Status Region :: Intersect (dans const RectF& Rect) |
Met à jour cette région avec la partie de elle-même qui croise l’intérieur du rectangle spécifié. Le paramètre combineMode dans la fonction Flat est un membre de l’énumération combineMode qui spécifie la manière dont la région et le rectangle sont combinés. |
| GpStatus WINGDIPAPI GdipCombineRegionRectI ( * région GpRegion, GDIPCONST GpRect * Rect, CombineMode CombineMode) |
Status Region :: Intersect (dans const Rect& Rect) |
Met à jour cette région avec la partie de elle-même qui croise l’intérieur du rectangle spécifié. Le paramètre combineMode dans la fonction Flat est un membre de l’énumération combineMode qui spécifie la manière dont la région et le rectangle sont combinés. |
| GpStatus WINGDIPAPI GdipCombineRegionPath ( * région GpRegion, * chemin GpPath, CombineMode CombineMode) |
Status Region :: Intersect (dans le chemin const GraphicsPath * ) |
Met à jour cette région avec la partie de elle-même qui croise l’intérieur du chemin d’accès spécifié. Le paramètre combineMode dans la fonction Flat est un membre de l’énumération combineMode qui spécifie la façon dont la région et le chemin d’accès sont combinés. |
| GpStatus WINGDIPAPI GdipCombineRegionRegion ( * région GpRegion, GpRegion * Region2, CombineMode CombineMode) |
Region :: Intersect (dans la région de la région const * ) |
Met à jour cette région avec la partie de elle-même qui croise une autre région. Le paramètre combineMode dans la fonction Flat est un membre de l’énumération combineMode qui spécifie la façon dont les régions sont combinées. |
| GpStatus WINGDIPAPI GdipTranslateRegion ( * région GpRegion, DX réel, en réalité dy) |
Region :: translate (dans le DX réel, en véritable dy) |
Décale cette région en valeurs spécifiées dans les directions horizontale et verticale. |
| GpStatus WINGDIPAPI GdipTranslateRegionI ( * région GpRegion, int DX, int dy) |
État Region :: translate (dans INT DX, en INT dy) |
Décale cette région en valeurs spécifiées dans les directions horizontale et verticale. |
| GpStatus WINGDIPAPI GdipTransformRegion ( * région GpRegion, GpMatrix * Matrix) |
Region :: Transform (dans la matrice de matrice const * ) |
Transforme cette région en multipliant chacun de ses points de données par une matrice spécifiée. |
| GpStatus WINGDIPAPI GdipGetRegionBounds ( * région GpRegion, GpGraphics * Graphics, GpRectF * Rect) |
État Region :: GetBounds (OUT RectF * Rect, dans const Graphics * g) const |
Obtient un rectangle qui englobe cette région. |
| GpStatus WINGDIPAPI GdipGetRegionBoundsI ( * région GpRegion, GpGraphics * Graphics, GpRect * Rect) |
État Region :: GetBounds (OUT Rect * Rect, dans const Graphics * g) const |
Obtient un rectangle qui englobe cette région. |
| GpStatus WINGDIPAPI GdipGetRegionHRgn ( * région GpRegion, GpGraphics * Graphics, hrgn * hrgn) |
HRGN Region :: GetHRGN (dans const Graphics * g) const |
Crée une région GDI à partir de cette région. |
| GpStatus WINGDIPAPI GdipIsEmptyRegion ( * région GpRegion, GpGraphics * Graphics, bool * result) |
BOOL Region :: IsEmpty (dans const Graphics * g) const |
Détermine si cette région est vide. |
| GpStatus WINGDIPAPI GdipIsInfiniteRegion ( * région GpRegion, GpGraphics * Graphics, bool * result) |
BOOL Region :: IsInfinite (dans const Graphics * g) const |
Détermine si cette région est infinie. |
| GpStatus WINGDIPAPI GdipIsEqualRegion ( * région GpRegion, GpRegion * Region2, GpGraphics * Graphics, bool * result) |
BOOL Region :: Equals (dans la région de la région const * , dans const Graphics * g) const |
Détermine si cette région est égale à une région spécifiée. |
| GpStatus WINGDIPAPI GdipGetRegionDataSize ( * région GpRegion, uint * bufferSize) |
UINT Region :: GetDataSize () const |
Obtient le nombre d’octets de données qui décrivent cette région. |
| GpStatus WINGDIPAPI GdipGetRegionData ( * région GpRegion, * mémoire tampon d’octets, uint bufferSize, uint * sizeFilled) |
État Region :: GetData ( * mémoire tampon de sortie, dans uint bufferSize, out uint * sizeFilled) const |
Obtient les données qui décrivent cette région. |
| GpStatus WINGDIPAPI GdipIsVisibleRegionPoint ( * région GpRegion, x réel, réel y, * graphique GpGraphics, * résultat bool) |
BOOL Region :: IsVisible (dans const PointF& point, dans const Graphics * g) const |
Détermine si un point se trouve à l’intérieur de cette région. Les paramètres x et y de la fonction Flat spécifient les coordonnées x et y d’un point qui correspond au paramètre point dans la méthode wrapper. |
| GpStatus WINGDIPAPI GdipIsVisibleRegionPointI ( * région GpRegion, int x, int y, GpGraphics * Graphics, bool * result) |
BOOL Region :: IsVisible (au point const point& point, dans const Graphics * g) const |
Détermine si un point se trouve à l’intérieur de cette région. Les paramètres x et y de la fonction Flat spécifient les coordonnées x et y d’un point qui correspond au paramètre point dans la méthode wrapper. |
| GpStatus WINGDIPAPI GdipIsVisibleRegionRect ( * région GpRegion, x réel, réel y, largeur réelle, hauteur réelle, * graphiques GpGraphics, * résultat bool) |
BOOL Region :: IsVisible (dans const RectF& Rect, dans const Graphics * g) const |
Détermine si un rectangle croise cette région. Les paramètres x, y, Width et Height de la fonction Flat spécifient un rectangle qui correspond au paramètre Rect dans la méthode wrapper. |
| GpStatus WINGDIPAPI GdipIsVisibleRegionRectI ( * région GpRegion, int x, int y, int Width, int Height, GpGraphics * Graphics, bool * result) |
BOOL Region :: IsVisible (dans const Rect& Rect, dans const Graphics * g) const |
Détermine si un rectangle croise cette région. Les paramètres x, y, Width et Height de la fonction Flat spécifient un rectangle qui correspond au paramètre Rect dans la méthode wrapper. |
| GpStatus WINGDIPAPI GdipGetRegionScansCount ( * région GpRegion, uint * Count, GpMatrix * Matrix) |
UINT Region :: GetRegionScansCount (dans une matrice const matrice * ) const |
Obtient le nombre de rectangles qui se rapprochent de cette région. La région est transformée en une matrice spécifiée avant le calcul des rectangles. |
| GpStatus WINGDIPAPI GdipGetRegionScans ( * région GpRegion, GpRectF * RECTS, int * Count, GpMatrix * Matrix) |
État Region :: GetRegionScans (dans la matrice de matrice const * , sortie RectF * RECTS, en sortie int * Count) const |
Obtient un tableau de rectangles qui se rapprochent de cette région. La région est transformée en une matrice spécifiée avant le calcul des rectangles. |
| GpStatus WINGDIPAPI GdipGetRegionScansI ( * région GpRegion, GpRect * RECTS, int * Count, GpMatrix * Matrix) |
État Region :: GetRegionScans (dans la matrice de matrice const * , sortie Rect * recto, en sortie de * nombre entier) const |
Obtient un tableau de rectangles qui se rapprochent de cette région. La région est transformée en une matrice spécifiée avant le calcul des rectangles. |