クラス
NSCursor
ポインタ (カーソルとも呼ばれます)。
宣言
class NSCursor : NSObject
概観
以下の表は、システムカーソルを示して説明し、それらを取得するためのクラスメソッドを示しています。
| カーソル | 説明 |
 | 矢印のカーソル (arrow) |
 | 挿入点を示すための I ビームカーソル (iBeam) |
 | 十字カーソル (crosshair) |
 | 閉じた手のカーソル (closedHand) |
 | 開いた手のカーソル (openHand) |
 | 手で示すカーソル (pointingHand) |
 | 左へのサイズ変更カーソル (resizeLeft) |
 | 右へのサイズ変更カーソル (resizeRight) |
 | 左右へのサイズ変更カーソル (resizeLeftRight) |
 | 上へのサイズ変更カーソル (resizeUp) |
 | 下へのサイズ変更カーソル (resizeDown) |
 | 上下へのサイズ変更カーソル (resizeUpDown) |
 | 項目消失カーソル (disappearingItem) |
 | 垂直レイアウト用 I ビームテキストカーソル (iBeamCursorForVerticalLayout)。 |
 | 許可されないカーソル (operationNotAllowed)。 |
 | ドラッグリンクカーソル (dragLink)。 |
 | ドラッグコピーカーソル (dragCopy)。 |
 | コンテクストメニューカーソル (contextualMenu)。 |
macOS 10.3 以降では、カーソルサイズは 16x16 ピクセルに制限されなくなりました。
カーソルの長方形
Cocoa では、ビューの 1 つに対するマウスの位置に基づいて、現在表示されているカーソルを変更できます。この手法を使用して、ユーザがマウスで実行できるアクションに関する視覚的なフィードバックを提供できます。たとえば、カスタムのサイズ変更ハンドルとして機能するビューの一部にマウスを移動するたびに、サイズ変更カーソルの 1 つを表示できます。これを設定するには、カーソルオブジェクトをビュー内の 1 つ以上のカーソルの長方形に関連付けます。
カーソルの長方形は、ビュー内のマウスの位置を監視するために使用される特殊な型の追跡長方形です。ビューは、追跡長方形を使用してカーソルの長方形を実装しますが、汎用追跡長方形インターフェイスとは異なるカーソルの長方形を設定および更新するためのメソッドを提供します。カーソルの長方形を設定する方法については、マウス追跡およびカーソル更新イベント (Mouse-Tracking and Cursor-Update Events) を参照してください。
カーソルの非表示と表示のバランスをとる
hide() カーソルを呼び出すたびに、対応する unhide() 呼び出しをしなければなりません。例えば、
[NSCursor hide];
// ...
[NSCursor unhide];
hide と unhide() メソッドの呼び出しのバランスが取れていないため、カーソルは非表示のままになります。代わりに、以下の例のように、メソッド呼び出しのバランスをとらなければなりません。
[NSCursor hide];
// ...
[NSCursor unhide];
[NSCursor unhide];
トピックス
新しいカーソルの初期化
init(image: NSImage, hotSpot: NSPoint)
与えられたイメージとホットスポットでカーソルを初期化します。
init(image: NSImage, foregroundColorHint: NSColor?, backgroundColorHint: NSColor?, hotSpot: NSPoint)
指定されたイメージとホットスポットでカーソルを初期化します。
廃止
カーソル属性の設定
カーソルのイメージ。
カーソルのホットスポットの位置。
現在のカーソルを非表示にします。
現在のカーソルを表示して、hide() への以前の呼び出しを無効にします。
class func setHiddenUntilMouseMoves(Bool)
マウスが移動するまでカーソルを非表示にするかどうかを設定します。
現在のカーソルの制御
現在のカーソルをスタックの一番上からポップします。
受信者のクラスに pop() メッセージを送信します。
受信者をカーソルスタックの一番上に置き、それを現在のカーソルにします。
受信者を現在のカーソルにします。
func mouseEntered(with: NSEvent)
カーソルが、受信者が所有するカーソルの長方形に入ると、受信者に自動的に送信されます。
廃止
受信者が mouseEntered(with:) イベントを受け入れるかどうかを指定します。
廃止
mouseEntered(with:) メッセージの受信時に受信者が最新になるかどうかを示すブール値。
廃止
func mouseExited(with: NSEvent)
カーソルが、受信者が所有するカーソルの長方形を出ると、自動的に受信者に送信されます。
廃止
受信者が mouseExited(with:) イベントを受け入れるかどうかを設定します。
廃止
mouseExited(with:) メッセージを受信したときに受信者が最新になるかどうかを示すブール値。
廃止
カーソルインスタンスの取得
アプリケーションの現在のカーソルを返します。
class var currentSystem: NSCursor?
現在のシステムカーソルを返します。
デフォルトのカーソルである矢印カーソルを返します。
class var contextualMenu: NSCursor
コンテキストメニューシステムのカーソルを返します。
class var closedHand: NSCursor
閉じた手のシステムカーソルを返します。
十字のシステムカーソルを返します。
class var disappearingItem: NSCursor
現在の操作でアイテムが消えることを示すカーソルを返します。
現在の操作でコピーアクションが発生することを示すカーソルを返します。
現在の操作でリンクアクションになることを示すカーソルを返します。
中央に小さなクロスビームがある大文字の I のようなカーソルを返します。
開いた手のシステムカーソルを返します。
class var operationNotAllowed: NSCursor
許可されていない操作のカーソルを返します。
class var pointingHand: NSCursor
手で示すシステムカーソルを返します。
class var resizeDown: NSCursor
下へのサイズ変更システムカーソルを返します。
class var resizeLeft: NSCursor
左へのサイズ変更システムカーソルを返します。
class var resizeLeftRight: NSCursor
左右へのサイズ変更システムカーソルを返します。
class var resizeRight: NSCursor
右へのサイズ変更システムカーソルを返します。
上へのサイズ変更システムカーソルを返します。
class var resizeUpDown: NSCursor
上下へのサイズ変更システムカーソルを返します。
class var iBeamCursorForVerticalLayout: NSCursor
垂直レイアウトテキストを編集するためのカーソルを返します。
イニシャライザ
関連
以下からの継承
以下への準拠
以下も見よ
カーソル
class NSTrackingArea
ポインタがその領域上にあるときにマウス追跡およびカーソル更新イベントを生成するビューの領域。