Класс Menu

public class Menu
extends MenuItem
implements MenuContainer, Accessible

Объект Menu — это компонент выпадающего меню, который развертывается из строки меню.

Меню может быть необязательно вырывающимся (tear-off) меню. Вырывающееся меню можно открыть и перетащить его от родительской строки меню или меню. Оно остается на экране после того, как кнопка мыши отпущена. Механизм вырывания меню зависит от платформы, так как внешний вид вырывающегося меню определяется его «виртуальной частью» (peer). На платформах, которые не поддерживают вырывающиеся меню, свойство вырывания игнорируется.

Каждый элемент в меню должен принадлежать классу MenuItem. Он может быть экземпляром MenuItem, подменю (экземпляр Menu) или флажком (экземпляр CheckboxMenuItem).

Конструкторы

Меню

public Menu()
     throws HeadlessException

Создаёт новое меню с пустым меткой. Это меню не является выпадающим.

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

С тех пор:

JDK1.1

См. также:

GraphicsEnvironment.isHeadless()

Меню

public Menu(String label)
     throws HeadlessException

Создаёт новое меню с указанной меткой. Это меню не является выпадающим.

Параметры:

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

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

GraphicsEnvironment.isHeadless()

Меню

public Menu(String label,
            boolean tearOff)
     throws HeadlessException

Параметры:

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

tearOff - если true, меню является выпадающим.

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

С тех пор:

JDK1.0.

См. также:

GraphicsEnvironment.isHeadless()

Методы

addNotify

public void addNotify()

Создаёт виджет меню. Виджет позволяет изменять вид меню без изменения его функциональности.

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

addNotify в классе MenuItem

removeNotify

public void removeNotify()

Удаляет виджет меню. Виджет позволяет изменять вид меню без изменения его функциональности.

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

removeNotify в классе MenuComponent

isTearOff

public boolean isTearOff()

Возвращает:

true если это выпадающее меню; false в противном случае.

getItemCount

public int getItemCount()

Возвращает количество элементов в этом меню.

Возвращает:

количество элементов в этом меню.

С тех пор:

JDK1.1

countItems

@Deprecated
public int countItems()

Устарело. С версии JDK 1.1 заменено на getItemCount().

getItem

public MenuItem getItem(int index)

Возвращает элемент, расположенный по указанному индексу в этом меню.

Параметры:

index - позиция возвращаемого элемента.

Возвращает:

элемент, расположенный по указанному индексу.

add

public MenuItem add(MenuItem mi)

Добавляет указанный элемент меню в это меню. Если элемент меню был частью другого меню, удаляет его из этого меню.

Параметры:

mi - элемент меню для добавления

Возвращает:

добавляемый элемент меню

См. также:

insert(java.lang.String, int), insert(java.awt.MenuItem, int)

add

public void add(String label)

Добавляет элемент с указанной меткой в это меню.

Параметры:

label - текст элемента

См. также:

insert(java.lang.String, int), insert(java.awt.MenuItem, int)

insert

public void insert(MenuItem menuitem,
                   int index)

Вставляет элемент меню в это меню в указанную позицию.

Параметры:

menuitem - вставляемый элемент меню.

index - позиция, в которую должен быть вставлен элемент меню.

Исключения:

IllegalArgumentException - если значение index меньше нуля

С тех пор:

JDK1.1

См. также:

add(java.lang.String), add(java.awt.MenuItem)

insert

public void insert(String label,
                   int index)

Вставляет элемент меню с указанной меткой в это меню в указанную позицию. Это удобный метод для insert(menuItem, index).

Параметры:

label - текст элемента

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

Исключения:

IllegalArgumentException - если значение index меньше нуля

С тех пор:

JDK1.1

См. также:

add(java.lang.String), add(java.awt.MenuItem)

addSeparator

public void addSeparator()

Добавляет разделительную линию или тире в меню в текущей позиции.

См. также:

insertSeparator(int)

insertSeparator

public void insertSeparator(int index)

Вставляет разделитель в указанную позицию.

Параметры:

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

Исключения:

IllegalArgumentException - если значение index меньше 0.

С тех пор:

JDK1.1

См. также:

addSeparator()

remove

public void remove(int index)

Удаляет элемент меню по указанному индексу из этого меню.

Параметры:

index - позиция удаляемого элемента.

remove

public void remove(MenuComponent item)

Удаляет указанный элемент меню из этого меню.

Определено в:

remove в интерфейсе MenuContainer

Параметры:

item - удаляемый элемент меню. Если item равно null или не входит в это меню, этот метод ничего не делает.

removeAll

public void removeAll()

Удаляет все элементы из этого меню.

С тех пор:

JDK1.0.

paramString

public String paramString()

Возвращает строку, представляющую состояние этого Menu. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не null.

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

paramString в классе MenuItem

Возвращает:

строку параметров этого меню

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим меню. Для меню AccessibleContext имеет вид AccessibleAWTMenu. Новый экземпляр AccessibleAWTMenu создаётся при необходимости.

Определено в:

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

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

getAccessibleContext в классе MenuItem

Возвращает:

AccessibleAWTMenu, который служит AccessibleContext этого меню

С тех пор:

1.3