UIAlertView - iPhoneアプリ開発用メモ @ wiki

UIAlertViewはアラートを表示させる時に使用します。
アラートはユーザに注意を促したり、処理の結果を通知したりしたい時に使用します。

UIWebViewの基本

// 生成例 UIAlertView *alert = [[UIAlertView alloc] init]; // 生成と同時に各種設定も完了させる例 UIAlertView *alert = [[UIAlertView alloc] initWithTitle: @"タイトル"                                                               message: @"メッセージ"                                                                delegate:nil                                                   cancelButtonTitle:nil                                                    otherButtonTitles: @"OK" , nil];

主要なプロパティ

delegate

レシーバのデリゲートを指定する。
※アラート内のボタンを押下したときになにかの処理を行いたい場合、デリゲートを設定すること

// デリゲートを設定
例）alert.delegate = self;

cancelButtonIndex

キャンセルボタンの位置を指定する

// 1つめのボタンをキャンセルボタンに設定する
例）alert.cancelButtonIndex = 0;

numberOfButtons

アラートビュー内のボタン数を取得する（読み取りのみ）

// アラートビュー内のボタン数を取得
例）int count = alert.numberOfButtons;

firstOtherButtonIndex

アラートビュー内のOtheButtonの位置を取得する（読み取りのみ）

// OtherButtonの位置を取得
例）int no = alert.firstOtherButtonIndex;
※キャンセルボタンが存在していると値は「1」、無いと値は「0」となる。

title

アラートビュー内のタイトルを設定する
　// タイトルの設定

例）alert.title = @"たいとる";

message

アラートビュー内のメッセージを設定する
　// メッセージの設定

例）alert.message = @"めっせーじです";

visible

アラートビューが表示されているかどうか判定

// アラートビューが表示されているかを確認
例）BOOL showAlert = alert.visible;

alertViewStyle

アラートビューのスタイルを指定する。スタイルにより様々なテキストフィールドが追加される（iOS5以上）

スタイル
UIAlertViewStyleDefault	基本（通常のアラートビュー）
UIAlertViewStyleLoginAndPasswordInput	ログイン、パスワード入力用のテキストフィールドが表示される
UIAlertViewStylePlainTextInput	アラートビューにテキストフィールドが表示される
UIAlertViewStyleSecureTextInput	テキストフィールド内に入力した値が隠れる（パスワード入力時と同様）

主要なインスタンスメソッド

initWithTitle:message:delegate:cancelButtonTitle:otherButtonTitles:
- (id)initWithTitle:(NSString *)title message:(NSString *)message delegate:(id)delegate cancelButtonTitle:(NSString *)cancelButtonTitle otherButtonTitles:(NSString *)...

アラートビューのインスタンスを生成する。
その際、「タイトル」「メッセージ」「delegate」「キャンセルボタン用タイトル」「その他ボタン用タイトル」の設定も行える

例）alert = [[UIAlertView alloc] initWithTitle:@"警告"
　　　　　　　　　　　　　　　 　　　　　　message:@"よろしいですか？"
　　　　　　　　　　　　　　　　　 　　　　delegate:self
　　　　　　　　　　　　　　 　cancelButtonTitle:@"OK"
　　　　　　　　　　　　　 　　otherButtonTitles:nil

addButtonWithTitle:
- (NSInteger)addButtonWithTitle:(NSString *)title

指定したタイトルのボタンを追加する

例）[alert addButtonWithTitle:@"たいとる"];

buttonTitleAtIndex:
- (NSString *)buttonTitleAtIndex:(NSInteger)buttonIndex

指定したインデックスのタイトルを返す

例）NSString *title = [alert buttonTitleAtIndex:0];

dismissWithClickedButtonIndex:animated:
- (void)dismissWithClickedButtonIndex:(NSInteger)buttonIndex animated:(BOOL)animated

指定したインデックスのボタンを消去する。オプションでアニメーションの有無も指定できる

例）[alert dismissWithClickedButtonIndex:0 animated:YES];

show
- (void)show

アラートビューを表示する

例）[alert show];

textFieldAtIndex:
- (UITextField *)textFieldAtIndex:(NSInteger)textFieldIndex

指定したインデックスのテキストフィールドのテキストを返す

例）NSString *title = [alert textFieldAtIndex:0];