{"id":4876,"date":"2020-07-13T17:53:22","date_gmt":"2020-07-14T00:53:22","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=4876"},"modified":"2021-11-17T13:15:51","modified_gmt":"2021-11-17T21:15:51","slug":"word-comments-vba-deprecation","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/word-comments-vba-deprecation\/","title":{"rendered":"Redesigned Word Comments VBA deprecation announcement"},"content":{"rendered":"<p>Last year, we announced the <a href=\"https:\/\/blog-insider.office.com\/2019\/12\/09\/redesigned-comments-in-word\/\">Redesigned Comments in Word<\/a> as an effort to bring consistency to the reviewing experience and facilitate collaboration across apps and platforms. With the new redesigned comments user experience announcement, we want to point out there are four VBA scenarios that are no longer fully supported in Word Comments.<\/p>\n<h3>What is changing in Word Comments?<\/h3>\n<p>The following VBA Selection scenarios and VBA commands will have different behavior in the redesigned comments experience:<\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>Using VBA <strong>Selection<\/strong> commands like <a href=\"https:\/\/docs.microsoft.com\/office\/vba\/api\/word.selection.boldrun\">Selection.BoldRun<\/a> command on user selection with Comments no longer applies bold formatting on user-selected text on user-selected text or\u00a0<a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Foffice%2Fvba%2Fapi%2Fword.selection.typetext&amp;data=04%7C01%7CLinda.Cannon%40microsoft.com%7C17021aa74b054935c91a08d917327a5a%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637566327826278840%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=Xf05Ps0wRTvpPkRvakvVsQtJVVYbMVW50ahFZejJeN4%3D&amp;reserved=0\">Selection.TypeText<\/a>\u00a0command on user selection with Comments no longer inserts text.<\/li>\n<li>The <a href=\"https:\/\/docs.microsoft.com\/office\/vba\/api\/word.document.deleteallcommentsshown\">DeleteAllCommentsShown<\/a> method deletes the visible subset of comments. This includes active comments (shown) as well as resolved comments (indicated by comment hint).<\/li>\n<li>The <a href=\"https:\/\/docs.microsoft.com\/office\/vba\/api\/word.options.commentscolor\">Options.CommentsColor<\/a> property is still available but there will be no visible effect in the Redesigned Comments experience. However, the command will apply the <strong>CommentsColor<\/strong> property to the Word options so if the current user reverts to the previous commenting experience, the comment thread outline color will change based on the previous setting.<\/li>\n<li>The <a href=\"https:\/\/docs.microsoft.com\/office\/vba\/api\/word.comment.done\">Comment.Done<\/a> property is still available, but when setting the <strong>Done<\/strong> flag for a single comment reply, there will be no visible effect in the Redesigned Comments experience. The command will apply the <strong>Done<\/strong> flag, so when a user opens the document in the previous commenting experience, the comment reply is displayed as resolved or unresolved.<\/li>\n<li>The <a href=\"https:\/\/docs.microsoft.com\/office\/vba\/api\/word.application.commandbars\">Application.CommandBars<\/a> property has changed. <strong>CommandBars<\/strong>(&#8220;Comments&#8221;) cannot be used to customize the context menu for comments<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>When is this happening?<\/h3>\n<p>The Redesigned Comments in Word feature will be available in Word for Windows for both Beta and Current Channel (Preview) users on Version 2007 (Build 16.0.13029.20006) or later.<\/p>\n<h3>What do I need to do to prepare for this change?<\/h3>\n<p>If you are using macros to manipulate user-selected text in a comment, you should transition those macros to using the <a href=\"https:\/\/docs.microsoft.com\/en-us\/office\/vba\/api\/word.comment.range\">Comment.Range<\/a> object to manipulate comment text.<\/p>\n<ul>\n<li>For macros using the <a href=\"https:\/\/docs.microsoft.com\/en-us\/office\/vba\/api\/word.document.deleteallcommentsshown\">DeleteAllCommentsShown<\/a> method, you should transition those macros to manually filtering comments for deletion.<\/li>\n<li>For macros using the <a href=\"https:\/\/docs.microsoft.com\/en-us\/office\/vba\/api\/word.options.commentscolor\">Options.CommentsColor<\/a> and <a href=\"https:\/\/docs.microsoft.com\/en-us\/office\/vba\/api\/word.comment.done\">Comment.Done<\/a> properties, no action is required.<\/li>\n<\/ul>\n<h3>We\u2019d love to hear from you!<\/h3>\n<p>If you have any feedback or suggestions, you can submit them within Word by clicking the <strong>Help Improve Office<\/strong> smile button in the top right corner, or on the menu click <strong>Help<\/strong> &gt; <strong>Feedback<\/strong>. We\u2019re excited to hear from you!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Announcing Microsoft Word Comments redesigned user experience. This blog outlines the four Word VBA commands that are no longer fully supported in Word Comments.<\/p>\n","protected":false},"author":69076,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[11],"tags":[47],"class_list":["post-4876","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-office-add-ins","tag-word"],"acf":[],"blog_post_summary":"<p>Announcing Microsoft Word Comments redesigned user experience. This blog outlines the four Word VBA commands that are no longer fully supported in Word Comments.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/4876","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69076"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=4876"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/4876\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=4876"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=4876"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=4876"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}