Definition

Represents a dialog box that displays find dialog.

Header: #include <xtd/forms/replace_dialog>

Namespace: xtd::forms

Library: xtd.forms

Appearance

	Windows	macOS	Gnome
Light	html dialog_replace_dialog_m.png html dialog_replace_dialog_g.png
Dark	html dialog_replace_dialog_md.png html dialog_replace_dialog_gd.png

Examples: The following code example demonstrates the use of replace_dialog dialog.
#include <xtd/forms/application>
#include <xtd/forms/button>
#include <xtd/forms/debug_form>
#include <xtd/forms/form>
#include <xtd/forms/replace_dialog>
#include <xtd/diagnostics/debug>
using namespace xtd;
using namespace xtd::forms;
class form1 : public form {
public:
form1() {
text("Replace dialog example");

replace_button.parent(*this);
replace_button.text("replace...");
replace_button.location({10, 10});
replace_button.click += [&] {
replace_dialog.show(*this);
};

replace_dialog.title("Replace");
replace_dialog.find_string("Gammasoft");
replace_dialog.replace_string("xtd");
replace_dialog.find_next += [&](object& sender, const find_event_args& e) {
diagnostics::debug::write_line(ustring::format("Find next : find string [{}], match case [{}], search direction [{}], whole word [{}]", e.find_string(), e.match_case(), e.search_direction(), e.whole_word()));
};
replace_dialog.replace += [&](object& sender, const replace_event_args& e) {
diagnostics::debug::write_line(ustring::format("Replace : find string [{}], replace string [{}], match case [{}], whole word [{}]", e.find_string(), e.replace_string(), e.match_case(), e.whole_word()));
};
replace_dialog.replace_all += [&](object& sender, const replace_event_args& e) {
diagnostics::debug::write_line(ustring::format("Replace all : find string [{}], replace string [{}], match case [{}], whole word [{}]", e.find_string(), e.replace_string(), e.match_case(), e.whole_word()));
};
}

private:
debug_form df;
button replace_button;
xtd::forms::replace_dialog replace_dialog;
};
auto main()->int {
application::run(form1 {});
}

Examples:: replace_dialog.cpp.

Constructors
	replace_dialog ()
	Initializes a new instance of the replace_dialog class. More...

Properties
const xtd::ustring &	find_string () const noexcept
	Gets the string to find. More...

replace_dialog &	find_string (const xtd::ustring &value)
	Sets the string to find. More...

const xtd::ustring &	replace_string () const noexcept
	Gets the replaced string. More...

replace_dialog &	replace_string (const xtd::ustring &value)
	Sets the replaced string. More...

xtd::drawing::point	location () const noexcept
	Gets the coordinates of the upper-left corner of the dialog relative to the upper-left corner of the screen. More...

replace_dialog &	location (const xtd::drawing::point &value)
	Sets the coordinates of the upper-left corner of the dialog relative to the upper-left corner of the screen. More...

bool	match_case () const noexcept
	Gets the match case value. More...

replace_dialog &	match_case (bool value)
	Sets the match case value. More...

bool	show_match_case () const noexcept
	Gets a value that indicates whether match case option is shown. More...

replace_dialog &	show_match_case (bool value)
	Sets a value that indicates whether match case option is shown. More...

bool	show_whole_word () const noexcept
	Gets a value that indicates whether whole word option is shown. More...

replace_dialog &	show_whole_word (bool value)
	Sets a value that indicates whether whole word option is shown. More...

const xtd::ustring &	title () const noexcept
	Gets the find dialog title. More...

replace_dialog &	title (const xtd::ustring &value)
	Sets the find dialog title. More...

bool	whole_word () const noexcept
	Gets the whole word value. More...

replace_dialog &	whole_word (bool value)
	Sets the whole word value. More...

Events
xtd::event< replace_dialog, xtd::forms::find_event_handler >	find_next
	Occurs when the user click the find button. More...

xtd::event< replace_dialog, xtd::forms::replace_event_handler >	replace
	Occurs when the user click the replace button. More...

xtd::event< replace_dialog, xtd::forms::replace_event_handler >	replace_all
	Occurs when the user click the replace all button. More...

