LinearGradientBrush Clase

Definición

Pinta un área con un degradado lineal.Paints an area with a linear gradient.

public ref class LinearGradientBrush sealed : System::Windows::Media::GradientBrush
public sealed class LinearGradientBrush : System.Windows.Media.GradientBrush
type LinearGradientBrush = class
    inherit GradientBrush
Public NotInheritable Class LinearGradientBrush
Inherits GradientBrush
Herencia

Comentarios

LinearGradientBrush Dibuja un área con un degradado lineal.A LinearGradientBrush paints an area with a linear gradient. Un degradado lineal define un degradado a lo largo de una línea.A linear gradient defines a gradient along a line. Los puntos finales de la línea se definen mediante StartPoint las EndPoint propiedades y del degradado lineal.The line's end points are defined by the StartPoint and EndPoint properties of the linear gradient. Un LinearGradientBrush pincel pinta su GradientStops A lo largo de esta línea.A LinearGradientBrush brush paints its GradientStops along this line.

El degradado lineal predeterminado es diagonal.The default linear gradient is diagonal. En el valor predeterminado, StartPoint el de un degradado lineal es (0,0), la esquina superior izquierda del área que se está pintando y su EndPoint es (1,1), la esquina inferior derecha del área que se está pintando.In the default, the StartPoint of a linear gradient is (0,0), the upper-left corner of the area being painted, and its EndPoint is (1,1), the lower-right corner of the area being painted. Los colores del degradado resultante se interpolan a lo largo de la ruta diagonal.The colors in the resulting gradient are interpolated along the diagonal path.

En la ilustración siguiente se muestra un degradado diagonal.The following illustration shows a diagonal gradient. Se ha agregado una línea para resaltar la ruta de la interpolación del degradado desde el punto inicial hasta el punto final.A line was added to highlight the interpolation path of the gradient from the start point to the end point.

![Eje de degradado para un degradado lineal diagonal] (~/add/media/wcpsdk-graphicsmm-diagonalgradientaxis.png "Eje de degradado para un degradado lineal diagonal")Gradient axis for a diagonal linear gradient
Degradado lineal diagonalA diagonal linear gradient

En la ilustración siguiente se muestra el mismo degradado lineal, pero con delimitadores de degradado resaltados.The next illustration shows the same linear gradient, but with highlighted gradient stops.

![Delimitadores de degradado en un degradado lineal] (~/add/media/wcpsdk-graphicsmm-4gradientstops.png "Delimitadores de degradado en un degradado lineal")Gradient stops in a linear gradient
Degradado lineal diagonal con delimitadores de degradado resaltadosA diagonal linear gradient with highlighted gradient stops

Es posible especificar un eje de degradado que no rellene completamente el área que se está pintando.It is possible to specify a gradient axis that does not completely fill area being painted. Cuando esto ocurre, la SpreadMethod propiedad determina cómo se pinta el área restante.When this occurs, the SpreadMethod property determines how the remaining area is painted.

Características de los objetos FreezableFreezable Features

Un LinearGradientBrush es un tipo de Freezable objeto y, por tanto, se puede inmovilizar para mejorar el rendimiento.A LinearGradientBrush is a type of Freezable object and therefore can be frozen to improve performance. Para obtener información Freezable sobre las características, como la inmovilización y la clonación, vea información general sobre objetos Freezable.For information about Freezable features, such as freezing and cloning, see Freezable Objects Overview.

Constructores

LinearGradientBrush()

Inicializa una nueva instancia de la clase LinearGradientBrush.Initializes a new instance of the LinearGradientBrush class.

LinearGradientBrush(Color, Color, Double)

Inicializa una nueva instancia de la clase LinearGradientBrush que tiene el Color inicial, Color final y ángulo especificados.Initializes a new instance of the LinearGradientBrush class that has the specified start Color, end Color, and angle.

LinearGradientBrush(Color, Color, Point, Point)

Inicializa una nueva instancia de la clase LinearGradientBrush con el Color inicial, Color final, StartPoint y EndPoint especificados.Initializes a new instance of the LinearGradientBrush class that has the specified start Color, end Color, StartPoint, and EndPoint.

LinearGradientBrush(GradientStopCollection)

Inicializa una nueva instancia de la clase LinearGradientBrush con los puntos de degradado especificados.Initializes a new instance of the LinearGradientBrush class that has the specified gradient stops.

