def fl_insert_nmenu_items2(ptr_flobject, ptr_flpopupentry, ptr_flpopupitem):
"""fl_insert_nmenu_items2(ptr_flobject, ptr_flpopupentry, ptr_flpopupitem)
-> ptr_flpopupentry
Inserts items in a nmenu flobject (alternative).
Parameters
----------
ptr_flobject : pointer to xfdata.FL_OBJECT
nmenu flobject
ptr_flpopupentry : pointer to xfdata.FL_POPUP_ENTRY
existing popup entry, after which the new items are to be
inserted. If it is None, it inserts items at the real start.
ptr_flpopupitem : pointer to xfdata.FL_POPUP_ITEM
popup item to be set. It can be prepared passing a dict (whose
keys are corresponding to xfdata.FL_POPUP_ITEM's members) to
xfstruct.fls_make_ptr_flpopupitem function.
Returns
-------
ptr_flpopupentry : pointer to xfdata.FL_POPUP_ENTRY
first nmenu item, or None (on failure)
Examples
--------
>>> *todo*
Notes
-----
Status: NA-UTest + Doc + Demo = OK
"""
_fl_insert_nmenu_items2 = library.cfuncproto(
library.load_so_libforms(), "fl_insert_nmenu_items2",
cty.POINTER(xfdata.FL_POPUP_ENTRY), [cty.POINTER(xfdata.FL_OBJECT),
cty.c_void_p, cty.POINTER(xfdata.FL_POPUP_ITEM)],
"""FL_POPUP_ENTRY * fl_insert_nmenu_items2(FL_OBJECT * obj,
FL_POPUP_ITEM * p2, FL_POPUP_ITEM * p3)""")
library.check_if_flinitialized()
library.verify_flobjectptr_type(ptr_flobject)
if not ptr_flpopupentry: # it is None
ptr_flpopupentry_alt = cty.cast(ptr_flpopupentry, \
cty.POINTER(cty.c_void_p))
else: # real FL_POPUP_ENTRY pointer
ptr_flpopupentry_alt = ptr_flpopupentry
library.verify_flpopupentryptr_type(ptr_flpopupentry_alt)
library.verify_flpopupitemptr_type(ptr_flpopupitem)
library.keep_elem_refs(ptr_flobject, ptr_flpopupentry, \
ptr_flpopupentry_alt, ptr_flpopupitem)
retval = _fl_insert_nmenu_items2(ptr_flobject, ptr_flpopupentry_alt, \
ptr_flpopupitem)
return retval
def fl_replace_nmenu_items2(ptr_flobject, ptr_flpopupentry, ptr_flpopupitem):
"""fl_replace_nmenu_items2(ptr_flobject, ptr_flpopupentry, ptr_flpopupitem)
-> ptr_flpopupentry
Replaces an item of a nmenu flobject (alternative).
Parameters
----------
ptr_flobject : pointer to xfdata.FL_OBJECT
nmenu flobject
ptr_flpopupentry : pointer to xfdata.FL_POPUP_ENTRY
old popup entry to be replaced
ptr_flpopupitem : pointer to xfdata.FL_POPUP_ITEM
new popup item. It can be prepared passing a dict (whose keys
are corresponding to xfdata.FL_POPUP_ITEM's members) to
xfstruct.fls_make_ptr_flpopupitem function.
Returns
-------
ptr_flpopupentry : pointer to xfdata.FL_POPUP_ENTRY
first nmenu item, or None (on failure)
Examples
--------
>>> *todo*
Notes
-----
Status: NA-UTest + Doc + Demo = OK
"""
_fl_replace_nmenu_items2 = library.cfuncproto(
library.load_so_libforms(), "fl_replace_nmenu_items2",
cty.POINTER(xfdata.FL_POPUP_ENTRY), [cty.POINTER(xfdata.FL_OBJECT),
cty.POINTER(xfdata.FL_POPUP_ENTRY), cty.POINTER(xfdata.FL_POPUP_ITEM)],
"""FL_POPUP_ENTRY * fl_replace_nmenu_items2(FL_OBJECT * obj,
FL_POPUP_ENTRY * p2, FL_POPUP_ITEM * p3)""")
library.check_if_flinitialized()
library.verify_flobjectptr_type(ptr_flobject)
library.verify_flpopupentryptr_type(ptr_flpopupentry)
library.verify_flpopupitemptr_type(ptr_flpopupitem)
library.keep_elem_refs(ptr_flobject, ptr_flpopupentry, ptr_flpopupitem)
retval = _fl_replace_nmenu_items2(ptr_flobject, ptr_flpopupentry, \
ptr_flpopupitem)
return retval
def fl_set_nmenu_items(ptr_flobject, ptr_flpopupitem):
"""fl_set_nmenu_items(ptr_flobject, ptr_flpopupitem) -> ptr_flpopupentry
Defines a popup nmenu item.
Parameters
----------
ptr_flobject : pointer to xfdata.FL_OBJECT
nmenu flobject
ptr_flpopupitem : pointer to xfdata.FL_POPUP_ITEM
popup item to be set. It can be prepared passing a dict (whose
keys are corresponding to xfdata.FL_POPUP_ITEM's members) to
xfstruct.fls_make_ptr_flpopupitem function.
Returns
-------
ptr_flpopupentry : pointer to xfdata.FL_POPUP_ENTRY
first nmenu item, or None (on failure)
Examples
--------
>>> *todo*
Notes
-----
Status: NA-UTest + Doc + NoDemo = Maybe
"""
_fl_set_nmenu_items = library.cfuncproto(
library.load_so_libforms(), "fl_set_nmenu_items",
cty.POINTER(xfdata.FL_POPUP_ENTRY), [cty.POINTER(xfdata.FL_OBJECT),
cty.POINTER(xfdata.FL_POPUP_ITEM)],
"""FL_POPUP_ENTRY * fl_set_nmenu_items(FL_OBJECT * p1,
FL_POPUP_ITEM * p2)""")
library.check_if_flinitialized()
library.verify_flobjectptr_type(ptr_flobject)
library.verify_flpopupitemptr_type(ptr_flpopupitem)
library.keep_elem_refs(ptr_flobject, ptr_flpopupitem)
retval = _fl_set_nmenu_items(ptr_flobject, ptr_flpopupitem)
return retval
def fl_set_select_items(ptr_flobject, ptr_flpopupitem):
"""fl_set_select_items(ptr_flobject, ptr_flpopupitem) -> numitems
(Re)populates a select flobject.
Parameters
----------
ptr_flobject : pointer to xfdata.FL_OBJECT
select flobject
ptr_flpopupitem : pointer to xfdata.FL_POPUP_ITEM
popup item to be set. It can be prepared passing a dict (whose
keys are corresponding to xfdata.FL_POPUP_ITEM's members) to
xfstruct.fls_make_ptr_flpopupitem function.
Returns
-------
numitems : long
number of items, or -1 (on failure)
Examples
--------
>>> *todo*
Notes
-----
Status: NA-UTest + Doc + Demo = OK
"""
_fl_set_select_items = library.cfuncproto(
library.load_so_libforms(), "fl_set_select_items",
cty.c_long, [cty.POINTER(xfdata.FL_OBJECT),
cty.POINTER(xfdata.FL_POPUP_ITEM)],
"""long int fl_set_select_items(FL_OBJECT * p1,
FL_POPUP_ITEM * p2)""")
library.check_if_flinitialized()
library.verify_flobjectptr_type(ptr_flobject)
library.verify_flpopupitemptr_type(ptr_flpopupitem)
library.keep_elem_refs(ptr_flobject, ptr_flpopupitem)
retval = _fl_set_select_items(ptr_flobject, ptr_flpopupitem)
return retval
