Главная страница | Контакты | Случайная страница Автомобили Астрономия Биология География Дом и сад Другие языки Другое Информатика История Культура Литература Логика Математика Медицина Металлургия Механика Образование Охрана труда Педагогика Политика Право Психология Религия Риторика Социология Спорт Строительство Технология Туризм Физика Философия Финансы Химия Черчение Экология Экономика Электроника

Метод paramString: protected String paramString ().Возвращает стро­ку, в которой указано состояние кнопки. Обычно применяется для от­ладки.

Метод processActionEvent: protected void processActionEvent (ActionEvent е). Стандартный метод, вызываемый при нажатии кнопки. В принципе, существует возможность назначить на одну и ту же кнопку несколько различных действий, а потом выбирать их, но эту возможность подробно мы рассматривать не будем. Скажу лишь, что для ее реализа­ции СТОИТ ВОСПОЛЬЗОВаТЬСЯ методами addActionListener И removeActionListener.

Метод setLabel: public synchronized void setLabel(String label). Предназначен для задания надписи на кнопке.

Следующим на палитре объектов стоит элемент Checkbox. Предназначен для реализации переключателя, имеющего два возможных положения: истина (True) и ложь (raise). Полное наименование класса— java.awt. checkbox. Может использоваться как в одиночку, так и в группе. Обладает пятью (!) конструкторами.

Конструктор checkbox () создает один переключатель без имени, состояние не определено и, кроме того, созданный переключатель не приписан ни к какой группе переключателей. Все эти данные задаются при помощи мето­дов в блоке инициализации.

Второй конструктор checkbox (String) создает переключатель с заранее за­данной строкой.

Конструктор checkbox (String, boolean) помимо установки строки, иден­тифицирующей этот переключатель, указывает еще и состояние переключа­теля, которое будет установлено по умолчанию.

Последние два конструктора различаются лишь порядком следования пара­метров— Checkbox(String, boolean, CheckboxGroup) И Checkbox(String, checkboxGroup, boolean). Они в дополнение к уже рассмотренным пара­метрам переключателя указывают группу независимых переключателей, к которой будет относиться создаваемый переключатель.

Метод getCheckboxGroup: public CheckboxGroup getCheckboxGroup(). В качестве результата возвращает идентификатор группы независимых переключателей, к которой приписан данный конкретный переключа­тель.

Метод getLabel: public String getLabel ().В качестве результата воз­вращает строку переключателя.

Метод getSelectedObjects: public Objectt] getSelectedObjects(). Возвращает массив, содержащий строку переключателя, либо null, если этот переключатель не выбран пользователем.

Метод getState: public boolean getStateO. Определяет, В каком ПО-ложении в данный момент находится переключатель, включен или вы­ключен, и, соответственно, возвращает либо True, либо False.

Метод paramString: protected String paramString (). Отладочный метод. Возвращает строку со служебной информацией о состоянии компонента.

Метод setCheckboxGroup: public void setCheckboxGroup(CheckboxGroup g). Позволяет установить группу независимых переключателей, к кото­рой будет приписан данный переключатель.

Метод setLabel: public synchronized void setLabel(String label). Позволяет установить строку переключателя, которая передается в каче­стве строкового параметра при вызове метода.

Метод setState: public void setState (boolean state). С помощью этого метода принудительно устанавливается состояние переключателя (то самое вкл\выкл).

Переходим к компоненту CheckboxGroup. Он объединяет в себе несколько зависимых переключателей, так называемых радиокнопок. Полное наименование класса — java.awt.CheckboxGroup. Обладает единственным конструк­тором CheckboxGroup().

Метод getSelectedCheckbox: public Checkbox getSelectedCheckbox(). Возвращает выбранный пользователем переключатель.

Метод setSelectedCheckbox: public synchronized void setSelectedCheckbox (Checkbox box). Позволяет Принудительно один из переключателей сделать выбранным, устанавливая этот переключатель в положение "включено", а все остальные переключатели этой группы — в положение "выключено".

Метод toString: public String toStringO.. Возвращает содержание всей группы в виде строки, включая и значение выбранного элемента.

Есть также методы getCurrent и setcurrent, дублирующие методы getSelectedCheckbox И setSelecfcedCheckbox. Их Применение, как ска­зано в документации, осуждается. Попросту говоря, эти методы устарели и оставлены лишь для обеспечения совместимости с предыдущими вер­сиями.

Следующим идет элемент Choice, который является аналогом стандартного ComboBox в Delphi, т. е. выпадающий список выбора. Полное наименование класса java.awt. choice. Имеет один обычный конструктор choice о. При создании выпадающего списка выбранным считается первый его элемент.

