Windows System classes

Internal classes More...

Classes
class	owl::TConfigFile
	Save/Load configuration parameters Base abstract class. More...
class	owl::TConfigFileSection
	Small inline wrapper around Section. More...
class	owl::TIniConfigFile
	Encapsulates the Windows INI file interface Get/SetPrivateProfileXXX functions. More...
class	owl::TMemConfigFile
class	owl::TRegConfigFile
	Derived from TConfigFile, TRegConfigFile is used to maintain configuration settings in the registry. More...
class	owl::TProfile
	An instance of TProfile encapsulates a setting within a system file, often referred to as a profile or initialization file. More...
class	owl::TRegValue
	Encapsulates a value-data entry within one registration key. More...
class	owl::TRegKey
	Encapsulates a registration key in the Windows Registry. More...
class	owl::TRegKeyIterator
	Iterator for walking thru the subkeys of a key. More...
class	owl::TRegValueIterator
	Iterator for walking through the values of a key. More...
class	owl::TXRegistry
	Thrown for errors within the Registry classes. More...
class	owl::TRegFormatHeap
	Used internally to provide buffers for formating registration strings. More...
struct	owl::TRegItem
	A single registration list entry. More...
class	owl::TRegList
	A registration parameter table, composed of a list of TRegItems. More...
class	owl::TRegLink
	A linked structure in which each node points to a list of TRegList objects (or TRegList-derived objects) or TDocTemplate objects. More...
class	owl::TRegTemplateList
	List of parameterized template strings that represent the actual entries to be registered. More...
class	owl::TRegParamList
	A list of param entries for use as an intermediate between a TRegList and the actual template list used to generate the registration. More...
class	owl::TRegSymbolTable
	High level symbol-based registry entry manipulation. More...
class	owl::TRegistry
	TRegistry provides high level stream and list access to the registry. More...
class	owl::TShell
	delay loading SHELL32.DLL/SHELL.DLL More...
class	owl::TShellMalloc
	Wraps the shell's IMalloc interface. More...
class	owl::TExtractIcon
	Wraps the IExtractIcon interface (currently lightweight). More...
class	owl::TContextMenu
	Wraps the IContextMenu interface (currently lightweight). More...
class	owl::TDataObject
	Wraps the IDataObject interface (currently lightweight). More...
class	owl::TDropTarget
	Wraps the IDropTarget interface (currently lightweight). More...
class	owl::TPidl
	TPidl is an item identifier list class (ITEMIDLIST). More...
class	owl::TShellItem
	An item in the shell's name space. More...
class	owl::TShellItemIterator
	TShellItemIterator is an interator for walking through the contents of a folder. More...
class	owl::TXShell
	Base Shell exception class. Handles all TShellItem and related class exceptions. More...

Macros
#define	BEGIN_REGISTRATION(regname)
#define	END_REGISTRATION   {0,{0}} };
#define	REGDATA(var, val)   {#var, {val}},
#define	REGXLAT(var, val)   {#var, {AUTOLANG_XLAT val}},
#define	REGITEM(key, val)   {" " key, {val}},
#define	REGFORMAT(i, f, a, t, d)   {"format" #i,{TRegItem::RegFormat(f,a,t,d,__regHeap)}},
#define	REGSTATUS(a, f)   {"aspect" #a, {TRegItem::RegFlags(f,__regHeap)}},
#define	REGVERBOPT(v, mf, sf)   {#v "opt",{TRegItem::RegVerbOpt(mf,sf,__regHeap)}},
#define	REGICON(i)   {"iconindex",{TRegItem::RegFlags(i,__regHeap)}},
#define	REGDOCFLAGS(i)   {"docflags",{TRegItem::RegFlags(i,__regHeap)}},
#define	REGISTRATION_FORMAT_BUFFER(n)    TRegFormatHeap __regHeap;
#define	REGISTRATION_FORMAT_HEAP    TRegFormatHeap __regHeap;
#define	ocrRichText   _T("Rich Text Format")
#define	ocrEmbedSource   _T("Embed Source")
#define	ocrEmbeddedObject   _T("Embedded Object")
#define	ocrLinkSource   _T("Link Source")
#define	ocrObjectDescriptor   _T("Object Descriptor")
#define	ocrLinkSrcDescriptor   _T("Link Source Descriptor")
#define	ocrSingleUse   _T("1")
	Single client per instance.
#define	ocrMultipleUse   _T("2")
	Multiple clients per instance.
#define	ocrMultipleLocal   _T("3")
	Multiple clients, separate inproc server.

Enumerations
enum	owl::ocrClipFormat {   owl::ocrText = 1 , owl::ocrBitmap = 2 , owl::ocrMetafilePict = 3 , owl::ocrSylk = 4 , owl::ocrDif = 5 , owl::ocrTiff = 6 , owl::ocrOemText = 7 , owl::ocrDib = 8 , owl::ocrPalette = 9 , owl::ocrPenData = 10 ,   owl::ocrRiff = 11 , owl::ocrWave = 12 , owl::ocrUnicodeText = 13 , owl::ocrEnhMetafile = 14 }
	Format: standard clipboard numeric format, or name of custom format. More...
