Симон Робинсон - C# для профессионалов. Том II

□ DefaultValue— значение по умолчанию для свойства.

Представление свойств в таком виде работает точно таким же образом, как и для специальных элементов управления, и определенно предпочтительно по отношению к представлению открытых полей.

Остальная часть класса состоит из метода Render(). Это единственный самый важный метод для реализации при создании специальных элементов управления, так как в нем мы получаем доступ к потоку вывода для изображения содержимого элемента управления. Существует только два случая, когда этот метод не нужно реализовывать:

□ Когда создается элемент управления, не имеющий визуального представления (обычно называемый компонентом).

□ Когда создается производный элемент из существующего элемента управления и не требуется изменять характеристики его изображения.

Специальные элементы управления могут также предоставлять специальные методы, инициировать специальные события, и отвечать производным элементам управления (если они существуют). Ниже мы рассмотрим:

□ Создание производных элементов управления

□ Создание композитных элементов управления

□ Создание более развитых элементов управления

Конечный пример будет элементом управления выбором, который разрешает пользователю голосовать за одну из нескольких возможностей, и выводить графически результаты голосования. Варианты выбора будут определяться с помощью вложенных элементов управления потомков способом, описанным ранее.

Создадим для начала простой производный элемент управления.

Для этого первого примера создадим производный элемент управления из элемента управления Labelи переопределим его метод Render()для вывода многоцветного текста. Чтобы держать элементы управления примера в этой главе отдельно, создадим новые файлы исходного кода, поэтому для этого элемента управления создадим новый файл .csс именем RainbowLabel.csи введем в него следующий код:

namespace PCSCustomWebControls {

using System;

using System.Web.UI;

using System.Web.UI.WebControls;

using System.ComponentModel;

using System.Drawing;

public class RainbowLabel : System.Web.UI.WebControls.Label {

private Color[] colors = new Color[] {

Color.Red, Color.Orange, Color.Yellow,

Color.GreenYellow, Color.Blue, Color.Indigo, Color.Violet

};

protected override void Render(HtmlTextWriter output) {

string text=Text;

for (int pos=0; pos < text.Length; pos++) {

int rgb = colors[pos % 7].ToArgb() & 0xFFFFFF;

output.Write("

" width= '90%' cellpadding='1' cellspacing='1'" + " align='center'>");

writer.Write("

if (Controls.Count == 0) {

// текст по умолчанию, когда нет вариантов выбора

writer.Write("

} else {

// Получить общее число голосов

for (int iLoop = 0; iLoop < Controls.Count; iLoop++) {

// Получить вариант выбора

currentOption = (Option)Controls[iLoop];

// Просуммировать результаты голосования

iTotalVotes += currentOption.Votes;

}

// Вывести каждый вариант выбора

for (int iLoop = 0; iLoop < Controls.Count; iLoop++) {

// Получить вариант выбора

currentOption = (Option)Controls[iLoop];

// Поместить имя варианта выбора в первый столбец

writer.Write("

// Добавить вариант голосования во второй столбец,

// если требуется

if (currentPollStyle != pollStyle.valuesonly) {

writer.Write("

}

// Поместить график, значение и проценты в третьем столбце,

// если требуется

if (currentPollStyle != pollStyle.voteonly) {

if (iTotalVotes > 0) {

iPercentage = (currentOption.Votes * 100) / iTotalVotes;

} else {

iPercentage = 0;

}

writer.Write("<���ТD bgcolor='#FFFFDD'>

+ "

writer.Write("

}

// Конец строки

writer.Write("");

}

// показать общее тело голосов, если выводятся значения

if (currentPollStyle != pollStyle.voteonly) {

writer.Write("

}

}

// Завершить таблицу

writer.Write("

}

Если выборочный опрос выводится в режиме voteonly, то голосование должно инициировать изменение изображения в режиме valuesonly. Чтобы сделать это, нам потребуется небольшое изменение в обработчике кнопки голосования в классе Option:

protected void btnVote_Click(object sender, System.EventArgs e) {

Increment();

StrawPoll parent = (StrawPoll)Parent;

if (parent.PollStyle == pollStyle.voteonly) {

parent.PollStyle = pollStyle.valuesonly;

}

}

Теперь все готово к проведению голосования.

Часто при использовании специальных элементов управления желательно инициировать специальные события и предоставить пользователям элемента управления действовать в соответствии с этим. В случае элемента управления выборочного опроса было бы хорошо иметь событие Voted, которое будет уведомлять форму, что голосование выполнено, и предоставлять ей всю информацию, необходимую для действия в этом случае.

Чтобы зарегистрировать специальное событие, надо добавить в элемент управления код, аналогичный представленному ниже:

public event EventHandler Voted;

protected void OnVoted(EventArgs e) {

Voted(this, e);

}

Тогда, как только нам понадобиться инициировать событие, мы просто вызываем метод OnVoted(), передавая аргументы события.

Когда вызывается OnVoted(), инициируется событие, в соответствии с которым может действовать пользователь. Чтобы сделать это, пользователю необходимо зарегистрировать обработчик событий для этого события:

strawPoll1.Voted += new EventHandler(this.StrawPoll1_OnVoted);

Пользователь должен также предоставить код обработчика strawPoll1_OnVoted(). Мы слегка расширим этот метод, добавляя специальные аргументы для события, чтобы сделать доступным элемент управления Option, который инициирует событие. Назовем наш объект специального аргумента OptionEventArgsи определим его в StrawPoll.csследующим образом:

public class OptionEventArgs : EventArgs {

public Option originatingOption;

}

Добавляем дополнительное открытое поле в существующий класс EventArgs. Так как мы изменили используемые аргументы, нам потребуется также специализированная версия представителя EventHandler, которая может объявляться в пространстве имен PCSCustomWebControlsследующим образом: