BlackBerry Java SDKUI ComponentVersión: 6.0

Guía de referencia rápida

Publicado: 2011-03-07SWD-1203961-0307101032-005

Contenido1 Campos de texto............................................................................................................................................... 3

Etiqueta............................................................................................................................................................. 3Campo de texto de sólo lectura........................................................................................................................ 4Campo de texto editable.................................................................................................................................. 5Campo de contraseña....................................................................................................................................... 7Campo de dirección de correo.......................................................................................................................... 8Campo de búsqueda......................................................................................................................................... 9Campos de texto con la función Autocompletar.............................................................................................. 11Campo de edición de texto automático............................................................................................................ 13Campo de edición de texto automático activo................................................................................................. 14

2 Campos de selección........................................................................................................................................ 16Casilla de verificación........................................................................................................................................ 16Lista desplegable basada en texto.................................................................................................................... 17Lista desplegable numérica.............................................................................................................................. 18Campo de fecha................................................................................................................................................ 19Colector de fechas............................................................................................................................................ 20Colector de archivos......................................................................................................................................... 21Casilla de selección numérica........................................................................................................................... 22Colector de ubicación....................................................................................................................................... 24Campo de árbol................................................................................................................................................. 27

3 Botones............................................................................................................................................................. 29Botón de opción................................................................................................................................................ 29Barra de herramientas...................................................................................................................................... 30Botón................................................................................................................................................................ 32

4 Campos de actividad......................................................................................................................................... 34Campo de evaluación........................................................................................................................................ 34Indicador de actividad...................................................................................................................................... 35Indicador de progreso....................................................................................................................................... 36

5 Campos de imagen........................................................................................................................................... 38Campo de mapa de bits.................................................................................................................................... 38Campo de desplazamiento de imágenes.......................................................................................................... 39

6 Listas y tablas.................................................................................................................................................... 41Lista sencilla...................................................................................................................................................... 41

Lista enriquecida............................................................................................................................................... 42Tabla................................................................................................................................................................. 43

7 Otros componentes.......................................................................................................................................... 47Campo de navegador........................................................................................................................................ 47Barra de título................................................................................................................................................... 48Campo de mapa................................................................................................................................................ 49

8 Comentarios..................................................................................................................................................... 51

9 Historial de revisión del documento................................................................................................................. 52

10 Aviso legal......................................................................................................................................................... 53

Campos de texto 1

EtiquetaUtilice una etiqueta para identificar un componente de interfaz de usuario para el usuario de un dispositivoBlackBerry®.

Clase LabelFieldCompatible desde BlackBerry® Java® SDK 4.0Ejemplo

Para obtener más información acerca de las etiquetas, consulte las Directrices sobre IU.

Ejemplo de código: crear una etiqueta

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.LabelField;public class LabelFieldDemo extends UiApplication{ public static void main(String[] args) { LabelFieldDemo theApp = new LabelFieldDemo(); theApp.enterEventDispatcher(); } public LabelFieldDemo() { pushScreen(new LabelFieldDemoScreen()); }}class LabelFieldDemoScreen extends MainScreen{ public LabelFieldDemoScreen() { LabelField title = new LabelField("Label Field Demo", LabelField.ELLIPSIS | LabelField.USE_ALL_WIDTH); setTitle(title);

Guía de referencia rápida Campos de texto

3

LabelField labelField1 = new LabelField("Right-aligned label field", LabelField.FIELD_RIGHT); LabelField labelField2 = new LabelField("Centered label field", LabelField.FIELD_HCENTER | LabelField.FOCUSABLE); LabelField labelField3 = new LabelField("Left-aligned label field", LabelField.FIELD_LEFT); add(labelField1); add(labelField2); add(labelField3); }}

Campo de texto de sólo lecturaUtilice un campo de texto de sólo lectura para mostrar texto de sólo lectura al que se pueda dar formato.

Clase RichTextFieldCompatible desde BlackBerry® Java® SDK 4.0Ejemplo

Para obtener más información acerca de los campos de texto de sólo lectura, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de texto de sólo lectura

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.RichTextField;import net.rim.device.api.ui.Font;import net.rim.device.api.ui.FontFamily;import net.rim.device.api.ui.component.Dialog;public class RichTextFieldDemo extends UiApplication{ public static void main(String[] args) { RichTextFieldDemo theApp = new RichTextFieldDemo(); theApp.enterEventDispatcher(); } public RichTextFieldDemo()

Guía de referencia rápida Campo de texto de sólo lectura

4

{ pushScreen(new RichTextFieldDemoScreen()); }}class RichTextFieldDemoScreen extends MainScreen{ Font myFont1, myFont2, myFont3; public RichTextFieldDemoScreen() { RichTextField title = new RichTextField("Read-only Text Field Demo"); setTitle(title); RichTextField rtf1 = new RichTextField("Right-aligned plain", RichTextField.TEXT_ALIGN_RIGHT); RichTextField rtf2 = new RichTextField("Centered extra bold", RichTextField.TEXT_ALIGN_HCENTER); RichTextField rtf3 = new RichTextField("Left-aligned italic", RichTextField.TEXT_ALIGN_LEFT); try { FontFamily ff1 = FontFamily.forName("Times New Roman"); myFont1 = ff1.getFont(Font.PLAIN, 18); FontFamily ff2 = FontFamily.forName("Courier New"); myFont2 = ff2.getFont(Font.EXTRA_BOLD, 24); FontFamily ff3 = FontFamily.forName("Verdana"); myFont3 = ff3.getFont(Font.ITALIC, 24); } catch(final ClassNotFoundException cnfe) { UiApplication.getUiApplication().invokeLater(new Runnable() { public void run() { Dialog.alert("FontFamily.forName() threw " + cnfe.toString()); } }); } rtf1.setFont(myFont1); rtf2.setFont(myFont2); rtf3.setFont(myFont3); add(rtf1); add(rtf2); add(rtf3); }}

Campo de texto editableUtilice un campo de texto editable para permitir que los usuarios del dispositivo BlackBerry® puedan introducir textoen un campo. Puede aplicar filtros para restringir los caracteres que los usuarios pueden introducir en el campo detexto.

Clase BasicEditField

Guía de referencia rápida Campo de texto editable

5

Compatible desde BlackBerry® Java® SDK 3.7Ejemplo

Para obtener más información acerca de los campos de texto editable, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de texto editable

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.BasicEditField;public class BasicEditFieldDemo extends UiApplication{ public static void main(String[] args) { BasicEditFieldDemo theApp = new BasicEditFieldDemo(); theApp.enterEventDispatcher(); } public BasicEditFieldDemo() { pushScreen(new BasicEditFieldDemoScreen()); }}class BasicEditFieldDemoScreen extends MainScreen{ public BasicEditFieldDemoScreen() { setTitle("Editable Text Field Demo"); BasicEditField enterName = new BasicEditField("Your name: ", ""); BasicEditField enterPhone = new BasicEditField("Work number: ", "", 50, BasicEditField.FILTER_PHONE); add(enterName); add(enterPhone); }}

Guía de referencia rápida Campo de texto editable

6

Campo de contraseñaUtilice un campo de contraseña cuando se solicite a los usuarios del dispositivo BlackBerry® que introduzcan unacontraseña. Puede aplicar filtros para restringir los caracteres que los usuarios pueden introducir en este campo. Deforma predeterminada, el campo de contraseña admite todos los caracteres.

Clase PasswordEditFieldCompatible desde BlackBerry® Java® SDK 4.2.1Ejemplo

Para obtener más información acerca de los campos de contraseña, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de contraseña

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.BasicEditField;import net.rim.device.api.ui.component.PasswordEditField;public class PasswordEditFieldDemo extends UiApplication{ public static void main(String[] args) { PasswordEditFieldDemo theApp = new PasswordEditFieldDemo(); theApp.enterEventDispatcher(); } public PasswordEditFieldDemo() { pushScreen(new PasswordEditFieldDemoScreen()); }}class PasswordEditFieldDemoScreen extends MainScreen{ public PasswordEditFieldDemoScreen() { setTitle("Password Field Demo"); BasicEditField enterUsername = new BasicEditField("Username: ", ""); PasswordEditField enterPIN = new PasswordEditField("PIN: ", "", 4, PasswordEditField.FILTER_NUMERIC);

Guía de referencia rápida Campo de contraseña

7

add(enterUsername); add(enterPIN); }}

Campo de dirección de correoUtilice un campo de dirección de correo cuando se solicite a los usuarios del dispositivo BlackBerry® que introduzcanuna dirección de correo. Este campo sólo admite aquellos caracteres válidos en direcciones de correo.

El primer espacio que un usuario introduce se sustituye automáticamente por una arroba (@) y cualquier espacioadicional se sustituye por puntos (.).

