カテゴリー別アーカイブ: リファレンスマニュアル

今更きけないUILabelの基本まとめ

概要

UILabelはUIViewを継承したクラス。
固定された内容のテキストを画面に貼付けるのに使う。
生成したら必ずどこぞのコントローラ下のViewにaddSubviewする。

UILabelTest

プロパティ

設定できるプロパティは以下の通り。

text

  • NSStringでパラメータ付与。
  • ラベル内に表示する文字列を指定する。

font

 

  • UIFontで指定。
  • フォントの種類を指定。フォントオブジェクトはその章を参照。
  •  

textColor

   

  • UIColorでパラメータ付与。
  • フォントの色を変える。
  •  

lineBreakMode

   

  • UILineBreakMode定数を指定する。
  • 文字数オーバー時の表現方法を指定。
  •  

enabled

   

  • BOOL指定。
  • グレー反転させて使用不可表現を行う。
  •  

adjustsFontSizeToFitWidth

   

  • BOOL指定。
  • textで指定した文字列がラベルの矩形内に納まる様にアジャストするか否かを指定する。
  • これをYESニシタバアイハlineBreakModeが無効になる。
  •  

baselineAdjustment

   

  • UIBaselineAdjustmentを文字列定数で指定。
  •  

minimumFontSize

   

  • CGFloatで指定。
  • 次に記述するnumberOfLinesが1の時のみ効果が出る。
  •  

numberOfLines

   

  • NSInteger指定。
  • textで指定された文字列を表示する限界の行数を指定する。
  •  

highlightedTextColor

   

  • UIColor指定。
  • ハイライトされた際の文字色を指定する。
  •  

highlighted

   

  • BOOL指定
  • ハイライトするか否かを指定する。
  •  

shadowColor

   

  • UIColor指定。
  • highlightedが有効だと
  •  

shadowOffset

   

  • CGSize指定。
  • CGSizeはCGFloat型のwidthとheightの2部構成。CGSizeMake(w,h)で作成。
  •  

userInteractionEnabled

   

  • BOOL指定。
  • タッチの検出をするか否か。しない、がデフォ。
  •  

