Scripting commands

Scripting is no good if all you can do is use the scripting language's built-in commands only. The host application (Code::Blocks) needs to expose parts of its internals to scripts, so scripts can use and control the host.

Code::Blocks has exposed a very large chunk of its SDK to scripts. This makes scripting in Code::Blocks nearly as powerful as native code (C++).

In this page all the exported constants, functions and classes are documented as a quick reference. For detailed documentation on each function/class, refer to the Code::Blocks SDK documentation.

NOTE: Please remember that Squirrel is typeless. Data types mentioned below are only used for documentation purposes.

NOTE: Please keep in mind that if a function has default parameters in C++ (which can be ommitted), you still have to type them for scripts (for e.g. exposed wxWidgets functionality). This means you *have* to use e.g. wxFileName.GetFullPath(wxPATH_NATIVE) instead of e.g only wxFileName.GetFullPath().

NOTE: Updated to 12.11

Application object

The application object is accessed through the variable named App. Currently it has no bound functions...

Global functions

Return value	Name	Arguments	Remarks
void	Log	wxString	logs to the application log
void	LogDebug	wxString	logs to the debug log
void	LogWarning	wxString	logs a warning
void	LogError	wxString	logs an error
int	Message	wxString,wxString,int	arg1=msg, arg2=caption, arg3=buttons; see API docs for cbMessageBox()
void	ShowMessage	wxString
void	ShowWarning	wxString
void	ShowError	wxString
void	ShowInfo	wxString
wxString	ReplaceMacros	wxString	Does variable expansion on the input wxString
ScriptingManager*	GetScriptingManager
ProjectManager*	GetProjectManager
EditorManager*	GetEditorManager
ConfigManager*	GetConfigManager
UserVariableManager*	GetUserVariableManager
CompilerFactory*	GetCompilerFactory
wxArrayString	GetArrayFromString	wxString,wxString,bool
wxString	GetStringFromArray	wxArrayString,wxString,bool
wxString	EscapeSpaces	wxString
wxString	UnixFilename	wxString, int	arg1=filename, arg2=wxPATH_NATIVE, wxPATH_WIN, ...
FileType	FileTypeOf	wxString
wxString	URLEncode	wxString
void	NotifyMissingFile	wxString
int	GetPlatformsFromString	wxString
wxString	GetStringFromPlatforms	int,bool
void	InfoWindow	wxString,wxString,int,int	pop-up box in the lower right, see infowindow.h
wxString	GetFolder	int	see API docs for ConfigManager::GetFolder()
wxString	LocateDataFile	wxString, int	see API docs for ConfigManager::LocateDataFile()
bool	InstallPlugin	wxString,bool, bool	Install a binary plugin
int	ExecuteToolPlugin	wxString	Execute a tool plugin (found in Plugins menu)
int	ConfigureToolPlugin	wxString	Configure a tool plugin (found in Plugins menu)
void	CallMenu	wxString	Call a menu entry describing its path using slashes (e.g. "/Valgrind/Run Valgrind::MemCheck")
void	Include	wxString	similar to C/C++ #include "name"
int	Require	wxString	arg=script_filename, return 0 if ok
bool	IsNull	void*
bool	wxLaunchDefaultBrowser	wxString
wxColour	wxGetColourFromUser	[wxColour]
long	wxGetNumberFromUser	wxString,wxString,wxString
wxString	wxGetPasswordFromUser	wxString,wxString,wxString
wxString	wxGetTextFromUser	wxString,wxString,wxString
long	wxString_ToLong	wxString const

ScriptingManager

Return value	Name	Arguments	Remarks
bool	RegisterScriptMenu	wxString, wxString	registers the script file (arg1) under a menu item (arg2). e.g. GetScriptingManager().RegisterScriptMenu(_T("sample.script"), _T("Scripts/Sample script"));

Notes about the RegisterScriptMenu function:

• The second argument (menu item) is a string containing the full menu path to create the menu item. The path separator is a slash (/). For example, the string "Settings/Sample menu/Sample item" would create the menu path "Settings->Sample menu->Sample item".
• When each part of the path is evaluated, it is checked whether it starts with a number followed by a colon (:). If so then this is considered to be a menu index in the parent menu and the menu is inserted at that index instead of being appended to the menu. The number and colon are removed from the string.
• If the menu item starts with a dash (-), then a separator line is prepended in the menu before the menu item (e.g. "Scripts/-Sample script").
• For your convenience, all menu items created using this function have one extra functionality: if you keep the SHIFT key pressed while clicking on any of these "script menu items", instead of running the attached script, Code::Blocks will open it in the editor for you to view/edit :).
• Have a look at the startup script example.

ConfigManager

Return value	Name	Arguments	Remarks
int	Read	const wxString, int	arg1=key, arg2=default_val
bool	Read	const wxString, bool	arg1=key, arg2=default_val
float	Read	const wxString, float	arg1=key, arg2=default_val
wxString	Read	const wxString, const wxString	arg1=key, arg2=default_val
void	Write	const wxString, int	arg1=key, arg2=value
void	Write	const wxString, bool	arg1=key, arg2=value
void	Write	const wxString, float	arg1=key, arg2=value
void	Write	const wxString, const wxString, bool	arg1=key, arg2=value, arg3=ignore_value_empty

ProjectManager

see API docs for 'ProjectManager::...' in 'include\projectmanager.h'

Return value	Name	Arguments in Prototype	Remarks
wxString	GetDefaultPath	( )
void	SetDefaultPath	(const wxString& path)
cbProject*	GetActiveProject	( )
int	GetProjectCount	( )
cbProject*	GetProject	(int)
void	SetProject	(cbProject* project, bool refresh = true)
bool	LoadWorkspace	(const wxString& filename = DEFAULT_WORKSPACE)
bool	SaveWorkspace	( )
bool	SaveWorkspaceAs	(const wxString& filename)
bool	CloseWorkspace	( )
cbProject*	IsOpen	(const wxString& filename)
cbProject*	LoadProject	(const wxString& filename, bool activateIt = true)
bool	SaveProject	(cbProject* project)
bool	SaveProjectAs	(cbProject* project)
bool	SaveActiveProject	( )
bool	SaveActiveProjectAs	( )
bool	SaveAllProjects	( )
bool	CloseProject	(cbProject* project, bool dontsave = false, bool refresh = true)
bool	CloseActiveProject	(bool dontsave = false)
bool	CloseAllProjects	(bool dontsave = false)
cbProject*	NewProject	(const wxString& filename = wxEmptyString)
int	AddFileToProject	(const wxString& filename, cbProject* project = 0L, int target = -1)
int	AskForBuildTargetIndex	(cbProject* project = 0L)
void	RebuildTree	( )
bool	AddProjectDependency	(cbProject* base, cbProject* dependsOn)
void	RemoveProjectDependency	(cbProject* base, cbProject* doesNotDependOn)
void	ClearProjectDependencies	(cbProject* base)
void	RemoveProjectFromAllDependencies	(cbProject* base)
ProjectsArray*	GetDependenciesForProject	(cbProject* base)
void	ConfigureProjectDependencies	(cbProject* base = 0)

EditorManager

Return value	Name	Arguments in Prototype	Remarks
void	Configure	( )
cbEditor*	New	(const wxString& newFileName = wxEmptyString)
cbEditor*	Open	(const wxString& filename)
cbEditor*	IsBuiltinOpen	(const wxString& filename)
cbEditor*	GetBuiltinEditor	(int index)
cbEditor*	GetBuiltinActiveEditor	( )
EditorBase*	GetActiveEditor	( )
void	ActivateNext	( )
void	ActivatePrevious	( )
bool	SwapActiveHeaderSource	( )
bool	CloseActive	(bool dontsave = false)
bool	Close	(int index,bool dontsave = false),(EditorBase* editor,bool dontsave = false)
bool	CloseAll	(bool dontsave=false)
bool	Save	(int index)
bool	SaveActive	( )
bool	SaveAs	(int index)
bool	SaveActiveAs	( )
bool	SaveAll	( )
int	ShowFindDialog	(bool replace, bool explicitly_find_in_files = false)

UserVariableManager

Return value	Name	Arguments in Prototype	Remarks
bool	Exists	(const wxString& variable)

IO namespace

Return value	Name	Arguments in Prototype	Remarks
bool	DirectoryExists	(const wxString& dir)	1)
wxString	SelectDirectory	(const wxString& message, const wxString& initialPath, bool showCreateDirButton)
bool	CreateDirectory	(const wxString& full_path, int perms)	arg1=dir, arg2=permissions 1)
bool	RemoveDirectory	(const wxString& src)	1)
bool	CopyFile	(const wxString& src, const wxString& dst, bool overwrite)	1)
bool	RenameFile	(const wxString& src, const wxString& dst)	old,new 1)
bool	RemoveFile	(const wxString& src)	1)
bool	FileExists	(const wxString& file)	1)
wxString	SelectFile	(const wxString& title, const wxString& defaultFile, const wxString& filter)
wxString	ReadFileContents	(const wxString& filename)	1)
bool	WriteFileContents	(const wxString& filename, const wxString& contents)	filename,contents 1)
int	Execute	(const wxString& command)
wxString	ExecuteAndGetOutput	(const wxString& command)
wxString	ExecuteAndGetOutputAndError	(const wxString& command, bool prepend_error)	if 'prepend_error' is true gives an error string
wxString	GetCwd	( )
void	SetCwd	(const wxString& dir)	directory (currently working directory)

Notes: The namespaces are accesses by prepending it's name (e.g. "IO.") to the scripting function, e.g. "IO.DirectoryExists(...)". "::" is only used when declaring the members of the namespace. The functions in bold are going through the scripts security layer so there is no guarantee calling them will succeed. You should always examine the return value... There exists one constant too, named allowInsecureScripts, which allow you to test whether Code::Blocks was compiled with the functions going through the security layer.

NOTE: 1) All paths/filenames are expanded via the ReplaceMacros function prior the function is called. So it is possible to copy the project output file with

IO.CopyFile(_T("$(TARGET_OUTPUT_FILE)"),_T("output_directory/output_file"),true);

CompilerFactory

Return value	Name	Arguments in Prototype	Remarks
bool	IsValidCompilerID	(const wxString& id)
int	GetCompilerIndex	(const wxString& id)
wxString	GetDefaultCompilerID	( )
wxString	GetCompilerVersionString	(const wxString& Id)
bool	CompilerInheritsFrom	( )
wxString	GetCompilerIDByName	(const wxString &name )	Makes it possible to find the compiler id by its name. Available since rev 9823.

wxString

Return value	Name	Arguments	Remarks
wxString	_T	const char*	basically this is the wxString constructor
wxString	_	const char*	the same as _T, but should be used for translatable strings
wxString	operator=	const wxString
wxString	operator+	const wxString
wxString	operator+	const int
wxString	operator+=	const wxString
wxString	operator+=	const int
bool	operator<	const wxString	_T("abc") < _T("cba") -> true
bool	operator<=	const wxString
bool	operator>=	const wxString
bool	operator>	const wxString
int	Find	wxString	-1 if not found
bool	Matches	wxString	not use '==' !!, returns true if the string contents matches a mask containing '*' and '?'
void	AddChar	char
char	GetChar	int	arg1=position
bool	IsEmpty
int	Length
int	length		same as Length()
int	len		same as Length()
int	size		same as Length()
wxString	Lower
wxString	LowerCase		same as Lower()
void	MakeLower
wxString	Upper
wxString	UpperCase		same as Upper()
void	MakeUpper
wxString	Mid	int, int	arg1=position, arg2=long
wxString	Remove	int, int	arg1=position, arg2=long
void	RemoveLast	int	remove the last characters
int	Replace	wxString, wxString,bool	arg3=true -> all occurrences else the first
wxString	Right	int x	return the x last characters
wxString	AfterFirst	char	not found -> _T("")
wxString	AfterLast	char	not found -> all the character string
wxString	BeforeFirst	char	not found -> all the character string
wxString	BeforeLast	char	not found -> _T("")

NOTE: Is instantiated in a script using: local my_wxstring = ::wxString();

wxArrayString

Return value	Name	Arguments	Remarks
void	Add	wxString, size_t	arg1=string, arg2=number of copies to add
void	Clear
int	GetCount
int	Index	wxString	-1 If not found
wxString	Item	int	not work with wx 2.9.x ?!

NOTE: Is instantiated in a script using: local my_wxarraystring = ::wxArrayString();

wxColour

Return value	Name	Arguments	Remarks
byte	Red
byte	Green
byte	Blue
bool	IsOk		ONLY if (wxVERSION_NUMBER < 2900)
void	Set	byte, byte, byte, byte	red, green, blue, alpha : into [0..255]

NOTE: Is instantiated in a script using: local my_wxcolour = ::wxColour();

EXAMPLE: local my_wxcolour = ::wxColour(); my_wxcolour.Set(0xFF, 0x00, 0x00, 0x55); ::print(my_wxcolour) -> [r=255, g=0, b=0]

wxFileName

UNDER VERIFICATION

Return value	Name	Arguments	Remarks
void	Assign	const wxFileName	creates the file name from an other wxFileName
void	Assign	const wxString, wxPathFormat	arg1=full_path, arg2=wformat=xPATH_NATIVE ...
void	AssignCwd	const wxString	arg1=volume
void	AssignDir	const wxString, wxPathFormat	arg1=name_dir, arg2=format=wxPATH_NATIVE ...
void	AssignHomeDir		sets this file name object to the home directory
void	Clear		reset all components to default, uninitialized state
void	ClearExt		removes the extension from the file name resulting in a file name with no trailing dot
int	GetDirCount		returns the number of directories in the file name.
wxArrayString	GetDirs		returns the directories in string array form
wxString	GetExt		returns the file name extension.
wxString	GetFullName		returns the full name (including extension but excluding directories).
wxString	GetFullPath	wxPathFormat	arg=format=wxPATH_NATIVE ...
wxString	GetLongPath		return the long form of the path (returns identity on non-Windows platforms)
wxString	GetName		returns the name part of the filename (without extension)
wxString	GetPath	int, wxPathFormat	arg1=flags=wxPATH_GET_VOLUME..., arg2=format=wxPATH_NATIVE ...
wxString	GetShortPath		return the short form of the path (returns identity on non-Windows platforms).
wxString	GetVolume		returns the string containing the volume for this file name
bool	HasExt		returns true if an extension is present.
bool	HasName		returns true if a name is present
bool	HasVolume		returns true if a volume specifier is present
void	InsertDir	int, const wxString	arg1=before_dir, arg2=name_dir
bool	IsAbsolute	wxPathFormat	arg=format=wxPATH_NATIVE...
bool	IsOk		returns true if the filename is valid
bool	IsRelative	wxPathFormat	arg=format=wxPATH_NATIVE...
bool	IsDir		returns true if this object represents a directory
bool	MakeAbsolute	const wxString, wxPathFormat	arg1=cwd=_T("") or ..., arg2=format=wxPATH_NATIVE or ...
bool	MakeRelativeTo	const wxString, wxPathFormat	arg1=path_base, arg2=format=wxPATH_NATIVE or ...
bool	Normalize	int, const wxString, wxPathFormat	arg1=flags=wxPATH_NORM_ALL, arg2=cwd=_T(""),arg3=format=wxPATH_NATIVE or ...
void	PrependDir	const wxString	arg=dir
void	RemoveDir	int	arg=pos RemoveLastDir
void	RemoveLastDir		removes last directory component from the path
bool	SameAs	const wxFileName, wxPathFormat	arg1=filepath, arg2=format=wxPATH_NATIVE
bool	SetCwd		changes the current working directory
void	SetExt	const wxString	arg=extension
void	SetEmptyExt		sets the extension of the file name to be an empty extension
void	SetFullName	wxString
void	SetName	wxString
void	SetVolume	wxString

NOTE: Is instantiated in a script using: local my_filename = ::wxFileName()

wxPoint

UNDER CONSTRUCTION

Instantiate integer points 2D

Return value	Name	Arguments	Remarks
wxPoint	operator=	const wxPoint	default assignment operator is ok
bool	operator==	const wxPoint
bool	operator!=	const wxPoint
int	x
int	y

NOTE: Is instantiated in a script using: local my_wxpoint = ::wxPoint();

EXAMPLE: local my_wxpoint = ::wxPoint(); my_wxpoint.x = 5; my_wxpoint.y = 12; // not use ::print(my_wxpoint)

wxSize

UNDER CONSTRUCTION

Instantiate integers values (X, Y)

Return value	Name	Arguments	Remarks
wxSize	operator=	const wwSize	default assignment operator is ok
bool	operator==	const wxSize
bool	operator!=	const wxSize
int	GetWidth		return X
int	GetHeight		return Y
void	SetWidth	int w	X=w
void	SetHeight	int h	Y=h
void	Set	int w, int h	X=w, Y=h

NOTE: Is instantiated in a script using: local my_wxsize = ::wxSize();

EXAMPLE: local my_wxsize = ::wxSize(); my_wxsize.SetWidth(5); my_wxsize.SetHeight(12); // not use ::print(my_wxsize)

ProjectFile

Return value	Name	Arguments in Prototype	Remarks
void	AddBuildTarget	(const wxString& targetName)
void	RenameBuildTarget	(const wxString& oldTargetName, const wxString& newTargetName)
void	RemoveBuildTarget	(const wxString& targetName)
wxString	GetBaseName	( )
wxString	GetObjName	( )
void	SetObjName	(const wxString& targetName)
cbProject*	GetParentProject	( )
wxString	GetCustomBuildCommand	(const wxString& compilerId)
void	SetCustomBuildCommand	(const wxString& compilerId, const wxString& newBuildCommand)
bool	GetUseCustomBuildCommand	(const wxString& compilerId)
void	SetUseCustomBuildCommand	(const wxString& compilerId, bool useCustomBuildCommand)
wxFileName	file		(variable)
wxString	relativeFilename		(variable)
wxString	relativeToCommonTopLevelPath		(variable)
bool	compile		(variable)
bool	link		(variable)
int	weight		(variable)
wxString	compilerVar		(variable)
wxArrayString	buildTargets		(variable)
const wxArrayString &	GetBuildTargets	() const	r9252 : for use instead of the variable

CompileOptionsBase

Return value	Name	Arguments in Prototype	Remarks
void	AddPlatform	(int platform)	windows,unix,mac
void	RemovePlatform	(int platform)
void	SetPlatforms	(int platform)
int	GetPlatforms
bool	SupportsCurrentPlatform
void	SetLinkerOptions	(const wxArrayString& linkerOpts)
void	SetLinkLibs	(const wxArrayString& linkLibs)
void	SetCompilerOptions	(const wxArrayString& compilerOpts)
void	SetIncludeDirs	(const wxArrayString& includeDirs)
void	SetResourceIncludeDirs	(const wxString& option)
void	SetLibDirs	(const wxArrayString& libDirs)
void	SetCommandsBeforeBuild	(const wxArrayString& commands)
void	SetCommandsAfterBuild	(const wxArrayString& commands)
wxArrayString	GetLinkerOptions
wxArrayString	GetLinkLibs
wxArrayString	GetCompilerOptions
wxArrayString	GetIncludeDirs
wxArrayString	GetResourceIncludeDirs
wxArrayString	GetLibDirs
wxArrayString	GetCommandsBeforeBuild
wxArrayString	GetCommandsAfterBuild
bool	GetModified
void	SetModified	(bool modified)
void	AddLinkerOption	(const wxString& option)
void	AddLinkLib	(const wxString& lib)
void	AddCompilerOption	(const wxString& option)
void	AddIncludeDir	(const wxString& option)
void	AddResourceIncludeDir	(const wxString& option)
void	AddLibDir	(const wxString& option)
void	AddCommandsBeforeBuild	(const wxString& command)
void	AddCommandsAfterBuild	(const wxString& command)
void	RemoveLinkerOption	(const wxString& option)
void	RemoveLinkLib	(const wxString& lib)
void	RemoveCompilerOption	(const wxString& option)
void	RemoveIncludeDir	(const wxString& option)
void	RemoveResourceIncludeDir	(const wxString& option)
void	RemoveLibDir	(const wxString& option)
void	RemoveCommandsBeforeBuild	(const wxString& command)
void	RemoveCommandsAfterBuild	(const wxString& command)
bool	GetAlwaysRunPostBuildSteps
void	SetAlwaysRunPostBuildSteps	(bool always)
void	SetBuildScripts	(const wxArrayString& scripts)
wxArrayString	GetBuildScripts
void	AddBuildScript	(const wxString& script)
void	RemoveBuildScript	(const wxString& script)
bool	SetVar	(const wxString& key, const wxString& value, bool onlyIfExists = false)
wxString	GetVar	(const wxString& key)
bool	UnsetVar	(const wxString& key)
void	UnsetAllVars	( )

CompileTargetBase

Extends CompileOptionsBase.

Return value	Name	Arguments	Remarks
void	SetTargetFilenameGenerationPolicy	enum prefix, enum extension	tgfpPlatformDefault -> Generate filename based on running platform defaults. tgfpNone -> No automatic generation; let the user specify the full filename.
wxString	GetFilename		The full project name (*.cbp)
wxString	GetTitle		Target name
void	SetTitle	wxString
void	SetOutputFilename	wxString
void	SetWorkingDir	wxString
void	SetObjectOutput	wxString
void	SetDepsOutput	wxString
OptionsRelation	GetOptionRelation	OptionsRelationType
void	SetOptionRelation	OptionsRelationType,OptionsRelation
wxString	GetWorkingDir
wxString	GetObjectOutput
wxString	GetDepsOutput
wxString	GetOutputFilename
wxString	SuggestOutputFilename
wxString	GetExecutableFilename
wxString	GetDynamicLibFilename
wxString	GetDynamicLibDefFilename
wxString	GetStaticLibFilename
wxString	GetBasePath
void	SetTargetType	TargetType
TargetType	GetTargetType
wxString	GetExecutionParameters
void	SetExecutionParameters	wxString
wxString	GetHostApplication
void	SetHostApplication	wxString
void	SetCompilerID	wxString
wxString	GetCompilerID
wxString	GetMakeCommandFor	enum
void	SetMakeCommandFor	enum,wxString
bool	MakeCommandsModified

ProjectBuildTarget

Extends CompileTargetBase.

Return value	Name	Arguments	Remarks
cbProject*	GetParentProject
wxString	GetFullTitle		The full title, i.e. "projectname - targetname"
wxString	GetExternalDeps		list of files whose target depends
void	SetExternalDeps	wxString	list of files whose target depends
void	SetAdditionalOutputFiles	wxString	a list of additional output files
wxString	GetAdditionalOutputFiles		a list of additional output files
bool	GetIncludeInTargetAll		Deprecated, do not use at 'All'
void	SetIncludeInTargetAll	bool	Deprecated, do not use at 'All'
bool	GetCreateDefFile
void	SetCreateDefFile	bool	if the target creates a DEF imports file.
bool	GetCreateStaticLib
void	SetCreateStaticLib	bool	if an import library should be created
bool	GetUseConsoleRunner
void	SetUseConsoleRunner	bool	for targets generating a console executable.
ProjectFile*	GetFile	int	returns a file from the target
int	GetFilesCount		returns number of files of target

cbProject

Extends CompileTargetBase.

Return value	Name	Arguments	Remarks
bool	GetModified
void	SetModified	bool
wxString	GetMakefile
void	SetMakefile	wxString
bool	IsMakefileCustom
void	SetMakefileCustom	bool
bool	CloseAllFiles	bool
bool	SaveAllFiles
bool	Save
bool	SaveLayout
bool	LoadLayout
bool	ShowOptions		Display the project options dialog
wxString	GetCommonTopLevelPath
int	GetFilesCount		Returns number of files in the project
ProjectFile*	GetFile	int
ProjectFile*	GetFileByFilename	wxString,bool,bool	name, is relative, is Unixfilename
bool	RemoveFile	ProjectFile *
ProjectFile*	AddFile	wxString	wxString, wxString, bool, bool, int	See API docs for cbProject::AddFile
ProjectFile*	AddFile	wxString	int, wxString, bool, bool, int	See API docs for cbProject::AddFile
int	GetBuildTargetsCount		number targets
ProjectBuildTarget*	GetBuildTarget	int	target index
ProjectBuildTarget*	GetBuildTarget	wxString	target name, if '*' exists -> real target
ProjectBuildTarget*	AddBuildTarget	wxString	target name
bool	RenameBuildTarget	int, wxString	target index, new name
bool	RenameBuildTarget	wxString, wxString	old name, new name
ProjectBuildTarget*	DuplicateBuildTarget	int, wxString	index, new name
ProjectBuildTarget*	DuplicateBuildTarget	wxString, wxString	target name, new name
bool	RemoveBuildTarget	int	index
bool	RemoveBuildTarget	wxString	target name
bool	ExportTargetAsProject	int	target index
bool	ExportTargetAsProject	wxString	target name
bool	BuildTargetValid	bool
wxString	GetFirstValidBuildTargetName	bool
void	SetDefaultExecuteTarget	wxString
wxString	GetDefaultExecuteTarget	wxString
bool	SetActiveBuildTarget	wxString
wxString	GetActiveBuildTarget		active target name, might be a virtual target
int	SelectTarget	int,bool
ProjectBuildTarget*	GetCurrentlyCompilingTarget
void	SetCurrentlyCompilingTarget	ProjectBuildTarget*
PCHMode	GetModeForPCH
void	SetModeForPCH	PCHMode
void	SetExtendedObjectNamesGeneration	bool
bool	GetExtendedObjectNamesGeneration
void	SetNotes	wxString
wxString	GetNotes
void	SetShowNotesOnLoad	bool
bool	GetShowNotesOnLoad
void	ShowNotes	bool,bool
void	AddToExtensions	wxString
bool	DefineVirtualBuildTarget	wxString,wxArrayString	arg1=alias virtual target, arg2= array targets
bool	HasVirtualBuildTarget	wxSring	arg=alias virtual target
bool	RemoveVirtualBuildTarget	wxString	arg=alias virtual target, return true if removed
wxArrayString	GetVirtualBuildTargets		Get a list of all defined virtual build targets.
wxArrayString	GetVirtualBuildTargetGroup	wxString	arg=alias, Access a virtual build target's group of build targets.
wxArrayString	GetExpandedVirtualBuildTargetGroup	wxString	arg=alias, Access a virtual build target's expanded group of build targets.
bool	CanAddToVirtualBuildTarget	wxSring,wxString	arg1=alias, arg2=name target to add, Checks if a build target (virtual or real) can be added to a virtual build target, without causing a circular-reference.
void	SetTitle	wxSring

EditorBase

Return value	Name	Arguments	Remarks
wxString	GetFilename
void	SetFilename	wxString
wxString	GetShortName
bool	GetModified
void	SetModified	bool
wxString	GetTitle
void	SetTitle	wxString
void	Activate
bool	Close
bool	Save
bool	IsBuiltinEditor
bool	ThereAreOthers
void	GotoLine	int,bool
void	ToggleBreakpoint	int,bool
bool	HasBreakpoint	int
void	GotoNextBreakpoint
void	GotoPreviousBreakpoint
void	ToggleBookmark	int,bool
bool	HasBookmark	int
void	GotoNextBookmark
void	GotoPreviousBookmark
void	Undo
void	Redo
void	Cut
void	Copy
void	Paste
bool	CanUndo
bool	CanRedo
bool	CanPaste
bool	HasSelection

cbEditor

Extends EditorBase.

Return value	Name	Arguments	Remarks
void	SetEditorTitle	wxString
ProjectFile*	GetProjectFile
bool	Save
bool	SaveAs
void	FoldAll
void	UnfoldAll
void	ToggleAllFolds
void	FoldBlockFromLine	int
void	UnfoldBlockFromLine	int
void	ToggleFoldBlockFromLine	int
int	GetLineIndentInSpaces	int
wxString	GetLineIndentString	int
void	Touch
bool	Reload	bool
void	Print	bool,PrintColourMode,bool
void	AutoComplete
bool	AddBreakpoint	int,bool
bool	RemoveBreakpoint	int,bool
void	SetText	wxString	this is not present in cbEditor; included to help scripts edit text
wxString	GetText		this is not present in cbEditor; included to help scripts edit text

Constants

Constant	Type	Remarks
PLATFORM	int	this defines the platform Code::Blocks is currently running on. It is equal to only one of the following PLATFORM_* constants
PLATFORM_MSW	int	All Windows platforms
PLATFORM_GTK	int	All GTK platforms (Linux, BSD, Solaris, Darwin, etc.)
PLATFORM_MAC	int	All Mac platforms
PLATFORM_OS2	int	OS/2 platform
PLATFORM_X11	int	All X11 platforms
PLATFORM_UNKNOWN	int	Unknown platform. Please inform us if PLATFORM == PLATFORM_UNKNOWN so we can make this platform known too ;)
Plugin version
PLUGIN_SDK_VERSION_MAJOR	int	=1, it will change when the SDK interface breaks
PLUGIN_SDK_VERSION_MINOR	int	=13, it will change when the SDK interface breaks
PLUGIN_SDK_VERSION_RELEASE	int	=13, it will change when the SDK interface breaks
Path separator for filenames
wxFILE_SEP_PATH	wxString	Path separator. "\" for windows, "/" for all other platforms
Message dialog flags
wxOK	int	Flag for Message() 's third argument (flags).
wxYES_NO	int	-"-
wxCANCEL	int	-"-
wxICON_QUESTION	int	-"-
wxICON_INFORMATION	int	-"-
wxICON_WARNING	int	-"-
wxICON_ERROR	int	-"-
Message dialog return values
wxID_OK	int
wxID_YES	int
wxID_NO	int
wxID_CANCEL	int
enum wxPathFormat
wxPATH_NATIVE	enum
wxPATH_UNIX	enum
wxPATH_BEOS	enum
wxPATH_MAC	enum
wxPATH_DOS	enum
wxPATH_WIN	enum
wxPATH_OS2	enum
wxPATH_VM3	enum
For wxFileName::GetPath()
wxPATH_GET_VOLUME	enum	include the volume if applicable
wxPATH_GET_SEPARATOR	enum	terminate the path with the separator
enum wxPathNormalize
wxPATH_NORM_ENV_VARS	enum	replace env vars with their values
wxPATH_NORM_DOTS	enum	squeeze all .. and . and prepend cwd
wxPATH_NORM_TILDE	enum	Unix only: replace ~ and ~user
wxPATH_NORM_CASE	enum	if case insensitive => tolower
wxPATH_NORM_ABSOLUTE	enum	make the path absolute
wxPATH_NORM_LONG	enum	make the path the long form
wxPATH_NORM_SHORTCUT	enum	resolve the shortcut, if it is a shortcut
wxPATH_NORM_ALL	enum	= 0x00ff & ~wxPATH_NORM_CASE
enum OptionsRelationType
ortCompilerOptions	enum
ortLinkerOptions	enum
ortIncludeDirs	enum
ortLibDirs	enum
ortResDirs	enum
enum OptionsRelation
orUseParentOptionsOnly	enum
orUseTargetOptionsOnly	enum
orPrependToParentOptions	enum
orAppendToParentOptions	enum
enum TargetType
ttExecutable	enum
ttConsoleOnly	enum
ttStaticLib	enum
ttDynamicLib	enum
ttCommandsOnly	enum
enum MakeCommand
mcClean	enum
mcDistClean	enum
mcBuild	enum
mcCompileFile	enum
mcAskRebuildNeeded	enum
mcSilentBuild	enum
enum PCHMode
pchSourceDir	enum
pchObjectDir	enum
pchSourceFile	enum
enum PrintScope
psSelection	enum
psActiveEditor	enum
psAllOpenEditors	enum
enum PrintColourMode
pcmBlackAndWhite	enum
pcmColourOnWhite	enum
pcmInvertColours	enum
pcmAsIs	enum
enum TemplateOutputType
wizProject	enum	TemplateOutputType::totProject
wizTarget	enum	TemplateOutputType::totTarget
wizFiles	enum	TemplateOutputType::totFiles
wizCustom	enum	TemplateOutputType::totCustom
enum SearchDirs
sdHome	enum	User's home directory
sdBase	enum	Code::Blocks' installation base
sdTemp	enum	System-wide temp folder
sdPath	enum	All dirs in the PATH environment variable
sdConfig	enum	Config folder
sdCurrent	enum	Current working folder
sdPluginsUser	enum	Plugins folder in user's dir
sdScriptsUser	enum	Scripts folder in user's dir
sdDataUser	enum	Data folder in user's dir
sdAllUser	enum	Convenience value meaning "all sd*User values"
sdPluginsGlobal	enum	Plugins folder in base dir
sdScriptsGlobal	enum	Scripts folder in base dir
sdDataGlobal	enum	Data folder in base dir
sdAllGlobal	enum	Convenience value meaning "all sd*Global values"
sdAllKnown	enum	All known dirs (i.e. all of the above)
SupportedPlatforms
spMac	enum
spUnix	enum
spWindows	enum
spAll	enum
TargetFilenameGenerationPolicy
tgfpPlatformDefault	enum	Generate filename based on running platform defaults.
tgfpNone	enum	No automatic generation; let the user specify the full filename
ModuleType
mtProjectManager	enum
mtEditorManager	enum
mtLogManager	enum
mtOpenFilesList	enum
mtEditorTab	enum
mtUnknown	enum
FileTreeDataKind
ftdkUndefined	enum
ftdkProject	enum
ftdkFolder	enum
ftdkFile	enum
ftdkVirtualGroup	enum
ftdkVirtualFolder	enum
File extensions (e.g. "cbp")
EXT_WORKSPACE	wxString
EXT_CODEBLOCKS	wxString
EXT_DEVCPP	wxString
EXT_MSVC6	wxString
EXT_MSVC7	wxString
EXT_MSVC10	wxString
EXT_MSVC6_WORKSPACE	wxString
EXT_MSVC7_WORKSPACE	wxString
EXT_ASM	wxString
EXT_D	wxString
EXT_F	wxString
EXT_F77	wxString
EXT_F90	wxString
EXT_F95	wxString
EXT_FOR	wxString
EXT_FPP	wxString
EXT_F03	wxString
EXT_F08	wxString
EXT_JAVA	wxString
EXT_C	wxString
EXT_CC	wxString
EXT_CPP	wxString
EXT_CXX	wxString
EXT_CPLPL	wxString
EXT_INL	wxString
EXT_H	wxString
EXT_HH	wxString
EXT_HPP	wxString
EXT_HXX	wxString
EXT_HPLPL	wxString
EXT_S	wxString
EXT_SS	wxString
EXT_S62	wxString
EXT_OBJECT	wxString
EXT_XRCRESOURCE	wxString
EXT_STATICLIB	wxString
EXT_DYNAMICLIB	wxString
EXT_EXECUTABLE	wxString
EXT_NATIVE	wxString
EXT_RESOURCE	wxString
EXT_RESOURCEBIN	wxString
EXT_XML	wxString
EXT_SCRIPT	wxString
File extensions with leading dot (e.g. ".cbp")
DOT_EXT_WORKSPACE	wxString
DOT_EXT_CODEBLOCKS	wxString
DOT_EXT_DEVCPP	wxString
DOT_EXT_MSVC6	wxString
DOT_EXT_MSVC7	wxString
DOT_EXT_MSVC10	wxString
DOT_EXT_MSVC7_WORKSPACE	wxString
DOT_EXT_MSVC6_WORKSPACE	wxString
DOT_EXT_D	wxString
DOT_EXT_F	wxString
DOT_EXT_F77	wxString
DOT_EXT_F90	wxString
DOT_EXT_F95	wxString
DOT_EXT_FOR	wxString
DOT_EXT_FPP	wxString
DOT_EXT_F03	wxString
DOT_EXT_F08	wxString
DOT_EXT_JAVA	wxString
DOT_EXT_C	wxString
DOT_EXT_CC	wxString
DOT_EXT_CPP	wxString
DOT_EXT_CXX	wxString
DOT_EXT_HPP	wxString
DOT_EXT_CPLPL	wxString
DOT_EXT_H	wxString
DOT_EXT_HH	wxString
DOT_EXT_HPP	wxString
DOT_EXT_HXX	wxString
DOT_EXT_HPLPL	wxString
DOT_EXT_S	wxString
DOT_EXT_SS	wxString
DOT_EXT_S62	wxString
DOT_EXT_OBJECT	wxString
DOT_EXT_XRCRESOURCE	wxString
DOT_EXT_STATICLIB	wxString
DOT_EXT_DYNAMICLIB	wxString
DOT_EXT_EXECUTABLE	wxString
DOT_EXT_NATIVE	wxString
DOT_EXT_RESOURCE	wxString
DOT_EXT_RESOURCEBIN	wxString
DOT_EXT_XML	wxString
DOT_EXT_SCRIPT	wxString

Plugins with script bindings

Environment Variables plugin Plugin to change environment variables

See also

• Scripting index