Edit history

Edit: -1 of 1
Time: 2008-09-01 20:28:19
Note: /dabosite/wiki/DaboUiWidgets/edit

changed:
-
**dPageSelect** is one variation on the paged control; instead of using tabs to select pages, the user is given a dropdown list; selecting an item in the list selects the associated page. This is a good choice when there are more pages than can comfortably fit using tabs

---- 

Some of the more useful properties for **dPageSelect**:

 <table border="0" width="95%" cellspacing="16">
	<tr>
		<td>**!PageClass** - (dPage): The default class to use for pages added to the control.</td>
	</tr>
	<tr>
		<td>**!PageCount** - (int): This isn't just a read-only counting of pages; changing this property will add or delete pages to bring the total number of pages in line.</td>
	</tr>
	<tr>
		<td>**Pages** - (list): a read-only list of the pages in this control.</td>
	</tr>
	<tr>
		<td>**!PageSizerClass** - (dSizer or dGridSizer): When a new page is created, this is the class of the sizer that is automatically added to it.</td>
	</tr>
	<tr>
		<td>**!SelectedPage** - (dPage): A reference to the currently visible page.</td>
	</tr>
	<tr>
		<td>**!SelectedPageNumber** - (int): The index of the SelectedPage.</td>
	</tr>
	<tr>
		<td>**!TabPosition** - (str): Can be one of: Top (default), Bottom, Left or Right. However, due to the shape of the dropdown list, Top and Bottom are really the only practical choices.</td>
	</tr>
</table>
	
---- 

Some of the more useful methods for **dPageSelect**:

 <table border="0" width="95%" cellspacing="16">
	<tr>
		<td>**appendPage(page)** - (dPage): Adds a new page to the control. 'page' can be either a page instance or a page class to be instantiated. The page is placed in the last position in the control, and a reference to it is returned.</td>
	</tr>
	<tr>
		<td>**insertPage(pos, page)** - (dPage): Adds a new page to the control. 'page' can be either a page instance or a page class to be instantiated. The page is placed in the position specified by 'pos', and a reference to it is returned.</td>
	</tr>
	<tr>
		<td>**removePage(pgOrPos, delete=True)** - (None or dPage): Removes the specified page from the control. You can pass a reference to the page, or its index in the control. If 'delete' is False, the page is not destroyed, and a reference to it is returned. Otherwise, the page is destroyed and None is returned.</td>
	</tr>
	<tr>
		<td>**movePage(oldPgOrPos, newPos, selecting=True)** - (None or True): Changes the position of the specified page. If the old and new positions are the same, nothing happens and None is returned; otherwise, the page is moved and True is returned. Unless you pass 'selecting=False', the specified page is selected.</td>
	</tr>
	<tr>
		<td>**cyclePages(num)** - (None): Moves through the pages by the specified amount, wrapping around the ends. Negative values move to previous pages; positive move through the next pages.</td>
	</tr>
</table>
	

See the <a href="http://dabodev.com/getDaboDoc">Dabo Class Documentation</a> for an exhaustive documentation of this control's Properties and Methods.