Function
関数
NSPointInRect
Returns a Boolean value that indicates whether a given point is in a given rectangle.
与えられた点が与えられた矩形の中にあるかどうかを指し示すブール値を返します。
Return Value
戻り値
YES
if aPoint
is located within the rectangle represented by aRect
, otherwise NO
.
YES
、もしaPoint
がaRect
によって表される矩形内に位置するならば、そうでなければNO
。
Discussion
議論
Point-in-rectangle functions generally assume that the “upper” and “left” edges of a rectangle are inside the rectangle boundaries, while the “lower” and “right” edges are outside the boundaries. This method treats the “upper” and “left” edges of the rectangle as the ones containing the origin of the rectangle.
「ポイントイン矩形」関数は、一般的に、矩形の「上」と「左」端が矩形境界の内側である、一方で「下」と「右」端は境界の外側であることを仮定します。このメソッドは、矩形の「上」と「左」端を矩形の原点を含んでいるものとして扱います。
Special Considerations
特別な注意事項
The meanings of “upper” and “lower” (and “left” and “right”) are relative to the current coordinate system and the location of the rectangle. For a rectangle of positive height located in positive x and y coordinates:
「上」と「下」(そして「左」と「右」)の意味することは、現在の座標システムおよび矩形の位置に相対的です。正の x と y 座標に位置する、正の高さをもつ矩形に対して:
In the default macOS desktop coordinate system—where the origin is at the bottom left—the rectangle edge closest to the bottom of the screen is the “upper” edge (and is considered inside the rectangle).
初期状態のmacOSデスクトップ座標システムにおいて — そこにおいて原点は下左です — 画面の下に最も近い矩形の端は、「上」端です(そして矩形内と考えられます)。
On iOS and in a flipped coordinate system in macOS desktop—where the origin is at the top left—the rectangle edge closest to the bottom of the screen is the “lower” edge (and is considered outside the rectangle).
iOS上でそしてmacOSデスクトップでの反転座標システムにおいて — そこにおいて原点は上側左です — 画面の下に最も近い矩形の端は、「下」端です(そして矩形外と考えられます)。
See Also
参照
Managing Rectangles
矩形を管理する
NSContainsRect
Returns a Boolean value that indicates whether one rectangle completely encloses another.
ある1つの矩形が完全に別のものを取り囲むかどうかを指し示すブール値を返します。
NSDivideRect
Divides a rectangle into two new rectangles.
ある矩形を2つの新しい矩形へと分割します。
NSEqualRects
Returns a Boolean value that indicates whether the two rectangles are equal.
2つの矩形が等しいかどうかを指し示すブール値を返します。
NSIsEmptyRect
Returns a Boolean value that indicates whether a given rectangle is empty.
与えられた矩形が空であるかどうかを指し示すブール値を返します。
NSHeight
Returns the height of a given rectangle.
与えられた矩形の高さを返します。
NSInsetRect
Insets a rectangle by a specified amount.
指定された量だけ矩形にインセット(差込)をします。
NSIntegralRect
Adjusts the sides of a rectangle to integer values.
矩形の辺を整数値に合わせて調整する。
NSIntegralRectWithOptions
Adjusts the sides of a rectangle to integral values using the specified options.
矩形の辺を整数値に調整します、指定されたオプションを使います。
NSIntersectsRect
Returns a Boolean value that indicates whether two rectangles intersect.
2つの矩形が交差するかどうかを指し示すブール値を返します。
NSMakeRect
Creates a new NSRect
from the specified values.
新しいNSRect
を、指定された値から作成します。
NSMaxX
Returns the largest x coordinate of a given rectangle.
与えられた矩形の最大のx座標を返します。
NSMaxY
Returns the largest y coordinate of a given rectangle.
与えられた矩形の最大のy座標を返します。
NSMidX
Returns the x coordinate of a given rectangle’s midpoint.
与えられた矩形の中心点のx座標を返します。
NSMidY
Returns the y coordinate of a given rectangle’s midpoint.
与えられた矩形の中心点のy座標を返します。
NSMinX
Returns the smallest x coordinate of a given rectangle.
与えられた矩形の最小のx座標を返します。
NSMinY
Returns the smallest y coordinate of a given rectangle.
与えられた矩形の最小のy座標を返します。
NSMouseInRect
Returns a Boolean value that indicates whether the point is in the specified rectangle.
その点が指定された矩形の中にあるかどうかを指し示すブール値を返します。
NSOffsetRect
Offsets the rectangle by the specified amount.
矩形を指定された量だけオフセットします。
NSRectFromString
Returns a rectangle from a text-based representation.
テキストに基づく表現から、矩形を返します。
NSStringFromRect
Returns a string representation of a rectangle.
ある矩形を表している文字列を返します。
NSRectFromCGRect
Returns an NSRect
typecast from a CGRect
.
CGRect
から型キャストされたNSRect
を返します。
NSRectToCGRect
Returns a CGRect
typecast from an NSRect
.
NSRect
から型キャストされた、CGRect
を返します。
NSUnionRect
Calculates the union of two rectangles.
2つの矩形の併合を計算する。
NSWidth
Returns the width of the specified rectangle.
指定された矩形の幅を返します。