[wxWidgets.git] / contrib / src / stc / scintilla / include / Platform.h

// Scintilla source code edit control
// Platform.h - interface to platform facilities
// Also includes some basic utilities
// Implemented in PlatGTK.cxx for GTK+/Linux, PlatWin.cxx for Windows, and PlatWX.cxx for wxWindows
// Copyright 1998-2000 by Neil Hodgson <neilh@scintilla.org>
// The License.txt file describes the conditions under which this software may be distributed.

#ifndef PLATFORM_H
#define PLATFORM_H

// PLAT_GTK = GTK+ on Linux, PLAT_WIN = Win32 API on Win32 OS
// PLAT_WX is wxWindows on any supported platform
// Could also have PLAT_GTKWIN = GTK+ on Win32 OS in future

#define PLAT_GTK 0
#define PLAT_WIN 0
#define PLAT_WX  0

#if defined(__WX__)
#undef PLAT_WX
#define PLAT_WX  1

#elif defined(GTK)
#undef PLAT_GTK
#define PLAT_GTK 1

#else
#undef PLAT_WIN
#define PLAT_WIN 1

#endif


// Include the main header for each platform

#if PLAT_GTK
#include <gtk/gtk.h>
#include <gdk/gdkkeysyms.h>
#endif

#if PLAT_WIN
#define _WIN32_WINNT  0x0400 // Otherwise some required stuff gets ifdef'd out
// Vassili Bourdo: shut up annoying Visual C++ warnings:
#ifdef _MSC_VER
#pragma warning(disable: 4800 4244 4309)
#endif
#include <windows.h>
#include <commctrl.h>
#include <richedit.h>
#endif

#if PLAT_WX
#include <wx/wx.h>
#endif

// Underlying the implementation of the platform classes are platform specific types.
// Sometimes these need to be passed around by client code so they are defined here

#if PLAT_GTK
typedef GdkColor ColourID;
typedef GdkFont* FontID;
typedef GdkDrawable* SurfaceID;
typedef GtkWidget* WindowID;
typedef GtkItemFactory* MenuID;
#endif

#if PLAT_WIN
typedef COLORREF ColourID;
typedef HFONT FontID;
typedef HDC SurfaceID;
typedef HWND WindowID;
typedef HMENU MenuID;
#endif

#if PLAT_WX
typedef wxColour ColourID;
typedef wxFont* FontID;
typedef wxDC* SurfaceID;
typedef wxWindow* WindowID;
typedef wxMenu* MenuID;
#endif

// Point is exactly the same as the Win32 POINT and GTK+ GdkPoint so can be used interchangeably

class Point {
public:
	int x;
	int y;
	
	Point(int x_=0, int y_=0) : x(x_), y(y_) {
	}

	// Other automatically defined methods (assignment, copy constructor, destructor) are fine
	
	static Point FromLong(long lpoint);
};

// PRectangle is exactly the same as the Win32 RECT so can be used interchangeably
// PRectangles contain their top and left sides, but not their right and bottom sides
class PRectangle {
public:
	int left;
	int top;
	int right;
	int bottom;

	PRectangle(int left_=0, int top_=0, int right_=0, int bottom_ = 0) :
		left(left_), top(top_), right(right_), bottom(bottom_) {
	}

	// Other automatically defined methods (assignment, copy constructor, destructor) are fine

	bool Contains(Point pt) {
		return (pt.x >= left) && (pt.x <= right) &&
			(pt.y >= top) && (pt.y <= bottom);
	}
	bool Contains(PRectangle rc) {
		return (rc.left >= left) && (rc.right <= right) &&
			(rc.top >= top) && (rc.bottom <= bottom);
	}
	bool Intersects(PRectangle other) {
		return (right >= other.left) && (left <= other.right) &&
			(bottom >= other.top) && (top <= other.bottom);
	}
	int Width() { return right - left; }
	int Height() { return bottom - top; }
};

#if PLAT_WX
wxRect wxRectFromPRectangle(PRectangle prc);
PRectangle PRectangleFromwxRect(wxRect rc);
#endif

