Пошаговое руководство. Программирование событий элемента управления NamedRange

в этом пошаговом руководстве показано, как добавить NamedRange элемент управления в Microsoft Office Excel лист и программировать его события с помощью Office средств разработки Visual Studio.

Применимость. Информация в этой статье относится к проектам уровня документа для Excel.- Дополнительные сведения см. в разделе доступность функций по типам приложений Office и проектов.

В этом пошаговом руководстве описаны следующие процедуры.

Добавление NamedRange элемента управления на лист.

Программа по отношению к NamedRange событиям управления.

Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в следующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Персонализация интегрированной среды разработки Visual Studio.

Предварительные требования

Для выполнения этого пошагового руководства требуются следующие компоненты:

Выпуск Visual Studio, включающий инструменты разработчика Microsoft Office. Дополнительные сведения см. в статье Настройка компьютера для разработки решений Office.

Excel 2013 или Excel 2010.

Создание проекта

на этом шаге вы создадите Excel проект книги с помощью Visual Studio.

создайте Excel проект книги с именем мои события именованного диапазона. Убедитесь, что выбрано Создание нового документа . дополнительные сведения см. в разделе инструкции. создание проектов Office в Visual Studio.

Visual Studio открывает новую книгу Excel в конструкторе и добавляет в обозреватель решений проект " мои события именованного диапазона ".

Добавление в лист текста и именованных диапазонов

так как элементы управления ведущего приложения являются расширенными Office объектами, их можно добавить в документ так же, как и при добавлении собственного объекта. например, можно добавить NamedRange элемент управления Excel на лист, открыв меню вставка , указав имя и выбрав команду определить. Можно также добавить NamedRange элемент управления, перетащив его с панели элементов на лист.

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

убедитесь, что книга мой именованный диапазон Events.xlsx открыта в конструкторе Visual Studio и Sheet1 отображается.

с вкладки элементы управления Excel панели элементов перетащите NamedRange элемент управления в ячейку A1 в Sheet1 .

Откроется диалоговое окно Добавление элемента управления NamedRange .

Убедитесь, что в редактируемом текстовом поле отображается $A $1 и выбрана ячейка a1 . Если это не так, щелкните ячейку a1 , чтобы выбрать ее.

Нажмите кнопку ОК.

Ячейка a1 преобразуется в диапазон с именем namedRange1 . На листе нет видимых индикаторов, но оно namedRange1 отображается в поле имя (расположено прямо над листом слева), если выбрана ячейка a1 .

Добавьте еще один NamedRange элемент управления в ячейку B3.

Убедитесь, что в редактируемом текстовом поле отображается $B $3 и выбрана ячейка B3 . Если это не так, щелкните ячейку B3 , чтобы выбрать ее.

Нажмите кнопку ОК.

Ячейка B3 преобразуется в диапазон с именем namedRange2 .

В ячейке a1 введите следующий текст:

Это пример элемента управления NamedRange.

В ячейке a3 (слева от namedRange2 ) введите следующий текст:

Событиях

В следующих разделах будет написан код, который вставляет текст в namedRange2 и изменяет свойства namedRange2 элемента управления в ответ на BeforeDoubleClick Change события, и SelectionChange namedRange1 .

Добавление кода для реагирования на событие Бефоредаублекликк

В Обозреватель решений щелкните правой кнопкой мыши Лист1. vb или Sheet1. CS и выберите Просмотреть код.

Добавьте код, чтобы namedRange1_BeforeDoubleClick обработчик событий выглядел следующим образом:

В C# необходимо добавить обработчики событий для именованного диапазона, как показано в приведенном Startup ниже событии. сведения о создании обработчиков событий см. в разделе инструкции. создание обработчиков событий в Office проектах.

Добавление кода для реагирования на событие изменения

Добавьте код, чтобы NamedRange1_Change обработчик событий выглядел следующим образом:

поскольку двойной щелчок по ячейке в диапазоне Excel переходит в режим правки, Change событие возникает, когда выделение перемещается за пределы диапазона, даже если изменения текста не происходили.

Добавление кода для реагирования на Событие SelectionChange

Добавьте код, чтобы обработчик событий NamedRange1_SelectionChange выглядел следующим образом:

поскольку двойной щелчок по ячейке в диапазоне Excel приводит к перемещению выделения в диапазон, SelectionChange событие возникает до BeforeDoubleClick возникновения события.

Тестирование приложения

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

Нажмите клавишу F5 для запуска проекта.

Поместите курсор в namedRange1 и убедитесь, что текст, относящийся к SelectionChange событию, вставлен и комментарий вставлен в лист.

Дважды щелкните внутри namedRange1 и убедитесь, что текст, относящийся BeforeDoubleClick к событиям, вставлен с помощью красного курсивного текста в namedRange2 .

Щелкните за пределами namedRange1 и обратите внимание, что событие Change возникает при выходе из режима редактирования, даже если в тексте не было внесено никаких изменений.

Измените текст в namedRange1 .

Щелкните вне namedRange1 и убедитесь, что текст, относящийся к Change событию, вставлен синим текстом в namedRange2 .

Дальнейшие действия

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