Clase EmailAddressEditFieldCompatible desde BlackBerry® Java® SDK 4.0Ejemplo

Para obtener más información acerca de los campos de dirección de correo electrónico, consulte las Directrices sobreIU.

Ejemplo de código: crear un campo de dirección de correo

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.EmailAddressEditField;public class EmailAddressEditFieldDemo extends UiApplication{ public static void main(String[] args) { EmailAddressEditFieldDemo theApp = new EmailAddressEditFieldDemo(); theApp.enterEventDispatcher(); } public EmailAddressEditFieldDemo() { pushScreen(new EmailAddressEditFieldDemoScreen()); }}

Guía de referencia rápida Campo de dirección de correo

8

class EmailAddressEditFieldDemoScreen extends MainScreen{ public EmailAddressEditFieldDemoScreen() { setTitle("Email Address Field Demo"); EmailAddressEditField enterEmail = new EmailAddressEditField("Email address: ", ""); add(enterEmail); }}

Campo de búsquedaUtilice un campo de búsqueda para permitir que los usuarios del dispositivo BlackBerry® puedan filtrar una lista depalabras que coincidan con los caracteres que introduzcan en el campo. Los usuarios pueden seleccionar una de lascoincidencias que se presentan, o bien continuar introduciendo texto para restringir aún más las opciones disponibles.

Al crear un campo de búsqueda, debe especificar una lista de origen. La lista de origen suministra las cadenas parala comparación, que pueden ser no modificables o bien derivadas de fuentes de datos de un dispositivo BlackBerrycomo, por ejemplo, los contactos, las notas y las tareas.

Clase KeywordFilterFieldCompatible desde BlackBerry® Java® SDK 4.5Ejemplo

Para obtener más información acerca de los campos de búsqueda, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de búsqueda

import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.collection.ReadableList;import net.rim.device.api.util.Comparator;import java.util.*;import net.rim.device.api.collection.util.*; import net.rim.device.api.util.StringUtilities;import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;

Guía de referencia rápida Campo de búsqueda

9

public class SearchFieldDemo extends UiApplication{ KeywordFilterField _keywordFilterField; CountryList _countryList; public static void main(String args[]) { SearchFieldDemo theApp = new SearchFieldDemo(); theApp.enterEventDispatcher(); } public SearchFieldDemo() { _countryList = new CountryList(); _countryList.addElement(new Country("Zimbabwe")); _countryList.addElement(new Country("Argentina")); _countryList.addElement(new Country("Brazil")); _countryList.addElement(new Country("Canada")); _countryList.addElement(new Country("Chile")); _countryList.addElement(new Country("China")); _countryList.addElement(new Country("Germany")); _keywordFilterField = new KeywordFilterField(); _keywordFilterField.setLabel(""); _keywordFilterField.setSourceList(_countryList, _countryList); SearchFieldDemoScreen screen = new SearchFieldDemoScreen(); screen.setTitle(_keywordFilterField.getKeywordField()); screen.add(_keywordFilterField); screen.addMenuItem(addElementItem); pushScreen(screen); } void addElementToList(Country country) { _countryList.addElement(country); _keywordFilterField.updateList(); } private final MenuItem addElementItem = new MenuItem("Add country", 0, 0) { public void run() { _keywordFilterField.setKeyword(""); String[] selections = {"Add","Cancel"}; Dialog addDialog = new Dialog("Add Country", selections, null, 0, null); EditField inputField = new EditField("Country: ",""); addDialog.add(inputField); if(addDialog.doModal() == 0) { addElementToList(new Country(inputField.getText())); } } };}class SearchFieldDemoScreen extends MainScreen{ public SearchFieldDemoScreen(){};} class CountryList extends SortedReadableList implements KeywordProvider{

Guía de referencia rápida Campo de búsqueda

10

public CountryList() { super(new CountryListComparator()); } void addElement(Object element) { doAdd(element); } public String[] getKeywords(Object element) { if(element instanceof Country) { return StringUtilities.stringToWords(element.toString()); } return null; } final static class CountryListComparator implements Comparator { public int compare(Object o1, Object o2) { if (o1 == null || o2 == null) throw new IllegalArgumentException("Cannot compare null countries"); return o1.toString().compareTo(o2.toString()); } }}class Country{ private String _countryName; public Country(String countryName) { _countryName = countryName; } public String toString() { return _countryName; }}

Campos de texto con la función AutocompletarUtilice un campo de texto con la función Autocompletar para permitir que los usuarios del dispositivo BlackBerry®puedan seleccionar una opción de una lista cambiante de palabras que coincidan con los caracteres que introducenen el campo. Los usuarios pueden seleccionar una de las coincidencias que se presentan, o bien continuarintroduciendo texto para restringir aún más las opciones.

Al crear un campo de texto con la función Autocompletar, debe asociarlo a un objeto BasicFilteredList. ElBasicFilteredList suministra las cadenas para la comparación, que pueden ser no modificables o bien derivadasde fuentes de datos de un dispositivo BlackBerry como, por ejemplo, los contactos, las notas y las tareas.

Clases AutoCompleteField, BasicFilteredList

Guía de referencia rápida Campos de texto con la función Autocompletar

11

Compatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información acerca de los campos de texto con la función Autocompletar, consulte la Guía dedesarrollo de interfaz de usuario y navegación.

Ejemplo de código: crear un campo de texto con la función Autocompletar

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.AutoCompleteField;import net.rim.device.api.collection.util.*;public class AutoCompleteFieldApp extends UiApplication { public static void main(String[] args) { AutoCompleteFieldApp app = new AutoCompleteFieldApp(); app.enterEventDispatcher(); } AutoCompleteFieldApp() { pushScreen(new HomeScreen()); }}class HomeScreen extends MainScreen{ public HomeScreen() { setTitle("Autocomplete Text Field Demo"); BasicFilteredList filterList = new BasicFilteredList(); String[] days = {"Monday","Tuesday","Wednesday", "Thursday","Friday","Saturday","Sunday"}; filterList.addDataSet(1,days,"days",BasicFilteredList .COMPARISON_IGNORE_CASE); AutoCompleteField autoCompleteField = new AutoCompleteField(filterList); add(autoCompleteField); }}

Guía de referencia rápida Campos de texto con la función Autocompletar

12

Campo de edición de texto automáticoUtilice un campo de edición de texto automático para corregir automáticamente el texto que el usuario de undispositivo BlackBerry® introduce en el campo. El texto se corrige a partir de la lista de definiciones de textoautomático que incluye los errores tipográficos y las correcciones más comunes. El texto se corrige cuando el usuariopulsa la tecla Espacio.

Clase AutoTextEditFieldCompatible desde BlackBerry® Java® SDK 4.0Ejemplo

Para obtener más información acerca de los campos de edición de texto automático, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de edición de texto automático.

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.AutoTextEditField;public class AutoTextEditFieldDemo extends UiApplication{ public static void main(String[] args) { AutoTextEditFieldDemo theApp = new AutoTextEditFieldDemo(); theApp.enterEventDispatcher(); } public AutoTextEditFieldDemo() { pushScreen(new AutoTextEditFieldDemoScreen()); }}class AutoTextEditFieldDemoScreen extends MainScreen{ public AutoTextEditFieldDemoScreen() { setTitle("AutoText Edit Field Demo"); AutoTextEditField myField = new AutoTextEditField("Description: ", "");

Guía de referencia rápida Campo de edición de texto automático

13

add(myField); }}

Campo de edición de texto automático activoUtilice un campo de edición de texto automático activo para buscar los patrones de texto que el usuario de undispositivo BlackBerry® introduce en el campo. Cuando se encuentra un patrón, el texto pasa a ser activo y el usuariopuede hacer clic en el mismo para acceder a elementos de menú especiales. Por ejemplo, las direcciones de correoy los números de teléfono son dos de los patrones que se reconocen de forma predeterminada.

Además, cuando el usuario pulsa la tecla Espacio, el texto se corrige a partir de la lista de definiciones de textoautomático, que incluye los errores tipográficos y las correcciones más comunes.

Clases ActiveAutoTextEditFieldCompatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información acerca de los campos de texto activo con la función Autocompletar, consulte lasDirectrices sobre IU.

Ejemplo de código: crear un campo de edición de texto automático activo

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.ActiveAutoTextEditField;public class ActiveAutoTextEditFieldDemo extends UiApplication{ public static void main(String[] args) { ActiveAutoTextEditFieldDemo theApp = new ActiveAutoTextEditFieldDemo(); theApp.enterEventDispatcher(); } public ActiveAutoTextEditFieldDemo() { pushScreen(new ActiveAutoTextEditFieldDemoScreen()); }}class ActiveAutoTextEditFieldDemoScreen extends MainScreen{

Guía de referencia rápida Campo de edición de texto automático activo

14

public ActiveAutoTextEditFieldDemoScreen() { setTitle("Active AutoText Edit Field Demo"); ActiveAutoTextEditField myField = new ActiveAutoTextEditField("Send a message to Mike: \n \n", ""); add(myField); }}

