CompositionRadialGradientBrush Класс

Определение

Пространство имен:

Microsoft.UI.Composition

Представляет кисть, которая красит область радиальным градиентом.

public ref class CompositionRadialGradientBrush sealed : CompositionGradientBrush

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class CompositionRadialGradientBrush final : CompositionGradientBrush

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class CompositionRadialGradientBrush : CompositionGradientBrush

Public NotInheritable Class CompositionRadialGradientBrush
Inherits CompositionGradientBrush

Наследование

Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionGradientBrush CompositionRadialGradientBrush

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Примеры

Создание радиальной кисти градиента

В этом примере показано, как создать радиальную градиентную кисть, добавить 2 остановки цвета и нарисовать с ним spriteVisual.

// Create radial gradient brush.
CompositionRadialGradientBrush RGBrush = compositor.CreateRadialGradientBrush();

// Create the color stops by defining the offset and color.
CompositionColorGradientStop ColorStop1 = compositor.CreateColorGradientStop();
ColorStop1.Offset = 0;
ColorStop1.Color = Colors.Blue;
CompositionColorGradientStop ColorStop2 = compositor.CreateColorGradientStop();
ColorStop2.Offset = 1;
ColorStop2.Color = Colors.Yellow;

// Add the color stops to brush's ColorStops collection.
RGBrush.ColorStops.Add(ColorStop1);
RGBrush.ColorStops.Add(ColorStop2);

// Create a sprite visual and paint it with the radial gradient brush.
var visual = compositor.CreateSpriteVisual();
visual.Size = new Vector2(120, 120);
visual.Brush = RGBrush;

Вы также можете сжать шаги по созданию и добавлению цветовой остановки с помощью этого более короткого синтаксиса:

RGBrush.ColorStops.Add(compositor.CreateColorGradientStop(0, Colors.Blue));
RGBrush.ColorStops.Add(compositor.CreateColorGradientStop(1, Colors.Yellow));

Анимация радиальной градиентной кисти

В этом примере показано, как анимировать цвет первой градиентной остановки радиальной кисти.

private SpriteVisual GetRadialGradientVisualWithAnimation(Vector2 size,
                                                          Vector2 gradientOriginOffset,
                                                          Vector2 ellipseCenter,
                                                          Vector2 ellipseRadius)
{
    // Create radial gradient brush.
    var gradientBrush = compositor.CreateRadialGradientBrush();
    gradientBrush.GradientOriginOffset = gradientOriginOffset;
    gradientBrush.EllipseCenter = ellipseCenter;
    gradientBrush.EllipseRadius = ellipseRadius;

    // Add the color stops. The first color stop needs a name so you can refer to it later.
    CompositionColorGradientStop ColorStop1 = compositor.CreateColorGradientStop(0, Colors.Blue);
    gradientBrush.ColorStops.Add(ColorStop1);
    gradientBrush.ColorStops.Add(compositor.CreateColorGradientStop(1, Colors.Yellow));

    // Set up animation for ColorStop1's color.
    var colorAnimation = compositor.CreateColorKeyFrameAnimation();
    colorAnimation.InsertKeyFrame(0.0f, Colors.Blue);
    colorAnimation.InsertKeyFrame(0.5f, Colors.LightBlue);
    colorAnimation.InsertKeyFrame(0.75f, Colors.Navy);
    colorAnimation.InsertKeyFrame(1.0f, Colors.Blue);
    colorAnimation.Duration = TimeSpan.FromSeconds(20);
    colorAnimation.IterationBehavior = AnimationIterationBehavior.Forever;
    ColorStop1.StartAnimation("Color", colorAnimation);

    // SpriteVisual to be painted with gradated content.
    var gradientVisual = compositor.CreateSpriteVisual();
    gradientVisual.Size = size;
    // Set brush on the SpriteVisual.
    gradientVisual.Brush = gradientBrush;

    return gradientVisual;
}

Комментарии

Эта кисть красит spriteVisual с радиальным градиентом.

Градиент рисуется в многоточии, определяемом свойствами EllipseCenter и EllipseRadius . Цвета градиента начинаются в центре эллипса и заканчиваются радиусом.

Цвета радиального градиента определяются остановками цвета. Каждая остановка цвета указывает цвет и расположение вдоль градиента.

Свойства

Имя	Описание
AnchorPoint	Возвращает или задает точку на кисти, расположенную в смещение кисти. (Унаследовано от CompositionGradientBrush)
CenterPoint	Возвращает или задает точку, о которой поворачивается и масштабируется кисть. (Унаследовано от CompositionGradientBrush)
ColorStops	Возвращает остановки градиента кисти. (Унаследовано от CompositionGradientBrush)
Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
Compositor	Компостор, используемый для создания этого объекта CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает диспетчерку для CompositionObject. (Унаследовано от CompositionObject)
EllipseCenter	Получает или задает двухмерные координаты центра многоточия, содержащего градиент.
EllipseRadius	Возвращает или задает радии многоточия, содержащей градиент.
ExtendMode	Возвращает или задает значение, указывающее, как нарисовать градиент вне вектора градиента или пробела кисти. (Унаследовано от CompositionGradientBrush)
GradientOriginOffset	Получает или задает двухмерные координаты источника градиента.
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
InterpolationSpace	Возвращает или задает значение, указывающее, как интерполируются цвета градиента. (Унаследовано от CompositionGradientBrush)
MappingMode	Возвращает или задает значение, указывающее, являются ли координаты расположения градиента (StartPoint, EndPoint) абсолютными или относительными к выходной области. (Унаследовано от CompositionGradientBrush)
Offset	Возвращает или задает смещение кисти относительно окрашенного объекта. (Унаследовано от CompositionGradientBrush)
Properties	Коллекция свойств, связанных с CompositionObject. (Унаследовано от CompositionObject)
RotationAngle	Получает или задает угол поворота кисти в радианах. (Унаследовано от CompositionGradientBrush)
RotationAngleInDegrees	Получает или задает угол поворота кисти в градусах. (Унаследовано от CompositionGradientBrush)
Scale	Возвращает или задает масштаб, применяемый к кисти. (Унаследовано от CompositionGradientBrush)
TransformMatrix	Возвращает или задает матрицу преобразований, применяемых к кисти. (Унаследовано от CompositionGradientBrush)

Методы

Имя	Описание
Close()	Закрывает ресурсы системы CompositionObject и освобождает системные ресурсы. (Унаследовано от CompositionObject)
Dispose()	Выполняет определяемые приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов. (Унаследовано от CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Определяет свойство, которое может быть анимировано. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Подключает анимацию с указанным свойством объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation)	Подключает анимацию с указанным свойством объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно в объекте. (Унаследовано от CompositionObject)
StopAnimation(String)	Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Останавливает группу анимации. (Унаследовано от CompositionObject)
TryGetAnimationController(String)	Возвращает AnimationController для анимации, выполняемой в указанном свойстве. (Унаследовано от CompositionObject)

См. также раздел

• Brush