Класс JTabbedPane

public static final int WRAP_TAB_LAYOUT

См. также:

• Значения константных полей

public static final int SCROLL_TAB_LAYOUT

См. также:

• Значения константных полей

protected int tabPlacement

См. также:

• setTabPlacement(int)

protected SingleSelectionModel model

protected ChangeListener changeListener

protected transient ChangeEvent changeEvent

public JTabbedPane()

См. также:

• addTab(String, Icon, Component, String)

public JTabbedPane(int tabPlacement)

Параметры:

tabPlacement - расположение вкладок относительно содержимого

См. также:

• addTab(String, Icon, Component, String)

public JTabbedPane(int tabPlacement, int tabLayoutPolicy)

Параметры:

tabPlacement - расположение вкладок относительно содержимого

tabLayoutPolicy - политика компоновки вкладок, когда все вкладки не помещаются в один ряд

Исключения:

IllegalArgumentException - если расположение вкладок или политика компоновки вкладок не являются одним из указанных выше поддерживаемых значений

Начиная с версии:

1.4

См. также:

• addTab(String, Icon, Component, String)

public TabbedPaneUI getUI()

Переопределяет:

getUI в классе JComponent

Возвращает:

объект TabbedPaneUI

См. также:

• setUI(TabbedPaneUI)

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the tabbedpane's LookAndFeel") public void setUI(TabbedPaneUI ui)

Параметры:

ui - новый объект UI

См. также:

• UIDefaults.getUI(JComponent)

public void updateUI()

Переопределяет:

updateUI в классе JComponent

См. также:

• JComponent.updateUI()

@BeanProperty(bound=false) public String getUIClassID()

Переопределяет:

getUIClassID в классе JComponent

Возвращает:

строку "TabbedPaneUI"

См. также:

• JComponent.getUIClassID()
• UIDefaults.getUI(JComponent)

protected ChangeListener createChangeListener()

Возвращает:

ChangeListener

См. также:

• fireStateChanged()

public void addChangeListener(ChangeListener l)

Параметры:

l - добавляемый ChangeListener

См. также:

• fireStateChanged()
• removeChangeListener(ChangeListener)

public void removeChangeListener(ChangeListener l)

Параметры:

l - удаляемый ChangeListener

См. также:

• fireStateChanged()
• addChangeListener(ChangeListener)

@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()

Возвращает:

все добавленные слушатели ChangeListener или пустой массив, если слушатели не добавлялись

Начиная с версии:

1.4

protected void fireStateChanged()

См. также:

• addChangeListener(ChangeListener)
• EventListenerList

public SingleSelectionModel getModel()

Возвращает:

модель SingleSelectionModel, связанную с этой панелью с вкладками

См. также:

• setModel(SingleSelectionModel)

@BeanProperty(description="The tabbedpane's SingleSelectionModel.") public void setModel(SingleSelectionModel model)

Параметры:

model - используемая модель

См. также:

• getModel()

public int getTabPlacement()

Возвращает:

значение типа int, определяющее расположение вкладок

См. также:

• setTabPlacement(int)

@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.TOP","JTabbedPane.LEFT","JTabbedPane.BOTTOM","JTabbedPane.RIGHT"}, description="The tabbedpane's tab placement.") public void setTabPlacement(int tabPlacement)

Параметры:

tabPlacement - расположение вкладок относительно содержимого

Исключения:

IllegalArgumentException - если значение расположения вкладок не является одним из указанных выше допустимых значений

public int getTabLayoutPolicy()

Возвращает:

значение типа int, определяющее политику, используемую для компоновки вкладок

Начиная с версии:

1.4

См. также:

• setTabLayoutPolicy(int)

@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.WRAP_TAB_LAYOUT","JTabbedPane.SCROLL_TAB_LAYOUT"}, description="The tabbedpane's policy for laying out the tabs") public void setTabLayoutPolicy(int tabLayoutPolicy)

Параметры:

tabLayoutPolicy - политика, используемая для компоновки вкладок

Исключения:

IllegalArgumentException - если значение layoutPolicy не является одним из указанных выше допустимых значений

Начиная с версии:

1.4

См. также:

• getTabLayoutPolicy()

public int getSelectedIndex()

Возвращает:

индекс выбранной вкладки

См. также:

• setSelectedIndex(int)

@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected tab index.") public void setSelectedIndex(int index)

Параметры:

