[wxWidgets.git] / utils / configtool / src / utils.cpp

/////////////////////////////////////////////////////////////////////////////
// Name:        utils.cpp
// Purpose:     Utility functions and classes
// Author:      Julian Smart
// Modified by:
// Created:     2002-09-04
// RCS-ID:      $Id$
// Copyright:   (c) Julian Smart
// Licence:
/////////////////////////////////////////////////////////////////////////////

#ifdef __GNUG__
// #pragma implementation
#endif

// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"

#ifdef __BORLANDC__
#pragma hdrstop
#endif

#include <math.h>

#ifndef WX_PRECOMP

#include "wx/splitter.h"
#include "wx/datstrm.h"
#include "wx/file.h"
#include "wx/listctrl.h"
#include "wx/process.h"
#include "wx/variant.h"
#include "wx/cmdline.h"
#include "wx/msgdlg.h"
#include "wx/log.h"
#include "wx/sizer.h"
#include "wx/icon.h"
#include "wx/intl.h"

#endif

#include "wx/wfstream.h"
#include "wx/cshelp.h"
#include "wx/image.h"
#include "wx/imaglist.h"
#include "wx/tokenzr.h"
#include "wx/notebook.h"
#include "wx/mimetype.h"
#include "utils.h"

// Returns the image type, or -1, determined from the extension.
int apDetermineImageType(const wxString& filename)
{
    wxString path, name, ext;

    wxSplitPath(filename, & path, & name, & ext);

    ext.MakeLower();
    if (ext == _T("jpg") || ext == _T("jpeg"))
        return wxBITMAP_TYPE_JPEG;
    else if (ext == _T("gif"))
        return wxBITMAP_TYPE_GIF;
    else if (ext == _T("bmp"))
        return wxBITMAP_TYPE_BMP;
    else if (ext == _T("png"))
        return wxBITMAP_TYPE_PNG;
    else if (ext == _T("pcx"))
        return wxBITMAP_TYPE_PCX;
    else if (ext == _T("tif") || ext == _T("tiff"))
        return wxBITMAP_TYPE_TIF;
    else
        return -1;
}

// Convert a colour to a 6-digit hex string
wxString apColourToHexString(const wxColour& col)
{
    wxString hex;

    hex += wxDecToHex(col.Red());
    hex += wxDecToHex(col.Green());
    hex += wxDecToHex(col.Blue());

    return hex;
}

// Convert 6-digit hex string to a colour
wxColour apHexStringToColour(const wxString& hex)
{
    unsigned char r = (unsigned char)wxHexToDec(hex.Mid(0, 2));
    unsigned char g = (unsigned char)wxHexToDec(hex.Mid(2, 2));
    unsigned char b = (unsigned char)wxHexToDec(hex.Mid(4, 2));

    return wxColour(r, g, b);
}

// Convert a wxFont to a string
wxString apFontToString(const wxFont& font)
{
    wxString str;
    str.Printf(wxT("%d,%d,%d,%d,%d,%s"), (int) font.GetPointSize(),
        (int) font.GetFamily(), (int) font.GetStyle(), (int) font.GetWeight(),
        (int) font.GetUnderlined(), font.GetFaceName().c_str());

    return str;
}

static inline int StringToInt(const wxString& s)
{
    long tmp;
    s.ToLong(&tmp);

    return int(tmp);
}

// Convert a string to a wxFont
wxFont apStringToFont(const wxString& str)
{
    int pointSize = 12;
    int family = wxSWISS;
    int style = wxNORMAL;
    int weight = wxNORMAL;
    int underlined = 0;
    wxString facename;

    wxStringTokenizer tkz(str, wxT(","));
    int i = 0;
    while (tkz.HasMoreTokens())
    {
        wxString token = tkz.GetNextToken();

        if (i == 0)
        {
            pointSize = StringToInt(token);
#if defined(__WXGTK__) || defined(__WXMAC__)
            if (pointSize < 8)
                pointSize = 8;
            if (pointSize == 9)
                pointSize = 10;
#endif
        }
        else if (i == 1)
            family = StringToInt(token);
        else if (i == 2)
            style = StringToInt(token);
        else if (i == 3)
            weight = StringToInt(token);
        else if (i == 4)
            underlined = StringToInt(token);
        else if (i == 5)
        {
            facename = token;
#if defined(__WXGTK__)
            if (facename == wxT("Arial"))
                facename = wxT("helvetica");
#endif
        }
        i ++;

    }
    return wxFont(pointSize, family, style, weight, (underlined != 0), facename);
}


// Get the index of the given named wxNotebook page
int apFindNotebookPage(wxNotebook* notebook, const wxString& name)
{
    int i;
    for (i = 0; i < (int)notebook->GetPageCount(); i++)
        if (name == notebook->GetPageText(i))
            return i;
    return -1;
}

wxString wxGetTempDir()
{
    wxString dir;
#if defined(__WXMAC__) && !defined(__DARWIN__)
    dir = wxMacFindFolder(  (short) kOnSystemDisk, kTemporaryFolderType, kCreateFolder ) ;
#else // !Mac
    wxString dirEnv(wxGetenv(_T("TMP")));
    dir = dirEnv;
    if ( dir.empty() )
    {
        wxString envVar(wxGetenv(_T("TEMP")));
        dir = envVar;
    }

    if ( dir.empty() )
    {
        // default
#ifdef __DOS__
        dir = _T(".");
#else
        dir = _T("/tmp");
#endif
    }
#endif // Mac/!Mac
    return dir;
}

// Invoke app for file type
// Eventually we should allow the user to select an app.
bool apInvokeAppForFile(const wxString& filename)
{
    wxString path, file, ext;
    wxSplitPath(filename, & path, & file, & ext);

    wxFileType *ft = wxTheMimeTypesManager->GetFileTypeFromExtension(ext);
    if ( !ft )
    {
        wxString msg;
        msg.Printf(wxT("Sorry, could not determine what application to invoke for extension %s\nYou may need to edit your MIME types."),
            ext.c_str());
        wxMessageBox(msg, wxT("Application Invocation"), wxICON_EXCLAMATION|wxOK);
        return false;
    }

    wxString cmd;
    ft->GetOpenCommand(&cmd, wxFileType::MessageParameters(filename, wxEmptyString));
    delete ft;

    return (wxExecute(cmd, false) != 0);
}

// Find the absolute path where this application has been run from.
// argv0 is wxTheApp->argv[0]
// cwd is the current working directory (at startup)
// appVariableName is the name of a variable containing the directory for this app, e.g.
// MYAPPDIR. This is checked first.

wxString apFindAppPath(const wxString& argv0, const wxString& cwd, const wxString& appVariableName)
{
    // Try appVariableName
    if (!appVariableName.empty())
    {
        wxString strVar(wxGetenv(appVariableName.c_str()));
        if (!strVar.empty())
            return strVar;
    }

    if (wxIsAbsolutePath(argv0))
        return wxPathOnly(argv0);
    else
    {
        // Is it a relative path?
        wxString currentDir(cwd);
        if (currentDir.Last() != wxFILE_SEP_PATH)
            currentDir += wxFILE_SEP_PATH;

        currentDir += argv0;
        if (wxFileExists(currentDir))
            return wxPathOnly(currentDir);
    }

    // OK, it's neither an absolute path nor a relative path.
    // Search PATH.

    wxPathList pathList;
    pathList.AddEnvList(wxT("PATH"));
    wxString strPath = pathList.FindAbsoluteValidPath(argv0);
    if (!strPath.empty())
        return wxPathOnly(strPath);

    // Failed
    return wxEmptyString;
}

