Home

BlackBerry Java Application - 5.0

Contents

1. und setFont auf um die Darstellung des Men s anzuwenden die Sie in den Schritten 4 und 5 angegeben haben protected void makeMenu Menu menu int context menu setBorder _menuBorder menu setBackground _menuBackground menu setFont _menuFont super makeMenu menu context Codebeispiel ndern der Darstellung eines Men s impolgtener ezinndevileerma perl ee import net rim device api ui component import net rim device api ui container import net rim device api ui decor import net rim device api system public class CreateCustomMenu extends UiApplication public static void main String args CreateCustomMenu theApp new CreateCustomMenu theApp enterEventDispatcher public CreateCustomMenu pushScreen new CreateCustomMenuScreen class CreateCustomMenuScreen extends MainScreen Border _menuBorder 110 Entwicklungshandbuch Hinzuf gen eines Symbols zu einem Men eintrag Background _menuBackground Font _menuFont CreateCustomMenuScreen setTitle Custom Menu Sample add new RichTextField Creating a custom menu XYEdges thickPadding new XYEdges 10 10 10 10 _menuBorder BorderFactory createRoundedBorder thickPadding Border STYLE_DOTTED _menuBackground BackgroundFactory createSolidTransparentBackground Color LIGHTSTEELBLUE 50 try FontFamily family FontFamily forName BBCasual _menuFont family getFont Font PLAIN 30 Ui UNITS_px catch f
2. Anwendung anzuzeigen Die in Schritt 3 beschriebene MyUiScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class MyUi extends UiApplication public static void main String args MyUi theApp new MyUi theApp enterEventDispatcher public MyUi pushScreen new MyUiScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um den Titel f r den Bildschirm anzugeben 100 Entwicklungshandbuch Strukturansichten class MyUiScreen extends MainScreen public MyUiScreen setTitle UI Component Sample 4 Erstellen Sie im Bildschirmkonstruktor mithilfe der DateField Klasse ein Datumsfeld Stellen Sie System currentTimeMillis als Parameter bereit um die aktuelle Uhrzeit zur ckzugeben Verwenden Sie den DateField DATE_TIME Stil um sowohl das Datum als auch die Uhrzeitanzuzeigen Sie k nnen andere Stileverwenden um nur das Datum oder nur die Uhrzeit anzuzeigen add new DateField Date System currentTimeMillis DateField DATE_TIME Erstellen eines Kennwortfelds 1 Importieren Sie dienet rim device api ui component PasswordEditField Klasse 2 Erstellen Sie eine Instanz von PasswordEditField Die folgende Instanz verwendet zum Beispiel einen Konstruktor mit dem Sie einen Standardanfangswert f r PasswordEditField bereitstellen k nnen PasswordEditField p
3. Dialogfelder Dropdown Listen Interaktionsmethoden auf BlackBerry Ger ten Tastatur Bezeichnungen Listen Optionsfelder Auswahldialogfelder Fortschrittsanzeigen Suchfelder Drehungsfelder Textfelder Trackball oder Trackpad Strukturansichten Die folgenden Codebeispiele wurden hinzugef gt Codebeispiel Konfigurieren eines Browserfelds Codebeispiel Erstellen eines Kontrollk stchens Codebeispiel Erstellen einer Dropdown Liste Codebeispiel Erstellen eines Optionsfelds Codebeispiel Anzeigen des HTML Inhalts von einer Ressource in Ihrer Anwendung Codebeispiel Anzeigen von HTML Inhalt in einem Browserfeld Entwicklungshandbuch Datum 9 November 2009 Verlauf der Dokumentrevision Beschreibung Codebeispiel Anzeigen von HTML Inhalt von einer Webseite in einem Browserfeld Codebeispiel Senden von Formulardaten an eine Webadresse in einem Browserfeld Die folgenden Themen wurden ge ndert Erstellen eines Kontrollk stchens Erstellen eines Datumsfelds Erstellen einer Dropdown Liste Erstellen einer Optionstaste Reagieren auf einen Benutzer der den Bildschirm zweimal schnell ber hrt Festlegen des Formats und der Richtung des Bildschirms Rechtschreibpr fung Die folgenden Themen wurden gestrichen Bew hrtes Verfahren Implementieren von Untermen s Codebeispiel Erstellen eines Untermen s Codebeispiel Anzeigen einer Bezeichnung an einer absoluten Position auf dem Bildschirm Erstellen eines
4. ENDS ELD_ EIDA ELD ENDS MU NTACTS_NAME_FIRST NTACTS_NAME_LAST NTACTS_NOTES NTACTS_PAGER NTACTS_PHONE ALL NTACTS_PHONE_HOME NTACTS_PHONE_HOME2 NTACTS_PHONE_MOBILE NTACTS_PHONE_OTHER NTACTS_PHONE_WORK NTACTS_PHONE_WORK2 NTACTS_PIN MEMOS_TITLE MESSAGES_ALL MESSAGES_RECIPIENT MESSAGES_SENDER MESSAGES_SUBJECT MUSIC_ALL MUSIC_ALBUM SIC_ARTIST MUSIC_GENRE _MUSIC_PLAYLIST MU SIC_SONG ELD_PICTURES_TITLE ELD_RINGTONES_TITLE ELD_TASKS_TITLE ELD_VIDEOS_TITLE ELD_VOICENOTES_TITLE 51 Entwicklungshandbuch Schaltfl chen Schaltfl chen Verwenden Sie Schaltfl chen um Benutzern zu erm glichen eine Aktion aus einem Dialogfeld auszuf hren Men s enthalten in der Regel Aktionen die mit einem Bildschirm zusammenh ngen Benutzer k nnen ber eine Schaltfl che die folgenden Aktionen ausf hren Aktion Markieren Sie eine Schaltfl che F hren Sie eine Aktion aus BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen e Drehen Sie das Trackwheel oder den Ber hren Sie die Schaltfl che leicht Trackball e Fahren Sie mit einem Finger ber das Trackpad Klicken Sie auf die Schaltfl che oder dr cken Klicken Sie auf den Bildschirm Sie die Eingabetaste Add Contact 2 Delete lan Dundas Delete Cancel Bew hrtes Verfahren Implementieren von Schaltfl chen e Vermeiden Sie aufeinem Anwendungsbildschirm den Einsatz von Schaltfl chen Zur
5. Zuverl ssigkeit Rechtm igkeit Schicklichkeit Links oder andere Aspekte der Drittprodukte und dienste Der Einschluss eines Verweises auf Drittprodukte und dienste in dieser Dokumentation impliziert in keiner Weise eine besondere Empfehlung der Drittprodukte und dienste oder des Drittanbieters durch RIM SOFERN ES NICHT DURCH DAS IN IHREM RECHTSGEBIET GELTENDE RECHT AUSDR CKLICH UNTERSAGT IST WERDEN HIERMIT S MTLICHE AUSDR CKLICHEN ODER KONKLUDENTEN BEDINGUNGEN BILLIGUNGEN GARANTIEN ZUSICHERUNGEN ODER GEW HRLEISTUNGEN JEDER ART EINSCHLIESSLICH OHNE EINSCHR NKUNG BEDINGUNGEN BILLIGUNGEN GARANTIEN ZUSICHERUNGEN ODER GEW HRLEISTUNGEN HINSICHTLICH DER HALTBARKEIT EIGNUNG F R EINEN BESTIMMTEN ZWECK ODER VERWENDUNGSZWECK MARKTG NGIGKEIT MARKTG NGIGEN QUALIT T NICHTVERLETZUNG VON RECHTEN DRITTER ZUFRIEDENSTELLENDEN QUALIT T ODER DES EIGENTUMSRECHTS ABGELEHNT DIES GILT AUCH F R ZUSICHERUNGEN ODER GEW HRLEISTUNGEN DIE SICH AUS EINEM GESETZ EINER GEPFLOGENHEIT USANCEN BZW HANDELSGEPFLOGENHEITEN ERGEBEN ODER IM ZUSAMMENHANG MIT DER DOKUMENTATION ODER IHRER VERWENDUNG DER LEISTUNG ODER MANGELNDEN LEISTUNG VON SOFTWARE HARDWARE DIENSTEN ODER DRITTANBIETER PRODUKTEN UND DIENSTEN STEHEN AUF DIE HIER VERWIESEN WIRD M GLICHERWEISE HABEN SIE ZUDEM ANDERE LANDESSPEZIFISCHE RECHTE IN MANCHEN RECHTSGEBIETEN IST DER AUSSCHLUSS ODER DIE EINSCHR NKUNG KONKLUDENTER GEW HRLEISTUNGEN UND BEDINGUNGEN NICHT ZUL SSIG IN DEM GESETZLI
6. dass zus tzliche Informationen erforderlich sind bevor die verkn pfte Aktion ausgef hrt werden kann Dropdown Listen Verwenden Sie Dropdown Listen um einen Satz sich gegenseitig ausschlie ender Werte bereitzustellen Benutzer k nnen mit einer Dropdown Liste die folgende Aktion ausf hren Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen Klicken Sie auf einen Dr cken Sie die Leertaste oder klicken Sieauf Klicken Sie auf den Bildschirm Wert aus einer das Trackwheel den Trackball oder das Dropdown Liste Trackpad Font Family BBAlpha Sans v Font Size Font Style GEI The quick brown fox jumps over Bold do ExtraBold g Bold Italic Backlight Brightness Italic Backlight Timeout Automatically Dim Backlight 71 Entwicklungshandbuch Dropdown Listen Bew hrtes Verfahren Implementieren von Dropdown Listen Verwenden Sie eine Dropdown Liste um zwei oder mehr Auswahlm glichkeiten anzubieten wenn der Platz beschr nkt ist Wenn der Platz nicht beschr nkt ist erw gen Sie stattdessen Optionsschaltfl chen zu verwenden damit die verf gbaren Optionen auf dem Bildschirm angezeigt werden Verwenden Sie die ObjectChoiceField Klasse um Dropdown Listen zu erstellen Verwenden Sie f r den Standardwert jenen Wert den Benutzer am wahrscheinlichsten anklicken Verwenden Sie die markierte Option als Standardfokus wenn Benutzer durch die Liste scrollen Wenn Benutzer nicht a
7. wodurch angezeigt wird dass die Anwendung den Benutzer vor dem Schlie en nicht auffordert 73 Entwicklungshandbuch public boolean onSavePrompt Geesse Codebeispiel Erstellen einer Dropdown Liste import net rim device api ui import net rim device api ui component import net rim device api ui container public class MyUi extends UiApplication public static void main String args MyVi theApp new MyUi theApp enterEventDispatcher public MyUi pushScreen new MyUiScreen class MyUiScreen extends MainScreen public MyUiScreen setlTitle UI Component Sample String choices Monday Tuesday Wednesday Thursday Friday Saturday Sunday int iSetTo 2 add new ObjectChoiceField First Drop down List choices iSetTo int iStartAt 1 int iEndAt 31 int iIncrement 1 iSetTo 10 add new NumericChoiceField Numeric Drop Down List iStartAt iEndAt iIncrement iSetlo public boolean onSavePrompt eteagit el 2lelu az Bezeichnungen Verwenden Sie eine Bezeichnung um Text anzuzeigen der eine Steuerung kennzeichnet 74 Bezeichnungen Entwicklungshandbuch Listen Name i Information Bew hrtes Verfahren Implementieren von Bezeichnungen e Verwenden Sie die LabelField Klasse um Bezeichnungen zu erstellen e Verwenden Sie kurze klare Bezeichnungen e Gruppieren und ordnen Sie Bezeichnungen logisch an grupp
8. 04 4 MB Track 05 5 MB Diese Auswahl erm glicht Benutzern einen Ort von einer Liste auszuw hlen die Sie definieren Zum Beispiel k nnen Sie Benutzern erm glichen ihre GPS Position oder einen vorher ausgew hlte Ort auszuw hlen Select Location Enter location My current location Find on a map Diese Auswahl erm glicht Benutzern einen bestimmten Tag Monat oder ein bestimmtes Jahr auszuw hlen Zum Beispiel k nnen Sie Benutzern erm glichen einen Monat und ein Jahr auszuw hlen um anzugeben wann ihre Kreditkarte abl uft Mon May 10 2010 Duration Jun Time Zone Eastern Time 5 7 Show Time As Reminder Diese Auswahl erm glicht Benutzern eine bestimmte Stunde Minute oder Sekunde auszuw hlen 83 Entwicklungshandbuch Auswahldialogfelder Auswahltyp Beschreibung Set Alarm 20 22 Bew hrtes Verfahren Implementieren von Auswahldialogfeldern Verwenden Sie die Klassen FilePicker LocationPicker undDateTimePicker um Auswahldialogfelder zu erstellen Richtlinien f r Dateiauswahldialogfelder Erm glichen Sie den Benutzern ber einen entsprechenden Standardordner mit dem Durchsuchen zu beginnen Wenn die Anwendung keinen Standardordner besitzt und eine Medienkarte in das BlackBerry Ger t eingesetzt wird erm glichen Sie den Benutzern vom Stammordner aus mit dem Durchsuchen zu beginnen Wenn die Anwendung verschiedene Dateitypen unters
9. 118 Entwicklungshandbuch Empfangen von Rechtschreibpr fungsereignissen Um eine Korrektur f r ein falsch buchstabiertes Wort zu verwenden rufen Sie SpellCheckEngine learnCorrection auf Verwenden Sie die Parameter newStringBuffer Text und newStringBuffer Korrektur wobei Text f r das falsch buchstabierte Wort und Korrektur f r das richtig buchstabierte Wort steht _spellCheckEngine learnCorrection new StringBuffer text new StringBuffer correction Um f r ein Feld Rechtschreibpr fungsvorg nge auszuf hren rufen Sie SpellCheckUI spellCheck miteinem field Objekt als Parameter auf _spellCheckUIl spellCheck field Um ein falsch buchstabiertes Wort als richtig buchstabiertes Wort zu akzeptieren rufen Sie SpellCheckEngine learnWord mit dem zu lernenden Wort als Parameter auf _spellCheckEngine learnWord new StringBuffer word Empfangen von Rechtschreibpr fungsereignissen 1 Importieren Sie die folgenden Klassen e java lang StringBuffer e net rim device api ui UiApplication e net rim device api ui Field Importieren Sie die folgenden Schnittstellen e net rim blackberry api spellcheck SpellCheckUlListener e net rim blackberry api spellcheck SpellCheckEngine Erstellen Sie eine Methode die die SpellCheckUIListener LEARNING ACCEPT Konstante zur ckgibt wenn SpellCheckEngine ein neues Wort lernt public int wordLearned SpellCheckUIl ui StringBuffer word VUiApplication getUiApplication invokeLa
10. Breite basierend auf der Form des benutzerdefinierten Feldes zu bestimmen Verwenden Sie f r jeden Formentyp eine if Anweisung um Ma angaben zu vergleichen und die bevorzugte Breite f r das benutzerdefinierte Feld zu bestimmen public int getPreferredWidth switch _shape case TRIANGLE 57 Entwicklungshandbuch Erstellen eines benutzerdefinierten Feldes 58 if _labelWidth lt _labelHeight return _labelHeight lt lt 2 else return _labelWidth lt lt 1 case OCTAGON if _labelWidth lt _labelHeight return _labelHeight 4 else return _labelWidth 8 case RECTANGLE default return _labelWidth 8 Implementieren Sie getPreferredHeight mithilfe der relativen Ma angaben der Feldbezeichnung um die bevorzugte H he zu bestimmen Verwenden Sie einen switch Block um die bevorzugte H he basierend auf der Form des benutzerdefinierten Feldes zu bestimmen Verwenden Sie f r jeden Formentyp eine if Anweisung um Ma angaben zu vergleichen und die bevorzugte H he f r das benutzerdefinierte Feld zu bestimmen public int getPreferredHeight switch _shape case TRIANGLE if _labelWidth lt _labelHeight return _labelHeight lt lt 1 else return _labelWidth case RECTANGLE return _labelHeight 4 case OCTAGON return getPreferredWidth return H Implementieren Sie paint Der Manager eines Feldesruftpaint auf um das Feld neu zu zeichnen wenn ei
11. Formats und der Richtung des Bildschirms In Touchscreen Anwendungen k nnen Sie sowohl das Format als auch die Richtung des Bildschirms ber cksichtigen Das Format bezieht sich auf das Seitenverh ltnis des Bildschirms Die Richtung bezieht sich auf den Zeichenbereich des Bildschirms Format Der Benutzer eines BlackBerry Ger ts mit Touchscreen kann das Format des Bildschirms durch Drehen des Ger ts ndern Wenn ein Benutzer das BlackBerry Ger t so h lt dass sich das BlackBerry Logo oben befindet weist der Bildschirm das Hochformat auf Wenn der Benutzer das Ger t um 90 Grad nach links oder rechts dreht weist der Bildschirm das Querformat auf Sie k nnen mithilfe dernet rim device api system Display Klasse das Format des Bildschirms abrufen Die Display Klasse enth lt die Konstanten die den Formaten entsprechen die das Ger t mit Touchscreen zum Anzeigen von Informationen verwenden kann Das Hochformat entspricht beispielsweise der Konstante Display ORIENTATION_PORTRAIT das Querformat der Konstante Display ORIENTATION_LANDSCAPE und das quadratische Format der Konstante Display ORIENTATION_ SQUARE Um das Format des Bildschirms abzurufen k nnenSiedieDisplay getOrientation Methode aufrufen Diese Methode gibt eine Ganzzahl zur ck die einem der Formate entspricht die auf dem BlackBerry Ger t verwendet werden k nnen Damit Format nderungen erkannt werden k nnen Sie Screen sub Layout berschreiben Rufen Sie in dieser
12. GridFieldManager Eigenschaft angeben Eigenschaft FIXED_SIZE PREFERRED_SIZE Beschreibung Breite oder H he ist ein fester Wert in Pixel Breite oder H he ist eine bevorzugte Gr e basierend auf der maximalen bevorzugten Gr e der Felder in der Spalte oder der Zeile PREFERRED_SIZE ist die Standardeigenschaft Breite oder H he ist eine bevorzugte Gr e bis zu einer maximalen Gr e Breite oder H he basiert auf dem verf gbaren Platz auf dem Bildschirm PREFERRED_SIZE_WITH_MAXIMUM AUTO_SIZE Erstellen einer Gittergr e 1 Importieren Sie die erforderlichen Klassen und Schnittstellen mpolzteneitaniilmndevaieerapieunes import net rim device api ui component import net rim device api ui container 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Im Beispiel stellt die GridScreen Klasse beschrieben in Schritt 3 den benutzerdefinierten Bildschirm dar class GridFieldManagerDemo extends UiApplication public static void main String args GridFieldManagerDemo theApp new GridFieldManagerDemo theApp enterEventDispatcher GridFieldManagerDemo pushScreen new GridScreen Erstellen Sie das Framework f
13. Schriftart zu installieren Schlie en Sie den Load Aufruf in eine IF Anweisung ein um zu pr fen ob die Installation erfolgreich war Die Load Methode gibt eine Markierung zur ck die angibt ob die Schriftart erfolgreich installiert wurde Der folgende Code gibt an dass die Schriftart nur von der Anwendung verwendet werden kann if FontManager getInstance load Myfont ttf MyFont FontManager APPLICATION_FONT FontManager SUCCESS 5 Erstellen Sie im Bildschirmkonstruktor in einem try catch Block in der in Schritt 5 erstellten IF Anweisung ein Font Objekt f r die Schriftart die Sie gerade installiert haben Rufen Sie die setFont Methode auf um die in Schritt 5 erstellte Schriftart auf das LabelField Objekt anzuwenden try FontFamily family FontFamily forName MyFont Font myFont family getFont Font PLAIN 50 helloWorld setFont myFont catch ClassNotFoundException e D Rufen Sie im Bildschirmkonstruktor add auf um das LabelField Objekt dem Bildschirm hinzuzuf gen add helloWorld System out printin e getMessage Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung import net rim device api system lee Jeng lt leren St nl 7 import net rim device api ui container import net rim device api ui component importe 2lepuet WEI ss public class FontLoadingDemo extends UiApplication 116 Entwicklungs
14. String spinBoxMonths get spinBoxMonths getSelectedIndex super close Textfelder Benutzer k nnen ein Textfeld zur Eingabe von Text verwenden Art des Textfelds Beschreibung email Zum Einf gen des Zeichens oder eines Punktes in ein E Mail Adressenfeld dr cken Benutzer die Leertaste Datum und Uhrzeit Bei BlackBerry Ger ten miteinem Trackwheel oder Trackball k nnen Benutzer das Datum bzw die Zeit mit der Tastatur oder durch vertikales Drehen des Trackwheel oder des Trackballs ndern Bei BlackBerry Ger ten mit einem Trackpad k nnen Benutzer das Datum bzw die Zeit mit der Tastatur oder durch vertikales Bewegen eines Fingers auf dem Trackpad ndern Bei BlackBerry Ger ten mit einem Touchscreen k nnen Benutzer das Datum bzw die Zeit durch Anklicken von Datum bzw Zeit und durch Bewegen eines Fingers nach oben oder unten ndern Nummer Wenn bei BlackBerry Ger ten ohne Touchscreen die Benutzer in ein Nummernfeld eingeben wechselt das BlackBerry Ger t in den Modus Zahlensperre damit zum Eingeben von Zahlen nicht die Alt Taste gedr ckt werden muss Wenn bei BlackBerry Ger ten mit Touchscreen die Benutzer Nummern in ein Nummernfeld eingeben m ssen wird die Zahlentastatur angezeigt Kennwort Wenn Benutzer in ein Kennwortfeld eingeben werden anstelle des Textes Sternchen angezeigt In Kennwortfeldern k nnen Benutzer keinen Text ausschneiden kopieren oder einf gen bzw AutoText nicht verwenden
15. auszuw hlen Wenn Sie mithilfe einer lteren Version als Version 4 7 von BlackBerry Java Development Environment eine BlackBerry Ger teanwendung erstellen k nnen Sie die JAD Datei der Anwendung ndern damit die Anwendung reagieren kann wenn ein BlackBerry Ger tebenutzer den Touchscreen ber hrt In der JAD Datei legen Sie die Option RIM TouchCompatibilityMode auf false fest Wenn Sie mit BlackBerry JDE Version 4 7 oder h her eine BlackBerry Ger teanwendung erstellen k nnen Sie der Anwendung die Erkennung der Aktion erm glichen die der BlackBerry Ger tebenutzer auf dem Touchscreen ausf hrt indem Sie die net rim device api ui Screen Klasse dienet rim device api ui Field Klasse oder eine der Unterklassen der Field Klasse erweitern und die touchEvent Methode berschreiben Vergleichen Sie innerhalb der touchEvent Methode den Wert den TouchEvent getEvent zur ckgibt mit den Konstanten aus der net rim device api ui TouchEvent Klasse und dernet rim device api ui TouchGesture Klasse Die TouchEvent Klasse enth lt die Konstanten die die verschiedenen Aktionen darstellen die ein Benutzer auf dem Touchscreen ausf hren kann Die Aktion Klicken entspricht beispielsweise der Konstante TouchEvent CLICK die Aktion Ber hren der Konstante TouchEvent DOWN und die Aktion Verschieben der Konstante TouchEvent MOVE Die TouchGesture Klasse enth lt die Konstanten die die verschiedenen Gesten darstellen die ein Benutzer auf
16. class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen BrowserField myBrowserField new BrowserField add myBrowserField myBrowserField requestContent http www blackberry com Anzeigen von HTML Inhalt aus einer Ressource in Ihrer Anwendung 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api browser field2 import net rim device api system import net rim device api ui import net rim device api ui container 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene BrowserFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class BrowserFieldDemo extends UiApplication public static void main String args BrowserFieldDemo app new BrowserFieldDemo app enterEventDispatcher public BrowserFieldDemo pushScreen new BrowserFieldDemoScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse 63 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen class BrowserFieldDemoScreen extends MainScreen public Br
17. das Standardelement an Im folgenden Codebeispiel wird standardm ig Wednesday Mittwoch angezeigt Rufen Sie add auf um die Dropdown Liste dem Bildschirm hinzuzuf gen String choices Monday Tuesday Wednesday Thursday Friday Saturday Sunday int iSetTo 2 add new ObjectChoiceField First Drop down List choices iSetlo Erstellen Sie im Bildschirmkonstruktor mithilfe der NumericChoiceField Klasse eine zweite Dropdown Liste die eine Liste von Zahlen anzeigt Geben Sie im NumericChoiceField Konstruktor die Bezeichnung f r die Dropdown Liste die erste und die letzte in der Dropdown Liste anzuzeigende Zahl die f r die Zahlenliste zu verwendende Schrittgr e und die Standardzahl an Im folgenden Codebeispiel werden die numerischen Parameter in int Objekten gespeichert In der Dropdown Liste sind die Zahlen 1 bis 31 enthalten und standardm ig wird die Zahl 10 angezeigt Rufen Sie add auf um die zweite Dropdown Liste dem Bildschirm hinzuzuf gen int iStartAt 1 int iEndAt 31 int ilncrement 1 iSetTo 10 add new NumericChoiceField Numeric Drop Down SenSBalgte tsniEndAtsiinezementsnisetlo E Um die Standardfunktionalit t au er Kraft zu setzen die den Benutzer auffordert nderungen vor dem Schlie en der Anwendung zu speichern setzen Sie in der Erweiterung der MainScreen Klasse die MainScreen onSavePrompt Methode au er Kraft Im folgenden Codebeispiel lautet der R ckgabewert true
18. die R ckkehr zum vorherigen Bildschirm m glich Durch Dr cken der Esc Taste werden Benutzer immer wieder zur Startseite zur ckkehren Durch Halten der Esc Taste wird der Browser oder die Medienanwendung geschlossen Standardm ig bieten die BlackBerry Bildschirmobjekte diese Funktion ohne weiteres Anpassen Sie m ssen allerdings die gew nschten Men elemente und die zus tzliche Benutzeroberfl chen und Navigationslogik hinzuf gen Touchscreen Bei BlackBerry Ger ten mit einem SurePress Touchscreen verwenden Benutzer einen Finger um mit den Anwendungen auf dem Ger t zu interagieren Durch das Ausf hren verschiedener Aktionen auf dem Touchscreen geben Benutzer Text ein und navigieren durch die Bildschirme Benutzer k nnen auch Aktionen durch Klicken auf Symbole auf der Shortcut Leiste oder durch Dr cken der Men taste ausf hren Bei BlackBerry Ger ten mit einem Touchscreen k nnen Benutzer die folgenden Aktionen ausf hren Aktion Ergebnis Leichtes Ber hren des Bildschirms Diese Aktion markiert ein Element Wenn Benutzer in einem Textfeld den Bildschirm in der N he des Cursors ber hren wird ein umrandetes Feld um den Cursor angezeigt Dieses Feld hilft Benutzern den Cursor problemloser zu verschieben Tippen auf den Bildschirm In Anwendungen die eine Vollbildanzeige unterst tzen wie z B BlackBerry Maps undder BlackBerry Browser wird durch diese Aktion die Shortcut Leiste verborgen bzw angezeigt
19. ein Bild nachgef hrt Dr cken der Esc Taste Diese Aktion entfernt die Markierung von Text oder einer Liste von Elementen In einer Webseite Karte oder einem Bild zoomt diese Aktion um eine Ebene heraus Benutzer k nnen die Esc Taste zweimal dr cken um zur urspr nglichen Ansicht zur ck zu zoomen Trackball oder Trackpad Bei BlackBerry Ger ten mit einem Trackball oder Trackpad sind der Trackball oder das Trackpad die prim re Steuerung f r die Benutzernavigation Benutzer k nnen folgende Aktionen ausf hren e Drehen des Trackballs oder Schieben mit einem Finger auf dem Trackpad um den Cursor zu bewegen e Klicken Sie auf den Trackball oder das Trackpad um Standardaktionen auszuf hren oder ein Kontextmen zu ffnen e Klicken auf den Trackball oder das Trackpad bei gleichzeitigem Dr cken der Umschalttaste um Text zu markieren oder Nachrichten in einer Nachrichtenliste zu markieren BlackBerry miteinem Trackballoder Trackpad verf gen auch ber eine Men taste die sich links vom Trackball bzw dem Trackpad befindet Benutzer k nnen die Men taste dr cken um ein vollst ndiges Men verf gbarer Aktionen zu ffnen Trackball Empfindlichkeit Die Trackball Empfindlichkeit bezeichnet den Umfang der Trackball Bewegung die erforderlich ist damit das System die Bewegung als Navigationsereignis erkennt und entsprechend ein Navigationsereignis an die Softwareschicht zu senden Die BlackBerry Ger tehardware misst die physis
20. einem BlackBerry Ger t zu interagieren Sie k nnen sie auch in barrierefreien Anwendungen wie z B Sprache in Text Konvertern verwenden Um eine Beispielanwendung zu sehen die die Ereignisinjektion vorf hrt gehen Sie zu www blackberry com go toucheventinjectorsampleapp und laden Sie die Beispielanwendung des Ber hrungsereignisinjektors herunter Weitere Informationen zur Beispielanwendung finden Sie unter www blackberry com go docs developers in folgenden Dokumenten Touch Event Injector Sample Application Overview berblick ber die Beispielanwendung des Ber hrungsereignisinjektors 35 Entwicklungshandbuch Anordnen von Benutzeroberfl chenkomponenten Anordnen von Benutzeroberfl chenkomponenten 6 o Sie k nnen die Benutzeroberfl chenkomponenten auf einem Anwendungsbildschirm mithilfe von BlackBerry API Layout Managern anordnen Die folgenden Klassen erweitern die Manager Klasse deimnet rim device apu ui Paket bereitgestellt wird und stellen vordefinierte Layouts f r die Benutzeroberfl chenkomponenten auf dem Bildschirm Ihrer Anwendung bereit Layout Manager Beschreibung FlowFieldManager Dieser Layout Manager ordnet Benutzeroberfl chenkomponenten in Abh ngigkeit von der Gr e des Bildschirms vertikal und anschlie end horizontal an Die erste Benutzeroberfl chenkomponente wird in der linken oberen Ecke des Bildschirms platziert und die folgenden Komponenten werden horizontal rechts von der ersten Komponente platziert b
21. enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene HomeScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class AutoCompleteFieldApp extends UiApplication public static void main String args AutoCompleteFieldApp app new AutoCompleteFieldApp app enterEventDispatcher nee en pushScreen new HomeScreen Erstellen Sie den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class HomeScreen extends MainScreen public HomeScreen Entwicklungshandbuch Autocomplete Textfeld 4 Erstellen Sie im Konstruktor ein BasicFilteredList Objekt Erstellen Sie ein String Array und speichern Sie die Zeichenfolgen die sich im Array entsprechen sollen In diesem Beispiel sind die Zeichenfolgen Wochentage Rufen Sie addDataSet auf um die Daten im Array an BasicFilteredList zu binden BasicFilteredList filterList new BasicFilteredList String days Monday Tuesday Wednesday Thursday Friday Saturday Sunda filterList addDataSet 1 days days BasicFilteredList COMPARISON_IGNORE_CASE 5 Erstellen Sie im Konstruktor ein AutoCompleteField Objekt bergeben Sie eine Instanz der BasicFilteredList an den AutoCompleteField Konstruktor um die BasicFilteredList an das Autocomplete Textfeld
22. field to first unoccupied cell grid add new LabelField new The grid now looks like this AA one insert two AA three new five 4 Entwicklungshandbuch Anzeigen von Feldern in einem tempor ren Paar von Managern Anzeigen von Feldern in einem tempor ren Paar von Managern Sie k nnen die EyelidFieldManager Klasse verwenden um Felder in einem Paar von Managern anzuzeigen die vor bergehend oben und unten auf dem Bildschirm angezeigt werden Standardm ig werden die Felder angezeigt wenn der BlackBerry Ger tebenutzer den Trackball bewegt oder bei einem Ger t mit Touchscreen den Bildschirm ber hrt Die Felder werden nach einem bestimmten Zeitraum der Inaktivit t standardm ig 1 2 Sekunden ausgeblendet Sie k nnen diese Standardeigenschaften au er Kraft setzen Es gibt keine Beschr nkung f r die Anzahl und die Gr e der Felder Wenn die Manager mehr Felder enthalten als auf den Bildschirm passen berlappen der obere und der untere Manager einander wobei sich der obere Manager im Vordergrund befindet Vor bergehendes Anzeigen eines ButtonField und eines LabelField oben bzw unten am Bildschirm 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api system MalstsfedfvtAdffl et uf UA cemapiki unma import net rim device api ui component import net rim device api ui container import net rim device api ui extension container 2 Erstellen Sie da
23. new RadioButtonField Option 1 rbg true add new RadioButtonField Option 2 rbg false Entwicklungshandbuch Fortschrittsanzeigen public boolean onSavePrompt Ketlulgnssurnlier Fortschrittsanzeigen Verwenden Sie Fortschrittanzeigen um den Status eines Vorgangs anzuzeigen Es gibt zwei Arten von Fortschrittanzeigen e Verwenden Sie bestimmte Fortschrittsanzeigen wenn die Zeitdauer eines Vorgangs bekannt ist Bestimmte Fortschrittanzeigen enthalten ein Etikett um den Vorgang anzuzeigen und eine horizontale Leiste die sich von links nach rechts f llt w hrend ein Vorgang fortschreitet Ein Prozentsatz wird in der Leiste angezeigt um anzuzeigen wie viel vom Vorgang vollst ndig ist Im Browser zeigen Fortschrittanzeigen auch die Anzahl der Kilobytes aus einer Gesamtanzahl der Kilobytes an die ein BlackBerry Ger t heruntergeladen hat Um einen bestimmten Fortschrittanzeiger auszublenden dr cken Benutzer die Taste Beenden Wenn Benutzer die Taste Beenden dr cken setzt der Vorgang fort aber Benutzer k nnen andere Aufgaben gleichzeitig ausf hren e Verwenden Sie eine unbestimmte Fortschrittsanzeige wenn die Zeitdauer eines Vorgangs unbekannt ist Sie k nnen den Fortschritt mithilfe eines Statusdialogfeldes oder eines animierten Uhrcursors f r das Precision Thema oder ein Sanduhrsymbol f r das Dimension Thema verwenden anzeigen Benutzer k nnen andere Aktionen nicht ausf hren w hrend eine Anwendung einen unbe
24. oder den Wochentag zu ndern 93 Entwicklungshandbuch Drehungsfelder Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen Finden Sie ein Element e Drehen Sie den Trackball auf oder Fahren Sie mit einem Finger schnell nach oben in der Liste abw rts oder unten e Schieben Sie einen Finger auf dem Trackpad nach oben oder unten W hlen Sie ein Element Klicken Sie auf den Trackball oder mit dem Klicken Sie auf OK aus der Liste aus Trackpad Gehen Sie zu einem Drehen Sie den Trackball nach links oder Ber hren Sie das Drehungsfeld anderen Drehungsfeld rechts e Fahren Sie mit einem Finger auf dem Trackpad nach links oder rechts May 11 2009 12 21 lt sIMwITIFIs Mon May 11 2009 Bew hrtes Verfahren Implementieren von Drehfeldern e Verwenden Sie Drehfelder bei einer Liste sequenzieller Elemente e Verwenden Sie Dropdown Listen bei nicht sequenziellen Elementen oder Elementen mit unregelm ig en Abst nden Bei einer kurzen Liste nicht sequenzieller Elemente k nnen Sie ein Drehfeld verwenden um eine interaktivere Funktionalit t f r Benutzer bereitzustellen e Vermeiden Sie die Verwendung eines Drehfelds wenn mehrere andere Steuerelemente auf dem Bildsc werden e Verwenden Sie die Klassen SpinBoxField und SpinBoxFieldManager um Drehfelder zu erstel hirm angezeigt len e F gen Sie Dialogfelder wenn m glich Drehfeldern statt Bildschirmen hinzu Auf Bla
25. r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class GridScreen extends MainScreen public GridScreen 39 Entwicklungshandbuch Erstellen eines Raster Layouts 4 Im Bildschirmkonstruktor rufen Sie setTitle auf um den Text festzulegen den Sie im Titelabschnitt vom Bildschirm anzeigen wollen setTitle GridFieldManager Demo 5 Erstellen Sie im Bildschirmkonstruktor eine Instanz der GridFieldManager Klasse Geben Sie die Anzahl der Reihen die Anzahl der Spalten und den Stil des Rasters an mithilfe eines Stils der von net rim device api ui Manager geerbt wird Geben Sie f r den Stil an um den Standardstil zu verwenden GridFieldManager grid grid new GridFieldManager 2 3 0 6 Rufen Sie im Bildschirmkonstruktor GridFieldManager add auf um Felder zum Raster hinzuzuf gen grid add new LabelField one grid add new LabelField two grid add new LabelField three grid add new LabelField four grid add new LabelField five 7 Rufen Sie im Bildschirmkonstruktor die GridFieldManager Satz Methoden auf um die Eigenschaften vom Raster anzugeben grid setColumnPadding 20 grid setRowPadding 20 8 Rufen Sie im Bildschirmkonstruktor Screen add auf um dem Bildschirm das Raster hinzuzuf gen add grid Nach Abschluss erforderliche Aktion Sie k nnen das Raster ndern nachdem Sie es erstellt haben Zum Beispiel k nnen Sie Felder hinzuf gen Feld
26. running channel getLastAccelerationData xyz channel close Abrufen der Beschleunigungssensordaten in bestimmten Abst nden Wenn eine BlackBerry Ger teanwendung einen Kanal f r den Beschleunigungssensor ffnet w hrend sich die Anwendung im Vordergrund befindet und die Anwendung sich anschlie end im Hintergrund befindet pausiert der Kanal und der Beschleunigungssensor wird nicht abgefragt Wenn eine BlackBerry Ger teanwendung AccelerometerSensor Channel getLastAccelerationData short in kurzen Abst nden aufruft oder wenn das BlackBerry Ger t nicht bewegt wird k nnen durch die Methode doppelte Werte zur ckgegeben werden 1 Importieren Sie die folgenden Klassen e net rim device api system AccelerometerSensor Channel 20 Entwicklungshandbuch Abfragen des Beschleunigungssensors wenn sich die Anwendung im Vordergrund befindet e net rim device api system AccelerometerSensor ffnen Sie einen Kanal f r den Beschleunigungssensor W hrend ein Kanal offen ist wird von der BlackBerry Ger teanwendung der Beschleunigungssensor nach Informationen abgefragt Channel rawDataChannel AccelerometerSensor openRawDataChannel Application getApplication Erstellen Sie ein Array zum Speichern der Beschleunigungssensordaten short xyz new short 3 Erstellen Sie einen Thread while running Rufen Sie Channel getLastAccelerationData short auf um Daten vom Beschleunigungssensor abzurufen rawDataCha
27. schen Verwerfen oder Speichern Falls erforderlich f gen Sie weitere Beschreibungen anderswo auf dem Bildschirm hinzu zum Beispiel in einer Anwendungsnachricht e Vermeiden Sie die Verwendung der Bezeichnungen Ja und Nr e Vermeiden Sie die Verwendung von Symbolen oder Grafik in einer Bezeichnung e Vermeiden Sie Interpunktion in einer Bezeichnung Verwenden Sie in der Bezeichnung einer Schaltfl che Auslassungspunkte um anzuzeigen dass Benutzer eine weitere Aktion ausf hren m ssen nachdem sie auf die Schaltfl che klicken Erstellen einer Schaltfl che 1 Importieren Sie dienet rim device api ui component ButtonField Klasse 2 Erstellen Sie mithilfe eines Stilparameters eine Instanz eines ButtonField Objekts ButtonField mySubmitButton new ButtonField Submit Kontrollk stchen Verwenden Sie Kontrollk stchen f r Optionen die Benutzer aktivieren oder deaktivieren k nnen Benutzer k nnen mit einem Kontrollk stchen die folgende Aktion ausf hren Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen W hlen Sie ein Dr cken Sie die Leertaste oder klicken Sieauf Klicken Sie auf den Bildschirm Kontrollk stchen aus das Trackwheel den Trackball oder das Trackpad Spell Check Ignore Case W Ignore Acronyms tZ Ignore Words With Numbers Spell Check Email Before Sending Check Spelling As You Type Minimum Sized Word To Check Custom Dictionary 53 Entwicklungshand
28. verf gbaren Bildschirmbreite m glich angezeigt und die brigen werden nicht angezeigt Die Benutzeroberfl chenkomponenten sind vorhanden aber nicht sichtbar Dies kann zu einem unerwarteten Verhalten beim Scrollen f hren VerticalFieldManager Dieser Layout Manager ordnet Benutzeroberfl chenkomponenten auf dem Bildschirm von oben nach unten in einer einzelnen vertikalen Spalte an Weil dieser Layout Manager daf r entworfen wurde Elemente vertikalanzuordnen k nnen Sie auf Benutzeroberfl chenkomponenten keine vertikalen Stil Bits zum Beispiel Field FIELD_TOP Field FIELD_BOTTOM oder Field FIELD_VCENTER anwenden Sie k nnen horizontale Stil Bits zum BeispielField FIELD_LEFT Field FIELD_HCENTER oder Field FIELD_RIGHT anwenden Sie k nnen zus tzliche Layout Manager verwenden um Benutzeroberfl chenkomponenten in Ihrer Anwendung anzuordnen Zum Beispiel k nnen Sie den GridFieldManager Layout Manager verwenden um Benutzeroberfl chenkomponenten auf einem Bildschirm in Zeilen und Spalten zu platzieren und dadurch ein Raster zu erstellen Sie k nnen den EyelidFieldManager Layout Manager verwenden um Benutzeroberfl chenkomponenten in einem Paar von Managern anzuzeigen die vor bergehend oben und unten auf dem Bildschirm angezeigt werden Anordnen von Benutzeroberfl chenkomponenten 1 Importieren Sie die erforderlichen Klassen und Schnittstellen net rim device api ui container HorizontalFieldManager net rim device api ui compo
29. 76 Entwicklungshandbuch Listen private Vector _listElements public ListFieldScreen setTitle List Field Sample 4 Erstellen Sie im Bildschirmkonstruktor das Listenfeld Erstellen Sie ein Array f r die Elemente die Sie dem Listenfeld mithilfe der Vektors Klasse hinzuf gen m chten Erstellen Sie das Listenfeld mithilfe der Listfield Klasse Rufen Sie add auf um dem Bildschirm das Listenfeld hinzuzuf gen Rufen Sie initializeList auf die in Schritt 4 beschrieben ist um ein Listenfeld hinzuzuf gen _listElements new Vector _listField new ListField ListCallback _callback new ListCallback _listField setCallback _callback addi MFS EETEKdNE imeta lizels 5 Erstellen Sie eine Methode die Elemente anzugeben die Sie im Listenfeld mithilfe des Str ing Objekts anzeigen wollen Rufen Sie addElement auf um die Elemente der Liste hinzuzuf gen Rufen Sie setSize auf um die Anzahl der Elemente im Listenfeld anzugeben private void initializelList String itemOne List item one String itemTwo List item two _listElements addElement itemOne _listElements addElement itemTwo reloadList private void reloadList _listField setSize _listElements size 6 Erstellen Sie eine Klasse welche die ListFieldCallback Schnittstelle implementiert Implementieren Sie drawListRow um die Listenfeldelemente zum Bildschirm hinzuzuf gen Implementieren Sie get um das Listenfe
30. 97 Bew hrtes Verfahren Implementieren von Testielderg 98 rtl l t Gite Feeler eelerer heel ee ns a es de Sek 99 10 11 12 13 14 15 Erstelleneines De Duell gerett eege 100 Erstellenreines Kennworttelds 2 822er 101 SEPIK trI SIE MCEI e ee ee ee E 101 Bew hrtes Verfahren Implementieren von Strukturansichten 102 Erstellen eines Feldes f r das Anzeigen einer Strukturansicht 102 KENNEN 104 Erstellen EE 104 Codebeispiel Erstellen eines Men s ssssnensssesenssseensensensenneensennennenneenennennensensennennsensennennennsenennennsensensenneensensensenneen 105 Bew hrtes Verfahren Implementieren von Mentee 106 Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Amwendung 107 Hinzuf gen eines Men eintrags zu einer BlackBerry Device Softeare Anwendung 107 ndern der Darstellung eines Mens nennen ee 108 ndern der Darstellung eines Mani 108 Codebeispiel ndern der Darstellung eines Mentee 110 Hinzuf gen eines Symbols zu einem Mentleinttan ee EENS 11 Hinzuf gen eines Symbols zu einem Mentleintrag 112 Codebeispiel Hinzuf gen eines Symbols zu einem Mentelement 113 Benutzerdefiniefte Schatten nee ee 115 Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung 115 Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung Seeerei Eeer 116 RESHISENIEIDBRUNN N ernennen nee eine 118 Hinzuf g
31. Bei BlackBerry Ger ten mit SureType Technologie ist Mehrfachtippen die standardm ige Eingabemethode in Kennwortfeldern 97 Entwicklungshandbuch Art des Textfelds Telefonnummer Text Webadresse Textfelder Beschreibung Wenn bei BlackBerry Ger ten ohne Touchscreen die Benutzer in ein Telefonnummernfeld eingeben wechselt das BlackBerry Ger t in den Modus Zahlensperre damit zum Eingeben von Zahlen nicht die Alt Taste gedr ckt werden muss Sie k nnen es den Benutzern auch erlauben in Telefonnummernfeldern die folgenden Aktionen auszuf hren e Eingeben des Pluszeichens f r internationale Telefonnummern e Eingeben von Formatierungszeichen wie z B das Minuszeichen den Punkt Klammern 0 und Leerzeichen ingeben eines Nummernzeichens oder Sternchens E e Zeigen Sie durch Eingeben eines Kommas eine Pause oder eine Wartezeit durch Eingeben eines Ausrufezeichens an e Zeigen Sie eine Durchwahl durch Dr cken der Alt Taste und Dr cken von E X oder T an Wenn bei BlackBerry Ger ten mit Touchscreen die Benutzer Nummern in ein Telefonnummernfeld eingeben m ssen wird die Zahlentastatur angezeigt Sie k nnen es den Benutzern auch erlauben in Telefonnummernfeldern die folgenden Aktionen auszuf hren e Eingeben eines Nummernzeichens oder Sternchens e Zeigen Sie eine Pause oder eine Durchwahl durch Gedr ckthalten der Sternchen Taste an e Zeigen Sie eine Warte
32. Benutzer in einem autocomplete Textfeld eingibt mit den Werten von Feldern in einer angegebenen Datenquelle vergleichen Sie geben die zu verwendenden Felder und ihre Datenquellen mithilfe eines BasicFilteredList Objekts an das Sie als Argument an den Konstruktor der AutoCompleteField Klasse bergeben Datenquelle Felder DATA_SOURCE_APPOINTMENTS e DATA_FIELD_APPOINTMENTS_ALL e DATA_FIELD_APPOINTMENTS_ATTENDEES DATA_FIELD_APPOINTMENTS_ORGANIZER DATA_FIELD_APPOINTMENTS_SUBJECT DATA_SOURCE_CONTACTS e DATA_FIELD_CONTACTS_ADDRESS_ALL DATA_FIELD_CONTACTS_ADDRESS_HOME DATA_FIELD_CONTACTS_ADDRESS_WORK DATA_FIELD_CONTACTS_ANNIVERSARY DATA_FIELD_CONTACTS_BIRTHDAY DATA_FIELD_CONTACTS_CATEGORIES DATA_FIELD_CONTACTS_COMPANY DATA_FIELD_CONTACTS_EMAIL DATA_FIELD_CONTACTS_FAX DATA_FIELD_CONTACTS_JOB_TITLE DATA_FIELD_CONTACTS_NAME_FULL 50 Entwicklungshandbuch Datenquelle DATA_SOURCE_MEMOS DATA_SOURCE_MESSAGES DATA_SOURCE_MUSIC DATA_SOURCE_PICTURES DATA_SOURCE_RINGTONES DATA_SOURCE_TASKS DATA_SOURCE_VIDEOS DATA_SOURCE_VOICENOTES Felder DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_F DATA_ DATA_F DATA_ DATA_F DATA_F ENDRGO ELD_CO ELD_CO ELD_CO ELD_CO ELD_CO ELD_CO ELD_CO EUDECO ELD_CO ELD_CO ELD_CO ENDS EEDS ELD_ EEDS EIDE ELD_
33. Bereitstellung von miteinem Bildschirm verkn pften Aktionen verwenden Sie stattdessen wo m glich das Anwendungsmen Das Men steht Benutzern sofort zur Verf gung unabh ngig von der Position des Cursors auf dem Bildschirm Schaltfl chen sind statisch und erfordern vom Benutzer eine Markierung der Schaltfl che um die verkn pfte Aktion auszuf hren Wenn Sie Schaltfl chen verwenden nehmen Sie ebenfalls Men elemente f r die Aktionen im Anwendungsmen auf e Verwenden Sie wo m glich Kontrollk stchen oder Optionsfelder f r Optionen wie z B das Ein oder Ausschalten einer Funktion e Verwenden Sie f r die Standardschaltfl che jene Schaltfl che die Benutzer am wahrscheinlichsten ausw hlen Vermeiden Sie die Verwendung einer Schaltfl che die mit einer beendenden Aktion verkn pft ist als Standardschaltfl che Richtlinien f r Bezeichnungen e Verwenden Sie kurze klare Bezeichnungen 52 Entwicklungshandbuch Kontrollk stchen e Verwenden Sie nach M glichkeit Bezeichnungen die aus einem Wort bestehen Die Gr e einer Schaltfl che ndert sich mit der L nge der Bezeichnung Wenn eine Bezeichnung zu lang ist werden Auslassungspunkte angezeigt um zu verdeutlichen dass der Text abgeschnitten ist Wenn Sie eine Bezeichnung aus mehreren W rtern verwenden verwenden Sie satzabh ngige Gro schreibung e Verwenden Sie f r Bezeichnungen Verben die die verkn pfte Aktion beschreiben zum Beispiel Abbrechen L
34. Black Application Ion Entwicklungshandbuch BlackBerry Ver ffentlicht 2010 06 07 SWD 810476 0607021351 003 Inhaltsverzeichnis 1 2 Erstellen einer Benutzeroberfl che die mit normalen BlackBerry Benutzeroberfl chen kompatibel ist 5 BlackBerry Ger t Eingabe und Navigation f r Benutzer see 6 elleng EE 6 Trackball oder Trackpad 8 Trackball Empfindlichkeit 8 Trackball BEWEGUNG DEE 9 Trackwheel 9 EE 9 Interaktionsmethoden auf Black Ber Cer ten 10 Bildschirm sinne IR EEN EE deen 11 Verwalten eines Zeichen bereich Sinnani era Eeer RE 12 Erstellen eines Bildschirm bergangS ess seessseseseseesrsssssssssanssesssssussrasctireesosessrnvssssnsannsensssuutirrecetdtdorresksisskossssssnsvaeadadtererroterndeeit 13 Codebeispiel Erstellen eines Bildechirmfbergangs ee 15 Festlegen des Formats und der Richtung des Bildechimms 16 Abrufen der Ausrichtung des Touchsereen sa 0040er 17 Schr nken Sie die Richtung des Touchscreens em 17 Benachrichtigen lassen wenn sich die Gr e des Zeichenbereichs auf dem Touchscreen ndert 18 BEschleunigundssen LEE 19 Arten von Beschleunigungssensor Daten 19 Abrufen von Beschleunigungssensordaten 19 Abrufen der Beschleunigungssensordaten in bestimmten Abet nden 20 Abfragen des Beschleunigungssensors wenn sich die Anwendung im Vordergrund befindet 21 Abfragen des Beschleunigungssensors wenn sich die A
35. CH ZUL SSIGEN UMFANG WERDEN S MTLICHE KONKLUDENTEN GEW HRLEISTUNGEN ODER BEDINGUNGEN IM ZUSAMMENHANG MIT DER DOKUMENTATION DIE EINGESCHR NKT WERDEN K NNEN SOFERN SIE NICHT WIE OBEN DARGELEGT AUSGESCHLOSSEN WERDEN K NNEN HIERMIT AUF 90 TAGE AB DATUM DES ERWERBS DER DOKUMENTATION ODER DES ARTIKELS AUF DEN SICH DIE FORDERUNG BEZIEHT BESCHR NKT 128 Entwicklungshandbuch Rechtliche Hinweise IN DEM DURCH DAS IN IHREM RECHTSGEBIET ANWENDBARE GESETZ MAXIMAL ZUL SSIGEN AUSMASS HAFTET RIM UNTER KEINEN UMST NDEN F R SCH DEN JEGLICHER ART DIE IM ZUSAMMENHANG MIT DIESER DOKUMENTATION ODER IHRER VERWENDUNG DER LEISTUNG ODER NICHTLEISTUNG JEGLICHER SOFTWARE HARDWARE DIENSTE ODER DRITTPRODUKTE UND DIENSTE AUF DIE HIER BEZUG GENOMMEN WIRD STEHEN EINSCHLIESSLICH ABER NICHT BESCHR NKT AUF DIE FOLGENDEN SCH DEN DIREKTE VERSCH RFTEN SCHADENERSATZ NACH SICH ZIEHENDE BEIL UFIG ENTSTANDENE INDIREKTE KONKRETE STRAFE EINSCHLIESSENDE SCH DEN FOLGESCH DEN ODER SCH DEN F R DIE ANSPRUCH AUF KOMPENSATORISCHEN SCHADENERSATZ BESTEHT SCH DEN WEGEN ENTGANGENEN GEWINNEN ODER EINKOMMEN NICHTREALISIERUNG ERWARTETER EINSPARUNGEN BETRIEBSUNTERBRECHUNGEN VERLUSTES GESCH FTLICHER DATEN ENTGANGENER GESCH FTSCHANCEN ODER BESCH DIGUNG BZW VERLUSTES VON DATEN DES UNVERM GENS DATEN ZU BERTRAGEN ODER ZU EMPFANGEN PROBLEMEN IM ZUSAMMENHANG MIT ANWENDUNGEN DIE IN VERBINDUNG MIT RIM PRODUKTEN UND DIENSTEN VERWENDET WERDEN KOSTEN VON AUSFALLZ
36. CountryList StringComparator getInstance true countries Um die Elemente der Liste anzugeben erstellen Sie eine neue Instanz eines KeywordFilterField Objekts _keywordField new KeywordFilterField Rufen Sie KeywordFilterField setlist auf _keywordField setList _CountryList _CountryList Legen Sie eine Bezeichnung f r das Eingabefeld von KeywordFilterField fest _keywordField setLabel Search Erstellen Sie den Hauptbildschirm der Anwendung und f gen Sie dem Hauptbildschirm ein KeywordFilterField Objekt hinzu KeywordFilterDemoScreen screen new KeywordFilterDemoScreen this _keywordField screen add _keywordField getKeywordField screen add _keywordField pushScreen screen Um eine Methode zu erstellen die einen Vektor von Country Objekten f llt und zur ckgibt die Daten aus der Textdatei enthalten geben Sie in der Methodensignatur als R ckgabetyp Vector an public Vector getDataFromFile Erstellen und speichern Sie einen Verweis auf ein neues Vector Objekt Vector countries new Vector Erstellen Sie einen Eingabestrom zur Textdatei InputStream stream getClass getResourceAsStream Data CountryData txt Entwicklungshandbuch Drehungsfelder 12 Lesen Sie durch CRLF getrennte Zeilen aus dem Eingabestrom LineReader lineReader new LineReader stream 13 Lesen Sie Zeile f r Zeile Daten aus dem Eingabestrom bis Sie die Markierung f r das Dateiende erreichen Jede Zeile wird ana
37. Das Thema auf dem BlackBerry Ger t steuert die visuellen Effekte die angezeigt werden wenn ein Benutzer eine Anwendung ffnet Weitere Informationen finden Sie im BlackBerry Theme Studio Benutzerhandbuch Entwicklungshandbuch Erstellen eines Bildschirm bergangs Codebeispiel Erstellen eines Bildschirm bergangs Das folgende Codebeispiel zeigt einen bergang durch Verschieben sowie einen bergang durch allm hliches Ausblenden Wenn der Benutzer die Anwendung ffnet wird auf dem BlackBerry Ger t der erste Bildschirm angezeigt der eine Schaltfl che enth lt Wenn der Benutzer auf die Schaltfl che klickt wird von rechts ein zweiter Bildschirm auf den Ger tebildschirm geschoben Der zweite Bildschirm wird nach zwei Sekunden automatisch ausgeblendet 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 decor public class ScreenTransitionSample extends UiApplication implements FieldChangelistener private Screen _secondaryScreen private Runnable _popRunnable public static void main String args ScreenTransitionSample theApp new ScreenTransitionSample theApp enterEventDispatcher public ScreenTransitionSample _secondaryScreen new FullScreen _secondaryScreen setBackground BackgroundFactory createSolidBackground Color LIGHTBLUE LabelField labelField new LabelField The screen closes automatically in two se
38. EITEN NICHTVERWENDBARKEIT VON RIM PRODUKTEN UND DIENSTEN ODER TEILEN DAVON BZW VON AIRTIME DIENSTEN KOSTEN VON ERSATZG TERN DECKUNG EINRICHTUNGEN ODER DIENSTEN KAPITAL ODER ANDERE VERM GENSSCH DEN UNABH NGIG DAVON OB SCH DEN DIESER ART ABZUSEHEN ODER NICHT ABZUSEHEN WAREN UND AUCH DANN WENN RIM AUF DIE M GLICHKEIT SOLCHER SCH DEN HINGEWIESEN WURDE IN DEM DURCH DAS IN IHREM RECHTSGEBIET ANWENDBARE GESETZ MAXIMAL ZUL SSIGEN AUSMASS BERNIMMT RIM KEINERLEI VERANTWORTUNG VERPFLICHTUNG ODER HAFTUNG SEI SIE VERTRAGLICHER DELIKTRECHTLICHER ODER ANDERWEITIGER NATUR EINSCHLIESSLICH DER HAFTUNG FUR FAHRLASSIGKEIT UND DER DELIKTSHAFTUNG DIE IN DIESEM DOKUMENT GENANNTEN EINSCHR NKUNGEN AUSSCHL SSE UND HAFTUNGSAUSSCHL SSE GELTEN A UNGEACHTET DER VON IHNEN ANGEF HRTEN KLAGEGR NDE FORDERUNGEN ODER KLAGEN EINSCHLIESSLICH ABER NICHT BESCHR NKT AUF VERTRAGSBRUCH FAHRL SSIGKEIT ZIVILRECHTLICHER DELIKTE DELIKTSHAFTUNG ODER SONSTIGE RECHTSTHEORIE UND SIND AUCH NACH EINEM WESENTLICHEN VERSTOSS BZW EINEM FEHLENDEN GRUNDLEGENDEN ZWECK DIESER VEREINBARUNG ODER EINES DARIN ENTHALTENEN RECHTSBEHELFS WIRKSAM UND GELTEN B F R RIM UND DIE ZUGEH RIGEN UNTERNEHMEN RECHTSNACHFOLGER BEVOLLM CHTIGTEN VERTRETER LIEFERANTEN EINSCHLIESSLICH AIRTIME DIENSTANBIETERN AUTORISIERTE RIM DISTRIBUTOREN EBENFALLS EINSCHLIESSLICH AIRTIME DIENSTANBIETERN UND DIE JEWEILIGEN F HRUNGSKR FTE ANGESTELLTEN UND UNABH NGIGEN AUFTRAGNEHMER ZUS TZ
39. FieldDemo extends UiApplication public static void main String args BrowserFieldDemo app new BrowserFieldDemo app enterEventDispatcher public BrowserFieldDemo pushScreen new BrowserFieldDemoScreen Erstellen Sie das Framework f r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserField Klasse BrowserField myBrowserField new BrowserField Rufen Sie im Bildschirmkonstruktor add auf um dem Bildschirm das BrowserField Objekt hinzuzuf gen add myBrowserField Rufen Sie im Bildschirmkonstruktor BrowserField requestContent auf um den Ort des HTML Inhalts anzugeben und ihn anzuzeigen myBrowserField requestContent http www blackberry com Codebeispiel Anzeigen von HTML Inhalt von einer Webseite in einem Browserfeld import net rim device api browser field2 import net rim device api system import net rim device api ui import net rim device api ui container public class BrowserFieldDemo extends UiApplication 62 public static void main String args Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen BrowserFieldDemo app new BrowserFieldDemo app enterEventDispatcher public BrowserFieldDemo pushScreen new BrowserFieldDemoScreen
40. Image menulcon ImageFactory createlmage Bitmap getBitmapResource View jpg _viewItem setlIcon menulcon addMenultem _viewItem private Menultem _viewItem new Menultem More Info 110 10 public void run Dialog inform Display more information 113 Entwicklungshandbuch Hinzuf gen eines Symbols zu einem Men eintrag 114 Entwicklungshandbuch Benutzerdefinierte Schriftarten Benutzerdefinierte Schriftarten Die FontManager Klasseimnet rim device api ui Paket stellt Konstanten und Methoden bereit die Sie verwenden k nnen um eine TrueType Schriftartauf einem BlackBerry Ger t zu installieren und zu deinstallieren Die maximale Gr e die f r die TrueType Schriftartdatei erm glicht wird ist 60 KB Sie k nnen angeben ob die Schriftart f r die Anwendung die die Schriftart installiert oder f r alle Anwendungen auf dem BlackBerry Ger t verf gbar ist Die FontManager Klasse stellt auch Methoden bereit um die Standardschriftart f r das BlackBerry Ger t oder die Anwendung festzulegen Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung 1 3 Importieren Sie die erforderlichen Klassen und Schnittstellen import net import net import net import net rim device rim device rim device rim device import java util api api api api EE USE UE EE Ee ui component Erstellen Sie das Anwendungsframework durch Erweitern de
41. LICH ZU DEN OBEN GENANNTEN EINSCHR NKUNGEN UND AUSSCHL SSEN HAFTEN DIE F HRUNGSKR FTE ANGESTELLTEN VERTRETER DISTRIBUTOREN LIEFERANTEN UNABHANGIGEN AUFTRAGNEHMER VON RIM ODER RIM ANGEHORENDEN UNTERNEHMEN IN KEINER WEISE IM ZUSAMMENHANG MIT DER DOKUMENTATION Bevor Sie Drittprodukte bzw dienste abonnieren installieren oder verwenden m ssen Sie sicherstellen dass Ihr Airtime Dienstanbieter sich mit der Unterst tzung aller zugeh rigen Funktionen einverstanden erkl rt hat Einige Airtime Dienstanbieter bieten m glicherweise keine Internet Browsing Funktion in Zusammenhang mit einem Abonnement f r den BlackBerry Internet Service an Erkundigen Sie sich bei Ihrem Service Provider bez glich Verf gbarkeit Roaming Vereinbarungen Service Pl nen und Funktionen F r die Installation und Verwendung von Drittprodukten und diensten mit den Produkten und Diensten von RIM sind m glicherweise Patent Marken Urheberrechts oder andere Lizenzen erforderlich damit die Rechte Dritter nicht verletzt werden Es liegt in Ihrer Verantwortung zu entscheiden ob Sie Drittprodukte und dienste verwenden m chten und festzustellen ob hierf r Lizenzen erforderlich sind F r den Erwerb etwaiger Lizenzen sind Sie verantwortlich Installieren oder verwenden Sie Drittprodukte und dienste erst nach dem Erwerb aller erforderlichen Lizenzen Alle Drittprodukte und dienste die Sie mit Produkten und Diensten von RIM erhalten werden lediglich zu Ihrem Vortei
42. Layout Managers Erstellen eines Bildschirms Erstellen eines Untermen s Anzeigen eines Felds an einer absoluten Position auf einem Bildschirm Anzeigen einer Bezeichnung an einer absoluten Position auf dem Bildschirm Bereitstellen von Bildschirmnavigation beim Verwenden eines Mainscreen Die folgenden Themen wurden hinzugef gt Erstellen eines Raster Layouts Erstellen einer Gittergr e Erstellen einer Dateiauswahl Verwenden von Datenquellen und Feldern mit einem autocomplete Textfeld Die folgenden Codebeispiele wurden hinzugef gt 125 Entwicklungshandbuch Verlauf der Dokumentrevision e Codebeispiel Erstellen eines Raster Layouts e Codebeispiel Erstellen eines Dateipickers 6 Oktober 2009 Die folgenden Themen wurden hinzugef gt e Bew hrtes Verfahren Implementieren von Untermen s e Erstellen eines autocomplete Textfelds aus einem Datensatz e Erstellen eines autocomplete Textfelds aus einer Datenquelle e Erstellen einer Datumsauswahl e Erstellen eines Drehfelds e Erstellen eines Bildschirm bergangs e Benutzerdefinierte Schriftarten e Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung Die folgenden Codebeispiele wurden hinzugef gt e Codebeispiel Erstellen eines autocomplete Felds aus einem Datensatz e Codebeispiel Erstellen eines autocomplete Felds aus einem Datensatz e Codebeispiel Erstellen eines Bildschirm bergangs e Codebeispiel Erstellen ei
43. Methode super sublayout auf und achten Sie auf Anderungen der width und height Werte Richtung Ein BlackBerry Ger t mit Touchscreen kann Informationen auf dem Bildschirm in verschiedenen Richtungen anzeigen Die Richtung bezieht sich auf das obere Ende des Zeichenbereichs des Bildschirms das zur Position des BlackBerry Logos relativ ist Die Richtung ist Norden wenn das obere Ende des Zeichenbereichs die Bildschirmseite ist die dem BlackBerry Logo am n chsten liegt Westen wenn sich das obere Ende des Zeichenbereichs links vom BlackBerry Logo befindet und Osten wenn sich das obere Ende des Zeichenbereichs rechts vom BlackBerry Logo befindet Mithilfe dernet rim device api system Display Klasse dernet rim device api ui Ui Klasse und der net rim device api ui UiEngineInstance Klasse k nnen Sie die Richtung steuern die das BlackBerry Ger t zum Anzeigen von Informationen auf dem Bildschirm verwendet Die Display Klasse enth lt Konstanten die den Richtungen Entwicklungshandbuch Festlegen des Formats und der Richtung des Bildschirms entsprechen die das Ger t zum Anzeigen von Informationen verwenden kann Norden entspricht beispielsweise der Konstante Display DIRECTION_NORTH Westen der Konstante Display DIRECTION_WEST und Osten der Konstante Display DIRECTION_ EAST Sie k nnen ein Objektdernet rim device api ui Ui Klasseerstellen undUi getUiEngineIlnstance aufrufen um ein Objekt der UiEngineInstance Klasse abzurufen Durch A
44. Sie dienet rim device api system AccelerometerData Klasse Fragen Sie Beschleunigungssensordaten aus dem Puffer ab AccelerometerData accData accData bufferedChannel getAccelerometerData 23 Entwicklungshandbuch Ermitteln des Zeitpunkts des Abrufens eines Werts vom Beschleunigungssensor 3 24 Rufen Sie AccelerometerData getSampleTsHistory auf long queryTimestamps accData getSampleTsHistory Entwicklungshandbuch Ereignisse Ereignisse Reagierenauf Navigationsereignisse Sie k nnen die Screen Navigationsmethoden verwenden um eine BlackBerry Ger teanwendung zu erstellen Wenn Ihre vorhandene BlackBerry Ger teanwendung die Trackwheellistener Schnittstelle implementiert aktualisieren Sie Ihre BlackBerry Ger teanwendung um die Screen Navigationsmethoden zu verwenden 1 Importieren Sie dienet rim device api ui Screen Klasse 2 Verwalten Sie Navigationsereignisse durch Erweitern dernet rim device api ui Screen Klasse oder einer der Unterklassen und berschreiben der folgenden Navigationsmethoden navigationClick int status int time navigationlUnclick int status int time navigationMovement int dx int dy int status int time Bestimmen der Art der Eingabemethode 1 Importieren Sie eine oder mehrere der folgenden Klassen e net rim device api ui Screen e net rim device api ui Field Importieren Sie dienet rim device api system KeypadlListener Schnittstelle Implementieren Sie dienet rim device a
45. String label this label RECTANGLE 0 public CustomButtonField String label int shape this label shape public CustomButtonField String label long style this label RECTANGLE style public CustomButtonField String label int shape long style super style _label label _ shape shape _font getFont _labelHeight _font getHeight _labelWidth _font getAdvance _label 5 Implementieren Sie Layout um die Anordnung der Felddaten anzugeben F hren Sie die komplexesten Berechnungen in Layout stattinpaint aus Der Manager des Feldes ruft layout auf um zu bestimmen wie das Feld seine Inhalte im verf gbaren Platz anordnet Rufen Sie Math min auf um die kleineren Werte f r die angegebene Breite und H he sowie die bevorzugte Breite und H he des Feldes zur ckzugeben Rufen Sie Field setExtent int int auf umdie erforderlichen Abmessungen f r das Feld festzulegen protected void layout int width int height Tont EG _labelHeight _font getHeight _labelWidth _font getAdvance _ label width Math min width getPreferredWidth height Math min height getPreferredHeight SetE lt eentaemwi ldichssshensihits e 6 Implementieren Sie getPreferredwWidth mithilfe der relativen Ma angaben der Feldbezeichnung um sicherzustellen dass die Bezeichnung die Abmessungen der Komponente nicht berschreitet Verwenden Sie einen switch Block um die bevorzugte
46. X Y und Z Achse wahrnehmen Ein Ger tebenutzer kann die Ausrichtung vom Ger t ndern das die Bildschirmrichtung von einem Bildschirm f r eine BlackBerry Ger teanwendung zwischen Hoch und Querformat ndern kann Sie k nnen die Accelerometer APlsimnet rim device api system Paket f r die Reaktion auf die Ausrichtung und Beschleunigung des BlackBerry Ger ts verwenden Zum Beispiel k nnen Sie eine Spieleanwendung ndern um die Richtung und die Geschwindigkeit von einem bewegenden Objekt auf dem Bildschirm zu ndern w hrend ein Benutzer das BlackBerry Ger t mit verschiedenen Geschwindigkeiten bewegt und dreht Um eine Beispielanwendung herunterzuladen die vorf hrt wie Bildschirm berg nge verwendet werden besuchen Sie www blackberry com go accelerometersample Weitere Informationen zur Beispielanwendung finden Sie unter www blackberry com go devguides in folgenden Dokumenten Accelerometer Sample Application Overview berblick ber die Beispielanwendung Beschleunigungssensor Arten von Beschleunigungssensor Daten Eine BlackBerry Ger teanwendung kann Daten vom Beschleunigungssensor abrufen Datentyp Beschreibung Ausrichtung Die Ausrichtung des BlackBerry Ger ts in Bezug auf den Boden Beschleunigung Die Drehbeschleunigung des BlackBerry Ger ts Weitere Informationen zu Datentypen des Beschleunigungssensors finden Sie in der API Referenz f r das BlackBerry Java Development Environment Abrufen von Beschleunigung
47. Zweimaliges Tippen auf den Bildschirm In einer Webseite Karte Bild oder Pr sentationsanlage zoomt diese Aktion in die jeweilige Webseite Karte Bild oder Pr sentationsanlage Entwicklungshandbuch Aktion Den Finger auf einem Element halten Ber hren und Ziehen eines Elements auf dem Bildschirm Ber hren des Bildschirms an zwei Stellen gleichzeitig Klicken Dr cken auf den Bildschirm Schnelles Fahren mit einem Finger nach oben oder unten ber den Bildschirm Schnelles Fahren mit einem Finger nach links oder rechts ber den Bildschirm Schieben mit einem Finger nach oben oder unten ber den Bildschirm Touchscreen Ergebnis Durch diese Aktion wird auf der Shortcut Leiste ein QuickInfo angezeigt das die Aktion beschreibt die das Symbol darstellt Wenn Benutzer in einer Nachrichtenliste einen Finger auf dem Absender oder den Betreff einer Nachricht halten sucht das BlackBerry Ger t nach dem Absender oder dem Betreff Diese Aktion bewegt den Inhalt auf dem Bildschirm in die entsprechende Richtung Wenn Benutzer zum Beispiel ein Men element ber hren und ziehen bewegt sich die Liste der Men elemente in die gleiche Richtung In einem Textfeld bewegt diese Aktion das umrandete Feld und den Cursor in die gleiche Richtung Diese Aktion markiert den Text oder die Liste der Elemente wie z B Nachrichten zwischen den beiden Stellen Zum Hinzuf gen oder Entfernen markierter Texte oder Elemente k nnen Benutzer den Bild
48. al zum Beschleunigungssensor AccelerometerChannelConfig channelConfig new AccelerometerChannelConfig AccelerometerChannelConfig TYPE_RAW 3 Rufen SieAccelerometerChannelConfig setBackgroundMode Boolean auf um den Support f r eine Anwendung anzugeben die sich im Hintergrund befindet channelConfig setBackgroundMode true 4 Rufen Sie AccelerometerSensor openChannel auf um einen Kanal der sich im Hintergrund befindet zum Beschleunigungssensor zu ffnen Channel channel AccelerometerSensor openChannel Application getApplication channelConfig 5 Rufen Sie Thread sleep auf um den Abstand zwischen Abfragen zum Beschleunigungssensor in Millisekunden anzugeben short xyz new short 3 while running channel getLastAccelerationData xyz Thread sleep 500 6 Rufen Sie Channel close auf um den Kanal zum Beschleunigungssensor zu schlie en channel close Speichern der ausgelesenen Beschleunigungssensorwerte in einem Puffer 1 Importieren Sie die folgenden Klassen e net rim device api system AccelerometerChannelConfig e net rim device api system AccelerometerSensor Channel 2 Erstellen Sie eine Konfiguration f r einen Kanal zum Beschleunigungssensor 22 Entwicklungshandbuch Abrufen von Beschleunigungssensordaten aus einem Puffer AccelerometerChannelConfig channelConfig new AccelerometerChannelConfig AccelerometerChannelConfig TYPE_RAW Rufen Sie AccelerometerChanne
49. aphics drawLine 0 x2 x S i gmapmies leen TEE Glieser Bleu enee textWidth Math min _labelWidth w 6 textX w textWidth gt gt 1 textY w _labelHeight gt gt 1 break case RECTANGLE default graphics drawRect 0 w getHeight textX 4 textY 2 textWidth w 6 break graphics drawlext _label textX textY int getStyle amp DrawStyle ELLIPSIS DrawStyle HALIGN MASK textWidth 9 Implementieren Sie die Methoden Fieldset und get Implementieren Sie die Methoden Field getLabel Field getShape Field setLabel Stringlabel und Field setShape int shape um die Instanzvariablen des benutzerdefinierten Feldes zur ckzugeben public String getLabel Eeer ren public int getShape return _shape public void setLabel String label _ label label _labelWidth _font getAdvance _label updateLayout 59 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen public void setShape int shape _shape shape Erstellen eines Felds um Webinhalte anzuzeigen Anzeigen von HTML Inhalt in einem Browserfeld 1 60 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api browser field2 lmpotsneiteirimedeviiecerapieunes import net rim device api ui container Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Kla
50. api system Display getOrientation auf int orientation Display getOrientation Schr nken Sie die Richtung des Touchscreens ein 1 Importieren Sie die folgenden Klassen 17 Entwicklungshandbuch Festlegen des Formats und der Richtung des Bildschirms e net rim device api ui Vi e net rim device api ui UViEnginelnstance 2 Rufen Sienet rim device api ui Ui getliEnginelnstance auf ViEnginelnstance ue _ue Vi getliEnginelnstance 3 Rufen Sienet rim device api ui UiEnginelnstance setAcceptableDirections byte flags auf und bergeben Sie das Argument f r die Richtung des Bildschirms _ue setAcceptableDirections Display DIRECTION WEST Benachrichtigen lassen wenn sich die Gr e des Zeichenbereichs auf dem Touchscreen ndert 1 Importieren Sie die folgenden Klassen e javax microedition lcdui Canvas e net rim device api ui component Dialog Erweitern Sie javax microedition Lcdui Canvas berschreiben Sie Canvas sizeChanged int int protected void sizeChanged int w int h Dialog alert The size of the Canvas has changed Entwicklungshandbuch Beschleunigungssensor Beschleunigungssensor Ein BlackBerry Ger t mit einem Touchscreen enth lt einen Beschleunigungssensor der die Aufgabe hat die Ausrichtung und die Beschleunigung des BlackBerry Ger ts wahrzunehmen Wenn ein BlackBerry Ger tebenutzer das BlackBerry Ger t bewegt kann der Beschleunigungssensor die Bewegung im 3D Bereich entlang der
51. bezogen werden z B alle unter www blackberry com go docs erh ltlichen Dokumente werden ohne M ngelgew hr und je nach Verf gbarkeit bereitgestellt Die entsprechenden Dokumente werden ohne ausdr ckliche Billigung Gew hrleistung oder Garantie seitens Research In Motion Limited und seinen angegliederten Unternehmen RIM bereitgestellt RIM bernimmt keine Verantwortung f r eventuelle typografische technische oder anderweitige Ungenauigkeiten sowie f r Fehler und Auslassungen in den genannten Dokumenten Dieses Dokument beschreibt eventuell einige Aspekte der RIM Technologie in allgemeiner Form um das Eigentum und die vertraulichen Informationen und oder Gesch ftsgeheimnisse von RIM zu sch tzen RIM beh lt sich das Recht vor die in diesem Dokument enthaltenen Informationen von Zeit zu Zeit zu ndern RIM ist jedoch nicht verpflichtet die Benutzer ber diese nderungen Updates Verbesserungen oder Zus tze rechtzeitig bzw berhaupt in Kenntnis zu setzen Diese Dokumentation enth lt m glicherweise Verweise auf Informationsquellen Hardware oder Software Produkte oder Dienste einschlie lich Komponenten und Inhalte wie urheberrechtlich gesch tzte Inhalte und oder Websites von Drittanbietern nachfolgend Drittprodukte und dienste genannt RIM hat keinen Einfluss auf und bernimmt keine Haftung f r Drittprodukte und dienste dies gilt u a f r Inhalt Genauigkeit Einhaltung der Urheberrechtsgesetze Kompatibilit t Leistung
52. buch Kontrollk stchen Bew hrtes Verfahren Implementieren von Kontrollk stchen Verwenden Sie Kontrollk stchen wenn Benutzer mehrere Optionen ausw hlen k nnen Verwenden Sie die CheckboxField Klasse um Kontrollk stchen zu erstellen Starten Sie keine Aktion wenn Benutzer ein Kontrollk stchen markieren Zum Beispiel keinen neuen Bildschirm ffnen Richten Sie die Kontrollk stchen senkrecht aus Gruppieren und ordnen Sie Kontrollk stchen logisch an gruppieren Sie beispielsweise zusammen geh rende Objekte oder f hren Sie die h ufigsten Objekte zuerst an Vermeiden Sie eine alphabetische Sortierung der Kontrollk stchen die alphabetische Reihenfolge ist sprachspezifisch Richtlinien f r Bezeichnungen Verwenden Sie kurze klare Bezeichnungen berpr fen Sie ob die Bezeichnung deutlich beschreibt was geschieht wenn Benutzer das Kontrollk stchen aktivieren Verwenden Sie nach M glichkeit positive Bezeichnungen Wenn beispielsweise Benutzer die Option zum Ein oder Ausschalten einer Funktion haben verwenden Sie in der Bezeichnung Einschalten statt Ausschalten Platzieren Sie die Bezeichnungen auf der rechten Seite von Kontrollk stchen Verwenden Sie die bliche Gro Kleinschreibung f r Titel Verwenden Sie keine Ende Interpunktion Erstellen eines Kontrollk stchens 1 54 Importieren Sie die erforderlichen Klassen und Schnittstellen Imporzteneitan nadeviigerapieune import net rim device api ui com
53. cell 1 0 This is cell 1 1 This i5 cell 1 2 In einem Gebietsschema mit einer Textrichtung von rechts nach links befindet sich die erste Zelle in der rechten oberen Ecke des Rasters Right to left locale This is cell 0 2 This is cell 0 1 This is cell 0 0 This is cell 1 2 This is cell 1 1 This is cell 1 0 Sie k nnen einem Raster Felder sequenziell hinzuf gen von links nach rechts oder von oben nach unten in Gebietsschemas mit einerTextrichtung von links nach rechts von rechts nach links oder von oben nach unten in Gebietsschemas miteiner Textrichtung von rechts nach links oder durch Angeben einer Zeile und einer Spalte im Raster Sie k nnen Felder l schen Felder einf gen die Abst nde zwischen Spalten und Zeilen angeben und die Eigenschaften eines Rasters abrufen Raster haben keine definierten berschriftenzeilen oder berschriftenspalten Sie k nnen die Darstellung von berschriften emulieren indem Sie die Darstellung der Felder in der ersten Zeile oder der ersten Spalte des Rasters ndern Sie k nnen horizontal und vertikal durch Raster scrollen wenn die Breite oder H he des Rasters ber den Bildschirmbereich hinausgeht 38 Entwicklungshandbuch Erstellen eines Raster Layouts Sie k nnen durch Aufrufen von GridFieldManager setColumnProperty die Spaltenbreite und durch Aufrufen von GridFieldManager setRowProperty die Zeilenh he angeben Wenn Sie diese Methoden aufrufen m ssen Sie eine
54. che Trackball Bewegung mithilfe spezieller Einheiten die als Ticks bezeichnet werden Wenn die Anzahl der Ticks entlang einer Achse den Schwellenwert des Systems oder einer BlackBerry Ger teanwendung berschreitet wird ein Navigationsereignis an die Softwareschicht gesendet und das System setzt die Tick Zahl wieder auf Null zur ck Auch nach einer bestimmten Leerlaufzeit wird die Tick Zahl wieder auf Null zur ckgesetzt Mit der Trackball API k nnen Sie die Trackball Empfindlichkeit festlegen Eine hohe Trackball Empfindlichkeit entspricht einem kleineren Tick Schwellenwert ein geringe Trackball Bewegung erzeugt ein Navigationsereignis Eine niedrige Trackball Empfindlichkeit entspricht einem gr eren Tick Schwellenwert ein gr ere Trackball Bewegung ist erforderlich um ein Navigationsereignis zu erzeugen Entwicklungshandbuch Trackwheel Trackball Bewegung Mit der Trackball API filtern Sie die Trackball Bewegungsdaten die die Hardware des BlackBerry Ger ts an die Softwareschicht sendet Die Trackball API filtert Bewegungen Rauschen oder unerw nschte Bewegungen Mit der Trackball API k nnen Sie auch Einstellungen ndern z B die Beschleunigung beim Bewegen des Trackballs Eine h here Einstellung f r die Beschleunigung beim Bewegen des Trackballs kann dazu f hren dass die Softwareschicht die Bewegungen als scheinbar schneller erkennt als die BlackBerry Ger tehardware solange der Benutzer den Trackball fortlaufend roll
55. ckBerry Ger ten mit einem Touchscreen m ssen Benutzer auf OK klicken um ein Element aus der Liste auszuw hlen e Wenn Benutzer ein Drehfeld markieren zeigen Sie drei bis f nf Elemente bereinander an e Verwenden Sie ein erkennbares Muster f r die Abfolge der Elemente zum Beispiel 5 10 15 damit Ben k nnen wie weit sie scrollen m ssen um das Zielelement zu finden utzer absch tzen e Vermeiden Sie Benutzer horizontal scrollen zu lassen um mehrere Drehfelder anzuzeigen Unterteilen Sie Drehfelder falls notwendig in mehrere Felder 94 Entwicklungshandbuch Drehungsfelder e Wenn der Text in einem Drehfeld zu lang ist verwenden Sie Auslassungspunkte Erstellen eines Drehfelds 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui UiApplication import net rim device api ui component Dialog import net rim device api ui component TextSpinBoxField import net rim device api ui container MainScreen import net rim device api ui container SpinBoxFieldManager 2 Erstellen Sie das Anwendungsframework durch Erweitern der ViApplication Klasse Erstellen Sie in main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die HomeScreen Klasse stellt den benutzerdefinierten B
56. ckgeben Es gibt vier Datentypen die Sie an eine BasicFilteredList binden k nnen um diese mit einem AutoCompleteField zu verwenden Sie k nnen den Satz der Zeichenfolgen angeben mit dem auf eine der folgenden Arten verglichen wird 45 Entwicklungshandbuch Autocomplete Textfeld Ein Array w rtlicher Zeichenfolgen Ein Array von Objekten das toString unterst tzt Datenquellen aufeinem BlackBerry Ger t wie z B Kontakte Notizen Aufgaben und verschiedene Arten von Mediendateien Ein Array von Objekten und einem Array von Zeichenfolgen mit entsprechenden Indizes Standardm ig zeigt das autocomplete Textfeld den Satz der Zeichenfolgen an der vom Vergleichsprozess in einer Dropdown Liste zur ckgegeben wird Sie k nnen das Erscheinungsbild dieser Liste durch Angeben von Stilmarkierungen bei der Erstellung des autocomplete Textfeldes konfigurieren Sie k nnen ndern wie die Liste anzeigt wird und wie Benutzer mit der Liste interagieren k nnen Erstellen eines autocomplete Textfelds aus einem Datensatz 1 3 46 Importieren Sie die erforderlichen Klassen und Schnittstellen 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 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie
57. conds by using a fade transition _secondaryScreen add labelField TransitionContext transition new TransitionContext TransitionContext TRANSITION_SLIDE transition setIntAttribute TransitionContext ATTR_DURATION 500 transition setIntAttribute TransitionContext ATTR_DIRECTION TransitionContext DIRECTION RIGHT transition setIntAttribute TransitionContext ATTR_STYLE TransitionContext STYLE_PUSH ViEnginelnstance engine Vi getliEnginelnstance engine setTransition null _secondaryScreen UiEnginelnstance TRIGGER_PUSH transition transition new TransitionContext TransitionContext TRANSITION FADE transition setIntAttribute TransitionContext ATTR_DURATION 500 transition setIntAttribute TransitionContext ATTR_KIND TransitionContext KIND_OUT engine setITransition _secondaryScreen null UViEnginelnstance TRIGGER_POP transition MainScreen baseScreen new MainScreen baseScreen setTitle Screen Transition Sample ButtonField buttonField new ButtonField View Transition ButtonField CONSUME CLICK buttonField setChangelListener this baseScreen add buttonrField pushScreen baseScreen Entwicklungshandbuch Festlegen des Formats und der Richtung des Bildschirms _popRunnable new Runnable public void run popScreen _secondaryScreen D public void fieldChanged Field field int context pushScreen _secondaryScreen invokeLater _popRunnable 2000 false Festlegen des
58. d dass dieser auf die Anzeige oder von der Anzeige am Ger t gewischt wird TRANSITION_ZOOM Dieser bergang zeigt einen Bildschirm an oder entfernt einen Bildschirm indem dieser auf die Anzeige oder von der Anzeige am Ger t gezoomt wird TRANSITION_NONE Es findet kein bergang statt Jede Art von Bildschirm bergang hat Attribute die Sie verwenden k nnen um die visuellen Effekte des Bildschirm bergangs anzupassen Zum Beispiel k nnen Sie einen schiebenden Effekt so anpassen dass ein Bildschirm von unten am Bildschirm am Ger t nach oben am Bildschirm geschoben wird Wenn Sie den Bildschirm bergang nicht anpassen verwendet die Anwendung die Standardattribute Weitere Informationen zu den Standardattributen finden Sie in der API Referenz f r das BlackBerry Java Development Environment Nach der Erstellung eines Bildschirm bergangs m ssen Sie diese innerhalb Ihrer Anwendung durch Aufrufen von ViEnginelnstance setTransition registrieren und m ssen den zu entfernenden ausgehenden Bildschirm sowie den anzuzeigenden eingehende Bildschirm die Ereignisse die den bergang ausl sen und den anzuzeigenden bergang angeben Um eine Beispielanwendung herunterzuladen die vorf hrt wie Bildschirm berg nge verwendet werden besuchen Sie die Website www blackberry com go screentransitionssample Weitere Informationen zu Bildschirm berg ngen finden Sie in der API Referenz f r die BlackBerry Java Development Environment Anmerkung
59. d autoCompleteField Codebeispiel Erstellen eines autocomplete Felds aus einer Datenquelle 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 HomeScreen scr new HomeScreen this pushScreen scr class HomeScreen extends MainScreen public HomeScreen BasicFilteredList filterList new BasicFilteredList 49 Entwicklungshandbuch Autocomplete Textfeld filterList addDataSource l BasicFilteredList DATA_SOURCE_CONTACTS BasicFilteredList DATA_FIELD_CONTACTS_NAME FULL BasicFilteredList DATA_FIELD_CONTACTS_COMPANY BasicFilteredList DATA_FIELD_CONTACTS_ EMAIL BasicFilteredList DATA_FIELD_CONTACTS_NAME FULL BasicFilteredList DATA_FIELD_CONTACTS_COMPANY BasicFilteredList DATA_FIELD_CONTACTS_ EMAIL BasicFilteredList DATA_FIELD_CONTACTS_NAME FULL BasicFilteredList DATA_FIELD_CONTACTS_NAME FULL RIIT AutoCompleteField autoCompleteField new AutoCompleteField filterList add autoCompleteField Verwenden von Datenquellen und Feldern mit einem autocomplete Textfeld Mithilfe der Klassen AutoCompleteField und BasicFilteredList k nnen Sie den Text den ein
60. d new CheckboxField Second Check Box false public boolean onSavePrompt return true Erstellen einer Bitmap 1 Importieren Sie dienet rim device api ui component BitmapField Klasse 2 Erstellen Sie eine Instanz von BitmapField BitmapField myBitmapField new BitmapField Erstellen eines benutzerdefinierten Feldes Sie k nnen einem benutzerdefinierten Feld nur benutzerdefinierte Kontextmen eintr ge und benutzerdefinierte Layouts hinzuf gen 1 Importieren Sie die folgenden Klassen e net rim device api ui Field e java lang String e net rim device api ui Font e java lang Math e net rim device api ui Graphics Importieren Sie dienet rim device api ui DrawStyle Schnittstelle Erweitern Sie die Field Klasse oder eine ihrer Unterklassen die die DrawSty1le Schnittstelle implementieren um die Eigenschaften des benutzerdefinierten Feldes anzugeben und die Zeichnungsstile zu aktivieren public class CustomButtonField extends Field implements DrawStyle public static final int RECTANGLE 1 public static final int TRIANGLE 2 public static final int OCTAGON 3 private String _label 56 Entwicklungshandbuch Erstellen eines benutzerdefinierten Feldes private int _shape private Font _font private int _labelHeight private int _labelWidth 4 Implementieren Sie Konstruktoren um die Bezeichnung die Form und den Stil der benutzerdefinierten Schaltfl che zu definieren public CustomButtonField
61. d new RichTextField Creating a custom menu 4 Geben Sie im Bildschirmkonstruktor die Darstellung des Men s an Legen Sie durch Erstellen eines XYEdges Objekt die Abst nde f r den Rahmen um das Men fest Rufen Sie createRoundedBorder auf um einen Rahmen mit abgerundeten Ecken zu erstellen Rufen Sie createSolidTransparentBackground auf um eine transparente Hintergrundfarbe f r das Men zu erstellen XYEdges thickPadding new XYEdges 10 10 10 10 _menuBorder BorderFactory createRoundedBorder thickPadding Border STYLE_DOTTED _menuBackground BackgroundFactory createSolidTransparentBackground Color LIGHTSTEELBLUE 50 5 Geben Sie im Bildschirmkonstruktor die Schriftart f r das Men mithilfe eines FontFamily Objekts an Rufen Sie forName auf um eine Schriftart vom BlackBerry Ger t abzurufen Rufen Sie getFont auf um den Schnitt und die Gr e der Schriftart anzugeben 109 Entwicklungshandbuch ndern der Darstellung eines Men s try FontFamily family FontFamily forName BBCasual _menuFont family getFont Font PLAIN 30 Ui UNITS_px catch final ClassNotFoundException cnfe VUiApplication getUiApplication invokeLater new Runnable public void run Dialog alert FontFamily forName threw cnfe toString DE 6 Setzen Sie in der Bildschirmklasse die makeMenu 3 Methode au er Kraft um die Darstellung des Men s anzuwenden Rufen Sie setBackground setBorder
62. e Reagieren auf einen Benutzer der einen Finger schnell nach unten ber den Bildschirm bewegt 1 28 Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui TouchGesture e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf Pr fen Sie ob der von TouchGesture getSwipeDirection zur ckgegebene Wert gleich TouchGesture SWIPE_SOUTH ist Entwicklungshandbuch Reagieren auf einen Benutzer der einen Finger schnell nach rechts ber den Bildschirm bewegt protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent case TouchGesture SWIPE if gesture getSwipeDirection TouchGesture SWIPE SOUTH Dialog alert Downward swipe occurred return true return false Reagieren auf einen Benutzer der einen Finger schnell nach rechts ber den Bildschirm bewegt 1 Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui TouchGesture e net rim devic
63. e die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf 4 Pr fen Sie ob der von TouchGesture getSwipeDirection zur ckgegebene Wert gleich TouchGesture SWIPE_WEST ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent case TouchGesture SWIPE if gesture getSwipeDirection TouchGesture SWIPE WEST Dialog alert Westward swipe occurred Fewn true return false Reagieren auf einen Benutzer der auf den Bildschirm klickt 1 Importieren Sie die folgenden Klassen 30 Entwicklungshandbuch Reagieren auf einen Benutzer der den Bildschirm zweimal schnell ber hrt e net rim device api ui TouchEvent e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf Pr fen Sie ob der von TouchEvent getEvent zur ckgegebene Wert gleich To
64. e api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog 2 Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf 4 Pr fen Sie ob der von TouchGesture getSwipeDirection zur ckgegebene Wert gleich TouchGesture SWIPE_EAST ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent case TouchGesture SWIPE if gesture getSwipeDirection TouchGesture SWIPE EAST Dialog alert Eastward swipe occurred return true 29 Entwicklungshandbuch return false Reagieren auf einen Benutzer der schnell einen Finger nach rechts ber den Bildschirm bewegt Reagieren auf einen Benutzer der schnell einen Finger nach rechts ber den Bildschirm bewegt 1 Importieren Sie die folgenden Klassen net net net net net net rim rim rim rim rim rim device api device api device api device api device api device api ui ui ui ui ui ui TouchEvent TouchGesture Field Manager Screen component Dialog 2 Erstellen Sie eine Klasse die die Manager Klass
65. e sollten Screen Objekte nicht f r die Texteingabe verwenden Screen Klassen Class Beschreibung Bildschirm Sie k nnen die Screen Klasse verwenden um einen Bildschirm zu erstellen und einen Layout Manager verwenden um die Benutzeroberfl chen Komponenten auf dem Bildschirm anzulegen Sie k nnen eine bestimmte Art von Bildschirm mithilfe der Stile definieren die von den Konstanten in der bergeordneten Field Klasse definiert werden Entwicklungshandbuch Verwalten eines Zeichenbereichs Class Beschreibung FullScreen Sie k nnen die FullScreen Klasse verwenden um einen leeren Bildschirm zu erstellen dem Sie Benutzeroberfl chen Komponenten in einem standardm igen vertikalen Layout hinzuf gen k nnen Wenn Sie einen anderen Layoutstil verwenden wollen wie z B horizontal oder diagonal k nnen Sie stattdessen die Screen Klasse verwenden und einen Layout Manager hinzuf gen MainScreen Sie k nnen die MainScreen Klasse verwenden um einen Bildschirm mit den folgenden standardm igen Benutzeroberfl chen Komponenten zu erstellen e Standardbildschirmtitel mit einem SeparatorField nach dem Titel e Bildlauff higer Hauptabschnitt in einem VerticalFieldManager enthalten e Standardmen mit einem Men element Schlie en e Standardm ige Schlie en Aktion die den Bildschirm schlie t wenn der BlackBerry Ger tebenutzer auf das Men element Schlie en klickt oder die Esc Taste dr ckt Sie sollten den Einsatz ei
66. ebildschirm anzuordnen z B horizontal vertikal oder von links nach rechts Mithilfe der BlackBerry Benutzeroberfl chen APls k nnen Sie eine Benutzeroberfl che mit Tabellen Rastern und anderen speziellen Eigenschaften erstellen Sie k nnen ein standardm iges Java Ereignismodell verwenden um bestimmte Arten von Ereignissen zu empfangen und auf sie zu antworten Eine BlackBerry Ger teanwendung kann Benutzerereignisse empfangen und auf sie antworten z B wenn der Benutzer auf den Trackball klickt oder Eingaben ber die Tastatur vornimmt und kann Systemereignisse wie z B globale Warnungen Uhrzeit nderungen und USB Anschlussverbindungen empfangen und auf sie antworten Entwicklungshandbuch BlackBerry Ger t Eingabe und Navigation f r Benutzer BlackBerry Ger t Eingabe und Navigation f r Benutzer BlackBerry Ger te umfassen eine Tastatur ein Trackwheel Trackpad oder einen Trackball sowie eine Esc Taste f r die Eingabe und die Navigation Auf BlackBerry Ger ten mit einem SurePress Touchscreen entspricht das Klicken auf dem Bildschirm dem Klicken auf den Trackball oder das Trackwheel Eine BlackBerry Java Application f r BlackBerry Ger te sollte dem nachstehenden Modell f r Eingabe und Navigation so weit wie m glich folgen e Klicken auf das Trackwheel Trackpad den Trackball oder Touchscreen ffnet in der Regel ein Men e Durch Dr cken der Esc Taste k nnen Aktionen abgebrochen werden Weiterhin ist damit
67. einem Touchscreen ausf hren kann Die Geste Tippen entspricht beispielsweise der Konstante TouchGesture TAP und die Geste Fingerstrich der Konstante TouchGesture SWIPE Codebeispiel Identifizieren der Aktion die ein Benutzer auf dem Touchscreen ausf hrt Im folgenden Codebeispiel wird eine swi tch Anweisung zur Identifizierung der Aktion verwendet protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent CLICK Dialog alert A click action occurred return true case TouchEvent DOWN Dialog alert A down action occurred return true case TouchEvent MOVE Dialog alert A move action occurred return true return false 26 Entwicklungshandbuch Antworten auf Systemereignisse w hrend der Benutzer den Bildschirm ber hrt Antworten auf Systemereignisse w hrend der Benutzer den Bildschirm ber hrt 1 Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog 2 Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf 4 Pr fen Sie ob der von TouchEvent getEvent zur ckgegebene Wert g
68. einem tempor ren Paar von Managern EyelidFieldManagerDemo app new EyelidFieldManagerDemo app enterEventDispatcher public EyelidFieldManagerDemo pushScreen new EyelidFieldManagerDemoScreen class EyelidFieldManagerDemoScreen extends MainScreen public EyelidFieldManagerDemoScreen setTitle EyelidFieldManager Demo EyelidFieldManager manager new EyelidFieldManager manager addTop new LabelField Hello World HorizontalFieldManager buttonPanel new HorizonalFieldManager Field FIELD_HCENTER Field USE_ALL WIDTH 44 buttonPanel add new SimpleButton Button 1 buttonPanel add new SimpleButton Button 2 manager addBottom buttonPanel manager setEyelidDisplayTime 3 add manager Entwicklungshandbuch Benutzeroberfl chen Komponenten Benutzeroberfl chen Komponenten Hinzuf gen einer Benutzeroberfl chenkomponente zu einem Bildschirm 1 Importieren Sie die folgenden Klassen e net rim device api ui component CheckboxField e net rim device api ui container MainScreen 2 Erstellen Sie eine Instanz einer Benutzeroberfl chenkomponente CheckboxField myCheckbox new CheckboxField First checkbox true 3 F gen Sie die Benutzeroberfl chenkomponente Ihrer Erweiterung einer Screen Klasse hinzu mainScreen add myCheckbox Ausrichten eines Feldes an einer Textzeile Sie k nnen mithilfe der Markierung Field FIELD_LEADING eine Anwendung erstellen die ei
69. eines Felds um Webinhalte anzuzeigen Konfigurieren eines Browserfeldes 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api browser field2 import net rim device api ui import net rim device api ui container 2 Erstellen Sie das Anwendungsframework durch Erweitern der ViApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene BrowserFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class BrowserFieldDemo extends UiApplication public static void main String args BrowserFieldDemo app new BrowserFieldDemo app enterEventDispatcher public BrowserFieldDemo pushScreen new BrowserFieldDemoScreen 3 Erstellen Sie das Framework f r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen 4 Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserFieldConfig Klasse BrowserFieldConfig myBrowserFieldConfig new BrowserFieldConfig 5 Rufen Sie im Bildschirmkonstruktor BrowserFieldConfig setProperty auf um eine Eigenschaft des BrowserField Objekts anzugeben Der erste Para
70. ekt hinzu 1 Importieren Sie die erforderlichen Klassen und Schnittstellen mpolzteneitimsdevaleerapieunes 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 system 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene AddIconScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class AddIcon extends UiApplication public static void main String args AddIcon theApp new AddIcon theApp enterEventDispatcher public AddIcon pushScreen new AddIconScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um den Titel f r den Bildschirm anzugeben Rufen Sie add auf um dem Bildschirm ein Textfeld hinzuzuf gen Rufen Sie addMenultem auf um dem von MainScreen erstellten Men einen Men eintrag hinzuzuf gen class AddIconScreen extends MainScreen public AddIconScreen setTitle Menu Icon Sample add new RichTextField Add an icon to a menu addMenul
71. el Erstellen eines Untermen s e Codebeispiel Vor bergehendes Anzeigen eines ButtonField und eines LabelField oben bzw unten am Bildschirm e Codebeispiel Anzeigen einer Bezeichnung an einer absoluten Position auf dem Bildschirm Die folgenden Themen wurden ge ndert e Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Anwendung e Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Anwendung e Benachrichtigen lassen wenn sich die Gr e des Zeichenbereichs auf dem Touchscreen ndert e Abrufen von Beschleunigungssensordaten e Abrufen der Beschleunigungssensordaten in bestimmten Abst nden e Festlegen des Formats und der Richtung des Bildschirms e Speichern der ausgelesenen Beschleunigungssensorwerte in einem Puffer 127 Entwicklungshandbuch Rechtliche Hinweise Rechtliche Hinweise 2010 Research In Motion Limited Alle Rechte vorbehalten BlackBerry RIM Research In Motion SureType SurePress und die zugeh rigen Marken Namen und Logos sind Eigentum von Research In Motion Limited und sind in den USA und weiteren L ndern weltweit als Marken eingetragen und oder werden dort als Marken verwendet Eclipse ist eine Marke der Eclipse Foundation Inc Java ist eine Marke von Sun Microsystems Inc TrueType ist eine Marke von Apple Inc Alle weiteren Marken sind Eigentum ihrer jeweiligen Inhaber Dieses Dokument und alle Dokumente die per Verweis in dieses Dokument mit ein
72. en Fokus auf das Feld das die Benutzer wahrscheinlich zuerst verwenden werden Verwenden Sie Aufforderungstext nur dann wenn der Platz auf einem Bildschirm beschr nkt ist und Sie keine Bezeichnung und keinen Anweisungstext bereitstellen k nnen Aufforderungstext wird im Feld angezeigt und verschwindet wenn die Benutzer Eingaben vornehmen Richtlinien f r Bezeichnungen Verwenden Sie kurze klare beschreibende Bezeichnungen Vermeiden Sie Bezeichnungen mit Zeilenumbr chen Verwenden Sie die bliche Gro Kleinschreibung f r Titel Schlie en Sie die Bezeichnungen von Feldern mit einem Doppelpunkt ab Wenn Sie Aufforderungstext verwenden formulieren Sie ihn kurz und klar Verwenden Sie die bliche Gro Kleinschreibung f r S tze Erstellen eines Textfelds Erstellen eines schreibgesch tzten Textfelds das eine Formatierung erm glicht 1 2 Importieren Sie dienet rim device api ui component RichTextField Klasse Erstellen Sie eine Instanz von RichTextField RichTextFieldrich newRichTextField RichTextField Erstellen eines bearbeitbaren Textfelds das keine Formatierung besitzt und Filter akzeptiert 1 Importieren Sie die folgenden Klassen e net rim device api ui component BasicEditField s net rim device api ui component EditField Erstellen Sie eine Instanz von BasicEditField BasicEditFieldbf newBasicEditField BasicEditField 10 EditField FILTER_UPPERCASE Erstellen eines bearbeitbaren Text
73. en einer Funktion zur Bechtschreibprfung 118 Empfangen von Bechtschrebprifungserelgntssen 119 EM E N nee en ee ee es aa 121 BIOS ee ee 122 rr T osaa 123 V tzagt dbtr Bekumentbtegeiopt steel 124 RE IE TINNE SE ee ee es a a ea ee le 128 Entwicklungshandbuch Erstellen einer Benutzeroberfl che die mit normalen BlackBerry Benutzeroberfl chen kompatibel ist Erstellen einer Benutzeroberfl che die mit normalen BlackBerry Benutzeroberfl chen kompatibel ist Mithilfe der Standard MIDP APIs und der BlackBerry Benutzeroberfl chen APlIs k nnen Sie eine Benutzeroberfl che f r BlackBerry Java Application erstellen Die Benutzeroberfl chenkomponenten in den BlackBerry Benutzeroberfl chen APls wurden daf r entworfen Layouts und Verhaltensweisen bereitzustellen die den BlackBerry Device Software Anwendungen entsprechen e Bildschirmkomponenten k nnen ein Standardbildschirmlayout ein Standardmen und ein Standardverhalten bereitstellen wenn ein BlackBerry Ger tebenutzer die Esc Taste dr ckt auf das Trackwheel den Trackball oder das Trackpad klickt oder den Bildschirm ber hrt e Feldkomponenten k nnen die standardm igen Benutzeroberfl chenelemente f r die Datumsauswahl Optionsschaltfl chen Kontrollk stchen Listen Textfelder Bezeichnungen und Fortschrittsanzeigen bereitstellen Layout Manager k nnen einer Anwendung die M glichkeit geben die Komponenten auf standardm ige Weise in einem BlackBerry Ger t
74. endung von Mehrfachanzeigen in einem Dialogfeld e F gen Sie Bildlaufpfeile hinzu wenn Ihre Dialogfeldnachricht oder Schaltfl chen im Dialogfeld nicht vollst ndig angezeigt werden k nnen Wenn Sie Standardkomponenten verwenden werden Bildlaufpfeile bei Bedarf automatisch angezeigt e Geben Sie Benutzern immer die M glichkeit ein Dialogfeld mit der Esc Taste zu schlie en Vermeiden Sie das Implementieren einer anderen Aktion wenn Benutzer zum Schlie en eines Dialogfelds die Esc Taste dr cken Wenn ein Dialogfeld Benutzern beispielsweise die M glichkeit gibt eine Einstellung zu ndern implementieren Sie keine nderungen wenn Benutzer die Esc Taste dr cken Zeigen Sie bei Bedarf das Dialogfeld zu einem sp teren Zeitpunkt an 69 Entwicklungshandbuch Dialogfelder e Wenn ein Dialogfeld auf einem Anwendungsbildschirm anzeigt wird und Benutzer den Ein Aus Schalter dr cken zeigen Sie die Startseite oder die Anwendungsliste an Wenn Benutzer zur Anwendung zur ckkehren zeigen Sie wieder das Dialogfeld an e bernehmen Sie wo m glich den visuellen Stil des von den Benutzern ausgew hlten Themas Wenn Ihre Anwendung den visuellen Stil des Themas nicht bernimmt versuchen Sie den Benutzern eine konstante Arbeitsumgebung bereitzustellen e W hlen Sie zum Markieren eine Farbe aus die einen hohen Kontrast hat und einen deutlichen Fokus impliziert zum Beispiel wei er Text auf blauem Hintergrund Verwenden Sie die gleiche Mark
75. enquellenfeldern an die bereitgestellt werden sollen wenn eine bereinstimmung gefunden wird In diesem Beispiel sind die Felder mit denen verglichen wird identisch mit den Feldern die bereitgestellt werden sollen wenn eine Entwicklungshandbuch Autocomplete Textfeld bereinstimmung gefunden wird Das f nfte Argument gibt das prim re Anzeigefeld an Das sechste Argument gibt das sekund re Anzeigefeld an und ist auf 1 gesetzt wenn Sie es nicht verwenden m chten Das letzte Argument gibt einen Namen f r BasicFilteredList an Sein Wert wird automatisch generiert wenn Sie null angeben BasicFilteredList filterList new BasicFilteredList filterList addDataSource d BasicFilteredList DATA_SOURCE_CONTACTS BasicFilteredList DATA_FIELD_CONTACTS_NAME FULL BasicFilteredList DATA_FIELD_CONTACTS_COMPANY BasicFilteredList DATA_FIELD_CONTACTS_ EMAIL BasicFilteredList DATA_FIELD_CONTACTS_NAME FULL BasicFilteredList DATA_FIELD_CONTACTS_COMPANY BasicFilteredList DATA_FIELD_CONTACTS_ EMAIL BasicFilteredList DATA_FIELD_CONTACTS_NAME FULL 1 MLL 5 Erstellen Sie im Bildschirmkonstruktor ein AutoCompleteField Objekt bergeben Sie das BasicFilteredList Objekt das Sie in Schritt 4 erstellt haben an den AutoCompleteField Konstruktor um BasicFilteredListan das autocomplete Textfeld zu binden Rufen Sie add auf um das Feld dem Bildschirm hinzuzuf gen AutoCompleteField autoCompleteField new AutoCompleteField filterList ad
76. enutzeroberfla chenkampenenten a aaa 36 Anordnen von Benutzeroberfl chenkomponerten 37 Erstellen eines Raster Layauts 22a arena EN A ERA ET 38 Erstellen einer Cottergr fie eet 39 Anzeigen von Feldern in einem tempor ren Paar von Manager 42 Vor bergehendes Anzeigen eines ButtonField und eines LabelField oben bzw unten am Bildschirm 42 E ET Eet e een ENRERE 45 Hinzuf gen einer Benutzeroberfl chenkomponente zu einem Bildschirm 45 Ausrichten eines Feldes an einer Textzeile u u 0 usessenenennanenianinnanennsnsennennsinsennenann 45 Autocomplete Textfeld E 45 Erstellen eines autocomplete Textfelds aus einem Datensatz 46 Erstellen eines autocomplete Textfelds aus einer Datenquelle 48 Verwenden von Datenquellen und Feldern mit einem autocomplete Textield 50 Schaltfl chen ege een ansehen anna 52 Bew hrtes Verfahren Implementieren von Schaltfl chen 52 ErstellenreinerSchaltll che nu een een 53 Kontrollk stchen 53 Bew hrtes Verfahren Implementieren von Kontrollk stchen 54 ErstellenieinesK ntrollk stchens u aseeeaseenssanenaan anna nn nk BER 54 Erstellen einer Bmtmap 56 Erstellen eines benutzerdefinierten Feldes 56 Erstellen eines Felds um Webinhalte anzuzeigen 60 Anzeigen von HTML Inhalt in einem Browserteld 60 Anzeigen von HTML Inhalt von einer Webseite in einem Browserteld 61 Anzeigen von HTML Inhalt aus einer Ressource in Ihrer Amgendung 63 Konfigurieren eines Brows
77. er Benutzer mithilfe der Dateiauswahl eine Datei ausw hlt 88 Entwicklungshandbuch class FilePickListener implements FilePicker Listener public void selectionDone String str Dialog alert You selected str Codebeispiel Erstellen eines Dateipickers 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 FilePick extends UiApplication public static void main String args FilePick theApp new FilePick theApp enterEventDispatcher public FilePick d pushScreen new FilePickScreen class FilePickScreen extends MainScreen public FilePickScreen seilitle File Picker sanole add new LabelField Trying File Picker ViApplication getUiApplication invokeLater new Runnable public void run FilePicker fp FilePicker getInstance FilePickListener fileListener new FilePickListener fp setListener fileListener fp show H Di class FilePickListener implements FilePicker Listener public void selectionDone String str Auswahldialogfelder 89 Entwicklungshandbuch Suchfelder Diatoemaler t ven e kecte d 1 ek Sick Suchfelder Setzen Sie Suchfelder ein um es Benutzern zu erm glichen nach Elementen in einer Anwendung zu suchen Zahlreiche BlackBerry Ger teanwendungen enthalten Suchfelder Zum Beispie
78. er die Grenzen des Grafikkontexts hinaus und schneidet ihn zu XYRect rectangle new XYRect 1 1 100 100 XYPoint newLocation new XYPoint 20 20 rectangle translate newLocation Erstellen eines Bildschirm bergangs Sie k nnen einen Bildschirm bergang erstellen um einen visuellen Effekt anzuwenden der dann erscheint wenn Ihre Anwendung einen Bildschirm auf einem BlackBerry Ger t ffnet oder schlie t Sie k nnen die folgenden Arten von Bildschirm berg ngen f r Ihre Anwendung mithilfe der net rim device api ui TransitionContext Klasse erstellen 13 Entwicklungshandbuch Erstellen eines Bildschirm bergangs bergang Beschreibung TRANSITION_FADE Dieser bergang zeigt einen Bildschirm an oder entfernt einen Bildschirm durch allm hliches Ein oder Ausblenden Dieser Bildschirm bergang erzeugt den visuellen Effekt des Ein bzw Ausblendens durch nderung der Deckkraft des Bildschirms TRANSITION_SLIDE Dieser bergang zeigt einen Bildschirm an oder entfernt einen Bildschirm indem dieser auf die Anzeige oder von der Anzeige am Ger t geschoben wird Sie k nnen Attribute verwenden um anzugeben dass sowohl der neue als auch der aktuelle Bildschirm geschoben werden und dadurch ein Effekt erzeugt wird als w rden sich beide Bildschirme bewegen oder dass sich der neue ber den aktuellen Bildschirm schiebt TRANSITION_WIPE Dieser bergang zeigt einen Bildschirm an oder entfernt einen Bildschirm indem simuliert wir
79. er l schen oder die Eigenschaften des Rasters ndern Codebeispiel Erstellen eines Raster Layouts Ws GridFieldManagerDemo java x Research In Motion Limited proprietary and confidential Copyright Research In Motion Limited 2009 Motel dd ekhtu fe AACHEN ETA import net rim device api ui component Umpozteneitesiimsdeviieerapieunkseontannenss public class GridFieldManagerDemo extends UiApplication 40 Entwicklungshandbuch public static void main String args GridFieldManagerDemo theApp new GridFieldManagerDemo theApp enterEventDispatcher GridFieldManagerDemo pushScreen new GridScreen class GridScreen extends MainScreen public GridScreen setlitle GridFieldManager Demo GridFieldManager grid new GridFieldManager 2 3 0 grid add new LabelField one grid add new LabelField two grid add new LabelField three grid add new LabelField four srid add new LabelField five srid setColumnPadding 20 grid setRowPadding 20 add grid The grid looks like this one two three AA four five insert a cell first row second column grid insert new LabelField insert 1 The grid now looks like this I one insert two I three four five delete a cell second row second column enidrdeilete Cimbi The grid now looks like this one insert two Wi three five Add
80. erforderlichen Klassen und Schnittstellen import net rim device api browser field2 import net rim device api io http import net rim device api system impostsnetarn nndeviieerapiz len import net rim device api ui container import java lang import java util 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene BrowserFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar 66 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen public class BrowserFieldDemo extends UiApplication public static void main String args BrowserFieldDemo app new BrowserFieldDemo app enterEventDispatcher public BrowserFieldDemo pushScreen new BrowserFieldDemoScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen 4 Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserField Klasse BrowserField browserField new BrowserField 5 Rufen Sie im Bildschirmkonstruktor add auf um dem Bildschirm das BrowserField Ob
81. erteldes SEENEN EENEG 65 Senden von Formulardaten an eine Webadresse in einem Browserteld 66 Di l gfelder sense habe bite ab krnbe E en aa 68 Erstellenreines Dialogfeldseesauneeeennee ana zum 69 Dropdown DOC EE 71 Bew hrtes Verfahren Implementieren von Dropdown Listen 72 Erstellen einerDropdown Listern nunseseeni ne Ran ER ER nee 72 BEZEICHNUNGEN er a ea er a a a na se en SE BR Re ee Ra BE ea a a ER ER rs AEA 74 Bew hrtes Verfahren Implementieren von Bezeichnungen 75 Erstellen eines Textetiketts u 22 2 ss hiess e Berlin Boi nah insb 75 Ie tt eege ee EE 75 Bew hrtes Verfahren Implementieren von Listen 76 ee ENN DE 76 Riegel DES 78 Bew hrtes Verfahren Implementieren von Optionsschahtfl chen 78 Erstelleneiner Optionstaste 2 8en er ann RER III DIGG ZIEL 79 ele NIE EE 81 Bew hrtes Verfahren Implementieren von Fortschrtttsanzegen 81 Erstellen einerFortschrittsanzeilge aussen AEA AEE EE 82 A swahldidl gtelder eene EE EES 82 Bew hrtes Verfahren Implementieren von Auswahldualogteldern 84 Erstellen einer Datumsauswahlieii assgateeen iin AR ERIMERESERRR BREI ER 84 Erstelletreger Hatetgtewabl aere EE 87 Sie 90 Bew hrtes Verfahren Implementieren von Suchfelderm 91 Erstellen einesss chfelds 2e 2 22 eeh EE 91 Drehunasfelder aseiteseneiinsshenhkelis BIER a bh anilkeoerke a 93 Bew hrtes Verfahren Implementieren von Drehielderm 94 Erstellen eines Drehfeldsiuas susanne BIRSLIHe BEE ER ie Besen 95 Textfeldern esse ste Ee
82. et rim device api ui component Paket enthalten ist um ein Benutzeroberfl chenfeld bereitzustellen das aus einem einzelnen Texteingabefeld und einer Liste ausw hlbarer Elemente besteht W hrend die Benutzer Text in ein Suchfeld eingeben filtert die Anwendung die Elemente in der Liste die mit dem Suchtext beginnen Weitere Informationen zur Verwendung derKeywordFilterField Klasse finden Sie in der Beispielanwendung zum Stichwortfilterfeld die in der BlackBerry Java Development Environment Version 4 3 1 oder h her enthalten ist 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api collection util SortedReadablelist import net rim device api io LineReader import net rim device api ui component KeywordFilterField 91 Entwicklungshandbuch Suchfelder ER import net rim device api ui component KeywordProvider import java io InputStream import java lang String import java util Vector Erstellen Sie Variablen Im folgenden Codebeispiel erweitert CountryList die SortedReadableLlist Klasse und implementiert die KeywordProvider Schnittstelle private KeywordFilterField _keywordField private CountryList _CountryList private Vector _countries Um eine Liste ausw hlbarer Textelemente zu erstellen f llen Sie einen Vektor mit Daten aus einer Textdatei _ countries getDataFromFile Erstellen Sie eine Instanz einer Klasse die die SortedReadableList Klasse erweitert _CountryList new
83. felds das Sonderzeichen erm glicht 1 Importieren Sie dienet rim device api ui component EditField Klasse 99 Entwicklungshandbuch Textfelder 2 Erstellen Sie eine Instanz von EditField tcloeezsbkallrel ebe e Tut Edit En EdC Edited OF Ede leid EI le S DEFRAUD Erstellen eines Textfelds f r AutoText Wenn ein Textfeld AutoText unterst tzt wenn Benutzer zweimal die Leertaste dr cken f gt das BlackBerry Ger t einen Punkt ein schreibt den n chsten Buchstaben nach einem Punkt gro und ersetzt W rter gem den Definitionen in der AutoText Anwendung 1 Importieren Sie die folgenden Klassen e net rim device api ui component AutoTextEditField e net rim device api ui autotext AutoText e net rim device api ui component BasicEditField 2 Erstellen Sie eine Instanz von AutoTextEditField AutoTextEditField autoT new AutolextEditField AutolextEditField Erstellen eines Datumsfelds 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui import net rim device api ui component import net rim device api ui container import java lang 2 Erstellen Sie das Anwendungsframework durch Erweitern der ViApplication Klasse Erstellen Sie in main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die
84. g durch Erweitern der MainScreen Klasse Rufen Sie im Konstruktor setTitle auf um einen Titel auf dem Bildschirm anzuzeigen Rufen Sie add auf um ein Rich Text Feld auf dem Bildschirm anzuzeigen class DatePickScreen extends MainScreen public DatePickScreen setalmktalei DaitezRiieckersSsampilend e add new RichTextField Trying Date Picker 4 F gen Sie der Ereigniswarteschlange der Anwendung durch Aufrufen von invokeLater einen Codeabschnitt hinzu Erstellen Sie ein Runnable Objekt und bergeben Sie es als Parameter an invokeLater Setzen Sierun in der Definition von Runnable au er Kraft class DatePickScreen extends MainScreen public DatePickScreen St Tt eut Dates RiickerzssampilesdE add new RichTextField Trying Date Picker ViApplication getUiApplication invokeLater new Runnable public void run DE 5 Rufen Sie in run die Methode DateTimePicker getInstance auf um ein DateTimePicker Objekt zur ckzugeben Rufen Sie doModal auf um die Datumsauswahl anzuzeigen Rufen Sie doModal auf um ein Calendar Objekt zur ckzugeben das das Datum und die Uhrzeit darstellt die der Benutzer ausw hlt Verwenden Sie getTime um das Datum und die Uhrzeit als Date Objekt zur ckzugeben Verwenden Sie Dialog alert um das ausgew hlte Datum und die Uhrzeit anzuzeigen class DatePickScreen extends MainScreen public DatePickScreen 85 Entwicklungshandbuch set
85. handbuch Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung i public static void main String args FontLoadingDemo app new FontLoadingDemo app enterEventDispatcher public FontLoadingDemo pushScreen new FontLoadingDemoScreen gt FontLoadingDemoScreen extends MainScreen public FontLoadingDemoScreen setlitle Font Loading Demo LabelField helloworld new LabelField Hello World if FontManager getInstance load Myfont ttf MyFont FontManager APPLICATION_FONT FontManager SUCCESS try FontFamily typeface FontFamily forName Charming Font myFont typeface getFont Font PLAIN 50 helloWorld setFont myFont catch ClassNotFoundException e add helloWorld System out printin e getMessage 117 Entwicklungshandbuch Rechtschreibpr fung Rechtschreibpr fung Sie k nnen die Elemente im Paketnet rim blackberry api spellcheck verwenden um einer Anwendung die Funktion zur Rechtschreibpr fung hinzuzuf gen Die SpellCheckEngine Schnittstelle bef higt eine Anwendung die Rechtschreibung eines Ul Feld Wertes zu pr fen und gibt einem BlackBerry Ger tebenutzer die Optionen zur Rechtschreibkorrektur Die SpellCheckUI Schnittstelle bef higt eine Anwendung eine Benutzeroberfl che bereitzustellen die es einem BlackBerry Ger tebenutzer erm glicht ein Rechtschreibeproblem durch Interagieren mit der SpellCheckEngine I
86. hinzu Rufen Sie add auf um den Manager sowie die Felder die er enth lt dem Bildschirm hinzuzuf gen spinBoxMgr add spinBoxDays spinBoxMgr add spinBoxMonths add spinBoxMgr Codebeispiel Erstellen eines Drehfelds 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 SpinBoxApp extends UiApplication public static void main String args SpinBoxApp app new SpinBoxApp app enterEventDispatcher public SpinBoxApp HomeScreen homeScreen new HomeScreen pushScreen homeScreen class HomeScreen extends MainScreen TextSpinBoxField spinBoxDays TextSpinBoxField spinBoxMonths SpinBoxFieldManager spinBoxMgr public HomeScreen final String DAYS Monday Tuesday Wednesday Thursday Friday Saturday Sunday final String MONTHS lU Ee Eeer E EE ber October November December spinBoxMgr new SpinBoxFieldManager spinBoxDays new TextSpinBoxField DAYS spinBoxMonths new TextSpinBoxField MONTHS spinBoxMgr add spinBoxDays 96 Entwicklungshandbuch Textfelder spinBoxMgr add spinBoxMonths add spinBoxMgr public void close Dialog alert You selected String spinBoxDays get spinBoxDays getSelectedIndex and
87. ichnungen 106 Verwenden Sie kurze und klare beschreibende Bezeichnungen die nicht l nger als 12 Zeichen sind Wenn eine Bezeichnung zu lang ist werden Auslassungspunkte angezeigt um zu verdeutlichen dass der Text abgeschnitten ist Verwenden Sie Verben f r Bezeichnungen Verwenden Sie die bliche Gro Kleinschreibung f r Bezeichnungen Verwenden Sie Auslassungspunkte in einer Men eintragsbezeichnung um anzuzeigen dass Benutzer nach dem Klicken auf den Men eintrag eine weitere Aktion ausf hren m ssen Wenn Benutzer zum Beispiel im Kalender auf den Men eintrag Wechseln zu Datum klicken m ssen sie auf dem eingeblendeten Bildschirm ein Datum angeben Vermeiden Sie in Bezeichnungen die Verwendung von Symbolen wie z B Sternchen Entwicklungshandbuch Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Anwendung Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Anwendung Sie k nnen einer BlackBerry Device Software Anwendung mithilfe der API f r Men eintr ge im net rim blackberry api menuitem Paket einen Men eintrag hinzuf gen Sie k nnen zum Beispiel der Kontaktanwendung auf einem BlackBerry Ger t einen Men eintrag namens Auftrag anzeigen hinzuf gen damit wenn ein Benutzer auf den Men eintrag klickt eine CRM Anwendung ge ffnet und eine Liste der Auftr ge f r diesen Kontakt angezeigt wird Die ApplicationMenultemRepository Klasse stellt die Konstanten bereit d
88. ics fillRect auf um das Rechteck zu f llen Rufen Sie Graphics popContext auf um den aktuellen Kontext vom Kontextstapel loszul sen graphics pushContext rectangle 0 graphics fillRect 10 10 30 30 graphics drawRect 15 15 30 30 graphics popContext graphics drawRect 15 15 30 30 graphics pushContext rectangle graphics fillRect 10 10 30 30 graphics drawRect 15 15 30 30 graphics popContext graphics drawRect 15 15 30 30 4 Rufen Sie pushRegion auf und geben Sie an dass der Bereichsursprung den Zeichen Offset anpassen soll Rufen Sie Graphics drawRect auf um ein Rechteck zu zeichnen und rufen Sie Graphics fillRect auf um ein Rechteck zu f llen Rufen Sie Graphics popContext auf um den aktuellen Kontext vom Kontextstapel loszul sen graphics pushRegion rectangle Birstsluie 20 LUibieee 2 26 2191 SI graphics drawRect 15 15 30 30 graphics popContext 5 Geben Sie den Teil des Graphics Objekts an der mittels Push zum Stapel bertragen werden soll Nachdem Sie pushContext oder pushRegion aufgerufen haben stellen Sie den Teil des Graphics Objekts bereit der invertiert werden soll graphics pushContext rectangle graphics invert rectangle graphics popContext 7 RufenSietranslate auf DasXYRect Objekt wird von seinem Ursprung 1 1 in einen Ursprung 20 20 konvertiert Nach der Konvertierung reicht der untere Teil des XYRect Objekts b
89. ie die BlackBerry Device Software Anwendung angeben in der Ihr Men eintrag angezeigt werden sollte Die MENUITEM_MESSAGE_LIST Konstante gibt zum Beispiel an dass der Men eintrag in der Nachrichtenanwendung angezeigt werden soll Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Anwendung 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim blackberry api menuitem import net rim blackberry api pdap import net rim device api ui import net rim device api ui component 2 Erweitern Sie die abstrakte ApplicationMenultem Klasse um einen Men eintrag zu erstellen Setzen Sie den ApplicationMenultem Konstruktor mit einer Ganzzahl au er Kraft um die Position des Men eintrags im Men anzugeben Durch eine h here Zahl wird der Men eintrag weiter unten im Men platziert public class SampleMenultem extends ApplicationMenultem SampleMenultem super 20 3 Implementieren Sie toString um den Men eintragstext anzugeben public String toString 4 Rufen Sie getInstance auf um die Anwendungsdatenbank abzurufen return Open the Contacts Demo application ApplicationMenultemRepository repository ApplicationMenultemRepository getInstance 5 Erstellen Sie eine Instanz einer Klasse um die Menultem Klasse zu erweitern 107 Entwicklungshandbuch ndern der Darstellung eines Men s ContactsDemoMenultem contactsDemoMenultem new ContactsDemoMen
90. ie ein Listenfeld um eine Liste anzuzeigen aus der Benutzer eine oder mehrere Werte ausw hlen k nnen 1 Importieren Sie die folgenden Klassen import net rim device api system Impolsteneitar nadeviicerapieune import net rim device api ui component import net rim device api ui container import java util Vector 2 Erstellen Sie das Anwendungsframework durch Erweitern der ViApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die CreateMenuScreen Klasse stellt den benutzerdefinierten Bildschirm dar der in Schritt 3 beschrieben wird public class ListFields extends UiApplication public static void main String args ListFields theApp new ListFields theApp enterEventDispatcher public ListFields pushScreen new ListFieldScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Konstruktor setTitle auf um den Titel f r den Bildschirm anzuzeigen Rufen Sie add auf um ein Textfeld auf dem Bildschirm anzuzeigen Rufen Sie addMenultem auf um dem von MainScreen erstellten Men einen Men eintrag hinzuzuf gen class ListFieldScreen extends MainScreen private ListField _listField
91. ieren Sie beispielsweise zusammen geh rende Elemente oder f hren Sie die h ufigsten Elemente zuerst an Vermeiden Sie es die Werte alphabetisch anzuordnen weil die alphabetische Reihenfolge sprachspezifisch ist e Verwenden Sie die bliche Gro Kleinschreibung f r Titel e Interpunktieren Sie die Bezeichnung mit einem Doppelpunkt Erstellen eines Textetiketts 1 Importieren Sie dienet rim device api ui component LabelField Klasse 2 Erstellen Sie eine Instanz von einem LabelField um einem Bildschirm ein Textetikett hinzuzuf gen LabelField title new LabelField UI Component Sample LabelField ELLIPSIS Listen Verwenden Sie eine Liste um Elemente anzuzeigen die Benutzer markieren und ffnen k nnen Benutzer k nnen in einer Liste die folgenden Aktionen ausf hren Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen Markieren Sie ein e Drehen Sie das Trackwheel oder den Ber hren Sie das Element leicht Element in der Liste Trackball e Fahren Sie mit einem Finger ber das Trackpad 75 Entwicklungshandbuch Listen Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen ffnen Sie ein Element Klicken Sie auf das Element oder dr cken Sie Klicken Sie auf den Bildschirm in der Liste die Eingabetaste Bew hrtes Verfahren Implementieren von Listen e Verwenden Sie die ListField Klasse um Listen zu erstellen Erstellen eines Listenfelds Verwenden S
92. ierungsfarbe f r alle Steuerungen e Vermeiden Sie eine Festcodierung von Farbwerten Die von Ihnen gew hlte Farbe funktioniert m glicherweise nicht mit dem Thema das Benutzer ausgew hlt haben Richtlinien f r das Layout e Zenteren Sie das Dialogfeld auf dem Bildschirm Wenn Sie Standardkomponenten verwenden zentriert das BlackBerry Ger t automatisch das Dialogfeld e Erstellen Sie Dialogfelder die 90 oder weniger der Breite bzw der H he des Bildschirms haben Wenn Sie Standardkomponenten verwenden berechnet das BlackBerry Ger t automatisch die entsprechende Gr e der Dialogfelder e Zenteren Sie die Dialogfeldanzeige senkrecht zur Dialogfeldnachricht e Zeigen Sie Nachrichten rechts von der Anzeige und oberhalb Schaltfl chen an e Platzieren Sie Schaltfl chen f r Best tigungsaktionen zuerst Platzieren Sie beispielsweise Speichern vor Verwerfen oder Abbrechen e Zenteren Sie Schaltfl chen in Dialogfeldern horizontal e Platzieren Sie Schaltfl chen senkrecht in das Dialogfeld Das senkrechte Layout erm glicht die Erweiterung von Schaltfl chen um lokalisierte Schaltfl chenbezeichnungen anzupassen Richtlinien f r Nachrichten e Seien Sie m glichst genau Falls m glich verwenden Sie einen kurzen Satz der deutlich den Grund zum Anzeigen des Dialogfelds und der Aktionen erkl rt die es schlie en k nnen e Verwenden Sie nach M glichkeit f r Nachrichten vollst ndige S tze e Verwenden Sie den Wo
93. ildschirm dar der in Schritt 3 beschrieben wird public class SpinBoxApp extends UiApplication public static void main String args SpinBoxApp app new SpinBoxApp app enterEventDispatcher public SpinBoxApp pushScreen new HomeScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern derMainScreen Klasse Deklarieren Sie eine Variable f r jedes Feld im Drehfeld sowie eine Variable f r den Drehfeld Manager class HomeScreen extends MainScreen TextSpinBoxField spinBoxDays TextSpinBoxField spinBoxMonths SpinBoxFieldManager spinBoxMgr public HomeScreen 4 Erstellen Sie im Bildschirmkonstruktor f r jedes der Drehfelder ein Array von String Objekten final String DAYS Monday Tuesday Wednesday Thursday Friday Saturday Sunday final String MONTHS a Janter w a T Eelotemsear y HEren s AD T LU Maya was Puy AUI ust September October November December 95 Entwicklungshandbuch Drehungsfelder 5 Erstellen Sie im Bildschirmkonstruktor neue Instanzen des Drehfeld Managers sowie der zwei Drehfelder bergeben Sie das entsprechende Array von Zeichenfolgen als Argumente an jeden der Drehfeldkonstruktoren spinBoxMgr new SpinBoxFieldManager spinBoxDays new TextSpinBoxField DAYS spinBoxMonths new TextSpinBoxField MONTHS 6 F gen Sie im Bildschirmkonstruktor dem Drehfeld Manager die Drehfelder
94. inal ClassNotFoundException cnfe VUiApplication getUiApplication invokeLater new Runnable public void run Dialog alert FontFamily forName threw cnfe toString DE protected void makeMenu Menu menu int context menu setBorder _menuBorder menu setBackground _menuBackground menu setFont _menuFont super makeMenu menu context Hinzuf gen eines Symbols zu einem Men eintrag Sie k nnen einem Men element ein Symbol mithilfe desMenultemsimNet rim device api ui Pakets hinzuf gen Das BlackBerry Ger t berechnet die Gr e vom Symbol und zentriert das Symbol nach links oder rechts vom Men elementtext wenn es das Men anlegt Das Symbol richtet sich nach links oder rechts vom Men elementtext abh ngig von der Textrichtung aus zum Beispiel bei der Textrichtung von links nach rechts richtet sich das Symbol links vom Text aus Falls notwendig ndert das BlackBerry Ger t die H he und Breite des Symbols in Beziehung zur H he der Standardschriftart die die BlackBerry Ger teanwendung verwendet Wenn das BlackBerry Ger t die Gr e des Bilds ndert bewahrt es das Bildformat vom Bild Anmerkung Sie k nnen einem vordefinierten Men element kein Symbol hinzuf gen zum BeispielMenultem SAVE CLOSE 11 Entwicklungshandbuch Hinzuf gen eines Symbols zu einem Men eintrag Hinzuf gen eines Symbols zu einem Men eintrag Vor Beginn erforderliche Aktion F gen Sie das Symbol Ihrem Proj
95. ine Aktion auszuf hren Die Gr e des Dialogfelds h ngt von der Gr e des BlackBerry Ger tebildschirms ab Bildlaufpfeile werden falls notwendig angezeigt Das Thema das Benutzer auf ihrem BlackBerry Ger t ausw hlen bestimmt den visuellen Stil des Dialogfelds Indicator Message Find dd Contact 2 Delete lan Dundas DARGA inactive button Cancel Default button Erstellen eines Dialogfelds Verwenden Sie Alarmdialogfelder um Benutzer auf eine kritische Aktion hinzuweisen wie z B das Ausschalten des BlackBerry Ger ts oder auf einen Fehler wie z B das Eingeben ung ltiger Informationen In einem Alarmdialogfeld wird ein Ausrufezeichen angezeigt Um ein Alarmdialogfeld zu schlie en k nnen Benutzer auf OK klicken oder die Esc Taste dr cken Weitere Informationen zu anderen Arten von Dialogfeldern finden Sie in der APl Referenz f r die BlackBerry Java Development Environment 1 Importieren Sie dienet rim device api ui component Dialog Klasse 2 Erstellen Sie ein Alarmdialogfeld das den Alarmtext enth lt den Sie anzeigen m chten Dialog alert Specify the alert text that you want to display Bew hrtes Verfahren Implementieren von Dialogfeldern e Verwenden Sie immer Schaltfl chen zur Steuerung in Dialogfeldern Vermeiden Sie die Verwendung von Links oder anderen Steuerelementen e Verwenden Sie eine Standardanzeige die der Art des Dialogfelds entspricht Vermeiden Sie die Verw
96. ine aussagekr ftige Meldung ber den aktuellen Vorgang bereitstellen k nnen Um die Garbage Collection anzuzeigen verwenden Sie den animierten Uhren Cursor f r das Precision Thema oder einen animierten Sanduhr Cursor f r das Dimension Thema bernehmen Sie wo m glich den visuellen Stil des von den Benutzern ausgew hlten Themas Wenn Ihre Anwendung den visuellen Stil des Themas nicht bernimmt versuchen Sie den Benutzern eine konstante Arbeitsumgebung bereitzustellen Verwenden Sie eine kurze und klare beschreibende Bezeichnung zum Beispiel Daten werden geladen oder Anwendungsliste wird erstellt Verwenden Sie die bliche Gro Kleinschreibung f r S tze Schlie en Sie die Dialogfeldmeldung mit Auslassungspunkten ab Erstellen einer Fortschrittsanzeige 1 2 Importieren Sie dienet rim device api ui component GaugeField Klasse Erstellen Sie eine Instanz von GaugeField GaugeField percentGauge new GaugeField Percent 1 100 29 GaugeField PERCENT Auswahldialogfelder Sie k nnen Auswahldialogfelder verwenden um Benutzern zu helfen ein Element von einer Liste problemlos auszuw hlen Auswahltyp Beschreibung 82 Datei Diese Auswahl erm glicht Benutzern ihre BlackBerry Ger te nach Dateien zu durchsuchen Entwicklungshandbuch Auswahltyp Ort Date Time Beschreibung Auswahldialogfelder Select SEINERTEREE EES Nd m Up Track 01 6 MB Track 02 4MB Track 03 10 MB Track
97. inzuzuf gen Erstellen Sie ein Runnable Objekt und bergeben Sie es als Parameter an invokeLater WI class FilePickScreen extends MainScreen public FilePickScreen Steng Tag let File Picker samole add new LabelField Trying File Picker ViApplication getUiApplication invokeLater new Runnable public void run WE 5 Setzen Sie run in der Definition von Runnable au er Kraft Rufen Sie in run die Methode FilePicker getInstance auf um ein FilePicker Objekt zur ckzugeben Erstellen Sie ein FilePickListener Objekt das in Schritt 6 beschrieben wird Rufen Sie setListener auf um den Listener f r die Dateiauswahl zu registrieren Rufen Sie show auf um die Dateiauswahl auf dem Bildschirm anzuzeigen class FilePickScreen extends MainScreen public FilePickScreen Secnieler uEiikesBiickeizzsanmpikess E add new LabelField Trying File Picker VUiApplication getUiApplication invokeLater new Runnable public void run Eillle iekerzripz Enlle itekenmsetinstaneeOE FilePickListener fileListener new FilePickListener en El len eet Cl eltern H fp show DE 6 RufenSieDialog alert auf um ein Dialogfeld mit einer Meldung zu erstellen die anzeigt welche Datei ausgew hlt wurde Rufen Sie Dialog alert in einer Klasse auf die die FilePicker Listener Schnittstelle durch Au erkraftsetzen von selectionDone implementiert Die Anwendung ruft selectionDone auf wenn d
98. ioButtonGroup Klasse erstellen Ein Benutzer kann nur eine Option von einer Gruppe der Optionstasten ausw hlen 1 Importieren Sie die erforderlichen Klassen und Schnittstellen importane tamm devn CETA import net rim device api ui component import net rim device api ui container 2 Erstellen Sie das Anwendungsframework durch Erweitern der ViApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene MyUiScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class MyUi extends UiApplication public static void main String args MyUi theApp new MyUi theApp enterEventDispatcher public MyUi pushScreen new MyUiScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um den Titel f r den Bildschirm anzugeben class My UiS creen extends MainScreen public MyUiScreen 79 Entwicklungshandbuch Optionsfelder setlitle UI Component Sample Erstellen Sie im Bildschirmkonstruktor eine Gruppe der Optionstasten mithilfe der RadioButtonGroup Klasse Erstellen Sie die Optionstasten die Sie der Gruppe mithilfe der Radi
99. is der Bildschirm ber die gesamte Breite gef llt ist Wenn keine weiteren Benutzeroberfl chenkomponenten in die erste Zeile passen wird die n chste Benutzeroberfl chenkomponente unter die erste Zeile von Komponenten in einer Zeile platziert deren H he der H he der gr ten Komponente in der Zeile dar ber entspricht Sie k nnen vertikale Stil Bits zum BeispielField FIELD TOP Field FIELD_BOTTOM oder Field FIELD_VCENTER anwenden um Benutzeroberfl chenkomponenten innerhalb ihrer Zeile vertikal auszurichten HorizontalFieldManager Dieser Layout Manager ordnet Benutzeroberfl chenkomponenten in einer einzelnen horizontalen Zeile vom linken und zum rechten Rand des Bildschirms an Weil dieser Layout Manager Benutzeroberfl chenkomponenten horizontal anordnet k nnen Sie auf die Benutzeroberfl chenkomponenten keine horizontalen Stil Bits zum BeispielField FIELD_LEFT Field FIELD _HCENTER oder Field FIELD_RIGHT anwenden Sie k nnen vertikale Stil Bits zum Beispiel Field FIELD_TOP Field FIELD_BOTTOM oder Field FIELD_VCENTER anwenden Wenn die Benutzeroberfl chenkomponenten die verf gbare Breite des Bildschirm berschreiten sollten Sie das Manager HORIZONTAL_SCROLL Stil Bit verwenden um ein horizontales Scrollen zu erm glichen Andernfalls werden auf dem Bildschirm so viele Benutzeroberfl chenkomponenten wie innerhalb der 36 Entwicklungshandbuch Anordnen von Benutzeroberfl chenkomponenten Layout Manager Beschreibung
100. jekt hinzuzuf gen add browserField 6 Erstellen Sie im Bildschirmkonstruktor ein String Objekt das die Basis Webadresse der Webseite enth lt an die Sie die Formulardaten senden String baseURL http www blackberry com 7 Erstellen Sie im Bildschirmkonstruktor ein String Objekt das die Formulardaten angibt die Ihre Anwendung an die Webseite sendet String postData fieldnamel valuel amp fieldname2 value2 8 Erstellen Sie im Bildschirmkonstruktor ein Hashtable Objekt um die Kopfzeileninformationen f r die Formulardaten zu speichern Hashtable header new Hashtable 9 Rufen Sie im Bildschirmkonstruktor Hashtable put auf um die Kopfzeileninformationen f r die Formulardaten anzugeben header put Content Length postData length header put Content Type application x www form urlencoded 10 Rufen Sie im Bildschirmkonstruktor BrowserField requestContent auf um die Formulardaten an die Webseite zu senden und die Webseite anzuzeigen 67 Entwicklungshandbuch Dialogfelder browserField requestContent baseURL postData getBytes new HttpHeaders header Codebeispiel Senden von Formulardaten an eine Webadresse in einem Browserfeld import import import import import import import public net rim device api browser field2 ETH EE UE net rim device api system AIS JE lu Siet DLC net rim device api ui container leet Leurs o Jee We 7 class BrowserFie
101. k stchen hinzuzuf gen add new CheckboxField First Check Box true add new CheckboxField Second Check Box false Um das Standardverhalten eines Kontrollk stchens zu ndern verwenden Sie die Stile die von der Field Klasse geerbt wurden Um zum Beispiel ein Kontrollk stchen zu erstellen dass die Benutzer nicht ndern k nnen verwenden Sie den READONLY Stil add new CheckboxField First Check Box true this READONLY Um die Standardfunktionalit t au er Kraft zu setzen die den Benutzer auffordert nderungen vor dem Schlie en der Anwendung zu speichern setzen Sie in der Erweiterung der MainScreen Klasse die MainScreen onSavePrompt Methode au er Kraft Im folgenden Codebeispiel lautet der R ckgabewert true wodurch angezeigt wird dass die Anwendung den Benutzer vor dem Schlie en nicht auffordert public boolean onSavePrompt return true Codebeispiel Erstellen eines Kontrollk stchens impolstene erzinndevileeza pen es import net rim device api ui component import net rim device api ui container public class MyUi extends UiApplication public static void main String args MyUi theApp new MyUi theApp enterEventDispatcher public MyUi 55 Entwicklungshandbuch Erstellen einer Bitmap pushScreen new MyUiScreen class MyUiScreen extends MainScreen public MyUiScreen setTitle UI Component Sample add new CheckboxField First Check Box true ad
102. keiten anzubieten wenn der Platz nicht beschr nkt ist Wenn der Platz beschr nkt ist erw gen Sie stattdessen eine Dropdown Liste zu verwenden Verwenden Sie die RadioButtonField Klasse um Optionsschaltfl chen zu erstellen Vergewissern Sie sich dass der Inhalt f r Optionsschaltfl chen statisch bleibt Inhalt f r Optionsschaltfl chen sollte nicht in Abh ngigkeit vom Kontext ge ndert werden Starten Sie keine Aktion wenn Benutzer eine Optionsschaltfl che ausw hlen Zum Beispiel keinen neuen Bildschirm ffnen Richten Sie Optionsschaltfl chen vertikal aus Entwicklungshandbuch Optionsfelder e Gruppieren und ordnen Sie die Werte m glichst logisch fassen Sie zum Beispiel zusammenh ngende Optionsschaltfl chen in Gruppen zusammen oder beginnen Sie mit den gebr uchlichsten Werten Vermeiden Sie es die Optionsschaltfl chen alphabetisch anzuordnen weil die alphabetische Reihenfolge sprachspezifisch ist Richtlinien f r Bezeichnungen e Verwenden Sie kurze klare Bezeichnungen Vergewissern Sie sich dass das Bezeichnung klar beschreibt was geschieht wenn Benutzer die Optionsschaltfl che ausw hlen Wenn die Bezeichnungen zu lang sind erfolgt ein Zeilenumbruch e Platzieren Sie Bezeichnungen rechts von den Optionsschaltfl chen e Verwenden Sie die bliche Gro Kleinschreibung f r Titel e Verwenden Sie keine Ende Interpunktion Erstellen einer Optionstaste Sie k nnen eine Gruppe der Optionstasten mithilfe der Rad
103. l ohne M ngelgew hr und ohne ausdr ckliche oder konkludente Bedingungen Billigungen Garantien Zusicherungen oder Gew hrleistungen jeglicher Art von 129 Entwicklungshandbuch Rechtliche Hinweise RIM bereitgestellt und RIM bernimmt in diesem Zusammenhang keine Haftung Die Verwendung von Drittprodukten und diensten unterliegt Ihrer Zustimmung zu den Bedingungen separater Lizenzen und anderer geltender Vereinbarungen mit Dritten sofern sie nicht ausdr cklich von einer Lizenz oder anderen Vereinbarung mit RIM behandelt wird Bestimmte in diesem Dokument angef hrte Funktionen erfordern eine Mindestversion von BlackBerry Enterprise Server BlackBerry Desktop Software und oder BlackBerry Device Software Die Nutzungsbedingungen f r RIM Produkte und Dienste werden in einer entsprechenden separaten Lizenz oder anderen Vereinbarung mit RIM dargelegt KEINE DER IN DIESER DOKUMENTATION DARGELEGTEN BESTIMMUNGEN SETZEN IRGENDWELCHE AUSDR CKLICHEN SCHRIFTLICHEN VEREINBARUNGEN ODER GEW HRLEISTUNGEN VON RIM F RTEILE VON RIM PRODUKTEN ODER DIENSTEN AUSSER KRAFT Research In Motion Limited 295 Phillip Street Waterloo ON N2L3W8 Canada Research In Motion UK Limited Centrum House 36 Station Road Egham Surrey TW20 9LF United Kingdom Ver ffentlicht in Kanada 130
104. l k nnen Benutzer in der Aufgabenliste ein Suchfeld verwenden um nach bestimmten Aufgaben zu suchen W hrend Benutzer Text in ein Suchfeld eingeben sucht die Anwendung danach und zeigt Elemente an die mit dem Suchtext beginnen Wenn Benutzer mehrere W rter in das Suchfeld eingeben zeigt die Anwendung Ergebnisse an die beiden W rtern entsprechen Wenn Benutzer beispielsweise bi zu eingeben gibt die Anwendung alle Elemente zur ck die ein Wort enthalten das mit bi beginnt und ein Wort enthalten das mit zu beginnt wie z B bitte zur ckrufen Benutzer k nnen in einem Suchfeld folgende Aktionen ausf hren Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen ffnen Sie ein Dr cken Sie die Eingabetaste oder klicken Sie Klicken Sie auf den Bildschirm markiertes Elementin auf das Trackwheel Trackpad oder den den Suchergebnissen Trackball L schen Sie den Textin Dr cken Sie die Esc Taste Dr cken Sie die Esc Taste einem Suchfeld Add Task Q Marketing presentation 0Order books Um Benutzern zu helfen einen bestimmten Wert schnell einzugeben k nnen Sie ein Feld erstellen das automatische Vervollst ndigung unterst tzt Beim Eingeben erhalten Benutzer eine Dropdown Liste mit vorgeschlagenen Werten angezeigt Benutzer k nnen auf einen dieser Werte klicken oder die Eingabe fortsetzen um die Werte in der Liste einzuschr nken 90 Entwicklungshandbuch Suchfelder Choose a mon
105. lConfig setSamplesCount auf um die Anzahl der im Puffer zu speichernden ausgelesenen Beschleunigungswerte anzugeben Jedes Element im Puffer beinhaltet die ausgelesenen Beschleunigungswerte f r die X Y und Z Achse sowie Daten ber den Zeitpunkt des Auslesens channelConfig setSamplesCount 500 Rufen Sie AccelerometerSensor openChannel auf einen Kanal zum Beschleunigungssensor zu ffnen Channel bufferedChannel AccelerometerSensor openChannel Application getApplication channelConfig Abrufen von Beschleunigungssensordaten aus einem Puffer 1 Importieren Sie die folgenden Klassen e net rim device api system AccelerometerData e net rim device api system AccelerometerSensor Channel Fragen Sie Beschleunigungssensordaten aus dem Puffer ab AccelerometerData accData bufferedChannel getAccelerometerData Rufen Sie AccelerometerData getNewBatchLength auf um die Anzahl der Werte zu erhalten die seit der letzten Abfrage abgerufen wurden int newBatchSize accData getNewBatchLength Rufen Sie AccelerometerData getXAccHistory AccelerometerData getYAccHistory und AccelerometerData getZAccHistory auf um f r jede Achse Beschleunigungssensordaten aus dem Puffer abzurufen short xAccel short yAccel short zAccel accData getXAccHistory accData getYAccHistory accData getZAccHistory Ermitteln des Zeitpunkts des Abrufens eines Werts vom Beschleunigungssensor 1 2 Importieren
106. ldDemo 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 BrowserField browserField new BrowserField add browserField String baseURL http www blackberry com String postData fieldnamel valuel amp fieldname2 value2 Hashtable header new Hashtable header put Content Length postData length header put Content Type application x www form urlencoded browserField requestContent baseURL postData getBytes new HttpHeaders header Dialogfelder Verwendung von Dialogfeldern um die folgenden Aktionen auszuf hren e Fordern Sie von Benutzern Informationen die erforderlich sind um eine vom Benutzer eingeleitete Aufgabe abzuschlie en e Informieren Sie Benutzer ber wichtige Informationen oder den Status wichtiger Aktionen e Warnen Sie Benutzer vor unerwarteter oder m glicherweise zerst render Bedingungen oder Situationen 68 Entwicklungshandbuch Dialogfelder Dialogfelder sind modal sie unterbrechen den normalen Vorgang des BlackBerry Ger ts und werden im Stapel nach oben geschoben Ein Dialogfeld enth lt einen Anzeiger der die Art des Dialogfelds eine Nachricht und Schaltfl chen anzeigt die Benutzern erm glichen e
107. ldelement an den angegebenen Index zur ckzugeben Implementieren Sie indexOfList um das erste Vorkommen einer gegebenen Zeichenfolge zur ckzugeben Implementieren Sie getPreferredwidth um die Breite des Listenfelds abzurufen private class ListCallback implements ListFieldCallback public void drawListRow ListField list Graphics g int index int y int wi String text String _listElements elementAt index g drawText text y w public Object get ListField list int index 71 Entwicklungshandbuch Optionsfelder return _listElements elementAt index Sa Uhdte EK AAA EA lista SErIng Orei 1mME String return _listElements indexOf prefix string pubtic int getPreferredWidth ListField list return Display getWidth Optionsfelder Verwenden Sie die Optionsfelder um einen Satz sich gegenseitig ausschlie ender aber verwandter Auswahlen anzuzeigen Benutzer k nnen die folgende Aktion mit den Optionsfeldern ausf hren Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen W hlen Sie ein Dr cken Sie die Leertaste oder klicken Sie auf Klicken Sie auf den Bildschirm Optionsfeld aus das Trackwheel den Trackball oder das Trackpad Call Logging Show These Call Log Types In Message List O Missed Calls OAll Calls None Bew hrtes Verfahren Implementieren von Optionsschaltfl chen 78 Verwenden Sie Optionsschaltfl chen um zwei oder mehr Auswahlm glich
108. leich TouchEvent CANCEL ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent CANCEL Dialog alert System event occurred while processing touch events return true return false Reagieren auf einen Benutzer der einen Finger schnell nach oben ber den Bildschirm bewegt 1 Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui TouchGesture e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog 2 Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert 27 Entwicklungshandbuch Reagieren auf einen Benutzer der einen Finger schnell nach unten ber den Bildschirm bewegt public class newButtonField extends ButtonrField Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf Pr fen Sie ob der von TouchGesture getSwipeDirection zur ckgegebene Wert gleich TouchGesture SWIPE_NORTH ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent case TouchGesture SWIPE if gesture getSwipeDirection TouchGesture SWIPE_NORTH Dialog alert Upward swipe occurred return true return fals
109. litle Date Picker Sample add new RichTextField Trying Date Picker VUiApplication getUiApplication invokeLater new Runnable public void run DateTimePicker datePicker DateTimePicker getInstance datePicker doModal Calendar cal datePicker getDateTime Date date cal getTime Dialog alert You selected date toString DE Codebeispiel Erstellen einer Datumsauswahl import net rim device api ui Impotanertenmedevilecemopieunepileckeizen 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 DatePick extends UiApplication public static void main String args DatePick theApp new DatePick theApp enterEventDispatcher public DatePick pushScreen new DatePickScreen ee DatePickScreen extends MainScreen public DatePickScreen Sec miele Daiteskitckeizzsampiles E add new RichTextField Trying Date Picker VUiApplication getUiApplication invokeLater new Runnable public void run DateTimePicker datePicker DateTimePicker getInstance datePicker doModal Calendar cal datePicker getDateTime Date date cal getTime 86 Auswahldialogfelder Entwicklungshandbuch Auswahldialogfelder Dialog alert You selected date toString DI Erstellen einer Dateiauswahl 1 Importieren Sie die erforderlichen Klasse
110. lysiert um Daten zu extrahieren die f r das Erstellen von Country Objekten verwendet werden rt sJ Obtain a line of text from the text file String Line new String lineReader readLine WIN ewcoKeanotedeschezendeonstchesmilerspalrzsestheslkinezonstext if line equals EOF int spacel line indexOf String country lLine substring 0 spacel UD ger e EinesindexOn zns peace String population line substring spacel l space2 String capital lLine substring space2 1l line length Create a new Country object countries addElement new Country country population capital else break end the for loop return countries 14 Um der Liste ausw hlbarer Textelemente ein Stichwort hinzuzuf gen rufen Sie SortedReadableList doAdd element auf SortedReadableList doAdd Country countries elementAt i getCountryName 15 Um die Liste ausw hlbarer Textelemente zu aktualisieren rufen Sie KeywordFilterField updatelist auf _keywordField updateList 16 Um das Stichwort zu erhalten das ein BlackBerry Ger tebenutzer in das KeywordFilterField Feld eingegeben hat rufen Sie KeywordFilterField getKeyword auf String userTypedWord _keywordField getKeyword Drehungsfelder Verwenden Sie ein Drehungsfeld um Benutzern die problemlose Auswahl eines Elements aus einer sortierten Liste zu erm glichen Verwenden Sie beispielsweise Drehungsfelder um es Benutzern zu erm glichen eine Zahl zu finden
111. m Stapel nach oben geschoben Wenn eine BlackBerry Ger teanwendung einen Bildschirm schlie t verschwindet der Bildschirm vom Stapel und der n chste Bildschirm im Stapel wird ausgegeben und gegebenenfalls neu gezeichnet Jeder Bildschirm kann nur einmal im Anzeige Stapel vorkommen Die BlackBerry JVM l st einen Laufzeitfehler aus wenn ein Bildschirm den die BlackBerry Ger teanwendung auf den Stapel schiebt bereits existiert Eine BlackBerry Ger teanwendung muss einen Bildschirm vom Anzeige Stapel nehmen wenn der Benutzer die Interaktion mit dem Bildschirm beendet damit die BlackBerry Ger teanwendung den Speicher effizient einsetzen kann Sie sollten nur ein paar modale Bildschirme gleichzeitig verwenden denn jeder Bildschirm verwendet einen separaten Thread Die Benutzeroberfl chen APls initialisieren einfachen Screen Objekte Nachdem Sie einen Bildschirm erstellen k nnen Sie Felder und ein Men hinzuf gen und den Bildschirm dem Benutzer anzeigen indem Sie ihn im Anzeige Stapel nach oben schieben Sie k nnen die Benutzeroberfl che des BlackBerry Ger ts ndern und bei Bedarf neue Feldtypen implementieren Sie k nnen auch benutzerdefinierte Navigation hinzuf gen Die Screen Klasse implementiert keine Disambiguierung die f r komplexe Eingabemethoden wie z B internationale Tastaturen erforderlich ist F r die Integration der verschiedenen Eingabemethoden k nnen Sie die Field Klasse oder eine ihrer Unterklassen erweitern Si
112. m 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 class BrowserFieldDemoScreen extends MainScreen pushScreen new BrowserFieldDemoScreen public BrowserFieldDemoScreen BrowserField myBrowserField new BrowserField add myBrowserField myBrowserField displayContent lt html gt lt body gt lt h1 gt Hello World lt h1 gt lt body gt lt html gt http localhost Anzeigen von HTML Inhalt von einer Webseite in einem Browserfeld 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api browser field2 import net rim device api system impolzteneisamsilmsdevaieerapieunes import net rim device api ui container 61 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene BrowserFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class Browser
113. meter insetProperty gibt die Eigenschaft und der zweite Parameter den Wert der Eigenschaft an Im folgenden Codebeispiel wird zum Beispiel die NAVIGATION _MODE Eigenschaft eines BrowserField Objekts angegeben myBrowserFieldConfig setProperty BrowserFieldConfig NAVIGATION MODE BrowserFieldConfig NAVIGATION MODE _POINTER 6 Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserField Klasse die die von Ihnen definierte Konfiguration verwendet 65 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen BrowserField browserField new BrowserField myBrowserFieldConfig Codebeispiel Konfigurieren eines Browserfelds 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 BrowserField browserField new BrowserField myBrowserFieldConfig Senden von Formulardaten an eine Webadresse in einem Browserfeld 1 Importieren Sie die
114. mplementierung zu l sen Weitere Informationen zur Verwendung der Spell Check API k nnen Sie der Spell Check Beispielanwendung entnehmen die im BlackBerry Java Development Environment 4 3 1 oder neuer sowie im BlackBerry Java Plug in f r Eclipse enthalten ist Hinzuf gen einer Funktion zur Rechtschreibpr fung 1 Importieren Sie die folgenden Klassen e net rim blackberry api spellcheck SpellCheckEngineFactory e java lang StringBuffer 2 Importieren Sie die folgenden Schnittstellen e net rim blackberry api spellcheck SpellCheckEngine e net rim blackberry api spellcheck SpellCheckUI e net rim blackberry api spellcheck SpellCheckUlListener 3 Erstellen Sie Variablen f r Rechtschreibpr fungsobjekte SpellCheckEngine _spellCheckEngine SpellCheckUI _spellCheckUI 4 Rufen Sie createSpellCheckUI auf _spellCheckUI SpellCheckEngineFactory createSpellCheckUI 5 Um eine Anwendung zu benachrichtigen wenn ein Rechtschreibpr fungsereignis auftritt rufen Sie addSpellCheckUIlListener miteinem SpellCheckUIListener Objekt als Parameter auf _spellCheckUI addSpellCheckUIlListener new SpellCheckUIlListener 6 Um eine Anwendung eine Rechtschreibpr fung f r Benutzeroberfl chenfelder durchf hren und BlackBerry Ger tebenutzern Rechtschreibkorrekturen vorschlagen zu lassen rufen Sieein SpellCheckEngine Objektab und rufen Sie getSpellCheckEngine auf _spellCheckEngine _spellCheckUI getSpellCheckEngine
115. n Bereich des Feldes als ung ltig markiert wird Verwenden Sie einen switch Block um das Feld basierend auf der Form des benutzerdefinierten Feldes neu zu zeichnen Verwenden bei einem Feld mit einer dreieckigen oder achteckigen Form die Breite des Feldes um die horizontale und vertikale Position des Anfangs und Endpunkts einer Linie zu berechnen Rufen Siegraphics drawLine auf und verwenden Sie die Anfangs und Endpunkte um die Linien zu zeichnen die das benutzerdefinierte Feld definieren Rufen Sie bei einem Feld mit einer rechteckigen Form graphics drawRect auf und verwenden Sie die Breite und die H he des Feldes um das benutzerdefinierte Feld zu zeichnen Rufen Sie graphics drawText auf und verwenden Sie die Breite des Feldes um eine Textzeichenfolge in einen Bereich des Feldes zu zeichnen protected void paint Graphics graphics hd Ad COXE CEECEE int w getWidth Entwicklungshandbuch Erstellen eines benutzerdefinierten Feldes switch _shape case TRIANGLE int h w gt gt 1 int m w gt gt 1 1 graphics drawLine h 1 m graphics drawLine m w 1 h 1 graphics drawLine 0 h 1 w 1 h 1 textWidth Math min _labelWidth h textX w textWidth gt gt 1 textY h gt gt break case OCTAGON int x 5 w 17 int x2 w x 1l int x3 w 1 graphics drawLine 0 x 0 x2 leie let E 2 graphics drawLine x x2 0 graphics drawLine x x3 x2 x3 graphics drawLine 0 x x 0 gr
116. n Field Objekt am Anfang einer Textzeile ausrichten kann Wenn Sie zum Beispiel ein Field Objekt mit der Ausrichtungsmarkierung Field FIELD_LEADING erstellen und einem VerticalFieldManager Objekt das Field Objekt hinzuf gen wird das Field Objekt wenn die Anwendung beispielsweise beginnt ein englisches oder chinesisches Gebietsschemas zu verwenden an der linken Seite des Bildschirms ausgerichtet Wenn die Anwendung beginnt ein arabisches oder hebr isches Gebietsschema zu verwenden wird das Field Objekt an der rechten Seite des Bildschirms ausgerichtet Autocomplete Textfeld Sie k nnen ein autocomplete Textfeld verwenden um vorherzusagen was ein BlackBerry Ger tebenutzer eingeben m chte und ein Wort bzw einen Satz anzuzeigen bevor der Benutzer dessen Eingabe abgeschlossen hat Wenn Sie ein AutoCompleteField Objekt erstellen m ssen Sie einBasicFilteredList Objekt damit verkn pfen DurchBasicFilteredList bleiben die Bez ge auf Datenobjekte erhalten mit denen verglichen wird um die Liste der W rter und S tze zu erstellen Sie k nnen in der Konfiguration festlegen mit welchen Feldern in den Datenobjekten verglichen wird und welche Felder angezeigt werden wenn ein Gegenst ck gefunden wird So k nnen Sie beispielsweise den Text den der Benutzer eingibt mit dem Wert des Felds DATA_FIELD_CONTACTS_BIRTHDAY in der Datenquelle DATA_SOURCE_CONTACTS vergleichen und den Wert des entsprechenden Felds DATA_FIELD_CONTACTS_NAME_ FULL zur
117. n anzuzeigen Nehmen Sie nur dann einen Stammknoten auf wenn die Benutzer Aktionen f r die gesamte Struktur ausf hren k nnen m ssen Verzichten Sie andernfalls auf den Stammknoten Erstellen eines Feldes f r das Anzeigen einer Strukturansicht Verwenden Sie eine Strukturansicht um Objekte wie z B eine Ordnerstruktur auf hierarchische Weise anzuzeigen Ein TreeField Objektenth lt Knoten Der h chste Knoten ist der Stammknoten Ein Knoten in der Struktur kann untergeordnete Knoten besitzen Ein Knoten der ein untergeordnetes Element besitzt ist ein bergeordneter Knoten 1 2 3 102 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui component TreeField import net rim device api ui component TreeFieldCallback import net rim device api ui container MainScreen import java lang String Implementieren Sie die TreeFieldCallback Schnittstelle Rufen Sie TreeField setExpanded f r das TreeField Objekt auf um anzugeben ob ein Ordner ausblendbar ist Erstellen Sie ein TreeField Objekt und mehrere untergeordnete Knoten f r das TreeField Objekt Rufen Sie TreeField setExpanded mit node4 als Parameter auf um den Ordner auszublenden String fieldOne new String Main folder TreeCallback myCallback new TreeCallback TreeField myTree new TreeField myCallback Field FOCUSABLE int nodel myTree addChildNode fieldOne int node2 myTree addChildNode fieldT
118. n in einem Dialogfeld Wenn es mehr als drei gibt ziehen Sie in Betracht stattdessen einen Anwendungsbildschirm mit Optionsfeldern zu verwenden e Stellen Sie auf BlackBerry Ger ten mit einem Trackwheel Trackball oder Trackpad Tastenkombinationen f r Schaltfl chen bereit In der Regel ist die Tastenkombination der erste Buchstabe der Schaltfl chenbezeichnung e Verwenden Sie kurze klare Bezeichnungen e Verwenden Sie nach M glichkeit Bezeichnungen die aus einem Wort bestehen Die Gr e einer Schaltfl che ndert sich mit der L nge der Bezeichnung Wenn eine Bezeichnung zu lang ist werden Auslassungspunkte angezeigt um zu verdeutlichen dass der Text abgeschnitten ist Wenn Sie eine Bezeichnung aus mehreren W rtern verwenden verwenden Sie satzabh ngige Gro schreibung e Vermeiden Sie die Verwendung der Bezeichnungen Ja und Nr Verwenden Sie f r Bezeichnungen Verben die die verkn pfte Aktion beschreiben zum Beispiel Abbrechen L schen Verwerfen oder Speichern Dieser Ansatz hilft Benutzern schnell und problemlos zu verstehen was geschieht wenn sie auf die Schaltfl che klicken Falls erforderlich f gen Sie weitere Beschreibungen anderswo auf dem Bildschirm hinzu zum Beispiel in einer Anwendungsnachricht e Vermeiden Sie die Verwendung von Symbolen oder Grafik in Bezeichnungen e Vermeiden Sie Interpunktion in Bezeichnungen Verwenden Sie in der Bezeichnung einer Schaltfl che Auslassungspunkte um anzuzeigen
119. n und Schnittstellen UI D GUST are BEES import net rim device api ui picker import net rim device api ui component import net rim device api ui container import java util 2 Erstellen Sie das Anwendungsframework durch Erweitern der ViApplication Klasse Erstellen Sie in main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die DatePickScreen Klasse stellt den in Schritt 3 beschriebenen benutzerdefinierten Bildschirm dar public class FilePick extends UiApplication public static void main String args FilePick theApp new FilePick theApp enterEventDispatcher public FilePick pushScreen new FilePickScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um einen Titel f r den Bildschirm anzugeben Rufen Sie add auf um dem Bildschirm ein Bezeichnungsfeld hinzuzuf gen class FilePickScreen extends MainScreen public FilePickScreen Stegen 7 File Picker samnmole s add new LabelField Trying File Picker 87 Entwicklungshandbuch Auswahldialogfelder 4 Rufen Sie im Bildschirmkonstruktor invokeLater auf um der Ereigniswarteschlange der Anwendung einen Codeabschnitt h
120. nent ButtonField 2 Erstellen Sie eine Instanz von HorizontalFieldManager HorizontalFieldManager _fieldManagerBottom new HorizontalFieldManager 3 Rufen Sie add auf um dem Bildschirm den HorizontalFieldManager hinzuzuf gen myScreen add _fieldManagerBottom 4 Erstellen Sie eine Instanz von ButtonField ButtonField mySubmitButton new ButtonField Submit 5 F gen Sie dem HorizontalFieldManager den ButtonField hinzu _fieldManagerBottom add mySubmitButton 37 Entwicklungshandbuch Erstellen eines Raster Layouts Erstellen eines Raster Layouts Anmerkung Um Informationen zum Erstellen eines Raster Layouts in der BlackBerry Java Development Environment vor Version 5 0 zu erhalten gehen Sie zu http www blackberry com knowledgecenterpublic und lesen Sie DB 00783 Sie k nnen mithilfe der GridFieldManager Klasse Felder auf einem Bildschirm in Zeilen und Spalten anordnen um ein Raster zu erstellen Wenn Sie ein Raster erstellen k nnen Sie die Anzahl der Zeilen und Spalten angeben Nach dem Erstellen eines Rasters k nnen Sie die Anzahl der Zeilen und Spalten die es enth lt nicht mehr ndern Der Index von Rastern beginnt bei null Deshalb befindet sich die erste Zelle bei Zeile O Spalte O In einem Gebietsschema mit einer Textrichtung von links nach rechts befindet sich die erste Zelle in der linken oberen Ecke des Rasters Left to right locale This is cell 0 0 This is cell 0 1 This is cell 0 2 This is
121. nes Drehfelds e Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung 14 August 2009 Die folgenden Themen wurden hinzugef gt e Hinzuf gen eines Symbols zu einem Men eintrag e Hinzuf gen eines Symbols zu einem Men eintrag e ndern der Darstellung eines Men s e _ ndern der Darstellung eines Men s e Konfigurieren eines Browserfeldes e Anzeigen von HTML Inhalt in einem Browserfeld e Erstellen eines Men s e Erstellen eines Untermen s e Erstellen eines Felds um Webinhalte anzuzeigen e Anzeigen eines Felds an einer absoluten Position auf einem Bildschirm 126 Entwicklungshandbuch Verlauf der Dokumentrevision Datum Beschreibung e Vor bergehendes Anzeigen eines ButtonField und eines LabelField oben bzw unten am Bildschirm e Anzeigen von HTML Inhalt aus einer Ressource in Ihrer Anwendung e Anzeigen von HTML Inhalt von einer Webseite in einem Browserfeld e Anzeigen einer Bezeichnung an einer absoluten Position auf dem Bildschirm e Anzeigen von Feldern in einem tempor ren Paar von Managern e Ereignisinjektion e Senden von Formulardaten an eine Webadresse in einem Browserfeld Die folgenden Codebeispiele wurden hinzugef gt e Codebeispiel Hinzuf gen eines Symbols zu einem Men element e Codebeispiel ndern der Darstellung eines Men s e Codebeispiel Erstellen einer Datumsauswahl e Codebeispiel Erstellen eines Men s e Codebeispi
122. nesMainScreen Objekts f r den ersten Bildschirm Ihrer BlackBerry Ger teanwendung in Betracht ziehen um die Konsistenz mit anderen BlackBerry Ger teanwendungen beizubehalten Verwalten eines Zeichenbereichs Das Graphics Objekt stellt die gesamte Zeichenoberfl che dar die f r die BlackBerry Ger teanwendung verf gbar ist Um diesen Bereich zu begrenzen unterteilen Sie ihn in XYRect Objekte Jedes XYPoint Objekt stellt einen Punkt auf dem Bildschirm dar der sich aus einer X Koordinate und einer Y Koordinate zusammensetzt 1 Importieren Sie die folgenden Klassen e net rim device api ui Graphics e net rim device api ui XYRect e net rim device api ui XYPoint 2 Erstellen SieXYPoint Objekte um den linken oberen Punkt und den rechten unteren Punkt eines Rechtecks darzustellen Erstellen Sie mithilfe der XYPoint Objekte ein XYRect Objekt um einen rechteckigen Clipping Bereich zu erstellen XYPoint bottomRight new XYPoint 50 50 XYPoint topLeft new XYPoint 10 10 XYRect rectangle new XYRect topLeft bottomRight Entwicklungshandbuch Erstellen eines Bildschirm bergangs 3 RufenSieGraphics pushContext auf um Zeichenaufrufe durchzuf hren die angeben dass der Bereichsursprung nicht den Zeichen Offset anpassen soll Rufen Sie Graphics pushContext auf um den rechteckigen Clipping Bereich mittels Push zum Kontextstapel zu bertragen Rufen Sie Graphics drawRect auf um ein Rechteck zu zeichnen und rufen Sie Graph
123. nnel getLastAccelerationData xyz Rufen Sie Thread sleep auf um den Abstand zwischen Abfragen zum Beschleunigungssensor in Millisekunden anzugeben Thread sleep 500 Rufen Sie Channel close auf um den Kanal zum Beschleunigungssensor zu schlie en rawDataChannel close Abfragen des Beschleunigungssensors wenn sich die Anwendung im Vordergrund befindet i Importieren Sie die folgenden Klassen e net rim device api system AccelerometerChannelConfig e net rim device api system AccelerometerSensor Channel ffnen Sie einen Kanal um Beschleunigungsdaten vom Beschleunigungssensor abzurufen Channel channel AccelerometerSensor openRawAccelerationChannel Application getApplication Rufen Sie Thread sleep auf um den Abstand zwischen Abfragen zum Beschleunigungssensor in Millisekunden anzugeben short xyz new short 3 while running channel getLastAccelerationData xyz Thread sleep 500 21 Entwicklungshandbuch Abfragen des Beschleunigungssensors wenn sich die Anwendung im Hintergrund befindet 4 Rufen SieChannel close auf um den Kanal zum Beschleunigungssensor zu schlie en channel close Abfragen des Beschleunigungssensors wenn sich die Anwendung im Hintergrund befindet 1 Importieren Sie die folgenden Klassen e net rim device api system AccelerometerChannelConfig e net rim device api system AccelerometerSensor Channel 2 Erstellen Sie eine Konfiguration f r einen Kan
124. nwendung im Hintergrund befindet 22 Speichern der ausgelesenen Beschleunigungssensorwerte in einem Puffer 22 Abrufen von Beschleunigungssensordaten aus einem Puffer 23 Ermitteln des Zeitpunkts des Abrufens eines Werts vom Beschleunigungssensor 23 ERSTEN 25 Reagierenauf Navigatonserelgnlseg estss sasen est erresieereeeioteteeetteetettetererttnt 25 Bestimmen derArtder Eingabemethode a asus aa 25 Reagieren auf Touchscreen Ereigntsesg steet EENEG 26 Antworten auf Systemereignisse w hrend der Benutzer den Bildschirm bert hrt 27 Reagieren auf einen Benutzer der einen Finger schnell nach oben ber den Bildschirm bewegt 27 Reagieren auf einen Benutzer der einen Finger schnell nach unten ber den Bildschirm bewegt 28 Reagieren auf einen Benutzer der einen Finger schnell nach rechts ber den Bildschirm bewegt 29 Reagieren auf einen Benutzer der schnell einen Finger nach rechts ber den Bildschirm bewegt 30 Reagieren auf einen Benutzer der auf den Bildschirm klickt 30 Reagieren auf einen Benutzer der den Bildschirm zweimal schnell bertbrt 31 Reagieren auf einen Benutzer der ein Element auf dem Bildschirm ber hrt und zieht 32 Reagieren auf einen Benutzer der den Bildschirm leicht bertbrt 32 Reagieren auf eine Bldlautakton 33 Reagieren auf einen Benutzer der den Bildschirm an zwei Stellen gleichzeitig ber hrt 34 Ereignisinjektidni sese non Tan RR ORO nenn nike 34 Anotdnen von B
125. oButtonField Klasse hinzuf gen wollen Im RadioButtonField Konstruktor geben Sie das Etikett f r die Optionstaste die Gruppe und einen booleschen Wert an um die Standardauswahl anzuzeigen zum Beispiel zeigt wahr an dass standardm ig die Option ausgew hlt ist Rufen Sie add auf um dem Bildschirm die Optionstasten hinzuzuf gen RadioButtonGroup rbg new RadioButtonGroup add new RadioButtonField Option 1 rbg true add new RadioButtonField Option 2 rbg false Um die Standardfunktionalit t au er Kraft zu setzen die den Benutzer auffordert nderungen vor dem Schlie en der Anwendung zu speichern setzen Sie in der Erweiterung der MainScreen Klasse die MainScreen onSavePrompt Methode au er Kraft Im folgenden Codebeispiel lautet der R ckgabewert true wodurch angezeigt wird dass die Anwendung den Benutzer vor dem Schlie en nicht auffordert public boolean onSavePrompt return true Codebeispiel Erstellen eines Optionsfelds import net rim device api ui import net rim device api ui component import net rim device api ui container public class MyUi extends UiApplication public static void main String args MyUi theApp new MyUi theApp enterEventDispatcher public MyUi pushScreen new MyUiScreen class MyViScreen extends MainScreen 80 public MyUiScreen setTitle UI Component Sample RadioButtonGroup rbg new RadioButtonGroup add
126. ortane et fe UA ste hee Cette Ach TIME Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die HomeScreen Klasse stellt den benutzerdefinierten Bildschirm dar der in Schritt 3 beschrieben wird public class AutoCompleteFieldApp extends UiApplication public static void main String args AutoCompleteFieldApp app new AutoCompleteFieldApp app enterEventDispatcher public AutoCompleteFieldApp pushScreen new HomeScreen Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse class HomeScreen extends MainScreen public HomeScreen Erstellen Sie im Bildschirmkonstruktor einBasicFilteredList Objekt Rufen Sie addDataSource auf um eine Datenquelle an BasicFilteredList zu binden In diesem Beispiel handelt es sich bei den Daten um Kontaktinformationen und die Datenquelle ist die Kontaktliste Das erste Argument das Sie an addDataSource bergeben ist eine eindeutige ID Das zweite Argument bindet das BasicFilteredList Objekt an eine Datenquelle Das dritte Argument gibt den Satz von Datenquellenfeldern an mit denen verglichen wird Das vierte Argument gibt den Satz von Dat
127. ose Bew hrtes Verfahren Implementieren von Men s Stellen Sie stets ein vollst ndiges Men bereit Stellen Sie sicher dass Benutzer die Men taste dr cken k nnen um das vollst ndige Men zu ffnen und eine Aktion zu initiieren wenn ein Men element markiert ist Stellen Sie sicher dass Benutzer auch die Men taste halten k nnen um das Dialogfeld zum Wechseln von Anwendungen zu ffnen Verwenden Sie als Standardmen element das Men element das die Benutzer am wahrscheinlichsten ausw hlen werden Platzieren Sie den Standardmen eintrag und die anderen am h ufigsten verwendeten Men eintr ge in der Mitte des Men s Vergewissern Sie sich dass die Reihenfolge der Men eintr ge der Reihenfolge der Men eintr ge in anderen BlackBerry Ger teanwendungen entspricht Gruppieren Sie Men eintr ge entsprechend der Verwendungsweise oder der Funktionalit t und lassen Sie Ihre Gruppierungen wenn m glich von den Benutzern testen F gen Sie Trennzeichen zwischen den Men eintragsgruppen ein Platzieren Sie keine Men eintr ge f r einander widersprechende Aktionen nahe beieinander Platzieren Sie zum Beispiel nicht den Men eintrag L schen neben dem Men eintrag ffnen Stellen Sie stets die Men eintr ge Anwendung wechseln und Schlie en bereit Platzieren Sie diese Men eintr ge am Ende des Men s Wenn Sie Standardkomponenten verwenden sind diese Men eintr ge automatisch enthalten Richtlinien f r Beze
128. owserFieldDemoScreen 4 Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserField Klasse BrowserField myBrowserField new BrowserField 5 Rufen Sie im Bildschirmkonstruktor add auf um dem Bildschirm das BrowserField Objekt hinzuzuf gen add myBrowserField 6 Rufen Sie im Bildschirmkonstruktor BrowserField requestContent auf um den Ort der Ressource in Ihrer Anwendung anzugeben und den HTML Inhalt anzuzeigen myBrowserField requestContent local test html Anmerkung Die BrowserField Klasse greift nicht mithilfe einer Ordnerstruktur auf Ressourcen zu DieBrowserField Klasse zeigt die erste Ressource an die gefunden wird und die dem angegebenen Dateinamen entspricht Codebeispiel Anzeigen des HTML Inhalts von einer Ressource in Ihrer Anwendung import net rim device api browser field2 import net rim device api system 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 BrowserField myBrowserField new BrowserField add myBrowserField myBrowserField requestContent local test html 64 Entwicklungshandbuch Erstellen
129. pi system KeypadListener Schnittstelle Erweitern Sie die Screen Klasse die Field Klasse oder beide o E DH In Ihrer Implementierung der Methoden navigationClick navigationUnclick oder navigationMovement f hren Sie einen bitweisen AND Vorgang auf dem status Parameter aus um mehr Informationen zum Ereignis zu erzeugen Implementieren Sie denavigationClick intstatus int time Methode um zu bestimmen ob das Trackwheel oder ein Vier Wege Navigationseingabeger t zum Beispiel ein Trackball ein Ereignis ausl st public boolean navigationClick int status int time if status amp KeypadlListener STATUS_TRACKWHEEL KeypadlListener STATUS_TRACKWHEEL Input came from the trackwheel else if status amp KeypadListener STATUS_FOUR_WAY KeypadListener STATUS_FOUR_WAY Input came from a four way navigation input device return super navigationClick status time Weitere Informationenzurnet rim device api 1bs Keypadlistener Klasse finden Sie in der API Referenz f r BlackBerry Java Development Environment 25 Entwicklungshandbuch Reagieren auf Touchscreen Ereignisse Reagieren auf Touchscreen Ereignisse BlackBerry Ger tebenutzer k nnen auf einem Ger t mit Touchscreen die gleichen Aktionen wie auf einem BlackBerry Ger t mit Trackball ausf hren Beispielsweise k nnen BlackBerry Ger tebenutzer den Touchscreen verwenden um ein Men zu ffnen durch eine Liste von Optionen zu scrollen und eine Option
130. ponent import net rim device api ui container Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene MyUiScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class MyUi extends UiApplication public static void main String args MyUi theApp new MyUi theApp enterEventDispatcher public MyUi pushScreen new MyUiScreen Entwicklungshandbuch Kontrollk stchen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um den Titel f r den Bildschirm anzugeben class MyUiScreen extends MainScreen public MyUiScreen setlTitle UI Component Sample Erstellen Sie im Bildschirmkonstruktor ein Kontrollk stchen mithilfe der CheckboxField Klasse Geben Sie im CheckboxField Konstruktor die Bezeichnung f r das Kontrollk stchen an und verwenden Sie einen booleschen Wert um anzuzeigen ob das Kontrollk stchen die Standardauswahl ist true zeigt zum Beispiel an dass das Kontrollk stchen standardm ig ausgew hlt ist Rufen Sie add auf um dem Bildschirm das Kontroll
131. r ckgegebene Wert gleich TouchEvent DOWN ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent DOWN Dialog alert Touch occurred return true return false Reagieren auf eine Bildlaufaktion 1 Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui TouchGesture e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen Erstellen Sie eine Klasse die die Manager Klasse erweitert public class newManager extends Manager Pr fen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode ob der von TouchEvent getEvent zur ckgegebene Wert gleich TouchEvent MOVE ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent MOVE return true return false 33 Entwicklungshandbuch Reagieren auf einen Benutzer der den Bildschirm an zwei Stellen gleichzeitig ber hrt Reagieren aufeinen Benutzer der den Bildschirm an zwei Stellen gleichzeitig ber hrt 1 Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog 2 Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extend
132. r ten mit einem SurePress Touchscreen wird in den meisten F llen die komplette Tastatur im Querformat und die SureType Tastatur im Hochformat angezeigt Entwicklungshandbuch Interaktionsmethoden auf BlackBerry Ger ten Interaktionsmethoden auf BlackBerry Ger ten BlackBerry Ger temodell Interaktionsmethode BlackBerry 7100 Series Trackwheel BlackBerry 8700 Series Trackwheel BlackBerry 8800 Series Trackball BlackBerry Bold 9000 Smartphone Trackball BlackBerry Bold 9650 Smartphone Trackpad BlackBerry Bold 9700 Smartphone BlackBerry Curve 8300 Series Trackball BlackBerry Curve 8500 Series Trackpad BlackBerry Curve 8900 Smartphone Trackball BlackBerry Pearl 8100 Series Trackball BlackBerry Pearl Flip 8200 Series Trackball BlackBerry Storm 9500 Series Touchscreen BlackBerry Tour 9630 Smartphone Trackball Entwicklungshandbuch Bildschirme Bildschirme Die Hauptkomponente einer Benutzeroberfl che des BlackBerry Ger ts ist das Screen Objekt Auf einem BlackBerry Ger t k nnen mehrere Bildschirme gleichzeitig ge ffnet sein aber nur ein Bildschirm zur selben Zeit angezeigt werden Die BlackBerry Java Virtual Machine verwaltet einen sortierten Satz von Screen Objekten in einem Anzeige Stapel Der Bildschirm oben im Stapel ist der aktive Bildschirm der f r den BlackBerry Ger tebenutzer sichtbar ist Wenn eine BlackBerry Ger teanwendung einen Bildschirm anzeigt wird der Bildschirm i
133. r UiApplication Klasse Erstellen Sieinmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene FontLoadingDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class FontLoadingDemo extends UiApplication public static void main String FontLoadingDemo app new FontLoadingDemo app enterEventDispatcher public FontLoadingDemo pushScreen new FontLoadingDemoScreen args Erstellen Sie den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse Rufen Sie setTitle auf um den Text festzulegen der im Titelbereich des Bildschirms angezeigt wird Erstellen SieeinneuesLabelField Objekt Sie wenden die benutzerdefinierte Schriftart auf dieses Objekt an 115 Entwicklungshandbuch Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung class FontLoadingDemoScreen extends MainScreen public FontLoadingDemoScreen setlitle Font Loading Demo LabelField helloworld new LabelField Hello World 4 Rufen Sie im Bildschirmkonstruktor die FontManager getInstance Methode auf um einen Verweis auf das FontManager Objektzu erhalten und rufen Sie anschlie end die Load Methode auf um die
134. rry Java Application Barrierefreiheit e BlackBerry Java Application Integration Development Guide Entwicklungshandbuch f r BlackBerry Java Application Integration e BlackBerry Java Application Multimedia Development Guide Multimedia Entwicklungshandbuch f r BlackBerry Java Application e BlackBerry Java Development Environment Transitioning to Touch Screen Development Technical Note Technischer Hinweis f r BlackBerry Java Development Environment bergang zur Touchscreen Entwicklung e BlackBerry Java Development Environment berblick ber Beispielanwendungen e BlackBerry Developer Zone unter www blackberry com developers e BlackBerry Entwickler k nnen Sie herunterladen unter www blackberry com developers downloads 121 Entwicklungshandbuch Glossar 3D Dreidimensional API Application Programming Interface wendungsprogrammierschnittstelle JVM Java Virtual Machine MIDP Mobile Information Device Profile Softwareprofil f r mobile Ger te 122 Glossar Entwicklungshandbuch R ckmeldung R ckmeldung Falls Sie uns eine R ckmeldung zu diesem Artikel zukommen lassen m chten besuchen Sie die Website www blackberry com docsfeedback 123 Entwicklungshandbuch Verlauf der Dokumentrevision Verlauf der Dokumentrevision Die folgenden Themen wurden hinzugef gt 6 April 2010 124 Anordnen von Benutzeroberfl chenkomponenten Autocomplete Textfeld Schaltfl chen Kontrollk stchen
135. rstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene CreateMenuScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class CreateMenu extends UiApplication public static void main String args CreateMenu theApp new CreateMenu theApp enterEventDispatcher public CreateMenu pushScreen new CreateMenuScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um den Titel f r den Bildschirm anzugeben Rufen Sie add auf um dem Bildschirm ein Textfeld hinzuzuf gen Rufen Sie addMenultem auf um dem von MainScreen erstellten Men einen Men eintrag hinzuzuf gen class CreateMenuScreen extends MainScreen public CreateMenuScreen setTitle Create Menu Sample add new RichTextField Create a menu addMenultem _viewlItem 104 Entwicklungshandbuch Erstellen eines Men s Erstellen Sie den Men eintrag mithilfe der Menultem Klasse Setzen Sie run au er Kraft um die Aktion anzugeben die ausgef hrt wird wenn der Benutzer auf den Men eintrag klickt Wenn der Benutzer auf den Men eintrag klickt ruft die Anwendung Menu run a
136. rtschatz den Benutzer verstehen Verwenden Sie zum Beispiel Die Datei konnte nicht gespeichert werden weil die Medienkarte voll ist statt Fehler beim Schreiben der Datei auf den Datentr ger e Verwenden Sie wo m glich positive Sprache um ein Tadeln der Benutzer zu vermeiden Schreiben Sie nie Nachrichten die Benutzer f r Fehler oder unerwartete Bedingungen tadeln Konzentrieren Sie sich stattdessen auf die Aktionen die Benutzer unternehmen k nnen um das Problem zu l sen e Verwenden Sie bei der Ansprache der Benutzer die zweite Person Sie Ihr e Verwenden Sie die bliche Gro Kleinschreibung f r S tze e Vermeiden Sie in Nachrichten die Verwendung von Ausrufezeichen I e Vermeiden Sie die Verwendung von Auslassungspunkten in Nachrichten es sei denn Sie zeigen einen Fortschritt an zum Beispiel Bitte warten Richtlinien f r Schaltfl chen 70 Entwicklungshandbuch Dropdown Listen e Verwenden Sie f r die Standardschaltfl che jene Schaltfl che die Benutzer am wahrscheinlichsten anklicken Vermeiden Sie die Verwendung einer Schaltfl che die mit einer beendenden Aktion verkn pft ist als Standardschaltfl che Eine Ausnahme dieser Regel sind jene F lle in denen Benutzer eine kleine beendende Aktion einleiten wie z B L schen eines einzelnen Elements und die h ufigste Benutzeraktion darin besteht mit der Aktion fortzufahren e Vermeiden Sie die Verwendung von mehr als drei Schaltfl che
137. s Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene EyelidFieldManagerDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class EyelidFieldManagerDemo extends UiApplication public static void main String args EyelidFieldManagerDemo app new EyelidFieldManagerDemo app enterEventDispatcher are EyelidFieldManagerDemo pushScreen new EyelidFieldManagerDemoScreen 3 Erstellen Sie das Framework f r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse 42 Entwicklungshandbuch Anzeigen von Feldern in einem tempor ren Paar von Managern class EyelidFieldManagerDemoScreen extends MainScreen public EyelidFieldManagerDemoScreen 4 Rufen Sie im Konstruktor setTitle auf um den Text festzulegen der im Titelbereich des Bildschirms angezeigt wird setlitle EyelidFieldManager Demo 5 Erstellen Sie im Bildschirmkonstruktor eine Instanz der EyelidFieldManager Klasse EyelidFieldManager manager new EyelidFieldManager 6 Rufen Sie im Bildschirmkonstruktor EyelidFieldManager addTop auf umeinLabelField Objekt dem oberen Manager des EyelidFieldManager hinzuz
138. s ButtonrField 3 Pr fen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode ob beim Aufrufen der folgenden Methoden Werte gr er als Null zur ckgegeben werden TouchEvent getX 1 TouchEvent getY 1 TouchEvent getX 2 TouchEvent getY 2 protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent MOVE if message getX 1 gt 0 amp amp message getY 1 gt 0 Dialog alert First finger touched moved if message getX 2 gt amp amp message getY 2 gt 0 Dialog alert Second finger touched moved FELEM rUe return false Ereignisinjektion MithilfederEventInjector Klasse und ihrer inneren Klassen k nnen Sie programmgesteuert Benutzeroberfl chenereignisse generieren Auf BlackBerry Ger ten die BlackBerry Device Software Version 5 0 oder h her ausf hren und Touchscreens besitzen k nnen Sie Ber hrungsereignisse wie z B Fingerstriche und Antippen injizieren Mithilfe einer der inneren EventInjector Klassen k nnen Sie ein Ereignis modellieren und mit der invokeEvent Methode k nnen Sie das Ereignis injizieren Das Ereignis wird an die Anwendung gesendet die derzeit ausgew hlt ist und auf die Eingabe wartet 34 Entwicklungshandbuch Ereignisinjektion Sie k nnen die Ereignisinjektion verwenden um Tests zu automatisieren Sie k nnen die Ereignisinjektion auch verwenden um Peripherieger ten die M glichkeit zu geben mit
139. schirm an einer anderen Stelle ber hren Leitet eine Aktion ein Wenn Benutzer zum Beispiel auf ein Element in einer Liste klicken wird der mit dem Element verkn pfte Bildschirm angezeigt Diese Aktion entspricht dem Klicken auf das Trackwheel Trackpad oder den Trackball In einer Karte Bild oder Pr sentationsanlage zoomt diese Aktion in die jeweilige Karte Bild oder Pr sentationsanlage In einer Webseite zoomt diese Aktion in die Webseite oder folgt einem Link In einem Textfeld wird durch diese Aktion der Cursor positioniert Wenn das Feld Text enth lt erscheint ein umrandetes Feld um den Cursor Durch schnelles Fahren mit einem Finger nach oben wird der n chste Bildschirm angezeigt Durch schnelles Fahren mit einem Finger nach unten wird der vorherige Bildschirm angezeigt Wenn die Tastatur anzeigt wird wird durch schnelles Fahren mit einem Finger nach unten die Tastatur verborgen und die Shortcut Leiste angezeigt Diese Aktion zeigt das n chste bzw vorherige Bild oder Nachricht oder den n chsten bzw vorherigen Tag Woche oder Monat in einem Kalender an In der Kamera wird durch Schieben eines Fingers ein Objekt herangezoomt Durch Schieben mit einem Finger nach unten wird aus dem Objekt herausgezoomt Entwicklungshandbuch Trackball oder Trackpad Aktion Ergebnis Schieben eines Fingers in irgendeine Diese Aktion f hrt eine Karte oder Webseite nach Wenn Benutzer ein Bild Richtung heranzoomen wird durch diese Aktion auch
140. sse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene BrowserFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class BrowserFieldDemo extends UiApplication public static void main String args BrowserFieldDemo app new BrowserFieldDemo app enterEventDispatcher public BrowserFieldDemo pushScreen new BrowserFieldDemoScreen Erstellen Sie den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserField Klasse BrowserField myBrowserField new BrowserField Rufen Sie im Bildschirmkonstruktor add auf um dem Bildschirm das BrowserField Objekt hinzuzuf gen Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen add myBrowserField 6 Rufen Sie im Bildschirmkonstruktor BrowserField displayContent auf um den HTML Inhalt anzugeben und anzuzeigen myBrowserField displayContent lt html gt lt body gt lt hl1 gt Hello World lt h1 gt lt body gt lt html gt http localhost Codebeispiel Anzeigen von HTML Inhalt in einem Browserfeld import net rim device api browser field2 import net ri
141. ssen und Schnittstellen import net rim device api ui import net rim device api ui component import net rim device api ui container Impontsnetan madeviieerapizuindeecons import net rim device api system Entwicklungshandbuch ndern der Darstellung eines Men s 2 Erstellen Sie das Anwendungsframework durch Erweitern der ViApplication Klasse Erstellen Sie in main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene CreateCustomMenuScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class CreateCustomMenu extends UiApplication public static void main String args CreateCustomMenu theApp new CreateCustomMenu theApp enterEventDispatcher public CreateCustomMenu pushScreen new CreateCustomMenuScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um den Titel f r den Bildschirm anzugeben Rufen Sie add auf um auf dem Bildschirm ein Textfeld hinzuzuf gen class CreateCustomMenuScreen extends MainScreen Background _menuBackground Border _menuBorder Font _menuFont CreateCustomMenuScreen setTitle Custom Menu Sample ad
142. ssensordaten Der Beschleunigungssensor dient dazu die Richtung und Geschwindigkeit der Bewegung entlang einer X Y und Z Achse nachzuverfolgen wenn ein BlackBerry Ger tebenutzer das BlackBerry Ger t bewegt Die X Achse istzur Breite des BlackBerry Ger ts parallel Die Y Achse ist zur L nge des BlackBerry Ger ts parallel Die Z Achse ist zur Tiefe von der Vorder bis zur R ckseite des BlackBerry Ger ts parallel Weitere Informationen zur X Y und Z Achse des Beschleunigungssensors finden Sie in der Beschreibung dernet rim device api system AccelerometerSensor Klasse in der API Referenz f r BlackBerry Java Development Environment Entwicklungshandbuch Abrufen der Beschleunigungssensordaten in bestimmten Abst nden Sie k nnen einer BlackBerry Ger teanwendung erm glichen auf die Beschleunigung eines BlackBerry Ger ts zu reagieren das ber einen Beschleunigungssensor verf gt Ein BlackBerry Ger tebenutzer k nnte beispielsweise das BlackBerry Ger t bewegen um die Richtung und Geschwindigkeit eines Objekts zu steuern das sich in einer Spieleanwendung durch ein Labyrinth bewegt Sie k nnen die Accelerometer APlsimnet rim device api system Paket f r die Reaktion auf die Beschleunigung des BlackBerry Ger ts verwenden Sie m ssen zuerst feststellen ob das BlackBerry Ger t einen Beschleunigungssensor unterst tzt indem Sienet rim device api system AccelerometerSensor isSupported aufrufen Wenn die Methode den Wert true z
143. stimmten Fortschrittanzeiger anzeigt i mm Era Applications 12 21 Monday May 12 Building application list i 80 B Please wait Bestimmter Fortschrittanzeiger Unbestimmter Fortschrittanzeiger Bew hrtes Verfahren Implementieren von Fortschrittsanzeigen e Zeigen Sie immer den Fortschritt an wenn der Abschluss eines Vorgangs mehr als 2 Sekunde dauert e Verwenden Sie eine bestimmte Fortschrittsanzeige wenn die Zeitdauer eines Vorgangs bekannt ist e Verwenden Sie eine unbestimmte Fortschrittsanzeige wenn die Zeitdauer eines Vorgangs unbekannt ist 81 Entwicklungshandbuch Auswahldialogfelder Richtlinien f r Bezeichnungen Verwenden Sie die GaugeField Klasse um Fortschrittsanzeigen zu erstellen Erm glichen Sie Benutzern immer eine bestimmte Fortschrittsanzeige mithilfe der Beenden Taste auszublenden Stellen Sie hilfreiche Fortschrittsinformationen bereit Wenn Benutzer zum Beispiel eine Webseite laden zeigen Sie die Datenmenge an die ihr BlackBerry Ger t bereits geladen hat zum Beispiel 8 KB von 10 KB Wenn sie Anwendungen auf ihr Ger t herunterladen zeigen Sie den Fortschritt als Prozentsatz an Seien Sie bei den Fortschrittsinformationen so genau wie m glich Um den unbestimmten Fortschritt anzuzeigen verwenden Sie ein Uhrensymbol f r das Precision Thema oder ein Sanduhrsymbol f r das Dimension Thema Verwenden Sie ein Statusdialogfeld um den unbestimmten Fortschritt anzuzeigen wenn Sie e
144. t Die Trackball Empfindlichkeit steigt vor bergehend an wenn der Benutzer den Trackball l ngere Zeit ununterbrochen rollt Trackwheel BlackBerry Ger te der BlackBerry Pearl 8100 Series verwenden ein Trackwheel als prim re Steuerung f r die Benutzernavigation Das Trackwheel befindet sich auf der rechten Seite des BlackBerry Ger ts Benutzer k nnen folgende Aktionen ausf hren e Trackwheel rollen um den Cursor in vertikaler Richtung zu bewegen e Trackwheel rollen und gleichzeitig die Alt Taste dr cken um den Cursor in horizontaler Richtung zu bewegen e Mit dem Trackwheel klicken um eine Aktion einzuleiten oder das Men zu ffnen Tastatur Benutzer verwenden die Tastatur haupts chlich um Text einzugeben Buchstabentasten senden dem BlackBerry Ger t ein Zeichen Eine Zusatztaste ver ndert die Funktion von Zeichentasten Zu den Zusatztasten geh ren die Umschalttaste und die Alt Taste Wenn Benutzer eine Zusatztaste dr cken wird eine Texteingabemodusanzeige in der rechten oberen Ecke des Bildschirms angezeigt Auf BlackBerry Ger ten ohne Touchscreen k nnen Benutzer die Tastatur auch verwenden um auf einem Bildschirm zu navigieren zum Beispiel auf einer Landkarte Die Navigation mithilfe der Tastatur sollte jedoch immer eine Alternative zur Navigation mithilfe von Trackwheel Trackball oder Trackpad sein BlackBerry Ger te haben entweder eine komplette Tastatur oder eine reduzierte Tastatur Auf BlackBerry Ge
145. t tzt und eine Medienkarte in das BlackBerry Ger t eingesetzt wird erm glichen Sie den Benutzern von Media Card BlackBerry aus mit dem Durchsuchen zu beginnen Wenn die Anwendung verschiedene Dateitypen unterst tzt und keine Medienkarte in das BlackBerry Ger t eingesetzt wird erm glichen Sie den Benutzern von Device Memory home user aus mit dem Durchsuchen zu beginnen Erstellen einer Datumsauswahl L 84 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui import net rim device api ui component import net rim device api ui container import net r im deviicerapizunmpickernn import java util Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die DatePickScreen Klasse stellt den in Schritt 3 beschriebenen benutzerdefinierten Bildschirm dar public class DatePick extends UiApplication public static void main String args Entwicklungshandbuch Auswahldialogfelder DatePick theApp new DatePick theApp enterEventDispatcher public DatePick pushScreen new DatePickScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendun
146. t rim device api ui TouchEvent e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog 2 Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf 4 Pr fen Sie ob der von TouchEvent getEvent zur ckgegebene Wert gleich TouchEvent MOVE ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent MOVE Dialog alert Move event occurred rertrw Crue return false Reagieren auf einen Benutzer der den Bildschirm leicht ber hrt 1 Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui TouchGesture e net rim device api ui Field 32 Entwicklungshandbuch Reagieren auf eine Bildlaufaktion e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField Rufen Sie in Ihrer Implementierung der touchEvent TouchEventmessage Methode TouchEvent getEvent auf Pr fen Sie ob der von TouchEvent getEvent zu
147. tem _viewlItem 4 Geben Sie im Bildschirmkonstruktor mithilfe der Image Klasse das Symbol an das Sie dem Men eintrag hinzuf gen m chten Rufen Sie createImage auf um das Symbol f r den Men eintrag zu erstellen Rufen Sie setIcon auf um das Symbol dem Men eintrag hinzuzuf gen 112 Entwicklungshandbuch Hinzuf gen eines Symbols zu einem Men eintrag Image menulcon ImageFactory createlmage Bitmap getBitmapResource View jpg _viewItem setIcon menulcon 5 Erstellen Sie in der Bildschirmklasse mithilfe der MenuIltem Klasse den Men eintrag Setzen Sie run au er Kraft um die Aktion anzugeben die ausgef hrt wird wenn der Benutzer auf den Men eintrag klickt private Menultem _viewItem new Menultem More Info 110 10 public void run Dialog inform Display more information D Codebeispiel Hinzuf gen eines Symbols zu einem Men element 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 system public class AddIcon extends UiApplication public static void main String args AddIcon theApp new AddIcon theApp enterEventDispatcher public AddIcon pushScreen new AddIconScreen class AddIconScreen extends MainScreen public AddIconScreen setTitle Menu Icon Sample add new RichTextField Add an icon to a menu
148. ter new popUpRunner Word learned return SpellCheckUIlListener LEARNING _ACCEPT Erstellen Sie eine Methode die die SpellCheckUIListener LEARNING ACCEPT Konstante zur ckgibt wenn SpellCheckEngine eine Korrektur f r ein Wort lernt public int wordCorrectionLearned SpellCheckUI ui StringBuffer word StringBuffer correction VUiApplication getUiApplication invokeLater new popUpRunner Correction learned return SpellCheckUlListener LEARNING_ACCEPT 119 Entwicklungshandbuch Empfangen von Rechtschreibpr fungsereignissen 5 Erstellen Sie eine Methode die die SpellCheckUIListener ACTION_OPEN UI Konstante zur ckgibt wenn SpellCheckEngine ein falsch buchstabiertes Wort findet public int misspelledWordFound SpellCheckUI ui Field field int offset int Leni UiApplication getUiApplication invokeLater new popUpRunner Misspelled word found return SpellCheckUIlListener ACTION_ OPEN UI 120 Entwicklungshandbuch Verwandte Ressourcen Verwandte Ressourcen Weitere Informationen zu Benutzeroberfl che und Navigationsentwicklung f r BlackBerry Ger te unter www blackberry com g0 docs developers Weitere Informationen finden Sie hier e APl Referenz f r BlackBerry Java Development Environment e Basishandbuch f r BlackBerry Java Application e Entwicklungshandbuch f r BlackBerry Java Application e BlackBerry Java Application Accessibility Development Guide Entwicklungshandbuch f r BlackBe
149. th ee August Bew hrtes Verfahren Implementieren von Suchfeldern e Stellen Sie ein Suchfeld bereit wenn Sie eine erzwungene Liste von Elementen haben e Verwenden Sie die KeywordFilterField Klasse um Suchfelder zu erstellen e Verwenden Sie die AutoCompleteField Klasse und dieBasicFilteredList Klasse um autocomplete Felder zu erstellen e Geben Sie Benutzern die M glichkeit von ihnen eingegebenen Suchtext mit der Esc Taste zu l schen e Setzen Sie den Standardfokus auf das Suchfeld und das erste Element in der Liste e Zeigen Sie Elemente in den Suchergebnissen an die ein Wort enthalten das mit dem eingegebenen Suchentext beginnt e Weisen Sie einem Bildschirm der ein Suchfeld enth lt keine Tastenkombinationen zu Wenn Sie Tastenkombinationen verwenden wollen und Sie haben eine erzwungene Liste von Elementen stellen Sie alternative Suchfunktionen bereit Zum Beispiel k nnten Benutzer nach Nachrichten in einer Nachrichtenliste durch Dr cken von S oder Verwenden des Men s suchen e Platzieren Sie ein Suchfeld in die Titelleiste eines Anwendungsbildschirms e Machen Sie Suchfelder nicht von Gro und Kleinschreibung abh ngig Richtlinien f r Bezeichnungen e Verwenden Sie f r das Suchfeld die Bezeichnung Suchen e Das Suchfeld darf keinen Eingabeaufforderungstext enthalten Erstellen eines Suchfelds Sie k nnen eine Anwendung erstellen die die KeywordFilterField Klasse verwendet die im n
150. uchEvent CLICK ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent CLICK Dialog alert CLICK occurred returna true return false Reagieren auf einen Benutzer der den Bildschirm zweimal schnell ber hrt L Importieren Sie die folgenden Klassen e net rim device api ui TouchEvent e net rim device api ui TouchGesture e net rim device api ui Field e net rim device api ui Manager e net rim device api ui Screen e net rim device api ui component Dialog Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonrField Pr fen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode das Auftreten eines TouchGesture TAP Ereignisses und dass TouchGesture getTapCount den Wert 2 zur ckgibt protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent 31 Entwicklungshandbuch Reagieren auf einen Benutzer der ein Element auf dem Bildschirm ber hrt und zieht case TouchGesture TAP if gesture getTapCount 2 Dialog alert Double tap occurred return true return false Reagieren auf einen Benutzer der ein Element auf dem Bildschirm ber hrt und zieht 1 Importieren Sie die folgenden Klassen e ne
151. uf private Menultem _viewItem new Menultem More Info 110 10 public void run Dialog inform Display more information D Setzen SieMenu au er Kraft um ein Dialogfeld anzuzeigen wenn der Benutzer auf den Men eintrag Schlie en klickt Standardm ig ist der Men eintrag Schlie en in dem von MainScreen erstellten Men enthalten Rufen Sie super close auf um die Anwendung zu schlie en Wenn der Benutzer das Dialogfeld schlie t ruft die Anwendung MainScreen close auf um die Anwendung zu schlie en public void close Dialog alert Goodbye super close Codebeispiel Erstellen eines Men s Imporgtsneikarn madevilcezap eune import net rim device api ui component import net rim device api ui container public class CreateMenu extends UiApplication public static void main String args CreateMenu theApp new CreateMenu theApp enterEventDispatcher public CreateMenu pushScreen new CreateMenuScreen class CreateMenuScreen extends MainScreen public CreateMenuScreen setTitle Create Menu Sample add new RichTextField Create a menu addMenultem _viewlItem private Menultem _viewItem new Menultem More Info 110 10 105 Entwicklungshandbuch Bew hrtes Verfahren Implementieren von Men s public void run Dialog inform Display more information bi public void close Dialog alert Goodbye super cl
152. uf gen manager addTop new LabelField Hello World 7 Erstellen Sie im Bildschirmkonstruktor einHorizontalFieldManager Objekt Rufen Sie HorizontalFieldManager add auf umdemHorizontalFieldManager Schaltfl chen hinzuzuf gen Rufen Sie EyelidFieldManager addBottom auf um dem unteren Manager des EyelidFieldManager den HorizontalFieldManager hinzuzuf gen HorizontalFieldManager buttonPanel new HorizontalFieldManager Field FIELD_HCENTER Field USE_ALL_WIDTH buttonPanel add new SimpleButton Button 1 buttonPanel add new SimpleButton Button 2 manager addBottom buttonPanel 8 Rufen Sie im Bildschirmkonstruktor EyelidFieldManager setEyelidDisplayTime auf um den Zeitraum der Inaktivit t der vergehen muss bevor das Paar von Managern ausgeblendet wird in Sekunden anzugeben manager setEyelidDisplayTime 3 9 Rufen Sie im Bildschirmkonstruktor add auf um den EyelidFieldManager dem Bildschirm hinzuzuf gen add manager Codebeispiel Vor bergehendes Anzeigen eines ButtonField und eines LabelField oben bzw unten am Bildschirm import import import import import public net rim device api system netanmadevzicemapie liess net rim device api ui component net rim device api ui container net rim device api ui extension container class EyelidFieldManagerDemo extends UiApplication public static void main String args 43 Entwicklungshandbuch Anzeigen von Feldern in
153. uf einen Wert klicken m ssen nehmen Sie einen Wert Keine in die Dropdown Liste auf Platzieren Sie den Wert Keine immer ganz oben in der Liste Gruppieren und ordnen Sie die Werte m glichst logisch fassen Sie zum Beispiel zusammenh ngende Werte in Gruppen zusammen oder beginnen Sie mit den gebr uchlichsten Werten Vermeiden Sie es die Werte alphabetisch anzuordnen weil die alphabetische Reihenfolge sprachspezifisch ist Richtlinien f r Bezeichnungen Verwenden Sie kurze klare Bezeichnungen f r Dropdown Listen und f r die Werte in einer Dropdown Liste Vergewissern Sie sich dass die Bezeichnung klar beschreibt was geschieht wenn Benutzer auf den Wert klicken Die Breite der Dropdown Liste ndert sich basierend auf der L nge der Wertbezeichnungen Wenn eine Bezeichnung zu lang ist werden Auslassungspunkte angezeigt um zu verdeutlichen dass der Text abgeschnitten ist Platzieren Sie die Bezeichnung auf der linken Seite einer Dropdown Liste Verwenden Sie die bliche Gro Kleinschreibung f r die Bezeichnungen von Dropdown Listen sowie von Werten in einer Dropdown Liste Schlie en Sie die Bezeichnungen von Dropdown Listen mit einem Doppelpunkt ab Erstellen einer Dropdown Liste 1 72 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui import net rim device api ui component import net rim device api ui container Erstellen Sie das Anwendungsframework d
154. ufrufen von ViEnginelnstance setAcceptableDirections miteiner der Konstanten die Richtungen aus der Display Klasse entsprechen wird die Richtung festgelegt die das BlackBerry Ger t zum Anzeigen von Informationen verwenden kann Codebeispiel Abrufen der Bildschirmausrichtung switch Display getOrientation case Display ORIENTATION_LANDSCAPE Dialog alert Screen orientation is landscape break case Display ORIENTATION PORTRAIT Dialog alert Screen orientation is portrait break case Display ORIENTATION SQUARE Dialog alert Screen orientation is square break default Dialog alert Screen orientation is not known break Codebeispiel Erzwingen des Hochformats in einer BlackBerry API Anwendung Use code like this before invoking UiApplication pushScreen int direction Display DIRECTION_NORTH Vi getliEnginelnstance setAcceptableDirections direction Codebeispiel Erzwingen des Querformats in einer MIDlet Anwendung Use code like this before invoking Display setCurrent in the MIDlet constructor DirectionControl dc DirectionControl Controllable Display getDisplay this getControl net rim device api lcdui control DirectionControl int directions DirectionControl DIRECTION EAST DirectionControl DIRECTION WEST dc setAcceptableScreenDirections directions Abrufen der Ausrichtung des Touchscreen 1 Importieren Sie dienet rim device api system Display Klasse 2 Rufen Sienet rim device
155. ultem Rufen Sie ApplicationMenultemRepository addMenultem auf um den Men eintrag der entsprechenden BlackBerry Ger teanwendungs Datenbank hinzuzuf gen repository addMenultem ApplicationMenultemRepository MENUITEM_ADDRESSCARD_VIEW contactsDemoMenultem Implementieren Sie run um das Verhalten des Men eintrags festzulegen Wenn im folgenden Codebeispiel ein Benutzer auf den neuen Men eintrag klickt und ein Contact Objekt vorhanden ist empf ngt die ContactsDemo Anwendung das Ereignis und ruft ContactsDemo enterEventDispatcher auf public Object run Object context BlackBerryContact c BlackBerryContact context ir Ce le mil new ContactsDemo enterEventDispatcher else throw new IllegalStateException Context is null expected a Contact instance Dialog alert Viewing an email message in the email view rewurn mulis ndern der Darstellung eines Men s Sie k nnen den Hintergrund Rahmen und die Schriftart von einem Men mithilfe der Menu Klasse im net rim device api ui component Paket ndern Zum Beispiel k nnen Sie die Anzeige vom Men ndern damit es ein Erscheinungsbild hat das hnlich zum Rest von Ihrer BlackBerry Ger teanwendung ist Wenn Sie die Anzeige von einem Men ndern hebt Ihre BlackBerry Ger teanwendung das Thema auf das auf dem BlackBerry Ger t festgelegt ist ndern der Darstellung eines Men s 1 108 Importieren Sie die erforderlichen Kla
156. ur ckgibt unterst tzt das BlackBerry Ger t einen Beschleunigungssensor Mithilfe der AccelerometerData Klasse k nnen Sie die Richtung identifizieren in der der Benutzer das BlackBerry Ger t bewegt Durch Aufrufen von AccelerometerData getOrientation wird eine der Konstanten der AccelerometerSensor Klasse zur ckgegeben die der Richtung des BlackBerry Ger ts entsprechen Wenn AccelerometerData getOrientation beispielsweise einen Wert gleich AccelerometerSensor ORIENTATION_LEFT_UP zur ckgibt weist die linke Seite des BlackBerry Ger ts nach oben Mithilfe der AccelerometerSensor Klasse k nnen Sie Beschleunigungsdaten vom BlackBerry Ger t abrufen Durch Aufrufen von AccelerometerSensor openRawDataChannel wird ein Objekt der net rim device api system AccelerometerSensor Channel Klasse zur ckgegeben Die AccelerometerSensor Channel Klasse erm glicht es Ihnen eine Verbindung zum Beschleunigungssensor herzustellen Sie k nnen Daten vom Beschleunigungssensor abrufen indem Sie AccelerometerSensor Channel getLastAccelerationData aufrufen Durch die Aufrechterhaltung einer Verbindung zum Beschleunigungssensor wird der Akku des BlackBerry Ger ts beansprucht Wenn die BlackBerry Ger teanwendung keine Daten mehr vom Beschleunigungssensor abrufen muss sollten Sie AccelerometerSensor Channel close aufrufen um die Verbindung zu schlie en Codebeispiel Abrufen von Daten vom Beschleunigungssensor short xyz new short 3 while
157. urch Erweitern der UiApplication Klasse Erstellen Sie inmain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im KonstruktorpushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene MyUiScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class MyUi extends UiApplication public static void main String args MyUi theApp new MyUi theApp enterEventDispatcher Entwicklungshandbuch Dropdown Listen 3 public MyUi pushScreen new MyUiScreen Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle auf um den Titel f r den Bildschirm anzugeben class MyUiScreen extends MainScreen public MyUiScreen setTitle UI Component Sample Erstellen Sie im Bildschirmkonstruktor mithilfe derObjectChoiceField Klasse eine Dropdown Liste die eine Liste von W rtern und Formulierungen anzeigt Erstellen Sie ein String Array um die Elemente zu speichern die Sie in der Dropdown Liste anzeigen m chten Erstellen Sie ein int Objekt in dem das Standardelement gespeichert wird das in der Dropdown Liste angezeigt werden soll Geben Sie im ObjectChoiceField Konstruktor die Bezeichnung f r die Dropdown Liste das Array der anzuzeigenden Elemente und
158. wd new PasswordEditField PasswordEditField Strukturansichten Verwenden Sie eine Strukturansicht um Objekte wie z B Ordner in hierarchischer Weise anzuzeigen Objekte in der Strukturansicht sind Knoten Der oberste Knoten ist der Stammknoten Ein Knoten in der Struktur kann untergeordnete Knoten besitzen Ein Knoten der ein untergeordnetes Element hat ist ein bergeordneter Knoten Benutzer k nnen in einer Strukturansicht die folgende Aktion ausf hren Aktion BlackBerry Ger te ohne Touchscreen BlackBerry Ger te mit Touchscreen Erweitern oder Dr cken Sie die Leertaste oder klicken Sieauf Klicken Sie auf den Bildschirm reduzieren Sie ein das Trackwheel den Trackball oder das Objekt mit einem Trackpad Pluszeichen oder Minuszeichen in einer Hierarchie 101 Entwicklungshandbuch Strukturansichten Dwi Fi Services WAP Bookmarks Cl BlackBerry Bookmarks Home Page Bew hrtes Verfahren Implementieren von Strukturansichten Verwenden Sie die TreeField Klasse um Strukturansichten zu erstellen Stellen Sie auf BlackBerry Ger ten mit einem Trackball oder Trackpad ein Kontextmen bereit wenn Benutzer mehrere Aktionen ausf hren k nnen wenn sie auf einen bergeordneten Knoten klicken Wenn Benutzer zum Beispiel auf einen Ordner klicken der Unterordner und Dateien enth lt sollte ein Kontextmen angezeigt werden das Benutzern erm glicht entweder den Ordner zu erweitern oder die Dateie
159. wo int node3 myTree addChildNode node2 fieldThree int node4 myTree addChildNode node3 fieldFour Entwicklungshandbuch Strukturansichten int nodel myTree addChildNode nodel fieldTen myTree setExpanded node4 false mainScreen add myTree S 4 Umein TreeField Objekt neu zu zeichnen wenn sich ein Knoten ndert erstellen Sie eine Klasse die die TreeFieldCallback Schnittstelle implementiert und implementieren Sie die TreeFieldCallback drawTreeItem Methode Die TreeFieldCallback drawTreeItem Methode verwendet das Cookie f r einen Strukturknoten um an der Position eines Knotens ein String Objekt zu zeichnen Die TreeFieldCallback drawTreeIltem Methode ruftGraphics drawText auf um das String Objekt zu zeichnen private class TreeCallback implements TreeFieldCallback public void drawlreeltem TreeField _tree Graphics g int node int y int width int indent String text String _tree getCookie node g drawlext text indent vi 103 Entwicklungshandbuch Men befehle Men befehle Bar Erstellen eines Men s Die MainScreen Klasse stellt Standardkomponenten einer BlackBerry Ger teanwendung bereit Sie enth lt ein Standardmen 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui import net rim device api ui component import net rim device api ui container 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse E
160. zeit oder eine Durchwahl durch Gedr ckthalten der Nummernzeichen Taste an In Textfeldern geben Benutzer Text ein Benutzer k nnen in Textfeldern Text ausschneiden kopieren und einf gen Wenn der Cursor das Ende einer Textzeile erreicht bricht der Text in die n chste Zeile um In Textfeldern k nnen BlackBerry Ger te Telefonnummern Webseiten und E Mail Adressen auch automatisch in Links umwandeln Benutzer k nnen durch Dr cken der Leertaste einen Punkt in ein Adressfeld einf gen Bew hrtes Verfahren Implementieren von Textfeldern e Verwenden Sie die RichTextField Klasse um Textfelder zu erstellen 98 Entwicklungshandbuch Textfelder W hlen Sie den Typ des Textfelds basierend darauf aus welche Art von Eingabe Sie von den Benutzern erwarten Die Verwendung des geeignetsten Textfelds ist wichtig damit die entsprechende Eingabeanzeige auf dem Bildschirm angezeigt wird wenn Benutzer Text eingeben Wenn Benutzer zum Beispiel Text in ein Feld f r Telefonnummern eingeben wird in der rechten oberen Ecke des Bildschirms die Zahlensperrenanzeige angezeigt Das Feld das Sie ausw hlen beeinflusst auch die Standardeingabemethode f r das Feld auf BlackBerry Ger ten mit SureType Technologie Wenn m glich verwenden oder erweitern Sie vorhandene Felder statt benutzerdefinierte Felder zu erstellen sodass die Felder das entsprechende Standardverhalten erben Legen Sie einen geeigneten Fokus fest Wenn m glich setzen Sie d
161. zu binden Rufen Sie add 3 auf um das Feld dem Bildschirm hinzuzuf gen AutoCompleteField autoCompleteField new AutoCompleteField filterList add autoCompleteField Codebeispiel Erstellen eines autocomplete Felds aus einem Datensatz import net rim device api ui UiApplication import net rim device api ui container MainScreen import net rim device api ui component AutoCompleteField UllStetHg eng Te EM Ster eme leese nei public class AutoCompleteFieldApp extends UiApplication public static void main String args AutoCompleteFieldApp app new AutoCompleteFieldApp app enterEventDispatcher AutoCompleteFieldApp HomeScreen scr new HomeScreen this pushScreen scr class HomeScreen extends MainScreen public HomeScreen 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 47 Entwicklungshandbuch Autocomplete Textfeld add autoCompleteField Erstellen eines autocomplete Textfelds aus einer Datenquelle L 48 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui UiApplication import net rim device api ui container MainScreen import net rim device api ui component AutoCompleteField imp

Download Pdf Manuals

Related Search

Related Contents

Jamo SUB360D subwoofer  prescrizioni sicurezza - Alto Calore Servizi Spa  SuperPro Designer ® User Guide  traduction française manuel d`utilisateur Série STERLING de  PAINEL DE INSTRUMENTOS (continuação)  Génération Y  MANUAL DE USUARIO - Carol Automatismos Igualada SA  Richard-Allan Scientific Chromaview Advanced  PictureTel 760XL User's Manual  Pig Out Arcade Service Manual  

Copyright © All rights reserved. Failed to retrieve file