XCode 7.3 日本語化計画: UIView

center

transform

bounds プロパティ

独自の座標系でのビューの位置とサイズを記述する境界の長方形。

宣言

<< SWIFT >>

var bounds: CGRect

<< OBJECTIVE-C >>
@property(nonatomic) CGRect bounds

議論

画面上では、境界の長方形は、そのフレームの長方形としてビューの目に見える同じ部分を表しています。デフォルトでは、境界の長方形の原点は（0、0）に設定されていますが、ビューの異なる部分を表示するには、この値を変更できます。境界の長方形のサイズは、フレームの長方形のサイズに結合されているので、いずれかの変更は、他に影響を与えます。境界のサイズを変更すると、その中心点へとビューを拡大または縮小します。境界の長方形の座標は常にポイントで指定されます。

フレームの長方形を変更すると、drawRect:メソッドを呼び出すことなく、受信者を自動的に再表示します。フレームの長方形が変更した時、drawRect:メソッドを呼び出したい場合は、contentMode プロパティに UIViewContentModeRedraw を設定して下さい。

このプロパティへの変更は、アニメーション化できます。

デフォルトの境界の原点は (0,0) で、サイズはフレームの長方形のサイズと同じです。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

center

transform

center プロパティ

フレームの中心。

宣言

<< SWIFT >>

var center: CGPoint

<< OBJECTIVE-C >>
@property(nonatomic) CGPoint center

議論

中心はそのスーパービューの座標系内で指定されており、ポイントで測定されます。このプロパティを設定すると、それに応じて frame プロパティの値が変更します。

フレームの長方形を変更すると、drawRect:を呼び出すことなく、受信者を自動的に再表示します。フレームの長方形が変更した時 drawRect:メソッドを呼び出したい場合は、 contentMode プロパティに UIViewContentModeRedraw を設定して下さい。

このプロパティへの変更は、アニメーション化できます。beginAnimations:context: クラスメソッドを使用してアニメーションブロックを開始し commitAnimations クラスメソッドを使用して、アニメーションブロックを終了してください。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

transform

transform プロパティ

その境界の中心への相対の、受信者に適用される変換を指定します。

宣言

<< SWIFT >>

var transform: CGAffineTransform

<< OBJECTIVE-C >>
@property(nonatomic) CGAffineTransform transform

議論

transform が変更された場合、その原点は、center プロパティの値、又はレイヤーの anchorPoint プロパティです。(基礎となる Core Animation のレイヤオブジェクトを取得するために layer プロパティを使用してください。) デフォルト値は CGAffineTransformIdentity です。

このプロパティへの変更は、アニメーション化できます。beginAnimations:context: クラスメソッドを使用してアニメーションブロックを開始し commitAnimations クラスメソッドを使用して、アニメーションブロックを終了してください。デフォルトは center の値が何であれ、それです。(または変更された場合、アンカーポイント)

iOS 8.0 以降では、transform プロパティは、自動レイアウトに影響を与えません。自動レイアウトは、その転換されていないフレームに基づいてビューの整列の長方形を計算します。

警告： このプロパティが識別変換でない場合は、frame プロパティの値は未定義であり、無視されるべきです。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– insertSubview:atIndex:
– insertSubview:aboveSubview:
– insertSubview:belowSubview:
– exchangeSubviewAtIndex:withSubviewAtIndex:

center

ビュー階層の管理

superview プロパティ

受信者のスーパービュー、もし持っていない場合は nil。(読み取り専用)

宣言

<< SWIFT >>

