ENH: Add Visual Studio specific debug helpers to ITKCommon project

Starting in Visual Studio 2022 version 17.6, copying these files
to VS installation directory will no longer be required.
Natvis has been supported for longer.
This will likely do nothing if MSVC+Ninja is chosen.

Author: dzenanz

Modules/Core/Common/src/CMakeLists.txt

@@ -246,6 +246,17 @@ elseif(MSVC)
   )
 endif()
 
+if(MSVC)
+  list(APPEND ITKCommon_SRCS
+
+    # ITK.natvis are nicer debug visualizers for Visual Studio
+    ${ITK_SOURCE_DIR}/Utilities/Debugger/ITK.natvis
+
+    # do not step into SmartPointer and Object::Register
+    ${ITK_SOURCE_DIR}/Utilities/Debugger/ITK.natstepfilter
+  )
+endif()
+
 ### generating libraries
 itk_module_add_library(ITKCommon ${ITKCommon_SRCS})
 

Utilities/Debugger/ITK.natstepfilter

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Documentation: https://learn.microsoft.com/en-us/visualstudio/debugger/just-my-code?view=visualstudio -->
+<StepFilter xmlns="http://schemas.microsoft.com/vstudio/debugger/natstepfilter/2010">
+  <Function><Name>itk::SmartPointer.*</Name><Action>NoStepInto</Action></Function>
+  <Function><Name>itk::Object::Register</Name><Action>NoStepInto</Action></Function>
+  <Function><Name>vtkSmartPointer.*</Name><Action>NoStepInto</Action></Function>
+  <!-- We can also disable stepping into STL functions by uncommeting the next line: -->
+  <!-- <Function><Name>std::.+</Name><Action>NoStepInto</Action></Function> -->
+</StepFilter>

Utilities/Debugger/ITK.natvis

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8" ?>
-<!-- Documentation: https://msdn.microsoft.com/en-us/library/jj620914.aspx?f=255&MSPPError=-2147217396 -->
-<!-- e.g. copy into C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\Packages\Debugger\Visualizers\ITK.natvis -->
+<!-- Documentation: https://learn.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2015/debugger/create-custom-views-of-native-objects?view=vs-2015 -->
 <AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">
 
   <Type Name="itk::Size&lt;1&gt;">