// Adds a context-sensitive help button, for non-Windows platforms
void apAddContextHelpButton(wxWindow*
                                      #if defined(__WXGTK__) || defined(__WXMAC__)
                                      parent
                                      #else
                                      WXUNUSED(parent)
                                      #endif
                                      , wxSizer*
                                                 #if defined(__WXGTK__) || defined(__WXMAC__)
                                                 sizer
                                                 #else
                                                 WXUNUSED(sizer)
                                                 #endif
                                                 , int
                                                       #if defined(__WXGTK__) || defined(__WXMAC__)
                                                       sizerFlags
                                                       #else
                                                       WXUNUSED(sizerFlags)
                                                       #endif
                                                       , int
                                                             #if defined(__WXGTK__) || defined(__WXMAC__)
                                                             sizerBorder
                                                             #else
                                                             WXUNUSED(sizerBorder)
                                                             #endif
                                                             )
{
#if defined(__WXGTK__) || defined(__WXMAC__)
#ifdef __WXMAC__
    wxSize buttonSize(20, 20);
#else
    wxSize buttonSize = wxDefaultSize;
#endif
    wxButton *contextButton = new wxContextHelpButton( parent, wxID_CONTEXT_HELP,
        wxDefaultPosition, buttonSize);
    sizer->Add( contextButton, 0, sizerFlags, sizerBorder );

    // Add a bit of space on the right, to allow for the dialog resizing
    // handle
#ifdef __WXMAC__
    sizer->Add(0, 0, 0, wxRIGHT, 10);
#endif

    contextButton->SetHelpText(_("Invokes context-sensitive help for the clicked-on window."));
#if 0
    if (wxGetApp().UsingTooltips())
    {
        contextButton->SetToolTip(_("Invokes context-sensitive help for the clicked-on window."));
    }
#endif
#endif
}

// Get selected wxNotebook page
wxWindow* apNotebookGetSelectedPage(wxNotebook* notebook)
{
    int sel = notebook->GetSelection();
    if (sel > -1)
    {
        return notebook->GetPage(sel);
    }
    return NULL;
}

/*
* wxIconInfo
*/

wxIconInfo::wxIconInfo(const wxString& name)
{
    m_maxStates = 0;
    m_name = name;
    int i;
    for (i = 0; i < wxMAX_ICON_STATES; i++)
        m_states[i] = 0;
}

int wxIconInfo::GetIconId(int state, bool enabled) const
{
    wxASSERT ( state < (wxMAX_ICON_STATES * 2) );
    wxASSERT ( state < m_maxStates );

    return m_states[state * 2 + (enabled ? 0 : 1)];
}

void wxIconInfo::SetIconId(int state, bool enabled, int iconId)
{
    wxASSERT ( state < (wxMAX_ICON_STATES * 2) );
    if (state+1 > m_maxStates)
        m_maxStates = state+1;

    m_states[state * 2 + (enabled ? 0 : 1)] = iconId;
}

/*
* wxIconTable
* Contains a list of wxIconInfos
*/

wxIconTable::wxIconTable(wxImageList* imageList)
{
    m_imageList = imageList;
    WX_CLEAR_LIST(wxIconTable,*this);
}

void wxIconTable::AppendInfo(wxIconInfo* info)
{
    Append(info);
}

// Easy way of initialising both the image list and the
// table. It will generate image ids itself while appending the icon.
bool wxIconTable::AddInfo(const wxString& name, const wxIcon& icon, int state, bool enabled)
{
    wxASSERT (m_imageList != NULL);

    wxIconInfo* info = FindInfo(name);
    if (!info)
    {
        info = new wxIconInfo(name);
        Append(info);
    }
    info->SetIconId(state, enabled, m_imageList->Add(icon));
    return true;
}

wxIconInfo* wxIconTable::FindInfo(const wxString& name) const
{
    wxObjectList::compatibility_iterator node = GetFirst();
    while (node)
    {
        wxIconInfo* info = (wxIconInfo*) node->GetData();
        if (info->GetName() == name)
            return info;
        node = node->GetNext();
    }
    return NULL;
}

int wxIconTable::GetIconId(const wxString& name, int state, bool enabled) const
{
    wxIconInfo* info = FindInfo(name);
    if (!info)
        return -1;
    return info->GetIconId(state, enabled);
}

bool wxIconTable::SetIconId(const wxString& name, int state, bool enabled, int iconId)
{
    wxIconInfo* info = FindInfo(name);
    if (!info)
        return false;
    info->SetIconId(state, enabled, iconId);
    return true;
}

// Output stream operators

wxOutputStream& operator <<(wxOutputStream& stream, const wxString& s)
{
    stream.Write(s, s.Length());
    return stream;
}

wxOutputStream& operator <<(wxOutputStream& stream, long l)
{
    wxString str;
    str.Printf(_T("%ld"), l);
    return stream << str;
}

wxOutputStream& operator <<(wxOutputStream& stream, const wxChar c)
{
    wxString str;
    str.Printf(_T("%c"), c);
    return stream << str;
}

// Convert characters to HTML equivalents
wxString ctEscapeHTMLCharacters(const wxString& str)
{
    wxString s;
    size_t len = str.Length();
    size_t i;
    for (i = 0; i < len; i++)
    {
        wxChar c = str.GetChar(i);
        if (c == _T('<'))
            s += _T("&lt;");
        else if (c == _T('>'))
            s += _T("&gt;");
        else if (c == _T('&'))
            s += _T("&amp;");
        else
            s += c;
    }
    return s;
}

// Match 'matchText' against 'matchAgainst', optionally constraining to
// whole-word only.
bool ctMatchString(const wxString& matchAgainst, const wxString& matchText, bool wholeWordOnly)
{
    // Fast operation if not matching against whole words only
    if (!wholeWordOnly)
        return (matchAgainst.Find(matchText) != wxNOT_FOUND);

    wxString left(matchAgainst);
    bool success = false;
    int matchTextLen = (int) matchText.Length();
    while (!success && !matchAgainst.empty())
    {
        int pos = left.Find(matchText);
        if (pos == wxNOT_FOUND)
            return false;

        bool firstCharOK = false;
        bool lastCharOK = false;
        if (pos == 0 || !wxIsalnum(left[(size_t) (pos-1)]))
            firstCharOK = true;

        if (((pos + matchTextLen) == (int) left.Length()) || !wxIsalnum(left[(size_t) (pos + matchTextLen)]))
            lastCharOK = true;

        if (firstCharOK && lastCharOK)
            success = true;

        left = left.Mid(pos+1);
    }
    return success;
}
Commit	Line	Data
d7463f75 JS	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: utils.cpp
	3	// Purpose: Utility functions and classes
	4	// Author: Julian Smart
	5	// Modified by:
	6	// Created: 2002-09-04
	7	// RCS-ID: $Id$
	8	// Copyright: (c) Julian Smart
4fe30bce	9	// Licence:
d7463f75 JS	10	/////////////////////////////////////////////////////////////////////////////
	11
	12	#ifdef __GNUG__
	13	// #pragma implementation
	14	#endif
	15
d9ab621e WS	16	// For compilers that support precompilation, includes "wx/wx.h".
	17	#include "wx/wxprec.h"
	18
	19	#ifdef __BORLANDC__
	20	#pragma hdrstop
	21	#endif
	22
	23	#include <math.h>
	24
	25	#ifndef WX_PRECOMP
	26
d7463f75	27	#include "wx/splitter.h"
d7463f75 JS	28	#include "wx/datstrm.h"
	29	#include "wx/file.h"
	30	#include "wx/listctrl.h"
d7463f75	31	#include "wx/process.h"
d7463f75	32	#include "wx/variant.h"
d7463f75	33	#include "wx/cmdline.h"
60c474a0 MB	34	#include "wx/msgdlg.h"
60c474a0 MB	35	#include "wx/log.h"
d21f1d8f MB	36	#include "wx/sizer.h"
d21f1d8f MB	37	#include "wx/icon.h"
a04a377a	38	#include "wx/intl.h"
d7463f75	39
d7463f75 JS	40	#endif
d7463f75 JS	41
d9ab621e WS	42	#include "wx/wfstream.h"
	43	#include "wx/cshelp.h"
	44	#include "wx/image.h"
	45	#include "wx/imaglist.h"
	46	#include "wx/tokenzr.h"
	47	#include "wx/notebook.h"
	48	#include "wx/mimetype.h"
