~~Title: Efl.Canvas.Layout_Part_External~~
====== Efl.Canvas.Layout_Part_External (class) ======

===== Description =====

%%Class representing an external part in Edje layouts.%%

%%An object of this type is an Efl.Part object, which means its lifecycle is limited to only one function call.%%

%%An external part contains one object, which can be retrieved with %%[[:develop:api:efl:content:property:content|Efl.Content.content.get]]%%(). Do not delete this object. Just like for other parts Edje is in charge of the visibility, geometry, clip, etc.%%

%%Common usage in pseudo-C would be as follows: Eo *widget = efl_content_get(efl_part(layout, "extpartname")); efl_text_set(widget, "hello");%%

%%Note that as a shortcut the widget's functions can be called directly on this part object. In C++: efl::eo::downcast<efl::Text>(layout.part("title")).text_set("hello"); Or in pseudo-C: efl_text_set(efl_part(layout, "title"), "hello"); Or in pseudo-script: layout["title"].text = "hello";%%

{{page>:develop:api-include:efl:canvas:layout_part_external:description&nouser&nolink&nodate}}

===== Inheritance =====

 => [[:develop:api:efl:canvas:layout_part|Efl.Canvas.Layout_Part]] //(class)// => [[:develop:api:efl:object|Efl.Object]] //(class)//
++++ Full hierarchy |

  * [[:develop:api:efl:canvas:layout_part|Efl.Canvas.Layout_Part]] //(class)//
    * [[:develop:api:efl:object|Efl.Object]] //(class)//
    * [[:develop:api:efl:gfx:entity|Efl.Gfx.Entity]] //(interface)//
    * [[:develop:api:efl:ui:drag|Efl.Ui.Drag]] //(interface)//
  * [[:develop:api:efl:content|Efl.Content]] //(interface)//


++++
===== Members =====

**[[:develop:api:efl:canvas:layout_part_external:property:content|content]]** //**(get, set)**//// [Overridden from [[:develop:api:efl:content|Efl.Content]]]//\\
> %%Sub-object currently set as this object's single content.%%
<code c>
Efl_Gfx_Entity *efl_content_get(const Eo *obj);
Eina_Bool efl_content_set(Eo *obj, Efl_Gfx_Entity *content);
</code>
\\
**[[:develop:api:efl:canvas:layout_part_external:method:content_unset|content_unset]]**// [Overridden from [[:develop:api:efl:content|Efl.Content]]]//\\
> %%Remove the sub-object currently set as content of this object and return it. This object becomes empty.%%
<code c>
Efl_Gfx_Entity *efl_content_unset(Eo *obj);
</code>
\\

==== Inherited ====

