QtCreator on 夜云泊 https://lifeislife.cn/tags/qtcreator/ feedId:57980998056508425+userId:73222296380546048 Recent content in QtCreator on 夜云泊 Hugo -- 0.160.1 zh Tue, 28 Sep 2021 19:26:03 +0000 QtCreator 快速添加注释模板 https://lifeislife.cn/posts/qtcreator%E5%BF%AB%E9%80%9F%E6%B7%BB%E5%8A%A0%E6%B3%A8%E9%87%8A%E6%A8%A1%E6%9D%BF/ Tue, 28 Sep 2021 19:26:03 +0000 https://lifeislife.cn/posts/qtcreator%E5%BF%AB%E9%80%9F%E6%B7%BB%E5%8A%A0%E6%B3%A8%E9%87%8A%E6%A8%A1%E6%9D%BF/ <h2 id="需求">需求</h2> <p>通常函数的注释一般都比较长，而且每个函数注释都格式一致，例如下面的函数注释模板。如果每次写注释都要复制一遍比较麻烦，复制完还要删除多余的字符。但是现有的编辑器一般都支持快捷输入。下面介绍在 QtCreator 中如何快捷输入注释模板。</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-cpp" data-lang="cpp"><span class="line"><span class="cl"><span class="cm">/* </span></span></span><span class="line"><span class="cl"><span class="cm"> * Description: // 函数功能、性能等的描述 </span></span></span><span class="line"><span class="cl"><span class="cm"> * Input Parameter: // 输入参数说明，包括每个参数的作 </span></span></span><span class="line"><span class="cl"><span class="cm"> * Output Parameter: // 对输出参数的说明。 </span></span></span><span class="line"><span class="cl"><span class="cm"> * Return: // 函数返回值的说明 </span></span></span><span class="line"><span class="cl"><span class="cm"> */</span> </span></span></code></pre></div><h2 id="方法">方法</h2> <ul> <li>QtCreator-菜单栏工具（Tool）- 选项（Options）- 文本编辑器（Text Editor）- 片段（Snippets）</li> <li>组（Group）选择<code>C++</code>-添加（Add） <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Responsive Image</title> <style> .post-img-view { text-align: center; } .responsive-image { display: block; margin: 0 auto; } </style> </head> <body> <div class="post-img-view"> <a data-fancybox="gallery" href="https://picbed-1311007548.cos.ap-shanghai.myqcloud.com/markdown_picbed/img/20210928193309.png"> <img class="responsive-image" src="https://picbed-1311007548.cos.ap-shanghai.myqcloud.com/markdown_picbed/img/20210928193309.png" alt="" style="margin: 0 auto;"/> </a> </div> <script> document.addEventListener("DOMContentLoaded", function() { var images = document.querySelectorAll(".responsive-image"); var maxHeight = window.innerHeight / 3; images.forEach(function(image) { image.style.maxHeight = maxHeight + "px"; }); }); </script> </body> </html></li> <li>现在要为我们的触发（Trigger）起个名字，因为是函数注释，我起了个<code>funcom</code>，然后在下方空白框里填入注释模板。Apply 保存。如图 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Responsive Image</title> <style> .post-img-view { text-align: center; } .responsive-image { display: block; margin: 0 auto; } </style> </head> <body> <div class="post-img-view"> <a data-fancybox="gallery" href="https://picbed-1311007548.cos.ap-shanghai.myqcloud.com/markdown_picbed/img/20210928193538.png"> <img class="responsive-image" src="https://picbed-1311007548.cos.ap-shanghai.myqcloud.com/markdown_picbed/img/20210928193538.png" alt="" style="margin: 0 auto;"/> </a> </div> <script> document.addEventListener("DOMContentLoaded", function() { var images = document.querySelectorAll(".responsive-image"); var maxHeight = window.innerHeight / 3; images.forEach(function(image) { image.style.maxHeight = maxHeight + "px"; }); }); </script> </body> </html></li> <li>在需要添加注释模板的地方输入<code>funcom</code>即可提示快捷输入，回车即可添加注释模板。 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Responsive Image</title> <style> .post-img-view { text-align: center; } .responsive-image { display: block; margin: 0 auto; } </style> </head> <body> <div class="post-img-view"> <a data-fancybox="gallery" href="https://picbed-1311007548.cos.ap-shanghai.myqcloud.com/markdown_picbed/img/20210928194108.gif"> <img class="responsive-image" src="https://picbed-1311007548.cos.ap-shanghai.myqcloud.com/markdown_picbed/img/20210928194108.gif" alt="" style="margin: 0 auto;"/> </a> </div> <script> document.addEventListener("DOMContentLoaded", function() { var images = document.querySelectorAll(".responsive-image"); var maxHeight = window.innerHeight / 3; images.forEach(function(image) { image.style.maxHeight = maxHeight + "px"; }); }); </script> </body> </html></li> </ul> <p>我们可以看到片段里有很多熟悉的内容，比如<code>if else</code>，我们在写代码时输入<code>if else</code>自动补全花括号其实就是在这里设置的。同理，我们还可以设置一些其他需要的快捷输入内容。比如行注释，文件注释，经常使用的代码框架等等。</p> 需求

通常函数的注释一般都比较长，而且每个函数注释都格式一致，例如下面的函数注释模板。如果每次写注释都要复制一遍比较麻烦，复制完还要删除多余的字符。但是现有的编辑器一般都支持快捷输入。下面介绍在 QtCreator 中如何快捷输入注释模板。

/* 
 * Description:      // 函数功能、性能等的描述  
 * Input Parameter:  // 输入参数说明，包括每个参数的作 
 * Output Parameter: // 对输出参数的说明。 
 * Return:           // 函数返回值的说明 
 */

方法

  • QtCreator-菜单栏工具（Tool）- 选项（Options）- 文本编辑器（Text Editor）- 片段（Snippets）
  • 组（Group）选择C++-添加（Add） Responsive Image
  • 现在要为我们的触发（Trigger）起个名字，因为是函数注释，我起了个funcom，然后在下方空白框里填入注释模板。Apply 保存。如图 Responsive Image
  • 在需要添加注释模板的地方输入funcom即可提示快捷输入，回车即可添加注释模板。 Responsive Image

我们可以看到片段里有很多熟悉的内容，比如if else，我们在写代码时输入if else自动补全花括号其实就是在这里设置的。同理，我们还可以设置一些其他需要的快捷输入内容。比如行注释，文件注释，经常使用的代码框架等等。

]]>