Siticone Dropdown

// Adds an item index to the current selection (Multi-Select only)
dropdown.AddToSelection(2);

// Removes an item index from the current selection (Multi-Select only)
dropdown.RemoveFromSelection(2);

// Toggles the selection state of a specific index (Multi-Select only)
dropdown.ToggleSelection(3);

// Clears all selections (works for both Single and Multi-Select)
dropdown.ClearSelection();

// Sets multiple selected indices at once (Multi-Select only)
var indices = new List<int> { 0, 2, 4 };
dropdown.SetSelectedIndices(indices);

// Binds a data source programmatically
var data = new List<string> { "Red", "Green", "Blue" };
dropdown.BindData(data);

// 1. ItemSelected (Single Selection)
// Fires when a single item is selected. Provides rich data about the selection.
dropdown.ItemSelected += (s, e) => 
{
                Debug.WriteLine($"Selected: {e.SelectedText} (Value: {e.SelectedValue})");
                Debug.WriteLine($"Index changed from {e.PreviousIndex} to {e.SelectedIndex}");
};

// 2. ItemsSelected (Multi Selection)
// Fires when the selection changes in Multi-Select mode.
dropdown.ItemsSelected += (s, e) => 
{
                Debug.WriteLine($"Total Items Selected: {e.SelectedIndices.Count}");
    
                // Check if the last operation was an Add or Remove
                if (e.IsAddOperation) 
                Debug.WriteLine($"Item added at index: {e.ChangedIndex}");
                else
                Debug.WriteLine($"Item removed at index: {e.ChangedIndex}");
};

// 3. SelectionCleared
// Fires when the selection is completely reset.
dropdown.SelectionCleared += (s, e) => 
{
                ResetUI();
};

// 4. Dropdown State Events
// Useful for triggering animations or UI updates when the list opens/closes.
dropdown.BeforeDropdownOpen += (s, e) => Debug.WriteLine("Opening...");
dropdown.AfterDropdownOpen += (s, e) => Debug.WriteLine("Opened");
dropdown.BeforeDropdownClose += (s, e) => Debug.WriteLine("Closing...");
dropdown.AfterDropdownClose += (s, e) => Debug.WriteLine("Closed");

private void SetupEmployeeDropdown()
{
                // Enable the search feature
    empDropdown.EnableSearch = true;
    empDropdown.SearchPlaceholderText = "Find employee by name...";
    empDropdown.SearchTextBoxHeight = 35;
    empDropdown.ShowSearchIcon = true;

                // Populate data
                var employees = GetEmployees(); // Returns List<Employee>
    empDropdown.DataSource = employees;
    empDropdown.DisplayMember = "FullName";
    empDropdown.ValueMember = "EmployeeId";

                // Style the list for readability
    empDropdown.ItemHeight = 40;
    empDropdown.MaxDropDownItems = 6;
}

private void SetupCategoryDropdown()
{
                // Enable Multi-Select
    catDropdown.AllowMultipleSelection = true;
    catDropdown.PlaceholderText = "Select Categories";

                // Handle selection changes
    catDropdown.ItemsSelected += (s, e) =>
    {
                // Validate selection count
                if (e.SelectedIndices.Count > 3)
        {
                MessageBox.Show("You can only select up to 3 categories.");
            
                // Revert the last addition
                if (e.IsAddOperation)
            {
                catDropdown.RemoveFromSelection(e.ChangedIndex);
            }
                return;
        }

                // Update UI with selected tags
        lblTags.Text = string.Join(", ", e.SelectedTexts);
    };
}

private void ConfigurePermissions(bool canEdit)
{
                if (!canEdit)
    {
        roleDropdown.IsReadonly = true;
        
                // Visual feedback configuration
        roleDropdown.CanShake = true;  // Shake animation on click
        roleDropdown.CanBeep = true;   // System beep on click
        
                // Update visual style to indicate locked state
        roleDropdown.BorderColor = Color.LightGray;
        roleDropdown.PlaceholderColor = Color.DarkGray;
    }
                else
    {
        roleDropdown.IsReadonly = false;
        roleDropdown.CanShake = false;
        roleDropdown.BorderColor = Color.DodgerBlue;
    }
}