Interface ID2D1LinearGradientBrush (d2d1.h)

  • Artigo

Pinta uma área com um gradiente linear.

Herança

A interface ID2D1LinearGradientBrush herda de ID2D1Brush. ID2D1LinearGradientBrush também tem estes tipos de membros:

Métodos

A interface ID2D1LinearGradientBrush tem esses métodos.

 
ID2D1LinearGradientBrush::GetEndPoint

Recupera as coordenadas finais do gradiente linear.
ID2D1LinearGradientBrush::GetGradientStopCollection

Recupera o ID2D1GradientStopCollection associado a esse pincel de gradiente linear.
ID2D1LinearGradientBrush::GetStartPoint

Recupera as coordenadas iniciais do gradiente linear.
ID2D1LinearGradientBrush::SetEndPoint

Define as coordenadas finais do gradiente linear no espaço de coordenadas do pincel.
ID2D1LinearGradientBrush::SetStartPoint

Define as coordenadas iniciais do gradiente linear no espaço de coordenadas do pincel.

Comentários

Um ID2D1LinearGradientBrush pinta uma área com um gradiente linear ao longo de uma linha entre o ponto inicial do pincel e o ponto final. O gradiente, definido pelo pincel ID2D1GradientStopCollection, é extrudado perpendicular a essa linha e, em seguida, transformado por uma transformação de pincel (se especificado).

O ponto inicial e o ponto de extremidade são descritos no espaço de pincel e são mapeados para o destino de renderização quando o pincel é usado. Observe que as coordenadas inicial e final são absolutas, não em relação ao tamanho do destino de renderização. Um valor de (0, 0) é mapeado para o canto superior esquerdo do destino de renderização, enquanto um valor de (1, 1) mapeia um pixel diagonalmente de (0, 0). Se houver uma transformação de pincel de não entidade ou transformação de destino de renderização, o ponto inicial e o ponto de extremidade do pincel também serão transformados.

É possível especificar um eixo de gradiente que não preencha completamente a área que está sendo pintada. Quando isso ocorre, o D2D1_EXTEND_MODE, especificado pelo ID2D1GradientStopCollection, determina como a área restante é pintada.

Criando objetos ID2D1LinearGradientBrush

Para criar um pincel de gradiente linear, use o método ID2D1RenderTarget::CreateLinearGradientBrush do destino de renderização no qual o pincel será usado. O pincel só pode ser usado com o destino de renderização que o criou ou com os destinos compatíveis para esse destino de renderização.

Um pincel de gradiente linear é um recurso dependente do dispositivo: seu aplicativo deve criar pincéis de gradiente linear depois de inicializar o destino de renderização com o qual os pincéis serão usados e recriar os pincéis sempre que o destino de renderização precisar ser recriado. (Para obter mais informações sobre recursos, consulte Visão geral de recursos.)

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1.h

Confira também

ID2D1Brush