QAudioSourceSelectorDialog Class Reference
[QtBaseModule]

Detailed Description

The QAudioSourceSelectorDialog class allows the user to select an audio document from a variety of sources.

QAudioSourceSelectorDialog allows the user to select an audio document from the documents system or from any QDS service on the device that allows an audio document to be retrieved, such as a microphone recording. It returns the user's selection to the client code as a QContent object.

The dialog will allow the user to invoke any QDS service that returns data in "audio/x-qstring" form and has the "get" attribute, or to select an existing audio document.

The following code uses QAudioSourceSelectorDialog to allow the user to select an audio document from any source:

    QAudioSourceSelectorDialog dialog( this );
    if( QtopiaApplication::execDialog( &dialog ) ) {
        // Accept
        QContent audio = dialog.content();
    } else {
        // Reject
    }

See also QDSServiceInfo and QDocumentSelectorDialog.

Member Function Documentation

QAudioSourceSelectorDialog::QAudioSourceSelectorDialog ( QWidget * parent )

Constructs a QAudioSourceSelectorDialog as a child of parent.

QAudioSourceSelectorDialog::~QAudioSourceSelectorDialog ()   [virtual]

Destroys the QAudioSourceSelectorDialog object.

QContent QAudioSourceSelectorDialog::content () const

Returns the audio document selected by the user.

See also setContent().

void QAudioSourceSelectorDialog::setContent ( const QContent & audio )

Sets the dialog to show audio as the selected audio document.

See also content().

void QAudioSourceSelectorDialog::setDefaultAudio ( const QString & type, const QString & subFormat, int frequency, int channels )

Sets the audio parameters to use if the user chooses to acquire new audio data.

The new audio data is requested to be of MIME type type, formatted as subFormat with the supplied frequency and number of channels.