/* ============================================================================== This file is part of the JUCE library. Copyright (c) 2020 - Raw Material Software Limited JUCE is an open source library subject to commercial or open-source licensing. By using JUCE, you agree to the terms of both the JUCE 6 End-User License Agreement and JUCE Privacy Policy (both effective as of the 16th June 2020). End User License Agreement: www.juce.com/juce-6-licence Privacy Policy: www.juce.com/juce-privacy-policy Or: You may also use this code under the terms of the GPL v3 (see www.gnu.org/licenses). JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE DISCLAIMED. ============================================================================== */ namespace juce { ComboBox::ComboBox (const String& name) : Component (name), noChoicesMessage (TRANS("(no choices)")) { setRepaintsOnMouseActivity (true); lookAndFeelChanged(); currentId.addListener (this); } ComboBox::~ComboBox() { currentId.removeListener (this); hidePopup(); label.reset(); } //============================================================================== void ComboBox::setEditableText (const bool isEditable) { if (label->isEditableOnSingleClick() != isEditable || label->isEditableOnDoubleClick() != isEditable) { label->setEditable (isEditable, isEditable, false); labelEditableState = (isEditable ? labelIsEditable : labelIsNotEditable); setWantsKeyboardFocus (labelEditableState == labelIsNotEditable); resized(); } } bool ComboBox::isTextEditable() const noexcept { return label->isEditable(); } void ComboBox::setJustificationType (Justification justification) { label->setJustificationType (justification); } Justification ComboBox::getJustificationType() const noexcept { return label->getJustificationType(); } void ComboBox::setTooltip (const String& newTooltip) { SettableTooltipClient::setTooltip (newTooltip); label->setTooltip (newTooltip); } //============================================================================== void ComboBox::addItem (const String& newItemText, int newItemId) { // you can't add empty strings to the list.. jassert (newItemText.isNotEmpty()); // IDs must be non-zero, as zero is used to indicate a lack of selection. jassert (newItemId != 0); // you shouldn't use duplicate item IDs! jassert (getItemForId (newItemId) == nullptr); if (newItemText.isNotEmpty() && newItemId != 0) currentMenu.addItem (newItemId, newItemText, true, false); } void ComboBox::addItem (const String& newItemText, int newItemId, const Image & newItemImage) { // you can't add empty strings to the list.. //jassert (newItemText.isNotEmpty()); // IDs must be non-zero, as zero is used to indicate a lack of selecion. jassert (newItemId != 0); // you shouldn't use duplicate item IDs! jassert (getItemForId (newItemId) == nullptr); if (/*newItemText.isNotEmpty() &&*/ newItemId != 0) { currentMenu.addItem (newItemId, newItemText, true, false, newItemImage); } } void ComboBox::addItemList (const StringArray& itemsToAdd, int firstItemID) { for (auto& i : itemsToAdd) currentMenu.addItem (firstItemID++, i); } void ComboBox::addSeparator() { currentMenu.addSeparator(); } void ComboBox::addSectionHeading (const String& headingName) { // you can't add empty strings to the list.. jassert (headingName.isNotEmpty()); if (headingName.isNotEmpty()) currentMenu.addSectionHeader (headingName); } void ComboBox::setItemEnabled (int itemId, bool shouldBeEnabled) { if (auto* item = getItemForId (itemId)) item->isEnabled = shouldBeEnabled; } bool ComboBox::isItemEnabled (int itemId) const noexcept { if (auto* item = getItemForId (itemId)) return item->isEnabled; return false; } void ComboBox::changeItemText (int itemId, const String& newText) { if (auto* item = getItemForId (itemId)) item->text = newText; else jassertfalse; } void ComboBox::clear (const NotificationType notification) { currentMenu.clear(); if (! label->isEditable()) setSelectedItemIndex (-1, notification); } //============================================================================== PopupMenu::Item* ComboBox::getItemForId (int itemId) const noexcept { if (itemId != 0) { for (PopupMenu::MenuItemIterator iterator (currentMenu, true); iterator.next();) { auto& item = iterator.getItem(); if (item.itemID == itemId) return &item; } } return nullptr; } PopupMenu::Item* ComboBox::getItemForIndex (const int index) const noexcept { int n = 0; for (PopupMenu::MenuItemIterator iterator (currentMenu, true); iterator.next();) { auto& item = iterator.getItem(); if (item.itemID != 0) if (n++ == index) return &item; } return nullptr; } int ComboBox::getNumItems() const noexcept { int n = 0; for (PopupMenu::MenuItemIterator iterator (currentMenu, true); iterator.next();) { auto& item = iterator.getItem(); if (item.itemID != 0) n++; } return n; } String ComboBox::getItemText (const int index) const { if (auto* item = getItemForIndex (index)) return item->text; return {}; } int ComboBox::getItemId (const int index) const noexcept { if (auto* item = getItemForIndex (index)) return item->itemID; return 0; } int ComboBox::indexOfItemId (const int itemId) const noexcept { if (itemId != 0) { int n = 0; for (PopupMenu::MenuItemIterator iterator (currentMenu, true); iterator.next();) { auto& item = iterator.getItem(); if (item.itemID == itemId) return n; else if (item.itemID != 0) n++; } } return -1; } //============================================================================== int ComboBox::getSelectedItemIndex() const { auto index = indexOfItemId (currentId.getValue()); if (getText() != getItemText (index)) index = -1; return index; } void ComboBox::setSelectedItemIndex (const int index, const NotificationType notification) { setSelectedId (getItemId (index), notification); } int ComboBox::getSelectedId() const noexcept { if (auto* item = getItemForId (currentId.getValue())) if (getText() == item->text) return item->itemID; return 0; } void ComboBox::setSelectedId (const int newItemId, const NotificationType notification) { auto* item = getItemForId (newItemId); auto newItemText = item != nullptr ? item->text : String(); if (lastCurrentId != newItemId || label->getText() != newItemText) { label->setText (newItemText, dontSendNotification); lastCurrentId = newItemId; currentId = newItemId; if (image) { removeChildComponent(image.get()); image.reset(); } if (item != nullptr && item->image != nullptr) { image = item->image->createCopy(); addAndMakeVisible(image.get()); resized(); } repaint(); // for the benefit of the 'none selected' text sendChange (notification); } } bool ComboBox::selectIfEnabled (const int index) { if (auto* item = getItemForIndex (index)) { if (item->isEnabled) { setSelectedItemIndex (index); return true; } } return false; } bool ComboBox::nudgeSelectedItem (int delta) { for (int i = getSelectedItemIndex() + delta; isPositiveAndBelow (i, getNumItems()); i += delta) if (selectIfEnabled (i)) return true; return false; } void ComboBox::valueChanged (Value&) { if (lastCurrentId != (int) currentId.getValue()) setSelectedId (currentId.getValue()); } //============================================================================== String ComboBox::getText() const { return label->getText(); } void ComboBox::setText (const String& newText, const NotificationType notification) { for (PopupMenu::MenuItemIterator iterator (currentMenu, true); iterator.next();) { auto& item = iterator.getItem(); if (item.itemID != 0 && item.text == newText) { setSelectedId (item.itemID, notification); return; } } lastCurrentId = 0; currentId = 0; repaint(); if (label->getText() != newText) { label->setText (newText, dontSendNotification); sendChange (notification); } } void ComboBox::showEditor() { jassert (isTextEditable()); // you probably shouldn't do this to a non-editable combo box? label->showEditor(); } //============================================================================== void ComboBox::setTextWhenNothingSelected (const String& newMessage) { if (textWhenNothingSelected != newMessage) { textWhenNothingSelected = newMessage; repaint(); } } String ComboBox::getTextWhenNothingSelected() const { return textWhenNothingSelected; } void ComboBox::setTextWhenNoChoicesAvailable (const String& newMessage) { noChoicesMessage = newMessage; } String ComboBox::getTextWhenNoChoicesAvailable() const { return noChoicesMessage; } //============================================================================== void ComboBox::paint (Graphics& g) { getLookAndFeel().drawComboBox (g, getWidth(), getHeight(), isButtonDown, label->getRight(), 0, getWidth() - label->getRight(), getHeight(), *this); if (textWhenNothingSelected.isNotEmpty() && label->getText().isEmpty() && ! label->isBeingEdited()) getLookAndFeel().drawComboBoxTextWhenNothingSelected (g, *this, *label); } void ComboBox::resized() { if (getHeight() > 0 && getWidth() > 0) getLookAndFeel().positionComboBoxText (*this, *label, image.get()); } void ComboBox::enablementChanged() { repaint(); } void ComboBox::colourChanged() { lookAndFeelChanged(); } void ComboBox::parentHierarchyChanged() { lookAndFeelChanged(); } void ComboBox::lookAndFeelChanged() { repaint(); { std::unique_ptr