Selection
Overview
Most of the following functions require a selection pointer (UF_UI_selection_p_t)
as the first input argument. This selection pointer is a unique identifier
for the selection associated with a particular dialog. NX assigns this
selection pointer and provides it to the Open C API programmer when needed.
The API programmer should only use the the selection pointer as an input
argument where required.
Generally, selectable objects types and subtypes are those that appear
in the object list of the NX Class Selection Menu and are also
defined in the uf_object_types.h header file. Note that the uf_object_types.h
header file also contains objects types and subtypes that are not selectable.
The selection pointer is provided to the API programmer in the following
ways:
- For UI Styler dialogs, the API programmer can call UF_STYLER_ask_value
from their callback.
- For single and class selection dialogs, NX passes the selection pointer
to the API programmer's initialization procedure . See UF_UI_select_with_single_dialog
for details.
- NX passes the selection pointer to the API programmer's filter procedure
and selection callback.
The selection pointer should not be saved outside the scope of the initialization
procedure or callback function.