d7463f75 JS	49	#include "utils.h"
	50
	51	// Returns the image type, or -1, determined from the extension.
	52	int apDetermineImageType(const wxString& filename)
	53	{
	54	wxString path, name, ext;
	55
	56	wxSplitPath(filename, & path, & name, & ext);
	57
	58	ext.MakeLower();
69da0d99	59	if (ext == _T("jpg") \|\| ext == _T("jpeg"))
d7463f75	60	return wxBITMAP_TYPE_JPEG;
69da0d99	61	else if (ext == _T("gif"))
d7463f75	62	return wxBITMAP_TYPE_GIF;
69da0d99	63	else if (ext == _T("bmp"))
d7463f75	64	return wxBITMAP_TYPE_BMP;
69da0d99	65	else if (ext == _T("png"))
d7463f75	66	return wxBITMAP_TYPE_PNG;
69da0d99	67	else if (ext == _T("pcx"))
d7463f75	68	return wxBITMAP_TYPE_PCX;
69da0d99	69	else if (ext == _T("tif") \|\| ext == _T("tiff"))
d7463f75 JS	70	return wxBITMAP_TYPE_TIF;
	71	else
	72	return -1;
	73	}
	74
	75	// Convert a colour to a 6-digit hex string
	76	wxString apColourToHexString(const wxColour& col)
	77	{
	78	wxString hex;
	79
	80	hex += wxDecToHex(col.Red());
	81	hex += wxDecToHex(col.Green());
	82	hex += wxDecToHex(col.Blue());
	83
	84	return hex;
	85	}
	86
	87	// Convert 6-digit hex string to a colour
	88	wxColour apHexStringToColour(const wxString& hex)
	89	{
254a2129 WS	90	unsigned char r = (unsigned char)wxHexToDec(hex.Mid(0, 2));
	91	unsigned char g = (unsigned char)wxHexToDec(hex.Mid(2, 2));
	92	unsigned char b = (unsigned char)wxHexToDec(hex.Mid(4, 2));
d7463f75 JS	93
	94	return wxColour(r, g, b);
	95	}
	96
	97	// Convert a wxFont to a string
	98	wxString apFontToString(const wxFont& font)
	99	{
	100	wxString str;
	101	str.Printf(wxT("%d,%d,%d,%d,%d,%s"), (int) font.GetPointSize(),
	102	(int) font.GetFamily(), (int) font.GetStyle(), (int) font.GetWeight(),
	103	(int) font.GetUnderlined(), font.GetFaceName().c_str());
	104
	105	return str;
	106	}
	107
3ac35b57 MB	108	static inline int StringToInt(const wxString& s)
	109	{
	110	long tmp;
	111	s.ToLong(&tmp);
	112
	113	return int(tmp);
	114	}
	115
d7463f75 JS	116	// Convert a string to a wxFont
	117	wxFont apStringToFont(const wxString& str)
	118	{
	119	int pointSize = 12;
	120	int family = wxSWISS;
	121	int style = wxNORMAL;
	122	int weight = wxNORMAL;
	123	int underlined = 0;
a04a377a	124	wxString facename;
d7463f75 JS	125
	126	wxStringTokenizer tkz(str, wxT(","));
	127	int i = 0;
	128	while (tkz.HasMoreTokens())
	129	{
	130	wxString token = tkz.GetNextToken();
	131
	132	if (i == 0)
	133	{
3ac35b57	134	pointSize = StringToInt(token);
d7463f75 JS	135	#if defined(__WXGTK__) \|\| defined(__WXMAC__)
	136	if (pointSize < 8)
	137	pointSize = 8;
	138	if (pointSize == 9)
	139	pointSize = 10;
254a2129	140	#endif
d7463f75 JS	141	}
d7463f75 JS	142	else if (i == 1)
3ac35b57	143	family = StringToInt(token);
d7463f75	144	else if (i == 2)
3ac35b57	145	style = StringToInt(token);
d7463f75	146	else if (i == 3)
3ac35b57	147	weight = StringToInt(token);
d7463f75	148	else if (i == 4)
3ac35b57	149	underlined = StringToInt(token);
d7463f75 JS	150	else if (i == 5)
	151	{
	152	facename = token;
	153	#if defined(__WXGTK__)
	154	if (facename == wxT("Arial"))
	155	facename = wxT("helvetica");
	156	#endif
	157	}
	158	i ++;
	159
	160	}
	161	return wxFont(pointSize, family, style, weight, (underlined != 0), facename);
	162	}
	163
	164
	165	// Get the index of the given named wxNotebook page
	166	int apFindNotebookPage(wxNotebook* notebook, const wxString& name)
	167	{
	168	int i;
69da0d99	169	for (i = 0; i < (int)notebook->GetPageCount(); i++)
d7463f75 JS	170	if (name == notebook->GetPageText(i))
	171	return i;
	172	return -1;
	173	}
	174
d7463f75 JS	175	wxString wxGetTempDir()
	176	{
	177	wxString dir;
	178	#if defined(__WXMAC__) && !defined(__DARWIN__)
	179	dir = wxMacFindFolder( (short) kOnSystemDisk, kTemporaryFolderType, kCreateFolder ) ;
	180	#else // !Mac
d9ab621e WS	181	wxString dirEnv(wxGetenv(_T("TMP")));
d9ab621e WS	182	dir = dirEnv;
d7463f75 JS	183	if ( dir.empty() )
d7463f75 JS	184	{
d9ab621e WS	185	wxString envVar(wxGetenv(_T("TEMP")));
d9ab621e WS	186	dir = envVar;
d7463f75	187	}
254a2129	188
d7463f75 JS	189	if ( dir.empty() )
	190	{
	191	// default
	192	#ifdef __DOS__
	193	dir = _T(".");
	194	#else
	195	dir = _T("/tmp");
	196	#endif
	197	}
	198	#endif // Mac/!Mac
	199	return dir;
	200	}
	201
	202	// Invoke app for file type
	203	// Eventually we should allow the user to select an app.
	204	bool apInvokeAppForFile(const wxString& filename)
	205	{
	206	wxString path, file, ext;
	207	wxSplitPath(filename, & path, & file, & ext);
	208
	209	wxFileType *ft = wxTheMimeTypesManager->GetFileTypeFromExtension(ext);
	210	if ( !ft )
	211	{
	212	wxString msg;
	213	msg.Printf(wxT("Sorry, could not determine what application to invoke for extension %s\nYou may need to edit your MIME types."),
	214	ext.c_str());
	215	wxMessageBox(msg, wxT("Application Invocation"), wxICON_EXCLAMATION\|wxOK);
4fe30bce	216	return false;
d7463f75 JS	217	}
	218
	219	wxString cmd;
a04a377a	220	ft->GetOpenCommand(&cmd, wxFileType::MessageParameters(filename, wxEmptyString));
d7463f75 JS	221	delete ft;
d7463f75 JS	222
4fe30bce	223	return (wxExecute(cmd, false) != 0);
d7463f75 JS	224	}
	225
	226	// Find the absolute path where this application has been run from.
	227	// argv0 is wxTheApp->argv[0]
	228	// cwd is the current working directory (at startup)
	229	// appVariableName is the name of a variable containing the directory for this app, e.g.
	230	// MYAPPDIR. This is checked first.
	231
	232	wxString apFindAppPath(const wxString& argv0, const wxString& cwd, const wxString& appVariableName)
	233	{
d7463f75	234	// Try appVariableName
a04a377a	235	if (!appVariableName.empty())
d7463f75	236	{
d9ab621e	237	wxString strVar(wxGetenv(appVariableName.c_str()));
a04a377a	238	if (!strVar.empty())
d9ab621e	239	return strVar;
d7463f75 JS	240	}
	241
	242	if (wxIsAbsolutePath(argv0))
	243	return wxPathOnly(argv0);
	244	else
	245	{
	246	// Is it a relative path?
	247	wxString currentDir(cwd);
	248	if (currentDir.Last() != wxFILE_SEP_PATH)
	249	currentDir += wxFILE_SEP_PATH;
	250
d9ab621e WS	251	currentDir += argv0;
	252	if (wxFileExists(currentDir))
	253	return wxPathOnly(currentDir);
d7463f75 JS	254	}
	255
	256	// OK, it's neither an absolute path nor a relative path.
	257	// Search PATH.
	258
	259	wxPathList pathList;
	260	pathList.AddEnvList(wxT("PATH"));
d9ab621e	261	wxString strPath = pathList.FindAbsoluteValidPath(argv0);
a04a377a	262	if (!strPath.empty())
d9ab621e	263	return wxPathOnly(strPath);
d7463f75 JS	264
	265	// Failed
	266	return wxEmptyString;
	267	}
	268
	269	// Adds a context-sensitive help button, for non-Windows platforms
254a2129	270	void apAddContextHelpButton(wxWindow*
69da0d99 JS	271	#if defined(__WXGTK__) \|\| defined(__WXMAC__)
	272	parent
	273	#else
	274	WXUNUSED(parent)
	275	#endif
254a2129	276	, wxSizer*
69da0d99 JS	277	#if defined(__WXGTK__) \|\| defined(__WXMAC__)
	278	sizer
	279	#else
	280	WXUNUSED(sizer)
	281	#endif
254a2129	282	, int
69da0d99 JS	283	#if defined(__WXGTK__) \|\| defined(__WXMAC__)
	284	sizerFlags
	285	#else
	286	WXUNUSED(sizerFlags)
	287	#endif
254a2129	288	, int
69da0d99 JS	289	#if defined(__WXGTK__) \|\| defined(__WXMAC__)
	290	sizerBorder
	291	#else
	292	WXUNUSED(sizerBorder)
	293	#endif
	294	)
d7463f75 JS	295	{
	296	#if defined(__WXGTK__) \|\| defined(__WXMAC__)
	297	#ifdef __WXMAC__
	298	wxSize buttonSize(20, 20);
	299	#else
4fe30bce	300	wxSize buttonSize = wxDefaultSize;
d7463f75 JS	301	#endif
	302	wxButton *contextButton = new wxContextHelpButton( parent, wxID_CONTEXT_HELP,
	303	wxDefaultPosition, buttonSize);
	304	sizer->Add( contextButton, 0, sizerFlags, sizerBorder );
	305
	306	// Add a bit of space on the right, to allow for the dialog resizing
	307	// handle
	308	#ifdef __WXMAC__
	309	sizer->Add(0, 0, 0, wxRIGHT, 10);
	310	#endif
	311
	312	contextButton->SetHelpText(_("Invokes context-sensitive help for the clicked-on window."));
02ae000a	313	#if 0
d7463f75 JS	314	if (wxGetApp().UsingTooltips())
	315	{
	316	contextButton->SetToolTip(_("Invokes context-sensitive help for the clicked-on window."));
	317	}
	318	#endif
02ae000a	319	#endif
d7463f75 JS	320	}
	321
	322	// Get selected wxNotebook page
	323	wxWindow* apNotebookGetSelectedPage(wxNotebook* notebook)
	324	{
	325	int sel = notebook->GetSelection();
	326	if (sel > -1)
	327	{
	328	return notebook->GetPage(sel);
	329	}
	330	return NULL;
	331	}
	332
	333	/*
	334	* wxIconInfo
	335	*/
	336
	337	wxIconInfo::wxIconInfo(const wxString& name)
	338	{
	339	m_maxStates = 0;
	340	m_name = name;
	341	int i;
	342	for (i = 0; i < wxMAX_ICON_STATES; i++)
	343	m_states[i] = 0;
	344	}
	345
	346	int wxIconInfo::GetIconId(int state, bool enabled) const
	347	{
	348	wxASSERT ( state < (wxMAX_ICON_STATES * 2) );
	349	wxASSERT ( state < m_maxStates );
254a2129	350
d7463f75 JS	351	return m_states[state * 2 + (enabled ? 0 : 1)];
	352	}
	353
	354	void wxIconInfo::SetIconId(int state, bool enabled, int iconId)
	355	{
	356	wxASSERT ( state < (wxMAX_ICON_STATES * 2) );
	357	if (state+1 > m_maxStates)
	358	m_maxStates = state+1;
254a2129	359
d7463f75 JS	360	m_states[state * 2 + (enabled ? 0 : 1)] = iconId;
	361	}
	362
	363	/*
	364	* wxIconTable
	365	* Contains a list of wxIconInfos
	366	*/
	367
	368	wxIconTable::wxIconTable(wxImageList* imageList)
	369	{
	370	m_imageList = imageList;
d9ab621e	371	WX_CLEAR_LIST(wxIconTable,*this);
d7463f75 JS	372	}
	373
	374	void wxIconTable::AppendInfo(wxIconInfo* info)
	375	{
	376	Append(info);
	377	}
	378
	379	// Easy way of initialising both the image list and the
	380	// table. It will generate image ids itself while appending the icon.
	381	bool wxIconTable::AddInfo(const wxString& name, const wxIcon& icon, int state, bool enabled)
	382	{
	383	wxASSERT (m_imageList != NULL);
254a2129	384
d7463f75 JS	385	wxIconInfo* info = FindInfo(name);
	386	if (!info)
	387	{
	388	info = new wxIconInfo(name);
	389	Append(info);
	390	}
	391	info->SetIconId(state, enabled, m_imageList->Add(icon));
4fe30bce	392	return true;
d7463f75 JS	393	}
	394
	395	wxIconInfo* wxIconTable::FindInfo(const wxString& name) const
	396	{
d9ab621e	397	wxObjectList::compatibility_iterator node = GetFirst();
d7463f75 JS	398	while (node)
d7463f75 JS	399	{
f8105809	400	wxIconInfo* info = (wxIconInfo*) node->GetData();
d7463f75 JS	401	if (info->GetName() == name)
d7463f75 JS	402	return info;
f8105809	403	node = node->GetNext();
d7463f75 JS	404	}
	405	return NULL;
	406	}
	407
	408	int wxIconTable::GetIconId(const wxString& name, int state, bool enabled) const
	409	{
	410	wxIconInfo* info = FindInfo(name);
	411	if (!info)
	412	return -1;
	413	return info->GetIconId(state, enabled);
	414	}
	415
	416	bool wxIconTable::SetIconId(const wxString& name, int state, bool enabled, int iconId)
	417	{
	418	wxIconInfo* info = FindInfo(name);
	419	if (!info)
4fe30bce	420	return false;
d7463f75	421	info->SetIconId(state, enabled, iconId);
4fe30bce	422	return true;
d7463f75 JS	423	}
	424
	425	// Output stream operators
	426
	427	wxOutputStream& operator <<(wxOutputStream& stream, const wxString& s)
	428	{
	429	stream.Write(s, s.Length());
	430	return stream;
	431	}
	432
	433	wxOutputStream& operator <<(wxOutputStream& stream, long l)
	434	{
	435	wxString str;
	436	str.Printf(_T("%ld"), l);
	437	return stream << str;
	438	}
	439
69da0d99	440	wxOutputStream& operator <<(wxOutputStream& stream, const wxChar c)
d7463f75 JS	441	{
	442	wxString str;
	443	str.Printf(_T("%c"), c);
	444	return stream << str;
	445	}
	446
	447	// Convert characters to HTML equivalents
	448	wxString ctEscapeHTMLCharacters(const wxString& str)
	449	{
	450	wxString s;
	451	size_t len = str.Length();
	452	size_t i;
	453	for (i = 0; i < len; i++)
	454	{
	455	wxChar c = str.GetChar(i);
	456	if (c == _T('<'))
	457	s += _T("<");
	458	else if (c == _T('>'))
	459	s += _T(">");
	460	else if (c == _T('&'))
	461	s += _T("&");
	462	else
	463	s += c;
	464	}
	465	return s;
f8105809	466	}
e7767867 JS	467
	468	// Match 'matchText' against 'matchAgainst', optionally constraining to
	469	// whole-word only.
	470	bool ctMatchString(const wxString& matchAgainst, const wxString& matchText, bool wholeWordOnly)
	471	{
	472	// Fast operation if not matching against whole words only
	473	if (!wholeWordOnly)
4fe30bce	474	return (matchAgainst.Find(matchText) != wxNOT_FOUND);
e7767867 JS	475
e7767867 JS	476	wxString left(matchAgainst);
4fe30bce	477	bool success = false;
e7767867	478	int matchTextLen = (int) matchText.Length();
a04a377a	479	while (!success && !matchAgainst.empty())
e7767867	480	{
79830320	481	int pos = left.Find(matchText);
4fe30bce WS	482	if (pos == wxNOT_FOUND)
4fe30bce WS	483	return false;
e7767867	484
4fe30bce WS	485	bool firstCharOK = false;
4fe30bce WS	486	bool lastCharOK = false;
e7767867	487	if (pos == 0 \|\| !wxIsalnum(left[(size_t) (pos-1)]))
4fe30bce	488	firstCharOK = true;
e7767867 JS	489
e7767867 JS	490	if (((pos + matchTextLen) == (int) left.Length()) \|\| !wxIsalnum(left[(size_t) (pos + matchTextLen)]))
4fe30bce	491	lastCharOK = true;
e7767867 JS	492
e7767867 JS	493	if (firstCharOK && lastCharOK)
4fe30bce	494	success = true;
e7767867 JS	495
	496	left = left.Mid(pos+1);
	497	}
	498	return success;
	499	}