index - индекс, который должен быть выбран

Исключения:

IndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < -1 || index >= tab count)

См. также:

• getSelectedIndex()
• SingleSelectionModel.setSelectedIndex(int)

public Component getSelectedComponent()

Возвращает:

компонент, соответствующий выбранной вкладке

См. также:

• setSelectedComponent(Component)

@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected component.") public void setSelectedComponent(Component c)

Параметры:

c - выбранный Component для этой панели TabbedPane

Исключения:

IllegalArgumentException - если компонент не найден на панели с вкладками

См. также:

• getSelectedComponent()

public void insertTab(String title, Icon icon, Component component, String tip, int index)

Параметры:

title - заголовок, отображаемый на вкладке

icon - значок, отображаемый на вкладке

component - компонент, отображаемый при нажатии на эту вкладку.

tip - всплывающая подсказка, отображаемая для этой вкладки

index - позиция для вставки этой новой вкладки (index >= 0 && index <= getTabCount())

Исключения:

IndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index > getTabCount())

См. также:

• addTab(String, Icon, Component, String)
• removeTabAt(int)

public void addTab(String title, Icon icon, Component component, String tip)

Параметры:

title - заголовок, отображаемый на этой вкладке

icon - значок, отображаемый на этой вкладке

component - компонент, отображаемый при нажатии на эту вкладку

tip - всплывающая подсказка, отображаемая для этой вкладки

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public void addTab(String title, Icon icon, Component component)

Параметры:

title - заголовок, отображаемый на этой вкладке

icon - значок, отображаемый на этой вкладке

component - компонент, отображаемый при нажатии на эту вкладку

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public void addTab(String title, Component component)

Параметры:

title - заголовок, отображаемый на этой вкладке

component - компонент, отображаемый при нажатии на эту вкладку

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public Component add(Component component)

Переопределяет:

add в классе Container

Параметры:

component - компонент, отображаемый при нажатии на эту вкладку

Возвращает:

компонент

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public Component add(String title, Component component)

Переопределяет:

add в классе Container

Параметры:

title - заголовок, отображаемый на этой вкладке

component - компонент, отображаемый при нажатии на эту вкладку

Возвращает:

компонент

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public Component add(Component component, int index)

Переопределяет:

add в классе Container

Параметры:

component - компонент, отображаемый при нажатии на эту вкладку

index - позиция для вставки этой новой вкладки

Возвращает:

компонент

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public void add(Component component, Object constraints)

Переопределяет:

add в классе Container

Параметры:

component - компонент, отображаемый при нажатии на эту вкладку

constraints - объект, отображаемый на вкладке

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public void add(Component component, Object constraints, int index)

Переопределяет:

add в классе Container

Параметры:

component - компонент, отображаемый при нажатии на эту вкладку

constraints - объект, отображаемый на вкладке

index - позиция для вставки этой новой вкладки

См. также:

• insertTab(String, Icon, Component, String, int)
• removeTabAt(int)

public void removeTabAt(int index)

Параметры:

index - индекс удаляемой вкладки

Исключения:

IndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= tab count)

См. также:

• addTab(String, Icon, Component, String)
• insertTab(String, Icon, Component, String, int)

public void remove(Component component)

Переопределяет:

remove в классе Container

Параметры:

component - компонент, который необходимо удалить из панели с вкладками

См. также:

• addTab(String, Icon, Component, String)
• removeTabAt(int)

public void remove(int index)

Переопределяет:

remove в классе Container

Параметры:

index - индекс компонента, который необходимо удалить из tabbedpane

Исключения:

IndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= tab count)

См. также:

• addTab(String, Icon, Component, String)
• removeTabAt(int)

public void removeAll()

Переопределяет:

removeAll в классе Container

См. также:

• addTab(String, Icon, Component, String)
• removeTabAt(int)

@BeanProperty(bound=false) public int getTabCount()

Возвращает:

целое число, определяющее количество страниц с вкладками

@BeanProperty(bound=false) public int getTabRunCount()

Возвращает:

целое число, задающее количество строк, если tabPlacement равен TOP или BOTTOM, и количество столбцов, если tabPlacement равен LEFT или RIGHT, или 0, если для этого объекта tabbedpane не установлен UI

public String getTitleAt(int index)

Параметры:

index - индекс опрашиваемого элемента

Возвращает:

заголовок по индексу index

Исключения:

IndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= tab count)

