Glyph.GetHitTest メソッド

.NET Framework クラス ライブラリ リファレンス

Glyph.GetHitTest メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ヒット テストのロジックを提供します。

名前空間: System.Windows.Forms.Design.Behavior
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 GetHitTest ( _
    p As Point _
) As Cursor

Visual Basic (使用法)

Dim instance As Glyph
Dim p As Point
Dim returnValue As Cursor

returnValue = instance.GetHitTest(p)

C#

public abstract Cursor GetHitTest (
    Point p
)

C++

public:
virtual Cursor^ GetHitTest (
    Point p
) abstract

J#

public abstract Cursor GetHitTest (
    Point p
)

JScript

public abstract function GetHitTest (
    p : Point
) : Cursor

パラメータ

p

ヒット テストを行うポイント。

戻り値
Glyph が p に関連付けられている場合は Cursor。それ以外の場合は null 参照 (Visual Basic では Nothing)。

解説

GetHitTest メソッドは、ヒット テスト ロジックを提供するための Glyph が実装された abstract メソッドです。任意のポイントを指定したときに、Glyph がその位置に置かれるように設定されている場合は、有効な Cursor を返す必要があります。それ以外の場合は null 参照 (Visual Basic では Nothing) が返され、BehaviorService はその位置を無視します。

使用例

GetHitTest をオーバーライドしてポイントがこのグリフ内にあるかどうか調べる方法を次の例に示します。このコード例は、BehaviorService クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Public Overrides Function
 GetHitTest(ByVal p As Point) As
 Cursor
    ' GetHitTest is called to see if the point is
    ' within this glyph.  This gives us a chance to decide
    ' what cursor to show.  Returning null from here means
    ' the mouse pointer is not currently inside of the glyph.
    ' Returning a valid cursor here indicates the pointer is
    ' inside the glyph,and also enables our Behavior property
    ' as the active behavior.
    If Bounds.Contains(p) Then
        Return Cursors.Hand
    End If

    Return Nothing

End Function

C#

public override Cursor GetHitTest(Point p)
{
    // GetHitTest is called to see if the point is
    // within this glyph.  This gives us a chance to decide
    // what cursor to show.  Returning null from here means
    // the mouse pointer is not currently inside of the glyph.
    // Returning a valid cursor here indicates the pointer is
    // inside the glyph, and also enables our Behavior property
    // as the active behavior.
    if (Bounds.Contains(p))
    {
        return Cursors.Hand;
    }

    return null;
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Glyph クラス
Glyph メンバ
System.Windows.Forms.Design.Behavior 名前空間
Behavior クラス
Adorner クラス
BehaviorService クラス
Cursor
その他の技術情報
方法 : デザイン モードでコントロールの外観と動作を拡張する