Добавление информации о свойствах

Программная реализация компоненты.

Для того, чтобы сделать в новой компоненте градиентную заливку добавим в нее два свойства StartColor и EndColor, которые будут соответствовать цветам начала и завершения градиента, и переопределим метод OnPaint (), внутри которого будем рисовать градиентную заливку (листинг 5.1). По умолчанию заливка будет переходить от ярко-зеленого (Light Green) к темно-синему (Dark Blue) цвету. Результат показан на рис.5.3.

Класс GradientLabel станет нашим базовым проектом, с помощью которого мы будем изучать средства времени разработки.

//Листинг 5.1. Класс GradientLabel.

using System;

using System.Collections.Generic;

using System.ComponentModel;

using System.Drawing;

using System.Drawing.Drawing2D;

using System.Data;

using System.Text;

using System.Windows.Forms;

namespace MyControl

{

public partial class GradientLabel: Label

{

private Color startColor = Color.LightGreen;

private Color endColor = Color.DarkBlue;

public GradientLabel(){ InitializeComponent(); }

public Color StartColor

{

get{ return startColor; }

set{ startColor = value; }

}

public Color EndColor

{

get{ return endColor; }

set{ endColor = value; }

}

protected override void OnPaint(PaintEventArgs pe)

{

Base.OnPaint(pe); // Вызываем базовый метод OnPaint()

Color c1 = Color.FromArgb(100, startColor);

Color c2 = Color.FromArgb(100, endColor);

Brush b = new LinearGradientBrush(ClientRectangle, c1, c2, 10);

pe.Graphics.FillRectangle(b, ClientRectangle);

b.Dispose();

}

}

}

Откроем окно свойств нашего компонента (например, с помощью меню Property по щелчку правой кнопки мыши). Как видно из рис.5.4, два наших новых свойства видны в списке, но, к сожалению, совершенно не информативны.

Рис.5.4. Пока новые свойства не информативны.

Добавить информацию о свойствах позволяют специальные атрибуты Category и Description.

Атрибут Category определяет название категории, к которой относится свойство. Если он не указан, то свойство считается относящимся к категории Misc. Для объединения свойств по категориям надо нажать самую левую кнопку в окне редактора свойств.

Атрибут Description позволяет задать некоторое строковое описание, которое будет давать представление о свойстве и его назначении.

Пример описания информации о свойствах показан в листинге 5.2, а результат – в окне свойств с информацией на рис.5.5.

Рис.5.5. Теперь свойство имеет текстовое описание и категорию "Gradient".

Листинг 5.2. Добавление информации о свойствах.

[Category("Gradient"), Description("Цвет начала заливки")]

public Color StartColor

{

get{ return startColor; }

set{ startColor = value; }

}

[Category("Gradient"), Description("Цвет завершения заливки")]

public Color EndColor

{

get{ return endColor; }

set{ endColor = value; }

}

Дата добавления: 2015-07-02