LinearGradientBrush(GradientStopCollection, Double)

Inicializa una nueva instancia de la clase LinearGradientBrush con la colección GradientStopCollection y el ángulo especificados.Initializes a new instance of the LinearGradientBrush class that has the specified GradientStopCollection and angle.

LinearGradientBrush(GradientStopCollection, Point, Point)

Inicializa una nueva instancia de la clase LinearGradientBrush con los delimitadores de degradado, StartPoint y EndPoint especificados.Initializes a new instance of the LinearGradientBrush class that has the specified gradient stops, StartPoint, and EndPoint.

Campos

EndPointProperty

Identifica la propiedad de dependencia EndPoint.Identifies the EndPoint dependency property.

StartPointProperty

Identifica la propiedad de dependencia StartPoint.Identifies the StartPoint dependency property.

Propiedades

CanFreeze

Obtiene un valor que indica si el objeto se puede convertir en no modificable.Gets a value that indicates whether the object can be made unmodifiable.

(Heredado de Freezable)
ColorInterpolationMode

Obtiene o establece una enumeración ColorInterpolationMode que especifica cómo se interpolan los colores del degradado.Gets or sets a ColorInterpolationMode enumeration that specifies how the gradient's colors are interpolated.

(Heredado de GradientBrush)
DependencyObjectType

Obtiene el objeto DependencyObjectType que ajusta el tipo CLRCLR de esta instancia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Heredado de DependencyObject)
Dispatcher

Obtiene el objeto Dispatcher al que está asociado DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Heredado de DispatcherObject)
EndPoint

Obtiene o establece las coordenadas bidimensionales finales del degradado lineal.Gets or sets the ending two-dimensional coordinates of the linear gradient.

GradientStops

Obtiene o establece los delimitadores de degradado del pincel.Gets or sets the brush's gradient stops.

(Heredado de GradientBrush)
HasAnimatedProperties

Obtiene un valor que indica si uno o más objetos AnimationClock se asocian a cualquiera de las propiedades de dependencia de este objeto.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Heredado de Animatable)
IsFrozen

Obtiene un valor que indica si el objeto se puede modificar actualmente.Gets a value that indicates whether the object is currently modifiable.

(Heredado de Freezable)
IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Heredado de DependencyObject)
MappingMode

Obtiene o establece una enumeración BrushMappingMode que especifica si las coordenadas de posicionamiento del pincel de degradado son absolutas o relativas con respecto al área de salida.Gets or sets a BrushMappingMode enumeration that specifies whether the gradient brush's positioning coordinates are absolute or relative to the output area.

(Heredado de GradientBrush)
Opacity

Obtiene o establece el grado de opacidad de Brush.Gets or sets the degree of opacity of a Brush.

(Heredado de Brush)
RelativeTransform

Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas.Gets or sets the transformation that is applied to the brush using relative coordinates.

(Heredado de Brush)
SpreadMethod

Obtiene o establece el tipo de método de propagación que especifica cómo dibujar un degradado que comienza o finaliza dentro de los límites del objeto que se pinta.Gets or sets the type of spread method that specifies how to draw a gradient that starts or ends inside the bounds of the object to be painted.

(Heredado de GradientBrush)
StartPoint

Obtiene o establece las coordenadas bidimensionales iniciales del degradado lineal.Gets or sets the starting two-dimensional coordinates of the linear gradient.

Transform

Obtiene o establece la transformación que se aplica al pincel.Gets or sets the transformation that is applied to the brush. Esta transformación se aplica después de haber asignado y colocado la salida del pincel.This transformation is applied after the brush's output has been mapped and positioned.

(Heredado de Brush)

Métodos

ApplyAnimationClock(DependencyProperty, AnimationClock)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado.If the property is already animated, the specified HandoffBehavior is used.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado.If the specified property is already animated, the specified HandoffBehavior is used.

(Heredado de Animatable)
CheckAccess()

Determina si el subproceso de la llamada tiene acceso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Heredado de DispatcherObject)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad.Clears the local value of a property. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura.Clears the local value of a read-only property. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Heredado de DependencyObject)
Clone()

Crea un clon modificable de este LinearGradientBrush y hace copias en profundidad de los valores de este objeto.Creates a modifiable clone of this LinearGradientBrush, making deep copies of this object's values. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque podrían no resolverse), pero no copia las animaciones ni sus valores actuales.When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