class Colour {
	ColourID co;
public:
	Colour(long lcol=0);
	Colour(unsigned int red, unsigned int green, unsigned int blue);
	bool operator==(const Colour &other) const;
	long AsLong() const;
	unsigned int GetRed();
	unsigned int GetGreen();
	unsigned int GetBlue();
	
	friend class Surface;
	friend class Palette;
};

// Colour pairs hold a desired colour and the colour that the graphics engine
// allocates to approximate the desired colour.
// To make palette management more automatic, ColourPairs could register at 
// construction time with a palette management object.
struct ColourPair {
	Colour desired;
	Colour allocated;

	ColourPair(Colour desired_=Colour(0,0,0)) {
		desired = desired_;
		allocated = desired;
	}
};

class Window;	// Forward declaration for Palette

class Palette {
	int used;
	enum {numEntries = 100};
	ColourPair entries[numEntries];
#if PLAT_GTK
	GdkColor *allocatedPalette;
	int allocatedLen;
#elif PLAT_WIN
	HPALETTE hpal;
#elif PLAT_WX
	// wxPalette* pal;  // **** Is this needed?
#endif
public:
	bool allowRealization;
	
	Palette();
	~Palette();

	void Release();
	
	// This method either adds a colour to the list of wanted colours (want==true)
	// or retrieves the allocated colour back to the ColourPair.
	// This is one method to make it easier to keep the code for wanting and retrieving in sync.
	void WantFind(ColourPair &cp, bool want);

	void Allocate(Window &w);
	
	friend class Surface;
};

class Font {
protected:
	FontID id;
#if PLAT_WX
	int ascent;
#endif
	// Private so Font objects can not be copied
	Font(const Font &) {}
	Font &operator=(const Font &) { id=0; return *this; }
public:
	Font();
	virtual ~Font();

	virtual void Create(const char *faceName, int characterSet, int size, bool bold, bool italic);
	virtual void Release();

	FontID GetID() { return id; }
	// Alias another font - caller guarantees not to Release
	void SetID(FontID id_) { id = id_; }
	friend class Surface;
};

// A surface abstracts a place to draw
class Surface {
private:
	bool unicodeMode;
#if PLAT_GTK
	GdkDrawable *drawable;
	GdkGC *gc;
	GdkPixmap *ppixmap;
	int x;
	int y;
	bool inited;
	bool createdGC;
#elif PLAT_WIN
	HDC hdc;
	bool hdcOwned;
	HPEN pen;
	HPEN penOld;
	HBRUSH brush;
	HBRUSH brushOld;
	HFONT font;
	HFONT fontOld;
	HBITMAP bitmap;
	HBITMAP bitmapOld;
	HPALETTE paletteOld;
#elif PLAT_WX
	wxDC* hdc;
	bool hdcOwned;
	wxBitmap* bitmap;
	int x;
	int y;
#endif

	// Private so Surface objects can not be copied
	Surface(const Surface &) {}
	Surface &operator=(const Surface &) { return *this; }
#if PLAT_WIN || PLAT_WX
	void BrushColor(Colour back);
	void SetFont(Font &font_);
#endif
public:
	Surface();
	~Surface();
	
	void Init();
	void Init(SurfaceID hdc_);
	void InitPixMap(int width, int height, Surface *surface_);

	void Release();
	bool Initialised();
	void PenColour(Colour fore);
	int LogPixelsY();
	int DeviceHeightFont(int points);
	void MoveTo(int x_, int y_);
	void LineTo(int x_, int y_);
	void Polygon(Point *pts, int npts, Colour fore, Colour back);
	void RectangleDraw(PRectangle rc, Colour fore, Colour back);
	void FillRectangle(PRectangle rc, Colour back);
	void FillRectangle(PRectangle rc, Surface &surfacePattern);
	void RoundedRectangle(PRectangle rc, Colour fore, Colour back);
	void Ellipse(PRectangle rc, Colour fore, Colour back);
	void Copy(PRectangle rc, Point from, Surface &surfaceSource);

