javax.swing

Class JToolBar

Inhoudsopgave
  • All Implemented Interfaces:
    ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

    public class JToolBar
extends JComponent
implements SwingConstants, Accessible
    JToolBar provides a component that is useful for displaying commonly used Actions or controls. For examples and information on using tool bars see How to Use Tool Bars, a section in The Java Tutorial.

    With most look and feels, the user can drag out a tool bar into a separate window (unless the floatable property is set to false). For drag-out to work correctly, it is recommended that you add JToolBar instances to one of the four "sides" of a container whose layout manager is a BorderLayout, and do not add children to any of the other four "sides".

    Warning: Swing is not thread safe. For more information see Swing's Threading Policy.

    Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see XMLEncoder.

    See Also:
    Action

    • Constructor Detail

      • JToolBar

        public JToolBar()
        Creates a new tool bar; orientation defaults to HORIZONTAL.

      • JToolBar

        public JToolBar(int orientation)
        Creates a new tool bar with the specified orientation. The orientation must be either HORIZONTAL or VERTICAL.
        Parameters:
        orientation - the orientation desired

      • JToolBar

        public JToolBar(String name)
        Creates a new tool bar with the specified name. The name is used as the title of the undocked tool bar. The default orientation is HORIZONTAL.
        Parameters:
        name - the name of the tool bar
        Since:
        1.3

      • JToolBar

        public JToolBar(String name,
        int orientation)
        Creates a new tool bar with a specified name and orientation. All other constructors call this constructor. If orientation is an invalid value, an exception will be thrown.
        Parameters:
        name - the name of the tool bar
        orientation - the initial orientation -- it must be either HORIZONTAL or VERTICAL
        Throws:
        IllegalArgumentException - if orientation is neither HORIZONTAL nor VERTICAL
        Since:
        1.3

    • Method Detail

      • updateUI

        public void updateUI()
        Notification from the UIFactory that the L&F has changed. Called to replace the UI with the latest version from the UIFactory.
        Overrides:
        updateUI in class JComponent
        See Also:
        JComponent.updateUI()

      • getComponentIndex

        public int getComponentIndex(Component c)
        Returns the index of the specified component. (Note: Separators occupy index positions.)
        Parameters:
        c - the Component to find
        Returns:
        an integer indicating the component's position, where 0 is first

      • getComponentAtIndex

        public Component getComponentAtIndex(int i)
        Returns the component at the specified index.
        Parameters:
        i - the component's position, where 0 is first
        Returns:
        the Component at that position, or null for an invalid index

      • setMargin

        public void setMargin(Insets m)
        Sets the margin between the tool bar's border and its buttons. Setting to null causes the tool bar to use the default margins. The tool bar's default Border object uses this value to create the proper margin. However, if a non-default border is set on the tool bar, it is that Border object's responsibility to create the appropriate margin space (otherwise this property will effectively be ignored).
        Parameters:
        m - an Insets object that defines the space between the border and the buttons
        See Also:
        Insets

      • getMargin

        public Insets getMargin()
        Returns the margin between the tool bar's border and its buttons.
        Returns:
        an Insets object containing the margin values
        See Also:
        Insets

      • isBorderPainted

        public boolean isBorderPainted()
        Gets the borderPainted property.
        Returns:
        the value of the borderPainted property
        See Also:
        setBorderPainted(boolean)

      • setBorderPainted

        public void setBorderPainted(boolean b)
        Sets the borderPainted property, which is true if the border should be painted. The default value for this property is true. Some look and feels might not implement painted borders; they will ignore this property.
        Parameters:
        b - if true, the border is painted
        See Also:
        isBorderPainted()

      • isFloatable

        public boolean isFloatable()
        Gets the floatable property.
        Returns:
        the value of the floatable property
        See Also:
        setFloatable(boolean)

      • setFloatable

        public void setFloatable(boolean b)
        Sets the floatable property, which must be true for the user to move the tool bar. Typically, a floatable tool bar can be dragged into a different position within the same container or out into its own window. The default value of this property is true. Some look and feels might not implement floatable tool bars; they will ignore this property.
        Parameters:
        b - if true, the tool bar can be moved; false otherwise
        See Also:
        isFloatable()

      • getOrientation

        public int getOrientation()
        Returns the current orientation of the tool bar. The value is either HORIZONTAL or VERTICAL.
        Returns:
        an integer representing the current orientation -- either HORIZONTAL or VERTICAL
        See Also:
        setOrientation(int)

      • setOrientation

        public void setOrientation(int o)
        Sets the orientation of the tool bar. The orientation must have either the value HORIZONTAL or VERTICAL. If orientation is an invalid value, an exception will be thrown.
        Parameters:
        o - the new orientation -- either HORIZONTAL or VERTICAL
        Throws:
        IllegalArgumentException - if orientation is neither HORIZONTAL nor VERTICAL
        See Also:
        getOrientation()

      • setRollover

        public void setRollover(boolean rollover)
        Sets the rollover state of this toolbar. If the rollover state is true then the border of the toolbar buttons will be drawn only when the mouse pointer hovers over them. The default value of this property is false.

        The implementation of a look and feel may choose to ignore this property.

        Parameters:
        rollover - true for rollover toolbar buttons; otherwise false
        Since:
        1.4

      • isRollover

        public boolean isRollover()
        Returns the rollover state.
        Returns:
        true if rollover toolbar buttons are to be drawn; otherwise false
        Since:
        1.4
        See Also:
        setRollover(boolean)

      • addSeparator

        public void addSeparator()
        Appends a separator of default size to the end of the tool bar. The default size is determined by the current look and feel.

      • addSeparator

        public void addSeparator(Dimension size)
        Appends a separator of a specified size to the end of the tool bar.
        Parameters:
        size - the Dimension of the separator

      • add

        public JButton add(Action a)
        Adds a new JButton which dispatches the action.
        Parameters:
        a - the Action object to add as a new menu item
        Returns:
        the new button which dispatches the action

      • createActionComponent

        protected JButton createActionComponent(Action a)
        Factory method which creates the JButton for Actions added to the JToolBar. The default name is empty if a null action is passed.
        Parameters:
        a - the Action for the button to be added
        Returns:
        the newly created button
        Since:
        1.3
        See Also:
        Action

      • createActionChangeListener

        protected PropertyChangeListener createActionChangeListener(JButton b)
        Returns a properly configured PropertyChangeListener which updates the control as changes to the Action occur, or null if the default property change listener for the control is desired.
        Returns:
        null

      • paramString

        protected String paramString()
        Returns a string representation of this JToolBar. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.
        Overrides:
        paramString in class JComponent
        Returns:
        a string representation of this JToolBar.

      • getAccessibleContext

        public AccessibleContext getAccessibleContext()
        Gets the AccessibleContext associated with this JToolBar. For tool bars, the AccessibleContext takes the form of an AccessibleJToolBar. A new AccessibleJToolBar instance is created if necessary.
        Specified by:
        getAccessibleContext in interface Accessible
        Overrides:
        getAccessibleContext in class JComponent
        Returns:
        an AccessibleJToolBar that serves as the AccessibleContext of this JToolBar

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/swing/JToolBar.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Inhoudsopgave Haut