Hello,
At the moment, unless I hear otherwise, it is strictly arduino compatible.
This means that the sketch is copied to a temp folder, the .ino and/or .pde files are combined into a .cpp and then compiled.
So relative include paths are not possible, I have never tried referencing #includes using a fully qualified path and I am not sure it would work.
What you can do You can add your own #includes to .h files that exist in the same folder as the sketch. The same folder can also contain .c and/or .cpp files.
To see an example of how these local includes work you can right click the project in the solution explorer and use the "Add>New Cpp Item". This will create new .h/.cpp (class) files and add an #include to the top of the [master_sketch].ino file.
ReCap: Cpp and h files work as normal except that they must reside in the same folder as the sketch
One way to reference includes from other locations is to turn them into arduino libraries. This is easy to do by creating a new "[My Documents\Arduino]\Libraries\MyLibBlah" and adding at least one .h file with the same name as the folder (MyLibBlah.h). nb: "My Documents\Arduino" must be the name of your arduino preferences "sketch folder".
Once you have created the library either re-start visual studio or click on the project node in the Solution Explorer and from the top menu click "PROJECT>Add Arduino Library>Refresh"
The new library will appear on the "PROJECT>Add Arduino Library>User" menu, clicking it will insert #includes for all .h files in your library.
If you add more .h files to your library then you will need to make sure you add #includes into the [mysketch.ino] file.
When working with your own libraries a useful feature is "PROJECT>Show all arduino files". This will add your library source codes directly into the Visual Studio solution explorer allowing you to edit both the sketch and the library sources at the same time, prior to upload.
I hope this helps, if this doesn't answer your question please speak up
Thanks
ps: a good idea for our codeplex issues list might be to allow you to add your own global .h files to the vs C++ include paths list? If you need this then please register it on the vidualmicro.codeplex.com issues list