Contents Gravity Values

The contents gravity constants specify the position of the content object when the layer bounds is larger than the bounds of the content object. They are used by the contentsGravity property.

Topics

Constants

kCAGravityCenter

The content is horizontally and vertically centered in the bounds rectangle.

kCAGravityTop

The content is horizontally centered at the top-edge of the bounds rectangle.

kCAGravityBottom

The content is horizontally centered at the bottom-edge of the bounds rectangle.

kCAGravityLeft

The content is vertically centered at the left-edge of the bounds rectangle.

kCAGravityRight

The content is vertically centered at the right-edge of the bounds rectangle.

kCAGravityTopLeft

The content is positioned in the top-left corner of the bounds rectangle.

kCAGravityTopRight

The content is positioned in the top-right corner of the bounds rectangle.

kCAGravityBottomLeft

The content is positioned in the bottom-left corner of the bounds rectangle.

kCAGravityBottomRight

The content is positioned in the bottom-right corner of the bounds rectangle.

kCAGravityResize

The content is resized to fit the entire bounds rectangle.

kCAGravityResizeAspect

The content is resized to fit the bounds rectangle, preserving the aspect of the content. If the content does not completely fill the bounds rectangle, the content is centered in the partial axis.

kCAGravityResizeAspectFill

The content is resized to completely fill the bounds rectangle, while still preserving the aspect of the content. The content is centered in the axis it exceeds.

See Also

Modifying the Layer’s Appearance

contentsGravity

A constant that specifies how the layer's contents are positioned or scaled within its bounds.

opacity

The opacity of the receiver. Animatable.

hidden

A Boolean indicating whether the layer is displayed. Animatable.

masksToBounds

A Boolean indicating whether sublayers are clipped to the layer’s bounds. Animatable.

mask

An optional layer whose alpha channel is used to mask the layer’s content.

doubleSided

A Boolean indicating whether the layer displays its content when facing away from the viewer. Animatable.

cornerRadius

The radius to use when drawing rounded corners for the layer’s background. Animatable.

borderWidth

The width of the layer’s border. Animatable.

borderColor

The color of the layer’s border. Animatable.

backgroundColor

The background color of the receiver. Animatable.

shadowOpacity

The opacity of the layer’s shadow. Animatable.

shadowRadius

The blur radius (in points) used to render the layer’s shadow. Animatable.

shadowOffset

The offset (in points) of the layer’s shadow. Animatable.

shadowColor

The color of the layer’s shadow. Animatable.

shadowPath

The shape of the layer’s shadow. Animatable.

style

An optional dictionary used to store property values that aren't explicitly defined by the layer.

allowsEdgeAntialiasing

A Boolean indicating whether the layer is allowed to perform edge antialiasing.

allowsGroupOpacity

A Boolean indicating whether the layer is allowed to composite itself as a group separate from its parent.