Partilhar via


LinearGradientBrush.StartPoint Propriedade

Definição

Obtém ou define as coordenadas bidimensionais de início do gradiente linear.

public:
 property System::Windows::Point StartPoint { System::Windows::Point get(); void set(System::Windows::Point value); };
public System.Windows.Point StartPoint { get; set; }
member this.StartPoint : System.Windows.Point with get, set
Public Property StartPoint As Point

Valor da propriedade

Point

As coordenadas bidimensionais iniciais para o gradiente linear. O padrão é (0, 0).

Comentários

Um LinearGradientBrush pinta um gradiente ao longo de uma linha. Os pontos de início e de término da linha são definidos pela e EndPoint pelas StartPoint propriedades do LinearGradientBrush.

O gradiente linear padrão é diagonal. No padrão, o StartPoint gradiente linear é (0,0), o canto superior esquerdo da área que está sendo preenchida e EndPoint é (1,1), o canto inferior direito da área que está sendo preenchida. As cores no gradiente resultante são interpoladas ao longo do caminho diagonal.

A imagem a seguir mostra um gradiente diagonal. A linha preta foi adicionada para realçar o caminho de interpolação do gradiente do ponto de partida até o ponto final.

Eixo de gradiente para um gradiente linear diagonal
Um gradiente linear diagonal

Especificando valores relativos ou absolutos

Observe que a MappingMode propriedade de um LinearGradientBrush determina se ela StartPoint é interpretada como um valor relativo ou absoluto. Um MappingMode dos RelativeToBoundingBox especifica que o EndPoint valor é relativo ao tamanho da área pintada. Um MappingMode dos Absolute especifica que o StartPoint valor é expresso em pixels independentes do dispositivo. Por padrão, o MappingMode valor é definido como RelativeToBoundingBox, tornando-o StartPoint um valor relativo.

Informações da propriedade de dependência

Campo identificador StartPointProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também