Guía de referencia rápida Campo de edición de texto automático activo

15

Campos de selección 2

Casilla de verificación.Utilice las casillas de verificación para seleccionar las opciones que los usuarios del dispositivo BlackBerry® puedenactivar o desactivar. Los usuarios pueden activar cualquier número de casillas de verificación en un grupo.

Clase CheckboxFieldCompatible desde BlackBerry® Java® SDK 3.7Ejemplo

Para obtener más información acerca de las casillas de verificación, consulte las Directrices sobre IU.

Ejemplo de código: crear una casilla de verificación

import net.rim.device.api.ui.Field;import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.component.LabelField;import net.rim.device.api.ui.component.CheckboxField;public class CheckboxFieldDemo extends UiApplication{ public static void main(String[] args) { CheckboxFieldDemo theApp = new CheckboxFieldDemo(); theApp.enterEventDispatcher(); } public CheckboxFieldDemo() { pushScreen(new CheckboxFieldDemoScreen()); }}class CheckboxFieldDemoScreen extends MainScreen{ public CheckboxFieldDemoScreen() { LabelField title = new LabelField("Check Box Demo",

Guía de referencia rápida Campos de selección

16

LabelField.ELLIPSIS | LabelField.USE_ALL_WIDTH); setTitle(title); CheckboxField checkBox1 = new CheckboxField("Ignore Case", true); CheckboxField checkBox2 = new CheckboxField("Ignore Acronyms", false); add(checkBox1); add(checkBox2); }}

Lista desplegable basada en textoUtilice una lista desplegable basada en texto para obtener las opciones basadas en texto que los usuarios deldispositivo BlackBerry® pueden seleccionar de una lista. Los usuarios pueden seleccionar únicamente una opción ala vez.

Clase ObjectChoiceFieldCompatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información acerca de las listas desplegables basadas en texto, consulte las Directrices sobre IU.

Ejemplo de código: crear una lista desplegable basada en texto.

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;public class TextDropdownListDemo extends UiApplication { public static void main(String[] args) { TextDropdownListDemo theApp = new TextDropdownListDemo(); theApp.enterEventDispatcher(); } public TextDropdownListDemo() { pushScreen(new TextDropdownListDemoScreen()); } }

Guía de referencia rápida Lista desplegable basada en texto

17

class TextDropdownListDemoScreen extends MainScreen { public TextDropdownListDemoScreen() { setTitle("Drop-down List Demo"); String choices[] = {"Monday","Tuesday","Wednesday","Thursday","Friday","Satu rday","Sunday"}; int iSetTo = 2; add(new ObjectChoiceField("Day of the week",choices,iSetTo)); }}

Lista desplegable numéricaUtilice una lista desplegable numérica para obtener las opciones numéricas que los usuarios del dispositivoBlackBerry® pueden seleccionar de una lista. Los usuarios pueden seleccionar únicamente una opción a la vez.

Clase NumericChoiceFieldCompatible desde BlackBerry® Java® SDK 3.6Ejemplo

Para obtener más información acerca de las listas desplegables numéricas, consulte las Directrices sobre IU.

Ejemplo de código: crear una lista desplegable numérica

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;public class NumericDropdownListDemo extends UiApplication { public static void main(String[] args) { NumericDropdownListDemo theApp = new NumericDropdownListDemo(); theApp.enterEventDispatcher(); } public NumericDropdownListDemo() { pushScreen(new NumericDropdownListDemoScreen());

Guía de referencia rápida Lista desplegable numérica

18

} }class NumericDropdownListDemoScreen extends MainScreen { public NumericDropdownListDemoScreen() { setTitle("Drop-down List Demo"); int iStartAt = 1; int iEndAt = 31; int iIncrement = 1; int iSetTo = 10; add(new NumericChoiceField("Day of the month",iStartAt,iEndAt,iIncrement,iSetTo-1)); }}

Campo de fechaUtilice un campo de fecha para mostrar la fecha y la hora.

Clase DateFieldCompatible desde BlackBerry® Java® SDK 3.6Ejemplo

Para obtener más información acerca de los campos de fecha, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de fecha

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;public class DateFieldDemo extends UiApplication { public static void main(String[] args) { DateFieldDemo theApp = new DateFieldDemo(); theApp.enterEventDispatcher(); }

Guía de referencia rápida Campo de fecha

19

public DateFieldDemo() { pushScreen(new DateFieldDemoScreen()); } }class DateFieldDemoScreen extends MainScreen { public DateFieldDemoScreen() { setTitle("Date Field Demo"); add(new DateField("Date and Time: ", System.currentTimeMillis(), DateField.DATE_TIME)); }}

Colector de fechasUtilice un colector de fechas para permitir que los usuarios del dispositivo BlackBerry® puedan seleccionar una fechay hora.

Clase DateTimePickerCompatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información sobre los colectores de fecha y hora, consulte las Directrices sobre IU.

Ejemplo de código: crear un colector de fechas

import net.rim.device.api.ui.*;import net.rim.device.api.ui.picker.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.database.*;import net.rim.device.api.io.*;import java.util.*;public class DatePickerDemo extends UiApplication{ public static void main(String[] args)

Guía de referencia rápida Colector de fechas

20

{ DatePickerDemo theApp = new DatePickerDemo(); theApp.enterEventDispatcher(); } public DatePickerDemo() { pushScreen(new DatePickerDemoScreen()); }}class DatePickerDemoScreen extends MainScreen{ public DatePickerDemoScreen() { setTitle("Date picker demo"); add(new RichTextField("Trying Date Picker")); UiApplication.getUiApplication().invokeLater(new Runnable() { public void run() { DateTimePicker datePicker = DateTimePicker.createInstance(); datePicker.doModal(); } }); }}

Colector de archivosUtilice un colector de archivos para permitir que los usuarios del dispositivo BlackBerry® seleccionen un archivo deldispositivo BlackBerry.

Clase FilePickerCompatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información acerca de los colectores de archivos, consulte las Directrices sobre IU.

Ejemplo de código: crear un colector de archivos

Guía de referencia rápida Colector de archivos

21

import net.rim.device.api.ui.*;import net.rim.device.api.ui.picker.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.io.*;public class FilePickerDemo extends UiApplication{ public static void main(String[] args) { FilePickerDemo theApp = new FilePickerDemo(); theApp.enterEventDispatcher(); } public FilePickerDemo() { pushScreen(new FilePickerDemoScreen()); }}class FilePickerDemoScreen extends MainScreen{ public FilePickerDemoScreen() { setTitle("File Picker Demo"); add(new LabelField("Trying file picker")); UiApplication.getUiApplication().invokeLater(new Runnable() { public void run() { FilePicker fp = FilePicker.getInstance(); FilePickListener fileListener = new FilePickListener(); fp.setListener(fileListener); fp.show(); } }); }}class FilePickListener implements FilePicker.Listener { public void selectionDone(String str) { Dialog.alert("You selected " + str); }}

Casilla de selección numéricaUtilice una casilla de selección numérica para obtener los elementos que los usuarios del dispositivo BlackBerry®pueden seleccionar de una lista ordenada.

Clase TextSpinBoxFieldCompatible desde BlackBerry® Java® SDK 5.0

Guía de referencia rápida Casilla de selección numérica

22

Ejemplo

Para obtener más información acerca de las casillas de selección numérica, consulte las Directrices sobre IU.

Ejemplo de código: crear una casilla de selección numérica

import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.ui.container.SpinBoxFieldManager;import net.rim.device.api.ui.component.Dialog;import net.rim.device.api.ui.component.TextSpinBoxField;public class SpinBoxDemo extends UiApplication { public static void main(String[] args) { SpinBoxDemo theApp = new SpinBoxDemo(); theApp.enterEventDispatcher(); } public SpinBoxDemo() { pushScreen(new SpinBoxDemoScreen()); }}class SpinBoxDemoScreen extends MainScreen{ TextSpinBoxField spinBoxDays; TextSpinBoxField spinBoxMonths; SpinBoxFieldManager spinBoxMgr; public SpinBoxDemoScreen() { setTitle("Spin Box Demo"); final String[] DAYS = {"Monday","Tuesday","Wednesday","Thursday","Friday","Saturday","Sunday"}; final String[] MONTHS = {"January","February","March","April","May","June","July","August","September", "October","November","December"}; spinBoxMgr = new SpinBoxFieldManager(); spinBoxMgr.setVisibleRows(3); spinBoxDays = new TextSpinBoxField(DAYS); spinBoxMonths = new TextSpinBoxField(MONTHS); spinBoxMgr.add(spinBoxDays); spinBoxMgr.add(spinBoxMonths);

Guía de referencia rápida Casilla de selección numérica

23

add(spinBoxMgr); } public void close() { Dialog.alert("You selected " + (String)spinBoxDays.get(spinBoxDays.getSelectedIndex()) + " and " + (String)spinBoxMonths.get(spinBoxMonths.getSelectedIndex())); super.close(); }}

