wingdi.h


ExtCreateRegion

La función ExtCreateRegion crea una región a partir de una especificada y los datos de transformación.

Sintaxis

HRGN ExtCreateRegion(
    CONST XFORM *lpXform,     // puntero a datos de transformación
    DWORD nCount,             // tamaño de estructura que contiene los datos de región
    CONST RGNDATA *lpRgnData  // puntero a datos de región
   );

Parámetros

lpXform: puntero a una estructura XFORM que define la transformación a realizar en la región. Si este puntero es NULL, se usa la transformación de identidad.

nCount: especifica el número de bytes apuntados por lpRgnData.

lpRgnData: puntero a estructura RGNDATA que contiene los datos de la región.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el de la región.

Si la función falla, el valor de retorno es NULL.

Observaciones

Una aplicación puede recuperar datos de una región llamando a la función GetRegionData.

Windows 95: las regiones no pueden ser mayores que el límite de 64K.

Windows 95: las transformaciones que impliquen cortes o rotaciones no son soportadas. ExtCreateRegion falla si la matriz de tranformación es cualquiera que no sea un cambio de escala o una traslación de la región.