• ui_dlg_background_refresh Function
• UI_DLG_BOX Function
• ui_dlg_card_embed Function
• ui_dlg_card_embed_can_close Function
• ui_dlg_card_embed_close Function
• ui_dlg_card_embed_object Function
• ui_dlg_card_embed_on_close Function
• ui_dlg_column_adjust Function
• UI_DLG_COMMIT Function
• UI_DLG_CONTROL_ANCHOR_FROM_POS Function
• ui_dlg_control_commit Function
• ui_dlg_control_embedded_get Function
• UI_DLG_CONTROL_FROM_POS Function
• ui_dlg_control_item_get Function
• ui_dlg_control_item_set Function
• UI_DLG_CREATE Function
• UI_DLG_CTL_COMMAND Function
• UI_DLG_CTL_CURRENT Function
• UI_DLG_CTL_GOTO Function
• ui_dlg_ctl_visible Function
• ui_dlg_dock Function
• ui_dlg_dock_topology Function
• ui_dlg_docked_panel_dock Function
• ui_dlg_docked_panel_undock Function
• ui_dlg_docked_state_end Function
• ui_dlg_docked_state_get Function
• ui_dlg_docked_state_group Function
• ui_dlg_docked_state_position Function
• ui_dlg_docked_state_set Function
• ui_dlg_docked_state_start Function
• ui_dlg_docking_listener_add Function
• ui_dlg_docking_listener_drop Function
• UI_DLG_DRAG_TEXT_GET Function
• UI_DLG_DRAG_TEXT_SET Function
• ui_dlg_editor_active Function
• ui_dlg_editor_get Function
• UI_DLG_EVAL Function
• UI_DLG_EVAL_VALID Function
• UI_DLG_EVENT Function
• ui_dlg_event_occurred Function
• ui_dlg_hdc_render Function
• UI_DLG_HIDE Function
• ui_dlg_hotspot_query Function
• ui_dlg_hotspot_refresh Function
• UI_DLG_IS_ACTIVE Function
• UI_DLG_IS_MAXIMIZED Function
• UI_DLG_IS_MINIMIZED Function
• UI_DLG_MAXIMIZE Function
• UI_DLG_MINIMIZE Function
• UI_DLG_MODAL Function
• UI_DLG_MOVE Function
• UI_DLG_NAVIGATE Function
• ui_dlg_navigation Function
• ui_dlg_object_get Function
• UI_DLG_OPTIONAL_EVENT Function
• UI_DLG_PANEL Function
• ui_dlg_panel_destroy Function
• ui_dlg_panel_name Function
• UI_DLG_PARENT_GET Function
• ui_dlg_query Function
• UI_DLG_REFRESH Function
• UI_DLG_REFRESH_TARGETED Function
• UI_DLG_REMEMBERED_CLEAR Function
• UI_DLG_REMEMBERED_GET Function
• UI_DLG_RESIZE Function
• ui_dlg_return Function
• ui_dlg_session_refresh_expr Function
• ui_dlg_session_refresh_result Function
• UI_DLG_SHOW Function
• ui_dlg_size_to_content Function
• ui_dlg_to_html Function
• ui_dlg_undock Function
• UI_INFO_DLG_DEF_CLIENT_HEIGHT Function
• UI_INFO_DLG_DEF_CLIENT_WIDTH Function
• ui_info_dlg_def_conditions Function
• ui_info_dlg_def_controls_get Function
• UI_INFO_DLG_DEF_EVENTS Function
• UI_INFO_DLG_DEF_HEIGHT Function
• UI_INFO_DLG_DEF_LISTS Function
• ui_info_dlg_def_tooltip_get Function
• UI_INFO_DLG_DEF_VARS Function
• UI_INFO_DLG_DEF_WIDTH Function
• UI_MODELESS_DLG_BOX Function
• UI_MODELESS_DLG_BUTTON Function
• UI_MODELESS_DLG_BUTTON_RESET Function
• UI_MODELESS_DLG_CLOSE Function
• UI_MODELESS_DLG_EXIST Function
• ui_modeless_dlg_hover Function
• UI_MODELESS_DLG_REFRESH Function
• UI_MODELESS_DLG_SETFOCUS Function
• UI_MODELESS_DLG_SIZING Function

UI_DLG_NAVIGATE Function

Syntax

Arguments

title

The title of the dialog box.

direction

The direction in which to move the cursor. "next" = the next control "prev" = the previous control

Description

Move to a different control - directions are 'next' and 'prev'.

Discussion

The UI_DLG_NAVIGATE() function moves the cursor and focus to the next or previous control on the Xdialog form.

Example

dim dlg_title as C
dim fn as C
dim ln as C
dim address1 as C
dim address2 as C
dim city as C
dim st as C
dim zip as C
dlg_title = "Advance on Enter"
ui_dlg_box(dlg_title,<<%dlg%
{on_key=enter}
Press Enter to advance to next field. When focus is on OK button, Enter
will close the dialog;
{lf};
{frame=1,1}
{region}
First name: | [.50fn];
Last name: | [.50ln];
Address 1: | [.50address1];
Address 2: | [.50address2];
City: | [.50city];
State: | [.5st];
Zip: | [.10zip];
{endregion};
{lf};
{justify=right}
<10&OK!ok> <10&Cancel!cancel>;
%dlg%,<<%code%
if (a_dlg_button = "enter") then
      if "!ok", ui_dlg_ctl_current(dlg_title? > 0) then
           'user is on the OK button, so close the dialog
      else
           'user is not on the OK button, so advance to next control
           ui_dlg_navigate(dlg_title,"Next")
           'set a_dlg_button to NULL to keep the dialog open
           a_dlg_button = ""
      end if
end if
%code%)

Limitations

Desktop applications only.

See Also

• Xdialog Function Reference