estructura D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES (d2d1.h)
Contiene el punto inicial y el punto de conexión del eje de degradado para un id2D1LinearGradientBrush.
Sintaxis
typedef struct D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES {
D2D1_POINT_2F startPoint;
D2D1_POINT_2F endPoint;
} D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES;
Miembros
startPoint
Tipo: D2D1_POINT_2F
En el espacio de coordenadas del pincel, el punto inicial del eje de degradado.
endPoint
Tipo: D2D1_POINT_2F
En el espacio de coordenadas del pincel, el extremo del eje de degradado.
Comentarios
Utilice este método al crear nuevos objetos ID2D1LinearGradientBrush con el método CreateLinearGradientBrush . Para mayor comodidad, Direct2D proporciona la función auxiliar D2D1::LinearGradientBrushProperties para crear nuevas estructuras de D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES .
En la ilustración siguiente se muestra cómo cambia un degradado lineal a medida que cambia sus puntos inicial y final. Para el primer degradado, el punto inicial se establece en (0,0) y el punto final en (150, 50); esto crea un degradado diagonal que comienza en la esquina superior izquierda y se extiende a la esquina inferior derecha del área que se está pintando. Al establecer el punto inicial en (0, 25) y el punto final en (150, 25), se crea un degradado horizontal. Del mismo modo, al establecer el punto de inicio en (75, 0) y el punto final en (75, 50) se crea un degradado vertical. Al establecer el punto inicial en (0, 50) y el punto final en (150, 0), se crea un degradado diagonal que comienza en la esquina inferior izquierda y se extiende a la esquina superior derecha del área que se está pintando.
Ejemplos
En el ejemplo siguiente se usa el método CreateLinearGradientBrush para crear un id2D1LinearGradientBrush (m_pLinearGradientBrush). Usa el método auxiliar D2D1::LinearGradientBrushProperties para crear una estructura de D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES que contenga un punto inicial de (0, 0) y un punto final de (150, 150) y lo pasa al método CreateLinearGradientBrush .
// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.
if (SUCCEEDED(hr))
{
hr = m_pRenderTarget->CreateLinearGradientBrush(
D2D1::LinearGradientBrushProperties(
D2D1::Point2F(0, 0),
D2D1::Point2F(150, 150)),
pGradientStops,
&m_pLinearGradientBrush
);
}
Para obtener más información sobre cómo crear y usar pinceles de degradado lineal, vea el tema How to Create a Linear Gradient Brush (Cómo crear un pincel lineal) y la Información general sobre pinceles.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Encabezado | d2d1.h |