MaterialDesignInXamlToolkit icon indicating copy to clipboard operation
MaterialDesignInXamlToolkit copied to clipboard

Add documentation for combobox

Open Keboo opened this issue 6 years ago • 6 comments

There are several additional features provided by the combo box that are not that easy to discover and should be documented.

  • [x] Add a page to the Wiki for ComboBox
  • [x] Add a link to it in the sidebar under Controls
  • [x] Document the two possible styles for ComboBox (MaterialDesignComboBox - this is the default, and MaterialDesignFloatingHintComboBox)
  • [x] Document that in addition to the default brushes on ComboBox there are a couple attached properties for changing colors. These are TextFieldAssist.UnderlineBrush for changing the color of the underline when the ComboBox is editable and the user is editing. HintAssist.Foreground for changing the color of the hint (when it is used).
  • [x] Document the ComboBoxAssist.ClassicMode attached property. When this is set to true it will cause the popup with the items to display strictly outside of the ComboBox rather than around it. This is more closely aligned with the default WPF ComboBox.

Keboo avatar Jan 22 '19 17:01 Keboo

Related #1171

Keboo avatar Jan 22 '19 17:01 Keboo

I agree, making a PR soon.

kevinmbuthi avatar Feb 13 '19 15:02 kevinmbuthi

Let me begin by saying that I am really impressed with this library. Thank you to all of those who contributed to the project!


It would be helpful if the documentation provided some guidance on how to implement the WPF default behavior for an editable ComboBox:

  1. DO NOT display list of items when ComboBox is clicked.
    • The user can simply click the combo box and start typing without having the dropdown obstructing the UI.
  2. DO display list of items when ComboBox arrow is clicked.
    • When the user wants to see the list of options, they can explicitly request to see them by clicking the combo box arrow.

I am still relatively new to WPF, and the solution has escaped me.

Additional Context

It appears that the MaterialDesignInXaml default behavior for a IsEditable="True" ComboBox is to:

  • automatically display the list of dropdown items on PreviewMouseDown or MouseLeftButtonDown

Pressacco avatar Feb 23 '21 16:02 Pressacco

@Keboo I added a page for ComboBox Note that I did not have to create a pr (Is everyone supposed to be able to just add/edit pages without anyone actually approving the changes?)

Alex-451 avatar Oct 09 '22 20:10 Alex-451

@Alex-451 yes, the wiki is just a special git repo within GitHub. I do keep an eye on the changes that people make to it and undo changes when needed, but most of the time when people make changes it is making things better, so I have left it open to all edits. I have looked over your changes and they look great to me.

Keboo avatar Oct 09 '22 21:10 Keboo

If you are looking to get PR credit for hacktoberfest, feel free to submit a small PR to this file adding a wiki link to the new page. You can see an example of suck a link here

Keboo avatar Oct 09 '22 21:10 Keboo