{"id":713,"date":"2014-06-17T00:51:39","date_gmt":"2014-06-17T00:51:39","guid":{"rendered":"http:\/\/blog.wholetomato.com\/?p=713"},"modified":"2019-05-03T17:28:18","modified_gmt":"2019-05-03T21:28:18","slug":"filtering-results-of-find-references","status":"publish","type":"post","link":"https:\/\/stage.wholetomato.com\/blog\/filtering-results-of-find-references\/","title":{"rendered":"Filtering results of Find References"},"content":{"rendered":"

We regularly hear from C\/C++ and C# users that Find References is their most-used feature of Visual Assist. Despite the existence of a similarly named feature in Visual Studio, the functionality and speed provided by our version appears to be a game changer. And Find References\u00c2\u00a0keeps getting better.<\/p>\n

Beginning with Visual Assist build 2036, you\u00c2\u00a0can filter the results of Find References, in original and cloned windows. Although filtering is available via\u00c2\u00a0the context menu, keyboard access is the way to go.<\/p>\n

I begin with a simple example that includes a reference to a quantity in a comment, its\u00c2\u00a0definition, one write\u00c2\u00a0access, and one read\u00c2\u00a0access.<\/p>\n

\"findRefsExample\"<\/a><\/p>\n

Find References (Shift+Alt+F) on quantity produces a results window with four entries, one of each type.<\/p>\n

\"findRefsResultsAll\"<\/a><\/p>\n

Although Find References has always differentiated read versus write references\u00e2\u20ac\u201dblue and pink in my example\u00e2\u20ac\u201dyou can now use shortcuts R and W to filter by\u00c2\u00a0type. When focus is in the results, press W to remove the write\u00c2\u00a0reference(s).<\/p>\n

\"findRefsResultsW\"<\/p>\n

Press W again to make\u00c2\u00a0the write\u00c2\u00a0reference reappear, then\u00c2\u00a0R to remove the read\u00c2\u00a0reference(s).<\/p>\n

\"findRefsResultsR\"<\/a><\/p>\n

Initializations aren\u00e2\u20ac\u2122t considered write references. Instead, they are included in\u00c2\u00a0definition references, which are filtered with the D shortcut. (In C\/C++, declarations are also filtered with D.)<\/p>\n

“References” in coMments and strings are filtered using M, and if my example had any, unknown\/Guess hits would be\u00c2\u00a0filtered with G.\u00c2\u00a0Hence, pressing RDM immediately after my initial find would leave\u00c2\u00a0me\u00c2\u00a0with only the write reference.<\/p>\n

\"findRefsResultsWOnly\"<\/a><\/p>\n

Filter states aren\u00e2\u20ac\u2122t sticky. Each Find References begins with all results, and each of the shortcuts initially removes references.<\/p>\n

Additionally, filter states are specific to the window. You can show read references in one window and write references in a cloned window\u00e2\u20ac\u201dto one or different symbols. If you can\u00e2\u20ac\u2122t remember the state of a filter in a window, toggle it and look for a change in\u00c2\u00a0the vertical scroll bar.<\/p>\n

Shortcuts for Highlight All (H) and Search All Projects (P) work similarly. H toggles the highlighting of references in source windows; P refreshes search results to include references\u00c2\u00a0from all projects, or restrict them to\u00c2\u00a0the current project. (Because quantity is a local variable in my example, my searches were\u00c2\u00a0always restricted to the current file.) .<\/p>\n

Open the context menu of Find References if you forget the\u00c2\u00a0shortcuts. Only those that apply to your results are visible.<\/p>\n

\"findRefsResultsMenu\"<\/a><\/p>\n

Find References in Visual Assist is powerful and complex, and you need time and revisits\u00c2\u00a0to take full advantage of the command. Try the filtering described in this post, check out\u00c2\u00a0a previous post about using Find References to manage a task<\/a>\u00c2\u00a0, then\u00c2\u00a0hit the documentation<\/a> when you are ready for more.<\/p>\n","protected":false},"excerpt":{"rendered":"

We regularly hear from C\/C++ and C# users that Find References is their most-used feature of Visual Assist. Despite the existence of a similarly named feature in Visual Studio, the functionality and speed provided by…<\/p>\n","protected":false},"author":28485711,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_coblocks_attr":"","_coblocks_dimensions":"","_coblocks_responsive_height":"","_coblocks_accordion_ie_support":"","_jetpack_newsletter_access":"","_jetpack_newsletter_tier_id":0,"footnotes":""},"categories":[672],"tags":[],"class_list":["post-713","post","type-post","status-publish","format-standard","hentry","category-tips-and-tricks"],"aioseo_notices":[],"jetpack_featured_media_url":"","jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pfhqii-bv","amp_enabled":true,"_links":{"self":[{"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts\/713","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/users\/28485711"}],"replies":[{"embeddable":true,"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/comments?post=713"}],"version-history":[{"count":10,"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts\/713\/revisions"}],"predecessor-version":[{"id":732,"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts\/713\/revisions\/732"}],"wp:attachment":[{"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/media?parent=713"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/categories?post=713"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/stage.wholetomato.com\/blog\/wp-json\/wp\/v2\/tags?post=713"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}