はじめに

AppleのSwiftアプリ開発チュートリアルを進めていて出てきた関数やクラスなどについて、調べたことを残していきます。
チュートリアルを進めながら、ざっくりとどういうものかを把握するためのお供になればと思います。

初学者のため、間違い等あればご指摘ください。

第１回：Swiftアプリ開発チュートリアル -Food Tracker- のお供に（Build a Basic UI 編）
第２回：Swiftアプリ開発チュートリアル -Food Tracker- のお供に（Connect the UI to Code 編）
第３回：Swiftアプリ開発チュートリアル -Food Tracker- のお供に（Work with View Controllers 編）
第４回：Swiftアプリ開発チュートリアル -Food Tracker- のお供に（Implement a Custom Control 編）←今回はここ
第５回：Swiftアプリ開発チュートリアル -Food Tracker- のお供に（Define Your Data Model 編）

チュートリアルページ

以下のような構成でレッスンが進んでいくので、それに沿って進めていきます。

Building the UI
Build a Basic UI
Connect the UI to Code
Work with View Controllers
Implement a Custom Control（今回はここ）
Define Your Data Model
Working with Table Views
Create a Table View
Implement Navigation
Implement Edit and Delete Behavior
Persist Data

Implement a Custom Control

今回は以下のレッスンで出てきたものについて見ていきます。

■ UIView

画面表示とその領域内のコンテンツを管理するクラス。
チュートリアルでは、rating部分をカスタムビューとして切り分ける際に使用している。

チュートリアルでの使用例

RatingControl.swift

import UIKit
 
class RatingControl: UIView {
    
}

ドキュメント

公式
UIView Class Reference

■ init?(coder aDecoder: NSCoder)

UIViewのサブクラスでオーバーライドする必要があるinitializer。
Interface Builderからそのビューを呼び出す場合に使用する。
Interface Builderでビューを構築しない場合はinitializerとしてinit(frame frame: CGRect)をオーバーライドする。

チュートリアルでの使用例

RatingControl.swift

required init?(coder aDecoder: NSCoder) {
    super.init(coder: aDecoder)
}

ドキュメント

公式
init(coder:) - NSCoding Protocol Reference

■ intrinsicContentSize

ビューのサイズを指定して返し、それをレイアウトシステムに伝える役割を果たすメソッド。

チュートリアルでの使用例

RatingControl.swift

override func intrinsicContentSize() -> CGSize {
    return CGSize(width: 240, height: 44)
}

ドキュメント

公式
intrinsicContentSize() - UIView Class Reference

■ addTarget

UIControlクラスにて定義されているメソッド。
特定のイベントが起こった時に指定したターゲットに対して、指定したアクションを起こすことができる。

チュートリアルでは、ボタンがタップ（TouchDown）された時、自身（self）の ratingButtonTappedを起動している。

チュートリアルでの使用例

RatingControl.swift

button.addTarget(self, action: "ratingButtonTapped:", forControlEvents: .TouchDown)

ドキュメント

公式
addTarget(_:action:forControlEvents:) - UIControl Class Reference

■ layoutSubviews()

UIViewクラスのメソッド。
この中にサブビューのレイアウト処理を書くことでviewの状態に合わせて必要な時にレイアウト処理が行われる。

チュートリアルでの使用例

RatingControl.swift

override func layoutSubviews() {
    var buttonFrame = CGRect(x: 0, y: 0, width: 44, height: 44)
    
    // Offset each button's origin by the length of the button plus spacing.
    for (index, button) in ratingButtons.enumerate() {
        buttonFrame.origin.x = CGFloat(index * (44 + 5))
        button.frame = buttonFrame
    }
}

ドキュメント

■ enumerate()

Swiftの標準関数。
配列からそれぞれのインデックスと値を持つタプルをkタプルを返す。

チュートリアルでの使用例

RatingControl.swift

for (index, button) in ratingButtons.enumerate() {
    buttonFrame.origin.x = CGFloat(index * (44 + 5))
    button.frame = buttonFrame
}

ドキュメント

公式
The Swift Programming Language (Swift 2.1): Collection Types
http://swift-studying.com/blog/swift/?p=142

■ setImage(_:forState:)

UIButtonクラスのメソッド。
ボタンの見た目として独自に用意した画像を使用することができる。
forStateでボタンがどういう状態の時の画像かが設定できるため、
ボタンの状態によって画像を変更することが可能。

状態を表すUIControlStateはこちら。

チュートリアルでの使用例

RatingControl.swift

button.setImage(emptyStarImage, forState: .Normal)
button.setImage(filledStarImage, forState: .Selected)
button.setImage(filledStarImage, forState: [.Highlighted, .Selected])

ドキュメント

公式
setImage(_:forState:) - UIButton Class Reference

■ adjustsImageWhenHighlighted

UIButtonクラスのプロパティ。
ボタン画像がHighlightedの状態になった時に画像を変更するかどうかの真偽値。

チュートリアルでの使用例

RatingControl.swift

button.adjustsImageWhenHighlighted = false

ドキュメント

公式
adjustsImageWhenHighlighted - UIButton Class Reference

■ indexOf

配列や辞書の中の値を渡すことでその値のインデックスを返す。

チュートリアルでの使用例

RatingControl.swift

rating = ratingButtons.indexOf(button)! + 1

タップされたボタンのインデックス+1をratingの値にしている。

ドキュメント

公式
indexOf(_: Self.Generator.Element) -> Self.Index? - CollectionType Protocol Reference

■ didSet

プロパティ監視。
プロパティに設定することでプロパティの値が変わった後に起こる処理を書くことができる。

同様にプロパティの値が変わる前に起こる処理を書く場合はwillSetを使う。

チュートリアルでの使用例

RatingControl.swift

var rating = 0 {
didSet {
    setNeedsLayout()
}
}

ドキュメント

公式
The Swift Programming Language (Swift 2.1): Declarations

■ setNeedsLayout()

layoutSubviews()を呼び出し、レイアウトを更新する。

チュートリアルでの使用例

RatingControl.swift

var rating = 0 {
    didSet {
        setNeedsLayout()
    }
}

ドキュメント

公式
setNeedsLayout() - UIView Class Reference

参考サイト

次回レッスン

第５回：Swiftアプリ開発チュートリアル -Food Tracker- のお供に（Define Your Data Model 編）