Declaration (see MWindow.h):
void cancelPropagation (MMessageCode mc, MPropagationSource ps);
Cancels the preceding requestPropagation with the same mc and ps.
Code of the message to unpropagate. Must to be less than mcCOUNT.
Source type of the message to unpropagate. Must to be less than psCOUNT.
After dest.cancelPropagation(mc,ps) is called, the messages from a suitable source to dest will no longer be propagated automatically (unless requestPropagation is called again, of course).
This function is useful for temporarily deactivating redundant propagations during some internal operation (e.g. window refreshing). The reactivation is done with requestPropagation once the said operation is complete.
All requested propagations for this window are cancelled automatically when the window is closed, so there is no need to call cancelPropagation when closing the window (in fact, that would be even less efficient).
- If the specified propagation (with the same destination, mc, and ps) does not exist, the function has no effect (but it is not an error)
Let us know
Please Contact us to report any errors on this page, or to suggest any improvements.