added interface headers with latest discussed changes

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52381 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/iconloc.h

@@ -0,0 +1,39 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        iconloc.h
+// Purpose:     documentation for wxIconLocation class
+// Author:      wxWidgets team
+// RCS-ID:      $Id$
+// Licence:     wxWindows license
+/////////////////////////////////////////////////////////////////////////////
+
+/**
+    @class wxIconLocation
+    @wxheader{iconloc.h}
+    
+    wxIconLocation is a tiny class describing the location of an (external, i.e.
+    not embedded into the application resources) icon. For most platforms it simply
+    contains the file name but under some others (notably Windows) the same file
+    may contain multiple icons and so this class also stores the index of the icon
+    inside the file.
+    
+    In any case, its details should be of no interest to the application code and
+    most of them are not even documented here (on purpose) as it is only meant to
+    be used as an opaque class: the application may get the object of this class
+    from somewhere and the only reasonable thing to do with it later is to create
+    a wxIcon from it.
+    
+    @library{wxbase}
+    @category{FIXME}
+    
+    @seealso
+    wxIcon, wxFileType::GetIcon
+*/
+class wxIconLocation 
+{
+public:
+    /**
+        Returns @true if the object is valid, i.e. was properly initialized, and 
+        @false otherwise.
+    */
+#define bool IsOk()     /* implementation is private */
+};