xtd::event< replace_dialog, xtd::forms::dialog_closed_event_handler >	dialog_closed
	Occurs when the user close the replace dialog box with dialog close button or cancel button. More...

Methods
void	close ()
	Closes the find dialog box. More...

void	reset () noexcept
	Resets all properties to default values. More...

void	show (const iwin32_window &owner)
	Runs find dialog box. More...

Additional Inherited Members
Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object. More...

bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object. More...

virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type. More...

virtual type_object	get_type () const noexcept
	Gets the type of the current instance. More...

template<typename object_t >
std::unique_ptr< object_t >	memberwise_clone () const noexcept
	Creates a shallow copy of the current object. More...

virtual xtd::ustring	to_string () const noexcept
	Returns a sxd::ustring that represents the current object. More...

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. More...

static bool	reference_equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are the same instance. More...

Protected Member Functions inherited from xtd::forms::component
	component ()
	Initialises a new instance of the component class. More...

virtual bool	can_raise_events () const noexcept
	Gets a value indicating whether the component can raise an event. More...

bool	design_mode () const noexcept
	Gets a value that indicates whether the component is currently in design mode. More...

Constructor & Destructor Documentation

◆ replace_dialog()

xtd::forms::replace_dialog::replace_dialog ( )

Initializes a new instance of the replace_dialog class.

Member Function Documentation

◆ close()

void xtd::forms::replace_dialog::close ( )

Closes the find dialog box.

Remarks: If the find dialog box is already closed, this method does nothing.

◆ find_string() [1/2]

const xtd::ustring& xtd::forms::replace_dialog::find_string ( ) const

noexcept

Gets the string to find.

Returns: The string to find.

Examples:: replace_dialog.cpp.

◆ find_string() [2/2]

replace_dialog& xtd::forms::replace_dialog::find_string ( const xtd::ustring & value )

Sets the string to find.

Parameters

value The string to find.

Returns: Current replace_dialog instance.

◆ location() [1/2]

xtd::drawing::point xtd::forms::replace_dialog::location ( ) const

noexcept

Gets the coordinates of the upper-left corner of the dialog relative to the upper-left corner of the screen.

Returns: The point that represents the upper-left corner of the dialog relative to the upper-left corner of its screen.

◆ location() [2/2]

replace_dialog& xtd::forms::replace_dialog::location ( const xtd::drawing::point & value )

Sets the coordinates of the upper-left corner of the dialog relative to the upper-left corner of the screen.

Parameters

value The point that represents the upper-left corner of the dialog relative to the upper-left corner of its screen.

Returns: Current replace_dialog instance.

◆ match_case() [1/2]

bool xtd::forms::replace_dialog::match_case ( ) const

noexcept

Gets the match case value.

Returns: true if match case option selected; otherwise false. The default is false.

◆ match_case() [2/2]

replace_dialog& xtd::forms::replace_dialog::match_case ( bool value )

Sets the match case value.

Parameters

value true if match case option selected; otherwise false. The default is false.

Returns: Current replace_dialog instance.

◆ replace_string() [1/2]

const xtd::ustring& xtd::forms::replace_dialog::replace_string ( ) const

noexcept

Gets the replaced string.

Returns: The replaced string.

Examples:: replace_dialog.cpp.

◆ replace_string() [2/2]

replace_dialog& xtd::forms::replace_dialog::replace_string ( const xtd::ustring & value )

Sets the replaced string.

Parameters

value The replaced string.

Returns: Current replace_dialog instance.

◆ reset()

void xtd::forms::replace_dialog::reset ( )

noexcept

Resets all properties to default values.

Remarks

When you reset the xtd::forms::replace::dialog, the following read/write properties are set to initial values.

Property	Value
title	""
find_string	""
replace_string	""
show_whole_word	true
show_match_case	true
whole_word	false
match_case	false

◆ show()

void xtd::forms::replace_dialog::show ( const iwin32_window & owner )

Runs find dialog box.

Remarks: If the find dialog box is already displayed, this method does nothing.

Examples:: replace_dialog.cpp.