Метод add: public synchronized void addfString item). Позволяет ДО-бавить один пункт в список выбора. Добавляемая строка передается в ка­честве параметра.

Метод addltem: public synchronized void add!tem(String item). Пол­ностью повторяет предыдущий.

Метод getltem: public String getltem(int index). В качестве результа­та работы возвращает строку этого элемента управления с номером, пе­реданным в качестве параметра.

Метод getItemCount: public int getItemCount ().Возвращаетколичество пунктов выбора, т. е. строк в выпадающем списке выбора.

Метод getSelectedIndex: public int getSelectedIndex (). Возвращает номер выбранного пункта списка.

Метод getSelectedItem: public synchronized String getSeiecteditemO. В отличие от предыдущего метода, возвращает со­держание выбранного пункта списка.

Метод getSelectedObjects: public synchronized Object[] getSeiectedobjects о. Возвращает в качестве массива объектов выбран­ный пункт меню. В том случае, если ни один пункт списка не выбран, возвращается null.

Метод insert: public synchronized void insert(String item, int index). Вставляет в список выбора дополнительную строку на позицию, указанную в параметре index.

Метод remove присутствует в двух модификациях. Первая из них — public synchronized void remove(int position). Удаляет ИЗ списка строку, на­ходящуюся на позиции с номером, указанным в качестве параметра. Вто­рая — public synchronized void remove(String item) — удаляет из списка строку, содержимое которой передано в качестве параметра.

Метод removeAll: public synchronized void removeAllO. В результате выполнения этого метода из списка удаляются все пункты.

Метод select также существует в двух модификациях. Предназначен для принудительной установки какой-либо строки в списке в качестве вы­бранной. Первая модификация — public synchronized void select(int pos) позволяет указывать номер выбираемой строки. Вторая — public synchronized void select (String str) передает в параметре содержи­мое того пункта, который необходимо выбрать.

Следующим рассматриваемым компонентом будет Label, т. е. простая тек­стовая метка. Название класса— java.awt. Label. Помимо методов и трех конструкторов, этот класс имеет и зарезервированные константы. Объявле­ны они целочисленными, но для удобства использования созданы в строко­вом виде. Эти константы отвечают за выравнивание текста и носят названия center, left и right. Первая выравнивает текст по центру, вторая по лево­му краю, а третья — по правому.

Также имеются три конструктора. Первый — Label о — создает пустую тек­стовую метку. Второй— Label (String) — позволяет при создании указы­вать и содержимое этой метки. А третий — Label (String, int) — дает воз­можность помимо строки содержимого, указывать и выравнивание ее с помощью вышеописанных констант.

Метод getAlignment: public int getAlignment (). Возвращает текущее выравнивание текста.

Метод getText: public String getText(). Возвращает содержимое тек­стовой метки.

Метод setAlignment: public synchronized void setAlignment(int alignment). Позволяет с помощью зарезервированных констант прину­дительно установить выравнивание текста метки.

Метод setText: public synchronized void setText(String text). Предназначен для установки текстового содержимого метки.

Следующий компонент предназначен для отображения списков. В том слу­чае, если количества строк, зарезервированных для этого элемента управле­ния, недостаточно для отображения всего содержимого, появляется полоса прокрутки. Элемент управления носит имя List. Полное имя класса — java.awt.List. Обладает тремя конструкторами. Первый из них — List о — просто создает пустой список. Второй — List tint) — создает список с за­ранее установленным числом строк, которое передается в качестве парамет­ра в конструкторе. Третий конструктор— List(int, boolean) — помимо создания списка с установленным количеством строк, еще и указывает на возможность множественного выбора элементов, т. е. если параметр типа boolean установлен в True, то пользователь получает возможность выбирать в списке не одну строку, а несколько.

Метод add у этого компонента представлен в двух модификациях. Пер­вый вариант— public void add (String item)— просто добавляет в ко-нец списка дополнительную строку. Второй — public synchronized void add (String item, i.nt index) — Вставляет новую строку на пози­цию, номер которой передается в параметре index. Отсчет ведется с нуля. Если этот параметр равен -1 или больше, чем количество строк в списке, новая строка вставляется в конце. В точно таких же модификациях при­сутствует и метод additem, по своему действию абсолютно повторяющий метод add.

Метод delltem: public synchronized void delltem(int position). Позволяет удалить строку из списка, порядковый номер которой (начиная с нуля) передан в качестве параметра.

Метод deselect: public synchronized void deselect(int index). Предназначен для снятия выделения со строки, номер которой передает­ся в качестве параметра. В том случае, если строка не являлась выбран­ной, выполнение метода ни к чему не приведет.

Метод getltem: public String getltem(int index). Возвращает В каче­стве результата строку, находящуюся в списке на позиции, номер кото­рой передан методу в качестве параметра.

Метод getItemCount: public int getItemCount О. Возвращает количество строк в списке.

Метод getltems: public synchronized String [] getItemsO. Возвраща­ет массив строк, в котором содержатся все строки списка.

Метод getMinimumSize: public Dimension getMinimumSize ().Возвращаетзначение типа Dimension. В классе java.awt. Dimension инкапсулированы высота и ширина объекта, к которому приписан данный класс. Эти значе­ния хранятся в переменных height и width, соответственно. Таким обра­зом, вызов метода getMinimumsize позволяет получить минимальные раз­меры, необходимые для корректного отображения объекта list. Этот метод имеет и другую реализацию — public Dimension getMinimumSize (int rows). В качестве параметра передается количество строк для списка, и в результате получаем все те же минимальные размеры.

Метод getpreferredsize весьма похож на предыдущий метод. Он точно так же существует в двух модификациях: public Dimension getPreferredSize() И public Dimension getPreferredSize (int rows). Но результатом их действия являются предпочтительные размеры для отображения списка. Как и в предыдущем методе, вторая реализация по­зволяет напрямую указывать количество строк.

Метод getRows: public int getRows (). Возвращает количество, видимых строк для данного списка.

Метод getSelectedIndex: public synchronized int getSeiectedindext). Возвращает номер строки, выбранной пользовате­лем. В том случае, если в списке нет выбранных строк, возвращает зна­чение -1.

Метод getSelectedIndexes: public synchronized int[] getSeiectedindexes (). Возвращает целочисленный массив, в котором хранятся позиции выбранных строк.

Метод getSelectedItem: public synchronized String getSelecteditemo. Возвращает строку, выбранную пользователем.

Метод getSelectedItems: public synchronized String[] getSelecteditems (). Возвращает массив строк, выбранных пользовате­лем, если, конечно, в данном списке позволен множественный выбор.

Метод getSelectedObjects: public Object[] getSelectedObjects(). В принципе, похож на предыдущий метод, но в отличие от него возвра­щает массив типа Object.

Метод getVisibleIndex: public int getVisibleIndex().Возвращаетномер строки, которая последняя была сделана видимой с помощью ме­тода makeVisible.

Метод isIndexSelected: public boolean isIndexSelected(int index). Позволяет узнать, является ли строка, чей номер был передан в качестве параметра, выбранной пользователем или нет. Возвращает, естественно, True или False, соответственно.

Метод'isMultipleMode: public boolean isMultipleMode (). Позволяет узнать, поддерживает ли данный список множественный выбор.

Метод makeVisible: public synchronized void makeVisible(int index). Позволяет сделать видимой строку, позиция которой передана в качестве параметра. Если все строки не умещаются в списке, то для по­каза какой-либо не видимой в данный момент строки без участия поль­зователя, который мог бы обратиться к строке прокрутки, используется именно этот метод.

Метод remove, как и многие другие, присутствует в двух модификациях: public synchronized void remove(int position) И public synchronized void remove (String item).Естественно, что в каждой своей ипостаси метод занимается тем, что удаляет из списка одну строку. Но в первой реализации ему в качестве параметра передается номер этой строки, а во второй — содержимое этой строки.

Метод removeAll: public synchronized void removeAll (). Позволяет полностью очистить список, т. е. попросту удалить из него все строки.

Метод replaceltem: public synchronized void replaceltem(String newvalue, int index). Предназначен для замены содержимого строки. В параметре newValue передается новое содержимое, в параметре index — номер заменяемой строки.

Метод select: public void select (int index). Позволяет строку с номером, передаваемым в параметре index, принудительно объявить вы­бранной.

Метод setMultipleMode: public synchronized void setMultipleMode(boolean b). Позволяет установить значение, опреде­ляющее, будет ли список иметь возможность множественного выбора. Естественно, при передаче в качестве параметра значения True список получит эту возможность.

Следующий компонент носит название MenuBar. Полное наименование клас­са java.awt.MenuBar. Предназначен для реализации стандартного меню. MenuBar состоит из нескольких объектов типа Menu. Каждый из них является пунктом основного меню, т.е. это те пункты, которые видны в строке глав­ного меню. Естественно, они позволяют реализовать и собственные подменю, так что перед тем, как разбираться с реализацией компонента MenuBar, при­дется узнать, как устроен класс java.awt.Menu. У этого класса есть три конст­руктора. Первый — Menu () — как обычно, просто создает объект без какого-либо наполнения, предоставляя возможность это сделать позже. Второй — Menu (String) — позволяет при создании указать строку с названием этого пункта меню. Третий — Menu (String, boolean) позволяет помимо содержи­мого, указывать еще и возможность перемещения этого пункта. Обратите внимание, что последняя возможность является платформо-зависимой и, сле­довательно, не может быть рекомендована к применению.

