Completed Doxygen documentation of all compounds in Explorer

svn path=/trunk/; revision=6611
This commit is contained in:
Martin Fuchs 2003-11-10 22:38:03 +00:00
parent 8aedeab84e
commit 4961049825
22 changed files with 153 additions and 101 deletions

View file

@ -1,3 +1,5 @@
Debug
Release
*.coff
*.exe
*.d

View file

@ -1,10 +1,10 @@
/* Do not edit - Machine generated */
#ifndef _INC_REACTOS_BUILDNO
#define _INC_REACTOS_BUILDNO
#define KERNEL_VERSION_BUILD 4
#define KERNEL_VERSION_BUILD_STR "4"
#define KERNEL_RELEASE_RC "0.1.4.4\0"
#define KERNEL_RELEASE_STR "0.1.4.4"
#define KERNEL_VERSION_BUILD 23
#define KERNEL_VERSION_BUILD_STR "23"
#define KERNEL_RELEASE_RC "0.1.4.23\0"
#define KERNEL_RELEASE_STR "0.1.4.23"
#define KERNEL_VERSION_RC "0.1.4\0"
#define KERNEL_VERSION_STR "0.1.4"
#endif

View file

@ -26,6 +26,7 @@
//
/// subclassed Background window behind the visible desktop window
struct BackgroundWindow : public SubclassedWindow
{
typedef SubclassedWindow super;
@ -37,6 +38,7 @@ protected:
};
/// Implementation of the Explorer desktop window
struct DesktopWindow : public Window, public IShellBrowserImpl
{
typedef Window super;

View file

@ -64,6 +64,7 @@ protected:
};
/// entry for the list in "find program" dialogs
struct FPDEntry
{
ShellEntry* _shell_entry;

View file

@ -3,7 +3,7 @@
<tr>
<td><address style="align: right;"><small>
ROS Explore Source Code Documentation
<br>generated on 02.11.2003 by <a href="http://www.doxygen.org/index.html">
<br>generated on 09.11.2003 by <a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0>
</small></address>
</td>

View file

@ -362,6 +362,10 @@ SOURCE=.\res\logov.bmp
# End Source File
# Begin Source File
SOURCE=.\res\logov256.bmp
# End Source File
# Begin Source File
SOURCE=.\res\reactos.ico
# End Source File
# Begin Source File

View file

@ -26,6 +26,7 @@
//
/// structure containing global variable of Explorer
extern struct ExplorerGlobals
{
ExplorerGlobals();
@ -75,6 +76,7 @@ protected:
HICON _hIcon;
};
/// convenient loading of icon resources with specified sizes
struct ResIconEx
{
ResIconEx(UINT nid, int w, int h);
@ -85,8 +87,10 @@ protected:
HICON _hIcon;
};
/// set big and small icons out of the resources for a window
extern void SetWindowIcon(HWND hwnd, UINT nid);
/// convenient loading of bitmap resources
struct ResBitmap
{
ResBitmap(UINT nid);

View file

@ -85,6 +85,8 @@ public:
virtual BOOL launch_entry(HWND hwnd, UINT nCmdShow=SW_SHOWNORMAL);
};
/// base for all directory entries
struct Directory {
protected:
Directory() : _path(NULL) {}
@ -94,6 +96,7 @@ protected:
};
/// root entry for file system trees
struct Root {
Root();
~Root();

View file

@ -38,6 +38,7 @@ struct FileChildWndInfo
int _open_mode; //OPEN_WINDOW_MODE
};
/// information structure for creation of ShellBrowserChild
struct ShellChildWndInfo : public FileChildWndInfo
{
ShellChildWndInfo(LPCTSTR path, const ShellPath& root_shell_path);
@ -91,6 +92,7 @@ public:
};
/// The "Execute..."-dialog lets the user enter a command line to launch.
struct ExecuteDialog { ///@todo use class Dialog
TCHAR cmd[MAX_PATH];
int cmdshow;

View file

@ -44,6 +44,7 @@ enum COLUMN_FLAGS {
};
/// Worker for drawing contents of file lists in child pane
struct OutputWorker
{
OutputWorker();

View file

@ -29,6 +29,7 @@
#include "../utility/shellbrowserimpl.h"
/// Implementation of IShellBrowserImpl interface in explorer child windows
struct ShellBrowserChild : public ChildWindow, public IShellBrowserImpl
{
typedef ChildWindow super;

View file

@ -46,6 +46,7 @@ protected:
};
/// shell folder entry
struct ShellDirectory : public ShellEntry, public Directory
{
ShellDirectory(ShellFolder& root_folder, const ShellPath& shell_path, HWND hwnd)

View file

@ -16,6 +16,7 @@
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/* Based on the Wine "bootup" handler application
*
* This app handles the various "hooks" windows allows for applications to perform
@ -55,7 +56,8 @@
#include <windows.h>
#include <ctype.h>
/* Performs the rename operations dictated in %SystemRoot%\Wininit.ini.
/**
* Performs the rename operations dictated in %SystemRoot%\Wininit.ini.
* Returns FALSE if there was an error, or otherwise if all is ok.
*/
static BOOL wininit()
@ -222,7 +224,7 @@ const WCHAR runkeys_names[][30]=
};
#define INVALID_RUNCMD_RETURN -1
/*
/**
* This function runs the specified command in the specified dir.
* [in,out] cmdline - the command line to run. The function may change the passed buffer.
* [in] dir - the dir to run the command in. If it is NULL, then the current dir is used.
@ -270,7 +272,7 @@ static int runCmd(LPWSTR cmdline, LPCWSTR dir, BOOL wait, BOOL minimized)
return exit_code;
}
/*
/**
* Process a "Run" type registry key.
* hkRoot is the HKEY from which "Software\Microsoft\Windows\CurrentVersion" is
* opened.
@ -399,6 +401,7 @@ end:
return res==ERROR_SUCCESS?TRUE:FALSE;
}
/// structure holding startup flags
struct op_mask {
BOOL w9xonly; /* Perform only operations done on Windows 9x */
BOOL ntonly; /* Perform only operations done on Windows NT */
@ -408,7 +411,8 @@ struct op_mask {
BOOL postlogin; /* Operations done after login */
};
static const struct op_mask SESSION_START={FALSE, FALSE, TRUE, TRUE, TRUE, TRUE},
static const struct op_mask
SESSION_START = {FALSE, FALSE, TRUE, TRUE, TRUE, TRUE},
SETUP = {FALSE, FALSE, FALSE, TRUE, TRUE, TRUE};
#define DEFAULT SESSION_START

View file

@ -26,6 +26,7 @@
//
/// Windows File System file-entry
struct WinEntry : public Entry
{
WinEntry(Entry* parent) : Entry(parent) {}
@ -36,6 +37,8 @@ protected:
virtual void get_path(PTSTR path) const;
};
/// Windows File System directory-entry
struct WinDirectory : public WinEntry, public Directory
{
WinDirectory(LPCTSTR root_path)

View file

@ -42,6 +42,7 @@
#define PM_STARTENTRY_LAUNCHED (WM_APP+0x13)
/// StartMenuDirectory is used to store the base directory of start menus.
struct StartMenuDirectory
{
StartMenuDirectory(const ShellDirectory& dir, bool subfolders=true)
@ -61,6 +62,7 @@ struct StartMenuDirectory
typedef list<StartMenuDirectory> StartMenuShellDirs;
typedef set<const ShellEntry*> ShellEntrySet;
/// structure holding information about one start menu entry
struct StartMenuEntry
{
StartMenuEntry() : _hIcon(0) {}
@ -72,7 +74,7 @@ struct StartMenuEntry
/**
StartMenuButton draws to face of a StartMenuCtrl button control.
StartMenuButton draws the face of a StartMenuCtrl button control.
*/
struct StartMenuButton : public OwnerdrawnButton
{
@ -108,6 +110,7 @@ struct StartMenuCtrl : public Button
};
/// separator between start menu entries
struct StartMenuSeparator : public Static
{
StartMenuSeparator(HWND parent, int x, int y, int w, DWORD style=WS_VISIBLE|WS_CHILD|WS_DISABLED|SS_ETCHEDHORZ, DWORD exStyle=0)
@ -119,6 +122,7 @@ struct StartMenuSeparator : public Static
typedef list<ShellPath> StartMenuFolders;
/// structor containing information for creating start menus
struct StartMenuCreateInfo
{
StartMenuCreateInfo() : _border_top(0) {}
@ -136,7 +140,8 @@ typedef map<UINT, StartMenuEntry> ShellEntryMap;
/**
Startmenu window
Startmenu window.
To create a start menu call its Create() function.
*/
struct StartMenu : public OwnerDrawParent<DialogWindow>
{
@ -221,7 +226,7 @@ typedef BOOL (WINAPI* SHFINDFILES)(LPCITEMIDLIST pidlRoot, LPCITEMIDLIST pidlSav
typedef BOOL (WINAPI* SHFINDCOMPUTER)(LPCITEMIDLIST pidlRoot, LPCITEMIDLIST pidlSavedSearch);
// Startmenu root window
/// Startmenu root window
struct StartMenuRoot : public StartMenu
{
typedef StartMenu super;
@ -248,7 +253,7 @@ protected:
};
// Settings sub-startmenu
/// Settings sub-startmenu
struct SettingsMenu : public StartMenu
{
typedef StartMenu super;
@ -266,7 +271,7 @@ protected:
};
// "Browse Files..." sub-start menu
/// "Browse Files..." sub-start menu
struct BrowseMenu : public StartMenu
{
typedef StartMenu super;
@ -284,6 +289,7 @@ protected:
};
/// "Recent Files" sub-start menu
struct RecentStartMenu : public StartMenu
{
typedef StartMenu super;

View file

@ -14,6 +14,7 @@ using std::vector;
typedef vector<FORMATETC> FormatArray;
/// structure containing information for one format of EnumFormatEtcImpl
struct DataStorage {
FORMATETC* _format;
STGMEDIUM* _medium;
@ -209,6 +210,7 @@ public:
/* [out][in] */ DWORD __RPC_FAR *pdwEffect);
};
/// implementation of IDragSourceHelper interface
class DragSourceHelper
{
IDragSourceHelper* pDragSourceHelper;

View file

@ -28,6 +28,7 @@
//
/// Implementation of IShellBrowser and ICommDlgBrowser interfaces for explorer child windows (see ShellBrowserChild)
struct IShellBrowserImpl : public IShellBrowser, public ICommDlgBrowser
{
IShellBrowserImpl()

View file

@ -175,7 +175,7 @@ struct CommonShellMalloc
};
// wrapper class for IMalloc with usage of common allocator
/// wrapper class for IMalloc with usage of common allocator
struct ShellMalloc
{
@ -194,7 +194,7 @@ struct ShellMalloc
};
// wrapper template class for pointers to shell objects managed by IMalloc
/// wrapper template class for pointers to shell objects managed by IMalloc
template<typename T> struct SShellPtr
{
@ -255,7 +255,7 @@ private:
};
// wrapper class for COM interface pointers
/// wrapper class for COM interface pointers
template<typename T> struct SIfacePtr
{
@ -473,7 +473,7 @@ extern "C" UINT ILGetSize(LPCITEMIDLIST pidl);
#endif
// wrapper class for item ID lists
/// wrapper class for item ID lists
struct ShellPath : public SShellPtr<ITEMIDLIST>
{
@ -673,6 +673,7 @@ struct ShellPath : public SShellPtr<ITEMIDLIST>
extern LPSTR strcpyn(LPSTR dest, LPCSTR source, size_t count);
extern LPWSTR wcscpyn(LPWSTR dest, LPCWSTR source, size_t count);
/// easy retrieval of multi byte strings out of STRRET structures
struct StrRetA : public STRRET
{
~StrRetA()
@ -698,6 +699,7 @@ struct StrRetA : public STRRET
}
};
/// easy retrieval of wide char strings out of STRRET structures
struct StrRetW : public STRRET
{
~StrRetW()
@ -724,6 +726,7 @@ struct StrRetW : public STRRET
};
/// Retreival of file system paths of ShellPath objects
class FileSysShellPath : public ShellPath
{
TCHAR _fullpath[MAX_PATH];
@ -829,6 +832,7 @@ protected:
#else // _WIN32_IE<0x400 -> use SHGetSpecialFolderLocation()
/// file system path of special folder
struct SpecialFolderFSPath : public FileSysShellPath
{
SpecialFolderFSPath(int folder, HWND hwnd)
@ -841,7 +845,7 @@ struct SpecialFolderFSPath : public FileSysShellPath
#endif
// wrapper class for enumerating shell namespace objects
/// wrapper class for enumerating shell namespace objects
struct ShellItemEnumerator : public SIfacePtr<IEnumIDList>
{

View file

@ -9,6 +9,7 @@
#include "dragdropimpl.h"
/// OLE drop target for tree controls
class TreeDropTarget : public IDropTargetImpl
{
public:

View file

@ -114,6 +114,7 @@ protected:
static CREATORFUNC s_window_creator;
/// structure for managing critical sections as static class information in struct Window
struct StaticWindowData {
CritSect _map_crit_sect;
CritSect _create_crit_sect;
@ -142,6 +143,7 @@ template<typename CLASS> struct GetWindowHelper
#endif
/// dynamic casting of Window pointers
template<typename CLASS> struct TypeCheck
{
static CLASS* dyn_cast(Window* wnd)
@ -171,6 +173,7 @@ protected:
};
/// template class used in macro WINDOW_CREATOR to the define creater functions for Window objects
template<typename WND_CLASS> struct WindowCreator
{
static WND_CLASS* window_creator(HWND hwnd)
@ -183,6 +186,7 @@ template<typename WND_CLASS> struct WindowCreator
(Window::CREATORFUNC) WindowCreator<WND_CLASS>::window_creator
/// template class used in macro WINDOW_CREATOR_INFO to the define creater functions for Window objects with additional creation information
template<typename WND_CLASS, typename INFO_CLASS> struct WindowCreatorInfo
{
static WND_CLASS* window_creator(HWND hwnd, const void* info)
@ -348,6 +352,7 @@ protected:
// Layouting of resizable windows
/// Flags to specify how to move and resize controls when resizing their parent window
enum RESIZE_FLAGS {
MOVE_LEFT = 0x1,
MOVE_RIGHT = 0x2,
@ -363,6 +368,7 @@ enum RESIZE_FLAGS {
RESIZE = RESIZE_X | RESIZE_Y
};
/// structure to assign RESIZE_FLAGS to dialogs control
struct ResizeEntry
{
ResizeEntry(UINT id, int flags)
@ -375,6 +381,8 @@ struct ResizeEntry
int _flags;
};
/// Management of controls in resizable dialogs
struct ResizeManager : public std::list<ResizeEntry>
{
typedef std::list<ResizeEntry> super;
@ -403,6 +411,8 @@ protected:
SIZE _last_size;
};
/// Controller base template class for resizable dialogs
template<typename BASE> struct ResizeController : public BASE
{
typedef BASE super;