Vba excel закомментировать несколько строк

Обновлено: 20.11.2024

При чтении примеров кода вы часто встречаете символ комментария ( ' ). Этот символ указывает компилятору Visual Basic игнорировать следующий за ним текст или комментарий. Комментарии – это краткие пояснительные примечания, добавляемые к коду для удобства тех, кто его читает.

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

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

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

Правила комментирования

В следующей таблице приведены общие рекомендации относительно того, какие типы комментариев могут предшествовать разделу кода. Это предложения; Visual Basic не применяет правила для добавления комментариев. Пишите то, что лучше всего работает как для вас, так и для всех, кто читает ваш код.

< td>Описывает, что делает процедура (а не как она это делает)

Тип комментария	Описание комментария
Цель
Предположения	Перечисляет каждую внешнюю переменную, элемент управления, открытый файл или другой доступный элемент по процедуре
Эффекты	Перечисляет каждую затрагиваемую внешнюю переменную, элемент управления или файл и эффект, который они оказывают (только если он не очевиден)< /td>
Входные данные	Указывает цель аргумента
Возвращает	Объясняет значения, возвращаемые процедурой

Помните следующие моменты:

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

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

Комментарии не могут следовать последовательности продолжения строки на той же строке.

Вы можете добавить или удалить символы комментария для блока кода, выделив одну или несколько строк кода и нажав кнопки «Комментировать» () и «Раскомментировать» () на панели инструментов «Правка».

Вы также можете добавить комментарии к своему коду, поставив перед текстом ключевое слово REM. Однако символ ' и кнопки Комментировать/Раскомментировать проще в использовании и требуют меньше места и памяти.

Как только вы начнете писать коды VBA, вам нужно будет усвоить еще одну важную вещь, а именно использование КОММЕНТАРИЙ в своих кодах VBA.

Дело в том, что использовать VBA COMMENT довольно легко и просто, единственное, чему вам нужно научиться, это делать это эффективно.

Итак, сегодня я поделюсь с вами всеми подробностями об использовании комментариев в VBA и обо всех связанных с ними параметрах.

Что такое комментарий VBA

КОММЕНТАРИЙ VBA – это зеленая строка текста, помогающая описать написанный код. Проще говоря, комментарий — это строка текста, которая не является кодом, и VBA игнорирует ее при выполнении кода. Это хорошая практика (даже я бы сказал, одна из лучших) добавлять комментарии в ваши коды VBA.

Преимущества использования комментариев

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

Добавить комментарий в код VBA

Что нужно сделать, чтобы добавить комментарий в код VBA:

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

В тот момент, когда вы это сделаете, вся строка кода станет зеленой, что означает, что эта строка теперь является комментарием.

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

Поэтому вам просто нужно добавить апостроф, прежде чем превратить его в комментарий, и VBA проигнорирует его при выполнении кода.

Используйте кнопку "Комментировать/Раскомментировать" на панели инструментов

Второй способ заключается в использовании кнопки блока комментариев на панели инструментов. Эта кнопка просто добавляет апостроф в начале строки.

Итак, чтобы использовать эту кнопку, прежде всего, вам нужно выделить строку кода, а затем нажать на кнопку.

Рядом с кнопкой «Комментарий» есть еще одна кнопка «Раскомментировать», с помощью которой можно раскомментировать строку (эта кнопка просто удаляет апостроф из строки кода).

Введите многострочный комментарий VBA

Возможна ситуация, когда вам нужно ввести комментарий в несколько строк, например блок комментариев.

Но вот что вам нужно отметить: каждая строка комментария должна начинаться с апострофа, поэтому, если вы хотите добавить несколько строк комментариев, каждая строка должна иметь апостроф.

Самый простой способ — выделить все строки, а затем использовать кнопку комментариев на панели инструментов или добавить апостроф в начале каждой строки.

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

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

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

Используйте ключевое слово «REM» для вставки комментария в VBA

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

REM означает примечания.

Комментарии при записи макроса с помощью Macro Recorder

Когда вы записываете код макроса с помощью средства записи макросов, вы можете добавить описание перед его записью.

Поэтому, когда вы открываете диалоговое окно записи макроса, появляется поле ввода «Описание», в котором вы можете добавить свой комментарий, а затем начать запись.

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

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

Введите комментарий в той же строке

Это довольно умный способ использовать комментарий в той же строке, где вы написали код.

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

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

Сочетание клавиш для добавления комментария

На самом деле нет (по умолчанию сочетание клавиш) для вставки комментария. Но благодаря Gaurav я нашел способ создать горячую клавишу для вставки апострофа.

Выполните следующие шаги:

Теперь вы можете преобразовать строку в комментарий с помощью сочетания клавиш Alt + C.

И если вы хотите создать сочетание клавиш для кнопки раскомментирования, вы можете просто использовать описанные выше шаги, чтобы добавить кнопку раскомментирования на панель инструментов, и сочетание клавиш для нее будет Alt + U.

Изменить формат комментария

VBA дает вам возможность изменить формат комментария, если вы хотите это сделать. В меню Инструменты ➜ Параметры ➜ Формат редактора щелкните текст комментария.

Как видите, я изменил цвет текста комментария с зеленого на синий. Теперь все комментарии, которые у меня есть в окне кода, окрашены в синий цвет.

Это один из самых частых вопросов, которые задают разработчики, начинающие изучать VBA. Как в VBA сразу прокомментировать блок строк? Блоки комментариев – это фундаментальная функция любого языка программирования, но по умолчанию в VBA она не включена.

Чтобы включить блоки комментариев VBA, необходимо настроить редактор Visual Basic (VBE).

Включение панели редактирования VBA

Откройте редактор Visual Basic (Alt+F11)
Нажмите "Просмотр".
Нажмите "Панели инструментов".
Установите флажок рядом с пунктом "Изменить".

Навигация по панели редактирования

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

Вы можете перетащить эту панель инструментов в любое место в своем VBE. Мне нравится, когда мой пристыкован рядом с панелью инструментов отладки.

Комментирование блоков строк

После того, как вы дошли до этого места, вы можете комментировать блоки кода VBA, выделяя строки и нажимая кнопку «Комментировать блок». Это будет выглядеть примерно так:

Создавайте мощные макросы с помощью нашего бесплатного комплекта разработчика VBA

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

Заключительные мысли

Навык комментирования блоков кода в VBA необходим для создания и отладки макросов. В этом руководстве по VBA я показал вам, как включить одну из самых важных панелей инструментов, которые вы можете иметь в VBA. Я все еще в шоке, что эта панель инструментов по умолчанию не видна, но это нормально. Теперь это так!

На этом уроке все. Когда вы будете готовы вывести свой VBA на новый уровень, подпишитесь, заполнив форму ниже.

Готовы делать больше с VBA?
Мы собрали гигантский PDF-файл с более чем 300 готовыми макросами и хотим, чтобы вы получили его бесплатно. Введите свой адрес электронной почты ниже, и мы вышлем вам копию вместе с нашим комплектом разработчика VBA, полным советов, приемов и ярлыков VBA.

Прежде чем мы начнем, я хочу сообщить вам, что мы разработали набор шпаргалок по VBA, чтобы вам было проще писать лучшие макросы. Мы включили более 200 советов и 140 примеров макросов, поэтому в них есть все, что вам нужно знать, чтобы стать лучшим программистом VBA.

Это очень простая, но полезная статья, особенно для новичков. Иногда даже пользователи среднего уровня также не знают обо всех этих возможностях комментирования строки или группы строк в Excel VBA.

Как и в любом другом языке программирования, в VBA есть возможность комментировать строку или группу строк в коде.
Для тех, кто не знает — что такое комментарий в программировании:

Комментирование строки или группы строк на любом языке программирования означает: указание системе управления выполнением или компилятору пропустить эти строки при компиляции или выполнении.

Прежде чем я расскажу вам, как прокомментировать строку в Excel VBA, позвольте мне объяснить вам, как это использовать

Для чего используются комментарии в программировании Excel VBA

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

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

В основном это можно сделать тремя способами.

Способ 1. Использование одинарных кавычек (‘)

Это один из самых простых способов комментирования отдельной строки в программировании на VBA.
Чтобы прокомментировать строку, вы можете просто ввести одинарную кавычку (‘) в начале этой строки. Вся строка превратится в зеленый текст. Это все !
Теперь эта строка не будет ни компилироваться, ни выполняться.

Одинарная кавычка также может быть помещена где-то в середине строки. В таком случае остальная часть текста после одинарной кавычки (‘) будет рассматриваться как комментарий.
См. изображение ниже

Строка комментариев в VBA

Способ 2. Использование ключевого слова REM в Excel VBA

Это тоже просто, но я не предпочитаю это. Вы можете увидеть причину ниже в разделе примечаний.

Чтобы прокомментировать любую строку в VBA, вы можете начать эту строку с ключевого слова REM. Таким образом, в этом методе вместо одиночной кавычки (апострофа) вы можете ввести ключевое слово Rem.

Ниже приведены ограничения на использование этого ключевого слова Rem:
1. Между началом комментария и ключевым словом Rem должен быть хотя бы один пробел.
2. Как и одинарные кавычки, ключевое слово Rem нельзя использовать в середине строки для комментирования остальной части строки. Ключевое слово Rem всегда должно начинаться первым словом.

Думаю, двух причин более чем достаточно, чтобы мне это не понравилось :).

