下からせり上がってくる非モーダルなカスタムダイアログを作る

2010年7月22日木曜日 | Published in | 0 コメント

このエントリーをはてなブックマークに追加

カスタムダイアログ


ユーザに操作指示を尋ねるために標準では UIActionSheetが用意されている。

UIActionSheetはモーダルなので、非モーダルにする場合は通常ツールバーを使う。

下は Pastebotの例。



ツールバーはボタンを赤くするにはカスタムな UIButton を貼り付ける必要があるようだ。

Pastebotの場合、さらにその上にメッセージを表示している。

今回はこれを実現する仕組みを作ってみた。


仕組み

UILabel と UIButton が乗った UIView を1枚用意して、アニメーションを使って下からせり上がるように表示する。


実装


まずダイアログを管理する CustomDialogViewController を用意する。
#import "CustomDialogViewDelegate.h"

@interface CustomDialogViewController : UIViewController {

 NSString* labelText_;
 NSString* buttonTitle_;
 id  delegate_;
 
 UILabel* label_;
 UIButton* button_;
}

@property (nonatomic, copy) NSString* labelText;
@property (nonatomic, copy) NSString* buttonTitle;
@property (nonatomic, assign) id  delegate;

@property (nonatomic, retain) IBOutlet UILabel* label;
@property (nonatomic, retain) IBOutlet UIButton* button;

-(IBAction)touchedButton:(id)sender;

@end

ユーザインターフェイスは Interface Builder で作る。こんな感じ

コントローラを初期化するときにこの Nibを読み込む。
- (id)init {
    if (self = [super initWithNibName:NSStringFromClass([self class])
          bundle:nil]) {
    }
    return self;
}

ラベルとボタンはインスタンス化のタイミングが表示される時になる。この為、表示する文字列は別途プロパティを用意し、先にここへいれておくようにする。インスタンス化された後(viewDidLoadのタイミング)に設定する。
- (void)viewDidLoad {
    [super viewDidLoad];
 
 [self.button setTitle:self.buttonTitle
     forState:UIControlStateNormal];
 self.label.text = self.labelText;
}

ダイアログのボタンが押された時にはデリゲート先にメッセージを送る。その為にプロトコルを定義しておく。
@protocol CustomDialogViewDelegate 

-(void)touchedButton:(id)sender;

@end


次にこのダイアログの表示制御を行うために UIViewController にカテゴリでメソッドを追加する。
@interface UIViewController (CustomDialog)

- (void)presentDialogViewController:(UIViewController*)controller animated:(BOOL)animated;
- (void)dismissDialogViewController:(UIViewController*)controller animated:(BOOL)animated;

@end

上記は UIViewController 標準の presentModalViewController:animated:, dismissModalViewControllerAnimated: をまねた。標準と異なり、閉じるときにも UIViewController を必要とするのは、カテゴリではインスタンス変数を持てない為、状態管理ができないから。状態管理をやる場合はカテゴリではなくサブクラスにするといい。今回はお手軽に機能追加できるようにカテゴリの方法を採用した。

実装はこう。UIViewのアニメーション関連のメソッドを使っている。Blockが使えるのは非常に便利。
#pragma mark -
#pragma mark Manage dialog
- (BOOL)isExistSubView:(UIView*)view
{
 BOOL is_exist = NO;
 for (UIView* subview in self.view.subviews) {
  if (view == subview) {
   is_exist = YES;
   break;
  }
 }
 return is_exist;
}

- (void)presentDialogViewController:(UIViewController*)controller animated:(BOOL)animated
{
 CGRect frame1 = self.view.frame;
 CGRect frame2 = controller.view.frame;
 
 // (1) init position
 frame2.origin.y = frame1.size.height;
 controller.view.frame = frame2;

 if ([self isExistSubView:controller.view]) {
  [self.view bringSubviewToFront:controller.view];
 } else {
  [self.view addSubview:controller.view];
 }

 // (2) animate
 frame2.origin.y = frame1.size.height - frame2.size.height;
 if (animated) {
  [UIView animateWithDuration:0.5
   animations:^{controller.view.frame = frame2;}];
 } else {
  controller.view.frame = frame2;
 }
 
}

