BehaviorService Sınıf

Tanım

Ad Alanı:

System.Windows.Forms.Design.Behavior

Bütünleştirilmiş Kod:

System.Windows.Forms.Design.dll

Kaynak:

BehaviorService.cs

Tasarımcıdaki kullanıcı arabirimini yönetir. Bu sınıf devralınamaz.

C#

public sealed class BehaviorService : IDisposable

Devralma

Object

BehaviorService

Uygulamalar

IDisposable

Örnekler

Aşağıdaki kod örneği, kullanıcı tıklamalarına yanıt veren kendi Behavior tabanlı sınıfınızı oluşturmayı gösterir.

C#

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Windows.Forms;
using System.Text;
using System.Windows.Forms.Design;
using System.Windows.Forms.Design.Behavior;

namespace BehaviorServiceSample
{
    class Form1 : Form
    {
        private UserControl1 userControl;

        public Form1()
        {
            InitializeComponent();
        }

        private System.ComponentModel.IContainer components = null;

        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        private void InitializeComponent()
        {
            this.userControl = new BehaviorServiceSample.UserControl1();
            this.SuspendLayout();

            this.userControl.Location = new System.Drawing.Point(12, 13);
            this.userControl.Name = "userControl";
            this.userControl.Size = new System.Drawing.Size(143, 110);
            this.userControl.TabIndex = 0;
            
            this.ClientSize = new System.Drawing.Size(184, 153);
            this.Controls.Add(this.userControl);
            this.Name = "Form1";
            this.Text = "Form1";
            this.ResumeLayout(false);
        }

        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }
    }

    [Designer(typeof(MyDesigner))]
    public class UserControl1 : UserControl
    {
        private System.ComponentModel.IContainer components = null;

        public UserControl1()
        {
            InitializeComponent();
        }

        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        private void InitializeComponent()
        {
            this.Name = "UserControl1";
            this.Size = new System.Drawing.Size(170, 156);
        }
    }

    class MyDesigner : ControlDesigner
    {
        private Adorner myAdorner;

        protected override void Dispose(bool disposing)
        {
            if (disposing && myAdorner != null)
            {
                BehaviorService b = BehaviorService;
                if (b != null)
                {
                    b.Adorners.Remove(myAdorner);
                }
            }
        }

        public override void Initialize(IComponent component)
        {
            base.Initialize(component);

            // Add the custom set of glyphs using the BehaviorService. 
            // Glyphs live on adornders.
            myAdorner = new Adorner();
            BehaviorService.Adorners.Add(myAdorner);
            myAdorner.Glyphs.Add(new MyGlyph(BehaviorService, Control));
        }
    }

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

Açıklamalar

BehaviorService oluşturulduğunda, tasarımcı çerçevesinin üzerine saydam bir pencere ekler. BehaviorService daha sonra bu pencereyi kullanarak nesneler olarak adlandırılan Glyph kullanıcı arabirimi öğelerini işleyebilir ve tüm fare iletilerini yakalayabilir. Bu şekilde, BehaviorService tasarımcı davranışını denetleyebilirsiniz.

BehaviorService sınıfı, nesnelerin gönderilebileceği Behavior bir davranış yığınını destekler. Saydam pencere aracılığıyla bir ileti kesildiğinde, BehaviorService iletiyi yığının en üstündekine Behavior gönderebilir. Bu, şu anda gönderilen Behavioröğesine bağlı olarak farklı kullanıcı arabirimi modlarını etkinleştirir. BehaviorService, seçim kenarlıkları, boyutlandırma tutamaçları ve akıllı etiketler gibi tüm Glyph nesneleri işlemek için kullanılır. , BehaviorService ek çizgi kullanma, sürükleme ve seçme gibi birçok tasarım zamanı davranışını da denetler.

Daha fazla bilgi için bkz . Davranış Hizmetine Genel Bakış.

Özellikler

Adorners	BehaviorServiceAdornerCollection öğesini alır.
AdornerWindowGraphics	Graphics Donatıcı penceresinin öğesini alır.
CurrentBehavior	Behavior Davranış yığınını kaldırmadan üst kısmındaki öğesini alır.

Yöntemler

AdornerWindowPointToScreen(Point)	Donatıcı penceresindeki bir Point öğesini ekran koordinatlarına çevirir.
AdornerWindowToScreen()	Ekran koordinatlarında donatıcı penceresinin konumunu alır.
ControlRectInAdornerWindow(Control)	bir Controlöğesinin sınırlayıcısını Rectangle döndürür.
ControlToAdornerWindow(Control)	Donatıcı penceresi koordinatlarına çevrilmiş bir Control konumu döndürür.
Dispose()	BehaviorService tarafından kullanılan tüm kaynakları serbest bırakır.
GetNextBehavior(Behavior)	Behavior Davranış yığınında verilenden Behavior hemen sonrasını döndürür.
Invalidate()	öğesinin donatıcı penceresini BehaviorServicegeçersiz kılın.
Invalidate(Rectangle)	Donatıcı penceresinde belirtilen alanı geçersiz kılınır BehaviorService.
Invalidate(Region)	Donatıcı penceresinde belirtilen alanı geçersiz kılınır BehaviorService.
MapAdornerWindowPoint(IntPtr, Point)	Tanıtıcının koordinat sistemindeki bir noktayı donatıcı penceresi koordinatlarına dönüştürür.
PopBehavior(Behavior)	Yığının Behavior en üstündeki öğesini kaldırır ve döndürür.
PushBehavior(Behavior)	Davranış yığınına bir Behavior iter.
PushCaptureBehavior(Behavior)	Davranış yığınına bir Behavior iter ve davranışa fare yakalaması atar.
ScreenToAdornerWindow(Point)	Ekran koordinatlarındaki bir noktayı öğesinin donatıcı penceresi koordinatlarına BehaviorServiceçevirir.
SyncSelection()	Tüm seçim karakterlerini eşitler.

Ekinlikler

BeginDrag	BehaviorService Sürükle ve bırak işlemi başlatıldığında gerçekleşir.
EndDrag	BehaviorService Bir sürükleme işlemi tamamlandığında gerçekleşir.
Synchronize	Geçerli seçimin yenilenmesi gerektiğinde gerçekleşir.

Şunlara uygulanır

Ayrıca bkz.

• Behavior
• Glyph
• Adorner
• Nasıl yapılır: Tasarım Modunda Denetimlerin Görünüşü ve Davranışını Genişletme
• Davranış Hizmetine Genel Bakış