enum	owl::ocrAspect { owl::ocrContent = 1 , owl::ocrThumbnail = 2 , owl::ocrIcon = 4 , owl::ocrDocPrint = 8 }
	Aspect: view types supported by transfer. More...
enum	owl::ocrMedium { owl::ocrNull = 0 , owl::ocrHGlobal = 1 , owl::ocrFile = 2 , owl::ocrIStream = 4 , owl::ocrIStorage = 8 , owl::ocrGDI = 16 , owl::ocrMfPict = 32 , owl::ocrStaticMed = 1024 }
	Medium: means of data transfer. More...
enum	owl::ocrDirection { owl::ocrGet = 1 , owl::ocrSet = 2 , owl::ocrGetSet = 3 }
	Direction: transfer directions supported. More...
enum	owl::ocrObjectStatus {   owl::ocrRecomposeOnResize = 1 , owl::ocrOnlyIconic = 2 , owl::ocrInsertNotReplace = 4 , owl::ocrStatic = 8 , owl::ocrCantLinkInside = 16 , owl::ocrCanLinkByOle1 = 32 , owl::ocrIsLinkObject = 64 , owl::ocrInsideOut = 128 , owl::ocrActivateWhenVisible = 256 , owl::ocrRenderingIsDeviceIndependent = 512 ,   owl::ocrNoSpecialRendering = 512 }
	IOleObject miscellaneous status flags, defined for each or all aspects. More...
enum	owl::ocrVerbMenuFlags { owl::ocrGrayed = 1 , owl::ocrDisabled = 2 , owl::ocrChecked = 8 , owl::ocrMenuBarBreak = 32 , owl::ocrMenuBreak = 64 }
	IOleObject verb menu flags. More...
enum	owl::ocrVerbAttributes { owl::ocrNeverDirties = 1 , owl::ocrOnContainerMenu = 2 }
	IOleObject verb attribute flags. More...

Variables
const int	owl::ocrVerbLimit = 8
	Maximum number of verbs registered per class.
const int	owl::ocrFormatLimit = 8
	Maximum number of data formats per class.

Detailed Description

Internal classes

Macro Definition Documentation

BEGIN_REGISTRATION

#define BEGIN_REGISTRATION

(

regname

)

Value:

  extern TRegItem regname##_list[];\
  extern TRegFormatHeap __regHeap;\
  TRegList regname(regname##_list);\
  TRegItem regname##_list[] = {

Definition at line 583 of file registry.h.

END_REGISTRATION

#define END_REGISTRATION   {0,{0}} };

Definition at line 589 of file registry.h.

ocrEmbeddedObject

#define ocrEmbeddedObject   _T("Embedded Object")

Definition at line 639 of file registry.h.

ocrEmbedSource

#define ocrEmbedSource   _T("Embed Source")

Definition at line 638 of file registry.h.

ocrLinkSource

#define ocrLinkSource   _T("Link Source")

Definition at line 640 of file registry.h.

ocrLinkSrcDescriptor

#define ocrLinkSrcDescriptor   _T("Link Source Descriptor")

Definition at line 642 of file registry.h.

ocrMultipleLocal

#define ocrMultipleLocal   _T("3")

Multiple clients, separate inproc server.

Definition at line 728 of file registry.h.

ocrMultipleUse

#define ocrMultipleUse   _T("2")

Multiple clients per instance.

Definition at line 727 of file registry.h.

ocrObjectDescriptor

#define ocrObjectDescriptor   _T("Object Descriptor")

Definition at line 641 of file registry.h.

ocrRichText

#define ocrRichText   _T("Rich Text Format")

Definition at line 637 of file registry.h.

ocrSingleUse

#define ocrSingleUse   _T("1")

Single client per instance.

Definition at line 726 of file registry.h.

REGDATA

#define REGDATA	(		var,
			val )   {#var, {val}},

Definition at line 591 of file registry.h.

REGDOCFLAGS

#define REGDOCFLAGS

(

i

)

{"docflags",{TRegItem::RegFlags(i,__regHeap)}},

Definition at line 598 of file registry.h.

REGFORMAT

#define REGFORMAT	(		i,
			f,
			a,
			t,
			d )   {"format" #i,{TRegItem::RegFormat(f,a,t,d,__regHeap)}},

Definition at line 594 of file registry.h.

REGICON

#define REGICON

(

i

)

{"iconindex",{TRegItem::RegFlags(i,__regHeap)}},

Definition at line 597 of file registry.h.

REGISTRATION_FORMAT_BUFFER

#define REGISTRATION_FORMAT_BUFFER

(

n

)

TRegFormatHeap __regHeap;

Definition at line 603 of file registry.h.

REGISTRATION_FORMAT_HEAP

#define REGISTRATION_FORMAT_HEAP    TRegFormatHeap __regHeap;

Definition at line 606 of file registry.h.

REGITEM

#define REGITEM	(		key,
			val )   {" " key, {val}},

