You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
314 lines
13 KiB
314 lines
13 KiB
// -*- c++ -*-
|
|
/* This file is part of the KDE libraries
|
|
Copyright (C) 2003 Joseph Wenninger <jowenn@kde.org>
|
|
2003 Andras Mantia <amantia@freemail.hu>
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Library General Public License
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __KENCODINGFILEDIALOG_H__
|
|
#define __KENCODINGFILEDIALOG_H__
|
|
|
|
#include <kfiledialog.h>
|
|
|
|
struct KEncodingFileDialogPrivate;
|
|
|
|
/**
|
|
* Provides a user (and developer) friendly way to
|
|
* select files with support for choosing encoding
|
|
*
|
|
*
|
|
* The dialog has been designed to allow applications to customise it
|
|
* by subclassing. It uses geometry management to ensure that subclasses
|
|
* can easily add children that will be incorporated into the layout.
|
|
*/
|
|
|
|
class KIO_EXPORT KEncodingFileDialog : public KFileDialog
|
|
{
|
|
Q_OBJECT
|
|
|
|
public:
|
|
class Result {
|
|
public:
|
|
TQStringList fileNames;
|
|
KURL::List URLs;
|
|
TQString encoding;
|
|
};
|
|
|
|
/**
|
|
* Constructs a file dialog for text files with encoding selection possibility.
|
|
*
|
|
* @param startDir This can either be
|
|
* @li The URL of the directory to start in.
|
|
* @li TQString::null to start in the current working
|
|
* directory, or the last directory where a file has been
|
|
* selected.
|
|
* @li ':<keyword>' to start in the directory last used
|
|
* by a filedialog in the same application that specified
|
|
* the same keyword.
|
|
* @li '::<keyword>' to start in the directory last used
|
|
* by a filedialog in any application that specified the
|
|
* same keyword.
|
|
*
|
|
* @param encoding The encoding shown in the encoding combo. If it's
|
|
* TQString::null, the global default encoding will be shown.
|
|
*
|
|
* @param filter This is a space separated list of shell globs.
|
|
* You can set the text to be displayed for the glob, and
|
|
* provide multiple globs. See setFilter() for details on
|
|
* how to do this...
|
|
*
|
|
* @param caption The caption of the dialog
|
|
*
|
|
* @param type This can either be
|
|
* @li Opening (open dialog, the default setting)
|
|
* @li Saving
|
|
* @param parent The parent widget of this dialog
|
|
* @param name The name of this object
|
|
* @param modal Whether to create a modal dialog or not
|
|
*
|
|
* @since 3.2
|
|
*/
|
|
KEncodingFileDialog (const TQString& startDir = TQString::null,
|
|
const TQString& encoding = TQString::null,
|
|
const TQString& filter = TQString::null,
|
|
const TQString& caption = TQString::null, KFileDialog::OperationMode type = KFileDialog::Opening,
|
|
TQWidget *parent= 0, const char *name="", bool modal = true);
|
|
/**
|
|
* Destructs the file dialog.
|
|
*/
|
|
~KEncodingFileDialog();
|
|
|
|
|
|
/**
|
|
* @returns The selected encoding if the constructor with the encoding parameter was used, otherwise TQString::null.
|
|
*/
|
|
TQString selectedEncoding() const;
|
|
|
|
|
|
/**
|
|
* Creates a modal file dialog and return the selected
|
|
* filename or an empty string if none was chosen additionally a chosen
|
|
* encoding value is returned.
|
|
*
|
|
* Note that with
|
|
* this method the user must select an existing filename.
|
|
*
|
|
* @param startDir This can either be
|
|
* @li The URL of the directory to start in.
|
|
* @li TQString::null to start in the current working
|
|
* directory, or the last directory where a file has been
|
|
* selected.
|
|
* @li ':<keyword>' to start in the directory last used
|
|
* by a filedialog in the same application that specified
|
|
* the same keyword.
|
|
* @li '::<keyword>' to start in the directory last used
|
|
* by a filedialog in any application that specified the
|
|
* same keyword.
|
|
* @param encoding The encoding shown in the encoding combo.
|
|
* @param filter This is a space separated list of shell globs.
|
|
* You can set the text to be displayed for the glob, and
|
|
* provide multiple globs. See setFilter() for details on
|
|
* how to do this...
|
|
* @param parent The widget the dialog will be centered on initially.
|
|
* @param caption The name of the dialog widget.
|
|
*/
|
|
static Result getOpenFileNameAndEncoding(const TQString& encoding=TQString::null,
|
|
const TQString& startDir= TQString::null,
|
|
const TQString& filter= TQString::null,
|
|
TQWidget *parent= 0,
|
|
const TQString& caption = TQString::null);
|
|
|
|
/**
|
|
* Creates a modal file dialog and returns the selected encoding and the selected
|
|
* filenames or an empty list if none was chosen.
|
|
*
|
|
* Note that with
|
|
* this method the user must select an existing filename.
|
|
*
|
|
* @param startDir This can either be
|
|
* @li The URL of the directory to start in.
|
|
* @li TQString::null to start in the current working
|
|
* directory, or the last directory where a file has been
|
|
* selected.
|
|
* @li ':<keyword>' to start in the directory last used
|
|
* by a filedialog in the same application that specified
|
|
* the same keyword.
|
|
* @li '::<keyword>' to start in the directory last used
|
|
* by a filedialog in any application that specified the
|
|
* same keyword.
|
|
* @param encoding The encoding shown in the encoding combo.
|
|
* @param filter This is a space separated list of shell globs.
|
|
* You can set the text to be displayed for the glob, and
|
|
* provide multiple globs. See setFilter() for details on
|
|
* how to do this.
|
|
* @param parent The widget the dialog will be centered on initially.
|
|
* @param caption The name of the dialog widget.
|
|
*/
|
|
static Result getOpenFileNamesAndEncoding(const TQString& encoding=TQString::null,
|
|
const TQString& startDir= TQString::null,
|
|
const TQString& filter= TQString::null,
|
|
TQWidget *parent = 0,
|
|
const TQString& caption= TQString::null);
|
|
|
|
/**
|
|
* Creates a modal file dialog and returns the selected encoding and
|
|
* URL or an empty string if none was chosen.
|
|
*
|
|
* Note that with
|
|
* this method the user must select an existing URL.
|
|
*
|
|
* @param startDir This can either be
|
|
* @li The URL of the directory to start in.
|
|
* @li TQString::null to start in the current working
|
|
* directory, or the last directory where a file has been
|
|
* selected.
|
|
* @li ':<keyword>' to start in the directory last used
|
|
* by a filedialog in the same application that specified
|
|
* the same keyword.
|
|
* @li '::<keyword>' to start in the directory last used
|
|
* by a filedialog in any application that specified the
|
|
* same keyword.
|
|
* @param encoding The encoding shown in the encoding combo.
|
|
* @param filter This is a space separated list of shell globs.
|
|
* You can set the text to be displayed for the glob, and
|
|
* provide multiple globs. See setFilter() for details on
|
|
* how to do this...
|
|
* @param parent The widget the dialog will be centered on initially.
|
|
* @param caption The name of the dialog widget.
|
|
*/
|
|
static Result getOpenURLAndEncoding(const TQString& encoding=TQString::null,
|
|
const TQString& startDir = TQString::null,
|
|
const TQString& filter= TQString::null,
|
|
TQWidget *parent= 0,
|
|
const TQString& caption = TQString::null);
|
|
|
|
|
|
|
|
|
|
/**
|
|
* Creates a modal file dialog and returns the selected encoding
|
|
* URLs or an empty list if none was chosen.
|
|
*
|
|
* Note that with
|
|
* this method the user must select an existing filename.
|
|
*
|
|
* @param startDir This can either be
|
|
* @li The URL of the directory to start in.
|
|
* @li TQString::null to start in the current working
|
|
* directory, or the last directory where a file has been
|
|
* selected.
|
|
* @li ':<keyword>' to start in the directory last used
|
|
* by a filedialog in the same application that specified
|
|
* the same keyword.
|
|
* @li '::<keyword>' to start in the directory last used
|
|
* by a filedialog in any application that specified the
|
|
* same keyword.
|
|
* @param encoding The encoding shown in the encoding combo.
|
|
* @param filter This is a space separated list of shell globs.
|
|
* You can set the text to be displayed for the glob, and
|
|
* provide multiple globs. See setFilter() for details on
|
|
* how to do this...
|
|
* @param parent The widget the dialog will be centered on initially.
|
|
* @param caption The name of the dialog widget.
|
|
*/
|
|
static Result getOpenURLsAndEncoding(const TQString& encoding=TQString::null,
|
|
const TQString& startDir= TQString::null,
|
|
const TQString& filter= TQString::null,
|
|
TQWidget *parent = 0,
|
|
const TQString& caption= TQString::null);
|
|
|
|
|
|
|
|
/**
|
|
* Creates a modal file dialog and returns the selected encoding and
|
|
* filename or an empty string if none was chosen.
|
|
*
|
|
* Note that with this
|
|
* method the user need not select an existing filename.
|
|
*
|
|
* @param startDir This can either be
|
|
* @li The URL of the directory to start in.
|
|
* @li a relative path or a filename determining the
|
|
* directory to start in and the file to be selected.
|
|
* @li TQString::null to start in the current working
|
|
* directory, or the last directory where a file has been
|
|
* selected.
|
|
* @li ':<keyword>' to start in the directory last used
|
|
* by a filedialog in the same application that specified
|
|
* the same keyword.
|
|
* @li '::<keyword>' to start in the directory last used
|
|
* by a filedialog in any application that specified the
|
|
* same keyword.
|
|
* @param encoding The encoding shown in the encoding combo.
|
|
* @param filter This is a space separated list of shell globs.
|
|
* You can set the text to be displayed for the glob, and
|
|
* provide multiple globs. See setFilter() for details on
|
|
* how to do this...
|
|
* @param parent The widget the dialog will be centered on initially.
|
|
* @param caption The name of the dialog widget.
|
|
*/
|
|
static Result getSaveFileNameAndEncoding(const TQString& encoding=TQString::null,
|
|
const TQString& startDir=TQString::null,
|
|
const TQString& filter= TQString::null,
|
|
TQWidget *parent= 0,
|
|
const TQString& caption = TQString::null);
|
|
|
|
|
|
/**
|
|
* Creates a modal file dialog and returns the selected encoding and
|
|
* filename or an empty string if none was chosen.
|
|
*
|
|
* Note that with this
|
|
* method the user need not select an existing filename.
|
|
*
|
|
* @param startDir This can either be
|
|
* @li The URL of the directory to start in.
|
|
* @li a relative path or a filename determining the
|
|
* directory to start in and the file to be selected.
|
|
* @li TQString::null to start in the current working
|
|
* directory, or the last directory where a file has been
|
|
* selected.
|
|
* @li ':<keyword>' to start in the directory last used
|
|
* by a filedialog in the same application that specified
|
|
* the same keyword.
|
|
* @li '::<keyword>' to start in the directory last used
|
|
* by a filedialog in any application that specified the
|
|
* same keyword.
|
|
* @param encoding The encoding shown in the encoding combo.
|
|
* @param filter This is a space separated list of shell globs.
|
|
* You can set the text to be displayed for the glob, and
|
|
* provide multiple globs. See setFilter() for details on
|
|
* how to do this...
|
|
* @param parent The widget the dialog will be centered on initially.
|
|
* @param caption The name of the dialog widget.
|
|
*/
|
|
static Result getSaveURLAndEncoding(const TQString& encoding=TQString::null,
|
|
const TQString& startDir= TQString::null,
|
|
const TQString& filter= TQString::null,
|
|
TQWidget *parent= 0,
|
|
const TQString& caption = TQString::null);
|
|
|
|
|
|
|
|
protected:
|
|
virtual void virtual_hook( int id, void* data );
|
|
private:
|
|
KEncodingFileDialogPrivate *d;
|
|
};
|
|
|
|
#endif
|