メソッド一覧

    drawTextInRect:

    • このメソッドは直接呼ばない方が良い。継承したサブクラスのデフォルトの振舞で描画したい時に呼ばれるべきだ。
    • このメソッドが呼ばれる時、現在の描画コンテキスト(デフォルトの環境とテキストの色で)の設計が完了する。
    • Overrideしたメソッドではsuper使って同名メソッドを発動させよう。

    textRectForBounds:limitedToNumberOfLines:

       

    • ラベルのテキストの矩形(CGRect)を返す。
    • parameter
      • bounds(CGRect)
      •      

        • レシーバの矩形を渡す
      • numberOfLines:(NSInteger)
      •          

        • 最大行数を渡す
    • このメソッドは直接呼ぶべきではない。レシーバに指定した矩形に何かしらの計算を伴う動作をさせる前に、継承したサブクラスがOverrideしたメソッドから呼ぶべきだ。
    • 最大行数を指定するnumberOfLinesパラメータを使って高さの上限を返される矩形に指定できる。
    • メソッドを呼ぶためにはsizeToFitか、sizeThatFitsの呼び出しが先だ。
    • UITableViewCellオブジェクト内のUILabel、またはサイズ指定のないUILabelはセルの寸法ベースのサイズが適用される。
    •    

    UILineBreakModeについて

    矩形に対する文字列幅がオーバーした際の表現方法を指定する。
    もともと行数指定をしてた場合は矩形幅がたらなくなるところまでは大凡共通した仕様で改行が行われる。
    UILineBreakModeCharacterWrapは例外で、Word間で自動改行ではなく、たらなくなった時点で改行が行われるので1単語を切ることになるので注意が必要。
    UILabel_Preview

    typedef enum {
       UILineBreakModeWordWrap = 0,
       UILineBreakModeCharacterWrap,
       UILineBreakModeClip,
       UILineBreakModeHeadTruncation,
       UILineBreakModeTailTruncation,
       UILineBreakModeMiddleTruncation, } UILineBreakMode;
    

    サンプル

    このサンプルを実行すると本記事のトップで表示した画像とおなじViewになる。

    - (void)viewDidLoad
    {
        NSLog(@"%s",__func__);
        [super viewDidLoad];
        
        float margine = 5;
        float y = 5;
        float h = 70;
        CGRect rect1 = CGRectMake(10,y,300,h);
        UILabel* label_UILineBreakModeWordWrap = [[UILabel alloc]initWithFrame:rect1];
        label_UILineBreakModeWordWrap.lineBreakMode = UILineBreakModeWordWrap;
        label_UILineBreakModeWordWrap.text = @"label_UILineBreakModeWordWrapnthis is label_UILineBreakModeWordWrap this is label_UILineBreakModeWordWrap this is label_UILineBreakModeWordWrap this is label_UILineBreakModeWordWrap";
        label_UILineBreakModeWordWrap.font = [UIFont systemFontOfSize:[UIFont smallSystemFontSize]];
        label_UILineBreakModeWordWrap.textAlignment = UITextAlignmentLeft;
        label_UILineBreakModeWordWrap.numberOfLines = 3;
        [self.view addSubview:label_UILineBreakModeWordWrap];
        
        y += h + margine;
        
        CGRect rect2 = CGRectMake(10,y,300,h);
        UILabel* label_UILineBreakModeTailTruncation = [[UILabel alloc]initWithFrame:rect2];
        label_UILineBreakModeTailTruncation.lineBreakMode = UILineBreakModeTailTruncation;
        label_UILineBreakModeTailTruncation.text = @"label_UILineBreakModeTailTruncationnthis is label_UILineBreakModeTailTruncation this is label_UILineBreakModeTailTruncation this is label_UILineBreakModeTailTruncation this is label_UILineBreakModeTailTruncation";
        label_UILineBreakModeTailTruncation.font = [UIFont systemFontOfSize:[UIFont smallSystemFontSize]];
        label_UILineBreakModeTailTruncation.textAlignment = UITextAlignmentLeft;
        label_UILineBreakModeTailTruncation.enabled = NO;
        label_UILineBreakModeTailTruncation.adjustsFontSizeToFitWidth = YES;
        label_UILineBreakModeTailTruncation.baselineAdjustment = UIBaselineAdjustmentAlignBaselines;//UIBaselineAdjustmentNone;//UIBaselineAdjustmentAlignCenters;//
        label_UILineBreakModeTailTruncation.numberOfLines = 3;
        label_UILineBreakModeTailTruncation.highlighted = YES;
        label_UILineBreakModeTailTruncation.shadowColor = [UIColor redColor];
        label_UILineBreakModeTailTruncation.shadowOffset = CGSizeMake(3.0, 2.0);
        [self.view addSubview:label_UILineBreakModeTailTruncation];
    
        y += h + margine;
    
        CGRect rect3 = CGRectMake(10,y,300,h);
        UILabel* label_UILineBreakModeMiddleTruncation = [[UILabel alloc]initWithFrame:rect3];
        label_UILineBreakModeMiddleTruncation.lineBreakMode = UILineBreakModeMiddleTruncation;
        label_UILineBreakModeMiddleTruncation.text = @"label_UILineBreakModeMiddleTruncationnthis is label_UILineBreakModeMiddleTruncation this is label_UILineBreakModeMiddleTruncation this is label_UILineBreakModeMiddleTruncation";
        label_UILineBreakModeMiddleTruncation.font = [UIFont systemFontOfSize:[UIFont smallSystemFontSize]];
        label_UILineBreakModeMiddleTruncation.textAlignment = UITextAlignmentLeft;
        label_UILineBreakModeMiddleTruncation.numberOfLines = 3;
        label_UILineBreakModeMiddleTruncation.highlighted = NO;
        label_UILineBreakModeMiddleTruncation.highlightedTextColor = [UIColor blueColor];
        label_UILineBreakModeMiddleTruncation.shadowColor = [UIColor redColor];
        label_UILineBreakModeMiddleTruncation.shadowOffset = CGSizeMake(3.0, 2.0);
    
        [self.view addSubview:label_UILineBreakModeMiddleTruncation];
        
        y += h + margine;
    
        CGRect rect4 = CGRectMake(10,y,300,h);
        UILabel* label_UILineBreakModeHeadTruncation = [[UILabel alloc]initWithFrame:rect4];
        label_UILineBreakModeHeadTruncation.lineBreakMode = UILineBreakModeHeadTruncation;
        label_UILineBreakModeHeadTruncation.text = @"label_UILineBreakModeHeadTruncationnthis is label_UILineBreakModeHeadTruncation this is label_UILineBreakModeHeadTruncation this is label_UILineBreakModeHeadTruncation";
        label_UILineBreakModeHeadTruncation.font = [UIFont systemFontOfSize:[UIFont smallSystemFontSize]];
        label_UILineBreakModeHeadTruncation.textAlignment = UITextAlignmentLeft;
        label_UILineBreakModeHeadTruncation.numberOfLines = 3;
        label_UILineBreakModeHeadTruncation.highlighted = YES;
        label_UILineBreakModeHeadTruncation.highlightedTextColor = [UIColor blueColor];
        label_UILineBreakModeHeadTruncation.shadowColor = [UIColor redColor];
        label_UILineBreakModeHeadTruncation.shadowOffset = CGSizeMake(3.0, 2.0);
    
        [self.view addSubview:label_UILineBreakModeHeadTruncation];
    
        y += h + margine;
    
        CGRect rect5 = CGRectMake(10,y,300,h);
        UILabel* label_UILineBreakModeClip = [[UILabel alloc]initWithFrame:rect5];
        label_UILineBreakModeClip.lineBreakMode = UILineBreakModeClip;
        label_UILineBreakModeClip.text = @"label_UILineBreakModeClipnthis is label_UILineBreakModeClip this is label_UILineBreakModeClip this is label_UILineBreakModeClip this is label_UILineBreakModeClip";
        label_UILineBreakModeClip.font = [UIFont systemFontOfSize:[UIFont smallSystemFontSize]];
        label_UILineBreakModeClip.textAlignment = UITextAlignmentLeft;
        label_UILineBreakModeClip.numberOfLines = 3;
        label_UILineBreakModeClip.userInteractionEnabled = NO;
        [label_UILineBreakModeClip textRectForBounds:CGRectMake(50,y,100,h) limitedToNumberOfLines:0];
        [self.view addSubview:label_UILineBreakModeClip];
    
        y += h + margine;
    
        CGRect rect6 = CGRectMake(10,y,300,h);
        UILabel* label_UILineBreakModeCharacterWrap = [[UILabel alloc]initWithFrame:rect6];
        label_UILineBreakModeCharacterWrap.lineBreakMode = UILineBreakModeCharacterWrap;
        label_UILineBreakModeCharacterWrap.text = @"label_UILineBreakModeCharacterWrapnthis is label_UILineBreakModeCharacterWrap this is label_UILineBreakModeCharacterWrap this is label_UILineBreakModeCharacterWrap this is label_UILineBreakModeCharacterWrap";
        label_UILineBreakModeCharacterWrap.font = [UIFont systemFontOfSize:[UIFont smallSystemFontSize]];
        label_UILineBreakModeCharacterWrap.textAlignment = UITextAlignmentLeft;
        label_UILineBreakModeCharacterWrap.numberOfLines = 3;
        label_UILineBreakModeCharacterWrap.userInteractionEnabled = YES;
        [label_UILineBreakModeCharacterWrap drawTextInRect:CGRectMake(10,y,100,h)];
        [self.view addSubview:label_UILineBreakModeCharacterWrap];
    }
    

    詳解 Objective-C 2.0 第3版

    Objective-C プログラマーズバイブル

[Unity]MonoBehaviour

http://unity3d.com/support/documentation/ScriptReference/Behaviour.html

MonoBehaviour Inherits from Behaviour MonoBehaviour is the base class every script derives from.

Using Javascript every script automatically derives from MonoBehaviour. When using C# or Boo you have to explicitly derive from MonoBehaviour.

Note: The checkbox for disabling a MonoBehavior (on the editor) will only prevent Start(), Awake(), Update(), FixedUpdate(), and OnGUI() from executing. If none of these functions are present, the checkbox is not displayed.

See Also: The chapter on scripting in the manual.

訳:

MonoBehaviour Behaviourから継承。

MonoBehaviour は全てのスクリプトが導き出される基底クラス。

Javascriptを使用した際のスクリプトは自動的にMonoBehaviourから導き出されます。

C#やBooを使用する時はMonoBehaviourから導き出す事を明示しなければなりません。

Note:

MonoBehaviorの機能を切るためのエディター上の

チェックボックスは、次の処理を無効化。

Start(), Awake(), Update() FixedUpdate() OnGUI()

これらの関数が用意されてなければチェックボックスが表示されません。

マニュアルの chapter on scripting を参照。