Glyph

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

Glyph クラス

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

Adorner によって管理される単一のユーザー インターフェイス (UI) エンティティを表します。

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

Visual Basic (宣言)

Public MustInherit Class
 Glyph

Visual Basic (使用法)

Dim instance As Glyph

C#

public abstract class Glyph

C++

public ref class Glyph abstract

J#

public abstract class Glyph

JScript

public abstract class Glyph

解説

Glyph は描画とヒット テストだけを目的としています。Glyph は、BehaviorService の装飾ウィンドウ コントロール上にレンダリングされるため、ウィンドウ ハンドル (HWND) はありません。それぞれの Glyph が、関連付けられた Behavior を持つことができます。ヒット テストの結果が正常だった Glyph では、新規または異なる Behavior を BehaviorService の動作スタックにプッシュできます。

詳細については、「動作サービスの概要」を参照してください。

使用例

関連付けられた Behavior を使用して独自の Glyph 基本クラスを作成する方法を次の例に示します。このコード例は、BehaviorService クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Class MyGlyph
    Inherits Glyph
    Private control As Control
    Private behaviorSvc As _
        System.Windows.Forms.Design.Behavior.BehaviorService

    Public Sub New(ByVal
 behaviorSvc As _
        System.Windows.Forms.Design.Behavior.BehaviorService, _
        ByVal control As Control)

        MyBase.New(New MyBehavior())
        Me.behaviorSvc = behaviorSvc
        Me.control = control
    End Sub

    Public Overrides ReadOnly
 Property Bounds() As Rectangle
        Get
            ' Create a glyph that is 10x10 and sitting
            ' in the middle of the control.  Glyph coordinates
            ' are in adorner window coordinates, so we must map
            ' using the behavior service.
            Dim edge As Point = behaviorSvc.ControlToAdornerWindow(control)
            Dim size As Size = control.Size
            Dim center As New
 Point(edge.X + size.Width / 2, edge.Y + _
                size.Height / 2)

            Dim bounds1 As New
 Rectangle(center.X - 5, center.Y - 5, 10, 10)

            Return bounds1
        End Get
    End Property

    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


    Public Overrides Sub
 Paint(ByVal pe As PaintEventArgs)
        ' Draw our glyph.  It is simply a blue ellipse.
        pe.Graphics.FillEllipse(Brushes.Blue, Bounds)

    End Sub

    ' By providing our own behavior we can do something interesting
    ' when the user clicks or manipulates our glyph.

    Class MyBehavior
        Inherits System.Windows.Forms.Design.Behavior.Behavior

        Public Overrides Function
 OnMouseUp(ByVal g As Glyph, _
            ByVal button As MouseButtons) As
 Boolean
            MessageBox.Show("Hey, you clicked the mouse here")
            Return True
            ' indicating we processed this event.
        End Function 'OnMouseUp
    End Class

End Class

C#

class MyGlyph : Glyph
{
    Control control;
    BehaviorService behaviorSvc;

    public MyGlyph(BehaviorService behaviorSvc, Control control)
 : 
        base(new MyBehavior())
    {
        this.behaviorSvc = behaviorSvc;
        this.control = control;
    }

    public override Rectangle Bounds
    {
        get
        {
            // Create a glyph that is 10x10 and sitting
            // in the middle of the control.  Glyph coordinates
            // are in adorner window coordinates, so we must map
            // using the behavior service.
            Point edge = behaviorSvc.ControlToAdornerWindow(control);
            Size size = control.Size;
            Point center = new Point(edge.X + (size.Width / 2),
 
                edge.Y + (size.Height / 2));

            Rectangle bounds = new Rectangle(
                center.X - 5,
                center.Y - 5,
                10,
                10);

            return bounds;
        }
    }

    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;
    }

    public override void Paint(PaintEventArgs
 pe)
    {
        // Draw our glyph. It is simply a blue ellipse.
        pe.Graphics.FillEllipse(Brushes.Blue, Bounds);
    }

    // By providing our own behavior we can do something interesting
    // when the user clicks or manipulates our glyph.
    class MyBehavior : Behavior
    {
        public override bool OnMouseUp(Glyph
 g, MouseButtons button)
        {
            MessageBox.Show("Hey, you clicked the mouse here");
            return true; // indicating
 we processed this event.
        }
    }
}

継承階層

System.Object
  System.Windows.Forms.Design.Behavior.Glyph
     System.Windows.Forms.Design.Behavior.ComponentGlyph

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 メンバ
System.Windows.Forms.Design.Behavior 名前空間
Behavior クラス
Adorner クラス
BehaviorService クラス
その他の技術情報
方法 : デザイン モードでコントロールの外観と動作を拡張する
動作サービスの概要

Glyph コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

Glyph クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New ( _
    behavior As Behavior _
)

Visual Basic (使用法)

Dim behavior As Behavior

Dim instance As New Glyph(behavior)

C#

protected Glyph (
    Behavior behavior
)

C++

protected:
Glyph (
    Behavior^ behavior
)

J#

protected Glyph (
    Behavior behavior
)

JScript

protected function Glyph (
    behavior : Behavior
)

パラメータ

behavior

Glyph に関連付けられている Behavior。null 参照 (Visual Basic では Nothing) でもかまいません。

使用例

Glyph クラスの新しいインスタンスを初期化する方法を次の例に示します。このコード例は、BehaviorService クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

myAdorner = New Adorner()
BehaviorService.Adorners.Add(myAdorner)
myAdorner.Glyphs.Add(New MyGlyph(BehaviorService, Control))

C#

myAdorner = new Adorner();
BehaviorService.Adorners.Add(myAdorner);
myAdorner.Glyphs.Add(new MyGlyph(BehaviorService, Control));

.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 クラス
その他の技術情報
方法 : デザイン モードでコントロールの外観と動作を拡張する

Glyph プロパティ

パブリック プロパティ

	名前	説明
	Behavior	Glyph に関連付けられている Behavior を取得します。
	Bounds	Glyph の範囲を取得します。

参照

関連項目

Glyph クラス
System.Windows.Forms.Design.Behavior 名前空間
Behavior クラス
Adorner クラス
BehaviorService クラス

その他の技術情報

方法 : デザイン モードでコントロールの外観と動作を拡張する
動作サービスの概要

Glyph メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetHitTest	ヒット テストのロジックを提供します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Paint	描画ロジックを提供します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	SetBehavior	Glyph に関連付けられている Behavior を変更します。

参照

関連項目

Glyph クラス
System.Windows.Forms.Design.Behavior 名前空間
Behavior クラス
Adorner クラス
BehaviorService クラス

その他の技術情報

方法 : デザイン モードでコントロールの外観と動作を拡張する
動作サービスの概要

Glyph メンバ

Adorner によって管理される単一のユーザー インターフェイス (UI) エンティティを表します。

Glyph データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	Glyph	Glyph クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Behavior	Glyph に関連付けられている Behavior を取得します。
	Bounds	Glyph の範囲を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetHitTest	ヒット テストのロジックを提供します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Paint	描画ロジックを提供します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	SetBehavior	Glyph に関連付けられている Behavior を変更します。

参照

関連項目

Glyph クラス
System.Windows.Forms.Design.Behavior 名前空間
Behavior クラス
Adorner クラス
BehaviorService クラス

その他の技術情報

方法 : デザイン モードでコントロールの外観と動作を拡張する
動作サービスの概要