Способ 3. Встроенная опция VBE – Комментарий/Раскомментировать блок

Это тот же метод, что и первый, но здесь вам не нужно вводить одинарную кавычку самостоятельно, вместо этого вы можете выполнить следующие шаги:
1. Поместите курсор мыши в любое место. в строке, которую вы хотите прокомментировать
2. Нажмите кнопку «Комментировать», как показано на видео ниже

Важно:

Используя этот метод, вы также можете нажать кнопку «Раскомментировать», как показано в приведенном выше gif-видео.

К сожалению, в VBA для этого нет сочетания клавиш. Но не волнуйтесь, метод 3 очень полезен в этом случае.
Для этого можно использовать те же кнопки Блокировать комментарии и Блокировать комментарии.
Просто выберите все строки, которые вы хотите прокомментировать или удалить, и нажмите соответствующую кнопку, как показано ниже:

Шаг 1: Выделите все строки (блок)
Шаг 2: Нажмите блок комментария, как показано на рисунке выше

Шаг 1. Выделите все закомментированные строки (блок).
Шаг 2. Нажмите кнопку "Раскомментировать блок", как показано на рисунке выше.

Что делать, если кнопка «Блок комментария» и «Удалить комментарий» не отображаются

Выполните следующие шаги:
Шаг 1: перейдите в раздел «Просмотр» –> «Панели инструментов» –> «Изменить»

VBE – просмотр параметров редактирования

Шаг 2. Установите флажок "Редактировать". Вы увидите панель инструментов «Редактировать», где вы можете найти эти две опции наряду с другими.

Читайте также: