IComponentChangeService 인터페이스

정의

네임스페이스:

System.ComponentModel.Design

어셈블리:

System.ComponentModel.TypeConverter.dll

구성 요소를 추가, 변경, 제거하거나 구성 요소의 이름을 바꾸는 이벤트에 대한 이벤트 처리기를 추가하고 제거하는 인터페이스를 제공하며 ComponentChanged 또는 ComponentChanging 이벤트를 발생시키는 메서드를 제공합니다.

public interface IComponentChangeService

예제

다음 예제에서는 인터페이스를 사용하여 IComponentChangeService 디자인 모드에서 구성 요소의 추가, 제거 및 변경 내용에 대한 알림을 받는 방법을 보여 줍니다.

using System;
using System.Data;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Windows.Forms;

/*  This sample illustrates how to use the IComponentChangeService interface 
    to handle component change events.  The ComponentClass control attaches 
    event handlers when it is sited in a document, and displays a message 
    when notification that a component has been added, removed, or changed
    is received from the IComponentChangeService.

    To run this sample, add the ComponentClass control to a Form and
    add, remove, or change components to see the behavior of the
    component change event handlers. */

namespace IComponentChangeServiceExample 
{
    public class ComponentClass : System.Windows.Forms.UserControl 
    {
        private System.ComponentModel.Container components = null;
    private System.Windows.Forms.ListBox listBox1;
    private IComponentChangeService m_changeService;
 
    public ComponentClass() 
    {
        InitializeComponent();
    }

    private void InitializeComponent() 
    {
        this.listBox1 = new System.Windows.Forms.ListBox();
        this.SuspendLayout();

        // listBox1.
        this.listBox1.Location = new System.Drawing.Point(24, 16);
        this.listBox1.Name = "listBox1";
        this.listBox1.Size = new System.Drawing.Size(576, 277);
        this.listBox1.TabIndex = 0;
           
        // ComponentClass.
        this.Controls.AddRange(new System.Windows.Forms.Control[] {this.listBox1});
        this.Name = "ComponentClass";
        this.Size = new System.Drawing.Size(624, 320);

            this.ResumeLayout(false);
    }

    // This override allows the control to register event handlers for IComponentChangeService events
    // at the time the control is sited, which happens only in design mode.
    public override ISite Site 
    {
        get 
        {
        return base.Site;
        }
        set 
        {		
        // Clear any component change event handlers.
        ClearChangeNotifications();		
                
        // Set the new Site value.
        base.Site = value;

        m_changeService = (IComponentChangeService)GetService(typeof(IComponentChangeService));

        // Register event handlers for component change events.
        RegisterChangeNotifications();			
        }
    }

    private void ClearChangeNotifications()
    {
        // The m_changeService value is null when not in design mode, 
        // as the IComponentChangeService is only available at design time.	
        m_changeService = (IComponentChangeService)GetService(typeof(IComponentChangeService));

        // Clear our the component change events to prepare for re-siting.				
        if (m_changeService != null) 
        {
        m_changeService.ComponentChanged -= new ComponentChangedEventHandler(OnComponentChanged);
        m_changeService.ComponentChanging -= new ComponentChangingEventHandler(OnComponentChanging);
        m_changeService.ComponentAdded -= new ComponentEventHandler(OnComponentAdded);
        m_changeService.ComponentAdding -= new ComponentEventHandler(OnComponentAdding);
        m_changeService.ComponentRemoved -= new ComponentEventHandler(OnComponentRemoved);
        m_changeService.ComponentRemoving -= new ComponentEventHandler(OnComponentRemoving);
        m_changeService.ComponentRename -= new ComponentRenameEventHandler(OnComponentRename);
        }
    }

    private void RegisterChangeNotifications()
    {
        // Register the event handlers for the IComponentChangeService events
        if (m_changeService != null) 
        {
        m_changeService.ComponentChanged += new ComponentChangedEventHandler(OnComponentChanged);
        m_changeService.ComponentChanging += new ComponentChangingEventHandler(OnComponentChanging);
        m_changeService.ComponentAdded += new ComponentEventHandler(OnComponentAdded);
        m_changeService.ComponentAdding += new ComponentEventHandler(OnComponentAdding);
        m_changeService.ComponentRemoved += new ComponentEventHandler(OnComponentRemoved);
        m_changeService.ComponentRemoving += new ComponentEventHandler(OnComponentRemoving);
        m_changeService.ComponentRename += new ComponentRenameEventHandler(OnComponentRename);
        }
    }

    /* This method handles the OnComponentChanged event to display a notification. */
    private void OnComponentChanged(object sender, ComponentChangedEventArgs ce) 
    {
        if( ce.Component != null && ((IComponent)ce.Component).Site != null && ce.Member != null ) 
        OnUserChange("The " + ce.Member.Name + " member of the " + ((IComponent)ce.Component).Site.Name + " component has been changed.");
    }

