Función EngStrokePath (winddi.h)

Artículo
08/27/2023

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