From ea318d1431c89e647598c510c4245c6571aa5f46 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Thu, 26 Jan 2012 23:32:43 -0600 Subject: Update to latest tqt3 automated conversion --- doc/html/ntqwizard.html | 337 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 337 insertions(+) create mode 100644 doc/html/ntqwizard.html (limited to 'doc/html/ntqwizard.html') diff --git a/doc/html/ntqwizard.html b/doc/html/ntqwizard.html new file mode 100644 index 000000000..fec3c228a --- /dev/null +++ b/doc/html/ntqwizard.html @@ -0,0 +1,337 @@ + + + + + +TQWizard Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQWizard Class Reference

+ +

The TQWizard class provides a framework for wizard dialogs. +More... +

#include <ntqwizard.h> +

Inherits TQDialog. +

List of all member functions. +

Public Members

+ +

Public Slots

+ +

Signals

+ +

Properties

+ +

Protected Members

+ +

Protected Slots

+ +

Detailed Description

+ + +The TQWizard class provides a framework for wizard dialogs. +

+ + + +

A wizard is a special type of input dialog that consists of a +sequence of dialog pages. A wizard's purpose is to walk the user +through a process step by step. Wizards are useful for complex or +infrequently occurring tasks that people may find difficult to +learn or do. +

TQWizard provides page titles and displays Next, Back, Finish, +Cancel, and Help push buttons, as appropriate to the current +position in the page sequence. These buttons can be +enabled/disabled using setBackEnabled(), setNextEnabled(), +setFinishEnabled() and setHelpEnabled(). +

Create and populate dialog pages that inherit from TQWidget and add +them to the wizard using addPage(). Use insertPage() to add a +dialog page at a certain position in the page sequence. Use +removePage() to remove a page from the page sequence. +

Use currentPage() to retrieve a pointer to the currently displayed +page. page() returns a pointer to the page at a certain position +in the page sequence. +

Use pageCount() to retrieve the total number of pages in the page +sequence. indexOf() will return the index of a page in the page +sequence. +

TQWizard provides functionality to mark pages as appropriate (or +not) in the current context with setAppropriate(). The idea is +that a page may be irrelevant and should be skipped depending on +the data entered by the user on a preceding page. +

It is generally considered good design to provide a greater number +of simple pages with fewer choices rather than a smaller number of +complex pages. +

Example code is available here: wizard/wizard.cpp wizard/wizard.h +

A TQWizard page

A TQWizard page +

+

See also Abstract Widget Classes, Dialog Classes, and Organizers. + +

Member Function Documentation

+

TQWizard::TQWizard ( TQWidget * parent = 0, const char * name = 0, bool modal = FALSE, WFlags f = 0 ) +

+Constructs an empty wizard dialog. The parent, name, modal and f arguments are passed to the TQDialog constructor. + +

TQWizard::~TQWizard () +

+Destroys the object and frees any allocated resources, including +all pages and controllers. + +

void TQWizard::addPage ( TQWidget * page, const TQString & title ) [virtual] +

+Adds page to the end of the page sequence, with the title, title. + +

bool TQWizard::appropriate ( TQWidget * page ) const [virtual] +

+Called when the Next button is clicked; this virtual function +returns TRUE if page is relevant for display in the current +context; otherwise it is ignored by TQWizard and returns FALSE. The +default implementation returns the value set using +setAppropriate(). The ultimate default is TRUE. +

Warning: The last page of the wizard will be displayed if no page +is relevant in the current context. + +

void TQWizard::back () [virtual protected slot] +

+Called when the user clicks the Back button; this function shows +the preceding relevant page in the sequence. +

See also appropriate(). + +

TQPushButton * TQWizard::backButton () const +

+Returns a pointer to the dialog's Back button +

By default, this button is connected to the back() slot, which is +virtual so you can reimplement it in a TQWizard subclass. Use +setBackEnabled() to enable/disable this button. + +

TQPushButton * TQWizard::cancelButton () const +

+Returns a pointer to the dialog's Cancel button +

By default, this button is connected to the TQDialog::reject() +slot, which is virtual so you can reimplement it in a TQWizard +subclass. + +

TQWidget * TQWizard::currentPage () const +

+Returns a pointer to the current page in the sequence. Although +the wizard does its best to make sure that this value is never 0, +it can be if you try hard enough. + +

TQPushButton * TQWizard::finishButton () const +

+Returns a pointer to the dialog's Finish button +

By default, this button is connected to the TQDialog::accept() +slot, which is virtual so you can reimplement it in a TQWizard +subclass. Use setFinishEnabled() to enable/disable this button. + +

void TQWizard::help () [virtual protected slot] +

+Called when the user clicks the Help button, this function emits +the helpClicked() signal. + +

TQPushButton * TQWizard::helpButton () const +

+Returns a pointer to the dialog's Help button +

By default, this button is connected to the help() slot, which is +virtual so you can reimplement it in a TQWizard subclass. Use +setHelpEnabled() to enable/disable this button. + +

void TQWizard::helpClicked () [signal] +

+ +

This signal is emitted when the user clicks on the Help button. + +

int TQWizard::indexOf ( TQWidget * page ) const +

+Returns the position of page page. If the page is not part of +the wizard -1 is returned. + +

void TQWizard::insertPage ( TQWidget * page, const TQString & title, int index ) [virtual] +

+Inserts page at position index into the page sequence, with +title title. If index is -1, the page will be appended to +the end of the wizard's page sequence. + +

void TQWizard::layOutButtonRow ( TQHBoxLayout * layout ) [virtual protected] +

+This virtual function is responsible for adding the buttons below +the bottom divider. +

layout is the horizontal layout of the entire wizard. + +

void TQWizard::layOutTitleRow ( TQHBoxLayout * layout, const TQString & title ) [virtual protected] +

+This virtual function is responsible for laying out the title row. +

layout is the horizontal layout for the wizard, and title is the title for this page. This function is called every +time title changes. + +

void TQWizard::next () [virtual protected slot] +

+Called when the user clicks the Next button, this function shows +the next relevant page in the sequence. +

See also appropriate(). + +

TQPushButton * TQWizard::nextButton () const +

+Returns a pointer to the dialog's Next button +

By default, this button is connected to the next() slot, which is +virtual so you can reimplement it in a TQWizard subclass. Use +setNextEnabled() to enable/disable this button. + +

TQWidget * TQWizard::page ( int index ) const +

+Returns a pointer to the page at position index in the +sequence, or 0 if index is out of range. The first page has +index 0. + +

int TQWizard::pageCount () const +

+Returns the number of pages in the wizard. + +

void TQWizard::removePage ( TQWidget * page ) [virtual] +

+Removes page from the page sequence but does not delete the +page. If page is currently being displayed, TQWizard will +display the page that precedes it, or the first page if this was +the first page. + +

void TQWizard::selected ( const TQString & ) [signal] +

+ +

This signal is emitted when the current page changes. The +parameter contains the title of the selected page. + +

void TQWizard::setAppropriate ( TQWidget * page, bool appropriate ) [virtual] +

+If appropriate is TRUE then page page is considered relevant +in the current context and should be displayed in the page +sequence; otherwise page should not be displayed in the page +sequence. +

See also appropriate(). + +

void TQWizard::setBackEnabled ( TQWidget * page, bool enable ) [virtual slot] +

+If enable is TRUE, page page has a Back button; otherwise page has no Back button. By default all pages have this button. + +

void TQWizard::setFinish ( TQWidget *, bool ) [virtual slot] +

+ +This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code. +

Use setFinishEnabled instead + +

void TQWizard::setFinishEnabled ( TQWidget * page, bool enable ) [virtual slot] +

+If enable is TRUE, page page has a Finish button; otherwise +page has no Finish button. By default no page has this +button. + +

void TQWizard::setHelpEnabled ( TQWidget * page, bool enable ) [virtual slot] +

+If enable is TRUE, page page has a Help button; otherwise page has no Help button. By default all pages have this button. + +

void TQWizard::setNextEnabled ( TQWidget * page, bool enable ) [virtual slot] +

+If enable is TRUE, page page has a Next button; otherwise +the Next button on page is disabled. By default all pages have +this button. + +

void TQWizard::setTitle ( TQWidget * page, const TQString & title ) +

+Sets the title for page page to title. + +

void TQWizard::setTitleFont ( const TQFont & ) +

Sets the font used for page titles. +See the "titleFont" property for details. +

void TQWizard::showPage ( TQWidget * page ) [virtual] +

+Makes page the current page and emits the selected() signal. +

This virtual function is called whenever a different page is to +be shown, including the first time the TQWizard is shown. +By reimplementing it (and calling TQWizard::showPage()), +you can prepare each page prior to it being shown. + +

Examples: distributor/distributor.ui.h and wizard/wizard.cpp. +

TQString TQWizard::title ( TQWidget * page ) const +

+Returns the title of page page. + +

TQFont TQWizard::titleFont () const +

Returns the font used for page titles. +See the "titleFont" property for details. +

Property Documentation

+

TQFont titleFont

+

This property holds the font used for page titles. +

The default is TQApplication::font(). + +

Set this property's value with setTitleFont() and get this property's value with titleFont(). + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1