/* ============================================================================== This file is part of the JUCE library - "Jules' Utility Class Extensions" Copyright 2004-11 by Raw Material Software Ltd. ------------------------------------------------------------------------------ JUCE can be redistributed and/or modified under the terms of the GNU General Public License (Version 2), as published by the Free Software Foundation. A copy of the license is included in the JUCE distribution, or can be found online at www.gnu.org/licenses. JUCE is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. ------------------------------------------------------------------------------ To release a closed-source product which uses JUCE, commercial licenses are available: visit www.rawmaterialsoftware.com/juce for more information. ============================================================================== */ CallOutBox::CallOutBox (Component& contentComponent, Component& componentToPointTo, Component* const parent) : borderSpace (20), arrowSize (16.0f), content (contentComponent) { addAndMakeVisible (&content); if (parent != nullptr) { parent->addChildComponent (this); updatePosition (parent->getLocalArea (&componentToPointTo, componentToPointTo.getLocalBounds()), parent->getLocalBounds()); setVisible (true); } else { if (! JUCEApplication::isStandaloneApp()) setAlwaysOnTop (true); // for a plugin, make it always-on-top because the host windows are often top-level updatePosition (componentToPointTo.getScreenBounds(), componentToPointTo.getParentMonitorArea()); addToDesktop (ComponentPeer::windowIsTemporary); } } CallOutBox::~CallOutBox() { } //============================================================================== class CallOutBoxCallback : public ModalComponentManager::Callback { public: CallOutBoxCallback (Component& attachTo, Component* content_, Component* parentComponent) : content (content_), callout (*content_, attachTo, parentComponent) { callout.setVisible (true); callout.enterModalState (true, this); } void modalStateFinished (int) {} private: ScopedPointer content; CallOutBox callout; JUCE_DECLARE_NON_COPYABLE (CallOutBoxCallback); }; void CallOutBox::launchAsynchronously (Component& componentToPointTo, Component* contentComponent, Component* parentComponent) { jassert (contentComponent != nullptr); // must be a valid content component! new CallOutBoxCallback (componentToPointTo, contentComponent, parentComponent); } //============================================================================== void CallOutBox::setArrowSize (const float newSize) { arrowSize = newSize; borderSpace = jmax (20, (int) arrowSize); refreshPath(); } void CallOutBox::paint (Graphics& g) { getLookAndFeel().drawCallOutBoxBackground (*this, g, outline, background); } void CallOutBox::resized() { content.setTopLeftPosition (borderSpace, borderSpace); refreshPath(); } void CallOutBox::moved() { refreshPath(); } void CallOutBox::childBoundsChanged (Component*) { updatePosition (targetArea, availableArea); } bool CallOutBox::hitTest (int x, int y) { return outline.contains ((float) x, (float) y); } enum { callOutBoxDismissCommandId = 0x4f83a04b }; void CallOutBox::inputAttemptWhenModal() { const Point mousePos (getMouseXYRelative() + getBounds().getPosition()); if (targetArea.contains (mousePos)) { // if you click on the area that originally popped-up the callout, you expect it // to get rid of the box, but deleting the box here allows the click to pass through and // probably re-trigger it, so we need to dismiss the box asynchronously to consume the click.. postCommandMessage (callOutBoxDismissCommandId); } else { exitModalState (0); setVisible (false); } } void CallOutBox::handleCommandMessage (int commandId) { Component::handleCommandMessage (commandId); if (commandId == callOutBoxDismissCommandId) { exitModalState (0); setVisible (false); } } bool CallOutBox::keyPressed (const KeyPress& key) { if (key.isKeyCode (KeyPress::escapeKey)) { inputAttemptWhenModal(); return true; } return false; } void CallOutBox::updatePosition (const Rectangle& newAreaToPointTo, const Rectangle& newAreaToFitIn) { targetArea = newAreaToPointTo; availableArea = newAreaToFitIn; Rectangle newBounds (content.getWidth() + borderSpace * 2, content.getHeight() + borderSpace * 2); const int hw = newBounds.getWidth() / 2; const int hh = newBounds.getHeight() / 2; const float hwReduced = (float) (hw - borderSpace * 3); const float hhReduced = (float) (hh - borderSpace * 3); const float arrowIndent = borderSpace - arrowSize; Point targets[4] = { Point ((float) targetArea.getCentreX(), (float) targetArea.getBottom()), Point ((float) targetArea.getRight(), (float) targetArea.getCentreY()), Point ((float) targetArea.getX(), (float) targetArea.getCentreY()), Point ((float) targetArea.getCentreX(), (float) targetArea.getY()) }; Line lines[4] = { Line (targets[0].translated (-hwReduced, hh - arrowIndent), targets[0].translated (hwReduced, hh - arrowIndent)), Line (targets[1].translated (hw - arrowIndent, -hhReduced), targets[1].translated (hw - arrowIndent, hhReduced)), Line (targets[2].translated (-(hw - arrowIndent), -hhReduced), targets[2].translated (-(hw - arrowIndent), hhReduced)), Line (targets[3].translated (-hwReduced, -(hh - arrowIndent)), targets[3].translated (hwReduced, -(hh - arrowIndent))) }; const Rectangle centrePointArea (newAreaToFitIn.reduced (hw, hh).toFloat()); float nearest = 1.0e9f; for (int i = 0; i < 4; ++i) { Line constrainedLine (centrePointArea.getConstrainedPoint (lines[i].getStart()), centrePointArea.getConstrainedPoint (lines[i].getEnd())); const Point centre (constrainedLine.findNearestPointTo (centrePointArea.getCentre())); float distanceFromCentre = centre.getDistanceFrom (centrePointArea.getCentre()); if (! (centrePointArea.contains (lines[i].getStart()) || centrePointArea.contains (lines[i].getEnd()))) distanceFromCentre *= 2.0f; if (distanceFromCentre < nearest) { nearest = distanceFromCentre; targetPoint = targets[i]; newBounds.setPosition ((int) (centre.getX() - hw), (int) (centre.getY() - hh)); } } setBounds (newBounds); } void CallOutBox::refreshPath() { repaint(); background = Image::null; outline.clear(); const float gap = 4.5f; outline.addBubble (content.getBounds().toFloat().expanded (gap, gap), getLocalBounds().toFloat(), targetPoint - getPosition().toFloat(), 9.0f, arrowSize * 0.7f); }