Colector de ubicaciónUtilice un colector de ubicación para permitir que los usuarios del dispositivo BlackBerry® puedan seleccionar unaubicación de una lista de opciones que defina.

Clase LocationPickerCompatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información acerca de los colectores de ubicación, consulte las Directrices de IU.

Ejemplo de código: crear un colector de ubicación

import net.rim.blackberry.api.invoke.*;import net.rim.device.api.gps.*;import net.rim.device.api.lbs.picker.*;import net.rim.device.api.ui.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.ui.component.*;import javax.microedition.location.*;import java.util.Enumeration;public class LocationPickerApp extends UiApplication{ public static void main(String[] args) { LocationPickerApp app = new LocationPickerApp(); app.enterEventDispatcher(); } public LocationPickerApp() {

Guía de referencia rápida Colector de ubicación

24

pushScreen(new LocationPickerAppScreen()); } static class LocationPickerAppScreen extends MainScreen implements LocationPicker.Listener, FieldChangeListener { private LocationPicker _locationPicker; private ButtonField _buttonField; private LabelField _nameLabel; private LabelField _descLabel; private LabelField _coordLabel; private boolean _mapsPresent = false; LocationPickerAppScreen() { setTitle("Location Picker Demo"); _buttonField = new ButtonField("Choose location", ButtonField.NEVER_DIRTY); _buttonField.setChangeListener(this); add(_buttonField); _nameLabel = new LabelField(); _descLabel = new LabelField(); _coordLabel = new LabelField(); add(_nameLabel); add(_descLabel); add(_coordLabel); Landmark[] landmarks = new Landmark[] {new Landmark("New York", "Times Square", new QualifiedCoordinates(40.757682, -73.98571, Float.NaN, Float.NaN, Float.NaN), null), new Landmark("New York","Central Park", new QualifiedCoordinates(40.783333, -73.966667, Float.NaN, Float.NaN, Float.NaN), null)}; int arraySize = 7; LocationPicker.Picker mapsLocationPicker = null; try { mapsLocationPicker = MapsLocationPicker.getInstance(); _mapsPresent = true; } catch(IllegalStateException ise) { arraySize--; } boolean gpsSupported = GPSInfo.getGPSDataSource() != null; if(!gpsSupported) { arraySize--; } LocationPicker.Picker[] locationPickersArray = new LocationPicker.Picker[arraySize]; locationPickersArray[--arraySize] = EnterLocationPicker.getInstance(false); locationPickersArray[--arraySize] = SuggestedLocationPicker.getInstance("App specific...", landmarks ); locationPickersArray[--arraySize] = RecentLocationPicker.getInstance(); locationPickersArray[--arraySize] = ContactsLocationPicker.getInstance(false); locationPickersArray[--arraySize] = GeotaggedPhotoPicker.getInstance();

Guía de referencia rápida Colector de ubicación

25

if(_mapsPresent) { locationPickersArray[--arraySize] = mapsLocationPicker; } if(gpsSupported) { locationPickersArray[--arraySize] = GPSLocationPicker.getInstance(); } _locationPicker = LocationPicker.getInstance(locationPickersArray); Enumeration globalPickers = _locationPicker.getGlobalLocationPickers(); while (globalPickers.hasMoreElements()) { _locationPicker.addLocationPicker((LocationPicker .Picker)globalPickers.nextElement()); } _locationPicker.setListener(this); } public void locationPicked (LocationPicker.Picker picker, Landmark location) { if(location != null) { _nameLabel.setText("Location name: " + location.getName()); _descLabel.setText("Description: " + location.getDescription()); QualifiedCoordinates coordinates = location.getQualifiedCoordinates(); if(coordinates != null) { StringBuffer buff = new StringBuffer("Coordinates: "); double latitude = coordinates.getLatitude(); double longitude = coordinates.getLongitude(); buff.append("Latitude:"); buff.append(latitude); buff.append(", Longitude: "); buff.append(longitude); _coordLabel.setText(buff.toString()); } if(_mapsPresent) { Landmark[] landmark = {location}; MapsArguments mapsArgs = new MapsArguments(landmark); Invoke.invokeApplication(Invoke.APP_TYPE_MAPS, mapsArgs); } } } public void fieldChanged(Field field, int context) { if(field == _buttonField) { _locationPicker.show(); } } }}

Guía de referencia rápida Colector de ubicación

26

Campo de árbolUtilice un campo de árbol para mostrar los componentes en una estructura jerárquica. Puede configurar los nodosde campo de árbol para que se puedan contraer.

Clase TreeFieldCompatible desde BlackBerry® Java® SDK 3.7Ejemplo

Para obtener más información acerca de los campos de árbol, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de árbol

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;public class TreefieldDemo extends UiApplication{ public static void main(String[] args) { TreefieldDemo theApp = new TreefieldDemo(); theApp.enterEventDispatcher(); } public TreefieldDemo() { pushScreen(new TreefieldDemoScreen()); } }class TreefieldDemoScreen extends MainScreen{ public TreefieldDemoScreen() { setTitle("Tree Field Demo"); String fieldOne = new String("Parent folder 1"); String fieldTwo = new String("Parent folder 2"); String fieldThree = new String("Sub-folder 1"); String fieldFour = new String("Sub-folder 2"); TreeCallback myCallback = new TreeCallback();

Guía de referencia rápida Campo de árbol

27

TreeField myTree = new TreeField(myCallback, Field.FOCUSABLE); int node1 = myTree.addChildNode(0, fieldOne); int node2 = myTree.addChildNode(0, fieldTwo); int node3 = myTree.addChildNode(node2, fieldThree); int node4 = myTree.addChildNode(node3, fieldFour); myTree.setExpanded(node4, false); add(myTree); } private class TreeCallback implements TreeFieldCallback { public void drawTreeItem(TreeField _tree, Graphics g, int node, int y, int width, int indent) { String text = (String)_tree.getCookie(node); g.drawText(text, indent, y); } }}

Guía de referencia rápida Campo de árbol

28

Botones 3

Botón de opciónUtilice los botones de opción para obtener las opciones que los usuarios del dispositivo BlackBerry® puedenseleccionar de un conjunto. Los usuarios sólo pueden seleccionar una opción de cada conjunto de botones de opción.

Clase RadioButtonGroup, RadioButtonFieldCompatible desde BlackBerry® Java® SDK 3.6Ejemplo

Para obtener más información acerca de los botones de opción, consulte las Directrices sobre IU.

Ejemplo de código: crear un botón de opción

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;public class RadioButtonDemo extends UiApplication { public static void main(String[] args) { RadioButtonDemo theApp = new RadioButtonDemo(); theApp.enterEventDispatcher(); } public RadioButtonDemo() { pushScreen(new RadioButtonDemoScreen()); } }class RadioButtonDemoScreen extends MainScreen { public RadioButtonDemoScreen() { setTitle("Radio Button Demo"); RadioButtonGroup rbg = new RadioButtonGroup(); add(new RadioButtonField("Option 1",rbg,true));

Guía de referencia rápida Botones

29

add(new RadioButtonField("Option 2",rbg,false)); }}

Barra de herramientasLas barras de herramientas ofrecen al usuario una manera rápida y fácil de acceder a las acciones frecuentes de unaaplicación o pantalla. Cada barra de herramientas consiste en un conjunto de iconos que aparecen situados en laparte inferior de la pantalla.

Sólo los smartphones de BlackBerry® Storm™ Series y los smartphones BlackBerry® Torch™ 9800 utilizan barras deherramientas.

Paquete Barra de herramientasCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de las barras de herramientas, consulte las Directrices sobre IU.

