Instance Method
インスタンスメソッド
sizeWithFont:constrainedToSize:lineBreakMode:
Returns the size of the string if it were rendered with the specified constraints.
その文字列の大きさを返します、もしそれがその指定された制約で描出されたならば。
Parameters
パラメータ
font
The font to use for computing the string size.
文字列サイズを計算するために使うフォント。
size
The maximum acceptable size for the string. This value is used to calculate where line breaks and wrapping would occur.
文字列に対する最大限受け入れ可能な大きさ。この値は、改行およびワードラップが発生するところを計算するために使われます。
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.
あなたはこのメソッドを使って、あなたがある文字列をあなたのユーザインターフェイスの中に描画するのに必要とするレイアウト指標を入手できます。このメソッドは、実際にその文字列を描画しません、またレシーバのもつテキストをどんな方法でも改変しません。
This method computes the metrics needed to draw the specified string. This method lays out the receiver’s text and attempts to make it fit the specified size using the specified font and line break options. During layout, the method may break the text onto multiple lines to make it fit better. If the receiver’s text does not completely fit in the specified size, it lays out as much of the text as possible and truncates it (for layout purposes only) according to the specified line break mode. It then returns the size of the resulting truncated string. If the height specified in the size
parameter is less than a single line of text, this method may return a height value that is bigger than the one specified.
このメソッドは、指定された文字列を描画するために必要とされる指標を計算します。このメソッドは、レシーバのもつテキストをレイアウトします、そしてそれをその指定された大きさに収まるようにその指定されたフォントと改行オプションを使って試みます。レイアウトの間、このメソッドはテキストを複数行上へと折りたたむかもしれません。レシーバのもつテキストがその指定された大きさの中に完全に収まらないならば、それはできるだけテキストに合うようにレイアウトします、そしてそれをその指定された改行モードによって(レイアウト目的のみのために)切り詰めます。それはそれから結果の切り詰めた文字列の大きさを返します。size
パラメータにおいて指定された高さがテキストの単一行より少ないならば、このメソッドは指定されたものより大きい高さ値を返すかもしれません。
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
非推奨