MetaFileClipMap Class Reference

A class which describes and implements an available mapping between internal and external data formats. More...

#include <metafilt.h>

Inheritance diagram for MetaFileClipMap:

List of all members.

Static Public Member Functions
static void	CreateAndRegister (ClipboardMappingType TheType, Filter *TheFilter, InternalClipboardFormat &InternalDataType, UINT32 ExternalDataType, UINT32 Priority)
	Constructs and registers a clipboard mapping with the ExternalClipboard manager. This mapping info describes a filter which is able to import data from or export data to a windows clipboard in some way.
Protected Member Functions
	MetaFileClipMap ()
	MetaFileClipMap (ClipboardMappingType TheType, Filter *TheFilter, InternalClipboardFormat &InternalDataType, UINT32 ExternalDataType, UINT32 Priority)
	Constructs a clipboard mapping with the ExternalClipboard manager. This mapping info describes a filter which is able to import data from or export data to a windows clipboard in some way.
virtual BOOL	HandleImport (SelOperation *Caller, HANDLE ClipboardData, InternalClipboard *Dest)
	Calls the parent filter as appropriate to import the given data from the external clipboard.
virtual HANDLE	HandleExport (Operation *Caller, InternalClipboard *Source)
	Invokes this mapping for exporting This takes the document tree of Source, and exports it to the external (windows) clipboard. Usually this just involves calling Filter::DoExport for the parent filter, and then returning the handle to the global memory block to be placed onto the external clipboard.
Friends
class	ExternalClipboard
class	OpClipboardExport
class	OpClipboardImport

---

Detailed Description

A class which describes and implements an available mapping between internal and external data formats.

Author:

Jason_Williams (Xara Group Ltd) <camelotdev@xara.com>

Date:

20/4/95

This class implements clipboard import/export functionality for Windows MetaFiles, using the MetaFile Filter.

See also:

ExternalClipboard; Filter; MetaFileFilter

Definition at line 162 of file metafilt.h.

---

Constructor & Destructor Documentation

MetaFileClipMap::MetaFileClipMap (   )  [inline, protected]

Definition at line 171 of file metafilt.h. {}

MetaFileClipMap::MetaFileClipMap (  ClipboardMappingType  TheType, Filter *  TheFilter, InternalClipboardFormat &  TheInternalDataType, UINT32  TheExternalDataType, UINT32  ThePriority )  [protected]

Constructs a clipboard mapping with the ExternalClipboard manager. This mapping info describes a filter which is able to import data from or export data to a windows clipboard in some way. Parameters: TheType  - 1 (import), 2 (export), or 3 (import and export) [INPUTS] TheFilter - The filter which can apply this conversion TheInternalDatatType - An object defining the internal data type (see cliptype.h) TheExternalDataType - A Windows CF_ constant defining the external clipboard data type which will be imported/exported. ThePriority - An integer indicating the priority of this mapping. The highest available priority mapping will be used in order to retain as much information in the data as possible. See docs.doc for details of the existing mappings. Notes: DON'T call the constructor - call CreateAndRegister See also: MetaFileClipMap::CreateAndRegister Definition at line 773 of file metafilt.cpp. : ClipboardMapping(TheType, TheFilter, TheInternalDataType, TheExternalDataType, ThePriority) { }

---

Member Function Documentation

void MetaFileClipMap::CreateAndRegister (  ClipboardMappingType  TheType, Filter *  TheFilter, InternalClipboardFormat &  TheInternalDataType, UINT32  TheExternalDataType, UINT32  ThePriority )  [static]

Constructs and registers a clipboard mapping with the ExternalClipboard manager. This mapping info describes a filter which is able to import data from or export data to a windows clipboard in some way. Parameters: ImportOrExport  - TRUE == Import, FALSE == Export [INPUTS] TheFilter - The filter which can apply this conversion TheInternalDatatType - An object defining the internal data type (see cliptype.h) TheExternalDataType - A Windows CF_ constant defining the external clipboard data type which will be imported/exported. ThePriority - An integer indicating the priority of this mapping. The highest available priority mapping will be used in order to retain as much information in the data as possible. See docs.doc for details of the existing mappings. Reimplemented from ClipboardMapping. Definition at line 813 of file metafilt.cpp. { MetaFileClipMap *Mapping = new MetaFileClipMap(TheType, TheFilter, TheInternalDataType, TheExternalDataType, ThePriority); if (Mapping == NULL) InformError(); else ExternalClipboard::RegisterDataType(Mapping); }

HANDLE MetaFileClipMap::HandleExport (  Operation *  Caller, InternalClipboard *  Source )  [protected, virtual]

Invokes this mapping for exporting This takes the document tree of Source, and exports it to the external (windows) clipboard. Usually this just involves calling Filter::DoExport for the parent filter, and then returning the handle to the global memory block to be placed onto the external clipboard. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 20/4/95 Parameters: Caller  - the operation within which this method is being called [INPUTS] Source - the internal clipboard (document) to be exported Returns: NULL (if it failed), or a windows handle of the data to be placed on the clipboard. Notes: The returned handle should be the thing you'd pass to SetClipboardData if you were dealing with it directly. You must adhere to all the Windows rules for this - i.e. a global data block, unlocked, etc etc. Reimplemented from ClipboardMapping. Definition at line 914 of file metafilt.cpp. { #if (_OLE_VER >= 0x200) // Check if we need to allocate some memory. HANDLE hGlobalMem; if ((hGlobalMem = m_hMem) != 0) { // We have some already. Is it big enough? if (m_cbMemSize < sizeof(METAFILEPICT)) return 0; } else { // We must allocate some. hGlobalMem = m_hMem = GlobalAlloc(GHND, sizeof(METAFILEPICT)); if (!hGlobalMem) return 0; } #else HANDLE hGlobalMem = GlobalAlloc(GHND, sizeof(METAFILEPICT)); if (!hGlobalMem) return 0; #endif METAFILEPICT* Info = (METAFILEPICT*) GlobalLock(hGlobalMem); // Initialise to suitable defaults, just in case Info->mm = MM_ANISOTROPIC; Info->xExt = 0; Info->yExt = 0; Info->hMF = NULL; // --- Now, export the source clipboard to a memory metafile // Create a dummy MemFile to keep the exporter happy char *temp[1024]; CCMemFile DummyFile(temp, 1000); ((MetaFileFilter *)pFilter)->DoExport(Caller, &DummyFile, (Document *)Source, Info); if (DummyFile.isOpen()) DummyFile.close(); // -- Finally, lob the metafile on the clipboard (we can forget about it now, as // it is now owned (and will be deleted) by the OS) // We must unlock the block before giving it to the clipboard GlobalUnlock(hGlobalMem); return(hGlobalMem); }

BOOL MetaFileClipMap::HandleImport (  SelOperation *  Caller, HANDLE  ClipboardData, InternalClipboard *  Dest )  [protected, virtual]

Calls the parent filter as appropriate to import the given data from the external clipboard. Parameters: Caller  - The operation within which this method is being called [INPUTS] ClipboardData - The result of calling GetClipboardData for your datatype Dest - The InternalClipboard (document) to import the data into. Returns: TRUE for success Reimplemented from ClipboardMapping. Definition at line 848 of file metafilt.cpp. { BOOL ok = FALSE; // Get a scratch file - if TMP isn't set, this will try for c:\temp. // The filename will have XS as a prefix char *tempname = GetTempFileName(); //_ttempnam("C:\temp", "XS"); if (tempname == NULL) { ERROR3("Couldn't get a temp filename"); return(FALSE); } // --- // Get the header data out of the clipboard, and copy the referenced metafile to disc METAFILEPICT *Info = (METAFILEPICT *) GlobalLock(ClipboardData); if (Info == NULL) { RemoveTempFile(); return(FALSE); } HMETAFILE hCopy = CopyMetaFile(Info->hMF, tempname); GlobalUnlock(ClipboardData); if (hCopy != NULL) { ok = ImportFromTempFile(tempname, Caller, Dest); DeleteMetaFile(hCopy); } RemoveTempFile(); return(ok); }

---

Friends And Related Function Documentation

friend class ExternalClipboard [friend]

Reimplemented from ClipboardMapping. Definition at line 166 of file metafilt.h.

friend class OpClipboardExport [friend]

Reimplemented from ClipboardMapping. Definition at line 167 of file metafilt.h.

friend class OpClipboardImport [friend]

Reimplemented from ClipboardMapping. Definition at line 168 of file metafilt.h.

---

The documentation for this class was generated from the following files:

• wxOil/metafilt.h (r1785/r1282)
• wxOil/metafilt.cpp (r1785/r1282)

---