	void DrawText(PRectangle rc, Font &font_, int ybase, const char *s, int len, Colour fore, Colour back);
	void DrawTextClipped(PRectangle rc, Font &font_, int ybase, const char *s, int len, Colour fore, Colour back);
	void MeasureWidths(Font &font_, const char *s, int len, int *positions);
	int WidthText(Font &font_, const char *s, int len);
	int WidthChar(Font &font_, char ch);
	int Ascent(Font &font_);
	int Descent(Font &font_);
	int InternalLeading(Font &font_);
	int ExternalLeading(Font &font_);
	int Height(Font &font_);
	int AverageCharWidth(Font &font_);
	
	int SetPalette(Palette *pal, bool inBackGround);
	void SetClip(PRectangle rc);
	void FlushCachedState();

	void SetUnicodeMode(bool unicodeMode_) {
		unicodeMode=unicodeMode_;
	}
};

// Class to hide the details of window manipulation
// Does not own the window which will normally have a longer life than this object
class Window {
	friend class ListBox;
protected:
	WindowID id;
public:
	Window() : id(0) {}
	Window(const Window &source) : id(source.id) {}
	virtual ~Window();
	Window &operator=(WindowID id_) {
		id = id_;
		return *this;
	}
	WindowID GetID() { return id; }
	bool Created() { return id != 0; }
	void Destroy();
	bool HasFocus();
	PRectangle GetPosition();
	void SetPosition(PRectangle rc);
	void SetPositionRelative(PRectangle rc, Window relativeTo);
	PRectangle GetClientPosition();
	void Show(bool show=true);
	void InvalidateAll();
	void InvalidateRectangle(PRectangle rc);
	virtual void SetFont(Font &font);
	enum Cursor { cursorText, cursorArrow, cursorUp, cursorWait, cursorHoriz, cursorVert, cursorReverseArrow };
	void SetCursor(Cursor curs);
	void SetTitle(const char *s);
#if PLAT_WIN
	LRESULT SendMessage(UINT msg, WPARAM wParam=0, LPARAM lParam=0);
	int GetDlgCtrlID();
	HINSTANCE GetInstance();
#endif
};

class ListBox : public Window {
#if PLAT_GTK
	WindowID list;
	WindowID scroller;
	int current;
#endif
	int desiredVisibleRows;
	unsigned int maxItemCharacters;
	unsigned int aveCharWidth;
public:
	ListBox();
	virtual ~ListBox();
	void Create(Window &parent, int ctrlID);
	virtual void SetFont(Font &font);
	void SetAverageCharWidth(int width);
	void SetVisibleRows(int rows);
	PRectangle GetDesiredRect();
	void Clear();
	void Append(char *s);
	int Length();
	void Select(int n);
	int GetSelection();
	int Find(const char *prefix);
	void GetValue(int n, char *value, int len);
	void Sort();
};

class Menu {
	MenuID id;
public:
	Menu();
	MenuID GetID() { return id; }
	void CreatePopUp();
	void Destroy();
	void Show(Point pt, Window &w);
};

// Platform class used to retrieve system wide parameters such as double click speed
// and chrome colour. Not a creatable object, more of a module with several functions.
class Platform {
	// Private so Platform objects can not be copied
	Platform(const Platform &) {}
	Platform &operator=(const Platform &) { return *this; }
public:
	// Should be private because no new Platforms are ever created
	// but gcc warns about this
	Platform() {}
	~Platform() {}
	static Colour Chrome();
	static Colour ChromeHighlight();
	static const char *DefaultFont();
	static int DefaultFontSize();
	static unsigned int DoubleClickTime();
	static void DebugDisplay(const char *s);
	static bool IsKeyDown(int key);
	static long SendScintilla(
		WindowID w, unsigned int msg, unsigned long wParam=0, long lParam=0);
	
