GUIBuilder Glossary

Form ID

(Also: Form Number). A positive integer from 1 to 32767 assigned by the developer to a top-level window in ResBuilder or ResEdit. A form is equivalent to a Visual PRO/5 'WINDOW' (parent window), also called a "Primary Window" in Microsoft's documentation.

Window ID

For a top-level (Primary) window, this is equivalent to the Form ID. For a Secondary Window (Visual PRO/5 'CHILD'), the Window ID shows how the child window is related to its top-level form. A form with Form ID of "10" also has a Window ID of "10." A child window of "1001" within that form has a window ID of "10.1001." Because child windows can be nested to an arbitrary level, arbitrarily long Window IDs are possible.

Control ID

(Also: Control Number). A positive integer from 1 to 32767 assigned by the developer to a graphical control within a specific window. As with Form IDs and Window IDs, Control IDs are basically arbitrary, but some Control IDs have special meaning. Control ID 1 is assigned to the "OK" button, if any. This button will be activated by the RETURN key if no other control on the window has keyboard focus. Control ID 2 is assigned to the "Close" or "Cancel" button, if any. This button will be activated by the ESCAPE key. Also, Control IDs determine the tab order within the window. When the user presses the TAB key, keyboard focus moves to the next control, based on ascending Control ID sequence. Also, GUIBuilder will sometimes refer to Control ID 0, meaning the window itself.

Event Code

In Visual PRO/5, the event code is a single, case-sensitive letter or digit that identifies some event, like a button push or a close-box activation. In the case of several events, GUIBuilder appends an integer qualifier to the base event code. A base event code of "f" (focus gained or lost) maps to two distinct GUIBuilder events -- "f0" (focus lost) and "f1" (focus gained). Normally you do not need to be concerned with the specific event codes; GUIBuilder will always provide a list of available events for any given control or window.