/* ============================================================================== This file is part of the JUCE 6 technical preview. Copyright (c) 2017 - ROLI Ltd. You may use this code under the terms of the GPL v3 (see www.gnu.org/licenses). For this technical preview, this file is not subject to commercial licensing. 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::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; 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); } void ComboBox::enablementChanged() { repaint(); } void ComboBox::colourChanged() { lookAndFeelChanged(); } void ComboBox::parentHierarchyChanged() { lookAndFeelChanged(); } void ComboBox::lookAndFeelChanged() { repaint(); { std::unique_ptr