Go to the source code of this file.
typedef void(* YMessageBoxValueCallback) (YMessageBox *func, const string &functionValue) |
Retrieves a MessageBox interface for a given identifier. The identifier can be specified using several formats:
-
FunctionLogicalName
-
ModuleSerialNumber.FunctionIdentifier
-
ModuleSerialNumber.FunctionLogicalName
-
ModuleLogicalName.FunctionIdentifier
-
ModuleLogicalName.FunctionLogicalName
This function does not require that the MessageBox interface is online at the time it is invoked. The returned object is nevertheless valid. Use the method YMessageBox.isOnline() to test if the MessageBox interface is indeed online at a given time. In case of ambiguity when looking for a MessageBox interface by logical name, no error is notified: the first instance found is returned. The search is performed first by hardware name, then by logical name.
If a call to this object's is_online() method returns FALSE although you are certain that the matching device is plugged, make sure that you did call registerHub() at application initialization time.
- Parameters
-
func | : a string that uniquely characterizes the MessageBox interface |
- Returns
- a YMessageBox object allowing you to drive the MessageBox interface.
Definition at line 549 of file yocto_messagebox.h.
Starts the enumeration of MessageBox interfaces currently accessible. Use the method YMessageBox.nextMessageBox() to iterate on next MessageBox interfaces.
- Returns
- a pointer to a YMessageBox object, corresponding to the first MessageBox interface currently online, or a NULL pointer if there are none.
Definition at line 560 of file yocto_messagebox.h.