    /* This method handles the OnComponentChanging event to display a notification. */
    private void OnComponentChanging(object sender, ComponentChangingEventArgs ce) 
    {
        if( ce.Component != null && ((IComponent)ce.Component).Site != null && ce.Member != null ) 
        OnUserChange("The " + ce.Member.Name + " member of the " + ((IComponent)ce.Component).Site.Name + " component is being changed.");
    }

    /* This method handles the OnComponentAdded event to display a notification. */
    private void OnComponentAdded(object sender, ComponentEventArgs ce) 
    {			
        OnUserChange("A component, " + ce.Component.Site.Name + ", has been added.");
    }

    /* This method handles the OnComponentAdding event to display a notification. */		
    private void OnComponentAdding(object sender, ComponentEventArgs ce) 
    {			
        OnUserChange("A component of type " + ce.Component.GetType().FullName + " is being added.");
    }

    /* This method handles the OnComponentRemoved event to display a notification. */
    private void OnComponentRemoved(object sender, ComponentEventArgs ce) 
    {
        OnUserChange("A component, " + ce.Component.Site.Name + ", has been removed.");
    }

    /* This method handles the OnComponentRemoving event to display a notification. */
    private void OnComponentRemoving(object sender, ComponentEventArgs ce) 
    {
        OnUserChange("A component, " + ce.Component.Site.Name + ", is being removed.");
    }

    /* This method handles the OnComponentRename event to display a notification. */
    private void OnComponentRename(object sender, ComponentRenameEventArgs ce) 
    {
        OnUserChange("A component, " + ce.OldName + ", was renamed to " + ce.NewName +".");
    }

    // This method adds a specified notification message to the control's listbox.
    private void OnUserChange(string text) 
    {
        listBox1.Items.Add(text);
    }

    // Clean up any resources being used.
    protected override void Dispose( bool disposing ) 
    {
        if( disposing ) 
        {
        ClearChangeNotifications();
            
        if(components != null) 
        {
            components.Dispose();
        }
        }
        base.Dispose( disposing );
    }
    }
}

설명

IComponentChangeService 에서는 다음 이벤트를 처리하는 메서드를 나타내는 데 사용할 수 있는 인터페이스를 제공합니다.

• ComponentAdded구성 요소가 추가될 때 발생합니다.

• ComponentAdding구성 요소를 추가하려고 할 때 발생합니다.

• ComponentChanged구성 요소가 변경될 때 발생합니다.

• ComponentChanging구성 요소를 변경하려고 할 때 발생합니다.

• ComponentRemoved구성 요소가 제거될 때 발생합니다.

• ComponentRemoving구성 요소를 제거하려고 할 때 발생합니다.

• ComponentRename구성 요소의 이름을 바꿀 때 발생합니다.

일반적으로 디자인 환경에서는 이러한 구성 요소 추가, 변경, 제거 또는 이름 바꾸기 이벤트가 발생합니다. 디자이너는 개체를 사용할 DesignerTransaction 때 이 인터페이스의 메서드를 호출하여 구성 요소에 영향을 주는 디자인 타임 작업에 대한 실행 취소 및 다시 실행 기능을 제공해야 합니다. 자세한 내용은 에 대한 DesignerTransaction설명서에서 확인할 수 있습니다. 일반적으로 루트 디자이너만 이러한 변경 알림을 처리합니다.

이 서비스는 구성 요소 변경 이벤트 또는 구성 요소 변경 이벤트를 발생시키는 메서드도 제공합니다. 또는 PropertyDescriptor 구성 요소는 구성 요소가 각각 및 OnComponentChanging 메서드를 사용하여 변경되었거나 변경 OnComponentChanged 되고 있음을 나타낼 수 있습니다.

메서드

OnComponentChanged(Object, MemberDescriptor, Object, Object)	구성 요소 변경 서비스에 특정 구성 요소가 변경되었음을 알립니다.
OnComponentChanging(Object, MemberDescriptor)	구성 요소 변경 서비스에 특정 구성 요소가 변경 중임을 알립니다.

이벤트

ComponentAdded	구성 요소가 추가되면 발생합니다.
ComponentAdding	구성 요소가 추가되는 동안에 발생합니다.
ComponentChanged	구성 요소가 변경되면 발생합니다.
ComponentChanging	구성 요소가 변경되는 동안에 발생합니다.
ComponentRemoved	구성 요소가 제거되면 발생합니다.
ComponentRemoving	구성 요소가 제거되는 동안에 발생합니다.
ComponentRename	구성 요소의 이름을 바꾸면 발생합니다.

적용 대상

추가 정보

• ComponentEventHandler
• ComponentChangedEventHandler
• ComponentChangingEventHandler
• ComponentRenameEventHandler
• MemberDescriptor
• DesignerTransaction