Definition

Represents a dialog box that displays find dialog.

Header: #include <xtd/forms/find_dialog>

Namespace: xtd::forms

Library: xtd.forms

Appearance

	Windows	macOS	Gnome
Light	html dialog_find_dialog_m.png html dialog_find_dialog_g.png
Dark	html dialog_find_dialog_md.png html dialog_find_dialog_gd.png

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

find_button.parent(*this);
find_button.text("find...");
find_button.location({10, 10});
find_button.click += [&] {
find_dialog.show(*this);
};

find_dialog.title("Find");
find_dialog.find_string("Gammasoft");
find_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()));
};
}

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

Examples:: find_dialog.cpp.

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

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

find_dialog &	find_string (const xtd::ustring &value)
	Sets the string to find. 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...

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

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

xtd::forms::search_direction	search_direction () const noexcept
	Gets the search direction value. More...

find_dialog &	search_direction (xtd::forms::search_direction value)
	Gets the search direction value. More...

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

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

bool	show_up_down () const noexcept
	Gets a value that indicates whether up down option is shown. More...

find_dialog &	show_up_down (bool value)
	Sets a value that indicates whether up down option is shown. More...

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

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

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

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

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

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

xtd::event< find_dialog, xtd::forms::dialog_closed_event_handler >	dialog_closed
	Occurs when the user close the find 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

◆ find_dialog()

xtd::forms::find_dialog::find_dialog ( )

Initializes a new instance of the find_dialog class.

Member Function Documentation

◆ close()

void xtd::forms::find_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::find_dialog::find_string ( ) const

noexcept

Gets the string to find.

Returns: The string to find.

Examples:: find_dialog.cpp.

◆ find_string() [2/2]

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

Sets the string to find.

Parameters

value The string to find.

Returns: Current find_dialog instance.

◆ location() [1/2]

xtd::drawing::point xtd::forms::find_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]

find_dialog& xtd::forms::find_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 find_dialog instance.

◆ match_case() [1/2]

bool xtd::forms::find_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]

find_dialog& xtd::forms::find_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 find_dialog instance.

◆ reset()

void xtd::forms::find_dialog::reset ( )

noexcept

Resets all properties to default values.

Remarks

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

Property	Value
title	""
find_string	""
show_up_down	true
show_whole_word	true
show_match_case	true
search_direction	xtd::forms::search_direction::down
whole_word	false
match_case	false

◆ search_direction() [1/2]

xtd::forms::search_direction xtd::forms::find_dialog::search_direction ( ) const

noexcept

Gets the search direction value.

Returns: One of xtd::forms::search_direction values. The default is xtd::forms::search_direction::down.

◆ search_direction() [2/2]

find_dialog& xtd::forms::find_dialog::search_direction ( xtd::forms::search_direction value )

Gets the search direction value.

Parameters

value One of xtd::forms::search_direction values. The default is xtd::forms::search_direction::down.

Returns: Current find_dialog instance.

◆ show()

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

Runs find dialog box.

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

Examples:: find_dialog.cpp.

◆ show_match_case() [1/2]

bool xtd::forms::find_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]

find_dialog& xtd::forms::find_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 find_dialog instance.

◆ show_up_down() [1/2]

bool xtd::forms::find_dialog::show_up_down ( ) const

noexcept

Gets a value that indicates whether up down option is shown.

Returns: true if up down option is shown; otherwise false. The default is true.

◆ show_up_down() [2/2]

find_dialog& xtd::forms::find_dialog::show_up_down ( bool value )

Sets a value that indicates whether up down option is shown.

Parameters

value true if up down option is shown; otherwise false. The default is true.

Returns: Current find_dialog instance.

◆ show_whole_word() [1/2]

bool xtd::forms::find_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]

find_dialog& xtd::forms::find_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 find_dialog instance.

◆ title() [1/2]

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

noexcept

Gets the find dialog title.

Returns: The find dialog title.

Examples:: find_dialog.cpp.

◆ title() [2/2]

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

Sets the find dialog title.

Parameters

value The find dialog title.

Returns: Current find_dialog instance.

◆ whole_word() [1/2]

bool xtd::forms::find_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]

find_dialog& xtd::forms::find_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 find_dialog instance.

Member Data Documentation

◆ dialog_closed

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

Occurs when the user close the find 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<find_dialog, xtd::forms::find_event_handler> xtd::forms::find_dialog::find_next

Occurs when the user click the find button.

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

Examples:: find_dialog.cpp.

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

xtd.forms/include/xtd/forms/find_dialog.h

Definition

Constructors

Properties

Events

Methods

Additional Inherited Members

Constructor & Destructor Documentation

◆ find_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]

◆ reset()

◆ search_direction() [1/2]

◆ search_direction() [2/2]

◆ show()

◆ show_match_case() [1/2]

◆ show_match_case() [2/2]

◆ show_up_down() [1/2]

◆ show_up_down() [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