Código de ejemplo: crear una barra de herramientas

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.ui.image.*;import net.rim.device.api.ui.toolbar.*;import net.rim.device.api.util.*;import net.rim.device.api.system.*;import net.rim.device.api.command.*;public class ToolbarDemo extends UiApplication{ public static void main(String[] args) { ToolbarDemo theApp = new ToolbarDemo(); theApp.enterEventDispatcher(); } public ToolbarDemo()

Guía de referencia rápida Barra de herramientas

30

{ // Push a screen onto the UI stack for rendering. pushScreen(new ToolbarDemoScreen()); } private final static class ToolbarDemoScreen extends MainScreen { public ToolbarDemoScreen() { if (ToolbarManager.isToolbarSupported()) { setTitle("Toolbar Demo"); ToolbarManager manager = new ToolbarManager(); setToolbar(manager); try { Bitmap myBitmap = Bitmap.getBitmapResource("myImg.jpg"); Image myImage = ImageFactory.createImage(myBitmap); /* * To create more buttons, Repeat the following lines * up until manager.add() */ ToolbarButtonField button1 = new ToolbarButtonField(myImage, new StringProvider("butn1")); button1.setCommandContext(new Object() { public String toString() { return "Button1"; } }); button1.setCommand(new Command(new CommandHandler() { public void execute(ReadOnlyCommandMetadata metadata, Object context) { Dialog.alert("Executing command for " + context.toString()); } })); manager.add(new ToolbarSpacer(0)); manager.add(button1); } catch (Exception e) { System.out.println(e.getMessage()); } } else { Dialog.alert("The Toolbar is not supported on this device."); } } }}

Guía de referencia rápida Barra de herramientas

31

BotónUtilice un botón para permitir que los usuarios del dispositivo BlackBerry® realicen una acción cuando hagan clic enel botón.

Clase ButtonFieldCompatible desde BlackBerry® Java® SDK 4.0Ejemplo

Para obtener más información acerca de los botones, consulte las Directrices sobre IU.

Para obtener información acerca de los botones avanzados, lea el artículo de la base de conocimientos sobre cómoimplementar botones avanzados, campos y administradores.

Ejemplo de código: crear un botón

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.container.*;public class ButtonFieldDemo extends UiApplication{ public static void main(String[] args) { ButtonFieldDemo theApp = new ButtonFieldDemo(); theApp.enterEventDispatcher(); } public ButtonFieldDemo() { pushScreen(new ButtonFieldDemoScreen()); }}class ButtonFieldDemoScreen extends MainScreen { public ButtonFieldDemoScreen() { setTitle("Button Field Demo"); ButtonField addButton = new ButtonField("Add"); ButtonField delButton = new ButtonField("Delete");

Guía de referencia rápida Botón

32

add(addButton); add(delButton); }}

Guía de referencia rápida Botón

33

Campos de actividad 4

Campo de evaluaciónUtilice un campo de evaluación para crear una barra horizontal que muestre un indicador de progreso o un valornumérico.

Clase GaugeFieldCompatible desde BlackBerry® Java® SDK 4.2Ejemplo

Para obtener más información acerca de los campos de evaluación, consulte las Directrices sobre IU.

Ejemplo de código: crear un campo de evaluación.

import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.GaugeField;import net.rim.device.api.ui.container.*;public class GaugeFieldDemo extends UiApplication { public static void main(String[] args) { GaugeFieldDemo theApp = new GaugeFieldDemo(); theApp.enterEventDispatcher(); } public GaugeFieldDemo() { pushScreen(new GaugeFieldDemoScreen()); } }class GaugeFieldDemoScreen extends MainScreen{ public GaugeFieldDemoScreen () { setTitle("Gauge Field Demo"); GaugeField percentGauge = new GaugeField("Percent: ", 1, 100, 29, GaugeField.PERCENT);

Guía de referencia rápida Campos de actividad

34

add(percentGauge); }}

Indicador de actividadUtilice un indicador de actividad para mostrar una pista visual que indique que una tarea de duración desconocidaestá en progreso. Si puede calcular la duración de la tarea, puede utilizar en su lugar un indicador de progreso.

Clase ActivityImageFieldCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de los indicadores de actividad, consulte las Directrices de IU.

Ejemplo de código: crear un indicador de actividad

import net.rim.device.api.system.Bitmap;import net.rim.device.api.ui.*;import net.rim.device.api.ui.component.progressindicator.*;import net.rim.device.api.ui.container.*;public class ActivityIndicatorDemo extends UiApplication { public static void main(String[] args) { ActivityIndicatorDemo theApp = new ActivityIndicatorDemo(); theApp.enterEventDispatcher(); } public ActivityIndicatorDemo() { pushScreen(new ActivityIndicatorDemoScreen()); } }class ActivityIndicatorDemoScreen extends MainScreen{ ActivityIndicatorView view = new ActivityIndicatorView(Field.USE_ALL_WIDTH); ActivityIndicatorModel model = new ActivityIndicatorModel(); ActivityIndicatorController controller = new ActivityIndicatorController();

Guía de referencia rápida Indicador de actividad

35

public ActivityIndicatorDemoScreen () { setTitle("Activity Indicator Demo"); view.setController(controller); view.setModel(model); controller.setModel(model); controller.setView(view); model.setController(controller); Bitmap bitmap = Bitmap.getBitmapResource("spinner.png"); view.createActivityImageField(bitmap, 5, Field.FIELD_HCENTER); add(view); }}

Indicador de progresoUtilice un indicador de progreso para mostrar una pista visual que indique que una tarea cuya duración se puedecalcular está en progreso. Si no puede calcular la duración de una tarea, puede utilizar un indicador de actividad.

Clase ProgressBarFieldCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de los indicadores de progreso, consulte las Directrices sobre IU.

Ejemplo de código: crear un indicador de progreso

import net.rim.device.api.ui.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.ui.component.progressindicator.*;public class ProgressIndicatorDemo extends UiApplication{ public static void main(String[] args) { ProgressIndicatorDemo theApp = new ProgressIndicatorDemo(); theApp.enterEventDispatcher(); } public ProgressIndicatorDemo()

Guía de referencia rápida Indicador de progreso

36

{ pushScreen(new ProgressIndicatorDemoScreen()); } }class ProgressIndicatorDemoScreen extends MainScreen{ ProgressIndicatorView view = new ProgressIndicatorView(0); ProgressIndicatorModel model = new ProgressIndicatorModel(0, 100, 0); ProgressIndicatorController controller = new ProgressIndicatorController(); ProgressThread _progressThread; public ProgressIndicatorDemoScreen() { setTitle("Progress Indicator Demo"); model.setController(controller); view.setModel(model); view.setController(controller); controller.setModel(model); controller.setView(view); view.setLabel("Percent completion"); view.createProgressBar(Field.FIELD_HCENTER); add(view); _progressThread = new ProgressThread(); _progressThread.start(); } // A thread that simulates the processing of data class ProgressThread extends Thread { public void run() { for(int i = 0; i <= 100; ++i) { ProgressIndicatorDemoScreen.this.model.setValue(i); try { // Simulate work sleep(250); } catch(InterruptedException ie) { } } } } }

Guía de referencia rápida Indicador de progreso

37

Campos de imagen 5

Campo de mapa de bitsUtilice un campo de mapa de bits para mostrar imágenes de mapa de bits que el usuario de un dispositivo BlackBerry®puede visualizar.

Clase BitmapFieldCompatible desde BlackBerry® Java® SDK 3.7Ejemplo

Para obtener más información acerca de los campos de mapa de bits, consulte la Guía de desarrollo multimedia.

Ejemplo de código: crear un campo de mapa de bits

import net.rim.device.api.system.Bitmap;import net.rim.device.api.ui.UiApplication;import net.rim.device.api.ui.component.BitmapField;import net.rim.device.api.ui.container.MainScreen;public class BitmapFieldDemo extends UiApplication { public static void main(String[] args) { BitmapFieldDemo theApp = new BitmapFieldDemo(); theApp.enterEventDispatcher(); } public BitmapFieldDemo() { pushScreen(new BitmapFieldDemoScreen()); } }class BitmapFieldDemoScreen extends MainScreen{ public BitmapFieldDemoScreen () { setTitle("Bitmap Field Demo"); Bitmap bitmapImage = Bitmap.getBitmapResource("BlackBerry_Data_Stream.jpg");

Guía de referencia rápida Campos de imagen

38

BitmapField fieldDemo = new BitmapField(bitmapImage); add(fieldDemo); }}

Campo de desplazamiento de imágenesUtilice un campo de desplazamiento de imágenes para mostrar una fila de imágenes por las que el usuario deldispositivo BlackBerry® puede desplazarse horizontalmente.

Clase PictureScrollFieldCompatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información acerca de los campos de desplazamiento de imágenes, consulte las Directrices de IU.

Ejemplo de código: crear un campo de desplazamiento de imágenes

import net.rim.device.api.system.*;import net.rim.device.api.ui.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.ui.decor.*; import net.rim.device.api.ui.extension.component.*;import net.rim.device.api.ui.extension.component.PictureScrollField.*;public class PictureScrollFieldDemo extends UiApplication{ public static void main(String[] args) { PictureScrollFieldDemo theApp = new PictureScrollFieldDemo(); theApp.enterEventDispatcher(); } public PictureScrollFieldDemo() { pushScreen(new PictureScrollFieldDemoScreen()); } }class PictureScrollFieldDemoScreen extends MainScreen{

Guía de referencia rápida Campo de desplazamiento de imágenes

39

public PictureScrollFieldDemoScreen() { setTitle("Picture Scroll Field Demo"); Bitmap[] images = new Bitmap[3]; String[] labels = new String[3]; String[] tooltips = new String[3]; images[0] = Bitmap.getBitmapResource("image1.jpg"); labels[0] = "Label for image 1"; tooltips[0] = "Tooltip for image 1"; images[1] = Bitmap.getBitmapResource("image2.jpg"); labels[1] = "Label for image 2"; tooltips[1] = "Tooltip for image 2"; images[2] = Bitmap.getBitmapResource("image3.jpg"); labels[2] = "Label for image 2"; tooltips[2] = "Tooltip for image 2"; ScrollEntry[] entries = new ScrollEntry[3]; for (int i = 0; i < entries.length; i++) { entries[i] = new ScrollEntry(images[i], labels[i],tooltips[i]); } PictureScrollField pictureScrollField = new PictureScrollField(150, 100); pictureScrollField.setData(entries, 0); pictureScrollField.setHighlightStyle(HighlightStyle .ILLUMINATE_WITH_SHRINK_LENS); pictureScrollField.setHighlightBorderColor(Color.BLUE); pictureScrollField.setBackground(BackgroundFactory .createSolidTransparentBackground(Color.BLACK, 150)); pictureScrollField.setLabelsVisible(true); add(pictureScrollField); }}

Guía de referencia rápida Campo de desplazamiento de imágenes

40

Listas y tablas 6

Lista sencillaUtilice una lista sencilla para mostrar una lista de elementos como texto.

Clase SimpleListCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de las listas sencillas, consulte las Directrices sobre IU.

Ejemplo de código: crear una lista sencilla

import net.rim.device.api.ui.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.component.table.*;public class SimpleListDemo extends UiApplication{ public static void main(String[] args) { SimpleListDemo theApp = new SimpleListDemo(); theApp.enterEventDispatcher(); } public SimpleListDemo() { pushScreen(new SimpleListScreen()); } private static final class SimpleListScreen extends MainScreen { public SimpleListScreen() { super(Manager.NO_VERTICAL_SCROLL); setTitle("Simple List Demo"); add(new LabelField("My list", LabelField.FIELD_HCENTER)); add(new SeparatorField()); Manager mainManager = getMainManager();

Guía de referencia rápida Listas y tablas

41

SimpleList listField = new SimpleList(mainManager); listField.add("Item 1"); listField.add("Item 2"); listField.add("Item 3"); } }}

Lista enriquecidaUtilice una lista enriquecida para mostrar una lista de elementos que contenga una imagen opcional a la izquierda,una lista de etiquetas junto a la imagen y una descripción opcional situada debajo de la imagen y de las etiquetas.

Clase RichListCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de las listas enriquecidas, consulte las Directrices de IU.

Ejemplo de código: crear una lista enriquecida

import net.rim.device.api.ui.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.system.*;import net.rim.device.api.ui.component.table.*;public class RichListDemo extends UiApplication{ public static void main(String[] args) { RichListDemo theApp = new RichListDemo(); theApp.enterEventDispatcher(); } public RichListDemo() { pushScreen(new RichListScreen()); } private static class RichListScreen extends MainScreen

Guía de referencia rápida Lista enriquecida

42

{ public RichListScreen() { super(Manager.NO_VERTICAL_SCROLL); setTitle("Rich List Demo"); add(new LabelField("BlackBerry Devices", LabelField.FIELD_HCENTER)); add(new SeparatorField()); Manager mainManager = getMainManager(); RichList list = new RichList(mainManager, true, 2, 1); Bitmap bitmap1 = Bitmap.getBitmapResource("9500.png"); Bitmap bitmap2 = Bitmap.getBitmapResource("9000.png"); list.add(new Object[] {bitmap1, "Device 1", "BlackBerry Smartphone 9500", "Description of Device 1."}); list.add(new Object[] {bitmap2, "Device 2", "BlackBerry Smartphome 9000", "Description of Device 2."}); } }}

TablaUtilice un modelo de tabla para almacenar y mostrar datos en una tabla.

Clase TableModelCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de las tablas, incluidas las tablas ordenadas cuyos elementos aparecenagrupados bajo encabezados, consulte las Directrices sobre IU.

Ejemplo de código: crear una tabla

import net.rim.device.api.ui.*;import net.rim.device.api.ui.container.*;import net.rim.device.api.ui.component.*;import net.rim.device.api.ui.decor.*;import net.rim.device.api.system.*;import net.rim.device.api.ui.component.table.*;

Guía de referencia rápida Tabla

43

public class TableModelDemo extends UiApplication{ public static void main(String[] args) { UiApplication app = new TableModelDemo(); app.enterEventDispatcher(); } public TableModelDemo() { pushScreen(new TableModelDemoScreen()); } }class TableModelDemoScreen extends MainScreen{ private RegionStyles _style; private TableModel _tableModel; private TableView _tableView; private TableController _controller; private static final int NUM_ROWS = 4; private static final int NUM_COLUMNS = 3; private static final int IMAGE_WIDTH = 50; private String modelNum[] = {"8100", "8220", "8300", "8330", "8700g", "8800", "9000", "9500"}; private String modelName[] = {"Pearl", "Pearl Flip", "Curve", "Curve", "8700g", "8800", "Bold", "Storm"}; private String osVersion[] = {"4.3", "4.6", "4.5", "4.6", "4.1", "4.2.1", "4.6", "4.7"}; private String deviceYear[] = {"2006", "2008", "2008", "2008", "2005","2007", "2008", "2008"}; private String deviceInterface[] = {"keyboard/trackball", "keyboard/trackball", "keyboard/trackball", "keyboard/trackball", "keyboard", "keyboard/trackball", "keyboard/trackball", "keyboard/trackball/touch"}; public TableModelDemoScreen() { super(Manager.NO_VERTICAL_SCROLL); setTitle("Table Model Demo"); _style = new RegionStyles(BorderFactory.createSimpleBorder(new XYEdges(1, 1, 1, 1), Border.STYLE_SOLID), null, null, null, RegionStyles.ALIGN_LEFT, RegionStyles.ALIGN_MIDDLE); _tableModel = new TableModel(); _tableView = new TableView(_tableModel); _tableView.setDataTemplateFocus(BackgroundFactory .createLinearGradientBackground(Color.WHITE, Color.WHITE, Color.BLUEVIOLET, Color.BLUEVIOLET)); _controller = new TableController(_tableModel, _tableView); _tableView.setController(_controller); setStyle(); add(new LabelField("BlackBerry Devices", LabelField.FIELD_HCENTER)); add(new SeparatorField()); add(_tableView); for(int i = 0; i < modelName.length; i++) { String imageFileName = modelNum[i] + ".png"; Bitmap bitmap = Bitmap.getBitmapResource(imageFileName);

Guía de referencia rápida Tabla

44

StringBuffer displayName = new StringBuffer(modelNum[i]); if(!modelName[i].equals(modelNum[i])) { displayName.append(" ("); displayName.append(modelName[i]); displayName.append(")"); } _tableModel.addRow(new Object[] {bitmap, displayName.toString(), osVersion[i], deviceYear[i], deviceInterface[i]}); } } public void setStyle() { DataTemplate dataTemplate = new DataTemplate(_tableView, NUM_ROWS, NUM_COLUMNS) { public Field[] getDataFields(int modelRowIndex) { Object[] data = (Object[]) _tableModel.getRow(modelRowIndex); Field[] fields = new Field[data.length]; for(int i = 0; i < data.length; i++) { if(data[i] instanceof Bitmap) { fields[i] = new BitmapField((Bitmap) data[i]); } else if(data[i] instanceof String) { fields[i] = new LabelField(data[i], Field.FOCUSABLE); } else { fields[i] = (Field) data[i]; } } return fields; } }; dataTemplate.createRegion(new XYRect(0, 1, 1, 3), _style); dataTemplate.createRegion(new XYRect(0, 0, 2, 1), _style); dataTemplate.setRowProperties(0, new TemplateRowProperties(Font.getDefault().getHeight() + (_style.getBorder() == null ? 0 : _style.getBorder().getTop() + _style.getBorder().getBottom()) + (_style.getMargin() == null ? 0 : _style.getMargin().top + _style.getMargin().bottom))); for(int i = 1; i < NUM_ROWS; i++) { dataTemplate.createRegion(new XYRect(1, i, 1, 1), _style); dataTemplate.setRowProperties(i, new TemplateRowProperties(Font.getDefault().getHeight() + (_style.getBorder() == null ? 0 : _style.getBorder().getTop() + _style.getBorder().getBottom()) + (_style.getMargin() == null ? 0 : _style.getMargin().top + _style.getMargin().bottom))); }

Guía de referencia rápida Tabla

45

int width = IMAGE_WIDTH + (_style.getBorder() == null ? 0 : _style.getBorder().getTop() + _style.getBorder().getBottom()) + (_style.getMargin() == null ? 0 : _style.getMargin().top + _style.getMargin().bottom); dataTemplate.setColumnProperties(0, new TemplateColumnProperties(width)); dataTemplate.setColumnProperties(1, new TemplateColumnProperties(Display.getWidth() - width)); _tableView.setDataTemplate(dataTemplate); dataTemplate.useFixedHeight(true); }}

Guía de referencia rápida Tabla

46

Otros componentes 7

Campo de navegadorUtilice un campo de navegador para mostrar contenido Web en una aplicación del dispositivo BlackBerry®.

Clase BrowserFieldCompatible desde BlackBerry® Java® SDK 5.0Ejemplo

Para obtener más información acerca de los campos de navegador, consulte la Guía de desarrollo de interfaz deusuario y navegación.

Ejemplo de código: configurar un campo de navegador

import net.rim.device.api.browser.field2.*;import net.rim.device.api.ui.*;import net.rim.device.api.ui.container.*;public class BrowserFieldDemo extends UiApplication{ public static void main(String[] args) { BrowserFieldDemo app = new BrowserFieldDemo(); app.enterEventDispatcher(); } public BrowserFieldDemo() { pushScreen(new BrowserFieldDemoScreen()); }}class BrowserFieldDemoScreen extends MainScreen{ public BrowserFieldDemoScreen() { BrowserFieldConfig myBrowserFieldConfig = new BrowserFieldConfig(); myBrowserFieldConfig.setProperty(BrowserFieldConfig .NAVIGATION_MODE,BrowserFieldConfig.NAVIGATION_MODE_POINTER);

Guía de referencia rápida Otros componentes

47

BrowserField browserField = new BrowserField(myBrowserFieldConfig); add(browserField); browserField.requestContent("http://www.blackberry.com"); }}

Barra de títuloUtilice una barra de título para ofrecer información a los usuarios del dispositivo BlackBerry® en la parte superior dela aplicación. La mayoría de las barras de título contienen sólo un título, pero pueden mostrar los siguienteselementos:

• icono de la aplicación, título descriptivo y hora• notificaciones de la aplicación como, por ejemplo, un indicador de mensaje nuevo• indicadores de conexión inalámbrica, incluidos nivel de cobertura inalámbrica, cobertura de red, indicador de

GPS, indicador de Bluetooth® e indicador de conexión Wi-Fi®.• indicador de batería• indicador de llamada activa

Clase StandardTitleBarCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de las barras de título, consulte las Directrices sobre IU.

Código de ejemplo: crear una barra de título

import net.rim.device.api.ui.*; import net.rim.device.api.ui.component.*; import net.rim.device.api.ui.container.*; public class TitleBarDemo extends UiApplication { public static void main(String[] args) { TitleBarDemo theApp = new TitleBarDemo(); theApp.enterEventDispatcher();

Guía de referencia rápida Barra de título

48

} public TitleBarDemo() { pushScreen(new TitleBarDemoScreen()); } }class TitleBarDemoScreen extends MainScreen{ public TitleBarDemoScreen() { StandardTitleBar myTitleBar = new StandardTitleBar() .addIcon("my_logo.png") .addTitle("Title Bar Demo") .addClock() .addNotifications() .addSignalIndicator(); myTitleBar.setPropertyValue(StandardTitleBar.PROPERTY_BATTERY_VISIBILITY, StandardTitleBar.BATTERY_VISIBLE_LOW_OR_CHARGING); setTitleBar(myTitleBar); }}

Campo de mapaUtilice un campo de mapa para mostrar un mapa en una aplicación del dispositivo BlackBerry®.

Clase MapFieldCompatible desde BlackBerry® Java® SDK 6.0Ejemplo

Para obtener más información acerca de los campos de mapa y los servicios basados en ubicación, consulte la Guíade desarrollo de servicios basados en ubicación.

Ejemplo de código: crear un campo de mapa

import net.rim.device.api.lbs.maps.model.*;import net.rim.device.api.lbs.maps.ui.*;import net.rim.device.api.ui.*;

Guía de referencia rápida Campo de mapa

49

import net.rim.device.api.ui.container.*;public class MapFieldDemo extends UiApplication{ public static void main(String[] args) { MapFieldDemo theApp = new MapFieldDemo(); theApp.enterEventDispatcher(); } public MapFieldDemo() { pushScreen(new MapScreen()); }}class MapScreen extends FullScreen{ public MapScreen() { super( FullScreen.DEFAULT_CLOSE | FullScreen.DEFAULT_MENU ); MapField map = new MapField(); MapAction action = map.getAction(); action.setCentreAndZoom(new MapPoint(43.46518, -80.52237), 3); add(map); }}

Guía de referencia rápida Campo de mapa

50

Comentarios 8Para ofrecer comentarios acerca de esta entrega, visite www.blackberry.com/docsfeedback.

Guía de referencia rápida Comentarios

51

Historial de revisión del documento 9

Fecha Descripción

29 de octubre de 2010 Se agregaron los temas siguientes:

• Campo de edición de texto automático• Campo de edición de texto automático activo• Campo de evaluación• Campo de mapa de bits• Botón• Tabla

4 de octubre de 2010 Se agregaron los temas siguientes:

• Campo de mapa24 de agosto de 2010 Se añadió el tema siguiente:

• Barra de herramientas3 de agosto de 2010 Versión inicial.

Guía de referencia rápida Historial de revisión del documento

52

Aviso legal 10©2011 Research In Motion Limited. Reservados todos los derechos. BlackBerry®, RIM®, Research In Motion® y lasmarcas comerciales, nombres y logotipos relacionados son propiedad de Research In Motion Limited y estánregistrados y/o se usan en EE. UU. y en diferentes países del mundo.

Java es una marca comercial de Oracle America, Inc. Bluetooth® es una marca comercial de Bluetooth SIG. Wi-Fi esuna marca comercial de Wi-Fi Alliance.. Todas las demás marcas comerciales son propiedad de sus respectivospropietarios.

Esta documentación, incluida cualquier documentación que se incorpore mediante referencia como documentoproporcionado o disponible en www.blackberry.com/go/docs se proporciona o se pone a disposición "TAL CUAL" y"SEGÚN SU DISPONIBILIDAD" sin ninguna condición, responsabilidad o garantía de ningún tipo por Research In MotionLimited y sus empresas afiliadas ("RIM") y RIM no asume ninguna responsabilidad por los errores tipográficos,técnicos o cualquier otra imprecisión, error u omisión contenidos en esta documentación. Con el fin de proteger lainformación confidencial y propia de RIM, así como los secretos comerciales, la presente documentación describealgunos aspectos de la tecnología de RIM en líneas generales. RIM se reserva el derecho a modificar periódicamentela información que contiene esta documentación, si bien tampoco se compromete en modo alguno a proporcionarcambios, actualizaciones, ampliaciones o cualquier otro tipo de información que se pueda agregar a estadocumentación.

Esta documentación puede contener referencias a fuentes de información, hardware o software, productos oservicios, incluidos componentes y contenido como, por ejemplo, el contenido protegido por copyright y/o sitiosWeb de terceros (conjuntamente, los "Productos y servicios de terceros"). RIM no controla ni es responsable deningún tipo de Productos y servicios de terceros, incluido, sin restricciones, el contenido, la exactitud, el cumplimientode copyright, la compatibilidad, el rendimiento, la honradez, la legalidad, la decencia, los vínculos o cualquier otroaspecto de los Productos y servicios de terceros. La inclusión de una referencia a los Productos y servicios de tercerosen esta documentación no implica que RIM se haga responsable de dichos Productos y servicios de terceros o dedichos terceros en modo alguno.

EXCEPTO EN LA MEDIDA EN QUE LO PROHÍBA ESPECÍFICAMENTE LA LEY DE SU JURISDICCIÓN, QUEDAN EXCLUIDASPOR LA PRESENTE TODAS LAS CONDICIONES, APROBACIONES O GARANTÍAS DE CUALQUIER TIPO, EXPLÍCITAS OIMPLÍCITAS, INCLUIDA, SIN NINGÚN TIPO DE LIMITACIÓN, CUALQUIER CONDICIÓN, APROBACIÓN, GARANTÍA,DECLARACIÓN DE GARANTÍA DE DURABILIDAD, IDONEIDAD PARA UN FIN O USO DETERMINADO, COMERCIABILIDAD,CALIDAD COMERCIAL, ESTADO DE NO INFRACCIÓN, CALIDAD SATISFACTORIA O TITULARIDAD, O QUE SE DERIVE DEUNA LEY O COSTUMBRE O UN CURSO DE LAS NEGOCIACIONES O USO DEL COMERCIO, O RELACIONADO CON LADOCUMENTACIÓN O SU USO O RENDIMIENTO O NO RENDIMIENTO DE CUALQUIER SOFTWARE, HARDWARE,SERVICIO O CUALQUIER PRODUCTO O SERVICIO DE TERCEROS MENCIONADOS AQUÍ. TAMBIÉN PODRÍA TENER OTROSDERECHOS QUE VARÍAN SEGÚN EL ESTADO O PROVINCIA. ES POSIBLE QUE ALGUNAS JURISDICCIONES NO PERMITANLA EXCLUSIÓN O LA LIMITACIÓN DE GARANTÍAS IMPLÍCITAS Y CONDICIONES. EN LA MEDIDA EN QUE LO PERMITALA LEY, CUALQUIER GARANTÍA IMPLÍCITA O CONDICIONES EN RELACIÓN CON LA DOCUMENTACIÓN NO SE PUEDENEXCLUIR TAL Y COMO SE HA EXPUESTO ANTERIORMENTE, PERO PUEDEN SER LIMITADAS, Y POR LA PRESENTE ESTÁNLIMITADAS A NOVENTA (90) DÍAS DESDE DE LA FECHA QUE ADQUIRIÓ LA DOCUMENTACIÓN O EL ELEMENTO QUEES SUJETO DE LA RECLAMACIÓN.

Guía de referencia rápida Aviso legal

53

EN LA MEDIDA MÁXIMA EN QUE LO PERMITA LA LEY DE SU JURISDICCIÓN, EN NINGÚN CASO RIM ASUMIRÁRESPONSABILIDAD ALGUNA POR CUALQUIER TIPO DE DAÑOS RELACIONADOS CON ESTA DOCUMENTACIÓN O SUUSO, O RENDIMIENTO O NO RENDIMIENTO DE CUALQUIER SOFTWARE, HARDWARE, SERVICIO O PRODUCTOS YSERVICIOS DE TERCEROS AQUÍ MENCIONADOS INCLUIDOS SIN NINGÚN TIPO DE LIMITACIÓN CUALQUIERA DE LOSSIGUIENTES DAÑOS: DIRECTOS, RESULTANTES, EJEMPLARES, INCIDENTALES, INDIRECTOS, ESPECIALES, PUNITIVOSO AGRAVADOS, DAÑOS POR PÉRDIDA DE BENEFICIOS O INGRESOS, IMPOSIBILIDAD DE CONSEGUIR LOS AHORROSESPERADOS, INTERRUPCIÓN DE LA ACTIVIDAD COMERCIAL, PÉRDIDA DE INFORMACIÓN COMERCIAL, PÉRDIDA DELA OPORTUNIDAD DE NEGOCIO O CORRUPCIÓN O PÉRDIDA DE DATOS, IMPOSIBILIDAD DE TRANSMITIR O RECIBIRCUALQUIER DATO, PROBLEMAS ASOCIADOS CON CUALQUIER APLICACIÓN QUE SE UTILICE JUNTO CON PRODUCTOSY SERVICIOS DE RIM, COSTES DEBIDOS AL TIEMPO DE INACTIVIDAD, PÉRDIDA DE USO DE LOS PRODUCTOS Y SERVICIOSDE RIM O PARTE DE ÉL O DE CUALQUIER SERVICIO DE USO, COSTE DE SERVICIOS SUSTITUTIVOS, COSTES DECOBERTURA, INSTALACIONES O SERVICIOS, COSTE DEL CAPITAL O CUALQUIER OTRA PÉRDIDA MONETARIA SIMILAR,TANTO SI DICHOS DAÑOS SE HAN PREVISTO O NO, Y AUNQUE SE HAYA AVISADO A RIM DE LA POSIBILIDAD DE DICHOSDAÑOS.

EN LA MEDIDA MÁXIMA EN QUE LO PERMITA LA LEY DE SU JURISDICCIÓN, RIM NO TENDRÁ NINGÚN OTRO TIPO DEOBLIGACIÓN O RESPONSABILIDAD CONTRACTUAL, EXTRACONTRACTUAL O CUALQUIER OTRA, INCLUIDA CUALQUIERRESPONSABILIDAD POR NEGLIGENCIA O RESPONSABILIDAD ESTRICTA.

LAS LIMITACIONES, EXCLUSIONES Y DESCARGOS DE RESPONSABILIDAD SE APLICARÁN: (A) INDEPENDIENTEMENTEDE LA NATURALEZA DE LA CAUSA DE LA ACCIÓN, DEMANDA O ACCIÓN SUYA, INCLUIDA PERO NO LIMITADA ALINCUMPLIMIENTO DEL CONTRATO, NEGLIGENCIA, AGRAVIO, EXTRACONTRACTUAL, RESPONSABILIDAD ESTRICTA OCUALQUIER OTRA TEORÍA DEL DERECHO Y DEBERÁN SOBREVIVIR A UNO O MÁS INCUMPLIMIENTOS ESENCIALES OAL INCUMPLIMIENTO DEL PROPÓSITO ESENCIAL DE ESTE CONTRATO O CUALQUIER SOLUCIÓN CONTENIDA AQUÍ; Y(B) A RIM Y A SUS EMPRESAS AFILIADAS, SUS SUCESORES, CESIONARIOS, AGENTES, PROVEEDORES (INCLUIDOS LOSPROVEEDORES DE SERVICIOS DE USO), DISTRIBUIDORES AUTORIZADOS POR RIM (INCLUIDOS TAMBIÉN LOSPROVEEDORES DE SERVICIOS DE USO) Y SUS RESPECTIVOS DIRECTORES, EMPLEADOS Y CONTRATISTASINDEPENDIENTES.

ADEMÁS DE LAS LIMITACIONES Y EXCLUSIONES MENCIONADAS ANTERIORMENTE, EN NINGÚN CASO NINGÚNDIRECTOR, EMPLEADO, AGENTE, DISTRIBUIDOR, PROVEEDOR, CONTRATISTA INDEPENDIENTE DE RIM O CUALQUIERAFILIADO DE RIM ASUMIRÁ NINGUNA RESPONSABILIDAD DERIVADA DE O RELACIONADA CON LA DOCUMENTACIÓN.

Antes de instalar, usar o suscribirse a cualquiera de los Productos y servicios de terceros, es su responsabilidadasegurarse de que su proveedor de servicios de uso ofrezca compatibilidad con todas sus funciones. Puede quealgunos proveedores de servicios de uso no ofrezcan las funciones de exploración de Internet con una suscripciónal servicio BlackBerry® Internet Service. Consulte con su proveedor de servicios acerca de la disponibilidad, arreglosde itinerancia, planes de servicio y funciones. La instalación o el uso de los Productos y servicios de terceros conproductos y servicios de RIM puede precisar la obtención de una o más patentes, marcas comerciales, derechos deautor u otras licencias para evitar que se vulneren o violen derechos de terceros. Usted es el único responsable dedeterminar si desea utilizar Productos y servicios de terceros y si se necesita para ello cualquier otra licencia deterceros. En caso de necesitarlas, usted es el único responsable de su adquisición. No instale o utilice Productos yservicios de terceros hasta que se hayan adquirido todas las licencias necesarias. Cualquier tipo de Productos yservicios de terceros que se proporcione con los productos y servicios de RIM se le facilita para su comodidad "TALCUAL" sin ninguna condición expresa e implícita, aprobación, garantía de cualquier tipo por RIM y RIM no sume

Guía de referencia rápida Aviso legal

54

ninguna responsabilidad en relación con ello. El uso de los Productos y servicios de terceros se regirá y estará sujetoa la aceptación de los términos de licencias independientes aplicables en este caso con terceros, excepto en los casoscubiertos expresamente por una licencia u otro acuerdo con RIM.

Algunas funciones mencionadas en esta documentación requieren una versión mínima del software de BlackBerry®Enterprise Server, BlackBerry® Desktop Software y/o BlackBerry® Device Software.

Los términos de uso de cualquier producto o servicio de RIM se presentan en una licencia independiente o en otroacuerdo con RIM que se aplica en este caso. NINGUNA PARTE DE LA PRESENTE DOCUMENTACIÓN ESTÁ PENSADAPARA PREVALECER SOBRE CUALQUIER ACUERDO EXPRESO POR ESCRITO O GARANTÍA PROPORCIONADA POR RIMPARA PARTES DE CUALQUIER PRODUCTO O SERVICIO DE RIM QUE NO SEA ESTA DOCUMENTACIÓN.

Research In Motion Limited295 Phillip StreetWaterloo, ON N2L 3W8Canadá

Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF Reino Unido

Publicado en Canadá

Guía de referencia rápida Aviso legal

55