Función EngStrokePath (winddi.h)
La función EngStrokePath solicita que GDI trazo una ruta de acceso especificada.
Sintaxis
ENGAPI BOOL EngStrokePath(
SURFOBJ *pso,
PATHOBJ *ppo,
CLIPOBJ *pco,
XFORMOBJ *pxo,
BRUSHOBJ *pbo,
POINTL *pptlBrushOrg,
[in] LINEATTRS *plineattrs,
[in] MIX mix
);
Parámetros
pso
Puntero a una estructura SURFOBJ que describe la superficie en la que se va a dibujar.
ppo
Puntero a una estructura PATHOBJ . Las rutinas de servicio PATHOBJ_Xxx se proporcionan para enumerar las líneas, las curvas Bezier y otros datos que componen la ruta de acceso. Esto indica lo que se va a dibujar.
pco
Puntero a una estructura CLIPOBJ . Las rutinas de servicio CLIPOBJ_Xxx se proporcionan para enumerar la región de clip como un conjunto de rectángulos. Opcionalmente, esta CLIPOBJ puede enumerar todas las líneas de la ruta de acceso. Esto significa que los controladores pueden hacer todos sus cálculos de recorte de líneas para ellos.
pxo
Puntero a una estructura XFORMOBJ . Esto solo es necesario cuando se va a dibujar una línea ancha geométrica. Especifica la transformación que convierte las coordenadas del mundo en coordenadas del dispositivo. Esto es necesario porque la ruta de acceso se proporciona en coordenadas del dispositivo, pero una línea ancha geométrica se amplía realmente en coordenadas del mundo.
El controlador puede usar las rutinas de servicio XFORMOBJ_Xxx para determinar la transformación.
pbo
Puntero a una estructura BRUSHOBJ que especifica el pincel que se va a usar al dibujar la ruta de acceso.
pptlBrushOrg
Puntero a una estructura POINTL que contiene el origen del pincel usado para alinear el patrón de pincel en el dispositivo.
[in] plineattrs
Puntero a una estructura LINEATTRS . Tenga en cuenta que el miembro elStyleState de esta estructura debe actualizarse como parte de esta función si se aplica estilo a la línea. Tenga en cuenta también que el miembro ptlLastPel de la misma estructura debe actualizarse si se dibuja una línea cosmética de ancho de píxel único.
[in] mix
Especifica cómo combinar el pincel con el destino.
Valor devuelto
El valor devuelto es TRUE si GDI tratiza la ruta de acceso. Si el controlador debe trazar la ruta de acceso, el valor devuelto es FALSE y no se registra ningún error. Si GDI encuentra un error, se DDI_ERROR el valor devuelto y se registra un código de error.
Comentarios
El modo de combinación define cómo se debe mezclar el patrón entrante con los datos que ya están en la superficie del dispositivo. El tipo de datos MIX consta de dos valores ROP2 empaquetados en un único ULONG. El byte de orden bajo define la operación de trama en primer plano; el byte siguiente define la operación de trama en segundo plano. Para obtener más información sobre los códigos de operación de trama, consulte la documentación de Microsoft Windows SDK.
Requisitos
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |