<!--
{
  "availability" : [
    "iOS: 27.1.0 -",
    "iPadOS: 27.1.0 -",
    "macCatalyst: 27.1.0 -",
    "tvOS: 27.1.0 -",
    "visionOS: 27.1.0 -",
    "watchOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UISplitArrangementViewProperties",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UISplitArrangementViewProperties"
  },
  "title" : "UISplitArrangementViewProperties"
}
-->

# UISplitArrangementViewProperties

Properties you use to customize how a split arrangement presents a view.

```
@interface UISplitArrangementViewProperties : NSObject
```

## Overview

By default, a split arrangement sizes the primary and secondary views equally when a display has one region. Influence how the arrangement view computes the sizes for each view by setting the split arrangement’s view properties for each placement to use an automatic size, a fixed layout size, a fractional layout size, or an intrinsic content size.

First create a [`UISplitArrangement`](/documentation/UIKit/UISplitArrangement-c.class) instance and a [`UISplitArrangementViewProperties`](/documentation/UIKit/UISplitArrangementViewProperties) instance to configure the preferred size:

```objc
UISplitArrangement *splitArrangement = [UISplitArrangement splitArrangement];
UISplitArrangementViewProperties *primaryViewProperties = [splitArrangement.defaultViewProperties copy];
```

Next, create a [`UISplitArrangementDimensionRange`](/documentation/UIKit/UISplitArrangementDimensionRange) instance, and configure the [`minimum`](/documentation/UIKit/UISplitArrangementDimensionRange/minimum), [`preferred`](/documentation/UIKit/UISplitArrangementDimensionRange/preferred), or [`maximum`](/documentation/UIKit/UISplitArrangementDimensionRange/maximum) properties with [`UISplitArrangementDimension`](/documentation/UIKit/UISplitArrangementDimension) options to describe how to size the view. The following example sets a preferred fractional layout size with an absolute minimum:

```objc
UISplitArrangementDimensionRange *primaryDimensionRange = [[UISplitArrangementDimensionRange alloc] init];
primaryDimensionRange.minimum = [UISplitArrangementDimension absoluteDimension:250.0];
primaryDimensionRange.preferred = [UISplitArrangementDimension fractionalDimension:0.3];
```

Then, set the `width` or `height` property on the view properties instance to the configured [`UISplitArrangementDimensionRange`](/documentation/UIKit/UISplitArrangementDimensionRange), set the view properties on the split arrangement for the view’s placement, and update the arrangement view controller to use the split arrangement by calling the [`updateArrangement:animated:`](/documentation/UIKit/UIArrangementViewController/updateArrangement:animated:) method:

```objc
primaryViewProperties.width = primaryDimensionRange;

[splitArrangement setViewProperties:primaryViewProperties forPlacement:UIArrangementViewControllerViewPlacementPrimary];
[arrangementVC updateArrangement:splitArrangement];
```

## Topics

### Creating view properties

[`- (instancetype) init;`](/documentation/UIKit/UISplitArrangementViewProperties/init)

Creates a set of split arrangement view properties.

### Configuring the view

[`@property (nonatomic, copy) UISplitArrangementDimensionRange * width;`](/documentation/UIKit/UISplitArrangementViewProperties/width)

The width dimension range for the view.

[`@property (nonatomic, copy) UISplitArrangementDimensionRange * height;`](/documentation/UIKit/UISplitArrangementViewProperties/height)

The height dimension range for the view.

[`@interface UISplitArrangementDimensionRange : NSObject`](/documentation/UIKit/UISplitArrangementDimensionRange)

A range of dimensions defining the minimum, preferred, and maximum size for a view within a split arrangement.

[`@property (nonatomic) CGFloat layoutPriority;`](/documentation/UIKit/UISplitArrangementViewProperties/layoutPriority)

The layout priority of the view within the split arrangement.

## Relationships

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

### Conforms To

[`NSCopying`](/documentation/Foundation/NSCopying)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)