Ets_Dbox_Load_Blocking()

Note: Requires OPNET Development Kit

Abstract

Load and process a dialog box modally.

Syntax

Ets_Dbox_Load_Blocking (parent_dbox_ptr, resource_path, client_state_ptr)
Argument Type Description
parent_dbox_ptr EtsT_Dbox * a parent dialog reference which can be nil
resource_path const char * path to the dialog resource inside a resource file. For example, a dialog resource called my_dialog, located inside a dictionary my_dictionary will have the path my_dictionary/my_dialog
client_state_ptr void * arbitrary client state to be associated with a dialog

Return Type

EtsT_Compcode

EtsC_Compcode_Success if dialog was successfully loaded and processed and EtsC_Compcode_Failure otherwise.

ets_api_gui.h

Details

Similarly to Ets_Dbox_Load(), loads a dialog box from the resource file. After loading, the dialog box is opened in a blocking modal mode and fully processed in a nested event loop. Blocking the modal mode prevents the user from making changes to any other application windows present at a time. By the time this function returns a result code, the created blocking dialog box is already processed, closed and destroyed.

This function is convenient for implementing "screens," or wizard-like chained user interaction interfaces.

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com