[.NET] C#을 이용한 PropertyGrid 사용법에 대한 Summary

이제 PropertyGrid 컨트롤의 프로퍼트에 이미지 컴보 리스트를 달아보자. 아래의 결과처럼 말이다.
먼저 PropertyGrid의 SelectedObject에 할당될 프로퍼티를 정의할 클래스를 만들어 주어야 한다. 즉 우리가 지금 정의할 클래스에는 위의 그림에서처럼 SourceType이라는 프로퍼티에 대한 정보를 담고 있을 것이다. 아래의 코드가 바로 그 클래스이다. 클래스 명은.. 딱히 지을만한게 없어 개똥이클래스라고 하려다가 그냥 얌전하게 MyProperty라고 이름 붙였다. (C#에서는 클래스명이나 변수명을 한글로 할 수 있다)

public class MyProperty {
    private MyType _type;

    [Editor(typeof(MyPropertyGridEditor), 
            typeof(System.Drawing.Design.UITypeEditor))]
    public MyType SourceType
    {
        get { return _type; }
        set { _type = value; }
    }
}

일단 MyType이라는 새로운 Type이 있는데, 이 Type은 아래와 같다.

public enum MyType { Left, Right, Up, Down };

실제로 PropertyGrid에 나타날 프로퍼티의 값으로 Left, Right, Up, Down이 나타날 것이다. 앞서 언급한 그림을 보기 바란다. 그리고 새롭게 등장한 Attribute 지시자로 Editor가 있는데, 이는 프러퍼티의 값을 변경할 UI Editor를 지정하기 위한 것이며, 인자로 2개를 받는다. 첫번째 인자는 UITypeEditor에서 상속받은, 곧 바로 우리가 새롭게 정의할 클래스명이고, 두번째 인자는 그냥 UITypeEditor 클래스명을 주면된다. 이렇게 Editor 특성자를 프로퍼티에 지정해주면 지정된 프로퍼티에 대한 값을 설정하기 위한 UI가 지정된다. 이 방법은 추후에 새롭게 살펴볼 프로퍼티의 값을 설정하기 위해 사용자 정의 UI를 붙이는 방법과 매우 유사하다.

이제 UITypeEditor에서 상속받아 새롭게 정의한 MyPropertyGridEditor에 대해서 살펴보도록하자.

public class MyPropertyGridEditor : UITypeEditor
{
    public override bool GetPaintValueSupported(
        ITypeDescriptorContext context) {
            return true;
        }

    public override void PaintValue(PaintValueEventArgs e) {
        string m = this.GetType().Module.Name;
        m = m.Substring(0, m.Length - 4);
        ResourceManager resourceManager =
            new ResourceManager(m + ".MyResource", 
                Assembly.GetExecutingAssembly());

        int i = (int)e.Value;
        string sourceName = "";
        switch (i) {
            case ((int)MyType.Left): sourceName = "left"; break;
            case ((int)MyType.Right): sourceName = "right"; break;
            case ((int)MyType.Up): sourceName = "up"; break;
            case ((int)MyType.Down): sourceName = "down"; break;
        }

        Bitmap newImage = (Bitmap)resourceManager.GetObject(sourceName);
        Rectangle destRect = e.Bounds;

        destRect.X = (e.Bounds.Width - newImage.Width) / 2;
        destRect.Y = e.Bounds.Y - 1;
        destRect.Width = newImage.Width;
        destRect.Height = newImage.Height;

        newImage.MakeTransparent();
        e.Graphics.DrawImage(newImage, destRect);
    }
}

제법 길다? -o-; ㅋ

먼저 이 클래스는 두개의 override된 매서드가 있다. 하나는 GetPaintValueSupported이며 또 하나는 PaintValue이다. 이 두개는 종속적인데 GetPaintValueSupported에서 true를 반환하면 PaintValue라는 매서드를 개발자가 override하겠다는 의미이다. 또한 바로 이 PaintValue 매서드에서 컴보 리스트에서 실제로 그림을 그려준다. 만약 GetPaintValueSupported가 false를 반환하면 그림이 없는 단순히 문자만 나타는 컴보 리스트의 형태로 나타난다. 아래의 그림처럼 말이다.
그렇다면 이제 PaintValue 매서드에 대해 집중해보자. 이 매서드는 내용은 이렇다. 먼저 IDE에서 추가한 리소스(MyResource.resx로 지정했음)에 접근할 수 있는 ResourceManager 클래스의 인스턴스를 얻는 코드의 부분이 있는데, 빨강색이 바로 그 코드이다. 아래의 그림을 참조하면 이해하기가 쉬울것이다.

그리고 이렇게 얻은 ResourceManager를 통해 현재 사용 컴보 리스트에 그려질 이미지를 얻어오는 코드가 초록색이다. 끝으로 빨강색 코드는 이렇게 얻어온 이미지를 화면상에 그린다. 그릴 영역은 PaintValue의 인자로 넘어온 PaintValueEventAgrs e를 통해서 얻을 수 있는데, 바로 e.Bounds이다.

음… 바로 지난번에 알아본 문자열에 대한 컴보 리스트 박스를 프로퍼티에 붙이는 것에 비하면 무척 쉽다고 생각한다.

[.NET] C#을 이용한 PropertyGrid 사용법에 대한 Summary

앞서 언급한대로, PropertyGrid에 List 컨트롤을 달아보자. 이 글을 쓰기에 앞서 List 컨트롤을 PropertyGrid에 달아보는 샘플 코드를 작성하면서, 뭐.. “이런 뷁스런”이란 생각이 들었다. 단지 컨트롤 하나 달기 위해 전역 변수이며 새로운 클래스를 2개씩이나 만들어줘야하다니.. .NET에 대한 실망이 쪼끔 인다. 그러나 이 방법말고 좀더 세련된 방법이 있을것이라 생각된다. 한번 시간날때 찾아봐야겠다.

여하튼, 지금 내가 알고 있는 방법을 정리해보자. 먼저 구현할 결과 화면은 다음과 같다.

즉, 우리가 추가할 프로퍼티의 이름은 ItemName이고 이 프로퍼티의 값으로 사과, 귤, 포도, 망고, 딸기을 선택할 수 있는 Combo List 컨트롤이라는 도우미를 붙인 형태를 구현하는 방법이다.

먼저 사과, 귤, 포도 등의 문자열들을 담을 string 배열에 대한 전역 변수를 선언한다.

internal class PropertyItemList
{
    internal static string[] _items;
}

비록 PropertyItemList라는 클래스를 전역변수로써 인스턴스화하지는 않겠지만, 맴버변수로 정적으로 선언함으로써 전역변수의 의미를 갖는다. 이렇게 정적으로 선언하여 전역처럼 쓰는 이유는 앞으로 추가할 2개의 새로운 클래스에서 이 PropertyItemList의 _items 정적변수에 접근해야하기 때문이다. 추가할 2개의 새로운 클래스에 대해서 살펴보기 전에 PropertyItemList의 _items 변수에 문자값들을 넣어주는 코드의 살펴보자.

private void Form1_Load(object sender, EventArgs e)
    {
        MyList listItem = new MyList();

        PropertyItemList._items = new String[5];
        PropertyItemList._items[0] = "사과(Apple)";
        PropertyItemList._items[1] = "귤(Orange)";
        PropertyItemList._items[2] = "포도(Grape)";
        PropertyItemList._items[3] = "망고(Mango)";
        PropertyItemList._items[4] = "딸기(Strawbery)";

        propertyGrid1.SelectedObject = listItem;
}

MyList는 앞으로 추가할 2개의 클래스 중 하나이며, propertyGrid의 SelectedObject 속성에 넣어주게 된다. 이는 이미 앞서 살펴봤으므로 이미 잘알고있을것이다.

이제 새로운게 추가할 두개의 클래스를 하나 하나 만들어 보자. 먼저 이미 나와버린 MyList 클래스이다.

public class MyList {
    private string _itemName;

    [Browsable(true)]
    [TypeConverter(typeof(MyConverter))]
    public string ItemName {
        get {
            string S = "";
            if (_itemName != null) {
                S = _itemName;
            } else {
                S = PropertyItemList._items[0];
            }

            return S;
        }

        set { _itemName = value; }
    }
}

ProperrtGrid에 추가할 프러퍼티인 ItemName을 가지고 있으며 Attribute를 지정하고 있다. 여기서 지정된 Attribute에 대해서 살펴보면, Browsable와 TypeConverter이다. Browsable는 원래 지정하지 않아도 되는데, 기본값으로 true이기 때문이다. 의미그대로 PropertyGrid에 나타낼 것이냐 말것이냐를 정하는 것이다. 그리고 TypeConverter가 바로 우리가 추가한 프로퍼티에 리스트 컨트롤을 달게 하는 역활을 하는 Attribute이다. 즉, TyperConverter의 인자로써 어떤 클래스를 주는데, 바로 이 어떤 클래스를 통해 프로퍼티에 리스트 컨트롤을 달거나 프로퍼티를 사용자가 직접값을 수정하게 하거나 리스트 컨트롤에서 선택만 하게 하거나 등의 특성을 지정하는 것이다. 그렇다면 이제 마지막으로 이 어떤 클래스인 MyConverter에 대해 살펴보자.

public class MyConverter : StringConverter
{
    public override bool GetStandardValuesSupported(
        ITypeDescriptorContext context) {
        return true;
    }

    public override bool GetStandardValuesExclusive(
        ITypeDescriptorContext context) {
	return true;
    }

    public override 
        System.ComponentModel.TypeConverter.StandardValuesCollection
        GetStandardValues(ITypeDescriptorContext context) {
        return new StandardValuesCollection(PropertyItemList._items);
    }
}

다소, 뷁스러운 클래스라고 생각하는데, 이 하나의 클래스에서 생전보도 못한 .NET 클래스가 참 많이도 나오기 때문이다. 다 집어치우고 필요한 것만 골라 따져보면, 먼저 override한 GetStandardValuesSupported에서 true를 반환해야만 Combo List 컨트롤을 볼수가 있으며 false를 반환하면 우리의 노력은 물거품이 되고 만다. 그리고 GetStandardValuesExclusive라는 매서드의 반환값을 true로 하면 단시 List에서 선택만 할 수 있고 키보드로 문자열값을 변경할 수 없게된다. 마지막으로 GetStandardValues는 List 컨트롤에 나열된 문자열값을 지정해주기 위한 매서드이다.

필자는 “뭔가 잘못된 것 같다”라는 생각이 들었다. 단지 컴보 리스트 컨트롤 하나 추가하기 위한 과정이 이처럼 복잡하다는 이유에서가 아니라, 반드시 전역변수를 선언해야만(여기서는 같은 효과를 위해 정적변수를 선언했다) 한다는 것에서였다. 이 문제는 차츰 해결될 것이라고 생각된다.

끝으로 Blog에 어제부터 google의 AdSense를 달아놨는데.. 이 글이 도움이 되셨다면 댓글말고, 옆에 AdSense 클릭 좀 해주시길~ 댓글은 쓰기 힘드실까봐~ ㅋ –;;