Share via


RectangleClip Class

Definition

Represents a rectangle with optional rounded corners that clips a portion of a visual. The portion of the visual inside the rectangle is visible; the portion of the visual outside the rectangle is clipped.

public ref class RectangleClip sealed : CompositionClip
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RectangleClip final : CompositionClip
/// [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 RectangleClip final : CompositionClip
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RectangleClip : CompositionClip
[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 RectangleClip : CompositionClip
Public NotInheritable Class RectangleClip
Inherits CompositionClip
Inheritance
Object Platform::Object IInspectable CompositionObject CompositionClip RectangleClip
Attributes

Remarks

RectangleClip is functionally similar to InsetClip, but allows you to round the corners of the clipping rectangle.

A RectangleClip is defined using offsets in pixels from the bottom, left, right, and top of the Visual to be clipped. You can round the corners of the rectangle by setting the various Radius properties.

To clip a Visual, you assign the RectangleClip to the Clip property of the Visual.

It is possible to fully clip the entire Visual. Negative values are allowed. RectangleClip supports all the same transforms as Visual except the 4x4 matrix. Unlike Visual, RectangleClip is 2D and is defined, instead, with a 3x2 matrix. RectangleClip properties are fully animatable.

Properties

AnchorPoint

The point on the clip to be positioned at the clip's offset. Value is normalized with respect to the size of the clip.

(Inherited from CompositionClip)
Bottom

Gets or sets the offset from the bottom of the visual. The portion of the visual below the edge defined by Bottom will be clipped. Animatable.

BottomLeftRadius

Gets or sets the amount by which the bottom left corner of the rectangle is rounded.

BottomRightRadius

Gets or sets the amount by which the bottom right corner of the rectangle is rounded.

CenterPoint

The point about which rotation or scaling occurs.

(Inherited from CompositionClip)
Comment

A string to associate with the CompositionObject.

(Inherited from CompositionObject)
Compositor

The Compositor used to create this CompositionObject.

(Inherited from CompositionObject)
DispatcherQueue

Gets the DispatcherQueue for the CompositionObject.

(Inherited from CompositionObject)
ImplicitAnimations

The collection of implicit animations attached to this object.

(Inherited from CompositionObject)
Left

Gets or sets the offset from the left of the visual. The portion of the visual to the left of the edge defined by Left will be clipped. Animatable.

Offset

The offset of the clip relative to the visual on which the clip is applied.

(Inherited from CompositionClip)
Properties

The collection of properties associated with the CompositionObject.

(Inherited from CompositionObject)
Right

Gets or sets the offset from the right of the visual. The portion of the visual to the right the edge defined by Right will be clipped. Animatable.

RotationAngle

The angle of rotation applied to the clip, in radians.

(Inherited from CompositionClip)
RotationAngleInDegrees

The angle of rotation applied to the clip, in degrees.

(Inherited from CompositionClip)
Scale

The scale to apply to the clip.

(Inherited from CompositionClip)
Top

Gets or sets the offset from the top of the visual. The portion of the visual above the edge defined by Top will be clipped. Animatable.

TopLeftRadius

Gets or sets the amount by which the top left corner of the rectangle is rounded.

TopRightRadius

Gets or sets the amount by which the top right corner of the rectangle is rounded.

TransformMatrix

The 3x2 transformation matrix to apply to the clip.

(Inherited from CompositionClip)

Methods

Close()

Closes the CompositionObject and releases system resources.

(Inherited from CompositionObject)
Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Inherited from CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Defines a property that can be animated.

(Inherited from CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

Connects an animation with the specified property of the object and starts the animation.

(Inherited from CompositionObject)
StartAnimation(String, CompositionAnimation)

Connects an animation with the specified property of the object and starts the animation.

(Inherited from CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

Starts an animation group.

The StartAnimationGroup method on CompositionObject lets you start CompositionAnimationGroup. All the animations in the group will be started at the same time on the object.

(Inherited from CompositionObject)
StopAnimation(String)

Disconnects an animation from the specified property and stops the animation.

(Inherited from CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

Stops an animation group.

(Inherited from CompositionObject)
TryGetAnimationController(String)

Returns an AnimationController for the animation running on the specified property.

(Inherited from CompositionObject)

Applies to

See also