Instance Method インスタンスメソッド

sizeWithFont:minFontSize:actualFontSize:forWidth:lineBreakMode:

Returns the size of the string if it were rendered with the specified constraints, including a variable font size, on a single line. その文字列の大きさを返します、もしそれが指定された制約で、可変フォントサイズを含めて、単一の行上で描出されたならば。

Declaration 宣言

- (CGSize)sizeWithFont:(UIFont *)font 
           minFontSize:(CGFloat)minFontSize 
        actualFontSize:(CGFloat *)actualFontSize 
              forWidth:(CGFloat)width 
         lineBreakMode:(NSLineBreakMode)lineBreakMode;

Parameters パラメータ

font

The font to use for computing the string size. 文字列サイズを計算するために使うフォント。

minFontSize

The minimum size to which the font may be reduced before resorting to truncation of the text. テキストの切り詰めに助けを求める前にそれへとフォントが縮小されるかもしれない最小限のサイズ。

actualFontSize

On input, a pointer to a floating-point value. On return, this value contains the actual font size that was used to compute the size of the string. 入力では、ある浮動小数点地へのポインタ。戻りでは、この値は実際のフォントサイズを含みます、それは文字列の大きさを計算するのに使われたものです。

width

The maximum acceptable width for the string. This value is used to calculate where line breaks would be placed. その文字列に対する受け入れ可能な最大の幅。この値は、改行が置かれるだろうところを計算するために使われます。

lineBreakMode

The line break options for computing the size of the string. For a list of possible values, see NSLineBreakMode. 文字列の大きさを計算するための改行オプション。可能な値の一覧として、NSLineBreakModeを見てください。

Return Value 戻り値

The width and height of the resulting string’s bounding box. These values may be rounded up to the nearest whole number. 結果文字列のもつ境界ボックスの幅と高さ。これらの値は、最も近い整数へと切り上げられるかもしれません。

Discussion 議論

You can use this method to obtain the layout metrics you need to draw a string in your user interface. This method does not actually draw the string or alter the receiver’s text in any way. あなたはこのメソッドを使って、あなたがある文字列をあなたのユーザインターフェイスの中に描画するのに必要とするレイアウト指標を入手できます。このメソッドは、実際にその文字列を描画しません、またレシーバのもつテキストをどんな方法でも改変しません。

Although it computes where line breaks would occur, this method does not actually wrap the text to additional lines. If the entire string does not fit within the given width using the initial font size, this method reduces the font size until the string does fit or until it reaches the specified minimum font size. If it reaches the minimum font size, the method begins truncating the text (for layout purposes only) until the resulting truncated string fits the width; it then returns the size of that truncated string. それが改行が発生するところを計算するとはいえ、このメソッドは実際にはテキストを追加の行へとワードラップしません。文字列全体がこの与えられた幅内に初期フォントサイズを使って収められないならば、このメソッドはフォントサイズをその文字列が収まるまでまたはそれが指定された最小フォントサイズに届くまで縮小します。それが最小フォントサイズに届くならば、メソッドはテキストの切り詰めを開始します(レイアウト目的だけのために)、その結果の切り詰められた文字列がその幅に収まるまで;それはそれからその切り詰めた文字列のサイズを返します。

See Also 参照

Deprecated 非推奨