LinearGradientBrush.StartPoint Propriété

Définition

Obtient ou définit les coordonnées à deux dimensions de départ du dégradé linéaire.Gets or sets the starting two-dimensional coordinates of the linear gradient.

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

Valeur de propriété

Coordonnées à deux dimensions de début du dégradé linéaire.The starting two-dimensional coordinates for the linear gradient. La valeur par défaut est (0, 0).The default is (0, 0).

Remarques

Un LinearGradientBrush peint un dégradé le long d’une ligne.A LinearGradientBrush paints a gradient along a line. Les points de début et de fin de la ligne sont définis par les propriétés StartPoint et EndPoint de la LinearGradientBrush.The line's start and end points are defined by the StartPoint and EndPoint properties of the LinearGradientBrush.

Le dégradé linéaire par défaut est diagonal.The default linear gradient is diagonal. Dans la valeur par défaut, le StartPoint d’un dégradé linéaire est (0,0), le coin supérieur gauche de la zone remplie et son EndPoint est (1,1), le coin inférieur droit de la zone remplie.In the default, the StartPoint of a linear gradient is (0,0), the upper-left corner of the area being filled, and its EndPoint is (1,1), the lower-right corner of the area being filled. Les couleurs du dégradé résultant sont interpolées le long du tracé Diagonal.The colors in the resulting gradient are interpolated along the diagonal path.

L’image suivante montre un dégradé Diagonal.The following image shows a diagonal gradient. La ligne noire a été ajoutée pour mettre en surbrillance le chemin d’interpolation du dégradé du point de départ jusqu’au point de terminaison.The black line was added to highlight the interpolation path of the gradient from the start point to the end point.

Axe du dégradé pour un dégradé linéaire DiagonalGradient axis for a diagonal linear gradient
Dégradé linéaire en diagonaleA diagonal linear gradient

Spécification de valeurs relatives ou absoluesSpecifying Relative or Absolute Values

Notez que la propriété MappingMode d’un LinearGradientBrush détermine si son StartPoint est interprété comme une valeur relative ou absolue.Note that the MappingMode property of a LinearGradientBrush determines whether its StartPoint is interpreted as a relative or absolute value. Une MappingMode de RelativeToBoundingBox spécifie que la valeur de EndPoint est relative à la taille de la zone peinte.A MappingMode of RelativeToBoundingBox specifies that the EndPoint value is relative to the size of the painted area. Une MappingMode de Absolute spécifie que la valeur de StartPoint est exprimée en DIP (Device Independent Pixel).A MappingMode of Absolute specifies that the StartPoint value is expressed in device independent pixels. Par défaut, le MappingMode est défini sur RelativeToBoundingBox, ce qui fait de la StartPoint une valeur relative.By default, the MappingMode is set to RelativeToBoundingBox, making the StartPoint a relative value.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field StartPointProperty
Propriétés de métadonnées définies sur trueMetadata properties set to true NoneNone

S’applique à

Voir aussi