xtd::forms::open_file_dialog Class Reference

#include <open_file_dialog.h>

Definition

Displays a standard dialog box that prompts the user to open a file. This class cannot be inherited.

Namespace

xtd::forms

Library

xtd.forms

Examples

The following code example demonstrate the use of open_file_dialog dialog.

#include <xtd/xtd>
 
using namespace std;
using namespace xtd;
using namespace xtd::forms;
 
class form1 : public form {
public:
  form1() {
    text("Open file dialog example");
    controls().push_back(button1);
 
    button1.location({10, 10});
    button1.text("Open...");
    button1.click += [&] {
      open_file_dialog dialog;
      dialog.initial_directory(!file_name.empty() ? io::path::get_directory_name(file_name) : environment::get_folder_path(environment::special_folder::desktop));
      dialog.file_name(io::path::get_file_name(file_name));
      dialog.filter("Text Files (*.txt)|*.txt|All Files (*.*)|*.*");
      if (dialog.show_sheet_dialog(*this) == forms::dialog_result::ok) {
        file_name = dialog.file_name();
        label1.text(ustring::format("File = {}", file_name));
      }
    };
 
    label1.parent(*this);
    label1.text("File = ");
    label1.auto_size(true);
    label1.location({10, 40});
  }
  
private:
  button button1;
  label label1;
  ustring file_name;
};
 
int main() {
  application::run(form1());
}

Examples

image_list.cpp, and open_file_dialog.cpp.

Inherits xtd::forms::file_dialog.

Public Member Functions
	open_file_dialog ()=default
	Initializes a new instance of the open_file_dialog class.
virtual bool	multiselect () const
	Gets a value indicating whether the dialog box allows multiple files to be selected.
virtual open_file_dialog &	multiselect (bool value)
	Sets a value indicating whether the dialog box allows multiple files to be selected.
std::ifstream	open_file () const
	Opens the file with read only permission selected by the user.
Public Member Functions inherited from xtd::forms::file_dialog
	file_dialog ()=default
	Initializes a new instance of the common_dialog class.
virtual bool	add_extension () const
	Gets a value indicating whether the dialog box automatically adds an extension to a file name if the user omits the extension.
virtual file_dialog &	add_extension (bool value)
	Sets a value indicating whether the dialog box automatically adds an extension to a file name if the user omits the extension.
virtual bool	auto_upgrade_enabled () const
	Gets a value indicating whether this file_dialog instance should automatically upgrade appearance and behavior when running on Windows Vista.
virtual file_dialog &	auto_upgrade_enabled (bool value)
	Sets a value indicating whether this file_dialog instance should automatically upgrade appearance and behavior when running on Windows Vista.
virtual bool	check_file_exists () const
	Gets a value indicating whether the dialog box displays a warning if the user specifies a file name that does not exist.
virtual file_dialog &	check_file_exists (bool value)
	Sets a value indicating whether the dialog box displays a warning if the user specifies a file name that does not exist.
virtual bool	check_path_exists () const
	Gets a value indicating whether the dialog box displays a warning if the user specifies a path that does not exist.
virtual file_dialog &	check_path_exists (bool value)
	Sets a value indicating whether the dialog box displays a warning if the user specifies a path that does not exist.
virtual const xtd::ustring &	default_ext () const
	Gets the default file name extension.
virtual file_dialog &	default_ext (const xtd::ustring &value)
	Sets the default file name extension.
virtual bool	dereference_link () const
	Gets a value indicating whether the dialog box returns the location of the file referenced by the shortcut or whether it returns the location of the shortcut (.lnk).
virtual file_dialog &	dereference_link (bool value)
	Sets a value indicating whether the dialog box returns the location of the file referenced by the shortcut or whether it returns the location of the shortcut (.lnk).
virtual const xtd::ustring &	file_name () const
	Gets a string containing the file name selected in the file dialog box.
virtual file_dialog &	file_name (const xtd::ustring &value)
	Sets a string containing the file name selected in the file dialog box.
virtual const std::vector< xtd::ustring >	file_names () const
	Gets the file names of all selected files in the dialog box.
virtual const xtd::ustring &	filter () const
	Gets the current file name filter string, which determines the choices that appear in the "Save as file type" or "Files of type" box in the dialog box.
virtual file_dialog &	filter (const xtd::ustring &value)
	Sets the current file name filter string, which determines the choices that appear in the "Save as file type" or "Files of type" box in the dialog box.
virtual size_t	filter_index () const
	Gets the index of the filter currently selected in the file dialog box.
virtual file_dialog &	filter_index (size_t value)
	Sets the index of the filter currently selected in the file dialog box.
virtual const xtd::ustring &	initial_directory () const
	Gets the initial directory displayed by the file dialog box.
virtual file_dialog &	initial_directory (const xtd::ustring &value)
	Sets the initial directory displayed by the file dialog box.
size_t	options () const
	Gets values to initialize the file_dialog.
void	reset () override
	Resets all properties to their default values.
virtual bool	restore_directory () const
	Gets a value indicating whether the dialog box restores the directory to the previously selected directory before closing.
virtual file_dialog &	restore_directory (bool value)
	Sets a value indicating whether the dialog box restores the directory to the previously selected directory before closing.
virtual bool	show_help () const
	Gets a value indicating whether the Help button is displayed in the file dialog box.
virtual file_dialog &	show_help (bool value)
	Sets a value indicating whether the Help button is displayed in the file dialog box.