- (void)dismissDialogViewController:(UIViewController*)controller animated:(BOOL)animated
{
 if (![self isExistSubView:controller.view]) {
  return;
  // do nothing
 }
 
 CGRect frame1 = self.view.frame;
 CGRect frame2 = controller.view.frame;
 
 // (1) animate
 frame2.origin.y = frame1.size.height;
 if (animated) {
  [UIView animateWithDuration:0.5
   animations:^{controller.view.frame = frame2;}
   completion:^(BOOL finished){[controller.view removeFromSuperview];}
   ];
 } else {
  [controller.view removeFromSuperview];
 }
}

@end


最後にこれを使うクライアントコード。まず初期化。
- (void)viewDidLoad {
    [super viewDidLoad];
 
 CustomDialogViewController* controller =
  [[CustomDialogViewController alloc] init];
 
 controller.delegate = self;
 controller.buttonTitle = @"close dilaog";
 controller.labelText = @"Custom Dialog Opened!";
 
 self.dialogViewController = controller;
 
 [controller release];
}

次にダイアログの開閉。
- (IBAction)openDialog:(id)sender
{
 
 if (opened) {
  [self dismissDialogViewController:self.dialogViewController
         animated:YES];
 } else {
  [self presentDialogViewController:self.dialogViewController
         animated:YES];
 }
 opened = !opened;
}

ダイアログボタンが押された時のアラート表示。
-(void)touchedButton:(id)sender
{
 UIAlertView* alert = [[[UIAlertView alloc] initWithTitle:@"Message"
              message:@"Touched dialog button"
             delegate:nil
  cancelButtonTitle:nil
  otherButtonTitles:@"OK", nil] autorelease];
 [alert show];
}





実行結果


さて実行してみよう。初期状態。

ボタンを押すと下からダイアログがせり上がってくる。

ダイアログのボタンを押すと -[CustomDialogDelegate touchedButton:] が呼ばれ、アラートが表示される。

もう一度ボタンを押すとこんどはアニメーションしながらダイアログが下へ消える。

ソースコード


DialogSample at 2010-07-23 from xcatsan's iOS-Sample-Code - GitHub

UISearchDisplayController と NSFetchedResultContoller を組み合わせる (3) 考察

2010年7月21日水曜日 | Published in | 0 コメント

このエントリーをはてなブックマークに追加

UISearchDisplayController と NSFetchedResultContoller を使う場合のメモなど。


状態


UISearchDisplayController を使った場合の状態イメージはこう。

表示用のビューは UITableView と UISearchResultsTableView の2つが、状態によって切り替わるようにできている。

通常は1つの UITableViewController に対して、これら2つのビューを結びつける(DataSource/Delegate)ことになる。
この為、Data Source / Delegate のメソッド内では必要に応じて、どちらのビューを扱っているのかを判断する。
[例]
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
 if (tableView == self.searchDisplayController.searchResultsTableView)
 {
        return [self.filteredListContent count];
    }
 else
 {
        return [self.listContent count];
    }
}

またモデルである NSFetchedResultsController を1つだけ用意して両方の状態で利用する場合は、検索時には条件の設定を、検索後には条件クリア(全件)を行う必要がある。

[例]
#pragma mark -
#pragma mark UISearchDisplayController Delegate
- (void)filterContentForSearchText:(NSString*)searchText scope:(NSString*)scope
{
    NSString *query = self.searchDisplayController.searchBar.text;
    if (query && query.length) {
        NSPredicate *predicate =
           [NSPredicate predicateWithFormat:@"Title contains[cd] %@", query];
        [self.fetchedResultsController.fetchRequest setPredicate:predicate];
    }
 
 [self reloadFetchedResultsController];
}
- (BOOL)searchDisplayController:(UISearchDisplayController *)controller
 shouldReloadTableForSearchString:(NSString *)searchString
{
    [self filterContentForSearchText:searchString scope:
     [[self.searchDisplayController.searchBar scopeButtonTitles]
         objectAtIndex:[self.searchDisplayController.searchBar
            selectedScopeButtonIndex]]];
 
    return YES;
}