Сам объект Menu состоит из нескольких объектов типа Menuitem, которые и являются основными строительными кирпичиками для всей системы меню. Класс java.awt. Menuitem реализует отдельные пункты меню. Также имеет три конструктора. Стандартный конструктор, создающий пустой объект, — Menuitemо. Конструктор, создающий пункт меню с его содержимым,— Menuitem (String). И, наконец, конструктор, который позволяет указывать не только название этого пункта, но и комбинацию "горячих клавиш" для его вызова, — Menulfem(String, MenuShortcut). При этом если в последних двух конструкторах в качестве содержимого пункта меню поставить ти­ре, то будет создан разделитель меню.

Метод deleteShortcut: public void deleteShortcut О. Удаляет комбинацию "горячих клавиш", ассоциированную с данным пунктом меню.

Метод getLabel: public String getLabelf).Возвращает строкусодержимого этого пункта меню.

Метод getShortcut: public MenuShortcut getShortcut().Возвращает комбинацию "горячих клавиш", назначенную для этого пункта меню.

Метод isEnabled: public boolean isEnabledo. Возвращает логическое значение, указывающее на доступность этого пункта меню для выбора.

Метод setEnabled: public synchronysed void setEnabled(boolean b). Позволяет сделать пункт меню доступным для выбора, если передано значение параметра True, или сделать его недоступным, если передано False.

Метод setLabel: public synchronized void setLabel(String label). Позволяет задать значение строки данного, пункта меню.

Метод setShortcut: public void setShortcut(MenuShortcut s). Приме­няется для установки комбинации "горячих клавиш" для данного пункта меню.

На этом список рассматриваемых методов класса Menuitem заканчивается, и мы можем перейти к рассмотрению методов класса Menu.

Метод add присутствует в двух модификациях. Первый вариант — public synchronyzed Menuitem add(Menuitem mi) — добавляет В меню НОВЫЙ элемент типа Menuitem. Если такой элемент присутствует в каком-либо другом меню, то он оттуда удаляется. При этом в качестве результата возвращается тот самый элемент, который необходимо было вставить. Вторая вариация — public void add (String label) позволяет в качестве параметра указать просто строку. Этот вариант, как можно увидеть из его объявления, ничего не возвращает.

Метод addSeparator: public void addSeparator О. Вставляет В текущую позицию меню разделитель.

Метод getltem: public Menuitem getltem(int index). Возвращает пункт меню (тип Menuitem), который находится на позиции, номер которой был передан в качестве параметра.

Метод getItemCount: public int getItemCount ().Возвращает количество пунктов в данном меню.

Метод insert, как и add, имеет две реализации. Первая — public synchronyzed void insert(Menuitem menuitem, int index)—вставляетна указанную позицию (параметр index) пункт меню, который передается в виде параметра типа Menuitem. Вторая реализация метода — public void insert (String label, int index) естественно, делает то же самое, но позволяет в качестве параметра передавать простую строку.

Метод insertSeparator: public void insertSeparator(int index). Предназначен для вставки разделителя на указанную позицию.

Метод remove представлен в двух вариантах. Первый — public synchronyzed void remove (int index) —удаляет из меню строку с указанным номером. Второй — public synchronyzed void remove (Menucomponent item) — для удаления строки требует передать ее в качестве параметра типа Menucomponent.

Метод removeAli: public synchronized void removeAl1(). Как можно догадаться, переведя его название, предназначен для удаления всех эле­ментов меню, т. е. для его очистки.

И вот только теперь мы можем перейти к изначально объявленному компо­ненту MenuBar. Реализующий его класс имеет всего один конструктор MenuBar (), создающий пустую заготовку, которую придется заполнять с по­мощью его родных методов.

Метод add: public synchronized Menu add (Menu m). Вот где Пригодилось нам тщательное рассмотрение предыдущих классов. Ведь в качестве па­раметра в этом методе передается то самое меню, чей тип мы рассмотре­ли только что. Естественно, оно просто добавляется к уже присутствую­щим. Кстати, в качестве результата метод возвращает это же меню.

Метод deleteShortcut: public void deleteShortcut(MenuShortcut s). Удаляет из меню указанную комбинацию быстрых клавиш.