xtd::iclonable Class Reference

Inheritance diagram for xtd::iclonable:

Definition

Supports cloning, which creates a new instance of a class with the same value as an existing instance.

Namespace

xtd

Library

xtd.core

Remarks

The xtd::iclonable interface enables you to provide a customized implementation that creates a copy of an existing object. The xtd::iclonable interface contains one member, the xtd::iclonable::clone method, which is intended to provide cloning support beyond that supplied by xtd::object::memberwise_clone. For more information about cloning, deep versus shallow copies, and examples, see the xtd::object::memberwise_clone method.

Notes to Implementers

The xtd::iclonable interface simply requires that your implementation of the xtd::iclonable::clone() method return a copy of the current object instance. It does not specify whether the cloning operation performs a deep copy, a shallow copy, or something in between. Nor does it require all property values of the original instance to be copied to the new instance. For example, the xtd::iclonable::clone() method performs a shallow copy of all properties; it always sets this property value to false in the cloned object. Because callers of xtd::iclonable::clone() cannot depend on the method performing a predictable cloning operation, we recommend that xtd::iclonable not be implemented in public APIs.

Public Methods
virtual std::unique_ptr< xtd::object >	clone () const =0
	Creates a new object that is a copy of the current instance.

Member Function Documentation

clone()

virtual std::unique_ptr< xtd::object > xtd::iclonable::clone ( ) const

pure virtual

Creates a new object that is a copy of the current instance.

Returns

A new object that is a copy of this instance.

Remarks

The resulting clone must be of the same type as, or compatible with, the original instance.

An implementation of xtd::iclonable::clone can perform either a deep copy or a shallow copy. In a deep copy, all objects are duplicated; in a shallow copy, only the top-level objects are duplicated and the lower levels contain references. Because callers of xtd::iclonable::clone cannot depend on the method performing a predictable cloning operation, we recommend that xtd::iclonable not be implemented in public APIs.

See xtd::object::memberwise_clone for more information on cloning, deep versus shallow copies, and examples.

Implemented in xtd::forms::animation, xtd::forms::button, xtd::forms::check_box, xtd::forms::checked_list_box, xtd::forms::choice, xtd::forms::collapsible_panel, xtd::forms::color_picker, xtd::forms::combo_box, xtd::forms::command_link_button, xtd::forms::context_menu, xtd::forms::control, xtd::forms::date_time_picker, xtd::forms::debug_form, xtd::forms::domain_up_down, xtd::forms::dot_matrix_display, xtd::forms::fixed_layout_panel, xtd::forms::flow_layout_panel, xtd::forms::font_picker, xtd::forms::form, xtd::forms::fourteen_segment_display, xtd::forms::group_box, xtd::forms::h_scroll_bar, xtd::forms::horizontal_layout_panel, xtd::forms::label, xtd::forms::lcd_label, xtd::forms::light_button, xtd::forms::link_label, xtd::forms::list_box, xtd::forms::loading_indicator, xtd::forms::main_menu, xtd::forms::menu_item, xtd::forms::month_calendar, xtd::forms::nine_segment_display, xtd::forms::numeric_up_down, xtd::forms::panel, xtd::forms::picture_box, xtd::forms::popup_panel, xtd::forms::progress_bar, xtd::forms::radio_button, xtd::forms::seven_segment_display, xtd::forms::sixteen_segment_display, xtd::forms::split_container, xtd::forms::splitter, xtd::forms::splitter_panel, xtd::forms::status_bar, xtd::forms::status_bar_panel, xtd::forms::switch_button, xtd::forms::tab_control, xtd::forms::tab_page, xtd::forms::table_layout_panel, xtd::forms::text_box, xtd::forms::toggle_button, xtd::forms::tool_bar, xtd::forms::tool_bar_button, xtd::forms::trace_form, xtd::forms::track_bar, xtd::forms::up_down_button, xtd::forms::user_control, xtd::forms::v_scroll_bar, and xtd::forms::vertical_layout_panel.

---

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

• xtd.core/include/xtd/iclonable.h