^ [[:develop:api:efl:canvas:layout_part|Efl.Canvas.Layout_Part]] ^^^
|  | **[[:develop:api:efl:canvas:layout_part:property:drag_dir|drag_dir]]** //**(get)**// |  |
|  | **[[:develop:api:efl:canvas:layout_part:property:drag_page|drag_page]]** //**(get, set)**// | %%The page step increments.%% |
|  | **[[:develop:api:efl:canvas:layout_part:method:drag_page_move|drag_page_move]]** | %%Moves the draggable by %%''dx''%%,%%''dy''%% pages.%% |
|  | **[[:develop:api:efl:canvas:layout_part:property:drag_size|drag_size]]** //**(get, set)**// | %%The draggable object relative size.%% |
|  | **[[:develop:api:efl:canvas:layout_part:property:drag_step|drag_step]]** //**(get, set)**// | %%The drag step increment.%% |
|  | **[[:develop:api:efl:canvas:layout_part:method:drag_step_move|drag_step_move]]** | %%Moves the draggable by %%''dx''%%,%%''dy''%% steps.%% |
|  | **[[:develop:api:efl:canvas:layout_part:property:drag_value|drag_value]]** //**(get, set)**// | %%The draggable object relative location.%% |
|  | **[[:develop:api:efl:canvas:layout_part:method:finalize|finalize]]** | %%Implement this method to finish the initialization of your object after all (if any) user-provided configuration methods have been executed.%% |
|  | **[[:develop:api:efl:canvas:layout_part:property:geometry|geometry]]** //**(get, set)**// | %%Rectangular geometry that combines both position and size.%% |
|  | **[[:develop:api:efl:canvas:layout_part:property:part_type|part_type]]** //**(get)**// |  |
|  | **[[:develop:api:efl:canvas:layout_part:property:state|state]]** //**(get)**// |  |
^ [[:develop:api:efl:gfx:entity|Efl.Gfx.Entity]] ^^^
|  | **[[:develop:api:efl:gfx:entity:property:position|position]]** //**(get, set)**// | %%The 2D position of a canvas object.%% |
|  | **[[:develop:api:efl:gfx:entity:property:scale|scale]]** //**(get, set)**// | %%The scaling factor of an object.%% |
|  | **[[:develop:api:efl:gfx:entity:property:size|size]]** //**(get, set)**// | %%The 2D size of a canvas object.%% |
|  | **[[:develop:api:efl:gfx:entity:property:visible|visible]]** //**(get, set)**// | %%The visibility of a canvas object.%% |
^ [[:develop:api:efl:object|Efl.Object]] ^^^
|  | **[[:develop:api:efl:object:property:allow_parent_unref|allow_parent_unref]]** //**(get, set)**// | %%Allow an object to be deleted by unref even if it has a parent.%% |
|  | **[[:develop:api:efl:object:method:children_iterator_new|children_iterator_new]]** | %%Get an iterator on all children.%% |
|  | **[[:develop:api:efl:object:property:comment|comment]]** //**(get, set)**// | %%A human readable comment for the object.%% |
|  | **[[:develop:api:efl:object:method:composite_attach|composite_attach]]** | %%Make an object a composite object of another.%% |
|  | **[[:develop:api:efl:object:method:composite_detach|composite_detach]]** | %%Detach a composite object from another object.%% |
|  | **[[:develop:api:efl:object:method:composite_part_is|composite_part_is]]** | %%Check if an object is part of a composite object.%% |
|  | **[[:develop:api:efl:object:method:constructor|constructor]]** | %%Implement this method to provide optional initialization code for your object.%% |
|  | **[[:develop:api:efl:object:method:debug_name_override|debug_name_override]]** | %%Build a read-only name for this object used for debugging.%% |
|  | **[[:develop:api:efl:object:method:destructor|destructor]]** | %%Implement this method to provide deinitialization code for your object if you need it.%% |
|  | **[[:develop:api:efl:object:method:event_callback_forwarder_del|event_callback_forwarder_del]]** | %%Remove an event callback forwarder for a specified event and object.%% |
|  | **[[:develop:api:efl:object:method:event_callback_forwarder_priority_add|event_callback_forwarder_priority_add]]** | %%Add an event callback forwarder that will make this object emit an event whenever another object (%%''source''%%) emits it. The event is said to be forwarded from %%''source''%% to this object.%% |
|  | **[[:develop:api:efl:object:method:event_callback_stop|event_callback_stop]]** | %%Stop the current callback call.%% |
|  | **[[:develop:api:efl:object:method:event_freeze|event_freeze]]** | %%Freeze events of this object.%% |
|  | **[[:develop:api:efl:object:property:event_freeze_count|event_freeze_count]]** //**(get)**// |  |
|  ''static'' | **[[:develop:api:efl:object:method:event_global_freeze|event_global_freeze]]** | %%Globally freeze events for ALL EFL OBJECTS.%% |
|  ''static'' | **[[:develop:api:efl:object:property:event_global_freeze_count|event_global_freeze_count]]** //**(get)**// |  |
|  ''static'' | **[[:develop:api:efl:object:method:event_global_thaw|event_global_thaw]]** | %%Globally thaw events for ALL EFL OBJECTS.%% |
|  | **[[:develop:api:efl:object:method:event_thaw|event_thaw]]** | %%Thaw events of object.%% |
|  | **[[:develop:api:efl:object:property:finalized|finalized]]** //**(get)**// |  |
|  | **[[:develop:api:efl:object:method:invalidate|invalidate]]** | %%Implement this method to perform special actions when your object loses its parent, if you need to.%% |
|  | **[[:develop:api:efl:object:property:invalidated|invalidated]]** //**(get)**// |  |
|  | **[[:develop:api:efl:object:property:invalidating|invalidating]]** //**(get)**// |  |
|  | **[[:develop:api:efl:object:property:name|name]]** //**(get, set)**// | %%The name of the object.%% |
|  | **[[:develop:api:efl:object:method:name_find|name_find]]** | %%Find a child object with the given name and return it.%% |
|  | **[[:develop:api:efl:object:property:parent|parent]]** //**(get, set)**// | %%The parent of an object.%% |
|  | **[[:develop:api:efl:object:method:provider_find|provider_find]]** | %%Searches upwards in the object tree for a provider which knows the given class/interface.%% |
|  | **[[:develop:api:efl:object:method:provider_register|provider_register]]** | %%Will register a manager of a specific class to be answered by %%[[:develop:api:efl:object:method:provider_find|Efl.Object.provider_find]]%%.%% |
|  | **[[:develop:api:efl:object:method:provider_unregister|provider_unregister]]** | %%Will unregister a manager of a specific class that was previously registered and answered by %%[[:develop:api:efl:object:method:provider_find|Efl.Object.provider_find]]%%.%% |

