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.
その文字列の大きさを返します、もしそれが指定された制約で、可変フォントサイズを含めて、単一の行上で描出されたならば。
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
非推奨
+ stringWithCString:
Creates a new string using a given C-string.
新しい文字列をある与えられたC文字列で作成します。
Deprecated
非推奨
- initWithCString:
Initializes the receiver, a newly allocated NSString
object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、与えられたC文字列の中のデータを省略時のC文字列符号化からユニコード文字符号化へと変換することによって初期化します。
Deprecated
非推奨
+ stringWithCString:length:
Returns a string containing the characters in a given C-string.
与えられたC文字列の中の文字を含んでいる文字列を返します。
Deprecated
非推奨
- initWithCString:length:
Initializes the receiver, a newly allocated NSString
object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、与えられたC文字列の中のデータを省略時のC文字列符号化からユニコード文字符号化へと変換することによって初期化します。
Deprecated
非推奨
- initWithCStringNoCopy:length:freeWhenDone:
Initializes the receiver, a newly allocated NSString
object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、与えられたC文字列の中のデータを省略時のC文字列符号化からユニコード文字符号化へと変換することによって初期化します。
Deprecated
非推奨
+ stringWithContentsOfFile:
Returns a string created by reading data from the file named by a given path.
与えられたパスによって指名されるファイルからデータを読み出すことによって作成される文字列を返します。
Deprecated
非推奨
- initWithContentsOfFile:
Initializes the receiver, a newly allocated NSString
object, by reading data from the file named by path
.
レシーバ、ある新しく作成されたNSString
オブジェクトを、path
によって指名されたファイルからデータを読み出すことによって初期化します。
Deprecated
非推奨
+ stringWithContentsOfURL:
Returns a string created by reading data from the file named by a given URL.
与えられたURLによって指名されるファイルからデータを読み出すことによって作成される文字列を返します。
Deprecated
非推奨
- initWithContentsOfURL:
Initializes the receiver, a newly allocated NSString
object, by reading data from the location named by a given URL.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、ある与えられたURLによって指名される位置からデータを読み出すことによって初期化します。
Deprecated
非推奨
- writeToFile:atomically:
Writes the contents of the receiver to the file specified by a given path.
レシーバの内容をある与えられたパスによって指定されるファイルに書き出します。
Deprecated
非推奨
- writeToURL:atomically:
Writes the contents of the receiver to the location specified by a given URL.
レシーバの内容をある与えられたURLによって指定される位置に書き出します。
Deprecated
非推奨
- getCharacters:
Copies all characters from the receiver into a given buffer.
全ての文字をレシーバからある与えられたバッファにコピーします。
Deprecated
非推奨
- cString
Returns a representation of the receiver as a C string in the default C-string encoding.
C文字列として、省略時のC文字列符号化において、レシーバの表現を返します。
Deprecated
非推奨
- lossyCString
Returns a representation of the receiver as a C string in the default C-string encoding, possibly losing information in converting to that encoding.
C文字列として、省略時のC文字列符号化において、レシーバの表現を返します、ことによるとその符号化への変換において情報を損失します。
Deprecated
非推奨
- cStringLength
Returns the length in char-sized units of the receiver’s C-string representation in the default C-string encoding.
省略時のC文字列符号化において 、レシーバのもつC文字列表現のcharサイズ単位での長さを返します。
Deprecated
非推奨
- stringByAddingPercentEscapesUsingEncoding:
Returns a representation of the receiver using a given encoding to determine the percent escapes necessary to convert the receiver into a legal URL string.
レシーバのある表現を返します、レシーバを合法なURL文字列へ変換するのに必要なパーセントエスケープを決定するのに与えられた符号化を使います。
Deprecated
非推奨
- stringByReplacingPercentEscapesUsingEncoding:
Returns a new string made by replacing in the receiver all percent escapes with the matching characters as determined by a given encoding.
レシーバにおいて全てのパーセントエスケープを、与えられた符号化によって判定されるときに、マッチする文字で置き換えることによって作られる新しい文字列を返します。
Deprecated
非推奨
- sizeWithFont:
Returns the size of the string if it were to be rendered with the specified font on a single line.
その文字列の大きさを返します、もしそれが指定されたフォントである単一の行上で描出されることになったならば。
Deprecated
非推奨
- sizeWithFont:forWidth:lineBreakMode:
Returns the size of the string if it were to be rendered with the specified font and line attributes on a single line.
その文字列の大きさを返します、もしそれが指定されたフォントと行属性である単一の行上で描出されることになったならば。
Deprecated
非推奨
- sizeWithFont:constrainedToSize:
Returns the size of the string if it were rendered and constrained to the specified size.
その文字列の大きさを返します、もしそれが描出されたそして指定された大きさに制約されたならば。
Deprecated
非推奨
- drawAtPoint:withFont:
Draws the string in a single line at the specified point in the current graphics context using the specified font.
文字列を単一行においてこの指定されたポイントで現在のグラフィック文脈においてこの指定されたフォントを使って描画します。
Deprecated
非推奨
- drawAtPoint:forWidth:withFont:lineBreakMode:
Draws the string in a single line at the specified point in the current graphics context using the specified font and attributes.
文字列を単一行においてこの指定されたポイントで現在のグラフィック文脈においてこの指定されたフォントと属性を使って描画します。
Deprecated
非推奨
- drawInRect:withFont:
Draws the string in the current graphics context using the specified bounding rectangle and font.
文字列を現在のグラフィック文脈においてこの指定された境界矩形とフォントを使って描画します。
Deprecated
非推奨
- drawInRect:withFont:lineBreakMode:
Draws the string in the current graphics context using the specified bounding rectangle, font, and attributes.
文字列を現在のグラフィック文脈においてこの指定された境界矩形、フォント、そして属性を使って描画します。
Deprecated
非推奨
- drawWithRect:options:attributes:
Draws the receiver with the specified options and other display characteristics of the given attributes, within the specified rectangle in the current graphics context.
レシーバをこの指定されたオプションとこの与えられた属性の他の表示特徴とともに、現在のグラフィクス文脈においてこの指定された矩形内に描画します。
Deprecated
非推奨
- boundingRectWithSize:options:attributes:
Calculates and returns the bounding rect for the receiver drawn using the given options and display characteristics, within the specified rectangle in the current graphics context.
現在のグラフィック文脈でこの指定された矩形内に、与えられたオプションと表示特徴を使って描画されるレシーバに対する境界rectを計算して返します。
Deprecated
非推奨