2014-12-15 3 views
0

Есть ли способ сделать комментарии C++ intellisense появляться в списке элементов/функций класса при использовании его изнутри функции класса в Visual Studio? Позвольте мне привести пример.Комментарии Intellisense внутри функций класса?

Скажите, что у нас есть собака и класс Cat, как показано ниже. Предположим, что у Cat есть ссылка «собака» на экземпляр «Собака». Обратите внимание на комментарии Xml, добавленные к каждой функции-члену, в частности, функцию isBarking для этого примера.

class Dog 
{ 
    ///<summary>Makes the dog bark.</summary> 
    void bark() { if (isBarking()) { /*woof woof*/ } } 

    ///<summary>Is the dog barking?</summary> 
    ///<return>This dog has no bark, so it always returns false.</return> 
    bool isBarking() { return false; } 
} 

class Cat 
{ 
    ///<summary>Should the cat run?</summary> 
    ///<return>Always true if the dog is barking, otherwise false.</return> 
    bool run() { return dog.isBarking(); } 
} 

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

Однако при вводе функции isBarking (или наведении указателя мыши на нее) внутри функции коры собаки, суммарный комментарий и обратный комментарий intellisense НЕ отображается для функции isBarking. Есть ли способ показать его?

ответ

0

Visual Studio никогда не отображает <return> заявления, они предназначены для других целей. Когда вы извлекаете документацию из своего кода, используются <return> s. Visual Studio отображает только <summary>.

Я просто скопировал ваш код в VS 2013, я вижу <summary> при наведении указателя мыши и при наборе текста. Просто проверьте настройки VS, перейдите в Редактор Visual Studio, Edit Menu-> Intellisense. To turn on/off Quick Info, Parameter Info, etc.

+0

Я понял, что мой пример плохо иллюстрирует проблему. Проблема возникает, когда определение класса и реализация разделяются между файлами .h и .cpp. Поэтому, если реализация методов Dog и Cat переносится в файл .cpp в моем предыдущем примере, вы попадете в проблему. Вы увидите, что суммарный комментарий не отображается для функции isBarking, например, при вводе его внутри функции коры. – user1227445

+0

Я использую VS 2013, и я только что выполнил упражнение, которое вы упомянули. Он отображает сводные комментарии, набирая его внутри функции Dog :: bark. Какую версию VS вы используете? Я предлагаю вам проверить настройки, перейдите в редактор Visual Studio, Edit Menu-> Intellisense. Включение/выключение Быстрая информация, информация о параметрах и т. Д. – user1

+0

VS 2013. К сожалению, он не работает, как вы описываете. Я попытался нажать Quick Info в меню, и он просто показывает то же самое в подсказке без сводки. В любом случае, чтобы опубликовать снимки экрана здесь? Возможно, это может устранить проблему, если я смогу показать, что происходит. – user1227445

Смежные вопросы