mirror/JUCE
1
0
Fork 0
mirror of https://github.com/juce-framework/JUCE.git synced 2026-01-10 23:44:24 +00:00
Code Activity

Component: Add API for window-control hit-testing

Browse source
This commit is contained in:
reuk 2024-05-28 19:30:29 +01:00
parent 8a09ac37cb
commit 9a91ae2ab6
No known key found for this signature in database
GPG key ID: FCB43929F012EE5C
1 changed files with 29 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

31
modules/juce_gui_basics/components/juce_Component.h
View file

@ -876,8 +876,8 @@ public:
Components with custom shapes will probably want to override it to perform
some more complex hit-testing.
The default implementation of this method returns either true or false,
depending on the value that was set by calling setInterceptsMouseClicks() (true
The default implementation of this method returns either 'client' or 'none',
depending on the value that was set by calling setInterceptsMouseClicks() ('client'
is the default return value).
Note that the hit-test region is not related to the opacity with which
@ -901,6 +901,33 @@ public:
*/
virtual bool hitTest (int x, int y);
/** Types of control that are commonly found in windows, especially title-bars. */
enum class WindowControlKind
{
client, ///< Parts of the component that are not transparent and also don't have any of the following control functions
caption, ///< The part of a title bar that may be dragged by the mouse to move the window
minimise, ///< The minimise/iconify button
maximise, ///< The maximise/zoom button
close, ///< The button that dismisses the component
sizeTop, ///< The area that may be dragged to move the top edge of the window
sizeLeft, ///< The area that may be dragged to move the left edge of the window
sizeRight, ///< The area that may be dragged to move the right edge of the window
sizeBottom, ///< The area that may be dragged to move the bottom edge of the window
sizeTopLeft, ///< The area that may be dragged to move the top-left corner of the window
sizeTopRight, ///< The area that may be dragged to move the top-right corner of the window
sizeBottomLeft, ///< The area that may be dragged to move the bottom-left corner of the window
sizeBottomRight, ///< The area that may be dragged to move the bottom-right corner of the window
};
/** For components that are added to the desktop, this may be called to determine what kind of
control is at particular locations in the window. On Windows, this is used to provide
functionality like Aero Snap (snapping the window to half of the screen after dragging the
window's caption area to the edge of the screen), double-clicking a horizontal border to
stretch a window vertically, and the window tiling flyout that appears when hovering the
mouse over the maximise button.
*/
virtual WindowControlKind findControlAtPoint (Point<float>) const { return WindowControlKind::client; }
/** Changes the default return value for the hitTest() method.
Setting this to false is an easy way to make a component pass all its mouse events