var superview: UIView? { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIView *superview

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

subviews

– removeFromSuperview

subviews プロパティ

受信者の直接のサブビュー。(読み取り専用)

宣言

<< SWIFT >>

var subviews: [UIView] { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly, copy) NSArray <__kindof UIView *> *subviews

議論

このプロパティを使用して、カスタムビュー階層に関連したサブビューを取得できます。配列内のサブビューの順番は、画面上での視える順序を反映し、インデックス 0 でのビューは、一番後ろのビューを示します。

UIKit および他のシステムフレームワークで宣言された複雑なビューの場合、ビューのすべてのサブビューは、一般的にいつでも変更できる private と考えられます。したがって、システム提供のビューのこれらのタイプのサブビューを取得したり、変更しないでください。そうした場合、あなたのコードは、将来のシステム更新で破損する可能性があります。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

superview

– removeFromSuperview

window プロパティ

受信者のウィンドウオブジェクト。もし持っていない場合は nil。(読み取り専用)

宣言

<< SWIFT >>

var window: UIWindow? { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) UIWindow *window

議論

ビューがまだウィンドウに追加されていない場合はこのプロパティは nil です。

利用可能

iOS 2.0 以降で利用可能。

- addSubview:

サブビューの受信者のリストの最後にビューを追加します。

宣言

<< SWIFT >>

func addSubview(_ view: UIView)

<< OBJECTIVE-C >>
- (void)addSubview:(UIView *)view

パラメーター

view

追加するべきビュー。追加された後、このビューは、他の全てのサブビューの上部に表示されます。

議論

このメソッドは、view への強い参照を確立し、その新しいスーパービューで受信者にその次のレスポンダを設定します。

ビューは一つだけスーパービューを持つことができます。view にすでにスーパービューがあり、そのビューが受信者でない場合は、このメソッドは、受信者に新しいスーパービューを作成する前に、以前のスーパービューを削除します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

- bringSubviewToFront:

兄弟の一番上に表示されるように指定されたサブビューを移動します。

宣言

<< SWIFT >>

func bringSubviewToFront(_ view: UIView)

<< OBJECTIVE-C >>
- (void)bringSubviewToFront:(UIView *)view

パラメーター

view

前に移動すべきサブビュー。

議論

このメソッドは、subview プロパティ内のビューの配列の最後に、指定されたビューを移動します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– sendSubviewToBack:

兄弟の背後に表示されるように、指定されたサブビューを移動します。

宣言

<< SWIFT >>

func sendSubviewToBack(_ view: UIView)

<< OBJECTIVE-C >>
- (void)sendSubviewToBack:(UIView *)view

パラメーター

view

後ろに移動すべきサブビュー。

議論

このメソッドは、subview プロパティ内のビューの配列の先頭に、指定されたビューを移動します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

bringSubviewToFront:

- removeFromSuperview

スーパービューとそのウインドウからビューをリンク解除し、またレスポンダチェーンから削除します。

宣言

<< SWIFT >>

func removeFromSuperview()

<< OBJECTIVE-C >>
- (void)removeFromSuperview

議論

ビューのスーパービューが nil でない場合は、スーパービューはビューを解放します。

このメソッドを呼び出すと、削除しようとしている、または削除しているビューのサブツリー内の全てのビューを参照する全ての制約を削除します。

重要： 決してあなたの drawRect:メソッドの中からこのメソッドを呼び出してはなりません。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

superview
subviews

- insertSubview:atIndex:

指定されたインデックスにサブビューを挿入します。

宣言

<< SWIFT >>

func insertSubview(_ view: UIView,
           atIndex index: Int)

<< OBJECTIVE-C >>
- (void)insertSubview:(UIView *)view
              atIndex:(NSInteger)index

パラメーター

view	挿入すべきビュー。これは nil にできません。
index	ビューを挿入するべき subviews プロパティの配列のインデックス。サブビューのインデックスは 0 から始まり、サブビューの数よりも大きくできません。

議論

このメソッドは、view への強い参照を確立し、その新しいスーパービューである、受信者にその次のレスポンダを設定します。

ビューは一つだけスーパービューを持つことができます。もし view にはすでにスーパーがあり、そのビューが受信者でない場合は、この方メソッドは、受信者に新しいスーパービューを作成する前に、以前のスーパービューを削除します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

- addSubview:
– insertSubview:aboveSubview:
– insertSubview:belowSubview:
– exchangeSubviewAtIndex:withSubviewAtIndex:

– insertSubview:aboveSubview:

ビュー階層内の別のビューの上にビューを挿入します。

宣言

<< SWIFT >>

func insertSubview(_ view: UIView,
      aboveSubview siblingSubview: UIView)

<< OBJECTIVE-C >>
- (void)insertSubview:(UIView *)view
         aboveSubview:(UIView *)siblingSubview

パラメーター

view	挿入されるべきビュー。それが siblingSubview の兄弟でなければ、そのスーパービューから削除されます。
siblingSubview	挿入されたビューの後ろになる兄弟ビュー。

議論

このメソッドは、view への強い参照を確立し、その新しいスーパービューである、受信者にその次のレスポンダを設定します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

- addSubview:
- insertSubview:atIndex:
– insertSubview:belowSubview:
– exchangeSubviewAtIndex:withSubviewAtIndex:

- insertSubview:belowSubview:

ビュー階層内の別のビューの下にビューを挿入します。

宣言

<< SWIFT >>

func insertSubview(_ view: UIView,
      belowSubview siblingSubview: UIView)

<< OBJECTIVE-C >>
- (void)insertSubview:(UIView *)view
         belowSubview:(UIView *)siblingSubview

パラメーター

view	別のビューの下に挿入するべきビュー。それが siblingSubview の兄弟でなければ、そのスーパービューから削除されます。
siblingSubview	挿入されたビューの上になる兄弟ビュー。

議論

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

- addSubview:
- insertSubview:atIndex:
- insertSubview:aboveSubview:
– exchangeSubviewAtIndex:withSubviewAtIndex:

– exchangeSubviewAtIndex:withSubviewAtIndex:

指定されたインデックスでサブビューを交換します。

宣言

<< SWIFT >>

func exchangeSubviewAtIndex(_ index1: Int,
         withSubviewAtIndex index2: Int)

<< OBJECTIVE-C >>
- (void)exchangeSubviewAtIndex:(NSInteger)index1
            withSubviewAtIndex:(NSInteger)index2

パラメーター

index1	受信者内の最初のサブビューのインデックス。
index2	受信者内の２番目のサブビューのインデックス。

議論

各インデックスは subviews プロパティ内の配列内の対応するビューの位置を表します。サブビューのインデックスは 0 から始まり、サブビューの数よりも大きくすることはできません。このメソッドは、いずれかのビューのスーパービューを変更することはありませんが、単に subviews 配列内のそれらの位置を交換します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

- addSubview:
- insertSubview:atIndex:
- insertSubview:aboveSubview:
– insertSubview:belowSubview:

- isDescendantOfView:

受信者がそのビューに与えられたビューまたは同一のサブビューかどうかを示すブール値を返します。

宣言

<< SWIFT >>

func isDescendantOfView(_ view: UIView) -> Bool

<< OBJECTIVE-C >>
- (BOOL)isDescendantOfView:(UIView *)view

パラメーター

view

受信者のビュー階層に対してテストすべきビュー。

戻り値

受信者が、view の直接または遠いサブビューである場合または view が受信者自体である場合には YES、それ以外の場合は NO。

利用可能

iOS 2.0 以降で利用可能。

サイズ変更動作の構成

autoresizingMask プロパティ

そのスーパービューの境界が変更したとき、受信者がそれ自体のサイズを変更する方法を決定する整数のビットマスク。

宣言

<< SWIFT >>

var autoresizingMask: UIViewAutoresizing

<< OBJECTIVE-C >>
@property(nonatomic) UIViewAutoresizing autoresizingMask

議論

ビューの境界が変更されると、そのビューは各サブビューの自動サイズ変更マスクに従ってそのサブビューのサイズを自動的に変更します。C のビット単位の OR 演算子を使用して UIViewAutoresizing で説明した定数を組み合わせて、このマスクの値を指定して下さい。これらの定数を組み合わせて、ビューの寸法がスーパービューに比べて大きくなったり小さくなったりするかを指定できます。このプロパティのデフォルト値は、ビューが全くサイズ変更されるべきではないことを示す UIViewAutoresizingNone です。

同じ軸に沿って、複数のオプションが設定されている場合は、デフォルトの動作は、柔軟な部分の間にサイズに違いを比例して分配することです。他の柔軟な部分に対して柔軟な部分がより大きければ、より成長する可能性があります。たとえば、このプロパティが UIViewAutoresizingFlexibleWidth と UIViewAutoresizingFlexibleRightMargin 定数を含んでいるとすると、 UIViewAutoresizingFlexibleLeftMargin を含んでおらず、このようにビューの左余白の幅は固定されており、ビューの幅と右の余白が変更する可能性があることを示しています。このように、ビューはそのスーパービューの左側に固定表示され、ビューの幅とビューの増加の右側にあるギャップの両方は増加します。

自動サイズ変更動作が、あなたのビューのために必要な正確なレイアウトを提供していない場合は、カスタムコンテナビューを使用し、より正確にあなたのサブビューを配置するために、その layoutSubviews メソッドをオーバーライドできます。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

autoresizesSubviews

autoresizesSubviews プロパティ

その境界が変更する場合は、受信者が自動的にそのサブビューのサイズを変更するかどうかを決定するブール値。

宣言

<< SWIFT >>

var autoresizesSubviews: Bool

<< OBJECTIVE-C >>
@property(nonatomic) BOOL autoresizesSubviews

議論

YES に設定すると、受信者は、その境界が変更する時、そのサブビューのサイズを調整します。デフォルト値は YES です。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

autoresizingMask

contentMode プロパティ

その境界が変更されたときにビューがそのコンテンツをレイアウトする方法を決定するために使用するフラグ。

宣言

<< SWIFT >>

var contentMode: UIViewContentMode

<< OBJECTIVE-C >>
@property(nonatomic) UIViewContentMode contentMode

議論

このコンテンツモードは、ビューの境界が変更されたときに、ビューのレイヤのキャッシュされたビットマップを調整する方法を指定します。このプロパティは、多くの場合、contentStretch プロパティに通常関連して、サイズ変更可能なコントロールを実現するために使用されます。ビューの内容を毎回再描画する代わりに、(歪みの有無にかかわらずどちらか) 内容をスケールまたはビュー上の特定の場所にそれらを固定することを指定するために、このプロパティを使用できます。

注意： 常に setNeedsDisplay または setNeedsDisplayInRect: メソッドを呼び出すことによって再描画されるビューの内容を強制できます。

このプロパティに割り当てできる値の一覧については、UIViewContentMode を参照してください。このプロパティのデフォルト値は UIViewContentModeScaleToFill です。

利用可能

iOS 2.0 以降で利用可能。

contentStretch
(iOS 6.0) プロパティ

ビューの伸縮できる領域と伸縮できない領域を定義する長方形。

<< OBJECTIVE-C >>

@property(nonatomic) CGRect contentStretch

議論

ビューのサイズが変更されたとき、ビューのコンテンツが、その境界を満たすように進展される方法を制御するには、このプロパティを使用して下さい。コンテンツを進展するのはしばしばビューのサイズ変更をアニメーション化するために使用されています。例えば、ボタンやその他のコントロールは、コントロールの中央部分の進展や利用可能なスペースを埋めるのを可能にしながら、鮮明な境界線を維持するために進展を使用しています。

注意： 画像ベースのコンテンツを伸展するためには、このプロパティを設定する代わりに、伸縮性のイメージで UIImageView オブジェクトを使用するのが簡単です。UIImage の stretchableImageWithLeftCapWidth:topCapHeight: メソッドを使用して伸展性のある画像を作成できます。

この長方形で指定した値は 0.0 から 1.0 の範囲に正規化されていなければなりません。これらの値は、その後適切なピクセル値を得るためにビューのコンテンツのサイズにスケーリングされます。この長方形のデフォルト値は、原点 (0.0、0.0) で(1.0、1.0) のサイズを有しています。これは、その伸展可能部分が全体の内容を取り囲む長方形を反映しています。

利用可能

iOS 3.0 以降で利用可能。

iOS 6.0 で旧式となる。

- sizeThatFits:

指定したサイズに丁度よく合ったサイズを計算し、返すようにビューを要求します。

宣言

<< SWIFT >>

func sizeThatFits(_ size: CGSize) -> CGSize

<< OBJECTIVE-C >>
- (CGSize)sizeThatFits:(CGSize)size

パラメーター

size

ビューは、その丁度よく合うサイズを計算する必要があるサイズ。

戻り値

受信者のサブビューに合う新しいサイズ。

議論

このメソッドのデフォルトの実装は、ビューの既存のサイズを返します。サブクラスは、全てのサブビューの望みのレイアウトに基づいて、カスタム値を返すようにこのメソッドをオーバーライドできます。例えば、UISwitch オブジェクトはスイッチビューの標準的なサイズを表す固定サイズ値を返し、UIImageView オブジェクトは、現在表示している画像のサイズを返します。

このメソッドは、受信者のサイズは変更しません。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– sizeToFit

– setNeedsUpdateConstraints

– sizeToFit

それが丁度サブビューを囲むように、受信者のビューのサイズを変更し、移動します。

宣言

<< SWIFT >>

func sizeToFit()

<< OBJECTIVE-C >>
- (void)sizeToFit

議論

空間の最も適切な量を使用するように、現在のビューのサイズを変更する場合は、このメソッドを呼び出して下さい。特定の UIKit ビューは、独自の内部のニーズに応じてそれら自身のサイズを変更します。いくつかの場合、ビューがスーパービューを持っていない場合、画面の境界に、それ自体のサイズに合わせます。このように、与えられたビューにその親ビューにサイズを合わせたい場合は、このメソッドを呼び出す前に、親ビューにそれを追加する必要があります。

このメソッドをオーバーライドすべきではありません。あなたのビューのデフォルトのサイズ情報を変更したい時は、sizeThatFits を代わりに、オーバーライドして下さい。そのメソッドは、必要な計算を実行し、このメソッドに、それらを返し、変更を行います。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

- sizeThatFits:

サブビューのレイアウト

- layoutSubviews

サブビューをレイアウトします。

宣言

<< SWIFT >>

func layoutSubviews()

<< OBJECTIVE-C >>
- (void)layoutSubviews

議論

このメソッドのデフォルトの実装は、iOS 5.1 以前では何もしません。そうでない場合、デフォルトの実装では、全てのサブビューのサイズと位置を決定するために設定した、任意の制約を使用します。

それらのサブビューの、より正確なレイアウトを実行するために必要なサブクラスは、このメソッドをオーバーライドできます。サブビューの自動サイズ変更および制約ベースの動作は、望みの動作を提供しない場合にのみ、あなたは、このメソッドをオーバーライドする必要があります。直接あなたのサブビューのフレームの長方形を設定するには、あなたの実装を使用できます。

このメソッドを直接呼び出すべきではありません。レイアウトの更新を強制する場合は、次の描画更新を行う前にそうする代わりに、setNeedsLayout メソッドを呼び出して下さい。すぐにあなたのビューのレイアウトを更新したい場合は、layoutIfNeeded メソッドを呼び出して下さい。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– setNeedsLayout
– layoutIfNeeded

– setNeedsLayout

受信者の現在のレイアウトを無効にして、次の更新サイクル中にレイアウトの更新をトリガします。

宣言

<< SWIFT >>

func setNeedsLayout()

<< OBJECTIVE-C >>
- (void)setNeedsLayout

議論

ビューのサブビューのレイアウトを調整したいときに、アプリケーションのメインスレッドでこのメソッドを呼び出して下さい。このメソッドは、リクエストのメモを作成し、すぐに返します。このメソッドは、即時更新を強制しませんが、代わりに次の更新サイクルを待機するので、それらの全てのビューが更新される前に、複数のビューのレイアウトを無効にするために使用できます。この動作は、通常はパフォーマンスに優れている、1つの更新サイクルで、レイアウト更新のすべてを統合することができます。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– layoutIfNeeded
– layoutSubviews

– layoutIfNeeded

すぐにサブビューをレイアウトします。

宣言

<< SWIFT >>

func layoutIfNeeded()

<< OBJECTIVE-C >>
- (void)layoutIfNeeded

議論

描画する前にサブビューのレイアウトを強制するために、このメソッドを使用して下さい。ルートビューとしてメッセージを受信したビューを使用して、このメソッドは、ルートから始まるビューサブツリーをレイアウトします。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– setNeedsLayout
– layoutSubviews

+ requiresConstraintBasedLayout

受信者が、制約ベースのレイアウトシステムに依存しているかどうかを示すブール値。

宣言

<< SWIFT >>

class func requiresConstraintBasedLayout() -> Bool

<< OBJECTIVE-C >>
+ (BOOL)requiresConstraintBasedLayout

戻り値

正常に機能するように制約ベースのレイアウトを使用して、ウィンドウ内にビューがなければない場合 YES、そうでない場合、NO。

議論

カスタムビューは、それらが自動サイズ変更を使用して正しくレイアウトすることができない場合は YES を返して、これをオーバーライドする必要があります。

利用可能

iOS 6.0 以降で利用可能。

translatesAutoresizingMaskIntoConstraints プロパティ

ビューの自動サイズ変更マスクが自動レイアウトの制約に翻訳されているかどうかを決定するブール値。

宣言

<< SWIFT >>

var translatesAutoresizingMaskIntoConstraints: Bool

<< OBJECTIVE-C >>
@property(nonatomic) BOOL translatesAutoresizingMaskIntoConstraints

議論

このプロパティの値が YES の場合、システムは、ビューの自動サイズ変更マスクで指定された動作を複製する制約のセットを作成します。これはまた、あなたが自動レイアウト内の静的、フレームベースのレイアウトを作成することを可能にし、ビューの　frame、bounds、center プロパティを使用してビューのサイズと位置を変更できます。

自動サイズ変更マスク制約が完全にビューのサイズと位置を指定することに注意してください。したがって、競合を導入することなく、このサイズや位置を変更するための追加の制約を追加することはできません。あなたが動的にビューのサイズと位置を計算するために、自動レイアウトを使用する場合は、このプロパティを NO に設定し、その後ビューの制約の曖昧でない、競合しないセットを提供しなければなりません。

デフォルトでは、このプロパティは、プログラムで作成した全てのビューで YES に設定されています。Interface Builder でビューを追加すると、システムは自動的に、このプロパティを NO に設定します。

利用可能

iOS 6.0 以降で利用可能。

レイアウトのアンカーを使用して制約の作成

bottomAnchor プロパティ

ビューのフレームの下端を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var bottomAnchor: NSLayoutYAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutYAxisAnchor *bottomAnchor

議論

ビューの下端で制約を作成するには、このアンカーを使用してください。他の NSLayoutYAxisAnchor アンカーとだけ、このアンカーを組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

centerXAnchor プロパティ

ビューのフレームの水平方向の中心を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var centerXAnchor: NSLayoutXAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutXAxisAnchor *centerXAnchor

議論

ビューの水平方向の中心で制約を作成するには、このアンカーを使用してください。他の NSLayoutXAxisAnchor アンカーとだけ、このアンカーを組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

centerYAnchor プロパティ

ビューのフレームの垂直方向の中心を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var centerYAnchor: NSLayoutYAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutYAxisAnchor *centerYAnchor

議論

ビューの垂直方向の中心で制約を作成するには、このアンカーを使用してください。他の NSLayoutYAxisAnchor アンカーとだけ、このアンカーを組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

firstBaselineAnchor プロパティ

ビュー内のテキストの一番上の行のベースラインを表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var firstBaselineAnchor: NSLayoutYAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutYAxisAnchor *firstBaselineAnchor

議論

複数行のテキストから成るビューでは、このアンカーは、テキストの一番上の行のベースラインを表します。このベースラインに制約を作成するには、このアンカーを使用してください。他の NSLayoutYAxisAnchor アンカーとだけ、このアンカーを組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

heightAnchor プロパティ

ビューのフレームの高さを表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var heightAnchor: NSLayoutDimension { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutDimension *heightAnchor

議論

ビューの高さで制約を作成するには、このアンカーを使用してください。他の NSLayoutDimension アンカーとだけ、このアンカーを組み合わせることができます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

lastBaselineAnchor プロパティ

ビュー内のテキストの一番下の行のベースラインを表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var lastBaselineAnchor: NSLayoutYAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutYAxisAnchor *lastBaselineAnchor

議論

複数行のテキストから成るビューでは、このアンカーは、テキストの一番下の行のベースラインを表します。このベースラインに制約を作成するには、このアンカーを使用してください。他の NSLayoutYAxisAnchor アンカーとだけ、このアンカーを組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

leadingAnchor プロパティ

ビューのフレームの先端を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var leadingAnchor: NSLayoutXAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutXAxisAnchor *leadingAnchor

議論

ビューの先端との制約を作成するには、このアンカーを使用してください。NSLayoutXAxisAnchor アンカーのサブセットとのみ、このアンカーを組み合わせられます。別の leadingAnchor、trailingAnchor、または centerXAnchor と leadingAnchor を組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

leftAnchor プロパティ

ビューのフレームの左端を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var leftAnchor: NSLayoutXAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutXAxisAnchor *leftAnchor

議論

ビューの左端との制約を作成するには、このアンカーを使用してください。NSLayoutXAxisAnchor アンカーのサブセットとのみ、このアンカーを組み合わせられます。別の leftAnchor、rightAnchor、または centerXAnchor と leftAnchor を組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

rightAnchor プロパティ

ビューのフレームの右端を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var rightAnchor: NSLayoutXAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutXAxisAnchor *rightAnchor

議論

ビューの右端との制約を作成するには、このアンカーを使用してください。NSLayoutXAxisAnchor アンカーのサブセットとだけ、このアンカーを組み合わせられます。別の rightAnchor、leftAnchor、または centerXAnchor と rightAnchor を組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

topAnchor プロパティ

ビューのフレームの上端を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var topAnchor: NSLayoutYAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutYAxisAnchor *topAnchor

議論

ビューの上端との制約を作成するには、このアンカーを使用してください。他の NSLayoutXAxisAnchor アンカーとだけ、このアンカーを組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

trailingAnchor プロパティ

ビューのフレームの後端を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var trailingAnchor: NSLayoutXAxisAnchor { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutXAxisAnchor *trailingAnchor

議論

ビューの後端との制約を作成するには、このアンカーを使用してください。NSLayoutXAxisAnchor アンカーのサブセットとだけ、このアンカーを組み合わせられます。別の trailingAnchor、leadingAnchor、または centerXAnchor と trailingAnchor を組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

widthAnchor プロパティ

ビューのフレームの幅を表すレイアウトアンカー。(読み取り専用)

宣言

<< SWIFT >>

var widthAnchor: NSLayoutDimension { get }

<< OBJECTIVE-C >>
@property(readonly, strong) NSLayoutDimension *widthAnchor

議論

ビューの幅との制約を作成するには、このアンカーを使用してください。他の NSLayoutDimension アンカーとだけ、このアンカーを組み合わせられます。詳細については、NSLayoutAnchor クラスリファレンス を参照してください。

利用可能

iOS 9.0 以降で利用可能。

ビューの制約の管理

constraints プロパティ

ビューに保持されている制約。(読み取り専用)

宣言

<< SWIFT >>

var constraints: [NSLayoutConstraint] { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly) NSArray <__kindof NSLayoutConstraint *> *constraints

利用可能

iOS 6.0 以降で利用可能。

- addConstraint:

受信しているビューまたはそのサブビューのレイアウト上に制約を追加します。

宣言

<< SWIFT >>

func addConstraint(_ constraint: NSLayoutConstraint)

<< OBJECTIVE-C >>
- (void)addConstraint:(NSLayoutConstraint *)constraint

パラメーター

constraint

ビューに追加されるべき制約。制約はビューそれ自体またはそのサブビューを参照することだけができます。

議論

制約は、受信しているビューの範囲内にあるビューのみを含む必要があります。具体的には、含まれる全てのビューは、受信しているビューそれ自体、あるいは受信しているビューのサブビューのいずれかでなければなりません。ビューに追加された制約は、そのビューによって保持されると言います。制約を評価する際に使用される座標系は、制約を保持しているビューの座標系です。

iOS 8.0 以降で開発する場合は、addConstraint: メソッドを直接呼び出す代わりに、制約の active プロパティを YES に設定します。active プロパティは、正しいビューから制約を自動的に追加し、削除します。

利用可能

iOS 6.0 以降で利用可能。

- addConstraints:

受信しているビューまたはそのサブビューのレイアウトに複数の制約を追加します。

宣言

<< SWIFT >>

func addConstraints(_ constraints: [NSLayoutConstraint])

<< OBJECTIVE-C >>
- (void)addConstraints:(NSArray<__kindofNSLayoutConstraint *> *)constraints

パラメーター

constraints

ビューに追加されるべき制約の配列。すべての制約はビュー自体またはそのサブビューを参照することだけができます。

議論

すべての制約は、受信しているビューの範囲内にあるビューのみを含める必要があります。具体的には、含まれる全てのビューは、受信しているビューそれ自体、あるいは受信しているビューのサブビューのいずれかでなければなりません。ビューに追加された制約は、そのビューによって保持されると言います。各制約を評価する際に使用される座標系は、制約を保持しているビューの座標系です。

iOS 8.0 以降で開発する場合、addConstraints: メソッドを直接呼び出す代わりに、NSLayoutConstraint クラスの activateConstraints: メソッドを使用して下さい。activateConstraints: メソッドは、自動的に正しいビューに制約を追加します。

利用可能

iOS 6.0 以降で利用可能。

- removeConstraint:

ビューから指定された制約を削除します。

宣言

<< SWIFT >>

func removeConstraint(_ constraint: NSLayoutConstraint)

<< OBJECTIVE-C >>
- (void)removeConstraint:(NSLayoutConstraint *)constraint

パラメーター

constraint

削除すべき制約。ビューによって保持されていない制約を削除しても効果はありません。

議論

iOS 8.0 以降で開発する時は、removeConstraint: メソッドを直接呼び出す代わりに、制約の active プロパティを NO に設定して下さい。active プロパティは、正しいビューからの制約を自動的に追加し、削除します。

利用可能

iOS 6.0 以降で利用可能。

- removeConstraints:

ビューから指定された複数の制約を削除します。

宣言

<< SWIFT >>

func removeConstraints(_ constraints: [NSLayoutConstraint])

<< OBJECTIVE-C >>
- (void)removeConstraints:(NSArray<__kindofNSLayoutConstraint *> *)constraints

パラメーター

constraints

削除すべき複数の制約。

議論

iOS 8.0 以降で開発する時は、removeConstraint: メソッドを直接呼び出す代わりに、NSLayoutConstraint クラスの deactivateConstraints: メソッドを使用して下さい。deactivateConstraints: メソッドは、正しいビューからの制約を自動的に削除します。

利用可能

iOS 6.0 以降で利用可能。

レイアウトガイドでの作業

- addLayoutGuide:

ビューに、指定されたレイアウトガイドを追加します。

宣言

<< SWIFT >>

func addLayoutGuide(_ layoutGuide: UILayoutGuide)

<< OBJECTIVE-C >>
- (void)addLayoutGuide:(UILayoutGuide *)layoutGuide

パラメーター

layoutGuide

追加されるべきレイアウトガイド。

議論

このメソッドは、ビューの layoutGuides 配列の最後に、指定されたレイアウトガイドを追加します。また、ガイドの owningView プロパティにビューを割り当てます。各ガイドは、一つだけ所有ビューを持てます。

ガイドがビューに追加された後、そのビューの階層との自動レイアウトの制約に参加できます。

利用可能

iOS 9.0 以降で利用可能。

layoutGuides プロパティ

このビューが所有するレイアウトガイドオブジェクトの配列。(読み取り専用)

宣言

<< SWIFT >>

var layoutGuides: [UILayoutGuide] { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly, copy) NSArray <__kindof UILayoutGuide *> *layoutGuides

利用可能

iOS 9.0 以降で利用可能。

layoutMarginsGuide プロパティ

ビューの余白を表すレイアウトガイド。(読み取り専用)

宣言

<< SWIFT >>

var layoutMarginsGuide: UILayoutGuide { get }

<< OBJECTIVE-C >>
@property(readonly, strong) UILayoutGuide *layoutMarginsGuide

議論

ビューの余白で制約を作成するには、このレイアウトガイドのアンカーを使用してください。

利用可能

iOS 9.0 以降で利用可能。

以下も見よ

layoutMargins

readableContentGuide プロパティ

ビュー内で読み取り可能な幅の領域を表すレイアウトガイド。(読み取り専用)

宣言

<< SWIFT >>

var readableContentGuide: UILayoutGuide { get }

<< OBJECTIVE-C >>
@property(nonatomic, readonly, strong) UILayoutGuide *readableContentGuide

議論

このレイアウトガイドは、ラインを追跡するために、ユーザーに自分の頭を移動するのを強制することなく読み取ることができる領域を定義します。読み取り可能なコンテンツ領域には、以下の規則に従います。

読み取り可能なコンテンツガイドは、決してビューのレイアウトマージンガイドを越えて延びません。

読み取り可能なコンテンツガイドは、レイアウトマージンガイド内側の垂直の中央に配置されます。

読み取り可能なコンテンツガイドの幅は、現在の動的テキストサイズで定義された読み取り可能な幅よりも小さいかに等しいです。

テキストの単一の列をレイアウトするために読み取り可能なコンテンツガイドを使用してください。複数の列をレイアウトしている場合、あなたの列に最適な幅を決定するために、ガイドの幅を使用できます。

利用可能

iOS 9.0 以降で利用可能。

- removeLayoutGuide:

ビューから、指定されたレイアウトガイドを削除します。

宣言

<< SWIFT >>

func removeLayoutGuide(_ layoutGuide: UILayoutGuide)

<< OBJECTIVE-C >>
- (void)removeLayoutGuide:(UILayoutGuide *)layoutGuide

パラメーター

layoutGuide

削除されるべきレイアウトガイド。

議論

このメソッドは、ビューの layoutGuides 配列からレイアウトガイドを削除し、ガイドの owningView プロパティを nil に設定します。また、レイアウトガイドへの全ての制約を削除します。

ビュー階層内のビューに追加されない限り、レイアウトガイドは、自動レイアウトの制約に参加できません。

利用可能

iOS 9.0 以降で利用可能。

自動レイアウトでの測定

- systemLayoutSizeFittingSize:

それが保持している制約を満たすビューのサイズを返します。

宣言

<< SWIFT >>

func systemLayoutSizeFittingSize(_ targetSize: CGSize) -> CGSize

<< OBJECTIVE-C >>
- (CGSize)systemLayoutSizeFittingSize:(CGSize)targetSize

パラメーター

targetSize

制約を満たす最小または最大の可能サイズにしたいかどうかを示します。受け入れられる値については、Fitting Size を参照してください。

戻り値

保持している制約を満たすビューのサイズ。

議論

保持している全ての制約とそのサブビューの制約を考慮した、ビューの最適なサイズを決定します。

利用可能

iOS 6.0 以降で利用可能。

- systemLayoutSizeFittingSize:withHorizontalFittingPriority
:verticalFittingPriority:

保持している制約を満たすビューのサイズを返します。

宣言

<< SWIFT >>

func systemLayoutSizeFittingSize(_ targetSize: CGSize,
   withHorizontalFittingPriority horizontalFittingPriority: UILayoutPriority,
         verticalFittingPriority verticalFittingPriority: UILayoutPriority) -> CGSize

<< OBJECTIVE-C >>
- (CGSize)systemLayoutSizeFittingSize:(CGSize)targetSize
        withHorizontalFittingPriority:(UILayoutPriority)horizontalFittingPriority
              verticalFittingPriority:(UILayoutPriority)verticalFittingPriority

パラメーター

TargetSize	制約を満たす最小または最大の可能サイズにしたいかどうかを示します。受け入れられる値については、Fitting Size を参照してください。
horizontalFittingPriority	水平制約の優先性。
verticalFittingPriority	垂直制約の優先性。

戻り値

保持している制約を満たすビューのサイズ。

議論

保持している全ての制約とそのサブビューの制約を考慮した、ビューの最適なサイズを決定します。

利用可能

iOS 8.0 以降で利用可能。

- intrinsicContentSize

ビューそれ自体のプロパティのみを考慮して、受信しているビューの自然なサイズを返します。

宣言

<< SWIFT >>

func intrinsicContentSize() -> CGSize

<< OBJECTIVE-C >>
- (CGSize)intrinsicContentSize

戻り値

その固有のプロパティに基づいて、受信しているビューの自然なサイズを示すサイズ。

議論

カスタムビューは、典型的には、それらのレイアウトシステムが認識していないものを表示するコンテンツを持っています。このメソッドをオーバーライドすると、カスタムビューに、そのコンテンツに基づきたいと思う、レイアウトシステムのサイズと通信することを可能にします。例えば、変更された高さに基づいてレイアウトシステムに、変更された幅を動的に通信する方法はありませんので、この固有のサイズは、コンテンツフレームに独立していなければなりません。

カスタムビューが、与えられた寸法に本質的なサイズを持っていない場合は、その寸法の UIViewNoIntrinsicMetric を返せます。

利用可能

iOS 6.0 以降で利用可能。

- invalidateIntrinsicContentSize

ビュー固有のコンテンツのサイズを無効にします。

宣言

<< SWIFT >>

func invalidateIntrinsicContentSize()

<< OBJECTIVE-C >>
- (void)invalidateIntrinsicContentSize

議論

何かがその固有のコンテンツサイズを無効化するカスタムビューで変更されたときにこれを呼び出して下さい。これは、次のレイアウトパスでアカウントに新しい固有コンテンツのサイズを取る事を制約ベースのレイアウトシステムに可能にします。

利用可能

iOS 6.0 以降で利用可能。

- contentCompressionResistancePriorityForAxis:

ビューがその固有のサイズよりも小さくされる事を抵抗する優先性を返します。

宣言

<< SWIFT >>

func contentCompressionResistancePriorityForAxis(_ axis: UILayoutConstraintAxis) -> UILayoutPriority

<< OBJECTIVE-C >>
- (UILayoutPriority)contentCompressionResistancePriorityForAxis:(UILayoutConstraintAxis)axis

パラメーター

axis

低下するおそれのあるビューの軸。

戻り値

指定された軸上でその固有のサイズから圧縮される事にビューが抵抗すべき優先性。

議論

それらが固有のサイズよりも小さくなるように必要とする制約に遭遇しているビューの最良のレイアウトを決定する際に制約ベースのレイアウトシステムは、これらの優先性を使用します。

サブクラスは、このメソッドをオーバーライドするべきではありません。代わりに、カスタムビューは、一般的に UILayoutPriorityDefaultLow または UILayoutPriorityDefaultHigh の作成時にそれらのコンテンツのデフォルト値を設定する必要があります。

利用可能

iOS 6.0 以降で利用可能。

以下も見よ

– setContentCompressionResistancePriority:forAxis:

ビューがその固有のサイズよりも小さくされる事を抵抗する優先性をを設定します。

宣言

<< SWIFT >>

func setContentCompressionResistancePriority(_ priority: UILayoutPriority,
                                     forAxis axis: UILayoutConstraintAxis)

<< OBJECTIVE-C >>
- (void)setContentCompressionResistancePriority:(UILayoutPriority)priority
                                        forAxis:(UILayoutConstraintAxis)axis

パラメーター

priority	新しい優先性。
axis	圧縮抵抗の優先性が設定される必要のある軸。

議論

カスタムビューは UILayoutPriorityDefaultLow または UILayoutPriorityDefaultHigh で典型的に、その内容に基づいて、作成時に両方の向きのデフォルト値を設定する必要があります。ユーザインタフェースを作成する時は、、インターフェースで使われるビューの自然な優先度よりも全体的なレイアウト設計が異なるトレードオフを必要とする場合、レイアウト設計者は、特定のビューで、これらの優先性を変更できます。

サブクラスは、このメソッドをオーバーライドするべきではありません。

利用可能

iOS 6.0 以降で利用可能。

以下も見よ

– contentCompressionResistancePriorityForAxis:

- contentHuggingPriorityForAxis:

ビューがその固有のサイズよりも大きくされる事を抵抗する優先性を返します。

宣言

<< SWIFT >>

func contentHuggingPriorityForAxis(_ axis: UILayoutConstraintAxis) -> UILayoutPriority

<< OBJECTIVE-C >>
- (UILayoutPriority)contentHuggingPriorityForAxis:(UILayoutConstraintAxis)axis

パラメーター

axis

拡大する可能性があるビューの軸。

戻り値

指定された軸上でその固有のサイズから拡大される事にビューは抵抗するべき優先性。

議論

それらの固有の大きさよりも大きくなるように、それらに必要とする制約に遭遇しているビューの最良のレイアウトを決定する際に制約ベースのレイアウトシステムは、これらの優先性を使用します。

利用可能

iOS 6.0 以降で利用可能。

以下も見よ

– setContentHuggingPriority:forAxis:

ビューがその固有のサイズよりも大きくなる事に抵抗する優先性を設定します。

宣言

<< SWIFT >>

func setContentHuggingPriority(_ priority: UILayoutPriority,
                       forAxis axis: UILayoutConstraintAxis)

<< OBJECTIVE-C >>
- (void)setContentHuggingPriority:(UILayoutPriority)priority
                          forAxis:(UILayoutConstraintAxis)axis

パラメーター

priority	新しい優先性。
axis	コンテンツが抱えている優先性が設定されるべき軸。

議論

カスタムビューは、UILayoutPriorityDefaultLow または UILayoutPriorityDefaultHigh に典型的な、その内容に基づいて、作成時に両方の向きのデフォルト値を設定する必要があります。ユーザインタフェースを作成する時、インターフェースで使用されているビューの自然な優先性とは異なるトレードオフを必要とする場合、レイアウト設計者は、全体的なレイアウト設計する時、特定のビューのため、これらの優先性を変更できます。

サブクラスは、このメソッドをオーバーライドするべきではありません。

利用可能

iOS 6.0 以降で利用可能。

以下も見よ

– contentHuggingPriorityForAxis:

自動レイアウトで整列ビュー

- alignmentRectForFrame:

与えられたフレーム用のビューの整列用の長方形を返します。

宣言

<< SWIFT >>

func alignmentRectForFrame(_ frame: CGRect) -> CGRect

<< OBJECTIVE-C >>
- (CGRect)alignmentRectForFrame:(CGRect)frame

パラメーター

frame

対応する整列用長方形が望まれているフレーム。

戻り値

指定されたフレーム用の整列用長方形。

議論

そのフレームよりもむしろ、制約ベースのレイアウトシステムは、ビューを整列するのに整列用長方形を使用します。カスタムビューは、それらが、影や反射のような、その内容の周りに描画する必要がある任意の装飾を含むフレームをまだ持ちながら、そのコンテンツの場所に基づいて整列させることを可能にします。

デフォルトの実装では、ビューの alignmentRectInsets によって変更される、ビューのフレームを返します。ほとんどのカスタムビューは、そのフレーム内でコンテンツの場所を指定する alignmentRectInsets をオーバーライドできます。任意の変換を必要とするカスタムビューは alignmentRectForFrame: をオーバーライドでき、frameForAlignmentRect: に、そのコンテンツの場所を記述させます。これらの2つのメソッドは、常に互いの逆でなければなりません。

利用可能

iOS 6.0 以降で利用可能。

- frameForAlignmentRect:

与えられ整列用長方形のビューのフレームを返します。

宣言

<< SWIFT >>

func frameForAlignmentRect(_ alignmentRect: CGRect) -> CGRect

<< OBJECTIVE-C >>
- (CGRect)frameForAlignmentRect:(CGRect)alignmentRect

パラメーター

alignmentRect

その対応するフレームが望まれている、整列用長方形。

戻り値

指定された整列用長方形のフレーム。

議論

デフォルトの実装では、ビューの alignmentRectInsets によって変更される、alignmentRect を返します。ほとんどのカスタムビューは、そのフレーム内でコンテンツの場所を指定する alignmentRectInsets をオーバーライドできます。任意の変換を必要とするカスタムビューは alignmentRectForFrame: をオーバーライドでき、frameForAlignmentRect: に、そのコンテンツの場所を記述させます。これらの2つのメソッドは、常に互いの逆でなければなりません。

利用可能

iOS 6.0 以降で利用可能。

- alignmentRectInsets

その整列用長方形を定義する、ビューのフレームから差し込まれたものを返します。

宣言

<< SWIFT >>

func alignmentRectInsets() -> UIEdgeInsets

<< OBJECTIVE-C >>
- (UIEdgeInsets)alignmentRectInsets

戻り値

その整列用長方形を定義する、ビューのフレームから差し込まれたもの。

議論

このメソッドのデフォルトの実装は、ゼロの値を持つ NSEdgeInsets 構造体を返します。その内容の周りに装飾を描くカスタムビューは、装飾を除いたコンテンツの縁で、整列された差し込み物を返すために、このメソッドをオーバーライドする必要があります。これは、ちょうどそれらのフレームというよりも、その内容に基づいてビューを配置することができるように制約ベースのレイアウトシステムに許可します。

そのコンテンツの場所が差し込まれた物の簡単なセットでは表現できないカスタムビューは alignmentRectForFrame: をオーバーライドする必要があり、frameForAlignmentRect: で整列用長方形とフレームとの間のカスタム変換について説明します。

利用可能

iOS 6.0 以降で利用可能。

- viewForBaselineLayout

(iOS 9.0)

ベースラインの制約を満たすために使用されるビューを返します。

旧式の文

代わりに viewForFirstBaselineLayout か viewForLastBaselineLayout プロパティを使用して下さい。

宣言

<< SWIFT >>

func viewForBaselineLayout() -> UIView

<< OBJECTIVE-C >>
- (UIView *)viewForBaselineLayout

戻り値

制約システムが、ベースラインの制約を満たすために使用すべきビュー。

議論

ビューの NSLayoutAttributeBaseline 属性に制約を加えると、自動レイアウトは、このメソッドによって返されるビューのベースラインを使用します。そのビューがベースラインを持っていない場合は、自動レイアウトは、ビューの下端を使用します。

(例えば、UILabel またはスクロールしない UITextView で) テキストベースのサブビューを返すためには、このメソッドをオーバーライドして下さい。このメソッドをオーバーライドする場合は、返されたビューは、受信者のサブビューでなければなりません。デフォルトの実装では、受信するビューを返します。

利用可能

iOS 6.0 以降で利用可能。

iOS 9.0 で旧式となる。

viewForFirstBaselineLayout プロパティ

最初のベースラインの制約を満たすために使用されるビューを返します。(読み取り専用)

宣言

<< SWIFT >>

var viewForFirstBaselineLayout: UIView { get }

<< OBJECTIVE-C >>
@property(readonly, strong) UIView *viewForFirstBaselineLayout

議論

テキストの複数行のビューでは、最初のベースラインは、一番上の行のベースラインです。

ビューの NSLayoutAttributeFirstBaseline 属性に制約を加えると、自動レイアウトは、このメソッドによって返されるビューのベースラインを使用します。そのビューがベースラインを持っていない場合は、自動レイアウトは、ビューの上端を使用します。

(例えば、UILabel またはスクロールしない UITextView で) テキストベースのサブビューを返すためには、このプロパティをオーバーライドして下さい。返されるビューは、受信者のサブビューでなければなりません。デフォルトの実装は、viewForLastBaselineLayout に含まれる値を返します。

注意： 同じサブビューが、最初と最後のベースラインの両方に適している場合は、同じサブビューは、最初と最後のベースラインの両方に適している場合は、viewForLastBaselineLayout ゲッターメソッドをオーバーライドするだけの必要があります。

利用可能

iOS 9.0 以降で利用可能。

viewForBaselineLayout プロパティ

最後のベースラインの制約を満たすために使用されるビューを返します。(読み取り専用)

宣言

<< SWIFT >>

var viewForLastBaselineLayout: UIView { get }

<< OBJECTIVE-C >>
@property(readonly, strong) UIView *viewForLastBaselineLayout

議論

テキストの複数行のビューについては、最後のベースラインは、一番下の行のベースラインです。

ビューの NSLayoutAttributeLastBaseline 属性に制約を加えると、自動レイアウトは、このメソッドによって返されるビューのベースラインを使用します。そのビューがベースラインを持っていない場合は、自動レイアウトは、ビューの下端を使用します。

(例えば、UILabel またはスクロールしない UITextView で) テキストベースのサブビューを返すためには、このプロパティをオーバーライドして下さい。返されるビューは、受信者のサブビューでなければなりません。デフォルトの実装は、受信しているビューを返します。

利用可能

iOS 9.0 以降で利用可能。

自動レイアウトをトリガする

- needsUpdateConstraints

ビューの制約が更新する必要があるかどうかを決定するブール値。

宣言

<< SWIFT >>

func needsUpdateConstraints() -> Bool

<< OBJECTIVE-C >>
- (BOOL)needsUpdateConstraints

戻り値

ビューの制約が更新を必要とする場合 YES、そうでない場合 NO。

議論

制約ベースのレイアウトシステムは、その通常のレイアウトパスの一部としてビューの updateConstraints を呼び出す必要があるかどうかを決定するために、このメソッドの戻り値を使用します。

利用可能

iOS 6.0 以降で利用可能。

以下も見よ

ビューの制約は更新が必要かどうかを制御します。

宣言

<< SWIFT >>

func setNeedsUpdateConstraints()

<< OBJECTIVE-C >>
- (void)setNeedsUpdateConstraints

議論

カスタムビューのプロパティが制約に影響を与えるように変更した場合、制約が将来のある時点で更新する必要があることを示すには、このメソッドを呼び出せます。その後、システムは、通常のレイアウトパスの一部として updateConstraints を呼び出します。バッチの制約変化への最適化ツールとしてこれを使用してください。それらが必要とされる直前にすべてを一度に制約を更新すると、複数の変更がレイアウトパスの間に、あなたのビューに加えられたときに、制約を不必要なに再計算しないことが保証されます。

利用可能

iOS 6.0 以降で利用可能。

以下も見よ

- needsUpdateConstraints

- updateConstraints

ビューの制約の更新。

宣言

<< SWIFT >>

func updateConstraints()

<< OBJECTIVE-C >>
- (void)updateConstraints

議論

制約への変更を最適化するには、このメソッドをオーバーライドして下さい。

注意： 影響する変更が発生した直後に制約を更新する方が常にクリーンで簡単です。例えば、ボタンタップに応じて制約を変更したい場合は、ボタンのアクションメソッドで直接その変更を行います。

ビューが多くの冗長な変更を生成しているときや、場所で制約を変更することが遅すぎる場合、このメソッドをオーバーライドするだけの必要があります。

変更をスケジュール化するには、ビューの setNeedsUpdateConstraints を呼び出します。その後、システムは、レイアウトが発生する前に updateConstraints の実装を呼び出します。これは、あなたのカスタムビューのプロパティが変更されていない場合、コンテンツに必要なすべての制約が所定の位置にあることを一度に確認できます。

あなたの実装は、可能な限り効率的でなければなりません。すべての制約を無効化せず、あなたが必要とするものを再度アクティブ化して下さい。代わりに、あなたのアプリが制約を追跡し、各更新パスの間に、それらを検証するいくつかの方法を持っている必要があります。変更が必要な項目だけを変更して下さい。各更新パスの間に、アプリの現在の状態用の適切な制約を持っていることを確認する必要があります。

実装の内部の setNeedsUpdateConstraints を呼び出さないでください。setNeedsUpdateConstraints を呼び出すと、別の更新パスをスケジュールし、フィードバックループを作成します。

重要： [super updateConstraints] を実装の最終ステップとして呼び出して下さい。

利用可能

iOS 6.0 以降で利用可能。

- updateConstraintsIfNeeded

受信しているビューとそのサブビューの制約を更新します。

宣言

<< SWIFT >>

func updateConstraintsIfNeeded()

<< OBJECTIVE-C >>
- (void)updateConstraintsIfNeeded

議論

新しいレイアウトパスがビューのためにトリガーされるたびに、システムは、ビューの全ての制約とそのサブビューが、現在のビュー階層とその制約からの情報で更新されていることを確認するには、このメソッドを呼び出して下さい。このメソッドは、システムによって自動的に呼び出されますが、最新の制約を検討する必要がある場合は、手動で呼び出せます。

サブクラスは、このメソッドをオーバーライドするべきではありません。

利用可能

iOS 6.0 以降で利用可能。

自動レイアウトのデバッグ

制約ベースのレイアウトのデバッグの詳細については、自動レイアウトガイド を参照してください。

- constraintsAffectingLayoutForAxis:

与えられた軸のビューのレイアウトに影響を与える制約を返します。

宣言

<< SWIFT >>

func constraintsAffectingLayoutForAxis(_ axis: UILayoutConstraintAxis) -> [NSLayoutConstraint]

<< OBJECTIVE-C >>
- (NSArray&glt__kindofNSLayoutConstraint *> *)constraintsAffectingLayoutForAxis:(UILayoutConstraintAxis)axis

パラメーター

axis

制約が発見されるべき軸。

戻り値

指定された軸のビューのレイアウトに影響を与える制約。

議論

制約の返されたセットは、明示的にビューをすべて含んでいないのことがあります。暗黙的にビューの位置に影響を与える制約も含まれているかもしれません。これはデバッグのため良い出発点を提供していますが、制約の返されたセットは、与えられた向きのビューのレイアウトに影響を与える制約のすべてを含んでいる保証はありません。

このメソッドは、制約ベースのレイアウトをデバッグするためにのみ使用されるべきです。アプリケーションは、その操作の一部として、このメソッドへの呼び出しが含まれてはなりません。

利用可能

iOS 6.0 以降で利用可能。

- hasAmbiguousLayout

ビューのレイアウトに影響を与える制約が不完全にビューの位置を指定するかどうかを決定するブール値。

宣言

<< SWIFT >>

func hasAmbiguousLayout() -> Bool

<< OBJECTIVE-C >>
- (BOOL)hasAmbiguousLayout

戻り値

ビューの位置が不完全に指定されている場合 YES、そうでなければ NO。

議論

このメソッドは、ビューが、ビューの制約も満足させることができる、他のフレームがあるかどうかを確認します。これは高価な操作であり、通常のレイアウト処理の一部として実行されませんが、与えられたインタフェースが一貫性のあるレイアウトを確実にするために、十分な数の制約で指定されているかどうかをデバッグする際に役立ちます。

利用可能

iOS 6.0 以降で利用可能。

- exerciseAmbiguityInLayout

別の有効な値の間の曖昧なレイアウトでビューのフレームをランダムに変更します。

宣言

<< SWIFT >>

func exerciseAmbiguityInLayout()

<< OBJECTIVE-C >>
- (void)exerciseAmbiguityInLayout

議論

このメソッドは、別の有効な値の間の曖昧なレイアウトでビューのフレームをランダムに変更し、インターフェイス内を移動するビューを引き起こします。ビューの位置を完全に指定するために、レイアウトに追加する必要がどのような制約を見分ける事を、開発者に可能にすることが容易になり、有効なフレームがどのような物か視覚的に識別できます。

利用可能

iOS 6.0 以降で利用可能。

ユーザーインターフェイスの方向の管理

semanticContentAttribute プロパティ

ビューの内容の意味の説明は、左から右へと右から左へのレイアウトを切り替えると、ビューを反転する必要があるかどうかを判断します。

宣言

<< SWIFT >>

var semanticContentAttribute: UISemanticContentAttribute

<< OBJECTIVE-C >>
@property(nonatomic) UISemanticContentAttribute semanticContentAttribute

議論

左から右へと右から左へのレイアウトを切り替えると、いくつかのビューは反転しないかもしれません。たとえば、ビューは、再生コントロールの一部であるか、または変更しない(上、下、右、左) 物理的な方向を表します。ビューがその向きを変えるべきかどうかを考える代わりに、最高にビューを説明する意味内容の属性を選択して下さい。

サブビューを含むビューを作成する時は、サブビューが反転すべきかどうかを決定するために、クラスメソッド userInterfaceLayoutDirectionForSemanticContentAttribute: を使用し、適切な順序でビューをレイアウトできます。

可能な値のリストについては、UISemanticContentAttribute を参照してください。

利用可能

iOS 6.0 以降で利用可能。

+ userInterfaceLayoutDirectionForSemanticContentAttribute:

与えられた意味内容の属性用のユーザインタフェースの方向を返します。

宣言

<< SWIFT >>

class func userInterfaceLayoutDirectionForSemanticContentAttribute(_ attribute:
 UISemanticContentAttribute) -> UIUserInterfaceLayoutDirection

<< OBJECTIVE-C >>
+ (UIUserInterfaceLayoutDirection)userInterfaceLayoutDirectionForSemanticContentAttribute:
(UISemanticContentAttribute)attribute

パラメーター

attrubute

ビューの意味内容の属性。

戻り値

ユーザインタフェースのレイアウトの方向(左から右へ、または右から左へ)。

議論

サブビューを含むビューを作成するときは、サブビューを反転する必要があるかどうかを判断するためにこのメソッドを使用して、適切な順序でビューをレイアウトできます。

利用可能

iOS 9.0 以降で利用可能。

コンテンツの余白の構成

layoutMargins プロパティ

ビュー内のコンテンツをレイアウトする際使用する、デフォルトの間隔。

宣言

<< SWIFT >>

var layoutMargins: UIEdgeInsets

<< OBJECTIVE-C >>
@property(nonatomic) UIEdgeInsets layoutMargins

議論

ビューと全てのサブビューの縁との間の(ポイント単位で測定された) 空間の所望の量を指定するには、このプロパティを使用して下さい。自動レイアウトは、コンテンツを配置するための手がかりとして、あなたのマージンを使用します。たとえば、フォーマット文字列 “|-[subview]-|”を使用して、水平方向の制約のセットを指定した場合、サブビューの左右の縁は、対応するレイアウトマージンでスーパービューの端からはめ込まれています。あなたのビューの縁がスーパービューの縁に近く、preservesSuperviewLayoutMargins プロパティが YES の場合、実際のレイアウトマージンはスーパービューのマージンがオーバーラップスル事からコンテンツを防ぐために増加されています。

デフォルトのマージン(余白) は、それぞれの側に 8 ポイントです。

ビューが、ビューコントローラのルートビューである場合は、システムがマージンを設定し、管理します。上下の余白はゼロポイントに設定されています。左右のマージンは、現在のサイズクラスによって異なりますが、16 または 20 ポイントにできます。これらの余白を変更することはできません。

利用可能

iOS 8.0 以降で利用可能。

preservesSuperviewLayoutMargins プロパティ

現在のビューも、そのスーパービューのマージンを尊重するかどうかを示すブール値。

宣言

<< SWIFT >>

var preservesSuperviewLayoutMargins: Bool

<< OBJECTIVE-C >>
@property(nonatomic) BOOL preservesSuperviewLayoutMargins

議論

このプロパティの値が YES の時は、コンテンツをレイアウトするときに、スーパービューのマージンも考慮されています。このマージンは、ビューのエッジとそのスーパービューの間の距離が、対応するマージンよりも小さい場合、レイアウトに影響を与えます。たとえば、そのフレームが正確にそのスーパービューの境界に一致するコンテンツビューを持っている可能性があります。スーパービューのマージンのいずれかが、コンテンツのビューと独自のマージンで示される領域内にある場合には、UIKit はスーパービューのマージンを尊重するために、コンテンツビューのレイアウトを調整します。調整の量は、その内容を保証するために必要な最小量であり、スーパービューのマージンの内側でもあります。

このプロパティのデフォルト値は、NO です。

利用可能

iOS 8.0 以降で利用可能。

- layoutMarginsDidChange

レイアウトのマージンが変更したと、そのビューに通知します。

宣言

<< SWIFT >>

func layoutMarginsDidChange()

<< OBJECTIVE-C >>
- (void)layoutMarginsDidChange

議論

このメソッドのデフォルト実装は何もしません。サブクラスは、このメソッドをオーバーライドし、ビューの layoutMargins プロパティの値が変わった時に応答するように使用できます。例えば、あなたのビューのサブクラスが手動でレイアウトを処理したり、描画時のレイアウトのマージンを使用している場合、このメソッドをオーバーライドします。両方の場合、図面やレイアウト更新を開始するために、このメソッドを使用できます。

利用可能

iOS 8.0 以降で利用可能。

ビューの描画と更新

- drawRect:

渡された長方形内に受信者のイメージを描画します。

宣言

<< SWIFT >>

func drawRect(_ rect: CGRect)

<< OBJECTIVE-C >>
- (void)drawRect:(CGRect)rect

パラメーター

rect

更新が必要なビューの境界の一部。あなたのビューが描画される最初の時は、この長方形は、典型的には、あなたのビューの全可視範囲です。しかし、その後の描画操作中に、長方形は、ビューの一部だけを指定できます。

議論

このメソッドのデフォルトの実装は何もしません。そのビューのコンテンツを描画するために、コアグラフィックスと UIKit のような技術を使用するサブクラスは、このメソッドをオーバーライドして、そこに自分の描画コードを実装する必要があります。あなたのビューが、他の方法でそのコンテンツを設定した場合、このメソッドをオーバーライドする必要はありません。例えば、あなたのビューがちょうど背景色を表示するか、そのコンテンツを直接下にある層のオブジェクトを使用して設定している場合、このメソッドをオーバーライドする必要はありません。

このメソッドが呼び出された時点では、UIKit はビューのために適切に描画環境を構成しており、あなたがコンテンツをレンダリングする必要がある、どのような描画メソッドや関数を単に呼び出せます。具体的には、UIKit は描画するためのグラフィックスコンテキストを作成して構成し、その起源があなたのビューの境界の長方形の原点と一致するように、そのコンテキストの変換を調整します。 UIGraphicsGetCurrentContext 機能を使用して、グラフィックスコンテキストへの参照を取得することができますが、それは drawRect: メソッドへの呼び出しの間で変更しうるので、グラフィックスコンテキストへの強い参照は確立しません。

同様に、OpenGL ES と GLKView クラスを使用して描画する場合は、GLKit は、このメソッドを呼び出す(またはあなたの GLKView デリゲートの glkView:drawInRect: メソッド) 前に、あなたのビューに応じて適切に基礎となる OpenGL ES コンテキストを構成し、どのような OpenGL ES があなたのコンテンツをレンダリングする必要があると何であれ命令する者を簡単に発行できます。OpenGL ES を使用して描画する方法の詳細については、iOS 用の OpenGL ES プログラミングガイド を参照してください。

rect パラメータで指定した長方形に、全ての描画を制限する必要があります。加えて、ビューの opaque プロパティが、YES に設定されている場合、あなたの drawRect: メソッドは、不透明内容で、指定された長方形を完全に埋めなければなりません。

直接 UIView のサブクラスを作成する場合は、このメソッドの実装は、super を呼び出す必要はありません。しかし、別のビュークラスをサブクラス化している場合は、実装の中でいくつかの点で super を呼び出す必要があります。

ビューが最初に表示されるか、イベントが発生したときには、ビューの可視部分を無効にすると、このメソッドが呼び出されます。直接自分自身でこのメソッドを呼び出しては決してなりません。代わりに、あなたのビューの一部を無効にし、したがってその部分を再描画させるために、setNeedsDisplay または setNeedsDisplayInRect: を呼び出します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– setNeedsDisplay
– setNeedsDisplayInRect:
contentMode

- setNeedsDisplay

再描画するべきものとして、受信者の全体の境界の長方形をマークします。

宣言

<< SWIFT >>

func setNeedsDisplay()

<< OBJECTIVE-C >>
- (void)setNeedsDisplay

議論

ビューのコンテンツを再描画する必要があるシステムに通知するために、このメソッドまたは setNeedsDisplayInRect: を使用できます。このメソッドは、リクエストのメモを作成し、すぐに戻ります。すべて無効化されたビューが更新されるポイントで、次の描画サイクルまでビューは実際には、再描画されません。

注意： あなたのビューが CAEAGLLayer オブジェクトによって支えられている場合、このメソッドは効果がありません。これは、そのコンテンツをレンダリングするために(UIKit や Core Graphicsのような) ネイティブな描画技術を使用するビューで使用するためのものです。

ビューは、ビューの変更の場合にのみコンテンツや外観を再描画することを要求するため、このメソッドを使用する必要があります。単にビューの外観を変更すると、ビューは一般的に再描画しません。代わりに、その既存のコンテンツは、ビューの contentMode プロパティの値に基づいて調整されます。既存のコンテンツを再表示すると、変更していないコンテンツを再描画する必要性を回避することによってパフォーマンスが向上します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– drawRect:
– setNeedsDisplayInRect:
contentMode

- setNeedsDisplayInRect:

再描画が必要であると受信者の指定された長方形をマークします。

宣言

<< SWIFT >>

func setNeedsDisplayInRect(_ rect: CGRect)

<< OBJECTIVE-C >>
- (void)setNeedsDisplayInRect:(CGRect)invalidRect

パラメーター

invalidRect

無効としてマークすべき受信者の長方形の領域。それは、受信者の座標系で指定する必要があります。

議論

ビューのコンテンツを再描画する必要があるシステムに通知するために、このメソッドまたは setNeedsDisplay を使用できます。このメソッドはただちに無効な長方形のビューの現在のリストに指定された長方形を追加し返します。ビューは、すべて無効化されたビューが更新されるポイントで、実際には次の描画サイクルまで再描画されません。

注意： あなたのビューが CAEAGLLayer オブジェクトによって支えられている場合、このメソッドは効果がありません。これは、そのコンテンツをレンダリングするために(UIKit と Core Graphics のような) ネイティブの描画技術を使用するビューでのみ使用するためのものです。

ビューは、ビューのコンテンツや外観が変更した場合にのみ再描画することを要求するために、このメソッドを使用する必要があります。単にビューの外観を変更する場合、ビューは一般的に再描画されません。代わりに、その既存のコンテンツは、ビューの contentMode プロパティの値に基づいて調整されます。既存のコンテンツを再表示すると、変更されていないコンテンツを再描画する必要性を回避することによってパフォーマンスが向上します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

– drawRect:
– setNeedsDisplay
contentMode

contentScaleFactor プロパティ

ビューに適用されるスケール係数。

宣言

<< SWIFT >>

var contentScaleFactor: CGFloat

<< OBJECTIVE-C >>
@property(nonatomic) CGFloat contentScaleFactor

議論

スケール係数は、ビュー内のコンテンツが、デバイスの座標空間(ピクセル単位で測定) に論理座標空間(ポイント単位で測定) からマッピングされる方法を決定します。この値は、通常、1.0 または 2.0 のいずれかです。より高いスケール係数は、ビューの各ポイントが、下層内の複数のピクセルで表現されることを示しています。例えば、スケール係数が 2.0 であり、ビューのフレームサイズが、50×50 ポイントで、そのコンテンツを提示するために使用されるビットマップのサイズが 100×100 ピクセルである場合。

このプロパティのデフォルト値は、現在のビューを表示するスクリーンに関連付けられたスケール係数です。カスタムビューが、カスタムの drawRect: メソッドを実装していて、ウィンドウに関連付けているか、または、OpenGL ES コンテンツを描画する GLKView クラスを使用する場合、あなたのビューは、スクリーンの最大解像度で描画します。システムビューの場合、このプロパティの値は、高解像度の画面でも 1.0 とすることができます。

一般的に、このプロパティの値を変更する必要はありません。しかし、アプリケーションが、OpenGL ES を使用して描画する場合は、レンダリングのパフォーマンスのため、画質を交換してスケール係数を変更したいかもりれません。あなたの OpenGL ES のレンダリング環境を調整する方法の詳細については、iOS 用の OpenGL ES プログラミング・ガイド の 高解像度ディスプレイのサポート を参照してください。

利用可能

iOS 4.0 以降で利用可能。

- tintColorDidChange

tintColor プロパティが変更した時、システムによって呼び出されます。

宣言

<< SWIFT >>

func tintColorDidChange()

<< OBJECTIVE-C >>
- (void)tintColorDidChange

議論

そのビューの tintColor プロパティの値をあなたのコードが変更する時、ビューでシステムはこのメソッドを呼び出します。また、変更された相互作用の淡い色を継承するサブビューでシステムはこのメソッドを呼び出します。

あなたの実装では、必要に応じて、ビューのレンダリングを更新します。

利用可能

iOS 7.0 以降で利用可能。

以下も見よ

tintColor

ビューコンテンツの印刷書式

- viewPrintFormatter

受信しているビューの印刷書式を返します。

宣言

<< SWIFT >>

func viewPrintFormatter() -> UIViewPrintFormatter

<< OBJECTIVE-C >>
- (UIViewPrintFormatter *)viewPrintFormatter

戻り値

UIViewPrintFormatter オブジェクトか、またはオブジェクトが作成できなかった場合 nil 。それが正常に作成された場合、返されたオブジェクトは、自動的にこのビューに関連付けられます。

議論

印刷ジョブを開始するとき、あなたのビュー用に適切なビュー印刷書式オブジェクトを取得するために、このメソッドを呼び出せます。印刷中に、あなたのビューのページレイアウトオプションを構成するには、書式オブジェクトを使用できます。このメソッドを呼び出すたびに、独自のビューの印刷書式オブジェクトを取得します。

ビューの印刷動作を構成するための、印刷書式を使用する方法の詳細については、iOS 用の描画と印刷ガイド を参照してください。

利用可能

iOS 4.2 以降で利用可能。

以下も見よ

– drawRect:forViewPrintFormatter:

印刷用にビューのコンテンツを描画するため実装されています。

宣言

<< SWIFT >>

         func drawRect(_ rect: CGRect,
forViewPrintFormatter formatter: UIViewPrintFormatter)

<< OBJECTIVE-C >>
- (void)drawRect:(CGRect)area
forViewPrintFormatter:(UIViewPrintFormatter *)formatter

パラメーター

area	印刷可能なコンテンツを描画するための領域を定義する長方形。
formatter	viewPrintFormatter メソッドを呼び出すことによって得られる、UIViewPrintFormatter のインスタンス。

議論

ビューの印刷されたコンテンツが、その表示された内容と異なって表示させたい場合は、このメソッドを実装して下さい。印刷ジョブにビューの印刷書式を追加する時、このメソッドを実装しない場合は、ビューの drawRect: メソッドは、印刷用コンテンツを提供するために呼び出されます。

印刷されたコンテンツ用のカスタム描画ルーチンを実装する方法の詳細については。iOS 用の描画と印刷ガイド を参照してください。

利用可能

iOS 4.2 以降で利用可能。

ジェスチャ認識装置の管理

- addGestureRecognizer:

ビューに、ジェスチャー認識装置を添付します。

宣言

<< SWIFT >>

func addGestureRecognizer(_ gestureRecognizer: UIGestureRecognizer)

<< OBJECTIVE-C >>
- (void)addGestureRecognizer:(UIGestureRecognizer *)gestureRecognizer

パラメーター

gestureRecognizer

UIGestureRecognizer クラスから派生したクラスのオブジェクト。このパラメータは nil であってはなりません。

議論

ビューに、ジェスチャ認識装置を取り付けた場合、ジェスチャーの表現の範囲を定義し、そのビューとそのサブビューのすべてにヒットテストしたタッチを、受信するようにします。ビューは、ジェスチャ認識装置への強い参照を確立します。

利用可能

iOS 3.2 以降で利用可能。

以下も見よ

– removeGestureRecognizer:
gestureRecognizers

- removeGestureRecognizer:

受信しているビューからジェスチャ認識装置を切り離します。

宣言

<< SWIFT >>

func removeGestureRecognizer(_ gestureRecognizer: UIGestureRecognizer)

<< OBJECTIVE-C >>
- (void)removeGestureRecognizer:(UIGestureRecognizer *)gestureRecognizer

パラメーター

gestureRecognizer

UIGestureRecognizer クラスから派生したクラスのオブジェクト。

議論

このメソッドは、ビューからそれを取り外すに加えて、gestureRecognizer を解放します。

利用可能

iOS 3.2 以降で利用可能。

以下も見よ

– addGestureRecognizer:
gestureRecognizers

gestureRecognizers プロパティ

現在のビューに取り付けられている、ジェスチャ認識装置オブジェクト。

宣言

<< SWIFT >>

var gestureRecognizers: [UIGestureRecognizer]?

<< OBJECTIVE-C >>
@property(nonatomic, copy) NSArray <__kindof UIGestureRecognizer *> *gestureRecognizers

議論

これらの各オブジェクトは、抽象基本クラス UIGestureRecognizer のサブクラスのインスタンスです。添付されたジェスチャー認識装置がない場合、このプロパティの値は空の配列です。

利用可能

iOS 3.2 以降で利用可能。

- gestureRecognizerShouldBegin:

ジェスチャー認識装置が、タッチイベントを追跡し続けることが許されるべきであるかビューに尋ねます。

宣言

<< SWIFT >>

func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool

<< OBJECTIVE-C >>
- (BOOL)gestureRecognizerShouldBegin:(UIGestureRecognizer *)gestureRecognizer

パラメーター

gestureRecognizer

UIGestureRecognizerStatePossible な状態から移行しようとしているジェスチャー認識装置。

戻り値

ジェスチャー認識装置が、タッチイベントを追跡し続けるべきで、ジェスチャーをトリガーするためにそれらを使用する時は YES、それが UIGestureRecognizerStateFailed の状態に移行するべきなら NO。

議論

サブクラスは、このメソッドをオーバーライドして、特定のジェスチャーの認識を防止するためにそれを使用できます。例えば、UISlider クラスは、スライダの進行方向と平行にスワイプするのと、親指でそれがスタートするようにするには、このメソッドを使用して下さい。

このメソッドが呼び出された時点で、ジェスチャー認識装置は UIGestureRecognizerStatePossible の状態にあり、それが UIGestureRecognizerStateBegan の状態に移行するために必要なイベントがあると考えています。

このメソッドのデフォルトの実装は、YES を返します。

利用可能

iOS 6.0 以降で利用可能。

ブロックオブジェクトでビューのアニメーション化

+ animateWithDuration:delay:options:animations:completion:

指定された持続時間、遅延、オプション、および完了ハンドラを使用して、1つ以上のビューへの変更をアニメーション化します。

宣言

<< SWIFT >>

class func animateWithDuration(_ duration: NSTimeInterval,
                         delay delay: NSTimeInterval,
                       options options: UIViewAnimationOptions,
                    animations animations: () -> Void,
                    completion completion: ((Bool) -> Void)?)

<< OBJECTIVE-C >>
+ (void)animateWithDuration:(NSTimeInterval)duration
                      delay:(NSTimeInterval)delay
                    options:(UIViewAnimationOptions)options
                 animations:(void (^)(void))animations
                 completion:(void (^)(BOOL finished))completion

パラメーター

duration	秒単位で測定された、アニメーションの総継続時間。負の値または 0 を指定した場合、変更は、それらをアニメーション化することなく行われます。
delay	アニメーションを開始する前に待機すべき時間の量(秒単位で測定される)。すぐにアニメーションを開始するには 0 の値を指定します。
options	アニメーションをどのように実行するかを示すオプションのマスク。有効な定数の一覧については、UIViewAnimationOptions を参照してください。
animations	ビューにコミットする変更を含むブロックオブジェクト。これは、プログラムであなたのビュー階層内のビューのいずれかのアニメーション化可能なプロパティを変更する場所です。このブロックはパラメータを取らず、戻り値はありません。このパラメータは NULL であってはいけません。
completion	アニメーションシーケンスが終了したときに実行されるブロックオブジェクト。このブロックは、戻り値はなく、終了ハンドラが呼び出される前にアニメーションが実際に終了したかどうかを示す単一のブール引数を取ります。アニメーションの継続時間が 0 である場合、このブロックは、次の実行ループサイクルの開始時に行われます。このパラメータは NULL であっても良いです。

議論

このメソッドは、ビュー上で実行するためにアニメーションのセットを開始します。animations パラメータ内のブロックオブジェクトは、1つ以上のビューのプロパティをアニメーション化するためのコードを含んでいます。

ビューがアニメーション化されるために、アニメーションの間、ユーザの相互作用は一時的に無効にされています。(iOS 5 以前では、ユーザの相互作用が。アプリケーション全体で無効になっています) ユーザーがビューと対話できるようにしたい場合は、options パラメータに定数 UIViewAnimationOptionAllowUserInteraction を含ませて下さい。

利用可能

iOS 4.0 以降で利用可能。

+ animateWithDuration:animations:completion:

指定された期間と完了ハンドラを使用して、1つ以上のビューへの変更をアニメーション化します。

宣言

<< SWIFT >>

class func animateWithDuration(_ duration: NSTimeInterval,
                    animations animations: () -> Void,
                    completion completion: ((Bool) -> Void)?)

<< OBJECTIVE-C >>
+ (void)animateWithDuration:(NSTimeInterval)duration
                 animations:(void (^)(void))animations
                 completion:(void (^)(BOOL finished))completion

パラメーター

duration	秒単位で測定した、アニメーションの合計時間。負の値または 0 を指定した場合、変更は、アニメーション化することなく行われます。
animations	ビューにコミットする、変更を含むブロックオブジェクト。これは、プログラムであなたのビュー階層内のビューのいずれかのアニメーション化可能プロパティを変更する場所です。このブロックはパラメータを取らず、戻り値はありません。このパラメータは NULL であってはいけません。
completion	アニメーションシーケンスが終了すした時に、実行されるブロックオブジェクト。このブロックは、戻り値はなく、終了ハンドラが呼び出される前にアニメーションが実際に終了したかどうかを示す単一のブール引数を取ります。アニメーションの継続時間が 0 である場合、このブロックは、次の実行ループサイクルの開始時に行われます。このパラメータに NULL であっても良いです。

議論

このメソッドは、UIViewAnimationOptionCurveEaseInOut と UIViewAnimationOptionTransitionNone のアニメーションオプションを使用して、すぐに指定されたアニメーションを実行します。

例えば、それが完全に透明になるまで、ビューをフェードしたくて、またそれからあなたのビュー階層から削除した場合、次のようなコードを使用できます。

[UIView animateWithDuration:0.2
animations:^{view.alpha = 0.0;}
completion:^(BOOL finished){ [view removeFromSuperview]; }];

アニメーションの間、ビューがアニメーション化されるためにユーザの相互作用が一時的に無効にされます。(iOS 5 以前では、ユーザとの相互作用は、アプリケーション全体で無効になっています。)

利用可能

iOS 4.0 以降で利用可能。

+ animateWithDuration:animations:

指定された期間を使用して 1つ以上のビューへの変更をアニメーション化します。

宣言

<< SWIFT >>

class func animateWithDuration(_ duration: NSTimeInterval,
                    animations animations: () -> Void)

<< OBJECTIVE-C >>
+ (void)animateWithDuration:(NSTimeInterval)duration
                 animations:(void (^)(void))animations

パラメーター

duration	秒単位で測定した、アニメーションの合計時間。負の値または 0 を指定した場合、変更は、それらをアニメーション化することなく行われます。
animations	ビューにコミットする、変更を含むブロックオブジェクト。これは、プログラムであなたのビュー階層内のビューのいずれかのアニメーション化可能プロパティを変更する場所です。このブロックはパラメータを取らず、戻り値はありません。このパラメータは NULL であってはいけません。

議論

このメソッドは、UIViewAnimationOptionCurveEaseInOut と UIViewAnimationOptionTransitionNone アニメーションオプションを使用して、指定されたアニメーションをすぐにアニメーションを実行します。

アニメーションの間、ビューがアニメーション化されるため、ユーザの相互作用は一時的に無効にされます。(iOS 5 以前では、ユーザとの対話は、アプリケーション全体で無効になっています。)

利用可能

iOS 4.0 以降で利用可能。

+ transitionWithView:duration:options:animations:completion:

指定されたコンテナビューの移行アニメーションを作成します。

宣言

<< SWIFT >>

class func transitionWithView(_ view: UIView,
                     duration duration: NSTimeInterval,
                      options options: UIViewAnimationOptions,
                   animations animations: (() -> Void)?,
                   completion completion: ((Bool) -> Void)?)

<< OBJECTIVE-C >>
+ (void)transitionWithView:(UIView *)view
                  duration:(NSTimeInterval)duration
                   options:(UIViewAnimationOptions)options
                animations:(void (^)(void))animations
                completion:(void (^)(BOOL finished))completion

パラメーター

view	移行を実行するコンテナビュー。
duration	秒単位で測定された移行アニメーションの継続時間。負の値または 0 を指定した場合、移行はアニメーションすることなく行われます。
options	どのようにアニメーションを実行するかを示すオプションのマスク。有効な定数の一覧については、UIViewAnimationOptions を参照してください。
animations	指定したビューに行いたい変更を含んでいるブロックオブジェクト。このブロックにはパラメータを取らず、戻り値もありません。このパラメータは NULL であってはいけません。
completion	アニメーションシーケンスが終了した時、実行されるブロックオブジェクト。このブロックは、戻り値はなく、終了ハンドラが呼び出される前にアニメーションが実際に終了したかどうかを示す単一のブール引数を取ります。アニメーションの継続時間が 0 である場合、このブロックは、次の実行ループサイクルの開始時に行われます。このパラメータには NULL を指定できます。

議論

指定したビューの状態への変更を行うことができるように、このメソッドは、それへの移行を適用します。animations パラメータで指定したブロックは、あなたが作りたい変更はどんな状態でも含んでいます。指定したビューのサブビューを追加し、削除し、表示し、または隠すには、このブロックを使用できます。他のアニメーション可能な変更を組み込むしたい場合は、options パラメータに UIViewAnimationOptionAllowAnimatedContent キーを含めなければなりません。

以下のコードは、指定されたコンテナビューの反転移行を作成します。移行中の適切な時点で、あるサブビューは除去され、別のサブビューはコンテナビューに追加されます。これは、新しいビューが新しいサブビューで所定の位置に反転したかのように見えますが、実際にそれが新しい構成で元の位置に戻り、アニメーションされるのとど同じビューです。

[UIView transitionWithView:containerView
duration:0.2
options:UIViewAnimationOptionTransitionFlipFromLeft
animations:^{ [fromView removeFromSuperview]; [containerView addSubview:toView]; }
completion:NULL];

アニメーションの間、ビューがアニメーション化されるために、ユーザの相互作用は一時的に無効にされています。(iOS 5 以前では、ユーザの相互作用が、アプリケーション全体で無効になっています。) ユーザーがビューと相互作用できるようにしたい場合は、options パラメータで定数 UIViewAnimationOptionAllowUserInteraction を含めて下さい。

利用可能

iOS 4.0 以降で利用可能。

+ transitionFromView:toView:duration:options:completion:

与えられたパラメータを使用して、指定されたビュー間の移行アニメーションを作成します。

宣言

<< SWIFT >>

class func transitionFromView(_ fromView: UIView,
                       toView toView: UIView,
                     duration duration: NSTimeInterval,
                      options options: UIViewAnimationOptions,
                   completion completion: ((Bool) -> Void)?)

<< OBJECTIVE-C >>
+ (void)transitionFromView:(UIView *)fromView
                    toView:(UIView *)toView
                  duration:(NSTimeInterval)duration
                   options:(UIViewAnimationOptions)options
                completion:(void (^)(BOOL finished))completion

パラメーター

fromView	移行の開始するビュー。デフォルトでは、このビューは、移行の一環としてそのスーパービューから削除されます。
toView	移行の終了するビュー。デフォルトでは、このビューは、移行の一環として fromView のスーパービューに追加されます。
duration	秒単位で測定された移行アニメーションの継続時間。負の値または 0 を指定した場合、移行はアニメーションすることなく行われます。
options	どのようにアニメーションを実行するかを示すオプションのマスク。有効な定数の一覧については、UIViewAnimationOptions を参照してください。
completion	アニメーションシーケンスが終了した時、実行されるべきブロックオブジェクト。このブロックは、戻り値はなく、終了ハンドラが呼び出される前にアニメーションが実際に終了したかどうかを示す単一のブール引数を取ります。アニメーションの継続時間が 0 である場合、このブロックは、次の実行ループサイクルの開始時に行われます。このパラメータは NULL を指定できます。

議論

このメソッドは、toView パラメータのビューに fromView パラメータのビューから移行する簡単な方法を提供します。デフォルトでは、fromView のビューは toView のビューによってビュー階層内に置き換えられます。両方のビューがすでにあなたのビュー階層の一部である場合は、単に隠したり、表示するための options パラメータに UIViewAnimationOptionShowHideTransitionViews オプションを含めることができます。

このメソッドは、そのビュー階層内のビューのみを変更します。それはいかなる方法でもアプリケーションのビューコントローラーを変更しません。例えば、ビューコントローラによって表示されたルートビューを変更するためこのメソッドを使用した場合、あなたにはその変更を処理するために適切にビューコントローラを更新する責任があります。

別のアニメーションが既に実行中でない限り、それが現在のアニメーションが終了した直後に開始する場合には、ビューの移行はすぐに開始されます。

アニメーションの間、ビューがアニメーション化されるために、ユーザの相互作用は一時的に無効にされています。(iOS 5 以前では、ユーザの相互作用が、アプリケーション全体で無効になっています。) ユーザーがビューと相互作用できるようにしたい場合は、options パラメータに定数 UIViewAnimationOptionAllowUserInteraction を含めて下さい。

利用可能

iOS 4.0 以降で利用可能。

+ animateKeyframesWithDuration:delay:options:animations:completion:

現在のビュー用のキーフレームベースのアニメーションを設定するために使用できるアニメーションブロックオブジェクトを作成します。

宣言

<< SWIFT >>

class func animateKeyframesWithDuration(_ duration: NSTimeInterval,
                                  delay delay: NSTimeInterval,
                                options options: UIViewKeyframeAnimationOptions,
                             animations animations: () -> Void,
                             completion completion: ((Bool) -> Void)?)

<< OBJECTIVE-C >>
+ (void)animateKeyframesWithDuration:(NSTimeInterval)duration
                               delay:(NSTimeInterval)delay
                             options:(UIViewKeyframeAnimationOptions)options
                          animations:(void (^)(void))animations
                          completion:(void (^)(BOOL finished))completion

パラメーター

duration	秒単位で測定された全体のアニメーションの継続時間。負の値または 0 を指定した場合、変更はすぐに、アニメーションなしで行われます。
delay	アニメーションを開始する前に待機する時間を(秒単位で) 指定します。
options	どのようにアニメーションを実行するかを示すオプションのマスク。有効な定数の一覧については、UIViewAnimationOptions を参照してください。
animations	ビューにコミットする変更を含むブロックオブジェクト。一般的に、このブロックの中から addKeyframeWithRelativeStartTime:relativeDuration:animations: メソッドを 1回以上呼び出します。それらの変更を全期間にわたってアニメーション化したい場合は、直接ビューの値を変更することもあります。このブロックはパラメータを取らず、戻り値はありません。このパラメータに nil 値を使用しないでください。
completion	アニメーションシーケンスが終了した時、実行されるべきブロックオブジェクト。このブロックは、戻り値がなく、終了ハンドラが呼び出される前にアニメーションが終了したかどうかを示す単一のブール引数を取ります。アニメーションの継続時間が 0 である場合、このブロックは、次の実行ループサイクルの開始時に行われます。このパラメータには nil 値を使用できます。

議論

このメソッドは、キーフレームベースのアニメーションを設定するために使用できるアニメーションブロックを作成します。キーフレームそれ自身は、このメソッドを使用して作成する最初のアニメーションブロックの一部ではありません。animations ブロック内で、 addKeyframeWithRelativeStartTime:relativeDuration:animations: メソッドを 1回以上呼び出して、キーフレームの時間とアニメーションデータを追加する必要があります。キーフレームを追加すると、アニメーションを現在の値から最初のキーフレームの値に、ビューをアニメーション化し、その後次のキーフレームの値へ、とあなたが指定した回数繰り返します。

animations ブロック内に全くキーフレームを追加しない場合、アニメーションは最初から最後まで進み、標準のアニメーションブロックのように終了します。言い換えれば、システムは指定された duration を超える全ての新しい値に、現在のビューの値からアニメーション化します。

利用可能

iOS 7.0 以降で利用可能。

以下も見よ

+ addKeyframeWithRelativeStartTime:relativeDuration:animations:

キーフレームアニメーションの単一フレームのタイミングとアニメーションの値を指定します。

宣言

<< SWIFT >>

class func addKeyframeWithRelativeStartTime(_ frameStartTime: Double,
                           relativeDuration frameDuration: Double,
                                 animations animations: () -> Void)

<< OBJECTIVE-C >>
+ (void)addKeyframeWithRelativeStartTime:(double)frameStartTime
                        relativeDuration:(double)frameDuration
                              animations:(void (^)(void))animations

パラメーター

frameStartTime	指定されたアニメーションを開始すべき時間。この値は、全体のアニメーションの開始を表す 0、全体的なアニメーションの終了を表す 0 で、0 から 1 の範囲でなければなりません。例えば、2 秒の長さのアニメーションがあった場合、0.5 の開始時刻を指定すると、全体的なアニメーションの開始後 1 秒で実行を開始するアニメーションを生じます。
frameDuration	指定された値にアニメーション化すべき時間の長さ。この値は 0 から 1 の範囲でなければならず、全体のアニメーションの長さに対する相対的な時間の量を示しています。0 の値を指定した場合、animations ブロックで設定した全てのプロパティは、指定された開始時刻に直ちに更新します。ゼロ以外の値を指定した場合、プロパティはその時間をかけてアニメーション化します。例えば、2 秒の長さのアニメーションに 0.5 の継続期間を指定すると、アニメーションの継続時間は 2 秒になります。
animations	実行したいアニメーションを含むブロックオブジェクト。これは、プログラムであなたのビュー階層内のビューのいずれかのアニメーション化可能プロパティを変更する場所です。このブロックはパラメータを取らず、戻り値はありません。このパラメータは nil であってはなりません。

議論

キーフレームアニメーション中にビュープロパティをアニメーション化するには、アニメーションブロック内からこのメソッドを呼び出し、animateKeyframesWithDuration:delay:options:animations:completion: メソッドに渡してください。異なる値の間でアニメーション化するか、またはビュープロパティのアニメーションのタイミングを微調整するには、ブロック内でこのメソッドを複数回呼出せます。

animations ブロックで変更するビュープロパティを使用すると、frameDuration パラメータで指定したタイムスパン上でアニメーション化します。プロパティは、frameStartTime パラメータで指定した時間までアニメーションは開始されません。フレーム開始時間の後、アニメーションはその指定された継続期間にわたって、または別のアニメーションで中断されるまで実行されます。

利用可能

iOS 7.0 以降で利用可能。

以下も見よ

+ animateKeyframesWithDuration:delay :options:animations:completion:

+ performSystemAnimation:onViews:options:animations:completion:

あなたが定義したオプションのパラレルアニメーションに沿って、1つ以上のビューの特定のシステム提供のアニメーションを実行します。

宣言

<< SWIFT >>

class func performSystemAnimation(_ animation: UISystemAnimation,
                          onViews views: [UIView],
                          options options: UIViewAnimationOptions,
                       animations parallelAnimations: (() -> Void)?,
                       completion completion: ((Bool) -> Void)?)

<< OBJECTIVE-C >>
+ (void)performSystemAnimation:(UISystemAnimation)animation
                       onViews:(NSArray<__kindof UIView *> *)views
                       options:(UIViewAnimationOptions)options
                    animations:(void (^)(void))parallelAnimations
                    completion:(void (^)(BOOL finished))completion

パラメーター

animation	実行すべきシステムのアニメーション。 UISystemAnimation 列挙型からの定数。
views	その上でアニメーションが実行すべきビュー。
options	どのようにアニメーションを実行したいかを示すオプションのマスク。有効な定数の一覧については、UIViewAnimationOptions を参照してください。
parallelAnimations	システムのアニメーションが定義または継承する、同じタイミングと継続期間で、システムのアニメーションと一緒に実行するように指定する追加のアニメーション。追加のアニメーションでは、システムのアニメーションが実行されているビューのプロパティを変更しないでください。
completion	アニメーションシーケンスが終了した時、実行されるべきブロックオブジェクト。終了ハンドラが呼び出される前にアニメーションが終了したか否かを示す単一のブール引数。アニメーションの継続時間が 0 である場合、このブロックは、次の実行ループサイクルの開始時に実行されます。このパラメータには nil 値を使用できます。

利用可能

iOS 7.0 以降で利用可能。

+ animateWithDuration:delay:usingSpringWithDamping: initialSpringVelocity:options:animations:completion:

物理的なスプリングの動きに対応するタイミング曲線を使用してビューのアニメーションを実行します。

宣言

<< SWIFT >>

class func animateWithDuration(_ duration: NSTimeInterval,
                         delay delay: NSTimeInterval,
        usingSpringWithDamping dampingRatio: CGFloat,
         initialSpringVelocity velocity: CGFloat,
                       options options: UIViewAnimationOptions,
                    animations animations: () -> Void,
                    completion completion: ((Bool) -> Void)?)

<< OBJECTIVE-C >>
+ (void)animateWithDuration:(NSTimeInterval)duration
                      delay:(NSTimeInterval)delay
     usingSpringWithDamping:(CGFloat)dampingRatio
      initialSpringVelocity:(CGFloat)velocity
                    options:(UIViewAnimationOptions)options
                 animations:(void (^)(void))animations
                 completion:(void (^)(BOOL finished))completion

パラメーター

duration	秒単位で測定した、アニメーションの合計継続期間。負の値または 0 を指定した場合、変更内容は、それらをアニメーション化することなく行われます。
delay	(秒単位で測定した) アニメーションの開始前に待機する時間の量。直ちにアニメーションを開始するには 0 の値を指定して下さい。
dampingRatio	その静止状態に近づくにつれて減る、スプリングのアニメーションの減衰比。振動することなく、アニメーションをスムーズに減速するためには、1 の値を使用して下さい。振動を増加させるためには、ゼロに近い減衰比を使用して下さい。
velocity	スプリングの最初の速度。アニメーションへのスムーズなスタートのために、添付される前からあったようにビューの速度にこの値を一致させます。 1 の値は1秒で全部のアニメーション距離を横断するのに相当します。例えば、もし全部のアニメーション距離が 200 ポイントで、アニメーションの開始を、1秒あたり 100 ポイントのビュー速度と一致させるには、0.5 の値を使用して下さい。
options	どのようにアニメーションを実行したいかを示すオプションのマスク。有効な定数の一覧については、UIViewAnimationOptions を参照してください。
animations	ビューにコミットする変更を含むブロックオブジェクト。これはプログラムであなたのビュー階層内のビューのいずれかのアニメーション化可能プロパティを変更する場所です。このブロックはパラメータを取らず、戻り値はありません。このパラメータは NULL であってはいけません。
completion	アニメーションシーケンスが終了した時、実行されるべきブロックオブジェクト。このブロックは、戻り値はなく、終了ハンドラが呼び出される前にアニメーションが実際に終了したかどうかを示す単一のブール引数を取ります。アニメーションの継続時間が 0 である場合、このブロックは、次の実行ループサイクルの開始時に行われます。このパラメータは NULL を指定できます。

議論

利用可能

iOS 7.0 以降で利用可能。

+ performWithoutAnimation:

ビュー移行アニメーションを無効にします。

宣言

<< SWIFT >>

class func performWithoutAnimation(_ actionsWithoutAnimation: () -> Void)

<< OBJECTIVE-C >>
+ (void)performWithoutAnimation:(void (^)(void))actionsWithoutAnimation

パラメーター

actionsWithoutAnimation

アニメーションなしで実行したいビュー移行コード。

利用可能

iOS 7.0 以降で利用可能。

以下も見よ

+ setAnimationsEnabled:
+ areAnimationsEnabled

ビューのアニメーション化

このセクションのメソッドの使用は、iOS 4 以降では推奨されません。代わりに、ブロックベースのアニメーション・メソッドを使用して下さい。

+ beginAnimations:context:

アニメーションブロックの開始/コミットの開始をマーク。

宣言

<< SWIFT >>

class func beginAnimations(_ animationID: String?,
                   context context: UnsafeMutablePointer<Void>)

<< OBJECTIVE-C >>
+ (void)beginAnimations:(NSString *)animationID
                context:(void *)context

パラメーター

animationID	アニメーション用の、アプリケーションが提供する識別子。
context	アニメーションのこのセットに関連付けたいカスタムデータであり、アニメーションデリゲートメッセージに渡される情報で、setAnimationWillStartSelector: 及び setAnimationDidStopSelector: メソッドを使用したセレクタのセット。

議論

このメソッドは、実行するために、1つ以上のアニメーションを指定したいシステムに通知します。このメソッドを呼び出した後、アニメーションオプション(setAnimation... クラスメソッドを使用して) を構成してから、ビューの望みのアニメーション化可能なプロパティを変更します。あなたのビュープロパティを変更し終えたら、セットを閉じてアニメーションをスケジュール化するために commitAnimations メソッドを呼び出して下さい。

必要に応じて(アニメーションの以前のセットをコミットする前に、このメソッドを再度呼び出して) アニメーションのセットを入れ子にできます。入れ子にするアニメーションは、それらを一緒にグループにし、入れ子にされたグループごとに異なるアニメーションオプションを設定できます。

setAnimationWillStartSelector: あるいは setAnimationDidStopSelector: メソッドを使用して開始・中止セレクタをインストールする場合、あなたが animationID と context パラメータで指定した値は、実行時に、あなたのセレクタに渡されます。これらのセレクタに追加情報を渡すために、これらのパラメータを使用できます。

このメソッドの使用は、iOS 4.0 以降では推奨されません。代わりに、アニメーションを指定するには、ブロックベースのアニメーション・メソッドを使用する必要があります。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

+ commitAnimations
+ setAnimationWillStartSelector:
+ setAnimationDidStopSelector:
+ setAnimationDelegate:

+ commitAnimations

アニメーションブロックの開始/コミットの終了をマークし、アニメーションの実行をスケジュールします。

宣言

<< SWIFT >>

class func commitAnimations()

<< OBJECTIVE-C >>
+ (void)commitAnimations

議論

現在のアニメーションセットが最も外側のセットである場合、アプリケーションが実行ループに戻ったとき、このメソッドはアニメーションを開始します。現在のアニメーションセットが別のセット内に入れ子にされている場合、アニメーションの最も外側のセットがコミットされるまでこのメソッドは待ち、それが一緒にアニメーションのすべてをコミットするまで待機します。

アニメーションは、アプリケーションをブロックするのを回避するために、別のスレッドで実行します。このように、複数のアニメーションは、互いの上に重ね合わせることができます。他のものが進行中にどのようにアニメーションを開始するか、 setAnimationBeginsFromCurrentState: を参照してください。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

+ beginAnimations:context:

+ setAnimationStartDate:

現在のアニメーションブロックの開始時間を設定します。

宣言

<< SWIFT >>

class func setAnimationStartDate(_ startDate: NSDate)

<< OBJECTIVE-C >>
+ (void)setAnimationStartDate:(NSDate *)startTime

パラメーター

startTime

アニメーションを開始すべき時間。

議論

beginAnimations:context: と commitAnimations メソッドの間でこのメソッドを呼び出し、アニメーションのそのセットの開始時間を指定します。また、あなたのビューのアニメーション化可能なプロパティを変更する前に、このメソッドを呼び出して下さい。(ブロックベースのアニメーションと併せて、このメソッドを呼びださないでください。) このメソッドを呼び出さない場合は、開始時間は、できるだけ早くアニメーションを開始する CFAbsoluteTimeGetCurrent 関数によって返された値に設定されています。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

+ beginAnimations:context:
+ commitAnimations
+ setAnimationDuration:
+ setAnimationDelay:
+ setAnimationCurve:
+ setAnimationRepeatCount:
+ setAnimationRepeatAutoreverses:
+ setAnimationBeginsFromCurrentState:

+ setAnimationsEnabled:

アニメーションが有効になっているかどうかを設定します。

宣言

<< SWIFT >>

class func setAnimationsEnabled(_ enabled: Bool)

<< OBJECTIVE-C >>
+ (void)setAnimationsEnabled:(BOOL)enabled

パラメーター

enabled

アニメーションを有効にするには YES を指定し、無効にするには NO を指定します。

議論

アニメーションはデフォルトで有効です。アニメーションを無効にした場合、その後のアニメーションブロック内のコードはまだ実行されているにもかかわらず、アニメーションは実際には発生しません。したがって、アニメーションブロック内で行った全ての変更は、アニメーション化される代わりに即座に反映されます。ブロックベースのアニメーション・メソッドを使用するか、アニメーションの開始/コミット・メソッドを使用するかどうかに関わらず、これは本当です。

このメソッドは、それが呼び出された後に提出されたアニメーションにだけ影響します。既存のアニメーションが実行されている間にこのメソッドを呼び出すと、それらの自然な終着点に到達するまで、それらのアニメーションは実行を継続します。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

+ areAnimationsEnabled
+ performWithoutAnimation:

+ setAnimationDelegate:

任意のアニメーションメッセージのデリゲートを設定します。

宣言

<< SWIFT >>

class func setAnimationDelegate(_ delegate: AnyObject?)

<< OBJECTIVE-C >>
+ (void)setAnimationDelegate:(id)delegate

パラメーター

delegate

setAnimationWillStartSelector: と setAnimationDidStopSelector: メソッドを使用して登録したメソッドを定義するオブジェクト。ビューは、アニメーションの継続時間の間、オブジェクトへの強い参照を保持します。

議論

アニメーションが開始または停止したとき、メッセージを受信したい場合、アニメーションデリゲートを指定できます。このメソッドを呼び出した後、必要に応じて適切なセレクタを登録するために setAnimationWillStartSelector: と setAnimationDidStopSelector: メソッドを呼び出す必要があります。デフォルトでは、アニメーションデリゲートは nil に設定されています。

主にアニメーションの開始/コミットメソッドを使用して作成したアニメーションブロックのデリゲートを設定するために、このメソッドを使用して下さい。アニメーションブロックが何もしないでいる外からこのメソッドを呼び出します。

このメソッドの使用は、iOS 4.0 以降では推奨されません。ブロックベースのアニメーション・メソッドを使用している場合、ブロック内で直接あなたのデリゲートの開始と終了コードを含めることができます。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

+ beginAnimations:context:
+ commitAnimations
+ setAnimationWillStartSelector:
+ setAnimationDidStopSelector:

+ setAnimationWillStartSelector:

アニメーションの開始時にアニメーションデリゲートに送信するメッセージを設定します。

宣言

<< SWIFT >>

class func setAnimationWillStartSelector(_ selector: Selector)

<< OBJECTIVE-C >>
+ (void)setAnimationWillStartSelector:(SEL)selector

パラメーター

selector

アニメーションが開始する前に、アニメーションデリゲートに送信すべきメッセージ。デフォルト値は NULL です。このセレクタは、次の形式にします: - (void)animationDidStart:(NSString *)animationID context(void *)context。あなたのメソッドは、以下の引数を取りらなければなりません。

animationID

NSString

nil

context

nil

議論

アニメーションの開始/コミットセットのアニメーションデリゲートを指定した場合は、アニメーションを開始する前に呼び出すセレクタを指定するには、このメソッドを使用します。アニメーションブロックの外から呼び出された場合、このメソッドは何もしません。beginAnimations:context: と + commitAnimations メソッドへの呼び出しの間に呼び出さなければなりません。このセレクタは、デフォルトで NULL に設定されています。

注意： アニメーションが無効になっている場合は、開始セレクタは呼び出されません。

このメソッドの使用は、iOS 4.0 以降では推奨されません。ブロックベースのアニメーション・メソッドを使用している場合、ブロック内で直接あなたのデリゲートの開始コードを含めることができます。

利用可能

iOS 2.0 以降で利用可能。

以下も見よ

+ beginAnimations:context:
+ commitAnimations
+ setAnimationDelegate:
+ setAnimationDidStopSelector:

+ setAnimationDidStopSelector:

アニメーションが停止したときにアニメーションデリゲートに送信するべきメッセージを設定します。

宣言

<< SWIFT >>

class func setAnimationDidStopSelector(_ selector: Selector)

<< OBJECTIVE-C >>
+ (void)setAnimationDidStopSelector:(SEL)selector

パラメーター

selector

アニメーションが終了した後に、アニメーションデリゲートに送信されるメッセージ。デフォルト値は NULL です。このセレクタは、次の形式にします: - (void)animationDidStop:(NSString *)animationID finished(NSNumber *)finished context:(void *)context。あなたのメソッドは、以下の引数を取りらなければなりません。

animationID

NSString

nil

finished

NSNumber

YES

context