Definition at line 593 of file registry.h.

REGSTATUS

#define REGSTATUS	(		a,
			f )   {"aspect" #a, {TRegItem::RegFlags(f,__regHeap)}},

Definition at line 595 of file registry.h.

REGVERBOPT

#define REGVERBOPT	(		v,
			mf,
			sf )   {#v "opt",{TRegItem::RegVerbOpt(mf,sf,__regHeap)}},

Definition at line 596 of file registry.h.

REGXLAT

#define REGXLAT	(		var,
			val )   {#var, {AUTOLANG_XLAT val}},

Definition at line 592 of file registry.h.

Enumeration Type Documentation

ocrAspect

enum owl::ocrAspect

Aspect: view types supported by transfer.

Enumerator
ocrContent	DVASPECT_CONTENT - normal display representation.
ocrThumbnail	DVASPECT_THUMBNAIL - picture appropriate for browser.
ocrIcon	DVASPECT_ICON - iconized representation of object.
ocrDocPrint	DVASPECT_DOCPRINT - print preview representation.

Definition at line 647 of file registry.h.

ocrClipFormat

enum owl::ocrClipFormat

Format: standard clipboard numeric format, or name of custom format.

Enumerator
ocrText	CF_TEXT.
ocrBitmap	CF_BITMAP.
ocrMetafilePict	CF_METAFILEPICT.
ocrSylk	CF_SYLK.
ocrDif	CF_DIF.
ocrTiff	CF_TIFF.
ocrOemText	CF_OEMTEXT.
ocrDib	CF_DIB.
ocrPalette	CF_PALETTE.
ocrPenData	CF_PENDATA.
ocrRiff	CF_RIFF.
ocrWave	CF_WAVE.
ocrUnicodeText	CF_UNICODETEXT Win32 only.
ocrEnhMetafile	CF_ENHMETAFILE Win32 only.

Definition at line 619 of file registry.h.

ocrDirection

enum owl::ocrDirection

Direction: transfer directions supported.

Enumerator
ocrGet
ocrSet
ocrGetSet

Definition at line 673 of file registry.h.

ocrMedium

enum owl::ocrMedium

Medium: means of data transfer.

Enumerator
ocrNull
ocrHGlobal	TYMED_HGLOBAL - global memory handle.
ocrFile	TYMED_FILE - data as contents of file.
ocrIStream	TYMED_ISTREAM - instance of an IStream object.
ocrIStorage	TYMED_ISTORAGE - streams within an instance of IStorage.
ocrGDI	TYMED_GDI - GDI object in global handle.
ocrMfPict	TYMED_MFPICT - CF_METAFILEPICT containing global handle.
ocrStaticMed	OLE 2 static object.

Definition at line 658 of file registry.h.

ocrObjectStatus

enum owl::ocrObjectStatus

IOleObject miscellaneous status flags, defined for each or all aspects.

Enumerator
ocrRecomposeOnResize	Request redraw on container resize.
ocrOnlyIconic	Only useful context view is Icon.
ocrInsertNotReplace	Should not replace current select.
ocrStatic	Object is an OLE static object.
ocrCantLinkInside	Should not be the link source.
ocrCanLinkByOle1	Only used in OBJECTDESCRIPTOR.
ocrIsLinkObject	Set by OLE2 link for OLE1 compat.
ocrInsideOut	Can be activated concurrently.
ocrActivateWhenVisible	Hint to cntnr when ocrInsideOut set.
ocrRenderingIsDeviceIndependent	No decisions made based on target.
ocrNoSpecialRendering	Older enum for previous entry.

Definition at line 687 of file registry.h.

ocrVerbAttributes

enum owl::ocrVerbAttributes

IOleObject verb attribute flags.

Enumerator
ocrNeverDirties	Verb can never cause object to become dirty.
ocrOnContainerMenu	Only useful context view is Icon.

Definition at line 717 of file registry.h.

ocrVerbMenuFlags

enum owl::ocrVerbMenuFlags

IOleObject verb menu flags.

Enumerator
ocrGrayed	MF_GRAYED.
ocrDisabled	MF_DISABLED.
ocrChecked	MF_CHECKED.
ocrMenuBarBreak	MF_MENUBARBREAK.
ocrMenuBreak	MF_MENUBAR.

Definition at line 705 of file registry.h.

Variable Documentation

ocrFormatLimit

const int owl::ocrFormatLimit = 8

Maximum number of data formats per class.

Definition at line 614 of file registry.h.

ocrVerbLimit

const int owl::ocrVerbLimit = 8

Maximum number of verbs registered per class.

Definition at line 613 of file registry.h.