См. также:

• setTitleAt(int, String)

public Icon getIconAt(int index)

Параметры:

index - индекс опрашиваемого элемента

Возвращает:

значок по индексу index

Исключения:

IndexOutOfBoundsException - если индекс выходит за пределы диапазона (index < 0 || index >= tab count)

См. также:

• setIconAt(int, Icon)

public Icon getDisabledIconAt(int index)

Параметры:

index - индекс запрашиваемого элемента

Возвращает:

значок в index

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• setDisabledIconAt(int, Icon)

public String getToolTipTextAt(int index)

Параметры:

index - индекс запрашиваемого элемента

Возвращает:

строку, содержащую текст подсказки в index

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

С версии:

1.3

См. также:

• setToolTipTextAt(int, String)

public Color getBackgroundAt(int index)

Параметры:

index - индекс запрашиваемого элемента

Возвращает:

Color фона вкладки в index

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• setBackgroundAt(int, Color)

public Color getForegroundAt(int index)

Параметры:

index - индекс запрашиваемого элемента

Возвращает:

Color переднего плана вкладки в index

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• setForegroundAt(int, Color)

public boolean isEnabledAt(int index)

Параметры:

index - индекс запрашиваемого элемента

Возвращает:

true, если вкладка в index включена; false в противном случае

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• setEnabledAt(int, boolean)

public Component getComponentAt(int index)

Параметры:

index - индекс запрашиваемого элемента

Возвращает:

Component в index

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• setComponentAt(int, Component)

public int getMnemonicAt(int tabIndex)

Параметры:

tabIndex - индекс вкладки, к которой относится мнемоника

Возвращает:

код клавиши, представляющий мнемонику; -1, если мнемоника для вкладки не указана

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (tabIndex < 0 || tabIndex >= количество вкладок)

С версии:

1.4

См. также:

• setDisplayedMnemonicIndexAt(int,int)
• setMnemonicAt(int,int)

public int getDisplayedMnemonicIndexAt(int tabIndex)

Параметры:

tabIndex - индекс вкладки, к которой относится мнемоника

Возвращает:

индекс, представляющий символ мнемоники, если он существует; в противном случае возвращает -1

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (tabIndex < 0 || tabIndex >= количество вкладок)

С версии:

1.4

См. также:

• setDisplayedMnemonicIndexAt(int,int)
• setMnemonicAt(int,int)

public Rectangle getBoundsAt(int index)

Параметры:

index - запрашиваемый индекс

Возвращает:

Rectangle, содержащий границы вкладки в index, или null, если вкладка в index в данный момент не видна в пользовательском интерфейсе или если для этого tabbedpane не установлен UI

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

@BeanProperty(preferred=true, visualUpdate=true, description="The title at the specified tab index.") public void setTitleAt(int index, String title)

Параметры:

index - индекс вкладки, для которой должен быть установлен заголовок

title - заголовок, отображаемый на вкладке

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• getTitleAt(int)
• setTabComponentAt(int, Component)

@BeanProperty(preferred=true, visualUpdate=true, description="The icon at the specified tab index.") public void setIconAt(int index, Icon icon)

Параметры:

index - индекс вкладки, для которой должен быть установлен значок

icon - значок, отображаемый на вкладке

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• setDisabledIconAt(int, Icon)
• getIconAt(int)
• getDisabledIconAt(int)
• setTabComponentAt(int, Component)

@BeanProperty(preferred=true, visualUpdate=true, description="The disabled icon at the specified tab index.") public void setDisabledIconAt(int index, Icon disabledIcon)

Параметры:

index - индекс вкладки, для которой должен быть установлен отключенный значок

disabledIcon - значок, отображаемый на вкладке в отключенном состоянии

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• getDisabledIconAt(int)

@BeanProperty(preferred=true, description="The tooltip text at the specified tab index.") public void setToolTipTextAt(int index, String toolTipText)

Параметры:

index - индекс вкладки, для которой должен быть установлен текст подсказки

toolTipText - текст подсказки, отображаемый для вкладки

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

С версии:

1.3

См. также:

• getToolTipTextAt(int)

@BeanProperty(preferred=true, visualUpdate=true, description="The background color at the specified tab index.") public void setBackgroundAt(int index, Color background)

Параметры:

index - индекс вкладки, для которой должен быть установлен фон

background - цвет, отображаемый в качестве фона вкладки

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• getBackgroundAt(int)

@BeanProperty(preferred=true, visualUpdate=true, description="The foreground color at the specified tab index.") public void setForegroundAt(int index, Color foreground)

Параметры:

index - индекс вкладки, для которой должен быть установлен цвет переднего плана

foreground - цвет, отображаемый в качестве переднего плана вкладки

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• getForegroundAt(int)

public void setEnabledAt(int index, boolean enabled)

Параметры:

index - индекс вкладки, которую необходимо включить/отключить

enabled - должна ли вкладка быть включена

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• isEnabledAt(int)

@BeanProperty(visualUpdate=true, description="The component at the specified tab index.") public void setComponentAt(int index, Component component)

Параметры:

index - индекс вкладки, на которую помещается этот компонент

component - компонент для вкладки

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

См. также:

• getComponentAt(int)

@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)

Параметры:

tabIndex - индекс вкладки, к которой относится мнемоника

mnemonicIndex - индекс в String для подчеркивания

Исключения:

IndexOutOfBoundsException - если tabIndex вне диапазона (tabIndex < 0 || tabIndex >= tab count)

IllegalArgumentException - выбрасывается, если mnemonicIndex >= длины заголовка вкладки или < -1

С версии:

1.4

См. также:

• setMnemonicAt(int,int)
• getDisplayedMnemonicIndexAt(int)

@BeanProperty(visualUpdate=true, description="The keyboard mnenmonic, as a KeyEvent VK constant, for the specified tab") public void setMnemonicAt(int tabIndex, int mnemonic)

Параметры:

tabIndex - индекс вкладки, к которой относится мнемоника

mnemonic - код клавиши, представляющий мнемонику

Исключения:

IndexOutOfBoundsException - если tabIndex вне диапазона (tabIndex < 0 || tabIndex >= tab count)

С версии:

1.4

См. также:

• getMnemonicAt(int)
• setDisplayedMnemonicIndexAt(int,int)

public int indexOfTab(String title)

Параметры:

title - заголовок вкладки

Возвращает:

индекс первой вкладки, соответствующей title, или -1, если ни одна вкладка не имеет такого заголовка

public int indexOfTab(Icon icon)

Параметры:

icon - значок для вкладки

Возвращает:

индекс первой вкладки, соответствующей icon, или -1, если ни одна вкладка не имеет такого значка

public int indexOfComponent(Component component)

Параметры:

component - компонент для вкладки

Возвращает:

первую вкладку, соответствующую этому компоненту, или -1, если для этого компонента нет вкладки

public int indexAtLocation(int x, int y)

Параметры:

x - координата x относительно этой панели вкладок

y - координата y относительно этой панели вкладок

Возвращает:

индекс вкладки, пересекающей позицию, или -1, если ни одна вкладка не пересекает эту позицию

С версии:

1.4

public String getToolTipText(MouseEvent event)

Переопределяет:

getToolTipText в классе JComponent

Параметры:

event - MouseEvent, указывающий, где задерживается курсор

Возвращает:

String, содержащий текст подсказки

protected String paramString()

Переопределяет:

paramString в классе JComponent

Возвращает:

строковое представление этой JTabbedPane.

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Указано в:

getAccessibleContext в интерфейсе Accessible

Переопределяет:

getAccessibleContext в классе Component

Возвращает:

AccessibleJTabbedPane, который служит в качестве AccessibleContext для этой JTabbedPane

@BeanProperty(preferred=true, visualUpdate=true, description="The tab component at the specified tab index.") public void setTabComponentAt(int index, Component component)

Параметры:

index - индекс вкладки, для которой должен быть установлен компонент

component - компонент для отображения заголовка указанной вкладки

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

IllegalArgumentException - если компонент уже был добавлен в эту JTabbedPane

С версии:

1.6

См. также:

• getTabComponentAt(int)

public Component getTabComponentAt(int index)

Параметры:

index - индекс запрашиваемого элемента

Возвращает:

компонент вкладки в index

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)

С версии:

1.6

См. также:

• setTabComponentAt(int, Component)

public int indexOfTabComponent(Component tabComponent)

Параметры:

tabComponent - компонент вкладки для вкладки

Возвращает:

первую вкладку, соответствующую этому компоненту вкладки, или -1, если для этого компонента вкладки нет вкладки

С версии:

1.6

См. также:

• setTabComponentAt(int, Component)
• getTabComponentAt(int)