===== Events =====

==== Inherited ====

^ [[:develop:api:efl:content|Efl.Content]] ^^^
|  | **[[:develop:api:efl:content:event:content_changed|content,changed]]** | %%Sent after the content is set or unset using the current content object.%% |
^ [[:develop:api:efl:gfx:entity|Efl.Gfx.Entity]] ^^^
|  | **[[:develop:api:efl:gfx:entity:event:position_changed|position,changed]]** | %%Object was moved, its position during the event is the new one.%% |
|  | **[[:develop:api:efl:gfx:entity:event:size_changed|size,changed]]** | %%Object was resized, its size during the event is the new one.%% |
|  | **[[:develop:api:efl:gfx:entity:event:visibility_changed|visibility,changed]]** | %%Object's visibility state changed, the event value is the new state.%% |
^ [[:develop:api:efl:object|Efl.Object]] ^^^
|  | **[[:develop:api:efl:object:event:del|del]]** | %%Object is being deleted. See %%[[:develop:api:efl:object:method:destructor|Efl.Object.destructor]]%%.%% |
|  | **[[:develop:api:efl:object:event:destruct|destruct]]** | %%Object has been fully destroyed. It can not be used beyond this point. This event should only serve to clean up any reference you keep to the object.%% |
|  | **[[:develop:api:efl:object:event:invalidate|invalidate]]** | %%Object is being invalidated and losing its parent. See %%[[:develop:api:efl:object:method:invalidate|Efl.Object.invalidate]]%%.%% |
|  | **[[:develop:api:efl:object:event:noref|noref]]** | %%Object has lost its last reference, only parent relationship is keeping it alive. Advanced usage.%% |
|  | **[[:develop:api:efl:object:event:ownership_shared|ownership,shared]]** | %%Object has acquired a second reference. It has multiple owners now. Triggered whenever increasing the refcount from one to two, it will not trigger by further increasing the refcount beyond two.%% |
|  | **[[:develop:api:efl:object:event:ownership_unique|ownership,unique]]** | %%Object has lost a reference and only one is left. It has just one owner now. Triggered whenever the refcount goes from two to one.%% |