CloneCore(Freezable)

Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con valores de propiedad base (no animadas).Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Heredado de Freezable)
CloneCurrentValue()

Crea un clon modificable de este objeto LinearGradientBrush y hace copias en profundidad de sus valores actuales.Creates a modifiable clone of this LinearGradientBrush object, making deep copies of this object's current values. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.Resource references, data bindings, and animations are not copied, but their current values are.

CloneCurrentValueCore(Freezable)

Convierte esta instancia en un clon modificable (copia en profundidad) del Freezable especificado mediante los valores de propiedad actuales.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Heredado de Freezable)
CoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada.Coerces the value of the specified dependency property. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Heredado de DependencyObject)
CreateInstance()

Inicializa una nueva instancia de la clase Freezable.Initializes a new instance of the Freezable class.

(Heredado de Freezable)
CreateInstanceCore()

Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Heredado de Freezable)
Equals(Object)

Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Heredado de DependencyObject)
Freeze()

Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Heredado de Freezable)
FreezeCore(Boolean)

Convierte este objeto Animatable en no modificable o determina si se puede convertir en no modificable.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Heredado de Animatable)
GetAnimationBaseValue(DependencyProperty)

Devuelve el valor no animado del objeto DependencyProperty especificado.Returns the non-animated value of the specified DependencyProperty.

(Heredado de Animatable)
GetAsFrozen()

Crea una copia inmovilizada de Freezable, con los valores de propiedades base (no animadas).Creates a frozen copy of the Freezable, using base (non-animated) property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Heredado de Freezable)
GetAsFrozenCore(Freezable)

Convierte la instancia en un clon inmovilizado de la clase Freezable especificada con los valores de propiedades base (no animadas).Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Heredado de Freezable)
GetCurrentValueAsFrozen()

Crea una copia inmovilizada de Freezable con los valores de propiedad actuales.Creates a frozen copy of the Freezable using current property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Convierte la instancia actual en un clon inmovilizado de la clase Freezable especificada.Makes the current instance a frozen clone of the specified Freezable. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales.If the object has animated dependency properties, their current animated values are copied.

(Heredado de Freezable)
GetHashCode()

Obtiene el código hash de DependencyObject.Gets a hash code for this DependencyObject.

(Heredado de DependencyObject)
GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Heredado de DependencyObject)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada.Re-evaluates the effective value for the specified dependency property.

(Heredado de DependencyObject)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnChanged()

Se le llama cuando el objeto Freezable actual se modifica.Called when the current Freezable object is modified.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Reemplaza la implementación DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también cualquier controlador Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Heredado de Freezable)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.Returns the local value of a dependency property, if it exists.

(Heredado de DependencyObject)
ReadPreamble()

Se asegura de que se tiene acceso a Freezable desde un subproceso válido.Ensures that the Freezable is being accessed from a valid thread. Los herederos de Freezable deben llamar a este método al inicio de las API que leen miembros de datos que no son propiedades de dependencia.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor.Sets the value of a dependency property without changing its value source.

(Heredado de DependencyObject)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.Sets the local value of a dependency property, specified by its dependency property identifier.

(Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia suministrada.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Heredado de DependencyObject)
ToString()

Devuelve una representación en forma de cadena de Brush.Return string representation of this Brush.

(Heredado de Brush)
ToString(IFormatProvider)

Crea una representación de cadena de este objeto con la información de formato específica de la referencia cultural especificada.Creates a string representation of this object based on the specified culture-specific formatting information.

(Heredado de Brush)
VerifyAccess()

Exige que el subproceso de la llamada tenga acceso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Heredado de DispatcherObject)
WritePostscript()

Genera el evento Changed para Freezable e invoca su método OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no estén almacenados como propiedades de dependencia.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Heredado de Freezable)
WritePreamble()

Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Los herederos de Freezable deben llamar a este método al inicio de las API que escriben en miembros de datos que no son propiedades de dependencia.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Heredado de Freezable)

Eventos

Changed

Se produce cuando se modifican la clase Freezable o un objeto que la contiene.Occurs when the Freezable or an object it contains is modified.

(Heredado de Freezable)

Implementaciones de interfaz explícitas

IFormattable.ToString(String, IFormatProvider)

Aplica formato al valor de la instancia actual utilizando el formato especificado.Formats the value of the current instance using the specified format.

(Heredado de Brush)

Se aplica a

Consulte también: