NSData+Base64

下記サイトの下の方にある NSData+Base64 のコードをダウンロードしてプロジェクトに追加します。
Cocoa with Love: Base64 encoding options on the Mac and iPhone

img タグを入れた HTML メールを送る

HTML メールを送るには以下のようにします。

NSMutableString* emailBody = [[[NSMutableString alloc] initWithString:@""] retain];
// HTML で本文を作成する
[emailBody appendString:@"太字"];

[emailBody appendString:@""];
MFMailComposeViewController* mailvc = [[MFMailComposeViewController alloc] init];
mailvc.mailComposeDelegate = self;
[mailvc setSubject:@"subject"];
[mailvc setToRecipients:[NSArray arrayWithObject:@"hoge@example.com"]];
[mailvc setMessageBody:emailBody isHTML:YES];
[self presentModalViewController:mailvc animated:YES];
[mailvc release];
[emailBody release];

しかし、img タグはタグを入れただけでは画像を本文内に表示させることはできません。img タグを使用する場合は、以下のように画像データを Base64 でエンコードして入れます。

NSString* path = [[NSBundle mainBundle] pathForResource:@"foo" ofType:@"gif"];
NSData* data = [NSData dataWithContentsOfFile:path];
NSString* base64String = [data base64EncodedString];
[emailBody appendString:[NSString stringWithFormat:@"<img src='data:image/gif;base64,%@'>", base64String]];

NSLog(@"%@, %@, %@", @"one", @"two", @"three");

上記の実行結果は “one, two, three” です。
次に下記のように実行すると

NSLog(@"%3$@, %2$@, %1$@, %2$@", @"one", @"two", @"three");

実行結果は “three, two, one, two” となります。”n$” と指定することにより、何番目の引数を入れるかを指定することができます。また同じ引数を何度でも指定することができます。

まあ、実際に NSLog ではこんな使い方をすることはないと思います。
しかし、これを知っておくと動的に出力する文字列をローカライズするときに役立ちます。

例えば、次のような日本語を出力したいとします。
（あまりいい例文が思いつかなかったw）

• 「太郎は2010年5月20日に花子と会った」

英語にローカライズすると

• “Taro met hanako on May 20, 2010.”

この文章の中で「太郎」「花子」「2010年5月20日」が動的に変わるとすると困るのが語順が違うことです。
この時こそ、先程の文字列フォーマットの順番指定が聞いてきます。

.strings に下記のように指定してします。

"HogeFormat" = @"%1$@は%3$@に%2$@と会った";
"HogeFormat" = @"%1$@ met %2$@ on %3$@.";

実際に出力する際は語順を気にせずに全ての言語で同じ語順で指定すれば正しく出力されます。

format = NSLocalizedString(@"HogeFormat", nil);
formattedString = [NSString stringWithFormat:format, name, name2, date];

もちろん、日付のローカライズはその前に必要です。日付のローカライズに関しては下記エントリもご参照ください。
[iPhone] 日付をローカライズして表示する | Sun Limited Mt.

UIWebView はインスタンスを生成しただけでは、URL をロードしてもレンダリングされません。レンダリングするには UIWindow 内になければダメです。そのために実際には表示しない UIWindow を作成して、その中に addSubview します。

UIWebView のデリゲートメソッド webViewDidFinishLoad: でロード終了の通知を受けてから、UIWebView のレイヤーの内容を UIImage に書きだします。

- (void)viewDidLoad {
  [super viewDidLoad];

  // 表示する UIImageView を生成
  self.imageView = [[UIImageView alloc] initWithFrame:CGRectMake(60, 90, 200, 300)];
  [self.view addSubview:imageView];

  // UIWebView 用の表示しない UIWindow を生成
  self.offscreenWindow = [[UIWindow alloc] initWithFrame:self.view.bounds];

  // UIWebView を表示しない UIWindow に生成
  NSURL* url = [NSURL URLWithString:@"http://www.yahoo.co.jp/"];
  self.webView = [[[UIWebView alloc] initWithFrame:imageView.bounds] autorelease];
  webView.delegate = self;
  webView.scalesPageToFit = YES;
  [offscreenWindow addSubview:webView];
  [webView loadRequest:[NSURLRequest requestWithURL:url]];
  isRendering = YES;
}

- (void) webViewDidFinishLoad:(UIWebView *)webView {
  if (isRendering) {
    isRendering = NO;
    // UIWebView の描画は別スレッドで行われ、
    // 描画完了前にこのメソッドが呼ばれるので
    // UIImage への描画処理は遅らせて実行する
    [self performSelector:@selector(renderWebContent) withObject:nil afterDelay:1.0];
  }
}

- (void) renderWebContent {
  UIGraphicsBeginImageContext(imageView.bounds.size);
  [webView.layer renderInContext:UIGraphicsGetCurrentContext()];
  imageView.image = UIGraphicsGetImageFromCurrentImageContext();
  UIGraphicsEndImageContext();
  [webView removeFromSuperview];
  webView.delegate = nil;
}

実行結果は以下のようになります。

注意点は UIWebView のレンダリング処理は別スレッドで非同期に行われるため、webViewDidFinishLoad: の通知の時にすぐに UIImage への書き出し処理を実行すると不完全なページになってしまいます。上記コードの 27行目を下記のように変更してすぐに書き出し処理すると不完全なページになってしまいます。

[self renderWebContent];

やりたいことは、Firefox などのマウスジェスチャーのように UIWebView をフィンガージェスチャーで操作するということです。UIWebView ではシングルタッチはスクロールや拡大縮小などがあるため、２本指でのタッチで左右にスワイプしたときに戻る、進むという動作をさせることにします。（フレーム内のスクロールに２本指でのタッチを使用しますが、まあその辺はとりあえず置いておいて下さい）

詳細なコードは GitHub にありますので、詳しくはそちらをご参照ください。

ポイントはフィンガージェスチャーを認識するためにタッチ動作をフックする UIWindow のサブクラス GestureWindow を作り、AppDelegate でその GestureWindow を使用するところです。UIWindow の sendEvent: ですべてのタッチ動作をフックして UIWebView への2本指でのマルチタッチのときのみ、delegateを通じてタッチイベントを通知します。また、フックしたタッチイベントは全てスーパークラスへそのまま渡すことにより、通常のタッチイベントを邪魔しないようにします。

@protocol GestureWindowDelegate

- (void) touchesBeganWeb:(NSSet *)touches withEvent:(UIEvent *)event;
- (void) touchesMovedWeb:(NSSet *)touches withEvent:(UIEvent *)event;
- (void) touchesEndedWeb:(NSSet *)touches withEvent:(UIEvent *)event;

@end

@interface GestureWindow : UIWindow {
    UIWebView* wView;
    id delegate;
}

@property (nonatomic, retain) UIWebView* wView;
@property (nonatomic, assign) id delegate;

@end

@implementation GestureWindow

@synthesize wView, delegate;

-(void) dealloc {
    [wView release];
    [super dealloc];
}

- (void)sendEvent:(UIEvent *)event {
    [super sendEvent:event];
    if (wView == nil || delegate == nil) {
        return;
    }
    // 2本指でのマルチタッチか
    NSSet *touches = [event allTouches];
    if (touches.count != 2) {
        return;
    }

    UITouch *touch = touches.anyObject;
    // 指定のUIWebViewへのタッチか
    if ([touch.view isDescendantOfView:wView] == NO) {
        return;
    }

    switch (touch.phase) {
        case UITouchPhaseBegan:
            if ([self.delegate
                 respondsToSelector:@selector(touchesBeganWeb:withEvent:)]) {
                [self.delegate
                    performSelector:@selector(touchesBeganWeb:withEvent:)
                    withObject:touches withObject:event];
            }
            break;
        case UITouchPhaseMoved:
            if ([self.delegate
                 respondsToSelector:@selector(touchesMovedWeb:withEvent:)]) {
                [self.delegate
                    performSelector:@selector(touchesMovedWeb:withEvent:)
                    withObject:touches withObject:event];
            }
            break;
        case UITouchPhaseEnded:
            if ([self.delegate
                 respondsToSelector:@selector(touchesEndedWeb:withEvent:)]) {
                [self.delegate
                    performSelector:@selector(touchesEndedWeb:withEvent:)
                    withObject:touches withObject:event];
            }
        default:
            return;
            break;
    }
}

@end

- (void) viewDidLoad {
    webView = [[UIWebView alloc] init];
    webView.delegate = self;
    ....
}

- (void)dealloc {
    webView.delegate = nil;
    [webView release];
}

アップルのマニュアルにも以下のように書かれています。

Important: Before releasing an instance of UIWebView for which you have set a delegate, you must first set its delegate property to nil. This can be done, for example, in your dealloc method.

理由は UIWebView のロード処理が別スレッドで行われているために、release 後にデリゲートメソッドを呼ぶ可能性があるためだそうです。

以下のコードで実験してみました。UIWebView のインスタンスを生成後、loadRequest で読み込みます。その直後に UIWebView のインスタンスをリリースしてみました。そして、webView.delegate = nil を入れた時と入れないときの挙動を試してみるとわかりやすいです。

- (void)viewDidLoad {
    [super viewDidLoad];

    UIWebView* webView = [[UIWebView alloc] init];
    [self.view addSubview:webView];
    webView.delegate = self;
    NSURL* url = [NSURL URLWithString:@"http://example.com"];
    [webView loadRequest:[NSURLRequest requestWithURL:url]];

    webView.delegate = nil;  // この行を入れた時と入れないときの挙動の違い
    [webView release];
}

- (void)webViewDidFinishLoad:(UIWebView *)_webView {
    NSLog(@"finish load");
}

delegate に nil を設定していないとデリゲートメソッドが呼ばれます。もし、このUIViewController のインスタンスが破棄されていればアプリが落ちてしまいます。

意図しないタイミングでデリゲートメソッドが呼ばれないために UIWebView のインスタンスをリリースする前にはデリゲートに nil をセットしなければいけないということです。

※すべての画像はクリックで拡大表示できます。

Group Opacity

UIView 内にある重なった2つの UIImageView があるときに、UIView の alpha 値を下げると UIImageView が重なっている部分がお互いに透過されて見えてしまいます。（下図参照）

これだとカッコ悪いので重なっている部分をお互いに透過させずに、ひとつの画像のイメージで透過させる方法です。
info.plist に UIViewGroupOpacity を指定して、値を true にします。これで下図のように重なり部分がお互いに透過されずに表示されます。

Edge anti-aliasing

画像にアンチエリアシングをかける方法です。
赤い四角形の画像を45度回転させたときの図です。

これだとよく分からないので拡大してみました。

エッジがギザギザしています。
これにアンチエリアシングをかけるには info.plist に UIViewEdgeAntialiasing を追加して値を true にします。
以下が UIViewEdgeAntialiasing = true で実行した結果です。

同様に拡大してみました。

この2つは OS3.0 以上で使用可能です。

先日、Xcode3.2 にやっとバージョンアップしたのですが、どうもそれが原因のようです。
info.plist にある、UIRequiredDeviceCapabilities の部分を削除したら実機ビルドできました。

参考サイト
Corrupt Info.plist « cocos2d for iPhone

UITableViewCell に UILabel を入れて、numberOfLines をゼロにします。numberOfLines をゼロにすると行数の制限がなくなります。

次に tableView: heightForRowAtIndexPath: で表示する行によって必要な高さを計算します。NSString を表示するサイズを計算するには、sizeWithFont:constrainedToSize:lineBreakMode: を使用します。

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
  NSString* text = @"表示するテキスト";
  UIFont* font = [UIFont systemFontOfSize:12];
  // label は表示する UILabel
  CGSize size = CGSizeMake(label.size.width, 1000);
  CGSize textSize = [text sizeWithFont:font constrainedToSize:size lineBreakMode:UILineBreakModeCharacterWrap];

  float height = 50.0f; // セルの最低限の高さ

  // 元の UILabel よりも高さが高ければ高さを補正する
  float h = textSize.height - label.size.height;
  if (h > 0) {
	height += h;
  }
  return height;
}

最後に tableView: cellForRowAtIndexPath: で実際にセルに各値を入れるときに、UILabel の高さを上記の計算で出した高さに変更すれば OK です。

UIEvent に以下のプロパティがあります。

• @property(readonly) UIEventType type;
• @property(readonly) UIEventSubtype subtype;

• UIEventTypeMotion
• UIEventSubtypeMotionShake

UIWindow でシェイクを感知

一番簡単にやるには、UIWindow のサブクラスを作成して、そこでチェックする方法です。

@implementation ShakeWindow
- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event {
  if (event.type == UIEventTypeMotion &&
      motion == UIEventSubtypeMotionShake) {
    NSLog(@"shake!");
  }
}
@end

UIWindow クラスを使用している箇所を ShakeWindow クラスに変更すれば、シェイク動作を取得できます。
注意点は IB を使用しているときは AppDelegate だけでなく、MainWindow.xib の方も修正する必要があります。

UIView でシェイクを感知

UIWindow でシェイクを感知するとアプリケーション全体で常にシェイク動作を感知してしまいます。そこで必要なときにのみ感知するように、特定の UIView でのみ感知するようにしてみます。

まず、シェイク動作をチェックしたい UIView のサブクラス ShakeView を作成します。シェイク動作を検知するためにはファーストレスポンダにならないといけないので、canBecomeFirstResonder をオーバライドして YES を返します。

@implementation ShakeView
- (BOOL)canBecomeFirstResponder {
	return YES;
}
@end

次に、UIViewController で ShakeView を addView して、motionEnded:withEvent: でシェイクを検知します。

- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event {
  if (event.type == UIEventTypeMotion &&
      motion == UIEventSubtypeMotionShake) {
    NSLog(@"shake!");
  }
}
- (void)viewDidLoad {
  [super viewDidLoad];

  ShakeView* shakeView = [[ShakeView alloc] init];
  shakeView.frame = self.view.bounds;
  [shakeView becomeFirstResponder];
  [self.view addSubview:shakeView];
  [shakeView release];
}

大事な点は、

• モーダルビューの表示、非表示は両方共同じクラスでやること
• 値の受け渡しはデリゲートで行うこと

ということです。

サンプルでたまに見かけるのは、表示を親ビューでやり、非表示はモーダルビューの中でやっている方法です。この方法でもかまいませんが、より汎用的にするためにはデリゲートを使用して、モーダルビューを表示したビューコントローラで非表示も行うべきです。また、モーダルビューから値を渡すのもデリゲートを使用して行うべきです。

モーダルビューの例としては、UIImagePickerViewController があげられます。この UIImagePickerViewController からの値の受け取り方、モーダル表示、非表示の方法をみていただければ、上記の説明が理解しやすいかと思います。

実際の実装方法です。まず、モーダルビューとして表示されるビューのコントローラを作ります。UITextField だけのビューです。UITextField の入力値を渡すのに使用する ModalViewDelegate を作成します。UITextField で Return キーを押すと UITextField に入力した値を delegate で指定したクラスへ渡します。

ModalViewController.h

@protocol ModalViewDelegate
- (void) updateTextField:(NSString*) string;
@end

@interface ModalViewController : UIViewController <UITextFieldDelegate> {
  id delegate;
  IBOutlet UITextField* textField;
}
@property (nonatomic, retain) id delegate;
@end

ModalViewController.m

@implementation ModalViewController
@synthesize delegate;
- (void)viewDidLoad {
  [super viewDidLoad];
  textField.delegate = self;
  [textField becomeFirstResponder];
}

- (BOOL)textFieldShouldReturn:(UITextField *)_textField {
  [textField resignFirstResponder];
  if ([delegate respondsToSelector:@selector(updateTextField:)]) {
    [delegate updateTextField:_textField.text];
  }
  return YES;
}

@end

今度は実際に ModalViewController をモーダル表示させる部分と、デリゲートを実装してその処理を作成します。モーダルビューからのデリゲート updateTextField: で値を受け取り、モーダルビューを非表示にします。
ParentViewController.h

@interface ParentViewController : UIViewController <ModalViewDelegate> {

}

@implementation ParentViewController

- (void) updateTextField:(NSString *)string {
  NSLog(@"string=%@", string);
  [self dismissModalViewControllerAnimated:YES];
}

- (IBAction) start:(id) sender {
  ModalViewController* viewController = [[ModalViewController alloc] initWithNibName:@"ModalViewController" bundle:nil];
  viewController.delegate = self;
  [self presentModalViewController:viewController animated:YES];
  [viewController release];
}