Documentation: Fix a few niggles in Elm docs.

This commit is contained in:
Kai Huuhko 2013-10-25 21:39:48 +03:00
parent 20973afe6f
commit 47be89c8ea
2 changed files with 35 additions and 53 deletions

View File

@ -242,9 +242,9 @@ cdef void py_elm_drag_state_cb(void *data, Evas_Object *obj) with gil:
cdef void py_elm_drag_done_cb(void *data, Evas_Object *obj, Eina_Bool accepted) with gil:
"""Callback called when a drag is finished.
@param data Application specific data
@param obj The object where the drag started
@param accepted TRUE if the droppped-data is accepted on drop
:param data: Application specific data
:param obj: The object where the drag started
:param accepted: TRUE if the droppped-data is accepted on drop
:since: 1.8
"""
@ -305,14 +305,14 @@ cdef void py_elm_drag_item_container_pos(
Callback called when a drag is over an object
:param data: Application specific data
@param cont The container object where the drag started
@param it The object item in container where mouse-over
@param x The X coordinate relative to the top-left of the object
@param y The Y coordinate relative to the top-left of the object
@param xposret Position relative to item (left (-1), middle (0), right (1)
@param yposret Position relative to item (upper (-1), middle (0), bottom (1)
@param action The drag action to be done
@since 1.8
:param cont: The container object where the drag started
:param it: The object item in container where mouse-over
:param x: The X coordinate relative to the top-left of the object
:param y: The Y coordinate relative to the top-left of the object
:param xposret: Position relative to item (left (-1), middle (0), right (1)
:param yposret: Position relative to item (upper (-1), middle (0), bottom (1)
:param action: The drag action to be done
:since: 1.8
"""
print("in drag_item_container_pos")
@ -324,12 +324,12 @@ cdef Eina_Bool py_elm_drop_item_container_cb(
Callback invoked in when the selected data is 'dropped' on container.
@param data Application specific data
@param obj The evas object where selected data is 'dropped'.
@param it The item in container where drop-cords
@param ev struct holding information about selected data
@param xposret Position relative to item (left (-1), middle (0), right (1)
@param yposret Position relative to item (upper (-1), middle (0), bottom (1)
:param data: Application specific data
:param obj: The evas object where selected data is 'dropped'.
:param it: The item in container where drop-cords
:param ev: struct holding information about selected data
:param xposret: Position relative to item (left (-1), middle (0), right (1)
:param yposret: Position relative to item (upper (-1), middle (0), bottom (1)
"""
print("in drop_item_container_cb")
@ -359,20 +359,20 @@ cdef class DragUserInfo(object):
Structure describing user information for the drag process.
@param format The drag formats supported by the data (output)
@param data The drag data itself (a string) (output)
@param icons if value not NULL, play default anim (output)
@param action The drag action to be done (output)
@param createicon Function to call to create a drag object, or NULL if not wanted (output)
@param createdata Application data passed to @p createicon (output)
@param dragpos Function called with each position of the drag,
:param format: The drag formats supported by the data (output)
:param data: The drag data itself (a string) (output)
:param icons: if value not NULL, play default anim (output)
:param action: The drag action to be done (output)
:param createicon: Function to call to create a drag object, or NULL if not wanted (output)
:param createdata: Application data passed to @p createicon (output)
:param dragpos: Function called with each position of the drag,
x, y being screen coordinates if possible, and action being the current action. (output)
@param dragdata Application data passed to @p dragpos (output)
@param acceptcb Function called indicating if drop target accepts
:param dragdata: Application data passed to @p dragpos (output)
:param acceptcb: Function called indicating if drop target accepts
(or does not) the drop data while dragging (output)
@param acceptdata Application data passed to @p acceptcb (output)
@param dragdone Function to call when drag is done (output)
@param donecbdata Application data to pass to @p dragdone (output)
:param acceptdata: Application data passed to @p acceptcb (output)
:param dragdone: Function to call when drag is done (output)
:param donecbdata: Application data to pass to @p dragdone (output)
"""
cdef:
@ -411,9 +411,9 @@ cdef Eina_Bool py_elm_item_container_data_get_cb(
Callback invoked when starting to drag for a container.
@param obj The container object
@param it The Elm_Object_Item pointer where drag-start
@return Returns EINA_TRUE, if successful, or EINA_FALSE if not.
:param obj: The container object
:param it: The Elm_Object_Item pointer where drag-start
:return: Returns EINA_TRUE, if successful, or EINA_FALSE if not.
"""
print("in item_container_data_get_cb")

View File

@ -120,14 +120,14 @@ spaces in the data fields. For the default genlist item theme, we have
A genlist item may be at one of several styles. Elementary provides one
by default - "default", but this can be extended by system or application
custom themes/overlays/extensions (see :ref:`Theme` "themes" for more
details).
custom themes/overlays/extensions (see :py:mod:`themes<efl.elementary.theme>`)
for more details).
Editing and Navigating
======================
Items can be added by several calls. All of them return a
:ref:`Elm_Object_Item` handle that is an internal member inside the genlist.
:py:class:`GenlistItem` handle that is an internal member inside the genlist.
They all take a data parameter that is meant to be used for a handle to
the applications internal data (eg. the struct with the original item
data). The parent parameter is the parent genlist item this belongs to if
@ -502,24 +502,6 @@ Selection modes
No select mode with no finger size rule
.. _Elm_Scroller_Policy:
Scrollbar visibility
====================
.. data:: ELM_SCROLLER_POLICY_AUTO
Show scrollbars as needed
.. data:: ELM_SCROLLER_POLICY_ON
Always show scrollbars
.. data:: ELM_SCROLLER_POLICY_OFF
Never show scrollbars
"""