Instance Method

alignmentRectForFrame:

Returns the view’s alignment rectangle for a given frame.

Declaration

- (NSRect)alignmentRectForFrame:(NSRect)frame;

Parameters

frame

The frame whose corresponding alignment rectangle is desired.

Return Value

The alignment rectangle for the specified frame.

Discussion

The constraint-based layout system uses alignment rectangles to align views, rather than their frame. This allows custom views to be aligned based on the location of their content while still having a frame that encompasses any ornamentation they need to draw around their content, such as shadows or reflections.

The default implementation returns the view’s frame modified by the insets specified by the view’s alignmentRectInsets method. Most custom views can override alignmentRectInsets to specify the location of their content within their frame. Custom views that require arbitrary transformations can override alignmentRectForFrame: and frameForAlignmentRect: to describe the location of their content. These two methods must always be inverses of each other.

See Also

Aligning Views with Auto Layout

- frameForAlignmentRect:

Returns the view’s frame for a given alignment rectangle.

alignmentRectInsets

The insets (in points) from the view’s frame that define its content rectangle.

baselineOffsetFromBottom

The distance (in points) between the bottom of the view’s alignment rectangle and its baseline.

firstBaselineOffsetFromTop

The distance (in points) between the top of the view’s alignment rectangle and its topmost baseline.

lastBaselineOffsetFromBottom

The distance (in points) between the bottom of the view’s alignment rectangle and its bottommost baseline.