Visual Studio 2008缩进C语言注释 /* */

Question

我是第一次使用Visual Studio 2008 IDE，之前一直在使用vim。请问有没有办法设置Visual Studio自动缩进C语言注释/* */，就像这样：

/*<ENTER>

我希望你能帮我翻译这个：

/*
 * <CURSOR>

编辑：看起来Visual Studio 2008对于C#注释有这种行为，但不适用于C/C++在下面的位置： 文本编辑器 > C# >高级 > 生成XML文档注释 for ///

- Yada

Answer 1

您可以在EnvironmentEvents 项目项中使用以下宏。它适用于所有标签样式 (None、Block 或 Smart)。

    Public Sub aftekeypress(ByVal key As String, ByVal sel As TextSelection, ByVal completion As Boolean) _
            Handles TextDocumentKeyPressEvents.AfterKeyPress

        If (Not completion And key = vbCr) Then
            Dim textDocument As TextDocument = DTE.ActiveDocument.Object("TextDocument")
            Dim startPoint As EditPoint = TextDocument.StartPoint.CreateEditPoint()
            startPoint.MoveToLineAndOffset(sel.ActivePoint.Line - 1, 1)
            Dim lines = startPoint.GetLines(sel.ActivePoint.Line - 1, sel.ActivePoint.Line)
            If lines.LastIndexOf("*") = 1 And lines.LastIndexOf("/") <= 0 Then
                If lines.LastIndexOf("/") = 0 Or _
                   DTE.Properties("TextEditor", "C/C++").Item("IndentStyle").Value = 0 Then
                    sel.Insert(" ")
                End If
                sel.Insert("* ")
            End If
        End If
    End Sub

- Rod

---

只是粘贴这个并没有任何作用。我需要以某种方式进行注册吗？ - Christopher Oezbek

你不需要注册它。你需要确保你在MyMacros中的EnvironmentEvents模块内。你只能在宏资源管理器（工具->宏->宏资源管理器）中访问此模块。 - Rod

不错！但是只有当注释没有缩进（lastIndexOf("*")...）时才有效。 - Christopher Oezbek

Answer 2

虽然不完全相同，但您可以尝试使用Comment Reflower插件：

http://www.kynosarges.de/CommentReflower.html（适用于VS2008+版本） http://commentreflower.sourceforge.net/（适用于VS2005的原始版本）

这个插件的工作方式类似于emacs；您可以随意输入注释，然后在光标位于注释中时键入您选择的快捷键（或者如果您坚持的话，从菜单中选择），然后注释就会被包裹起来。这并不是特别流畅 - 我想vim会在您输入时自动完成这个过程，对吧？- 但它足够合理，您很快就会习惯。

我现在不在Windows上，所以无法检查，但根据我的记忆，虽然这不会完全按照您要求的格式化C注释，但它会产生一些相当合理的结果，大致如下：

/* This is what Comment Reflower will do with your multi-line
 * C comments, as far as I can remember.
 */

此外，它还支持预格式化区域、各种doxygen格式项和各种类型的项目符号。（选项对话框非常值得一看。）

就我个人而言，我真的很喜欢它，并且为Xcode中缺乏类似功能而感到遗憾。（我编写的iPhone代码文件充满了œ字符，因为我出于习惯按下快捷键。）我的vim时代已经过去了，但我肯定更喜欢它比emacs的等效物。（我第一次遇到它是在使用vim时，虽然这是一段时间以前的事情了，但我不记得当时发现它太可怕了——所以它很可能也很好地支持vim的注释功能。）

（作为告别的一笔——Visual Studio 2005示例宏集提供了一个样本宏，声称可以为您包装注释。也许它仍然存在于2008年？无论如何，它做得还不错，我自己用了一段时间，但它有使任何比只包含C++ //-style注释的行更复杂的东西变得混乱的倾向。Comment Reflower要好得多。）

- please delete me

Answer 3

根据我的经验，它已经做到了这一点。

- BC.

---

似乎对我没有起作用，可能是我的设置问题。 - Yada

实际上，该行为是通过宏来控制的。我相信它是GetCommentLinePrefix，但不确定它是如何执行的。 - BC.

Answer 4

我的评论已经自动格式化了，我认为这是默认行为，但我安装了Visual Studio 2010和ReSharper。不幸的是，我在两者中都找不到打开或关闭注释格式设置的选项。然而，通过查看Visual Studio 2010中的示例宏，您应该能够编写一个宏，以您喜欢的方式格式化您的注释。

要查找示例宏

1. 打开Visual Studio
2. 按Alt + F8打开宏资源管理器
3. 展开示例选项卡
4. 双击“VSEditor”

最有用的方法将是

• NewCommentLine
• GetCommentLinePrefix

- TheLukeMcCarthy

---

我只是不明白为什么VS默认不这样做。这只是一个普通的块注释。 - Christopher Oezbek

我同意应该这样做，对我来说也是如此。真正让人沮丧的是我找不到任何设置 :-/ 然而，宏是你工具箱中必备的好工具。 - TheLukeMcCarthy

Answer 5

Visual Assist X 可以解决这个问题。它是 C/C++ 的 ReShaper，比 ReSharper 在 C/C++ 上表现更好。您需要配置片段 "/**" 以使其正常工作。

附注：在该片段配置中，您甚至可以按照自己的意愿自动生成文档。例如：

- Wernight

---

编辑来自VAX配置的现有'/'（执行'/*************************/'）的注释。 - Wernight

还可以在VA选项对话框的高级|更正页面上查看“自动扩展多行注释”选项。 - sean e