	// These are utility functions not really tied to a platform
	static int Minimum(int a, int b);
	static int Maximum(int a, int b);
	// Next three assume 16 bit shorts and 32 bit longs
	static long LongFromTwoShorts(short a,short b) {
		return (a) | ((b) << 16);
	}
	static short HighShortFromLong(long x) {
		return static_cast<short>(x >> 16);
	}
	static short LowShortFromLong(long x) {
		return static_cast<short>(x & 0xffff);
	}
	static void DebugPrintf(const char *format, ...);
	static int Clamp(int val, int minVal, int maxVal);
};

#endif
Commit	Line	Data
9ce192d4 RD	1	// Scintilla source code edit control
	2	// Platform.h - interface to platform facilities
	3	// Also includes some basic utilities
	4	// Implemented in PlatGTK.cxx for GTK+/Linux, PlatWin.cxx for Windows, and PlatWX.cxx for wxWindows
	5	// Copyright 1998-2000 by Neil Hodgson <neilh@scintilla.org>
	6	// The License.txt file describes the conditions under which this software may be distributed.
	7
	8	#ifndef PLATFORM_H
	9	#define PLATFORM_H
	10
	11	// PLAT_GTK = GTK+ on Linux, PLAT_WIN = Win32 API on Win32 OS
	12	// PLAT_WX is wxWindows on any supported platform
	13	// Could also have PLAT_GTKWIN = GTK+ on Win32 OS in future
	14
	15	#define PLAT_GTK 0
	16	#define PLAT_WIN 0
	17	#define PLAT_WX 0
	18
	19	#if defined(__WX__)
	20	#undef PLAT_WX
	21	#define PLAT_WX 1
	22
	23	#elif defined(GTK)
	24	#undef PLAT_GTK
	25	#define PLAT_GTK 1
	26
	27	#else
	28	#undef PLAT_WIN
	29	#define PLAT_WIN 1
	30
	31	#endif
	32
	33
	34	// Include the main header for each platform
	35
	36	#if PLAT_GTK
	37	#include <gtk/gtk.h>
	38	#include <gdk/gdkkeysyms.h>
	39	#endif
	40
	41	#if PLAT_WIN
	42	#define _WIN32_WINNT 0x0400 // Otherwise some required stuff gets ifdef'd out
	43	// Vassili Bourdo: shut up annoying Visual C++ warnings:
	44	#ifdef _MSC_VER
	45	#pragma warning(disable: 4800 4244 4309)
	46	#endif
	47	#include <windows.h>
f6bcfd97	48	#include <commctrl.h>
9ce192d4 RD	49	#include <richedit.h>
	50	#endif
	51
	52	#if PLAT_WX
	53	#include <wx/wx.h>
	54	#endif
	55
	56	// Underlying the implementation of the platform classes are platform specific types.
	57	// Sometimes these need to be passed around by client code so they are defined here
	58
	59	#if PLAT_GTK
	60	typedef GdkColor ColourID;
	61	typedef GdkFont* FontID;
	62	typedef GdkDrawable* SurfaceID;
	63	typedef GtkWidget* WindowID;
	64	typedef GtkItemFactory* MenuID;
	65	#endif
	66
	67	#if PLAT_WIN
	68	typedef COLORREF ColourID;
	69	typedef HFONT FontID;
	70	typedef HDC SurfaceID;
	71	typedef HWND WindowID;
	72	typedef HMENU MenuID;
	73	#endif
	74
	75	#if PLAT_WX
	76	typedef wxColour ColourID;
	77	typedef wxFont* FontID;
	78	typedef wxDC* SurfaceID;
	79	typedef wxWindow* WindowID;
	80	typedef wxMenu* MenuID;
	81	#endif
	82
9ce192d4 RD	83	// Point is exactly the same as the Win32 POINT and GTK+ GdkPoint so can be used interchangeably
	84
	85	class Point {
	86	public:
	87	int x;
	88	int y;
	89
	90	Point(int x_=0, int y_=0) : x(x_), y(y_) {
	91	}
	92
	93	// Other automatically defined methods (assignment, copy constructor, destructor) are fine
	94
	95	static Point FromLong(long lpoint);
	96	};
	97
	98	// PRectangle is exactly the same as the Win32 RECT so can be used interchangeably
	99	// PRectangles contain their top and left sides, but not their right and bottom sides
	100	class PRectangle {
	101	public:
	102	int left;
	103	int top;
	104	int right;
	105	int bottom;
	106
	107	PRectangle(int left_=0, int top_=0, int right_=0, int bottom_ = 0) :
	108	left(left_), top(top_), right(right_), bottom(bottom_) {
	109	}
	110
	111	// Other automatically defined methods (assignment, copy constructor, destructor) are fine
	112
	113	bool Contains(Point pt) {
	114	return (pt.x >= left) && (pt.x <= right) &&
	115	(pt.y >= top) && (pt.y <= bottom);
	116	}
	117	bool Contains(PRectangle rc) {
	118	return (rc.left >= left) && (rc.right <= right) &&
	119	(rc.top >= top) && (rc.bottom <= bottom);
	120	}
	121	bool Intersects(PRectangle other) {
	122	return (right >= other.left) && (left <= other.right) &&
	123	(bottom >= other.top) && (top <= other.bottom);
	124	}
	125	int Width() { return right - left; }
	126	int Height() { return bottom - top; }
	127	};
	128
	129	#if PLAT_WX
	130	wxRect wxRectFromPRectangle(PRectangle prc);
	131	PRectangle PRectangleFromwxRect(wxRect rc);
	132	#endif
	133
	134	class Colour {
	135	ColourID co;
	136	public:
	137	Colour(long lcol=0);
	138	Colour(unsigned int red, unsigned int green, unsigned int blue);
	139	bool operator==(const Colour &other) const;
	140	long AsLong() const;
	141	unsigned int GetRed();
	142	unsigned int GetGreen();
	143	unsigned int GetBlue();
	144
	145	friend class Surface;
	146	friend class Palette;
147	};
148
149	// Colour pairs hold a desired colour and the colour that the graphics engine
150	// allocates to approximate the desired colour.
151	// To make palette management more automatic, ColourPairs could register at
152	// construction time with a palette management object.
153	struct ColourPair {
154	Colour desired;
155	Colour allocated;
156
157	ColourPair(Colour desired_=Colour(0,0,0)) {
158	desired = desired_;
159	allocated = desired;
160	}
161	};
162
163	class Window; // Forward declaration for Palette
164
165	class Palette {
166	int used;
167	enum {numEntries = 100};
168	ColourPair entries[numEntries];
169	#if PLAT_GTK
170	GdkColor *allocatedPalette;
171	int allocatedLen;
172	#elif PLAT_WIN
173	HPALETTE hpal;
174	#elif PLAT_WX
175	// wxPalette* pal; // **** Is this needed?
176	#endif
177	public:
178	bool allowRealization;
179
180	Palette();
181	~Palette();
182
183	void Release();
184
185	// This method either adds a colour to the list of wanted colours (want==true)
186	// or retrieves the allocated colour back to the ColourPair.
187	// This is one method to make it easier to keep the code for wanting and retrieving in sync.
188	void WantFind(ColourPair &cp, bool want);
189
190	void Allocate(Window &w);
191
192	friend class Surface;
193	};
194
195	class Font {
d134f170	196	protected:
9ce192d4 RD	197	FontID id;
	198	#if PLAT_WX
	199	int ascent;
	200	#endif
	201	// Private so Font objects can not be copied
	202	Font(const Font &) {}
	203	Font &operator=(const Font &) { id=0; return *this; }
	204	public:
	205	Font();
d134f170	206	virtual ~Font();
9ce192d4	207
d134f170 RD	208	virtual void Create(const char *faceName, int characterSet, int size, bool bold, bool italic);
d134f170 RD	209	virtual void Release();
9ce192d4 RD	210
9ce192d4 RD	211	FontID GetID() { return id; }
f6bcfd97 BP	212	// Alias another font - caller guarantees not to Release
f6bcfd97 BP	213	void SetID(FontID id_) { id = id_; }
9ce192d4 RD	214	friend class Surface;
	215	};
	216
	217	// A surface abstracts a place to draw
	218	class Surface {
	219	private:
f6bcfd97	220	bool unicodeMode;
9ce192d4 RD	221	#if PLAT_GTK
	222	GdkDrawable *drawable;
	223	GdkGC *gc;
	224	GdkPixmap *ppixmap;
	225	int x;
	226	int y;
	227	bool inited;
	228	bool createdGC;
	229	#elif PLAT_WIN
	230	HDC hdc;
	231	bool hdcOwned;
	232	HPEN pen;
	233	HPEN penOld;
	234	HBRUSH brush;
	235	HBRUSH brushOld;
	236	HFONT font;
	237	HFONT fontOld;
	238	HBITMAP bitmap;
	239	HBITMAP bitmapOld;
	240	HPALETTE paletteOld;
	241	#elif PLAT_WX
	242	wxDC* hdc;
	243	bool hdcOwned;
	244	wxBitmap* bitmap;
	245	int x;
	246	int y;
	247	#endif
	248
	249	// Private so Surface objects can not be copied
	250	Surface(const Surface &) {}
	251	Surface &operator=(const Surface &) { return *this; }
	252	#if PLAT_WIN \|\| PLAT_WX
	253	void BrushColor(Colour back);
	254	void SetFont(Font &font_);
	255	#endif
	256	public:
	257	Surface();
	258	~Surface();
	259
	260	void Init();
	261	void Init(SurfaceID hdc_);
	262	void InitPixMap(int width, int height, Surface *surface_);
	263
	264	void Release();
	265	bool Initialised();
	266	void PenColour(Colour fore);
	267	int LogPixelsY();
f6bcfd97	268	int DeviceHeightFont(int points);
9ce192d4 RD	269	void MoveTo(int x_, int y_);
	270	void LineTo(int x_, int y_);
	271	void Polygon(Point *pts, int npts, Colour fore, Colour back);
	272	void RectangleDraw(PRectangle rc, Colour fore, Colour back);
	273	void FillRectangle(PRectangle rc, Colour back);
	274	void FillRectangle(PRectangle rc, Surface &surfacePattern);
	275	void RoundedRectangle(PRectangle rc, Colour fore, Colour back);
	276	void Ellipse(PRectangle rc, Colour fore, Colour back);
	277	void Copy(PRectangle rc, Point from, Surface &surfaceSource);
	278
	279	void DrawText(PRectangle rc, Font &font_, int ybase, const char *s, int len, Colour fore, Colour back);
	280	void DrawTextClipped(PRectangle rc, Font &font_, int ybase, const char *s, int len, Colour fore, Colour back);
	281	void MeasureWidths(Font &font_, const char s, int len, int positions);
	282	int WidthText(Font &font_, const char *s, int len);
	283	int WidthChar(Font &font_, char ch);
	284	int Ascent(Font &font_);
	285	int Descent(Font &font_);
	286	int InternalLeading(Font &font_);
	287	int ExternalLeading(Font &font_);
	288	int Height(Font &font_);
	289	int AverageCharWidth(Font &font_);
	290
	291	int SetPalette(Palette *pal, bool inBackGround);
	292	void SetClip(PRectangle rc);
f6bcfd97 BP	293	void FlushCachedState();
	294
	295	void SetUnicodeMode(bool unicodeMode_) {
	296	unicodeMode=unicodeMode_;
	297	}
9ce192d4 RD	298	};
	299
	300	// Class to hide the details of window manipulation
	301	// Does not own the window which will normally have a longer life than this object
	302	class Window {
	303	friend class ListBox;
	304	protected:
	305	WindowID id;
	306	public:
	307	Window() : id(0) {}
f6bcfd97	308	Window(const Window &source) : id(source.id) {}
9ce192d4 RD	309	virtual ~Window();
	310	Window &operator=(WindowID id_) {
	311	id = id_;
	312	return *this;
	313	}
	314	WindowID GetID() { return id; }
	315	bool Created() { return id != 0; }
	316	void Destroy();
	317	bool HasFocus();
	318	PRectangle GetPosition();
	319	void SetPosition(PRectangle rc);
	320	void SetPositionRelative(PRectangle rc, Window relativeTo);
	321	PRectangle GetClientPosition();
	322	void Show(bool show=true);
	323	void InvalidateAll();
	324	void InvalidateRectangle(PRectangle rc);
d134f170	325	virtual void SetFont(Font &font);
9ce192d4 RD	326	enum Cursor { cursorText, cursorArrow, cursorUp, cursorWait, cursorHoriz, cursorVert, cursorReverseArrow };
	327	void SetCursor(Cursor curs);
	328	void SetTitle(const char *s);
	329	#if PLAT_WIN
	330	LRESULT SendMessage(UINT msg, WPARAM wParam=0, LPARAM lParam=0);
	331	int GetDlgCtrlID();
	332	HINSTANCE GetInstance();
	333	#endif
	334	};
	335
	336	class ListBox : public Window {
	337	#if PLAT_GTK
	338	WindowID list;
	339	WindowID scroller;
	340	int current;
	341	#endif
d134f170 RD	342	int desiredVisibleRows;
	343	unsigned int maxItemCharacters;
	344	unsigned int aveCharWidth;
9ce192d4 RD	345	public:
	346	ListBox();
	347	virtual ~ListBox();
9ce192d4	348	void Create(Window &parent, int ctrlID);
d134f170 RD	349	virtual void SetFont(Font &font);
	350	void SetAverageCharWidth(int width);
	351	void SetVisibleRows(int rows);
	352	PRectangle GetDesiredRect();
9ce192d4 RD	353	void Clear();
	354	void Append(char *s);
	355	int Length();
	356	void Select(int n);
	357	int GetSelection();
	358	int Find(const char *prefix);
	359	void GetValue(int n, char *value, int len);
	360	void Sort();
	361	};
	362
	363	class Menu {
	364	MenuID id;
	365	public:
	366	Menu();
	367	MenuID GetID() { return id; }
	368	void CreatePopUp();
	369	void Destroy();
	370	void Show(Point pt, Window &w);
	371	};
	372
	373	// Platform class used to retrieve system wide parameters such as double click speed
	374	// and chrome colour. Not a creatable object, more of a module with several functions.
	375	class Platform {
	376	// Private so Platform objects can not be copied
	377	Platform(const Platform &) {}
	378	Platform &operator=(const Platform &) { return *this; }
	379	public:
	380	// Should be private because no new Platforms are ever created
	381	// but gcc warns about this
	382	Platform() {}
	383	~Platform() {}
	384	static Colour Chrome();
	385	static Colour ChromeHighlight();
	386	static const char *DefaultFont();
	387	static int DefaultFontSize();
	388	static unsigned int DoubleClickTime();
	389	static void DebugDisplay(const char *s);
	390	static bool IsKeyDown(int key);
	391	static long SendScintilla(
	392	WindowID w, unsigned int msg, unsigned long wParam=0, long lParam=0);
	393
	394	// These are utility functions not really tied to a platform
	395	static int Minimum(int a, int b);
	396	static int Maximum(int a, int b);
d134f170 RD	397	// Next three assume 16 bit shorts and 32 bit longs
	398	static long LongFromTwoShorts(short a,short b) {
	399	return (a) \| ((b) << 16);
	400	}
	401	static short HighShortFromLong(long x) {
	402	return static_cast<short>(x >> 16);
	403	}
	404	static short LowShortFromLong(long x) {
	405	return static_cast<short>(x & 0xffff);
	406	}
9ce192d4 RD	407	static void DebugPrintf(const char *format, ...);
	408	static int Clamp(int val, int minVal, int maxVal);
	409	};
	410
	411	#endif