Bug 150183 - DoEvents is undocumented
Summary: DoEvents is undocumented
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: Macro-Documentation
  Show dependency treegraph
 
Reported: 2022-07-28 09:52 UTC by Mike Kaganski
Modified: 2024-03-12 04:20 UTC (History)
2 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Mike Kaganski 2022-07-28 09:52:32 UTC
DoEvents is one of the built-in functions in Basic, and is implemented in [1]. However, it is missing in our help.

Despite the confused comment in the code, it actually does quite significant work - it processes existing event queue until its end. E.g., using it before executing '.uno:SaveAs' in bug 146109 would allow refreshing the display before the dialog is shown.

VBA also has such a function; its documentation is at [2] (but it's incorrect, since current OSes do not use cooperative multitasking, so the only effect of it is not on OS, but on the program's own event queue).

[1] https://opengrok.libreoffice.org/xref/core/basic/source/runtime/methods1.cxx?r=bc1ab88f&mo=14951&fi=594#594
[2] https://docs.microsoft.com/en-us/office/vba/language/reference/user-interface-help/doevents-function
Comment 1 Rafael Lima 2022-07-28 19:23:43 UTC
Interesting... I did not know DoEvents existed in LO Basic. There's no mention of it in Pitonyak's book, nor in Bernard Marcelly's and neither in OOo3.1 Developer's Guide.