mirror of
https://github.com/JetBrains/intellij-sdk-code-samples.git
synced 2025-07-28 17:27:49 +08:00
d8e83b57ea
* Add UI Guidelines to SDK docs * Add UI Guidelines to SDK docs * Fixing build errors * optimize PNGs * add UI guidelines landing page placeholder * IJ SDK Docs <-> UI guidelines crosslinks updated * split_button.md: remove reference to removed setting * use <ui-path> * use MD instead of <note> * use %gh-ic% links * drop_down.md: fix <control> * code samples: fix most obvious issues * remove obsolete `_defaults.md` * ijs.tree: UI cleanup * Delete "under construction" pages * Fix headers * Add link-summary * Remove invalid links * Delete unused files * Remove ''@2x' from image file names * Use Markdown syntax for some images and tables * Rename non-unique files to unique * Remove alpha in images where content is unreadable * align quotation marks * Controls: cleanup/fixes, add code links, edit * tooltip.md: fix HTML * misc fixes * typography.md: fix table contents * typography.md: fix table header * UI guidelines landing page + TOC fixes * remove unused icons_list.md * Normalize image paths * validation_errors.md: Fix broken tab * "correct"/"incorrect" labels styling * Resize images to 50% * button.topic: fixes * grammar, spelling, minor edits * remove ' ' * fix 99px * cleanup * UI_kit.md: minor * Fix "MRK058: Large image in paragraph rendered as a block element by default." * button.topic: Add img[alt] * mnemonics.md: Update "Contact Us" link to the IJSDK YouTrack * split_button.md: Use ui-path * UI landing: add feedback snippet * Improve code snippets formatting and naming * Fix code samples * Fix code samples * Add Kotlin variants for code samples * Add icons_list.md * crosslinks * Change external link to https://intellij-icons.jetbrains.design/ * icons list -> https://intellij-icons.jetbrains.design * Hide info about reducing split button to simple action button (now it is available through the registry only) * reformat * icons_style.md: Images in new line --------- Co-authored-by: marianna.kononenko <marianna.kononenko@jetbrains.com> Co-authored-by: Yann Cébron <yann.cebron@jetbrains.com>
39 lines
2.3 KiB
Markdown
39 lines
2.3 KiB
Markdown
<!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
|
|
|
|
# Miscellaneous Swing Components
|
|
|
|
<link-summary>Overview of useful Swing components provided by IntelliJ Platform.</link-summary>
|
|
|
|
### `Messages`
|
|
|
|
The [`Messages`](%gh-ic%/platform/platform-api/src/com/intellij/openapi/ui/Messages.java) class provides a way to show simple message boxes, input dialogs (modal dialogs with a text field), and chooser dialogs (modal dialogs with a combo box).
|
|
The function of different methods of the class should be clear from their names.
|
|
When running on macOS, the message boxes shown by the `Messages` class use the native UI.
|
|
|
|
The `showCheckboxMessageDialog()` function provides an easy way to implement a _Do not show this again_ checkbox on messages.
|
|
|
|
Note that it is recommended to use non-modal notifications instead of modal message boxes whenever it's appropriate.
|
|
Please refer to the [Notifications](notifications.md) topic for more information.
|
|
|
|
### `JBSplitter`
|
|
|
|
The [`JBSplitter`](%gh-ic%/platform/platform-api/src/com/intellij/ui/JBSplitter.java) class is JetBrains' replacement for the standard [`JSplitPane`](https://docs.oracle.com/javase/8/docs/api/javax/swing/JSplitPane.html) class.
|
|
Unlike some other JetBrains-enhanced Swing components, it's not a drop-in replacement and has a different API.
|
|
However, to achieve a consistent user experience, it's recommended to use `JBSplitter` instead of the standard `JSplitPane`.
|
|
|
|
To add components to the splitter, call the `setFirstComponent()` and `setSecondComponent()` methods.
|
|
|
|
`JBSplitter` supports automatic remembering of the split proportion.
|
|
To enable it, call the `setSplitterProportionKey()` method and pass the ID under which the proportion will be stored.
|
|
|
|
### `JBTabs`
|
|
|
|
The [`JBTabs`](%gh-ic%/platform/platform-api/src/com/intellij/ui/tabs/JBTabs.java) class is JetBrains' implementation of the tab control, used for editor tabs and a few other components.
|
|
It has a significantly different look & feel compared to the standard Swing tabs, and looks less native on the macOS platform, so it's up to the developer to choose which tab control would be more appropriate.
|
|
|
|
### Toolbars
|
|
|
|
See [](toolbar.md) in the UI Guidelines for an overview.
|
|
|
|
[Building UI from Actions](basic_action_system.md#building-ui-from-actions) covers creating `AnAction`-based toolbars.
|