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

draw(in:)

Draws the attributed string inside the specified bounding rectangle in the current graphics context. 属性付文字列をこの指定された境界矩形の内側に現在のグラフィック文脈で描画します。

Declaration 宣言

iOS, iPadOS, Mac Catalyst, tvOS, watchOS

func draw(in rect: CGRect)

macOS

func draw(in rect: NSRect)

Parameters パラメータ

rect

The bounding rectangle in which to draw the string. In AppKit, the origin is normally in the lower-left corner of the drawing area, but the origin is in the upper-left corner if the focused view is flipped. それの中に文字列を描画することになる境界矩形。AppKitにおいて、原点はふつう描画エリアの下側左隅になります、しかしこの原点は、フォーカスされたビューがフリップされるならば上側左隅になります。

Discussion 議論

This method draws as much of the string as it can inside the specified rectangle, wrapping the string text as needed to make it fit. If the string is too long to fit inside the rectangle, the method renders as much as possible and clips the rest. It is possible for a portion of a glyph to appear outside the area of rect if the image bounding box of the particular glyph exceeds its typographic bounding box. Text is drawn according to its line sweep direction; for example, Arabic text begins at the right edge and is potentially clipped on the left. このメソッドは、多くの文字列をそれがその指定された矩形内部に可能なだけ描画して、文字列テキストを必要に応じてそれがぴったり収まるようにワードラップしています。文字列が矩形にぴったり収まるには大きすぎるならば、メソッドは可能な限りたくさん描画して、残りを切り取ります。あるグリフの一部がrectのエリアの外側に現れることは可能です、もし特定のグリフのイメージ境界ボックスがそれのタイポグラフィック境界ボックスの限界を越えるならば。テキストは、それの行伸ばし方向に従って描画されます;例えば、アラビアテキストは右端から始まります、そしてもしかしたら左で切り詰められます。

Layout always occurs from top to bottom. AppKit automatically adjusts the initial drawing point whether or not the view is flipped. For example, if the rect argument is {0.0, 0.0, 100.0, 100.0}, the text origin is {0.0, 0.0} when the view coordinates are flipped and {0.0, 100.0} when the view is not flipped. レイアウトは、常に上から下へ起こります。AppKitは、自動的に最初の描画点を調整します、ビューがフリップされようとされまいと。例えば、rect引数が{0.0, 0.0, 100.0, 100.0}ならば、テキスト原点は、ビュー座標がフリップされる場合は {0.0, 0.0} 、そしてビューがフリップされない場合は {0.0, 100.0} です。

This method draws the line using the attributes specified in the attributed string itself. If newline characters are present in the string, those characters are honored and cause subsequent text to be placed on the next line underneath the starting point. このメソッドは、行を属性付文字列それ自体において指定される属性を使って描画します。改行文字が文字列において存在するならば、それら文字は尊重されます、そして続くテキストが、開始点の真下の次の行上に置かれるようにします。

There must be either a focused view or an active graphics context when you call this method. あなたがこのメソッドを呼び出す場合、フォーカスされたビューまたはある実際のグラフィックコンテキストのどちらかがなければなりません。

See Also 参照

Drawing the String 文字列を描画する

Related Documentation 関連文書