UINavigationItem

---

内容の保証はできませんよ。

---

/System/Library/frameWorks/UIKit.framework

クラス UINavigationItem †

NSObject
　　|
　　+--UINavigationItem

概要 †

UINavigationItemクラスは、ナビゲーションバーオブジェクトのスタックにプッシュされたのアイテムの情報をカスタム化しています。ナビゲーションバーはコンテンツを階層的に管理しています。UINavigationItemは、ナビゲーションバーのトップまたはその背後に何を表示してどのように表現するかを指定します。

initWithTitle:メソッドを使用することで、タイトルを指定してアイテムを作成できます。ナビゲーションバーのアイテムはタイトルなしで表示することはできません。現在のアイテムとは異なる背後のアイテムを使用したい場合には、backBarButtonItemプロパティを使用します。このプロパティでは、バーの左側に『戻る』ボタンを表示するかどうかを指定できます。

ナビゲーションバーはデフォルトでは左側に『戻る』ボタン、中央にタイトルを表示しています。左、中央、右に表示されるビューをカスタマイズすることが可能です。– setLeftBarButtonItem:animated:メソッドまたは– setRightBarButtonItem:animated:メソッドをしようして左または右に表示されるビューを指定できます。オプションでアニメーションの有無も指定可能です。titleViewメソッドを使用することで、中央のビューを指定することができます。

カスタムビューにシステムボタンを使用することも可能です。この場合、ナビゲーションアイテムに使用するカスタムビューをUIBarButtonItemクラスを使用して作成して追加することになります。

インデックス †

インスタンスの作成 †

– initWithTitle:

プロパティの設定 †

title property
prompt property
backBarButtonItem property
hidesBackButton property
– setHidesBackButton:animated:

ビューのカスタマイズ †

titleView property
leftBarButtonItem property
rightBarButtonItem property
– setLeftBarButtonItem:animated:
– setRightBarButtonItem:animated:

プロパティ †

backBarButtonItem †

ナビゲーションバー上の『戻る』ボタンで表示されるアイテムを指定する。

@property(nonatomic, retain) UIBarButtonItem *backBarButtonItem

hidesBackButton †

バックボタンを非表示にするかどうかを決定する。

@property(nonatomic, assign) BOOL hidesBackButton

leftBarButtonItem †

ナビゲーションバーの左側に表示されるアイテムを指定する。

@property(nonatomic, retain) UIBarButtonItem *leftBarButtonItem

prompt †

ナビゲーションバーの上部に表示されるテキストを指定する。

@property(nonatomic, copy) NSString *prompt

rightBarButtonItem †

ナビゲーションバーの右側に表示されるアイテムを指定する。

@property(nonatomic, retain) UIBarButtonItem *rightBarButtonItem

title †

ナビゲーションバーの中央に表示されるアイテムのタイトルを指定する。

@property(nonatomic, copy) NSString *title

titleView †

ナビゲーションバーの中央に表示するビューを指定する。

@property(nonatomic, retain) UIView *titleView

インスタンスメソッド †

initWithTitle: †

指定したタイトルでナビゲーションバーアイテムのインスタンスを作成する。

- (id)initWithTitle:(NSString *)title

setHidesBackButton:animated: †

バックボタンを非表示にする。オプションでアニメーションの有無を指定できる。

- (void)setHidesBackButton:(BOOL)hidesBackButton animated:(BOOL)animated

setLeftBarButtonItem:animated: †

ナビゲーションバーの左側に表示されるアイテムを指定する。オプションでアニメーションの有無を指定できる。

- (void)setLeftBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated

setRightBarButtonItem:animated: †

ナビゲーションバーの右側に表示されるアイテムを指定する。オプションでアニメーションの有無を指定できる。

- (void)setRightBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated