Wizard Page Events

From Code::Blocks
Revision as of 09:33, 10 July 2006 by Mandrav (talk | contribs) (Initial text and Page IDs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

A script can handle various wizard events while the wizard is running. This page explains these events (and their uses) in detail.

Page IDs

Every wizard page (pre-defined or custom) has a unique page ID. This ID is a wxString that identifies the page in scripts.

These are the valid pre-defined page IDs:

Page ID
Intro "IntroPage"
File selection "FilePathPage"
Project settings "ProjectPathPage"
Compiler "CompilerPage"
Build target "BuildTargetPage"
Generic path
Generic single choice list

You 'll notice that the two last pre-defined pages don't have an ID. This is because you can have more than one of them inside the same wizard and so the IDs wouldn't be unique anymore.

For these two pages, the ID is the first argument passed to their creation calls. See AddGenericSelectPathPage and AddGenericSingleChoiceListPage syntax.

You can give these two pages any ID you want but make sure it's unique. Besides the obvious reasons why it should be unique, the page ID is also used by various wizard pages to store per-page user selections inside the Code::Blocks configuration. So a duplicate ID will save under the same configuration key...