![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
|
内容の保証はできません。 /System/Library/frameWorks/UIKit.framework クラス UILabel †NSObject 概要 †
インデックス †テキスト属性にアクセス †
テキストのサイズ変更 †
ハイライト値の操作 †
影の描画 †
描画と配置のオーバーライド †
セッター/ゲッターの属性 †
プロパティ †adjustsFontSizeToFitWidth †ラベルの短形境界の中のタイトル文字列にあわせてフォントサイズを縮小するかどうかを指定する。
通常ラベルテキストの場合は、フォントプロパティに指定したフォントで描かれている。このプロパティがYESの場合は、テキストのフォントサイズがラベルの短形境界を超えてしまったときに、文字列が収まるか最小フォントサイズに達するまでフォントサイズを縮小する。このプロパティのデフォルト値はNOであり、変更する場合にはminimumFontSizeプロパティを変更することで適切な最小フォントサイズを設定する必要がある。
baselineAdjustment †テキストをラベルにあわせて縮小させる必要があるとき、テキストのベースラインの調整を制御する。このプロパティは、フォントサイズの調整が必要な状況下で、テキストのベースラインへの作用を制御する。デフォルトはUIBaselineAdjustmentAlignBaseLinesに設定されている。
enabled †このプロパティは、ラベルが利用可能かどうかを決定する。利用不可能なテキストは淡色で表示され非アクティブである。デフォルト：YES
font †テキストのフォントを指定する。このプロパティは全てのテキスト文字列に適用される。このプロパティのデフォルト値、システムフォントサイズは17である。プロパティの値をnilに設定すると例外が発生する。
highlighted †ハイライトが有効であるかどうかを指定する。このプロパティを設定する事で、適切な強調表示の状態でレシーバが再描画される。このプロパティの設定をYESまたはNOに変更する操作が行われたときにハイライトで再描画させるためには、highlightedTextColorプロパティの値がnil以外である必要がある。デフォルト：NO
highlightedTextColor †ハイライトが適用されたテキストの色を指定する。highlightedプロパティがYESにセットされたらこの色は自動的にラベルに適用される。デフォルト：nil
lineBreakMode †ラベルのテキストをトラッキング、ラッピングするための処理方法を指定する。このプロパティが有効な場合、フォントサイズをラベルの短形境界に合うように縮小する必要がある。このプロパティはデフォルトではUILineBreakModeTailTruncationに設定されている。
minimumFontSize †ラベルのテキストを描画する際に許容できる最小のフォントサイズを指定する。テキストを描画する際にはラベルの短形境界に適合しない可能性があるため、それを防ぐためにテキストのフォントサイズを短形境界に沿って縮小する事が可能である。このプロパティはデフォルトでは0.0であるが、ラベルのフォント調整を有効にした場合、この値を常にデフォルト値より大きくする必要がある。
numberOfLines †テキストレンダリングのために行の最大数を指定する。このプロパティでは、短形の境界を制御するためにテキストの最大行数を指定する。デフォルト値は1である。任意の行数の上限を無くす為には、プロパティの値を0にすればよい。ラベルの短形境界を超える場合にはlineBreakModeで適切なモードを利用すること。sizeToFitメソッドを使用して、レシーバがリサイズされた時、レシーバはリサイズのサイズにこのプロパティの値を格納する。
例えばこのプロパティの値が3にセットされていたなら、sizeToFitメソッドは3行のテキストを表示するのに十分な大きさでレシーバをリサイズする。
shadowColor †テキストの影の色を指定する。このプロパティのデフォルト値は、影の描画がない事を示しているnilである。このプロパティのデフォルト値を変更する事で、shadowOffsetプロパティのデフォルト値が変更される場合がある。テキストの影はオフセットと色とかすみ具合を指定して描かれる。
shadowOffset †テキストの影のオフセットを指定する。このプロパティは、影の色以外にも任意の効果があるため、プロパティ値はnil以外にする必要がある。デフォルトのオフセットの大きさである(0, -1)は、一点のテキストの上に影を示している。テキストの影はオフセットと色とかすみ具合を指定して描かれる。
text †ラベルによって表示されるテキストを指定する。
textAlignment †テキスト整列のための処理法方を指定する。このプロパティは、全てのテキスト文字列に適用される。プロパティのデフォルト値はUITextAlignmentLeftに設定されている。
textColor †テキストの色を指定する。このプロパティは全てのテキスト文字列に適用される。プロパティのデフォルト値はUIColorクラスのblackColorに設定されている。プロパティ値をnilにすると例外が発生する。
userInteractionEnabled †ユーザのイベントが無視されるかどうかとイベントキューからの削除を決定する。このプロパティは、親クラスであるUIViewから継承されている。親クラスがこのプロパティのデフォルト値をNOに変更することがある。
インスタンスメソッド †drawTextInRect: †指定した短形でテキスト(またはその影)を描画する。このメソッドを直接呼び出してはならない。このメソッドは、テキストのデフォルトの描画の作用を変更したい場合、サブクラスによってのみオーバーライドされるべきである。このメソッドが呼び出されるときには、現在のグラフィックスコンテキストは既にデフォルトの描画環境と描画色で構成されている。オーバーライドメソッドでは、現在のコンテキストをさらに構成することができ、"スーパー"を呼び出すことで、実際の描画や自らの描画を構成することも出来る。自分のテキストのレンダリングを行う際には、"スーパー"を呼び出してはならない。 注記:例として、影付きのテキストをラベルで描画する時、このメソッドは2回連続して呼ばれ、最初は影を描画して次にテキストを描画する可能性がある。
textRectForBounds:limitedToNumberOfLines: †テキストの描画短形を返す。このメソッドを直接呼び出してはならない。他の計算を実行する前に、レシーバの短形境界を変更するにはサブクラスでオーバーライドする必要がある。numberOfLinesのパラメータの値を使用する事で返された長方形の高さを制限することができる。このメソッドのデフォルトでの実装では、元の短形境界を返す。
|
