PA_IsWindowFocused

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_IsWindowFocused (windowRef) char

ParameterTypeDescription
windowRefPA_WindowRefReference to the window
Function resultchar1 = windowRef is focused

Description

The routine PA_IsWindowFocused returns 1 if the window referenced by windowRef has the focus at the time of the call. It windowRef does not have the focus, PA_IsWindowFocused returns 0.

Only focusable windows can get the keyboard focus. A focusable window is a window that can receive keyboard events ("get the focus"), even if it is a floating window. When a focusable window receives a keyboard event, it becomes focused. For example, the tool palette of the Form Editor is not focusable. When the user clicks on it, it does not get the focus, which remains in the Editor. On the other hand, the properties palette is focusable. When the user clicks in an editable field (to set a variable name, an object name) of this palette, it takes the focus and the keyboard events.

See Also

PA_GetWindowFocused, PA_IsWindowFocusable, PA_SetWindowFocusable, PA_SetWindowFocused.

Error Handling

Use PA_GetLastError to see if an error occurred


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next