Implements the following functionality
select, copy/cut and paste
clipboard
drag and drop
in order to share data across application windows.
Contains functions to select text or a portion of data, send it to a buffer, and paste the data into a target.
elm_cnp provides a generic copy and paste facility based on its windowing system. It is not necessary to know the details of each windowing system, but some terms and behavior are common. Currently the X11 window system is widely used, and only X11 functionality is implemented.
In X11R6 window system, CopyPaste works like a peer-to-peer communication. Copying is an operation on an object in an X server. X11 calls those objects ‘selections’ which have names. Generally, two selection types are needed for copy and paste: The Primary selection and the Clipboard selection. Primary selection is for selecting text (that means highlighted text). Clipboard selection is for explicit copying behavior (such as ctrl+c, or ‘copy’ in a menu). Thus, in applications most cases only use the clipboard selection. As stated before, taking ownership of a selection doesn’t move any actual data. Copying and Pasting is described as follows:
Copy text in Program A : Program A takes ownership of the selection
Paste text in Program B : Program B notes that Program A owns the selection
Program B asks A for the text
Program A responds and sends the text to program B
Program B pastes the response
X11R6 Inter-Client Communication Conventions Manual, section 2
moved
- When the object change position. (since 1.17)
focus
- When the object has received focus. (since 1.8)
unfocus
- When the object has lost focus. (since 1.8)
language,changed
- Whenever system locale changes.
efl.elementary.
ELM_FOCUS_PREVIOUS
¶Focus previous
efl.elementary.
ELM_FOCUS_NEXT
¶Focus next
efl.elementary.
ELM_FOCUS_UP
¶Focus up
New in version 1.8.1.
efl.elementary.
ELM_FOCUS_DOWN
¶Focus down
New in version 1.8.1.
efl.elementary.
ELM_FOCUS_RIGHT
¶Focus right
New in version 1.8.1.
efl.elementary.
ELM_FOCUS_LEFT
¶Focus left
New in version 1.8.1.
efl.elementary.
ELM_FOCUS_MOVE_POLICY_CLICK
¶Give focus to object when they are clicked
New in version 1.10.
efl.elementary.
ELM_FOCUS_MOVE_POLICY_IN
¶Give focus to object on mouse-in
New in version 1.10.
efl.elementary.
ELM_FOCUS_MOVE_POLICY_KEY_ONLY
¶Focus is set on key input like Left, Right, Up, Down, Tab, or Shift+Tab
New in version 1.15.
efl.elementary.
ELM_FOCUS_AUTOSCROLL_MODE_SHOW
¶Directly show the focused region or item automatically.
New in version 1.10.
efl.elementary.
ELM_FOCUS_AUTOSCROLL_MODE_NONE
¶Do not show the focused region or item automatically.
New in version 1.10.
efl.elementary.
ELM_FOCUS_AUTOSCROLL_MODE_BRING_IN
¶Bring_in the focused region or item automatically which might invole the scrolling
New in version 1.10.
efl.elementary.
ELM_FOCUS_REGION_SHOW_WIDGET
¶as a widget
New in version 1.16.
efl.elementary.
ELM_FOCUS_REGION_SHOW_ITEM
¶as an item
New in version 1.16.
efl.elementary.
EVAS_CALLBACK_KEY_DOWN
¶efl.elementary.
EVAS_CALLBACK_KEY_UP
¶efl.elementary.
EVAS_CALLBACK_MOUSE_WHEEL
¶Defines the types of selection property names.
http://www.x.org/docs/X11/xlib.pdf for more details.
efl.elementary.
ELM_SEL_TYPE_PRIMARY
¶Primary text selection (highlighted or selected text)
efl.elementary.
ELM_SEL_TYPE_SECONDARY
¶Used when primary selection is in use
efl.elementary.
ELM_SEL_TYPE_XDND
¶Drag ‘n’ Drop
efl.elementary.
ELM_SEL_TYPE_CLIPBOARD
¶Clipboard selection (ctrl+C)
Defines the types of content.
efl.elementary.
ELM_SEL_FORMAT_TARGETS
¶For matching every possible atom
efl.elementary.
ELM_SEL_FORMAT_NONE
¶Content is from outside of Elementary
efl.elementary.
ELM_SEL_FORMAT_TEXT
¶Plain unformatted text: Used for things that don’t want rich markup
efl.elementary.
ELM_SEL_FORMAT_MARKUP
¶Edje textblock markup, including inline images
efl.elementary.
ELM_SEL_FORMAT_IMAGE
¶Images
efl.elementary.
ELM_SEL_FORMAT_VCARD
¶Vcards
efl.elementary.
ELM_SEL_FORMAT_HTML
¶Raw HTML-like data (eg. webkit)
Defines the kind of action associated with the drop data if for XDND
New in version 1.8.
efl.elementary.
ELM_XDND_ACTION_UNKNOWN
¶Action type is unknown
efl.elementary.
ELM_XDND_ACTION_COPY
¶Copy the data
efl.elementary.
ELM_XDND_ACTION_MOVE
¶Move the data
efl.elementary.
ELM_XDND_ACTION_PRIVATE
¶Private action type
efl.elementary.
ELM_XDND_ACTION_ASK
¶Ask the user what to do
efl.elementary.
ELM_XDND_ACTION_LIST
¶List the data
efl.elementary.
ELM_XDND_ACTION_LINK
¶Link the data
efl.elementary.
ELM_XDND_ACTION_DESCRIPTION
¶Describe the data
efl.elementary.
ELM_OBJECT_SELECT_MODE_DEFAULT
¶Items will only call their selection func and callback when first becoming selected. Any further clicks will do nothing, unless you set always select mode.
efl.elementary.
ELM_OBJECT_SELECT_MODE_ALWAYS
¶This means that, even if selected, every click will make the selected callbacks be called.
efl.elementary.
ELM_OBJECT_SELECT_MODE_NONE
¶This will turn off the ability to select items entirely and they will neither appear selected nor call selected callback functions.
efl.elementary.
ELM_OBJECT_SELECT_MODE_DISPLAY_ONLY
¶No select mode with no finger size rule
efl.elementary.
ELM_TOOLTIP_ORIENT_NONE
¶Default value, Tooltip moves with mouse pointer
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_TOP_LEFT
¶Tooltip should appear at the top left of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_TOP
¶Tooltip should appear at the top of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_TOP_RIGHT
¶Tooltip should appear at the top right of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_LEFT
¶Tooltip should appear at the left of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_CENTER
¶Tooltip should appear at the center of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_RIGHT
¶Tooltip should appear at the right of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_BOTTOM_LEFT
¶Tooltip should appear at the bottom left of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_BOTTOM
¶Tooltip should appear at the bottom of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_BOTTOM_RIGHT
¶Tooltip should appear at the bottom right of parent
New in version 1.16.
efl.elementary.
ELM_TOOLTIP_ORIENT_LAST
¶Sentinel value, don’t use
New in version 1.16.