#pragma mark -
#pragma mark UISearchBar Delegate
- (void)searchBarCancelButtonClicked:(UISearchBar *)searchBar
{
 [self.fetchedResultsController.fetchRequest setPredicate:nil];
 [self reloadFetchedResultsController];
}


なお iPhone付属の iPod では、検索時には別途 UITableView が用意される性質を利用して、検索結果の表示をカスタマイズしている。iPhodの場合、アーティストやアルバムでグルーピングし、Section毎に結果を表示している。


参考情報

Cocoaの日々: UISearchDisplayController 調査
Cocoaの日々: UISearchDisplayController と NSFetchedResultContoller を組み合わせる
Cocoaの日々: UISearchDisplayController と NSFetchedResultContoller を組み合わせる (2) バグ修正

UISearchDisplayController と NSFetchedResultContoller を組み合わせる (2) バグ修正

2010年7月20日火曜日 | Published in | 0 コメント

このエントリーをはてなブックマークに追加

[前回] Cocoaの日々: UISearchDisplayController と NSFetchedResultContoller を組み合わせる

前回のコードに問題があることがわかった。

バグ


画面からはみ出る程度に件数を増やすと次のケースでクラッシュすることがわかった。

(1) 初期表示


(2) 検索実行


(3) キャンセルで元の一覧戻り、下へスクロール

⇒ クラッシュ


原因


検索時の NSFetchedResultController が、検索後に元の画面へ戻った時に使用されていた。どういうことかというと、元々10件のデータがあったにもかかわらず、検索で絞り込まれて1件となった後、元の画面に戻ってもその1件のままとなっていた。その状態で下へスクロールして見えていなかったデータを表示しようとした時に -tableView:cellForRowAtIndexPath: が呼び出され、そこで NSFetchedResultController に存在しない Indexを指定してエラーとなっていた(例:結果が1件にもかかわらずスクロールによって現れた 10件目のデータへアクセスしようとしていた)。

元の画面に戻った時に NSFetchedResultController の検索条件を元に(全件)戻し、フェッチをやり直す必要がある。


修正


検索完了時に NSFetchedResultController の検索条件を元に戻し、再フェッチする。UISearchBarの「キャンセル」ボタンが押された時を検索完了とすると UISearchBarDelegate のメソッドにこれらの処理を記述できる。
- (void)searchBarCancelButtonClicked:(UISearchBar *)searchBar
{
 [self.fetchedResultsController.fetchRequest setPredicate:nil];
 [self reloadFetchedResultsController];
}
条件をクリア(nil)した上で再フェッチを行う。

-(void)reloadFetchedResultsController {
 NSError *error = nil;
 [NSFetchedResultsController deleteCacheWithName:@"UserSearch"];
    if (![self.fetchedResultsController performFetch:&error]) {
        NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
        abort();
    }
}


ソースコード


SearchSample at 2010-07-20 from xcatsan's iOS-Sample-Code - GitHub

Core Data - 最大値を取得する

2010年7月19日月曜日 | Published in | 0 コメント

このエントリーをはてなブックマークに追加

Core Data に格納されたデータの中から特定の属性値が最大値を取得したい。
SQL だと
SELECT MAX(timeStamp) FROM Book;
と、たった一行で簡単に取得できるが Core Data ではどうか?


前提


こんなエンティティがあったとする。

この属性値 timeStamp の最大値(すなわち最も最近の日時)を取得するメソッドを用意する。またこのメソッドは絞り込みの条件として Author(NSManagedObjectのサブクラス)を渡すことができる。


コード見本


こんな感じ。

- (Book*)lastTimeStampOfAuthor:(Author*)author
{
 NSManagedObjectContext* moc = self.managedObjectContext;
 
 NSFetchRequest* request = [[NSFetchRequest alloc] init];
 
 // entity
 NSEntityDescription* entity = [NSEntityDescription entityForName:@"Book"
    inManagedObjectContext:moc];
 [request setEntity:entity]; 

 // expression
 NSExpression *keyPathExpression = [NSExpression expressionForKeyPath:@"timeStamp"];
 NSExpression *expression =
 [NSExpression expressionForFunction:@"max:"
   arguments:[NSArray arrayWithObject:keyPathExpression]];

 // expresssion description
 NSExpressionDescription *expressionDescription = [[NSExpressionDescription alloc] init];
 [expressionDescription setName:@"maxTimeStamp"];
 [expressionDescription setExpression:expression];
 [expressionDescription setExpressionResultType:NSDateAttributeType];

 // result properties
 [request setResultType:NSDictionaryResultType];
 [request setPropertiesToFetch:[NSArray arrayWithObject:expressionDescription]];

 // predicate
 if (author) {
  NSPredicate* predicate = [NSPredicate predicateWithFormat:@"Author == %@", author];
  [request setPredicate:predicate];
 }

 // execution
 NSError* error = nil;
 NSArray* array = [moc executeFetchRequest:request error:&error];
 NSDate* timeStamp = nil;
 
 if (error) {
  NSLog(@"[ERROR] %@", error);
 } else {
  timeStamp = [[array objectAtIndex:0] valueForKey:@"maxTimeStamp"];
 }

 [expressionDescription release];
 [request release];
 return timeStamp;
 
}


長っ...


参考情報


Core Data Programming Guide: Fetching Managed Objects - Fetching Specific Values


補足

(7/27補足)SQLを確認したところ次のようになっていた。
CoreData: sql: SELECT max( t0.ZTREATEDDATE) FROM ZKARTE t0 WHERE  t0.ZCUSTOMER = ? 

やっぱり1行か。

Xcode - 矩形選択

2010年7月18日日曜日 | Published in | 0 コメント

このエントリーをはてなブックマークに追加

Xcode では option キーを押しながらマウスで矩形選択ができる。

optionキーを押すとマウスカーソルが+になるので、その状態で矩形の範囲を選択する。

貼り付けるとそこへコピーした時の矩形範囲そのままで挿入される。

UITableViewController は initWithStyle: で UITableView を作成する

2010年7月17日土曜日 | Published in | 0 コメント

このエントリーをはてなブックマークに追加

UITableViewController Class Reference

ものすごい勘違いをしていてハマった。記録に残しておく。

TableViewController.m
TableViewController.h
TableViewController.xib

を用意しておき、他のコントローラからこのコントローラを呼び出す。この時 -init を使う。
TableViewController *tableViewController =
    [[TableViewController alloc] init];
[self.navigationController pushViewController:tableViewController animated:YES];
[tableViewController release];

-initはこんな実装。
- (id)init
{
 if (self = [super initWithStyle:UITableViewStylePlain]) {
  :
  :
 }
 return self;
}

この場合、TableViewController.xib は使われない。なぜなら initWithStyle: を呼んだ場合、UITableViewController が UITableView を自動的に生成するから。普通に考えればわざわざ UITableViewStyle を引数に取っているので自明ではある..。

ずっと xib が使われているものだと思ってそのままにしていた。今回たまたま検索窓をつけようとしてこのことに気がついた。最初はなぜ xibの変更が反映されないのか焦ってしまった。


解決策は UIViewController の initWithNibName:bundle: を使うこと。
- (id)init
{
 if (self = [super initWithNibName:@"TableViewController" bundle:nil]) {
  :
  :
 }
 return self;
}

もしくは呼び出し側で initの代わりに使う。Xcodeが生成するテンプレートはこちらのスタイルになっている。
TableViewController *tableViewController =
    [[TableViewController alloc] initWithNibName:@"TableViewController" bundle:nil];
[self.navigationController pushViewController:tableViewController animated:YES];
[tableViewController release];

UISearchDisplayBar を初期状態では隠しておく

2010年7月16日金曜日 | Published in | 0 コメント

このエントリーをはてなブックマークに追加

ずばりの記事があった。
UISearchDisplayControllerのサーチバーを最初は隠しておきたい « Programmer’s High

コード(引用)
- (void)viewDidLoad {
[super viewDidLoad];
self.tableView.contentOffset = CGPointMake(0.0, self.searchDisplayController.searchBar.bounds.size.height);
}


前回のコードへ加えてみた。

初期表示

下へ引っ張ると出てくる



いい感じだ。

人気の投稿(過去 30日間)