virtual bool	show_hidden_files () const
	Gets a value indicating whether hidden files are displayed in the file dialog box.
virtual file_dialog &	show_hidden_files (bool value)
	Sets a value indicating whether hidden files are displayed in the file dialog box.
virtual bool	show_preview () const
	Gets a value indicating whether preview file is displayed in the file dialog box.
virtual file_dialog &	show_preview (bool value)
	Sets a value indicating whether preview file is displayed in the file dialog box.
virtual bool	support_multi_dotted_extensions () const
	Gets whether the dialog box supports displaying and saving files that have multiple file name extensions.Gets or sets whether the dialog box supports displaying and saving files that have multiple file name extensions.
virtual file_dialog &	support_multi_dotted_extensions (bool value)
	Sets whether the dialog box supports displaying and saving files that have multiple file name extensions.Gets or sets whether the dialog box supports displaying and saving files that have multiple file name extensions.
virtual const xtd::ustring &	title () const
	Gets the file dialog box title.
virtual file_dialog &	title (const xtd::ustring &value)
	Sets the file dialog box title.
xtd::ustring	to_string () const noexcept override
	Provides a string version of this object.
virtual bool	validate_names () const
	Gets a value indicating whether the dialog box accepts only valid file names.
virtual file_dialog &	validate_names (bool value)
	Gets a value indicating whether the dialog box accepts only valid file names.
Public Member Functions inherited from xtd::forms::common_dialog
	common_dialog ()=default
	Initializes a new instance of the common_dialog class.
xtd::forms::dialog_result	dialog_result () const
	Get async dialog_result result after dialog box is closing.
virtual void	reset ()=0
	When overridden in a derived class, resets the properties of a common dialog box to their default values.
xtd::forms::dialog_result	show_dialog ()
	Runs a common dialog box with a default owner.
xtd::forms::dialog_result	show_dialog (const iwin32_window &owner)
	Runs a common dialog box with the specified owner.
void	show_sheet (const iwin32_window &owner)
	Runs a common dialog box with the specified owner.
xtd::forms::dialog_result	show_sheet_dialog (const iwin32_window &owner)
	Runs a common dialog box with the specified owner.
std::any	tag () const
	Gets an object that contains data about the control.
common_dialog &	tag (const std::any &tag)
	Sets an object that contains data about the control.
Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.
virtual bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object.
virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type.
template<typename object_t >
std::unique_ptr< object_t >	memberwise_clone () const
	Gets the type of the current instance.
virtual xtd::ustring	to_string () const noexcept
	Returns a std::string that represents the current object.

Additional Inherited Members
Public Attributes inherited from xtd::forms::common_dialog
event< common_dialog, dialog_closed_event_handler >	dialog_closed
	Occurs when the user close a common dialog box with dialog close button or other dialog buttons.
event< common_dialog, help_event_handler >	help_request
	Occurs when the user clicks the Help button on a common dialog box.
Static Public Member Functions inherited from xtd::object
static bool	equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are considered equal.
static bool	reference_equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are the same instance.
Protected Member Functions inherited from xtd::forms::file_dialog
bool	run_dialog (intptr_t hwnd_owner) override
	Runs file dialog box.
void	run_sheet (intptr_t hwnd_owner) override
	Runs file dialog box in sheet mode.
Protected Member Functions inherited from xtd::forms::common_dialog
virtual void	on_dialog_closed (const dialog_closed_event_args &e)
	Raises the common_dialog::dialog_close event.
virtual void	on_help_request (help_event_args &e)
	Raises the common_dialog::help_request event.
virtual bool	run_dialog (intptr_t hwnd_owner)=0
	When overridden in a derived class, specifies a common dialog box.
virtual void	run_sheet (intptr_t hwnd_owner)=0
	When overridden in a derived class, specifies a common dialog box.
Protected Member Functions inherited from xtd::forms::component
	component ()=default
	Initialises a new instance of the component class.
virtual bool	can_raise_events () const
	Gets a value indicating whether the component can raise an event.
bool	design_mode () const
	Gets a value that indicates whether the component is currently in design mode.

Constructor & Destructor Documentation

open_file_dialog()

xtd::forms::open_file_dialog::open_file_dialog ( )

default

Initializes a new instance of the open_file_dialog class.

Member Function Documentation

multiselect() [1/2]

virtual bool xtd::forms::open_file_dialog::multiselect ( ) const

inlinevirtual

Gets a value indicating whether the dialog box allows multiple files to be selected.

Returns

true if the dialog box allows multiple files to be selected together or concurrently; otherwise, false. The default value is false.

Remarks

Use the file_names property to access the full list of selected file names.

Examples

image_list.cpp.

multiselect() [2/2]

virtual open_file_dialog & xtd::forms::open_file_dialog::multiselect ( bool  value )

inlinevirtual

Sets a value indicating whether the dialog box allows multiple files to be selected.

Parameters

value

true if the dialog box allows multiple files to be selected together or concurrently; otherwise, false. The default value is false.

Returns

Current open_file_dialog.

Remarks

Use the file_names property to access the full list of selected file names.

open_file()

std::ifstream xtd::forms::open_file_dialog::open_file ( ) const

inline

Opens the file with read only permission selected by the user.

Returns

The read only file selected by the user.

---

The documentation for this class was generated from the following file:

• xtd.forms/include/xtd/forms/open_file_dialog.h