barrier/lib/platform/COSXClipboard.h

/*
 * synergy -- mouse and keyboard sharing utility
 * Copyright (C) 2004 Chris Schoeneman
 * 
 * This package is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * found in the file COPYING that should have accompanied this file.
 * 
 * This package is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */

#ifndef COSXCLIPBOARD_H
#define COSXCLIPBOARD_H

#include <Carbon/Carbon.h>
#include "IClipboard.h"
#include <vector>

class IOSXClipboardConverter;

//! OS X clipboard implementation
class COSXClipboard : public IClipboard {
public:
	COSXClipboard();
	virtual ~COSXClipboard();

	//! Test if clipboard is owned by synergy
	static bool			isOwnedBySynergy();

	// IClipboard overrides
	virtual bool		empty();
	virtual void		add(EFormat, const CString& data);
	virtual bool		open(Time) const;
	virtual void		close() const;
	virtual Time		getTime() const;
	virtual bool		has(EFormat) const;
	virtual CString		get(EFormat) const;

private:
	void				clearConverters();
	static CFStringRef
						getOwnershipFlavor();

private:
	typedef std::vector<IOSXClipboardConverter*> ConverterList;

	mutable Time		m_time;
	ConverterList		m_converters;
	mutable PasteboardRef	m_pboard;
};

//! Clipboard format converter interface
/*!
This interface defines the methods common to all Scrap book format
*/
class IOSXClipboardConverter : public IInterface {
public:
	//! @name accessors
	//@{

	//! Get clipboard format
	/*!
	Return the clipboard format this object converts from/to.
	*/
	virtual IClipboard::EFormat
						getFormat() const = 0;

	//! returns the scrap flavor type that this object converts from/to
	virtual CFStringRef
						getOSXFormat() const = 0;

	//! Convert from IClipboard format
	/*!
	Convert from the IClipboard format to the Carbon scrap format.
	The input data must be in the IClipboard format returned by
	getFormat().  The return data will be in the scrap
	format returned by getOSXFormat().
	*/
	virtual CString		fromIClipboard(const CString&) const = 0;

	//! Convert to IClipboard format
	/*!
	Convert from the carbon scrap format to the IClipboard format
	(i.e., the reverse of fromIClipboard()).
	*/
	virtual CString		toIClipboard(const CString&) const = 0;

	//@}
};

#endif