◆ show_match_case() [1/2]

bool xtd::forms::replace_dialog::show_match_case ( ) const

noexcept

Gets a value that indicates whether match case option is shown.

Returns: true if match case option is shown; otherwise false. The default is true.

◆ show_match_case() [2/2]

replace_dialog& xtd::forms::replace_dialog::show_match_case ( bool value )

Sets a value that indicates whether match case option is shown.

Parameters

value true if match case option is shown; otherwise false. The default is true.

Returns: Current replace_dialog instance.

◆ show_whole_word() [1/2]

bool xtd::forms::replace_dialog::show_whole_word ( ) const

noexcept

Gets a value that indicates whether whole word option is shown.

Returns: true if whole word option is shown; otherwise false. The default is true.

◆ show_whole_word() [2/2]

replace_dialog& xtd::forms::replace_dialog::show_whole_word ( bool value )

Sets a value that indicates whether whole word option is shown.

Parameters

value true if whole word option is shown; otherwise false. The default is true.

Returns: Current replace_dialog instance.

◆ title() [1/2]

const xtd::ustring& xtd::forms::replace_dialog::title ( ) const

noexcept

Gets the find dialog title.

Returns: The find dialog title.

Examples:: replace_dialog.cpp.

◆ title() [2/2]

replace_dialog& xtd::forms::replace_dialog::title ( const xtd::ustring & value )

Sets the find dialog title.

Parameters

value The find dialog title.

Returns: Current replace_dialog instance.

◆ whole_word() [1/2]

bool xtd::forms::replace_dialog::whole_word ( ) const

noexcept

Gets the whole word value.

Returns: true if whole word option selected; otherwise false. The default is false.

◆ whole_word() [2/2]

replace_dialog& xtd::forms::replace_dialog::whole_word ( bool value )

Sets the whole word value.

Parameters

value true if whole word option selected; otherwise false. The default is false.

Returns: Current replace_dialog instance.

Member Data Documentation

◆ dialog_closed

xtd::event<replace_dialog, xtd::forms::dialog_closed_event_handler> xtd::forms::replace_dialog::dialog_closed

Occurs when the user close the replace dialog box with dialog close button or cancel button.

Remarks: The xtd::forms::dialog_closed_event_args::dialog_result is always set to xtd::forms::dialog_result::cancel; For more information about handling events, see Handling and Raising Events.

◆ find_next

xtd::event<replace_dialog, xtd::forms::find_event_handler> xtd::forms::replace_dialog::find_next

Occurs when the user click the find button.

Remarks: For more information about handling events, see Handling and Raising Events.

Examples:: replace_dialog.cpp.

◆ replace

xtd::event<replace_dialog, xtd::forms::replace_event_handler> xtd::forms::replace_dialog::replace

Occurs when the user click the replace button.

Remarks: For more information about handling events, see Handling and Raising Events.

Examples:: replace_dialog.cpp.

◆ replace_all

xtd::event<replace_dialog, xtd::forms::replace_event_handler> xtd::forms::replace_dialog::replace_all

Occurs when the user click the replace all button.

Remarks: For more information about handling events, see Handling and Raising Events.

Examples:: replace_dialog.cpp.

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

xtd.forms/include/xtd/forms/replace_dialog.h

Definition

Constructors

Properties

Events

Methods

Additional Inherited Members

Constructor & Destructor Documentation

◆ replace_dialog()

Member Function Documentation

◆ close()

◆ find_string() [1/2]

◆ find_string() [2/2]

◆ location() [1/2]

◆ location() [2/2]

◆ match_case() [1/2]

◆ match_case() [2/2]

◆ replace_string() [1/2]

◆ replace_string() [2/2]

◆ reset()

◆ show()

◆ show_match_case() [1/2]

◆ show_match_case() [2/2]

◆ show_whole_word() [1/2]

◆ show_whole_word() [2/2]

◆ title() [1/2]

◆ title() [2/2]

◆ whole_word() [1/2]

◆ whole_word() [2/2]

Member Data Documentation

◆ dialog_closed

◆ find_next

◆ replace

◆ replace_all