Home

BlackBerry Java SDK - 6.0

1. 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 Rufen Sie Channel close auf um den Kanal zum Beschleunigungssensor zu schlie en channel close 21 Entwicklungshandbuch Abfragen des Beschleunigungssensors wenn sich die Anwendung im Hintergrund befindet 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 Kanal zum Beschleunigungssensor AccelerometerChannelConfig channelConfig new AccelerometerChannelConfig AccelerometerChannelConfig TYPE_RAW 3 Rufen Sie AccelerometerChannelConfig 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
2. case TouchGesture PINCH_END 34 Entwicklungshandbuch Pinch Gesten Dialog alert Focal point message getX 1 a message getY 1 a nFinal zoom value gesture getPinchMagnitude return true return false Aktivieren von Pinch Gesten Standardm ig sind Pinch Gesten auf dem Bildschirm einer BlackBerry Ger teanwendung nicht aktiviert Sie m ssen die Bildschirmeigenschaft festlegen um die Generierung von Pinch Gesten auf einem Bildschirm zu aktivieren 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui import net rim device api ui container mp olgtseneitarn madevaigerapieunesinp lee 2 Erstellen Sie in Ihrem Bildschirmobjekt ein InputSettings Objekt um es mit Touchscreen Eigenschaften aufzuf llen InputSettings ts TouchscreenSettings createEmptySet 3 Setzen Sie die Eigenschaft TouchscreenSettings DETECT_PINCH auf 1 ts set TouchscreenSettings DETECT_PINCH 1 4 Rufen SieScreen addInputSettings auf um dem Bildschirm die Eingabeeinstellungen hinzuzuf gen addInputSettings ts Sie k nnen den Wert der TouchscreenSettings DETECT_PINCH Eigenschaft jederzeit und nicht nur bei der Erstellung des Bildschirms ndern Codebeispiel Dieses Beispiel veranschaulicht wie Sie Pinch Gesten im Konstruktor eines Bildschirms aktivieren public MyScreen setTitle Sample Screen InputSettings ts TouchscreenSettings createEmptySet
3. case TRIANGLE 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 i case RECTANGLE default return _labelWidth 8 59 Entwicklungshandbuch Erstellen eines benutzerdefinierten Feldes 60 Implementieren SiegetPreferredHeight 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 retunnko Implementieren Sie paint Der Manager eines Feldes ruft paint auf um das Feld neu zu zeichnen wenn ein 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
4. ts set TouchscreenSettings DETECT_PINCH 1 addInputSettings ts 35 Entwicklungshandbuch Fingerstrich Gesten mit Trackpads Fingerstrich Gesten mit Trackpads hnlich zu BlackBerry Ger ten mit Touchscreen unterst tzen Ger te mit Trackpad Fingerstrich Gesten die BlackBerry Ger tebenutzer mit dem Trackpad machen Wenn der Benutzer den Finger ber das Trackpad f hrt wird ein TouchEvent Objekt mit dem Ereignistyp TouchGesture NAVIGATION_SWIPE erstellt Sie k nnen mit den folgenden Methoden Informationen zu einem Trackpad Fingerstrich abrufen e TouchGesture getSwipeAngle e TouchGesture getSwipeDirection e TouchGesture getSwipeContentAngle TouchGesture getSwipeContentDirection TouchGesture getSwipeMagnitude Codebeispiel Abrufen von Informationen zu einem Trackpad Fingerstrich Dieses Beispiel veranschaulicht wie Trackpad Fingerstriche in der touchEvent Methode eines Bildschirms verarbeitet werden protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent case TouchGesture NAVIGATION SWIPE Dialog alert Swipe direction gesture getSwipeDirection P E nMagnitude gesture getSwipeMagnitude Perurn erue FSLUIFIN TeNLSes Aktivieren von Fingerstrich Gesten die Benutzer auf dem Trackpad machen Standardm ig sind Fingerstrich Gesten die
5. Codebeispiel Erstellen eines Optionsfeldes 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 MyUiScreen extends MainScreen 84 public MyUiScreen setTitle UI Component Sample RadioButtonGroup rbg new RadioButtonGroup add new RadioButtonField Option 1 rbg true add new RadioButtonField Option 2 rbg false public boolean onSavePrompt Entwicklungshandbuch Aktivitats und Fortschrittsanzeigen Re CUBE EBue Aktivitats und Fortschrittsanzeigen Aktivit ts und Fortschrittsanzeigen zeigen den Benutzern dass ihre BlackBerry Ger te eine Aktion ausf hren z B das Suchen nach Elementen oder das Entfernen von Sprachen Verwenden Sie eine Aktivit tsanzeige wenn Sie zeigen m chten dass das BlackBerry Ger t aktiv ist und Sie nicht bestimmen k nnen wie lange die Aktion dauert Sie k nnen jeder beliebigen Komponente eine Aktivit tsanzeige z B einen Bildschirm ein Textfeld oder einen Listeneintrag hinzuf gen Au erdem k nnen Sie einer Aktivit tsanzeige Text hinzuf gen um die Aktion zu beschreiben Remote Contact Lookup Searching Eine Aktivitatsanzeige in einem Feld Eine Aktivitatsanzeige
6. Reagieren auf einen Benutzer der den Bildschirm leicht ber hrt 1 32 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 ButtonField Rufen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf Pr fen Sie ob der Wert den TouchEvent getEvent zur ckgibt gleich TouchEvent DOWN ist Entwicklungshandbuch Reagieren auf Touchscreen Ereignisse 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 net net net net net rim device rim device rim device rim device rim device api api api api api ui ui ui ui ui TouchEvent TouchGesture Field Manager Screen 2 Erstellen Sie eine Klasse die die Manager Klasse erweitert public class newManager extends Manager 3 Pr fen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode ob der Wert de
7. Sconzauneiss apiickeiner 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie im Konstruktor pushScreen 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 96 DatePick theApp new DatePick theApp enterEventDispatcher Entwicklungshandbuch Auswahltool public DatePick pushScreen new DatePickScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung 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 setTitle Date Picker Sample 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 Uberschreiben Sie run in der Definition von Runnable class Dat
8. Entwicklungshandbuch Bew hrtes Verfahren Implementieren von Men s super close Bew hrtes Verfahren Implementieren von Men s e Stellen Sie stets ein vollst ndiges Men bereit e 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 e Verwenden Sie als Standardmen element das Men element das die Benutzer am wahrscheinlichsten ausw hlen werden e Platzieren Sie den Standardmen eintrag und die anderen am h ufigsten verwendeten Men eintr ge in der Mitte des Men s e Vergewissern Sie sich dass die Reihenfolge der Men eintr ge der Reihenfolge der Men eintr ge in anderen BlackBerry Ger teanwendungen entspricht e _ _Gruppieren Sie Men eintr ge entsprechend der Verwendungsweise oder der Funktionalit t und lassen Sie Ihre Gruppierungen wenn m glich von den Benutzern testen e F gen Sie Trennzeichen zwischen den Men eintragsgruppen ein e 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 e 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 Stan
9. Storm 9500 Series Touchscreen BlackBerry Tour 9630 Smartphone Trackball 10 Entwicklungshandbuch Bildschirme Bildschirme Die Hauptkomponente einer Benutzeroberflache 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 im 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
10. new BasicFilteredList String days Monday Tuesday Wednesday Thursday Friday Saturday Sund ay filterList addDataSet 1 days days BasicFilteredList COMPARISON IGNORE_CASE 5 Erstellen Sie im Konstruktor ein AutoCompleteField Objekt bergeben Sie eine Instanz von BasicFilteredList an den AutoCompleteField Konstruktor um BasicFilteredList an das autocomplete Textfeld zu binden Rufen Sie add 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 MNP OMEMNe Gem NACeVAlGera Diet Ole Gita onau 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 107 Entwicklungshandbuch Suche public HomeScreen BasicFilteredList filterList new BasicFilteredList String days Monday Tuesday Wednesday Thursday Friday Saturday Sunday filterList addDataSet 1 days days BasicFilteredList COMPARISON_IGNORE_CASE Aut
11. 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication 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 Anwendungskonstruktor pushScreen 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 umein Textfeld zum Bildschirm hinzuzuf gen Rufen Sie addMenultem auf umeinen Men eintrag zu dem Men hinzuzuf gen das MainScreen erstellt class CreateMenuScreen extends MainScreen public CreateMenuScreen setTitle Create Menu Sample add new RichTextField Create a menu addMenultem _viewlItem 4 Erstellen Sie den Men eintrag mithilfe der MenuI tem Klasse berschreiben Sie run um die Aktion anzugeben die ausgef hrt wird wenn der Benutzer auf den Men eintrag klickt Wenn der Benutzer auf den Men eintra
12. 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene BrowserFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar 67 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen 10 68 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 browserField new BrowserField Rufen Sie add im Bildschirmkonstruktor auf um dem Bildschirm das BrowserField Objekt hinzuzuf gen add browserField 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 Erstellen Sie im Bildschirm
13. Rufen Sie im Anwendungskonstruktor 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 MyUiScreen extends MainScreen public MyUiScreen 56 Entwicklungshandbuch Kontrollk stchen setTitle UI Component Sample 4 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 t rue zeigt zum Beispiel an dass das Kontrollk stchen standardm ig ausgew hlt ist Rufen Sie add auf um dem Bildschirm das Kontrollk stchen hinzuzuf gen add new CheckboxField First Check Box true add new CheckboxField Second Check Box false 5 Um das Standardverhalten eines Kontrollk stchens zu ndern verwenden Sie die Stile die von der Field Klasse geerbt wurden Um zum Beispiel
14. Trackpad Ausw hlen eines Dr cken der Leertaste oder klicken mit e Tippen auf das Element Optionsfelds dem Trackpad e Dr cken Sie die Leertaste e Klicken mit dem Trackpad Call Logs and Lists Call Logs Show These Call Log Types In Message List _ Missed Calls None Deleting Call Logs Confirm Delete Yes Phone Appearance Initial View Previous v Phone List View l Most Recent Show My Number Bew hrtes Verfahren Implementieren von Optionsfeldern Verwenden Sie Optionsfelder um zwei oder mehr Auswahlm glichkeiten 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 Optionsfelder zu erstellen Vergewissern Sie sich dass der Inhalt f r Optionsfelder statisch bleibt Der Inhalt sollte sich f r Optionsfelder nicht kontextbezogen ndern Starten Sie keine Aktion wenn Benutzer ein Optionsfeld aktivieren ffnen Sie zum Beispiel keinen neuen Bildschirm Richten Sie Optionsfelder senkrecht aus 82 Entwicklungshandbuch Optionsfelder Gruppieren und ordnen Sie die Werte m glichst logisch fassen Sie zum Beispiel zusammenh ngende Optionsfelder in Gruppen zusammen oder beginnen Sie mit den gebr uchlichsten Werten Vermeiden Sie es die Optionsfelder alphabetisch anzuordnen da die alphabetische Reihenfolge sprachspezifisch ist Richtlinien f r Bezeichnu
15. chenkomponente festlegen F r einige Befehle ist m glicherweise ein Kontext erforderlich um zu bestimmen was der Befehl machen soll Wenn Sie keinen Kontext festlegen wird das Men eintrags oder Schaltfl chenobjekt zum Kontext myItem setCommandContext new Object public String toString return My Menultem Object Ws 5 Rufen Sie setCommand auf um den Befehl f r die Benutzeroberflachenkomponente festzulegen und die Befehlsverarbeitung als Argument der Methode bereitzustellen myItem setCommand new Command new DialogCommandHandler 39 Entwicklungshandbuch Verwenden eines Befehl in mindestens einer Anwendung 6 F gen Sie Ihrem Bildschirm die Komponente hinzu addMenultem myItem Der Befehl wird ausgef hrt wenn ein BlackBerry Ger tebenutzer eine Aktion mit der Benutzeroberfl chenkomponente ausf hrt zum Beispiel wenn der Benutzer auf einen Men eintrag klickt Codebeispiele Beispiele dieser Methode zum Definieren und Verwenden von Befehlen finden Sie in der API Referenz zu Menultem und ButtonField Verwenden eines Befehl in mindestens einer Anwendung Sie k nnen einen Befehl in einer lokalen Registry zur Verwendung in der eigenen Anwendung oderineinerglobalen Registry zur Verwendung in einer beliebigen Anwendung auf dem BlackBerry Ger t speichern 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api command import net rim device api
16. die Sie an verschiedenen Positionen in Ihren eigenen oder in anderen Anwendungen auf dem BlackBerry Ger t verwenden k nnen Das Command Framework API enth lt Funktionen f r die Befehlsverarbeitung sowie Befehlsmetadaten und Befehle Element Beschreibung Befehlsverarbeitung Sie verwenden die CommandHandler Klasse um die Funktionalit t zu definieren die Sie in Ihrer Anwendung oder in anderen Anwendungen auf dem Ger t bereitstellen m chten Sie erstellen eine Klasse die die abstrakte CommandHandler Klasse erweitert und definieren die Funktionalit t in der Klassenmethode execute Diese Funktionalit t wird Befehl genannt Befehlsmetadaten Sie verwenden die CommandMetadata Klasse um Metadaten zu definieren die einen Befehl beschreiben Die Metadaten der jeweiligen Befehle werden in einem CommandMetadata Objekt eingebunden In den Metadaten eines Befehl muss als einziger Inhalt die Befehls ID enthalten sein die bei der Erstellung des CommandMetadata Objekts bereitgestellt und im COMMAND_ID Feld des Objekts gespeichert wird CommandMetadata stellt weitere Felder bereit die Sie zur Beschreibung des Befehls verwenden k nnen Dazu geh rt z B das Feld RESOURCE_BUNDLE_ NAME zu dem Sie den Namen des vom Befehl verwendeten Ressourcenpakets zuweisen k nnen Sie k nnen au erdem Metadatenelemente definieren die spezifisch f r einen bestimmten Befehl sind Befehl Sie verwenden die Command Klasse um einen Befehl auszuf hren Sie k
17. 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 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api system IMOOrC MSC Fill CeVviEe aol Wi import net rim device api ui container import net rim device api ui component import java util 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor 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 args FontLoadingDemo app new FontLoadingDemo app enterEventDispatcher public FontLoadingDemo pushScreen new FontLoadingDemoScreen 3 Erstellen Sie den b
18. erhalb des Popup Men s e Dr cken der Esc Taste e ffnen oder Schlie en der Schiebeh lle Ring Tones la 3 Beeps H 3 Bells Adver N 6 eilt 7 eli Antel caren Set AS RINI Properties Assur G H Astut Switch Application Attentve Play Full Menu Balance BB 2 Note BB 4 Note Popup Men s ersetzen Kontextments oder kurze Men s Alle vorhandenen Kontextmen s werden automatisch in Popup Men s konvertiert Bew hrtes Verfahren Implementieren von Popup Men s e Verwenden Sie Popup Men s statt Kontextmen s kurzer Men s Stellen Sie sicher dass das Popup Men f r den Benutzer nutzbringend ist e Legen Sie den Men eintrag der von den Benutzern am wahrscheinlichsten gew hlt wird als Standardmen eintrag fest Der Standardeintrag im Popup Men sollte mit dem Standardeintrag im vollst ndigen Men identisch sein e Stellen Sie nur die h ufigsten Aktionen f r ein markiertes Element in einem Popup Men bereit e Stellen Sie ein Symbol und eine Bezeichnung f r jedes Element im Popup Men bereit Erstellen Sie Symbole mit einer durchschnittlichen Gr e von 33x33 Pixel Diese Symbole werden in einem 60x40 Pixelbereich angezeigt und sollten negative Abstandsorientierungen enthalten Richtlinien f r das Einf gen von Elementen in Popup Men s 136 Entwicklungshandbuch Popup Men s e Platzieren Sie den Standardmen eintrag in die Mitte des Popup Men s e Ordnen Sie die brigen Elemente entspreche
19. 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 mithilfe von 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 fieldTwo int node3 myTree addChildNode node2 fieldThree int node4 myTree addChildNode node3 fieldFour int node1 myTree addChildNode nodel fieldTen myTree setExpanded node4 false mainScreen add myTree Um ein TreeField Objekt neu zu zeichnen wenn sich ein Knoten ndert erstellen Sie eine Klasse die die TreeFieldCallback Schnittstelle implementiert und implementieren Sie die TreeFieldCallback drawTreeltem Methode Die TreeFieldCallback drawTreeIltem Methode verwendet das Cookie f r einen Strukturknoten um an der Position eines Knotens ein String Objekt zu zeichnen Die TreeFieldCallback drawTreeltem Methode ruft Graphics drawText auf u
20. mul 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 BasicFilteredList an das autocomplete Textfeld zu binden Rufen Sie add auf um das Feld dem Bildschirm hinzuzuf gen AutoCompleteField autoCompleteField new AutoCompleteField filterList add 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 109 Entwicklungshandbuch filterList addDataSource 1 Suche 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_FIEL
21. public FilePick pushScreen new FilePickScreen h class FilePickScreen extends MainScreen public FilePickScreen seilitle File Picker Sanole add new LabelField Trying File Picker UiApplication getUiApplication invokeLater new Runnable public void run FilePicker fp FilePicker getInstance FilePickListener fileListener new FilePickListener npessert Sistenenltulelfistenen s fp show WE class FilePickListener implements FilePicker Listener public void selectionDone String str Dialog alert You selected str Suche Benutzer k nnen das Suchfeld auf der Startseite verwenden um nach Elementen in einer beliebigen Anwendung auf dem Ger t zu suchen Dazu geh ren auch Drittanbieteranwendungen Die Suche kann auch Inhalt enthalten der nicht auf dem Ger t gespeichert ist wie z B die Datenbank eines Unternehmens oder eine Website 101 Entwicklungshandbuch Suche Benutzer k nnen auch ein Suchfeld in einer Anwendung verwenden um nach Elementen in dieser Anwendung zu suchen Zum Beispiel k nnten Benutzer eine E Mail Nachricht in einer Nachrichtenliste ein Lied in der Medienanwendung oder einen Kontakt in der Kontaktliste suchen In einigen F llen m chten Sie eventuell Suchergebnisse aus anderen Anwendungen anzeigen In einigen Anwendungen wird das Suchfeld auf dem Bildschirm angezeigt In anderen F llen ist die Suche im vollst ndigen Men Popup Men oder
22. public static void main String args GridFieldManagerDemo theApp new GridFieldManagerDemo theApp enterEventDispatcher GridFieldManagerDemo pushScreen new GridScreen 3 Erstellen Sie das Framework f r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class GridScreen extends MainScreen public GridScreen 4 Im Bildschirmkonstruktor rufen Sie setTitle auf um den Text festzulegen den Sie im Titelabschnitt vom Bildschirm anzeigen wollen setTitle GridFieldManager Demo 46 Entwicklungshandbuch Erstellen eines Raster Layouts Erstellen Sie im Bildschirmkonstruktor eine Instanz der Gr idFieldManager 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 0 fiir den Stil an um den Standardstil zu verwenden GridFieldManager grid grid new GridFieldManager 2 3 0 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 Rufen Sie im Bildschirmkonstruktor die GridFieldManager set Methoden auf um die Eigenschaften des Rasters anzugeben grid setColumnPadding 20 grid setRowPadding 20 Rufen Sie Screen ad
23. 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 AutoTextEditField AutoTextEditField Erstellen eines Datumsfelds 1 Importieren Sie die erforderlichen Klassen und Schnittstellen 117 Entwicklungshandbuch import net rim device api ui import net rim device api ui component import net rim device api ui container import java lang Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor 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 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse Rufen Sie im Bildschirmkonstruktor setTitle a
24. 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 recUlrin ciruies return false Antworten auf Systemereignisse wahrend 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 ButtonField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf 4 Pr fen Sie ob der Wert den TouchEvent getEvent zur ckgibt gleich 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 27 Entwicklungshandbuch Reagieren auf Touchscreen Ereign
25. t oder des Fortschritts verantwortlich sind e DieActivityImageField Klasse stellt Aktivit t mithilfe einer Bitmap dar die Animations Frames enth lt Der angezeigte Frame ndert sich im Zeitablauf In der Regel handelt es sich bei diesem Feld um ein Drehfeld eine Sanduhr oder um einen hnlich animierten visuellen Hinweis Dieses Feld wird mithilfe der ActivityIndicatorView Klasse erstellt und festgelegt e Die ProgressBarField Klasse stellt den Aufgabenfortschritt als Leiste dar die sich w hrend der Aufgabenausf hrung f llt bis die Aufgabe abgeschlossen ist Dieses Feld wird mithilfe der ProgressIndicatorView Klasse erstellt und festgelegt Die Progress Indicator Demo Beispielanwendung wird im BlackBerry Java SDK bereitgestellt Diese Beispielanwendung veranschaulicht wie verschiedene Aktivit tsanzeigen und eine Fortschrittsanzeigenleiste erstellt und ge ndert werden k nnen Anzeigen der Aktivit t Sie k nnen ein Feld in Ihrer BlackBerry Ger teanwendung anzeigen das darauf hinweist dass eine Aktivit t ausgef hrt wird In der Regel handelt es sich bei diesem Feld um ein Drehfeld eine Sanduhr oder um einen hnlich animierten visuellen Hinweis Das Feld wird mithilfe der ActivityImageField Klasse implementiert 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api system Bitmap INMPORE Mt FUN CeviCee aol Ui 5 import net rim device api ui component progressindicator impor
26. 111 Entwicklungshandbuch Aktion Element aus der Liste auswahlen Zu einem anderen Drehungsfeld wechseln BlackBerry Ger te nur mit Trackpad Drehfelder BlackBerry Ger te mit Touchscreen und Trackpad e Fahren Sie mit einem Finger senkrecht Uber das Trackpad Fahren Sie mit dem Finger auf dem Bildschirm oder Trackpad nach oben oder nach unten Klicken mit dem Trackpad e Nehmen Sie einen Finger weg vom Bildschirm e Klicken mit dem Trackpad Fahren Sie mit einem Finger senkrecht e Ziehen Sie einen Finger senkrecht Erstellen eines Drehfelds ber das Trackpad uber den Bildschirm e _ Fahren Sie mit einem Finger senkrecht Uber das Trackpad 12 21 PM 3G F Yul Monday May 10 2010 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import import import import import net nets net nets nets rim device rim device rim device rim device rim device api api api api ui api Aus AUS BUN ui ViApplication component Dialog component TextSpinBoxField container MainScreen container SpinBoxFieldManager 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm
27. Bildschirmkonstruktor die Schriftart f r das Men mithilfe eines FontFamily Objekts fest Rufen Sie forName auf um eine Schriftart vom BlackBerry Ger t abzurufen Rufen Sie getFont auf um den Stil und die Gr e der Schriftart anzugeben try FontFamily family FontFamily forName BBCasual _menuFont family getFont Font PLAIN 30 Ui UNITS px catch final ClassNotFoundException cnfe ViApplication getUiApplication invokeLater new Runnable public void run Dialog alert FontFamily forName threw cnfe toString DE 6 Uberschreiben Sie in der Screen Klasse makeMenu um die Darstellung des Men s anzuwenden Rufen Sie setBackground setBorder 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 146 Entwicklungshandbuch ndern der Darstellung eines Men s Codebeispiel Andern der Darstellung eines Meniis import net rim device api ui import net rim device api ui component WMOORE MSC IM COVIES 29 Wil lt COMEATMAlr 2 WMOORE ME CAVITIES B91 Wil ChEOlr e import net rim device api system public class CreateCustomMenu extends UiApplication public static void main String args CreateCustomMenu theApp new CreateCustomMenu th
28. BlackBerry Java Development Environment Nachdem Sie einen Bildschirm bergang erstellt haben m ssen Sie ihn innerhalb Ihrer Anwendung registrieren Dazu rufen Sie UiEngineInstance setTransition auf und geben den zu entfernenden Ausgangsbildschirm und den anzuzeigenden Eingangsbildschirm sowie die Ereignisse die den bergang verursachen und den anzuzeigenden bergang an Um eine Beispielanwendung herunterzuladen die die Verwendung von Bildschirm berg ngen veranschaulicht besuchen Sie www blackberry com go screentransitionssample Weitere Informationen zu Bildschirm berg ngen finden Sie in der API Referenz f r BlackBerry Java Development Environment Anmerkung Die Skin 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 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 compone
29. Die Benutzeroberflachen APIs initialisieren einfache 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 Sie sollten Screen Objekte nicht f r die Texteingabe verwenden Screen Klassen Class Beschreibung Screen 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 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 ver
30. Elemente zuerst an Vermeiden Sie es die Werte alphabetisch anzuordnen weil die alphabetische Reihenfolge sprachspezifisch ist 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 LabelField um einem Bildschirm ein Textetikett hinzuzuf gen LabelField title new LabelField UI Component Sample LabelField ELLIPSIS 76 Entwicklungshandbuch Listen und Tabellen Listen und Tabellen Verwenden Sie Listen und Tabellen um die Elemente anzuzeigen die Benutzer markieren und ffnen k nnen Wenn die Liste lang ist werden die Elemente in Stapeln abgerufen und angezeigt Wenn Benutzer das letzte Element in der Liste erreichen wird der n chste Elementenstapel am Ende der Liste angezeigt Verwenden Sie eine einfache Liste um Text problemlos in Zeilen anzuzeigen IChoreography steps Great places to eat in NYC Interview questions Minestrone soup recipe Notes from the review meeting Wine Verwenden Sie eine erweiterte Liste um Textzeilen und Symbole anzuzeigen Derzeit zeigen erweiterte Listen nur Informationen an und sind nicht interaktiv All Songs 0 Songs Artists Albums Genres Playlists Shuffle Songs Wenn Sie Elemente in Spalten und Zeilen anzeigen m chten verwenden Sie eine Tabelle 77 Entwicklungshandbuch Listen und Tabellen Message
31. Erstellen eines Felds um Webinhalte anzuzeigen pushScreen new BrowserFieldDemoScreen class BrowserFieldDemoScreen extends MainScreen 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 Inhalten 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 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 unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor 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 d
32. Sie mit dem EncodedImage einen ZoomScreen und rufen Sie pushScreen auf um das Bild zum Vergr ern und Schwenken anzuzeigen 123 Entwicklungshandbuch Anzeigen mehrerer Bilder zum Scrollen public class ZoomableImageApp extends UiApplication public static void main String args ZoomableImageApp theApp new ZoomablelmageApp theApp enterEventDispatcher public ZoomablelImageApp EncodedImage myImg new EncodedImage myImg jpg ZoomScreen zoomableImg new ZoomScreen myImg pushScreen zoomablelmg Anzeigen mehrerer Bilder zum Scrollen Sie k nnen die PictureScrollField Klasse verwenden um eine horizontale Zeile mit Bildern wiederzugeben durch die der Benutzer mithilfe des Trackballs oder durch Ber hren scrollen kann Mit dem PictureScrollField k nnen Sie den Markierungsstil des ausgew hlten Bilds den Hintergrundstil vom PictureScrollField den Anzeigetext unter dem ausgew hlten Bild den beim ersten Ausw hlen eines Bilds angezeigten QuickInfo Text sowie die H he und die Breite der Bilder definieren Codebeispiel Anzeigen einer Reihe von Bildern zum Scrollen import net rim device api system TIM POmeaen Citra mal Mee Valeria Dilley Unies import net rim device api ui component import net rim device api ui container INSORE MBE PUM Cavies aol Ui cleeOlr import net rim device api ui extension component public class PictureScrollFieldDemo extends UiApplication public stat
33. Text bereinstimmt Mit diesem Ansatz k nnen die Benutzer erkennen warum jedes Element in der Suchergebnisliste angezeigt wird e Wenn Benutzer auf einem Bildschirm nach einem Wort suchen m ssen zum Beispiel in einer Nachricht oder auf einer Webseite verwenden Sie im Men den Begriff Suchen Implementieren von Suchfeldern e Setzen Sie den Standardfokus auf das Suchfeld Wenn die Suchergebnisse angezeigt werden setzen Sie den Standardfokus auf das erste Element in der Liste der Suchergebnisse e Verwenden Sie den Begriff Suchen als Hinweistext im Suchfeld e Machen Sie Suchfelder nicht von Gro und Kleinschreibung abh ngig e Platzieren Sie das Suchfeld unter die Titelleiste eines Anwendungsbildschirms e Weisen Sie einem Bildschirm der ein Suchfeld enth lt keine Tastenkombinationen zu Wenn Sie Tastenkombinationen verwenden m chten stellen Sie alternative Suchfunktionen bereit Erlauben Sie zum Beispiel Benutzern nach Nachrichten in einer Nachrichtenliste zu suchen indem sie das Men verwenden 103 Entwicklungshandbuch Suche Erstellen eines Suchfelds Sie k nnen eine Anwendung erstellen die die KeywordFilterField Klasse verwendet die im net 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 d
34. 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 Vermeiden Sie die Bezeichnungen Ja und Nein als Dropdown Listenwerte Formulieren Sie die Option um und verwenden Sie stattdessen ein Kontrollk stchen 73 Entwicklungshandbuch Dropdown Listen Platzieren Sie die Bezeichnung auf der linken Seite der Dropdown Liste Verwenden Sie die Gro Kleinschreibung um die Dropdown Listenbezeichnungen und Werte zu betiteln es sei denn Sie bezeichnen die Werte mit einem Satz Schlie en Sie die Bezeichnungen von Dropdown Listen mit einem Doppelpunkt ab Erstellen einer Dropdown Liste 1 74 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 durch Erweitern der UiApplication Klasse Erstellen Sie in m
35. command registrar 1MPORE Net hl MAdevaGerapie Ui import net rim device api ui container 2 Erstellen Sie eine Befehlsverarbeitung indem Sie eine Klasse erstellen die die abstrakte CommandHandler Klasse erweitert Definieren Sie in execute die Funktionalit t die Sie bereitstellen m chten Um festzulegen ob ein Befehl f r ein bestimmtes Kontextobjekt ausf hrbar ist k nnen Sie canExecute optional in Ihrer Befehlsverarbeitung implementieren Wenn Sie canExecute nicht implementieren ist Ihr Befehl immer ausf hrbar private static class ViewContactCommand extends CommandHandler public void execute ReadOnlyCommandMetadata metadata Object context Invoke the Contacts application to view a contact here public boolean canExecute ReadOnlyCommandMetadata metadata Object context Return true if the command can be executed with the passed in context object 3 Definieren Sie die Metadaten des Befehls String id com example contacts view emailaddr CommandMetadata metadata new CommandMeta id 4 Wenn Anwendungen die den Befehl verwenden Instanzen vom Befehl erstellen m ssen speichern Sie den Klassennamen des Befehls in den Metadaten metadata setClassname ViewContactCommand class getName 40 Entwicklungshandbuch Verwenden eines Befehl in mindestens einer Anwendung Anmerkung Anwendungen k nnen Instanzen von Drittanbieterbefehlen nur dann dynamisch erstellen wenn die Befehle in der loka
36. cs cey iessaescedschccconsessewstesssesoteetsdausaeeseteacecyaasedacseesadetedcadansncdseteasesvansed Antworten auf Systemereignisse w hrend der Benutzer den Bildschirm berth rt ccccssssseeeeeeeees vv O ON N Reagieren auf einen Benutzer der einen Finger schnell nach oben ber den Bildschirm bewegt Reagieren auf einen Benutzer der einen Finger schnell nach unten Uber den Bildschirm bewegt Reagieren auf einen Benutzer der einen Finger schnell nach rechts ber den Bildschirm bewegt Reagieren auf einen Benutzer der schnell einen Finger nach rechts ber den Bildschirm bewegt Reagieren auf einen Benutzer der auf den Bildschirm Klickt cccccccccssscceeessseceessssececeseeeeeessseeeeeeeaes Reagieren auf einen Benutzer der den Bildschirm zweimal schnell ber hrt eeeee Reagieren auf einen Benutzer der ein Element auf dem Bildschirm ber hrt und zieht Reagieren auf einen Benutzer der den Bildschirm leicht ber hrt eeensesneseeneennneneeneenn Reagieren auf eine Bildlaufaktion Reagieren auf einen Benutzer der den Bildschirm an zwei Stellen gleichzeitig ber hrt Pinch Geste iniaenoi a a E aE E Haren exensdus bees tance E A E O E EE N ee Aktivieren von Pinch Gesten uuuussessesnnensnnnnensnnnnnnnnnnnnnnnnnnnnannennnnnnnnnennnnnnnnnnnnnnensnnnensennsnnnsnnnsnnnnennnnn Fingerstrich Gesten
37. eine Bezeichnung f r das Eingabefeld von KeywordFilterFleld fest _keywordField setLabel Search 8 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 104 Entwicklungshandbuch Suche 9 Um eine Methode zu erstellen die einen Vektor von Count ry 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 10 Erstellen und speichern Sie einen Verweis auf ein neues Vector Objekt Vector countries new Vector 11 Erstellen Sie einen Eingabestrom zur Textdatei InputStream stream getClass getResourceAsStream Data CountryData txt 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 analysiert um Daten zu extrahieren die f r das Erstellen von Country Objekten verwendet werden ORCS I Obtain a line of text from the text file String Line new String lineReader readLine If we are not at the end of the file parse the line of text neta line ecuals aE Olas i int spacel
38. f r die Anwendung anzuzeigen Die HomeScreen Klasse stellt den in Schritt 3 beschriebenen benutzerdefinierten Bildschirm dar 112 Entwicklungshandbuch Drehfelder public class SpinBoxApp extends UiApplication public static void main String args SpinBoxApp app new SpinBoxApp app enterEventDispatcher eee SpinBoxApp pushScreen new HomeScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen 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 January February March April May June July A ugust September October November December 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 Bil
39. hren Aktion BlackBerry Ger te nur mit Trackpad EIS ELE DU LISTEN Trackpad Erweitern oder Reduzieren Dr cken der Leertaste oder Klicken mit e Tippen auf das Objekt eines Objekts mit einem dem Trackpad e Dr cken Sie die Leertaste Pluszeichen oder e Klicken mit dem Trackpad Minuszeichen in einer Hierarchie Bookmarks BlackBerry Bookmarks Home Page BlackBerry Bo mobile blackberry com GRogers Shop Home Page Rogers Shop rogers mobi internet Bew hrtes Verfahren Implementieren von Strukturansichten Verwenden Sie die TreeField Klasse um Strukturansichten zu erstellen Stellen Sie ein Popup Men bereit wenn Benutzer beim Anklicken eines bergeordneten Knotens mehrere Aktionen ausf hren k nnen Nehmen Sie nur dann einen Stammknoten auf wenn die Benutzer Aktionen f r die gesamte Struktur ausf hren k nnen m ssen Verzichten Sie anderenfalls auf den Stammknoten 119 Entwicklungshandbuch Strukturansichten Erstellen eines Feldes f r das Anzeigen einer Strukturansicht Verwenden Sie eine Strukturansicht um Objekte wie z B eine Ordnerstruktur auf hierarchische Weise anzuzeigen TreeField enth 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 120 Importieren Sie die erforderlichen Klassen und Schnittstellen
40. in der Werkzeugleiste verf gbar Zeigen Sie die Suchergebnisse an noch w hrend die Benutzer Text in ein Suchfeld eingeben Wenn eine gro e Anzahl an Suchergebnissen zur ckgegeben wird erm glichen Sie es den Benutzern ihre Suche auf ein Feld oder eine Gruppe von Feldern einzugrenzen Wenn die Benutzer zum Beispiel die Nachrichtenliste durchsuchen k nnen sie die Dropdown Liste rechts vom Suchfeld verwenden um ihre Suche auf das Feld An oder Betreff einzugrenzen Weitere Informationen zum Hinzuf gen von Suchfeldern zu Ihrer Anwendung finden Sie im BlackBerry Java Application Integration Development Guide Contacts ob New Contact Create a new contact named A Remote Lookup LS Lookup A in remote directory o Bei an o Ahmed Farrakha GA Alex Kinsella f o Alida Droogendyk EEE o Andrea Aime Angela Van Daele BE Atsuko Iwamoto Alcd Benutzer k nnen in einem Suchfeld folgende Aktionen ausf hren 102 Entwicklungshandbuch Suche BlackBerry Ger te mit Touchscreen und Aktion BlackBerry Ger te nur mit Trackpad Trackpad ffnen eines markierten e Dr cken Sie die Eingabetaste e Antippen des Bildschirms Elements in den e Klicken mit dem Trackpad e Dr cken Sie die Eingabetaste Suchergebnissen e Klicken mit dem Trackpad Anzeigen eines Popup Klicken und halten Sie mit dem e Ber hren und halten Sie ein Men s mit Aktionen f r ein Trackpad Suchergebnis auf dem Bildschirm Suchergebni
41. int halfwayDown Display getHeight 2 manager add new LabelField Hello world 2 halfwayDown add manager 52 Entwicklungshandbuch Benutzeroberflachen Komponenten Benutzeroberflachen Komponenten BE 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 Benutzeroberflachenkomponente Ihrer Erweiterung einer Screen Klasse hinzu mainScreen add myCheckbox Ausrichten eines Feldes an einer Textzeile Sie k nnen eine Anwendung erstellen die ein Field Objekt mithilfe der Markierung Field FIELD_LEADING am Anfang einer Textzeile ausrichten kann Wenn Sie zum Beispiel ein Field mit der Ausrichtungsmarkierung Field FIELD_LEADING erstellen und einem VerticalFieldManager das Field hinzuf gen wird das Field wenn die Anwendung beispielsweise beginnt ein englisches oder chinesisches Gebietsschema zu verwenden an der linken Seite des Bildschirms ausgerichtet Wenn die Anwendung beginnt ein arabisches oder hebr isches Gebietsschema zu verwenden wird das Field an der rechten Seite des Bildschirms ausgerichtet Schaltfl chen Verwenden Sie Schaltfl chen um Benutzern zu erm glichen eine Aktion ber ein Dialogfeld auszu
42. kein physisches Anklicken und Deaktivieren durch erneutes Anklicken Stattdessen treten die Aktionen dann auf wenn der Benutzer den Bildschirm antippt Antippen ist ein TouchEvent DOWN Ereignis auf das schnell ein TouchEvent UP Ereignis folgt Diese Kombination von Ber hrungsereignissen wird als Geste bezeichnet weswegen auch ein TouchGesture auftritt Bei einem Antippen tritt ein TouchGesture TAP Ereignis zusammen mit dem TouchEvent DOWN und TouchEvent UP Ereignis auf Fur eine gr ere Kompatibilit t zwischen den beiden Modellarten f r Touchscreen Interaktionen treten auf Ger ten die leichte Klick Interaktionen unterst tzen die beiden Ereignisse TouchEvent CLICK und TouchEvent UNCLICK nach dem TouchGesture TAP Ereignis auf sodass Sie beim TouchEvent UNCLICK Ereignis eine Aktion auf allen Touchscreen Ger ten aufrufen k nnen und das unabh ngig davon ob das Ger t ber einen SurePress Touchscreen verf gt oder nicht Ger te die leichte Klick Interaktionen Benutzeraktion a Ger te mit einem SurePress Touchscreen unterst tzen Ber hren des TouchEvent DOWN TouchEvent DOWN Bildschirms Ber hren eines Element TouchGesture HOVER TouchGesture HOVER und mit dem Finger halten Klicken auf den TouchEvent CLICK Bildschirm Klicken auf den TouchEvent CLICK_REPEAT Bildschirm und halten Loslassen des TouchEvent UNCLICK Bildschirms Entfernen eines Fingers TouchEvent UP TouchEvent UP vom Bilds
43. line indexOf String country line substring 0 spacel int space2 line indexOf spacel1 1 String population line substring spacel l space2 String capital line substring space2 1 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 105 Entwicklungshandbuch Suche 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 ein BasicFilteredList Objekt damit verkn pfen Durch BasicFilteredList bleiben die Bez ge auf Datenobjekte erhalten mit denen verglichen wird um die Liste der W rter und S tze zu erste
44. mit Trackpads 24s0000 0104000000000 0v00 0000000 aar A aaRS EEE Ea KEARE AEREE SE A EAEE NESE seeds Aktivieren von Fingerstrich Gesten die Benutzer auf dem Trackpad Machen cccccccccccesceceeeeeeeeeeeeees Ereignisinjektion Command Framework API Verwenden eines Befehls mit einer Benutzeroberfl chenkomponente uuussssssneenseneennonnnnennennnennnnennnnn Verwenden eines Befehl in mindestens einer Anwendung uuueeeeessesssnnnenennnnsnsnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnensnnnnnnn Anordnen von BenutzeroberflachenkoOMpOnenten c ccssccsssscesccessecssesccessccsseesssseceseecceeseuscesuecesaeessaeeceatess Anordnen von Benutzeroberfl chenkomponenten uuusesessssssssssennsnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnennnn Erstellen eines Raster Layouts uessesssesssssssnnnnnnnnnnnssnnnnnnnnnnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnesnnnnnsnnnnnnnnsnnnsnnnnnnnnnsnnnnn Erstellen einer Gitte rer Gls yas sscccdisiecd case edecdnees ach nennen ra AA AEA EE a ER AA EE EOE A NE A ESENE ANGT Anzeigen von Feldern in einem Paar tempordrer Manage ccccccsessssssssceecseccceeeseeseeesesessseseeeeeseeseeeeseeeees Vor bergehendes Anzeigen eines ButtonField und eines LabelField oben bzw unten auf dem Bildschirm Anzeigen eines Felds an einer absoluten Position auf dem BildschirmM sssssssssrsssssssssrsrrrrsnnsssesreernrrnnssnssee Anzeigen einer Bezeichnung an einer absoluten Position auf dem Bil
45. nnen sich eine Command Instanz als ein Proxy zu einer Klasseninstanz vorstellen die CommandHandler erweitert Beim Aufruf von Command execute wird dieser an die zugewiesene CommandHandler Instanz delegiert Zur Ausf hrung erfolgt dabei eine bergabe des aktuellen Kontext sowie eine transparente bergabe einer schreibgesch tzten Version der zugewiesenen Befehlsmetadaten Das Command Framework API stellt zwei Registries bereit die Sie zum Speichern der Befehle verwenden k nnen e Sie k nnen die lokale Registry zum Speichern von Befehlen nutzen die Sie in Ihrer Anwendung mithilfe der LocalCommandRegistrarConnection Klasse verwenden e _ Sie k nnen die globale Registry zum Speichern von Befehlen nutzen die Sie in anderen Anwendungen auf dem Ger t mithilfe der RemoteCommandRegistrarConnection Klasse verwenden Die Command Framework Demo und Command Framework Demo Remote App Beispielanwendungen sind im BlackBerry Java SDK enthalten Diese Beispielanwendungen veranschaulichen wie Befehle in einer einzelnen Anwendung definiert und verwendet werden und wie Befehle in einer Anwendung definiert und dann in anderen Anwendungen verwendet werden 38 Entwicklungshandbuch Verwenden eines Befehls mit einer Benutzeroberflachenkomponente Verwenden eines Befehls mit einer Benutzeroberflachenkomponente Sie k nnen einen Befehl zur Verwendung mit einer Benutzeroberfl chenkomponente in Ihrer BlackBerry Ger teanwendung definieren Wenn Sie
46. 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 die die ListFieldCallback Schnittstelle implementiert Implementieren Sie drawListRow um die Listenfeldelemente zum Bildschirm hinzuzuf gen Implementieren Sie get um das Listenfeldelement 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 w String text String listElements elementAt index ERIRAWNETEGLEXT Om Vien OFEN le Object get ListField list int index return _listElements elementAt index ie iae WMNCSCikLiIse lLiscricwe liste Serine foirewik Wie Strine return _listElements indexOf prefix string public int getPreferredWidth ListField list 81 Entwicklungshandbuch Optionsfelder return Display getWidth Optionsfelder Verwenden Sie Optionsfelder um einen Satz sich gegenseitig ausschlie ender aber verwandter Auswahlen anzuzeigen Benutzer k nnen die folgende Aktion mit Optionsfeldern ausf hren Aktion BlackBerry Ger te nur mit Trackpad EISEN DW
47. te nur mit Trackpad BlackBerry Ger te mit Touchscreen und Trackpad Klicken auf einen Wert in Dr cken der Eingabetaste oder Klicken e Tippen auf das Element einer Dropdown Liste mit dem Trackpad e Dr cken Sie die Eingabetaste e Klicken mit dem Trackpad BBAlpha Sans X Font Size 9 Font Style Plain Font Smoothing Bold The quick brown fo gt the lazy dog ExtraBold Menu Bold Italic Menu Style Short Ica Backlight Backlight Brightness 100 v Backlight Timeout 30 Sec v 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 kein Problem ist sollten Sie stattdessen Optionsfelder verwenden sodass die Benutzer die verf gbaren Optionen auf dem Bildschirm anzeigen k nnen Verwenden Sie zur Erstellung von Dropdown Listen die Obj ect ChoiceField oder NumericChoiceField Klasse 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 auf einen Wert klicken m ssen nehmen Sie einen Wert wie Kein e s in die Dropdown Liste auf Platzieren Sie den Wert Kein e s 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
48. 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 Vorteil ohne M ngelgew hr und ohne ausdr ckliche oder konkludente Bedingungen Billigungen Garantien Zusicherungen oder Gew hrleistungen jeglicher Art von 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 R TEILE VON RIM PRODUKTEN ODER DIENSTEN AUSSER KRAFT Research In Motion Limited 295 Phillip Street Waterlo
49. xyz new short 3 while running channel getLastAccelerationData xyz Thread sleep 500 6 Rufen SieChannel 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 AccelerometerChannelConfig channelConfig new AccelerometerChannelConfig AccelerometerChannelConfig TYPE_RAW 22 Entwicklungshandbuch Abrufen von Beschleunigungssensordaten aus einem Puffer Rufen Sie AccelerometerChannelConfig 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 um 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 Acceleromete
50. 0 Datum Beschreibung 16 August 2010 Das folgende Thema wurde entfernt e Erstellen einer Fortschrittsanzeige 3 August 2010 Die folgenden Themen wurden hinzugef gt e Zugriff auf ein codiertes Bild ber einen Eingabestream e Info ber das Einf gen von Elementen in Popup Men s e _ Bew hrtes Verfahren Implementieren von Popup Men s e _ Bew hrtes Verfahren Implementieren von Untermen s e Command Framework API e Erstellen eines Popup Men s e Erstellen eines Popup Men s e Erstellen eines Untermen s e Anzeigen einer Bezeichnung an einer absoluten Position auf dem Bildschirm e Anzeigen eines codierten Bilds e Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken e Anzeigen mehrerer Bilder zum Scrollen e Anzeigen eines Felds an einer absoluten Position auf dem Bildschirm e Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken e Anzeigen mehrerer Bilder zum Scrollen e Aktivieren von Pinch Gesten e Aktivieren von Fingerstrich Gesten die Benutzer auf dem Trackpad machen e Codieren eines Bilds e Bilder e Anzeigen der Aktivit t e Anzeigen des Fortschritts e _ Anzeigen von Aktivit t oder Aufgabenfortschritt e _Pinch Gesten e Popup Men s e Festlegen des Decodierungsmodus f r ein Bild e Festlegen der Anzeigegr e eines codierten Bilds e Unterments e Unterst tzung f r ltere Kontextmen s e _ Fingerstrich Gesten mit Trackpads e Modelle f r Touchscreen Interaktionen 157 E
51. BlackBerry Ger tebenutzer auf dem Trackpad machen nicht auf dem Bildschirm aktiviert Sie m ssen die Navigationseigenschaft so festlegen dass auf dem Bildschirm das Erzeugen von Fingerstrich Gesten ber das Trackpad aktiviert ist 1 Importieren Sie die erforderlichen Klassen und Schnittstellen IMOOrC MSC rill CaVviEee aol Wi import net rim device api ui container import net rim device api ui input 36 Entwicklungshandbuch Ereignisinjektion 2 Erstellen Sie in Ihrem Bildschirmobjekt ein InputSettings Objekt um es mit Navigationseigenschaften aufzuf llen InputSettings nd NavigationDeviceSettings createEmptySet 3 Setzen Sie die Eigenschaft NavigationDeviceSettings DETECT_SWIPE auf 1 nd set NavigationDeviceSettings DETECT_SWIPE 1 4 Rufen SieScreen addInputSettings auf um dem Bildschirm die Eingabeeinstellungen hinzuzuf gen addInputSettings nd Sie k nnen den Wert der NavigationDeviceSettings DETECT_SWIPE Eigenschaft jederzeit und nicht nur bei der Erstellung des Bildschirms ndern Codebeispiel Dieses Beispiel veranschaulicht wie Sie im Konstruktor eines Bildschirms Fingerstrich Gesten ber das Trackpad aktivieren public MyScreen setTitle Sample Screen InputSettings nd NavigationDeviceSettings createEmptySet nd set NavigationDeviceSettings DETECT_SWIPE 1 addInputSettings nd Ereignisinjektion Mithilfe der EventInjector Klasse und ihrer inneren Klassen k nnen S
52. BlackBerry Java SDK Ul and Navigation Version 6 0 Entwicklungshandbuch BlackBerry Ver ffentlicht 2010 12 21 SWD 1239696 1223125741 003 Inhaltsverzeichnis 1 Erstellen einer Benutzeroberflache die mit den standardm igen BlackBerry Benutzeroberflachen VIE OLE E AEE EETAS eye EEEE ES FEE EE SERT FIAR TYOP E arr ae retry sierra ARE tre See ree BlackBerry Ger t Eingabe und Navigation f r Benutzer uueessssssessneensnnenennenennennnennnnnnnnnnnennnnnnensnnnnnnnnennnnnnnn TOUCHSCHEE ML ersehen an een Harder er E is rere E errr terre rere ner TACK DaAMOC ST MACK PD AG ienr e a a a n N e a R E Trackball EmpfimdlichkKe its sises e kn aan la Ede A EA n E E E E E EE E A E E E E E EE ESEA Trackwhee becana a a e a E E e a E a EE Tastatur as A E E T E E A E EE EES E E Interaktionsmethoden auf BlackBerry Ger ten BOUSO mean E Screen Klassen Verwalten eines Zeichenbereichs cccccccccccccceceeeeeeeeeeeeeesueueuseeeesuseseeeeeeseseececececececeeeeecceeceeeeeceseeeeseeeeeneneeeeeeaes Erstellen eines BildschirMUbergangs ccccccsssssccccceceesccesessseeeeeeeeceseeeesessseeeeseeeceeseseessseeeeeeesesseeeeseaaeeeeeseeeees Codebeispiel Erstellen eines Bildschirm bergangs Festlegen des Formats und der Richtung des Bildschirms Abrufen der Ausrichtung des TOUCHSCrEEN cccssssceessssseccccssssececesssseccceesssececceseeececesaseseseeaseeeeeesseeeeeees Schr nken Sie die Richtung des Touchscreen
53. D CONTACTS EMAIL BasicFilteredList DATA FIELD CONTACTS __ NAME_FULL BasicFilteredList DATA_FIELD CONTACTS NAME FULL null 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 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 DATA_SOURCE_APPOINTMENTS e e DATA_SOURCE_CONTACTS p 110 Felder DATA_FIELD_APPOINTMENTS_ALL DATA_FIELD_APPOINTMENTS_ATTENDEES DATA_FIELD_APPOINTMENTS_ORGANIZER DATA_FIELD_APPOINTMENTS_SUBJECT 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 DATA_FIELD_CONTACTS_NAME_FIRST DATA_FIELD_CONTACTS_NAME_LAST DATA_FIELD_CONTACTS_NOTES DATA_FIELD_CONTACTS_PAGER DATA_FIELD_CONTACTS_PHONE_ALL Entwicklungshandbuch Drehfelder Datenquelle Felder e DA
54. 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 class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen 4 Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserField Klasse BrowserField myBrowserField new BrowserField 5 Rufen Sie add im Bildschirmkonstruktor auf um dem Bildschirm das BrowserField Objekt hinzuzuf gen add myBrowserField 6 RufenSieBrowserField displayContent imBildschirmkonstruktor auf um den HTML Inhalt festzulegen und anzuzeigen myBrowserField displayContent lt html gt lt body gt lt h1 gt Hell 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 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 62 Entwicklungshandbuch
55. 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 83 Entwicklungshandbuch Optionsfelder setTitle UI Component Sample Erstellen Sie im Bildschirmkonstruktor eine Gruppe von Optionsfeldern und verwenden Sie dazu die RadioButtonGroup Klasse Erstellen Sie die Optionsfelder die Sie der Gruppe mithilfe der RadioButtonField Klasse hinzuf gen m chten Geben Sie im RadioButtonField Konstruktor die Bezeichnung f r das Optionsfeld die Gruppe und einen booleschen Wert an um die Standardauswahl zu definieren zum Beispiel bedeutet true dass standardm ig die Option ausgew hlt ist Rufen Sie add auf um dem Bildschirm die Optionsfelder hinzuzuf gen RadioButtonGroup rbg new RadioButtonGroup add new RadioButtonField Option 1 rbg true add new RadioButtonField Option 2 rbg false Um die Standardfunktionalit t zu berschreiben die den Benutzer auffordert nderungen vor dem Schlie en der Anwendung zu speichern berschreiben Sie in der Erweiterung der MainScreen Klasse die Methode MainScreen onSavePrompt Im folgenden Codebeispiel wird true zur ckgegeben Dies bedeutet dass vor dem Schlie en keine Benutzeraufforderung durch die Anwendung erfolgt public boolean onSavePrompt REGU E RUE
56. Indicator Message Contacts 7 Delete lan Dundas Delete Default button Cancel Trevor Cameron Bew hrtes Verfahren Implementieren von Dialogfeldern Verwenden Sie Schaltfl chen zum Best tigen oder Abbrechen von Aktionen in Dialogfeldern Vermeiden Sie die Verwendung von Links oder anderen Komponenten Verwenden Sie eine Standardanzeige die der Art des Dialogfelds entspricht Vermeiden Sie die Verwendung von Mehrfachanzeigen in einem Dialogfeld Vermeiden Sie wenn m glich dass Benutzer in einem Dialogfeld scrollen m ssen 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 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 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 Si
57. Is erstellen Ein Popup Men besteht aus den Lieferanten f r Kontextmen und Befehlselement und aus Befehlselementen 138 Entwicklungshandbuch Element Lieferant f r das Kontextmen Lieferant f r Befehlselement Befehlselemente Popup Men s Beschreibung Sie verwenden die DefaultContextMenuProvider Klasse um das Popup Men eines Bildschirms zu erstellen und anzuzeigen Wenn ein BlackBerry Ger tebenutzer ein Popup Men ffnet sucht der Lieferant des Kontextmen s nach Feldern auf dem Bildschirm die Lieferanten f r Befehlselemente sind DefaultContextMenuProvider ist die Standardimplementierung von ContextMenuProvider Wenn Sie keinen Bildschirm mit einem Lieferanten f r ein Kontextmen bereitstellen wird das ltere Kontextmen konvertiert und als Popup Men angezeigt Sie verwenden die CommandItemProvider Klasse um ein Feld auf dem Benutzeroberfl chen Bildschirm zu konfigurieren damit das Feld dem Popup Men Kontext und Befehlselemente basierend auf dem aktuellen Kontext bereitstellen kann So k nnten Sie beispielsweise eine E Mail Adresse als Lieferant eines Befehlselements konfigurieren und dem Benutzer verschiedene Aktionen bereitstellen die darauf basieren ob sich die E Mail Adresse in der Kontaktliste des Benutzers befindet oder nicht Sie verwenden die CommandItem Klasse um den Text sowie das Symbol und Verhalten eines Popup Men eintrags festzulegen Sie definieren das Verhalten des Popup Men
58. Methode auf um die Schriftart auf das in Schritt 5 erstellte LabelField anzuwenden try FontFamily family FontFamily forName MyFont Font myFont family getFont Font PLAIN 50 helloWorld setFont myFont catch ClassNotFoundException e 6 Rufen Sie im Bildschirmkonstruktor add auf um dem Bildschirm LabelField hinzuzuf gen System out printin e getMessage add helloWorld Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung import net rim device api system import net rim device api ui import net rim device api ui container import net rim device api ui component import java util public class FontLoadingDemo extends UiApplication public static void main String args FontLoadingDemo app new FontLoadingDemo app enterEventDispatcher public FontLoadingDemo 150 Entwicklungshandbuch Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung pushScreen new FontLoadingDemoScreen class FontLoadingDemoScreen extends MainScreen public FontLoadingDemoScreen setTitle 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 MyFont Font myFont typeface
59. N 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 AUSFALLZEITEN 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 F R FAHRL SSIGKEIT 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 GELTE
60. N 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 TZLICH ZU DEN OBEN GENANNTEN EINSCHR NKUNGEN UND AUSSCHL SSEN HAFTEN DIE F HRUNGSKR FTE ANGESTELLTEN VERTRETER DISTRIBUTOREN LIEFERANTEN UNABH NGIGEN AUFTRAGNEHMER VON RIM ODER RIM ANGEH RENDEN 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 Planen und Funktionen F r die Installation und Verwendung von Drittprodukten und diensten mit den Produkten und Diensten von RIM sind m glicherweise Patent Marken 160 Entwicklungshandbuch Rechtliche Hinweise Urheberrechts oder andere Lizenzen erforderlich damit die Rechte Dritter nicht verletzt werden Es liegt in Ihrer Verantwortung zu entscheiden ob Sie Drittprodukte
61. ND TransitionContext KIND_OUT engine setTransition _secondaryScreen null UiEngineInstance TRIGGER_POP transition MainScreen baseScreen new MainScreen baseScreen setTitle Screen Transition Sample ButtonField buttonField new ButtonField View Transition ButtonField CONSUME CLICK buttonField setChangeListener this baseScreen add buttonField pushScreen baseScreen _popRunnable new Runnable public void run popScreen _secondaryScreen hs public void fieldChanged Field field int context pushScreen _secondaryScreen invokeLater _popRunnable 2000 false Festlegen des 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 15 Entwicklungshandbuch Festlegen des Formats und der Richtung des Bildschirms 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 die net rim device api system Display Klasse verwenden um die Ausric
62. Position des Anfangs und Endpunkts einer Linie zu berechnen Rufen Sie graphics 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 int textX textY textWidth int w getWidth switch _shape case TRIANGLE int h w gt gt 1 int m w gt gt 1 1 graphics drawLine h 1 m 0 graphics drawLine m 0 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 1 break case OCTAGON ine x Seyi ale int x2 w x 1 int x3 w 1 graphics drawLine 0 x 0 x2 graphies edrawMiine x mT graphics drawLine x 0 x2 0 Se NiES ClraniLiMeOG M3 X75 943 5 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen graphics drawLine 0 x x 0 graphics drawLine x2 x x3 graphics drawLine x2 0 x3 x graphies sdrawMine C2 XS rn textWidth Math min _labelWidth w 6 textX w textWidth gt gt 1 textY w _labelHeight gt gt 1 break case RECTANGLE default graphics draw
63. Rect 0 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 Field set und get Methoden Implementieren Sie die Field getLabel Field getShape Field setLabel String label undField setShape int shape Methoden um die Instanzvariablen des benutzerdefinierten Felds zur ckzugeben public String getLabel return _label public int getShape return _shape public void setLabel String label _ label label _labelWidth _font getAdvance _ label updateLayout public void setShape int shape _shape shape Erstellen eines Felds um Webinhalte anzuzeigen Anzeigen von HTML Inhalten in einem Browserfeld 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 61 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen
64. Sie dabei einen der folgenden Modi als Parameter e Verwenden Sie DECODE_ALPHA um einen Alphakanal zu decodieren sofern vorhanden dies ist der Standardmodus e Verwenden Sie DECODE_NATIVE um die Decodierung eines Bitmap Bilds in den systemeigenen Bitmap Bildtyp der BlackBerry Device Software zu erzwingen e Verwenden Sie DECODE_READONLY um das decodierte Bitmap Bild als schreibgesch tzt zu markieren Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken Die ZoomScreen Klasse erm glicht Ihnen die Bereitstellung der Bildfunktionalit ten Schwenken und Vergr ern Verkleinern Wenn ein BlackBerry Ger tebenutzer mit dem Trackball oder auf den Touchscreen klickt zeigt der Bildschirm den mittleren Bereich des vergr erten Bilds an 122 Entwicklungshandbuch Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken Wenn das Bild vergr ert wird wird auf dem Bildschirm zudem ein Overlay angezeigt das den vergr erten Bereich hervorhebt Durch Scrollen mit dem Trackball oder Bewegen eines Fingers auf dem Bildschirm wird das Bild geschwenkt Wenn der Benutzer das Vergr ern und Schwenken beendet wird das Overlay auf dem Bildschirm ausgeblendet Auf BlackBerry Ger ten mit Touchscreen k nnen Benutzer den Bereich des zu vergr ernden Bilds definieren Der Benutzer kann zwei Punkte auf dem Bild ber hren um die diagonal entgegengesetzten Ecken des Bereichs zu definieren Nach der Auswahl des Bereichs kann der B
65. Sie das Anwendungsframework durch Erweitern der UiApplication 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 Anwendungskonstruktor 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 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 BrowserFieldConfig Klasse BrowserFieldConfig myBrowserFieldConfig new BrowserFieldConfig Rufen Sie im Bildschirmkonstruktor BrowserFieldConfig setProperty auf um eine Eigenschaft von BrowserField festzulegen Der erste Parameter in setProperty legt die Eigenschaft und der zweite Parameter den Wert der Eigenschaft fest Zum Beispiel legt das folgende Codebeispiel die NAVIGATION_MODE Eigenschaft eines BrowserField Objekts fest Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzei
66. String args CreateSubmenu theApp new CreateSubmenu theApp enterEventDispatcher public CreateSubmenu pushScreen new CreateSubmenuScreen 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 ein Textfeld zum Bildschirm hinzuzuf gen class CreateSubmenuScreen extends MainScreen public CreateSubmenuScreen setlitle Create Submenu Sample 133 Entwicklungshandbuch Untermen s add new RichTextField Create a submenu 4 Erstellen Sie mithilfe der MenuI tem Klasse die Elemente des Untermen s berschreiben Sie f r jedes Element im Untermen run 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 auf private Menultem _statusl new Menultem Available 100 1 public void run Dialog inform I m available NE private Menultem _status2 new Menultem Unavailable 200 2 public void run Dialog inform I m unavailable s 5 Uberschreiben Sie makeMenu um das Men f r die Anwendung zu erstellen Erstellen Sie das Untermen mithilfe der SubMenu Klasse Rufen Sie add auf um dem Untermen die Elemente des Untermen s hinzuzuf gen Rufen Sie super makeMenu auf um das Men
67. TA_FIELD_CONTACTS_PHONE_HOME e DATA_FIELD_CONTACTS_PHONE_HOME2 e DATA_FIELD_CONTACTS_PHONE_MOBILE e DATA_FIELD_CONTACTS_PHONE_OTHER e DATA_FIELD_CONTACTS_PHONE_WORK e DATA_FIELD_CONTACTS_ PHONE_WORK2 e DATA_FIELD_CONTACTS_PIN DATA_SOURCE_MEMOS e DATA_FIELD_ MEMOS TITLE DATA_SOURCE_MESSAGES e DATA_FIELD_MESSAGES_ALL e DATA_FIELD_MESSAGES_RECIPIENT e DATA_FIELD_MESSAGES_SENDER e DATA_FIELD_MESSAGES_SUBJECT DATA_SOURCE_MUSIC e DATA_FIELD_MUSIC_ALL e DATA _FIELD_MUSIC_ALBUM e DATA _FIELD_MUSIC_ARTIST e DATA_FIELD_MUSIC_GENRE e DATA_FIELD_MUSIC_PLAYLIST e DATA _FIELD_MUSIC_SONG DATA_SOURCE_PICTURES e DATA_FIELD_PICTURES_TITLE DATA_SOURCE_RINGTONES DATA_FIELD_RINGTONES_TITLE DATA_SOURCE_TASKS e DATA_FIELD_TASKS_TITLE DATA_SOURCE_VIDEOS e DATA_FIELD_VIDEOS TITLE DATA_SOURCE_VOICENOTES e DATA_FIELD_VOICENOTES_TITLE Drehfelder 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 oder den Wochentag zu ndern BlackBerry Ger it Touch Aktion BlackBerry Ger te nur mit Trackpad SckBeuny Gerate le Touchsereenlund Trackpad Ein Element in der Liste Fahren Sie mit einem Finger senkrecht e Ziehen Sie einen Finger senkrecht finden ber das Trackpad ber den Bildschirm e F hren Sie den Finger auf dem Bildschirm nach oben oder nach unten
68. Trackpad ber den Bildschirm e F hren Sie den Finger auf dem Bildschirm nach oben oder nach unten e Fahren Sie mit einem Finger senkrecht Uber das Trackpad Ein Element in der Liste Fahren Sie mit einem Finger senkrecht e Ber hren Sie das Element leicht markieren ber das Trackpad e Fahren Sie mit einem Finger senkrecht ber das Trackpad Ein Element in der Liste e Klicken mit dem Trackpad e Tippen auf das Element ffnen e Dr cken Sie die Eingabetaste e Klicken mit dem Trackpad e Dr cken Sie die Eingabetaste Bew hrtes Verfahren Implementieren von Listen und Tabellen e Verwenden Sie die SimpleList Klasse um eine Liste mit Text zu erstellen Verwenden Sie die RichList Klasse um eine schreibgesch tzte Liste mit Text und Symbolen zu erstellen Verwenden Sie die TableView Klasse um eine interaktive erweiterte Liste mit Text und Symbolen zu erstellen e Verwenden Sie die TableView Klasse um eine Tabelle mit Zeilen und Spalten zu erstellen Sie k nnen die GridFieldManager Klasse verwenden wenn Sie mit einer festen Anzahl von Zeilen und Spalten arbeiten e Wenn die Liste lang ist und Sie die Elemente auf separaten Bildschirmen anzeigen m chten stellen Sie unten auf dem Bildschirm die Schaltfl chen Weiter und Zur ck bereit Wenn die Liste sehr lang ist z B Tausende von Elementen sollten Sie stattdessen Bildschirmnummern bereitstellen 79 Entwicklungshandbuch Listen und Tabellen Wenn Sie erwarten das
69. UNG 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 GESETZLICH ZUL SSIGEN UMFANG WERDEN S MTLICHE KONKLUDENTEN GEW HRLEISTUNGEN ODER BEDINGUNGEN IM ZUSAMMENHANG MIT DER 159 Entwicklungshandbuch Rechtliche Hinweise DOKUMENTATION DIE EINGESCHRANKT WERDEN KONNEN SOFERN SIE NICHT WIE OBEN DARGELEGT AUSGESCHLOSSEN WERDEN KONNEN HIERMIT AUF 90 TAGE AB DATUM DES ERWERBS DER DOKUMENTATION ODER DES ARTIKELS AUF DEN SICH DIE FORDERUNG BEZIEHT BESCHRANKT IN DEM DURCH DAS IN IHREM RECHTSGEBIET ANWENDBARE GESETZ MAXIMAL ZULASSIGEN 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 EINSPARUNGE
70. ager Klasse EyelidFieldManager manager new EyelidFieldManager 6 Rufen Sie im Bildschirmkonstruktor EyelidFieldManager addTop auf um dem obersten Manager des EyelidFieldManager ein LabelField Objekt hinzuzuf gen manager addTop new LabelField Hello World 7 Erstellen Sie im Bildschirmkonstruktor ein HorizontalFieldManager Objekt Rufen Sie HorizontalFieldManager add auf um dem HorizontalFieldManager Schaltfl chen hinzuzuf gen Rufen Sie EyelidFieldManager addBottom auf um denHorizontalFieldManager zum untersten Manager des EyelidFieldManager hinzuzuf gen 49 Entwicklungshandbuch 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 Rufen Sie im Bildschirmkonstruktor EyelidFieldManager setEyelidDisplayTime auf um den Zeitraum der Inaktivit t in Millisekunden festzulegen der vergehen muss bevor das Manager Paar ausgeblendet wird manager setEyelidDisplayTime 3000 Rufen Sie im Bildschirmkonstruktor add auf um dem Bildschirm EyelidFieldManager hinzuzuf gen add manager Codebeispiel Vor bergehendes Anzeigen eines ButtonField und eines LabelField oben bzw unten am Bildschirm import net rim device api system import net rim device api ui import net rim device api ui component import net rim device
71. ahrscheinlichsten anklicken Vermeiden Sie die Verwendung einer Schaltfl che die mit einer beendenden Aktion verkn pft ist als Standardschaltfl che Ausnahmen zu dieser Regel sind die F lle bei denen Benutzer eine Aktion ausl sen die nur eine geringf gig destruktive Auswirkung haben wie z B das 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 chen in einem Dialogfeld Wenn Sie mehr als drei ben tigen sollten Sie statt den Optionsfeldern einen Anwendungsbildschirm verwenden e Stellen Sie auf BlackBerry Ger ten mit einer physischen Tastatur 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 zeigt ein Auslassungspunkt an dass der Text abgeschnitten ist 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 erforderli
72. ain eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen Rufen Sie im Anwendungskonstruktor 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 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 der ObjectChoiceField 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 das Standardelement an Im folgenden Codebeispiel wird standardm ig Wednesday Mittw
73. api ui container import net rim device api ui extension container public class EyelidFieldManagerDemo extends UiApplication public static void main String args 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 HorizontalFieldManager Field FIELD_HCENTER Field USE_ALL_WIDTH 50 buttonPanel add new ButtonField Button 1 buttonPanel add new ButtonField Button 2 manager addBottom buttonPanel manager setEyelidDisplayTime 3000 add manager Entwicklungshandbuch Anzeigen eines Felds an einer absoluten Position auf dem Bildschirm Anzeigen eines Felds an einer absoluten Position auf dem Bildschirm Sie k nnen die AbsoluteFieldManager Klasse verwenden um basierend auf den XY Koordinaten eine absolute Feldposition im Gegensatz zu einer Position die relativ zu anderen Feldern ist auf dem Bildschirm festzulegen Sie k nnen die AbsoluteFieldManager Klasse verwenden um auf dem Bildschirm die Platzierung und das berlappen von Feldern zu steuern Anzeigeneiner Bezeichnung an einer absoluten Position auf de
74. api ui image Importe net c medeviicemapnzuenles import java util 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene My PopUpMenuScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class MyPopUpMenuApp extends UiApplication public static void main String args Mypop upMenuApp theApp new Mypop upMenuApp theApp enterEventDispatcher ee Mypop upMenuApp i pushScreen new Mypop upMenuScreen 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 MyPopUpMenuScreen extends MainScreen EmailAddressEditField emailAddress public Mypop upMenuScreen setTitle Pop Up Menu Demo 4 Legen Sie im Bildschirmkonstruktor einen Lieferanten f r das Kontextmen fest bergeben Sie ein DefaultContextMenuProvider Objekt an Screen setContextMenuProvider um auf Ihrem Bildschirm die Anzeige eines Popup Men s zu erm glichen setContextMenuProvider new DefaultContextMenuProvider 5 Erstellen Sie
75. arte e _ Sortieren Suchen Finden und Filtern von Elementen auf unterschiedliche Weisen zum Beispiel das Filtern von Nachrichten nach Absender oder Betreff e ndern von Ansichten zum Beispiel die Tages Wochen oder Tagesordnungsansicht in einem Kalender Aktion Ein Untermen f r einen Men eintrag anzeigen der im vollst ndigen Men markiert ist Men eintrag aus einem Untermen ausw hlen Untermen schlie en Untermen und vollst ndiges Men schlie en BlackBerry Ger te nur mit Trackpad e Klicken mit dem Trackpad e Bewegen Sie einen Finger nach rechts ber das Trackpad e Dr cken Sie die Taste Men e Dr cken Sie die Eingabetaste e Klicken mit dem Trackpad e Dr cken Sie die Taste Men e Dr cken Sie die Eingabetaste e Bewegen Sie einen Finger nach links ber das Trackpad e Dr cken der Esc Taste Dr cken Sie zweimal die ESC Taste BlackBerry Ger te mit Touchscreen und Trackpad Tippen Sie auf den Men eintrag Klicken mit dem Trackpad Bewegen Sie einen Finger nach rechts ber das Trackpad Dr cken Sie die Taste Men Dr cken Sie die Eingabetaste Tippen Sie auf den Men eintrag Klicken mit dem Trackpad Dr cken Sie die Taste Men Dr cken Sie die Eingabetaste Tippen Sie auf eine Position au erhalb des Untermen s Bewegen Sie einen Finger nach links ber das Trackpad Dr cken der Esc Taste Tippen Sie zweimal auf eine Position au erhalb des vollst ndige
76. ccccccsssscceesssceecessseceesseeeecesseeeeessaseesenaees 132 Erstellen eines Untermen s un 00n ee en en se ne nennen Codebeispiel Erstellen eines Untermen s POPUP MENUS sieriem ee A soysugothiacacsavaupicadaadestyede iaudvacueusetsdeaadsabaupetbiabansavacyecadestestiadecseseaceeteenesk Bew hrtes Verfahren Implementieren von POPUP MENUG ccccccessccccccessseccecessseececeeseeeeeeessseeeeeesaaes 136 Info ber das Einf gen von Elementen in Popup Men s Unterst tzung f r ltere KONtextMensS cccccccccsscccceessceceeesssseeeecssteeeees Erstellen eines Popup Men s uuueeesssssssennnensssnnnnnennnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnnnonnnsnnnnnnnnnnonnnsnnssssnnnnnnnnnnnnnnnnn Hinzuf gen eines Men eintrags zu einer BlackBerry Device SOftWare cccccsscccccsssscececessseececessseececessaeeeees 143 Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software ANWendUN cccccccceeeeeseees 144 ndern der Darstellung eines M NiS c cccccccccccscccscescescsecsccscssseeseesecsecsessuseusecesssuseuseuessuseusausesseseuseusensessess 145 ndern der Darstellung eines M ns c cccccccscccesccscescsscscsscsesesescssseeseuseceesseseusecessuseusesseseuseeseseeseusestensess 145 Codebeispiel ndern der Darstellung eines Men s uunnenenesnnnennensnnennnnnnnnnnnnnnnnennnnnennnnnnnnennennennennnnn 147 17 Benutzerdetinierte Schrift rtens aren een nenne ae 149 Installieren und Verwenden einer ben
77. ch f gen Sie weitere Beschreibungen anderswo auf dem Bildschirm hinzu zum Beispiel in einer Anwendungsnachricht e Vermeiden Sie die Verwendung von Symbolen oder Grafiken in Bezeichnungen e Vermeiden Sie Interpunktion in Bezeichnungen Verwenden Sie in der Bezeichnung einer Schaltfl che Auslassungspunkte um anzuzeigen dass zus tzliche Informationen erforderlich sind bevor die verkn pfte Aktion ausgef hrt werden kann 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 ungiltiger 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 API 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 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 72 Entwicklungshandbuch Dropdown Listen Aktion BlackBerry Ger
78. chirm 25 Entwicklungshandbuch Reagieren auf Touchscreen Ereignisse Ger te die leichte Klick Interaktionen Benutzeraktion N Ger te mit einem SurePress Touchscreen unterst tzen Antippen des TouchEvent DOWN TouchEvent DOWN Siebens TouchGesture TAP TouchGesture TAP TouchEvent CLICK TouchEvent UP TouchEvent UNCLICK TouchEvent UP Sie k nnen bestimmen ob ein Ger t mit einem Touchscreen leichte Klick Interaktionen unterst tzt indem Sie DeviceCapability isTouchClickSupported aufrufen Wenn das Ger t leichte Klick Interaktionen unterst tzt gibt die Methode false zur ck Wenn das Ger t ber einen SurePress Touchscreen verf gt gibt die Methode true zur ck 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 auszuw hlen Wenn Sie mithilfe einer lteren Version als Version 4 7 der 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 Legen Sie in der JAD Datei f r die Option RIM TouchCompatibilityMode false fest Wenn Sie BlackBerry JDE Version 4 7
79. chnittstellen import net rim device api ui UiApplication import net rim device api ui container MainScreen import net rim device api ui component AutoCompleteField 1MPOME MEL riM AdevaGevapieGOLVEGE On Uita lens 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren 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 106 Entwicklungshandbuch Suche AutoCompleteFieldApp pushScreen new HomeScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class HomeScreen extends MainScreen public HomeScreen 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
80. creen unterst tzt Pinch Gesten vergr ern und verkleinern in der Regel Objekte auf dem Bildschirm Ein Pinch beginnt wenn zwei Ber hrungspunkte auf dem Touchscreen erkannt werden Der Kernpunkt eines Pinch wird als Mittelpunkt zwischen den beiden anf nglichen Ber hrungspunkten definiert e Wenn zwei Ber hrungspunkte erkannt werden tritt ein TouchGesture PINCH_ BEGIN Ereignis auf Die Koordinatenpunkte des Kernpunkts der Pinch Geste werden als TouchEvent getX 1 und TouchEvent getY 1 gespeichert Sie k nnen auf den anf nglichen Vergr erungsfaktor zugreifen indem Sie TouchGesture getPinchMagnitude aufrufen e Wenn der Benutzer einen oder beide Ber hrungspunkte verschiebt tritt eine Reihe von TouchGesture PINCH_UPDATE Ereignissen auf Sie k nnen auf die Vergr erungsfaktoren w hrend der Pinch Ausf hrung zugreifen indem Sie TouchGesture getPinchMagnitude aufrufen e Wenn der Benutzer die Geste abschlie t tritt ein TouchGesture PINCH_END Ereignis auf Sie k nnen auf den endg ltigen Vergr erungsfaktor zugreifen indem Sie TouchGesture getPinchMagnitude aufrufen Codebeispiel Abrufen von Informationen zu einer Pinch Geste Dieses Beispiel veranschaulicht wie Pinch Gesten in der touchEvent Methode eines Bildschirms verarbeitet werden protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent
81. d im Bildschirmkonstruktor 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 Felder l schen oder die Eigenschaften des Rasters ndern Codebeispiel Erstellen eines Raster Layouts Ws 2 GridFieldManagerDemo java Research In Motion Limited proprietary and confidential Copyright Research In Motion Limited 2009 import net rim device api ui import net rim device api ui component import net rim device api ui container public class GridFieldManagerDemo extends UiApplication cla public static void main String args GridFieldManagerDemo theApp new GridFieldManagerDemo theApp enterEventDispatcher GridFieldManagerDemo ss GridScreen extends MainScreen pushScreen new GridScreen 47 Entwicklungshandbuch Anzeigen von Feldern in einem Paar tempor rer Manager public GridScreen setTitle 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 grid add new LabelField five srid setColumnPadding 20 grid setRowPadding 20 add grid The grid looks like this one two three four five insert a cell first row second co
82. d 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 die net rim device api ui DrawStyle Schnittstelle Erweitern Sie die Field Klasse oder eine ihrer Unterklassen durch Implementieren der DrawStyle Schnittstelle 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 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 String label this label RECTANGLE 0 public CustomButtonField String label int shape this label shape 0 58 Entwicklungshandbuch Erstellen eines benutzerdefinierten Feldes public CustomButtonField String label long style this label RECTANGLE style public CustomButtonField String label int shape long s
83. dOnlyCommandMetadata metadata Object context Dialog alert Executing command for context toString Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Sie k nnen einer BlackBerry Device Software Anwendung einen Men eintrag mithilfe des APIs f r Men eintr ge imnet rim blackberry api menuitem Paket hinzuf gen Zum Beispiel k nnen Sie einen Men eintrag namens View Sales Order zur Kontaktanwendung auf einem BlackBerry hinzuf gen sodass eine CRM Anwendung mit einer Liste von Vertriebsauftr gen f r den Kontakt ge ffnet und angezeigt wird sobald ein Benutzer auf den Men eintrag klickt Die ApplicationMenultemRepository Klasse stellt die Konstanten bereit die die BlackBerry Device Software Anwendung festlegen in der Ihr Men eintrag angezeigt werden soll Die MENUITEM_MESSAGE_LIST Konstante gibt zum Beispiel an dass der Men eintrag in der Nachrichtenanwendung angezeigt werden soll 143 Entwicklungshandbuch Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software Hinzuf gen eines Menieintrags 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 berschreiben SiedenApplicationMenu
84. dardkomponenten verwenden sind diese Men eintr ge automatisch enthalten Richtlinien f r Bezeichnungen e 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 e Verwenden Sie Verben f r Bezeichnungen e Verwenden Sie die bliche Gro Kleinschreibung f r Bezeichnungen e 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 e Vermeiden Sie in Bezeichnungen die Verwendung von Symbolen wie z B Sternchen Untermen s Ein Untermen besteht aus einer Gruppe von verwandten Men eintr gen die als Teilmenge eines im vollst ndigen Men vorhandenen Men eintrags angezeigt werden Wenn Sie Elemente in ein Untermen aufnehmen k nnen Benutzer h ufig verwendete oder wichtige Elemente problemloser im vollst ndigen Men finden Untermen s enthalten in der Regel die folgenden Arten von Aktionen 130 Entwicklungshandbuch Untermen s e Senden von Elementen auf verschiedenen Wegen zum Beispiel das Versenden eines Bilds in einer E Mail Nachricht einer MMS Nachricht oder als Audiopostk
85. dd myBrowserField 6 Rufen SieBrowserField requestContent im Bildschirmkonstruktor auf um den Ort der Ressource in Ihrer Anwendung festzulegen und den HTML Inhalt anzuzeigen myBrowserField requestContent local test html Anmerkung Die BrowserField Klasse greift nicht mithilfe einer Ordnerstruktur auf Ressourcen zu Die BrowserField Klasse zeigt die erste gefundene Ressource an 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 65 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen BrowserField myBrowserField new BrowserField add myBrowserField myBrowserField requestContent local test html Konfigurieren eines Browserfeldes 1 66 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 Erstellen
86. diese Methode verwenden m ssen Sie keine Metadaten f r den Befehl definieren Zu den zentralen Benutzeroberfl chenkomponenten f r BlackBerry Ger teanwendungen die Befehle unterst tzen geh ren Men eintr ge Schaltfl chen Popup Men eintr ge und Werkzeugleisten 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api command import net rim device api ui import net rim device api ui container 2 Erstellen Sie eine Befehlsverarbeitung indem Sie eine Klasse erstellen die die abstrakte CommandHandler Klasse erweitert Definieren Sie in execute die Funktionalit t die Sie mit der Benutzeroberfl chenkomponente verkn pfen m chten Um festzulegen ob ein Befehl f r ein bestimmtes Kontextobjekt ausf hrbar ist k nnen Sie eine canExecute Methode in Ihrer Befehlsverarbeitung implementieren Wenn Sie canExecute nicht implementieren ist Ihr Befehl immer ausf hrbar this command is always executable class DialogCommandHandler extends CommandHandler public void execute ReadOnlyCommandMetadata metadata Object context Dialog alert Executing command for context toString 3 Erstellen Sie die Benutzeroberflachenkomponente Menultem myItem new Menultem new StringProvider My Menu Item 0x230000 0 4 Bei einem Men eintrag oder einer Schaltfl che k nnen Sie optional den Kontext f r den Befehl mithilfe der setCommandContext Methode der Benutzeroberfl
87. ds Thread private boolean _paused private boolean _stop public void run perform the task here and update the model s value as appropriate oe synchronized void setPaused boolean paused pause the indicator here Se synchronized void stopThread stop the indicator here Erstellen Sie eine Klasse in der die ProgressIndicatorListener Schnittstelle implementiert ist die bez glich nderungen am Datenmodell benachrichtigt werden soll Sie k nnen benachrichtigt werden wenn das Modell zur ckgesetzt wieder aufgenommen sowie abgebrochen wird oder wenn der Wert des Modells auf einem nicht programmgesteuerten Weg ge ndert wird private final class DemoProgressIndicatorListener implements ProgressIndicatorListener public void cancelled _progressThread setPaused true Entwicklungshandbuch Aktivitats und Fortschrittsanzeigen public void resumed _progressThread setPaused false 8 Verkn pfen Sie den Listener mit dem Modell model addListener new DemoProgressIndicatorListener 9 Legen Sie die Bezeichnung f r die Ansicht fest Die Bezeichnung wird ber dem ausgegebenen ProgressIndicatorField angezeigt vorausgesetzt es wird der Standardmanager VerticalFieldManager verwendet view setLabel Percent completion 10 Erstellen Sie das Feld das den Fortschritt ausgibt Sie k nnen Stile bereitstellen die im ProgressBarField definiert werden um festzulegen ob und wie Text auf der Leiste ang
88. dschirm e Codebeispiel Anzeigen einer Bezeichnung an einer absoluten Bildschirmposition Benutzerobertl chen Komponenten un za ein a a ai aiar reai aei Eiri Hinzuf gen einer Benutzeroberflachenkomponente zu einem BildSCHIFM cccccccceeseccceessseeceesssseeecessaeeees Ausrichten eines Feldes an einer Textzeile Schaltfl che Masisisi aa e a a A a a a EE EADE EEG Bew hrtes Verfahren Implementieren von Schaltflachen cccccccccccsssssccccssssseeeccessseeeceessseeeeeessaaees Erstellen einer Schaltfl che sssss0000snnsenesnnnnennnnnnnnnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnn KOMTFONKAStCME swiss scccsscsaxscsncedessdadaxsacdie cavedavasadenasedes duavassadasstesaddasua veces sagaadesdesduactee E E Bew hrtes Verfahren Implementieren von KontrollkastcChen ccccccccccesssccecssseceessseececssseeceessseeeeesaas Erstellen eines KONtrollkastChens ssseseessseseseseseeeeceeseecececececececececeecceecceccceeeceeceeeceeeeneueueeeaeeenaenananaaea 56 Estelle meinen BlMApss under tut scstva casa a a ea aaa a a a aAa aE aa Eae RERA CA E EEEa EEEE chacsaneanee 58 Erstellen eines benutzerdefinierten Feldes 58 Erstellen eines Felds um Webinhalte anZUZeigen cccccssccccccscsssssseeeecccecseessseeeeecceeseseseeeeeecesseeeesaseeeeeeess 61 Anzeigen von HTML Inhalten in einem Browserfeld ccccccccesssccce
89. dschirm 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 einen Men eintrag zu dem Men hinzuzuf gen das MainScreen erstellt class ListFieldScreen extends MainScreen private Liscriete lisicrieels private Vector _listElements public ListFieldScreen setTitle List Field Sample Entwicklungshandbuch Listen und Tabellen 4 Erstellen Sie im Bildschirmkonstruktor das Listenfeld Erstellen Sie ein Array f r die Elemente die Sie dem Listenfeld mithilfe der Vector 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 mE SupilekdmsetGalilibackG ealibacks add _listField initializeList 5 Erstellen Sie eine Methode um 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 initializeList String itemOne List item
90. dschirmkonstruktor dem Drehfeld Manager die Drehfelder 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 113 Entwicklungshandbuch Drehfelder 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 January February s Were Aor Ve Une July PATEE Seo tember October November December spinBoxMgr new SpinBoxFieldManager spinBoxDays new TextSpinBoxField DAYS spinBoxMonths new TextSpinBoxField MONTHS spinBoxMgr add spinBoxDays spinBoxMgr add spinBoxMonths add spinBoxMgr public
91. durch Aufrufen von registerCommand CommandMetadata registrieren Andernfalls wird der registrierte CommandHandler verwendet b Wenn Ihr Befehl in beliebigen Anwendungen verf gbar sein soll verwenden Sie ein RemoteCommandRegistrarConnection Objekt Die globale Registry steht allen Prozessen zur Verf gung die auf dem Ger t ausgef hrt werden RemoteCommandRegistrarConnection connection new RemoteCommandRegistrarConnection connection registerCommand new ViewContactCommand metadata 7 Rufen Sie den Befehl von einer beliebigen Position in Ihrer Anwendung bei lokalen Befehlen oder von einer beliebigen Anwendung auf dem Ger t bei globalen Befehlen auf und verwenden Sie ihn a Erstellen Sie ein CommandRequest Objekt und f llen Sie es mit Informationen zu dem Befehl den Sie aus der Registry abrufen m chten CommandRequest request new CommandRequest String myCommandCategories app contacts action view request setCommandCategories new CategoryCollection myCommandCategories b Rufen Sie den Befehl aus der Registry ab 41 Entwicklungshandbuch Verwenden eines Befehl in mindestens einer Anwendung using the local registry LocalCommandRegistrarConnection connection new LocalCommandRegistrarConnection Command command connection getCommand request using the global registry RemoteCommandRegistrarConnection connection new RemoteCommandRegistrarConnection Command command connection ge
92. e return false Reagieren auf einen Benutzer der auf den Bildschirm klickt 1 Importieren Sie die folgenden Klassen 30 net net net net net rim device rim device rim device rim device rim device api api api api api ui ud ud ui ui TouchEvent Field Manager Screen component Dialog Entwicklungshandbuch Reagieren auf Touchscreen Ereignisse 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 ButtonField Rufen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf Pr fen Sie ob der Wert den TouchEvent getEvent zur ckgibt gleich TouchEvent CLICK ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent CLICK Diialloermalena le eEkzocealngedi Pewrurmn Erue return false Reagieren auf einen Benutzer der den Bildschirm zweimal schnell 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 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 cla
93. e 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 e Verwenden Sie kurze klare Bezeichnungen berpr fen Sie ob die Bezeichnung deutlich beschreibt was geschieht wenn Benutzer das Kontrollk stchen aktivieren e Verwenden Sie nach M glichkeit positive Bezeichnungen Wenn beispielsweise Benutzer die Option zum Aktivieren oder Deaktivieren einer Funktion haben verwenden Sie in der Bezeichnung Aktivieren statt Deaktivieren e Platzieren Sie die Bezeichnungen auf der rechten Seite der Kontrollk stchen Bei Optionen platzieren Sie die Bezeichnungen auf der linken Seite von Kontrollk stchen e Verwenden Sie die bliche Gro Kleinschreibung f r S tze e _ Interpunktieren Sie Bezeichnungen f r Kontrollk stchen mit einem Doppelpunkt Erstellen eines Kontrollk stchens 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 Erstellen Sie in main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um der Anwendung das Empfangen von Ereignissen zu erm glichen
94. e Setup at any time by selecting the Setup icon Don t show again Close Cancel n _ u u How To UNGHEIEEE Tips amp Tricks Glossary Richtlinien f r Nachrichten 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 Verwenden Sie nach M glichkeit f r Nachrichten vollst ndige S tze Verwenden Sie den Wortschatz 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 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 Verwenden Sie bei der Ansprache der Benutzer die zweite Person Sie Ihr Verwenden Sie die bliche Gro Kleinschreibung f r S tze Vermeiden Sie in Nachrichten die Verwendung von Ausrufezeichen 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 71 Entwicklungshandbuch Dropdown Listen e Verwenden Sie f r die Standardschaltfl che jene Schaltfl che die Benutzer am w
95. e 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 Touchscreen Ereignisse 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 device rim device rim device rim device rim device rim device api api api api api api ui Pa ui a ui ui TouchEvent TouchGesture Field Manager Screen 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 ButtonField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf 4 Pr fen Sie ob der Wert den TouchGesture getSwipeDirection zur ckgibt 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 return tru
96. e from a four way navigation input device return super navigationClick status time Weitere Informationen zur Statusmodifizierung f r die net rim device api system KeypadListener Klasse finden Sie in der API Referenz f r die BlackBerry Java Development Environment 24 Entwicklungshandbuch Modelle f r Touchscreen Interaktionen Modelle f r Touchscreen Interaktionen BlackBerry Ger te mit Touchscreen und Trackpad verwenden ein Modell mit ganz leichten Klick Interaktionen bei dem der BlackBerry Ger tebenutzer den Bildschirm antippt oder das Trackpad verwendet um eine Aktion auszuf hren Dieses Modell weicht von vorherigen BlackBerry Ger ten mit einem SurePress Touchscreen ab bei denen der Benutzer auf den Bildschirm klickt dr ckt um eine Aktion auszuf hren Bei beiden Ger tearten tritt ein TouchEvent DOWN Ereignis auf wenn der Benutzer den Bildschirm ber hrt Bei Ger ten mit einem SurePress Touchscreen tritt ein TouchEvent CLICK Ereignis auf wenn der Benutzer Druck anwendet und auf den Bildschirm klickt Wenn der Druck verringert wird tritt ein TouchEvent UNCLICK Ereignis auf In der Regel treten bei einem TouchEvent UNCLICK Ereignis Aktionen wie z B das auf einer Schaltfl che basierende Aufrufen einer Aktion ein Wenn der Benutzer den Bildschirm komplett losl sst tritt ein TouchEvent UP Ereignis auf Auf Ger ten mit einem Touchscreen der leichte Klick Interaktionen unterst tzt gibt es
97. e wieder das Dialogfeld an Richtlinien f r das Layout 70 Zentrieren Sie das Dialogfeld auf dem Bildschirm Wenn Sie Standardkomponenten verwenden zentriert das BlackBerry Ger t automatisch das Dialogfeld Erstellen Sie Dialogfelder die maximal 90 der Bildschirmbreite und h he einnehmen Wenn Sie Standardkomponenten verwenden berechnet das BlackBerry Ger t automatisch die entsprechende Gr e der Dialogfelder Zentrieren Sie die Dialogfeldanzeige senkrecht zur Dialogfeldnachricht Entwicklungshandbuch Dialogfelder Zeigen Sie Meldungen rechts von der Anzeige und oberhalb der Schaltfl chen f r die meisten Sprachen an Platzieren Sie Schaltfl chen f r Best tigungsaktionen zuerst Platzieren Sie beispielsweise Speichern vor Verwerfen oder Abbrechen Zentrieren Sie Schaltfl chen in Dialogfeldern horizontal Platzieren Sie Schaltfl chen senkrecht in dem Dialogfeld Das senkrechte Layout erm glicht die Erweiterung von Schaltfl chen um lokalisierte Schaltfl chenbezeichnungen anzupassen Wenn Sie ein Kontrollk stchen verwenden passen Sie die Ausrichtung des Kontrollk stchens an die Ausrichtung der Dialogfeldmeldung an Platzieren Sie das Kontrollk stchen ber den Schaltfl chen Das Kontrollk stchen sollte standardm ig aktiviert sein es sei denn das Dialogfeld zeigt eine Meldung mit kritischen Informationen f r Benutzer an Setup 3G Fz Tanl customize You are about to exit Setup You can continu
98. eApp enterEventDispatcher public CreateCustomMenu i pushScreen new CreateCustomMenuScreen ur CreateCustomMenuScreen extends MainScreen Border _menuBorder 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 SISTGHIISITEEEB UERESO E try FontFamily family FontFamily forName BBCasual _menuFont family getFont Font PLAIN 30 Ui UNITS px catch final ClassNotFoundException cnfe UiApplication getUiApplication invokeLater new Runnable public void run Dialog alert FontFamily forName threw cnfe toString HO protected void makeMenu Menu menu int context menu setBorder _menuBorder menu setBackground _menuBackground menu setFont _menuFont 147 Entwicklungshandbuch ndern der Darstellung eines Men s super makeMenu menu context 148 Entwicklungshandbuch Benutzerdefinierte Schriftarten Benutzerdefinierte Schriftarten ye Die FontManager Klasse im net rim device api ui Paket stellt Konstanten und Methoden bereit die Sie verwenden k nnen um eine TrueType Schriftart auf einem BlackBerry Ger t zu installieren und zu deinstallieren Die maximale Gr e
99. ePickScreen extends MainScreen public DatePickScreen setTitle Date Picker Sample add new RichTextField Trying Date Picker UiApplication getUiApplication invokeLater new Runnable public void run yD 5 RufenSieinrun DateTimePicker getInstance auf umein DateTimePicker Objekt zur ckzugeben Rufen Sie doModal auf um die Datumsauswahl anzuzeigen Rufen Sie getDateTime 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 setTitle Date Picker Sample add new RichTextField Trying Date Picker UiApplication getUiApplication invokeLater new Runnable public void run DateTimePicker datePicker DateTimePicker getInstance 97 Entwicklungshandbuch datePicker doModal Calendar cal datePicker getDateTime Date date cal getTime Dalallogzalleisa Yoleseleetede Eda CentOS Emine ODE DE Codebeispiel Erstellen einer Datumsauswahl impone enetan Pe CA OS perl es import net rim device api ui picker import net rim device api ui component import net rim device api ui container import net rim device api database import net rim device api io
100. echtecks 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 Rufen Sie Graphics 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 Graphics 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 0 graphics fillRect 10 10 30 30 graphics drawRect 15 15 30 30 graphics popContext graphics drawRect 15 15 30 30 Entwicklungshandbuch Erstellen eines Bildschirm bergangs graphics pushContext rectangle 0 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 aktuell
101. eeeecsssseececessssseeeceesesesees Codieren eines Bilds H ca ss erento E a E AAEN Anzeigenieines codiertenBilds 0 0 ne iea deaa EEEa Festlegen der Anzeigegr e eines codierten BildS ccccccccsssccccssssceecssseeececssseeceessseeeceeseeeeeesseeeeeseaees Festlegen des Decodierungsmodus f r ein Bild Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken Codebeispiel Anzeigen eines Bilds zum Vergr ern Verkleinern und SCHWeNKEN csccccerseeeerseeeeees 123 Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken Anzeigen mehrerer Bilder zum Scroll n ccccccceeessseceececececeeesesssssseeeeeeeeeeseeeees Codebeispiel Anzeigen einer Reihe von Bildern zum SCrollen cccscssccccceeeessssseceeeeeeessesssseeeeeeeeeeeeeeaes Anzeigen mehrerer Bilder zum Scrollen 2440444444440n0snnnnnnenennnonnennnnnnennnnnnnnnnnnnnnnnsnnnnnnnnnnnnnannennan MERUBSIER IE nen E E A A a ree aes 128 Erstellen eines Men s n e u0 nes cavebeaucuuctuenavesen cuabueddieasedcevenseechuvigsaeddeabeiversdacteeati 128 Codebeispiel Erstellen eines Men sza unse andene oxeevanSeeiecaddseccssscectnana 129 Bew hrtes Verfahren Implementieren von MeNUS ccccccccsssscccesseeceecsssecccessseececcaseeeeesseeesesssseeesesaeeeens 130 Untermen sae runs e ee nase rer fer nisnl re teilen ihnen 130 Bew hrtes Verfahren Implementieren von UnterMentsS cc
102. efinierten Bildschirm dar public class FilePick extends UiApplication public static void main String args FilePick theApp new FilePick theApp enterEventDispatcher public FilePick pushScreen new FilePickScreen J 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 seilitle File Picker samole add new LabelField Trying File Picker 4 Rufen Sie im Bildschirmkonstruktor invokeLater auf um der Ereigniswarteschlange der Anwendung einen Codeabschnitt hinzuzuf gen Erstellen Sie ein Runnable Objekt und bergeben Sie es als Parameter an invokeLater class FilePickScreen extends MainScreen public FilePickScreen serme le Qi piles eicketaesoampileus Er add new LabelField Trying File Picker UiApplication getUiApplication invokeLater new Runnable public void run 99 Entwicklungshandbuch Auswahltool DE 5 Uberschreiben Sie run in der Definition von Runnable Rufen Sie inrun 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 Lis
103. ein Kontrollk stchen zu erstellen das die Benutzer nicht ndern k nnen verwenden Sie den READONLY Stil add new CheckboxField First Check Box true this READONLY 6 Um die Standardfunktionalit t zu berschreiben die den Benutzer auffordert nderungen vor dem Schlie en der Anwendung zu speichern berschreiben Sie in der Erweiterung der MainScreen Klasse die Methode MainScreen onSavePrompt Im folgenden Codebeispiel wird true zur ckgegeben Dies bedeutet dass vor dem Schlie en keine Benutzeraufforderung durch die Anwendung erfolgt public boolean onSavePrompt FEU ielrUe Codebeispiel Erstellen eines Kontrollkastchens WMOORE NE FIM COWES B91 Unn 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 MyUiScreen extends MainScreen public MyUiScreen setTitle UI Component Sample add new CheckboxField First Check Box true add new CheckboxField Second Check Box false 57 Entwicklungshandbuch Erstellen einer Bitmap public boolean onSavePrompt rEcUiin wires Erstellen einer Bitmap 1 Importieren Sie die net rim device api ui component BitmapField Klasse 2 Erstellen Sie eine Instanz von BitmapField BitmapField myBitmapFiel
104. einschreibung f r Titel Schlie en Sie die Bezeichnungen von Feldern mit einem Doppelpunkt ab Wenn Sie einen Hinweistext verwenden formulieren Sie ihn kurz und klar Verwenden Sie die bliche Gro Kleinschreibung f r S tze Entwicklungshandbuch Textfelder Erstellen eines Textfelds Erstellen eines schreibgesch tzten Textfelds das eine Formatierung erm glicht 1 Importieren Sie dienet rim device api ui component RichTextField Klasse 2 Erstellen Sie eine Instanz von RichTextField RichTextField rich new RichTextField 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 e net rim device api ui component EditField 2 Erstellen Sie eine Instanz von BasicEditField BasicEditField bf new BasicEditField BasicEditField 10 EditField FILTER_UPPERCASE Erstellen eines bearbeitbaren Textfelds das Sonderzeichen erm glicht 1 Importieren Sie dienet rim device api ui component EditField Klasse 2 Erstellen Sie eine Instanz von EditField SCiUrIGhE Selitc Mew leciclrielel echitriele s OF lechitclielel TERED ERA VIETE Erstellen eines Textfelds f r AutoText Wenn ein Textfeld AutoText unterst tzt und Benutzer zweimal die Leertaste dr cken f gt das BlackBerry Gerat einen Punkt ein schreibt den n chsten Buchstaben nach einem Punkt gro und ersetzt W
105. ellen 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 13 Entwicklungshandbuch Erstellen eines Bildschirm bergangs bergang Beschreibung 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 Ubergang zeigt einen Bildschirm an oder entfernt einen Bildschirm indem simuliert wird dass dieser auf die Anzeige oder von der Anzeige am Ger t gewischt wird TRANSITION ZOOM Dieser Ubergang 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 Ubergang 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 vom unteren Bereich des Ger tebildschirms nach oben 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
106. en zu ffnen e Klicken mit dem Trackball oder Trackpad bei gleichzeitigem Dr cken der Umschalttaste um Text zu markieren oder Nachrichten in einer Nachrichtenliste zu markieren BlackBerry mit einem Trackball oder 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 physische 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 Schwe
107. en Kontext vom Kontextstapel loszul sen graphics pushRegion rectangle graphics fillRect 10 10 30 30 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 Das XYRect wird von seinem Ursprung 1 1 in einen Ursprung 20 20 konvertiert Nach der Konvertierung reicht der untere Teil des XYRec t Objekts Uber 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 angezeigt wird wenn Ihre Anwendung einen Bildschirm auf einem BlackBerry Ger t ffnet oder schlie t Mithilfe der net rim device api ui TransitionContext Klasse k nnen Sie die folgenden Arten von Bildschirm berg ngen f r Ihre Anwendung erstellen bergang Beschreibung TRANSITION FADE Dieser Ubergang zeigt einen Bildschirm an oder entfernt einen Bildschirm durch allm hliches Ein oder Ausblenden Dieser Bildschirm bergang erzeugt den visu
108. en benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class BrowserFieldDemoScreen extends MainScreen public BrowserFieldDemoScreen 4 Erstellen Sie im Bildschirmkonstruktor eine Instanz der BrowserField Klasse 63 Entwicklungshandbuch Erstellen eines Felds um Webinhalte anzuzeigen BrowserField myBrowserField new BrowserField 5 Rufen Sie add im Bildschirmkonstruktor auf um dem Bildschirm das BrowserField Objekt hinzuzuf gen add myBrowserField 6 Rufen Sie BrowserField requestContent im Bildschirmkonstruktor auf um den Ort des HTML Inhalts festzulegen und 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 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 http www blackberry com Anzeigen von HTML Inhalten aus einer Ressource in Ihr
109. en und oder werden dort als Marken verwendet Eclipse ist eine Marke der Eclipse Foundation Inc Java ist eine Marke von Oracle America 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 einbezogen 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 In
110. ends 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 Verwenden Sie Dialogfelder um die folgenden Aktionen auszuf hren Fordern Sie von den Benutzern Informationen die erforderlich sind um eine vom Benutzer eingeleitete Aufgabe abzuschlie en Teilen Sie den Benutzern dringende Informationen mit oder informieren Sie sie ber den Status wichtiger Aktionen Geben Sie an die Benutzer Warnmeldungen zu unerwarteten oder m glicherweise zerst renden Bedingungen Situationen aus 69 Entwicklungshandbuch Dialogfelder Dialogfelder sind modal sie unterbrechen den normalen Betrieb des BlackBerry Ger ts und werden im Stapel an den Anfang geschoben Ein Dialogfeld enth lt eine Nachricht Schaltfl chen anhand derer die Benutzer eine Aktion ausf hren k nnen und eine Anzeige die die Art des Dialogfelds angibt Die Gr e des Dialogfelds h ngt von der Gr e des BlackBerry Ger tebildschirms ab Die vom Benutzer auf dem BlackBerry ausgew hlte Skin bestimmt den Anzeigestil des Dialogfelds
111. enutzer einen Finger ber das Bild bewegen um den zu vergr ernden Bereich zu verschieben Um den definierten Bereich zu vergr ern klickt der Benutzer auf den Bildschirm Zum Verkleinern dr ckt der Benutzer die Esc Taste Codebeispiel Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken import net rim device api system UNIO MBE Pull Clevicee aol Ui 5 import net rim device api ui component import net rim device api ui extension container public class ZoomableImageApp extends UiApplication public static void main String args ZoomableImageApp theApp new ZoomablelmageApp theApp enterEventDispatcher public ZoomableImageApp EncodedImage myImg new EncodedImage myImg jpg ZoomScreen zoomableImg new ZoomScreen myImg pushScreen zoomablelmg Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api system Impergtsnetarn madevieerap r u import net rim device api ui component import net rim device api ui extension container 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Erstellen Sie im Konstruktor mithilfe einer Ressource im Projekt ein EncodedImage erstellen
112. enutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse Rufen Sie setTitle auf um den Text festzulegen der im Titelbereich des Bildschirms angezeigt wird Erstellen Sie ein neues LabelField Objekt Sie wenden die benutzerdefinierte Schriftart auf dieses Objekt an class FontLoadingDemoScreen extends MainScreen public FontLoadingDemoScreen setTitle Font Loading Demo 149 Entwicklungshandbuch Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java Anwendung LabelField helloWorld new LabelField Hello World 4 Rufen Sie im Bildschirmkonstruktor die FontManager getInstance Methode auf um einen Verweis auf das FontManager Objekt zu erhalten und rufen Sie anschlie end die Load Methode auf um die 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 set Font
113. er 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 unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene BrowserFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar 64 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 myBrowserField new BrowserField 5 Rufen Sie add im Bildschirmkonstruktor auf um dem Bildschirm das BrowserField Objekt hinzuzuf gen a
114. er Liste die mit dem Suchtext beginnen Weitere Informationen zur Verwendung der KeywordFilterField 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 import net rim device api ui component KeywordProvider import java io InputStream import java lang String import java util Vector 2 Erstellen Sie Variablen Im folgenden Codebeispiel erweitert CountryList die SortedReadableList Klasse und implementiert die KeywordProvider Schnittstelle private KeywordFilterField _keywordField private CountryList _CountryList private Vector _countries 3 Um eine Liste ausw hlbarer Textelemente zu erstellen f llen Sie einen Vektor mit Daten aus einer Textdatei _countries getDataFromFile 4 Erstellen Sie eine Instanz einer Klasse die die SortedReadableList Klasse erweitert _CountryList new CountryList StringComparator getInstance true countries 5 Umdie Elemente der Liste anzugeben erstellen Sie eine neue Instanz eines KeywordFilterField Objekts _keywordField new KeywordFilterField 6 Rufen Sie KeywordFilterField setList auf _keywordField setList _CountryList _CountryList 7 Legen Sie
115. er k nnen ein Textfeld zur Eingabe von Text verwenden Art des Textfelds E Mail Datum und Uhrzeit Nummer Kennwort Telefonnummer Beschreibung Zum Einf gen des Zeichens oder eines Punktes in ein E Mail Adressenfeld dr cken Benutzer die Leertaste Benutzer k nnen das Datum oder die Zeit aufBlackBerry Ger ten mit Trackpad ndern indem Sie die Tastatur verwenden oder mit einem Finger senkrecht ber das Trackpad fahren Benutzer k nnen das Datum oder die Zeit auf BlackBerry Ger ten mit Touchscreen ndern indem Sie den Finger auf dem Bildschirm nach oben oder nach unten f hren M ssen Benutzer ein Nummernfeld auf einer physischen Tastatur eingeben wechselt das BlackBerry Ger t zum Modus Zahlensperre sodass die Benutzer die Alt Taste zum Eingeben von Zahlen nicht dr cken m ssen M ssen Benutzer ein Nummernfeld auf einer virtuellen Tastatur eingeben wird die Zahlentastatur angezeigt Wenn Benutzer Text 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 Bei BlackBerry Ger ten mit SureType Technologie ist Mehrfachtippen die standardm ige Eingabemethode in Kennwortfeldern Geben Benutzer ein Feld Telefonnummer auf einer physischen Tastatur ein wechselt das BlackBerry Ger t zum Modus Zahlensperre sodass die Benutzer die Alt Taste zum Eingeben von Za
116. ertes 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 SpellCheckUIListener e net rim blackberry api spellcheck SpellCheckEngine Erstellen Sie eine Methode die die Spel1lCheckUIListener LEARNING_ACCEPT Konstante zur ckgibt wenn SpellCheckEngine ein neues Wort lernt public int wordLearned SpellCheckUI ui StringBuffer word UiApplication getUiApplication invokeLater new popUpRunner Word learned return SpellCheckUIListener LEARNING ACCEPT Erstellen Sie eine Methode die die Spel LCheckUIListener LEARNING ACCEPT Konstante zur ckgibt wenn SpellCheckEngine eine Korrektur f r ein Wort lernt public int wordCorrectionLearned SpellCheckUI ui StringBuffer word StringBuffer correction UiApplication getUiApplication invokeLater new popUpRunner Correction learned return SpellCheckUIListener LEARNING ACCEPT Erstellen Sie eine Methode die die Spel LCheckUIListener ACTION OPEN _UI Konstante zur ckgibt wenn SpellCheckEngine ein falsch buchstabiertes Wort findet public int misspelledWordFound SpellCheckUI ui Field field int offs
117. es 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 Inder Kamera wird durch Schieben eines Fingers ein Objekt herangezoomt Durch Schieben mit einem Finger nach unten wird aus dem Objekt herausgezoomt Diese Aktion f hrt eine Karte oder Webseite nach Wenn Benutzer ein Bild heranzoomen wird durch diese Aktion auch ein Bild nachgef hrt 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 Entwicklungshandbuch Trackball oder Trackpad Trackball oder Trackpad Auf BlackBerry Ger ten mit einem Trackball oder Trackpad dienen der Trackball oder das Trackpad als prim re Steuerung der Benutzernavigation Benutzer k nnen folgende Aktionen ausf hren e Drehen des Trackballs oder Bewegen eines Fingers auf dem Trackpad um den Cursor zu bewegen e Klicken mit dem Trackball oder Trackpad um Standardaktionen auszuf hren oder ein Kontextm
118. esseeeessaees 103 Erstellen eines S chfeldsiu uee ee ee en E R Eaa 104 Autocomplete Textfeld u u ne aka mn EE aK 106 Drehtelden a ae esse ee erree fe een eae ccas ea vexta sh fecsttes Has antetincettteetanatsssecs dea Te Renee Ren des erred 111 Erstellen eines Drehfelds 112 Bew hrtes Verfahren Implementieren von Drehfeldern ccccccscccccccsssseccceessseececcsssseeeeeesssseeeesssaees 114 Textfelden senensunsanaeaan aN R AA IEE a AE E EAE EAE EAE EEEa 115 10 Bew hrtes Verfahren Implementieren von Textfeldern ccccccccccssscccccessssecccessssseccceeseseceeessseeeeeessaaees 116 Erstellen eines Textfeldsccc cccssescescicsecscssverssscisscchavescassseaanasusasicnssacavdedveauanessecantdvayecassancaasdazasachaaeassesnesscuanede 117 Erstelleneines DatuMmisf ldS ciiasan aaa eaaa a e ea aE E asea 117 Erstellen eines Kennwortfelds 118 SUPUKUUPANSICNLE Maragan a a a e A E ER vewexassbaseas eadecedsasn e E ihrer 119 Bew hrtes Verfahren Implementieren von Strukturansichten cccccccccccscccccsscecsseeeesseeseseesssaeeeeneeeeeeees 119 Erstellen eines Feldes f r das Anzeigen einer Strukturansicht usseensensenenenneensnnnnennennnnnnnennennnnnennnnn 120 Bilder nn re cae ena Ne eh Verwenden von codierten Bilderiisviciicisseccscascaccoveoceccssoctccavcenceccusctencvvccnceusescacchdacteccsscechechechea nennen Zugriff auf ein codiertes Bild ber einen Eingabestream cccccscccccssssscececssse
119. et int Llen UiApplication getUiApplication invokeLater new popUpRunner Misspelled word found return SpellCheckUIListener ACTION OPEN UI 153 Entwicklungshandbuch Verwandte Ressourcen Verwandte Ressourcen 154 www blackberry com go apiref Zeigen Sie die aktuelle Version der API Referenz f r das BlackBerry Java SDK an www blackberry com go devguides Hier finden Sie Entwicklungshandb cher Versionshinweise und berblicke ber die Beispielanwendung f r das BlackBerry Java SDK www blackberry com developers Besuchen Sie die BlackBerry Developer Zone f r Ressourcen zur Entwicklung von BlackBerry Ger teanwendungen www blackberry com go developerkb Zeigen Sie Knowledge Base Artikel der BlackBerry Development Knowledge Base an www blackberry com developers downloads Hier finden Sie die aktuellen Entwicklungstools und Downloads zum Entwickeln von BlackBerry Ger teanwendungen Entwicklungshandbuch Glossar Glossar 3D Dreidimensional API Application Programming Interface Anwendungsprogrammierschnittstelle JVM Java Virtual Machine MIDP Mobile Information Device Profile Softwareprofil f r mobile Ger te 155 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 156 Entwicklungshandbuch Verlauf der Dokumentrevision Verlauf der Dokumentrevision 16
120. etContext Field field return field public Vector getItems Field field 8 Stellen Sie in getI tems die Popup Men eintr ge bereit indem Sie Instanzen der CommandI tem Klasse erstellen Geben Sie f r jedes Befehlselement den Popup Menitext das Symbol und den Befehl an Im folgenden Codebeispiel wird eine if then else Anweisung verwendet um zu pr fen welche Komponente das Popup Men vor der CommandItem Erstellung aufgerufen hat Der Befehl ist ein Proxy zu einer Klasseninstanz die die abstrakte CommandHandler Klasse erweitert die in Schritt 9 beschrieben wird Rufen Sie Vector addElement auf um die Popup Men eintr ge zum Vector hinzuzuf gen Geben Sie den Vector zur ck CommandItem defaultCmd Image myIcon ImageFactory createlmage Bitmap getBitmapresource my_logo png if field equals emailAddress defaultCmd new CommandItem new StringProvider Email Address mylcon new Command new DialogCommandHandler else defaultCmd new CommandItem new StringProvider Label Field myIcon new Command new DialogCommandHandler items addElement defaultCmd return items Erstellen Sie auf dem benutzerdefinierten Bildschirm eine Befehlsverarbeitung indem Sie eine Klasse erstellen die die abstrakte CommandHandler Klasse erweitert Definieren Sie in execute die Funktionalit t die Sie mit den Popup Men eintr gen verkn pfen m chten Diese Befehlsverarbeitung k nnte auf Ih
121. ew ein zweites Argument an Wenn Sie keinen Manager festlegen wird ein VerticalFieldManager Objekt verwendet 89 Entwicklungshandbuch Aktivit ts und Fortschrittsanzeigen 3 90 Erstellen Sie ein ProgressIndicatorController Objekt ProgressIndicatorController controller new ProgressIndicatorController Erstellen Sie ein ProgressIndicatorModel Objekt Dieses Objekt stellt den Fortschritt der Aufgabe dar Wenn Sie das Objekt erstellen k nnen Sie den Anfangswert des Modells seinen Maximalwert und seinen Mindestwert festlegen ProgressIndicatorModel verwendet ein Adjustment Objekt damit ein Threading Zugriff auf das Datenmodell m glich ist und die Aufgabe durch ganzzahlige Werte dargestellt werden kann ProgressIndicatorModel model new ProgressIndicatorModel 100 0 In diesem Beispiel startet die Aufgabe mit dem Wert 0 und kann den Wert 100 erreichen Diese Werte modellieren den Abschluss einer Aufgabe als Prozentsatz Verbinden Sie den Controller das Modell und die Ansicht model setController controller view setModel model view setController controller controller setModel model controller setView view Erstellen Sie einen Thread um die Aufgabe zu verarbeiten In der Regel werden Aufgaben die Fortschrittsanzeigen erfordern mithilfe eines Threads ausgef hrt Aktualisieren Sie im Zuge des Aufgabenfortschritts den Wert des Modells um den Fortschritt der Aufgabe widerzuspiegeln class ProgressThread exten
122. ext 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 ohne Touchscreen k nnen Benutzer auch die Tastatur verwenden um auf dem Bildschirm zu navigieren zum Beispiel zum Navigieren in einer Karte 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 Ger ten mit einem SurePress Touchscreen wird in den meisten F llen die komplette Tastatur im Querformat und die reduzierte Tastatur im Hochformat angezeigt 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 Pear Flip 8200 Series Trackball BlackBerry
123. ezeigt werden soll Standardm ig wird der Wert des Modells in der Mitte des Bereichs angezeigt der von der Leiste belegt wird view createProgressBar Field FIELD HCENTER In diesem Beispiel verwendet die Fortschrittsanzeige den Standardtextstil und sie wird zentriert im Manager der Ansicht angezeigt 11 F gen Sie Ihrem Bildschirm die Ansicht hinzu add view 12 Steuern Sie die Fortschrittsanzeige indem Sie bei Bedarf das Modell der Ansicht steuern Menultem _pauseIndicator new Menultem Pause indicator 66010 0 public void run Ie Menultem _resumeIndicator new Menultem Resume indicator 66020 0 view getModel cancel public void run view getModel resume Re Dieses Beispiel ruft die cancel Methode des Modells auf um die Fortschrittsanzeige anzuhalten Das Beispiel ruft die resume Methode des Modells auf um die Fortschrittsanzeige wieder aufzunehmen Codebeispiel public class ProgressIndicatorScreen extends MainScreen ProgressIndicatorView view new ProgressIndicatorView 91 Entwicklungshandbuch Aktivitats und Fortschrittsanzeigen 92 ProgressIndicatorModel model new ProgressIndicatorModel 0 100 0 ProgressIndicatorController controller new ProgressIndicatorController ProgressThread _progressThread public ProgressIndicatorScreen setTitle Progress Indicator Screen model setController controller model addListener new DemoPro
124. f hren Men s enthalten in der Regel Aktionen die mit einem Bildschirm verkn pft sind Benutzer k nnen ber eine Schaltfl che die folgenden Aktionen ausf hren BlackBerry Ger te mit Touchscreen und Aktion BlackBerry Ger te nur mit Trackpad Trackpad Markieren einer Mit dem Finger ber das Trackpad e Leichtes Ber hren der Schaltfl che Schaltfl che fahren e Mit dem Finger ber das Trackpad fahren Ausf hren einer Aktion Klicken mit dem Trackpad oder Dr cken e Tippen auf das Element der Eingabetaste e Klicken mit dem Trackpad e Dr cken Sie die Eingabetaste 53 Entwicklungshandbuch Schaltflachen Contacts 3G 2 Tanl sh New Contact Create a new contact Delete lan Dundas Delete Bew hrtes Verfahren Implementieren von Schaltfl chen Vermeiden Sie auf einem Anwendungsbildschirm den Einsatz von Schaltfl chen Zur Bereitstellung von Aktionen die mit einem Bildschirm verkn pft sind verwenden Sie stattdessen das Anwendungsmen AufBlackBerry Ger ten mit Trackpad steht den Benutzern das Men sofort zur Verf gung und das unabh ngig davon an welcher Position sich der Cursor auf dem Bildschirm befindet Schaltfl chen sind statisch und erfordern dass sie von den Benutzern hervorgehoben werden um die mit der Schaltfl che verkn pfte Aktion auszuf hren Wenn Sie Schaltfl chen verwenden nehmen Sie ebenfalls Men elemente f r die Aktionen im Anwendungsmen auf AufBlackBerry Ger ten mit To
125. fl chenkomponenten 1 Importieren Sie die erforderlichen Klassen und Schnittstellen net rim device api ui container HorizontalFieldManager net rim device api ui component ButtonField 2 Erstellen Sie eine Instanz von Hor izontalFieldManager HorizontalFieldManager _fieldManagerBottom new HorizontalFieldManager 3 Rufen Sie add auf um dem Bildschirm Hor izontalFieldManager hinzuzuf gen myScreen add _fieldManagerBottom 4 Erstellen Sie eine Instanz von ButtonField ButtonField mySubmitButton new ButtonField Submit 5 F gen Sie das ButtonField zuHorizontalFieldManager hinzu _fieldManagerBottom add mySubmitButton Erstellen eines Raster Layouts Anmerkung F r Informationen zum Erstellen einer Gittergr e in der BlackBerry Java Development Environment vor Version 5 0 besuchen Sie die Seite http www blackberry com knowledgecenterpublic und lesen Sie Artikel 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 44 Entwicklungshandbuch Erstellen eines Raster Layouts Der Index von Rastern beginnt bei null Deshalb befindet sich die erste Zelle bei Zeile 0 Spalte 0 In einem Gebietsschema mit einer Textrichtung von
126. forderung durch die Anwendung erfolgt public boolean onSavePrompt rerurnttnue 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 MyUi theApp new MyUi theApp enterEventDispatcher public MyUi pushScreen new MyUiScreen class MyUiScreen extends MainScreen public MyUiScreen setTitle UI Component Sample String choices 75 Entwicklungshandbuch Bezeichnungen Monday Tuesday Wednesday Thursday Friday Saturday Sunday int iSetTo 2 add new ObjectChoiceField First Drop down List choices iSetTo int iStartAt il int iEndAt Fp shale int iIncrement 1 iSetTo 10 add new NumericChoiceField Numeric Drop Down List iStartAt iEndAt iIncrement iSetTo public boolean onSavePrompt Beielicnsteiglter Bezeichnungen Verwenden Sie eine Bezeichnung um Text anzuzeigen der eine Steuerung kennzeichnet Name 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 gruppieren Sie beispielsweise zusammen geh rende Elemente oder f hren Sie die h ufigsten
127. formationen so genau wie m glich e _ Erm glichen Sie dass die Benutzer immer die Beenden Taste verwenden k nnen um eine Fortschrittsanzeige auszublenden Richtlinien f r Text e Verwenden Sie einen kurzen und aussagekr ftigen Text zum Beispiel Daten werden geladen oder Anwendungsliste wird erstellt e Wenn eine Aktion lang andauert und Sie mitteilen m chten was in jeder Phase geschieht zeigen Sie einen Text an der jede einzelne Phase beschreibt zum Beispiel Download wird ausgef hrt oder Installation wird ausgef hrt e Verwenden Sie die bliche Gro Kleinschreibung f r S tze e _ Interpunktieren Sie den Text mit Auslassungspunkten 86 Entwicklungshandbuch Aktivit ts und Fortschrittsanzeigen Anzeigen von Aktivit t oder Aufgabenfortschritt Siek nnen dasimnet rim device api ui component progressindicator Paket bereitgestellte API f r die Aktivit ts und Fortschrittsanzeige verwenden um anhand von visuellen Hinweisen auf dem Bildschirm anzuzeigen dass eine Arbeit erledigt oder eine Aufgabe ausgef hrt wird Sie k nnen nicht nur eine Aktivit t darstellen deren Zeitdauer unbekannt ist sondern auch den Fortschritt der numerisch ausgegeben werden kann zum Beispiel als Prozentsatz einer abgeschlossenen Aufgabe Das API f r die Aktivit ts und Fortschrittsanzeige verwendet das Designmuster des Modell Ansicht Controllers und enth lt zwei Felder die f r die Ausgabe der Aktivit
128. frufen von GridFieldManager setRowProperty die Zeilenh he angeben Wenn Sie diese Methoden aufrufen m ssen Sie eine GridFieldManager Eigenschaft angeben Eigenschaft Beschreibung EIXEDESITZE Breite oder H he ist ein fester Wert in Pixel 45 Entwicklungshandbuch Erstellen eines Raster Layouts Eigenschaft PREFERRED SIZE Beschreibung 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 import net rim device api ui import net rim device api ui component import net rim device api ui container Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication 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 Anwendungskonstruktor 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
129. g klickt ruft die Anwendung Menu run auf 128 Entwicklungshandbuch Erstellen eines Men s private Menultem _viewItem new Menultem More Info 110 10 public void run Dialog inform Display more information I 5 berschreiben Sie close um ein Dialogfeld anzuzeigen wenn der Benutzer auf den Men eintrag Schlie en klickt Standardm ig ist der Men eintrag Schlie en in dem Men enthalten das MainScreen erstellt 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 import net rim device api ui 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 addMenuItem _viewItem private Menultem _viewItem new Menultem More Info 110 10 public void run J public void close Dialog inform Display more information Dialog alert Goodbye 129
130. gen myBrowserFieldConfig setProperty BrowserFieldConfig NAVIGATION MODE BrowserFieldConfig NAVIGATION MODE POINTER 6 Erstellen Sie im Bildschirmkonstruktor eine Instanz der Browser Field Klasse die die von Ihnen definierte Konfiguration verwendet 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 myBrowserFieldConf ig Senden von Formulardaten an eine Webadresse in einem Browserfeld 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api browser field2 import net rim device api io http import net rim device api system import net rim device api ui import net rim device api ui container import java lang import java util
131. gen der im Titelbereich des Bildschirms angezeigt wird setTitle PictureScrollField Demo Erstellen und initialisieren Sie im Konstruktor drei Arrays um die im PictureScrollField anzuzeigenden Bilder sowie die Bezeichnungen und den QuickInfo Text der beim Ausw hlen der einzelnen Bilder angezeigt wird zu speichern In diesem Beispiel enth lt das PictureScrollField drei Bilder Bitmap images new Bitmap 3 String labels new String 3 String tooltips new String 3 images 0 Bitmap getBitmapResource imgl jpg labels 0 Label for image 1 tooltips 0 Tooltip for image 1 images 1 Bitmap getBitmapResource img2 jpg labels 1 Label for image 2 tooltips 1 Tooltip for image 2 images 2 Bitmap getBitmapResource img3 jpg labels 2 Label for image 3 tooltips 2 Tooltip for image 3 Erstellen und initialisieren Sie im Konstruktor ein Array mit ScrollEntry Objekten Ein ScrollEntry stellt jedes Element im PictureScrollField dar ScrollEntry entries ScrollEntry 3 yor ime d Os i lt Giheiries hemes 1A Erstellen und initialisieren Sie im Konstruktor das PictureScrollField und verwenden Sie f r jedes Bild eine Breite von 150 Pixeln und eine H he von 100 Pixeln Rufen Sie setData auf um die Eintr ge im PictureScrollField festzulegen Der zweite Parameter in setData legt fest welche Bildposition standardm ig ausgew hlt wird entries i new Scro
132. getFont Font PLAIN 50 helloWorld setFont myFont catch ClassNotFoundException e System out printin e getMessage add helloWorld 151 Entwicklungshandbuch Rechtschreibpr fung Rechtschreibpr fung Sie k nnen die Elemente im net rim blackberry api spellcheck Paket verwenden um einer Anwendung Rechtschreibpr fungsfunktionen 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 Implementierung zu l sen Weitere Informationen zur Verwendung der Spell Check API k nnen Sie der Spell Check Beispielanwendung entnehmen die in der 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 Erstel
133. gressIndicatorListener view setModel model view setController controller controller setModel model controller setView view view setLabel Percent completion view createProgressBar Field FIELD_HCENTER add view Menultem _startIndicator new Menultem Start indicator 66000 0 public void run if _progressThread null _progressThread stopThread _progressThread new ProgressThread _progressThread start Ie Menultem _pauseIndicator new Menultem Pause indicator 66010 0 public void run DE Menultem _resumelndicator new Menultem Resume indicator 66020 view getModel cancel public void run IE addMenultem _startIndicator addMenultem _pauselndicator addMenultem _resumelndicator view getModel resume class ProgressThread extends Thread private boolean _paused private boolean _stop public void run Run dummy operations to simulate the processing of a collection of data Torne 1 0 a lt 100 N synchronized this Entwicklungshandbuch Aktivitats und Fortschrittsanzeigen if _stop break if _paused try wait catch InterruptedException ie ProgressIndicatorScreen this model setValue i try Simulate work sleep 250 catch InterruptedException ie public synchronized void setPaused boolean paused _paused paused this notify public synchronized void st
134. halte 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 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 LEIST
135. handbuch ndern der Darstellung eines Men s else throw new IllegalStateException Context is null expected a Contact Insitanidess E Dialog alert Viewing an email message in the email view rewurn MWS ndern der Darstellung eines Men s Sie k nnen den Hintergrund Rahmen und die Schriftart eines Men s mithilfe der Menu Klasse im net rim device api ui component Paket ndern Zum Beispiel k nnen Sie die Anzeige des Men s ndern damit es ein Erscheinungsbild hat das dem Rest Ihrer BlackBerry Ger teanwendung hnlich ist Wenn Sie die Anzeige eines Men s ndern hebt Ihre BlackBerry Ger teanwendung das Thema auf das auf dem BlackBerry Ger t festgelegt ist ndern der Darstellung eines Men s i 3 Importieren Sie die erforderlichen Klassen und Schnittstellen INPOrE MBE rill device mapik Unm 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 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication 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 Anwendungskonstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene CreateCustomMenuScreen Klasse stellt den benutzerdefinierten Bildsc
136. hirm dar public class CreateCustomMenu extends UiApplication public static void main String args CreateCustomMenu theApp new CreateCustomMenu theApp enterEventDispatcher public CreateCustomMenu pushScreen new CreateCustomMenuScreen 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 ein Textfeld auf dem Bildschirm hinzuzuf gen 145 Entwicklungshandbuch ndern der Darstellung eines Men s class CreateCustomMenuScreen extends MainScreen Background _menuBackground Border _menuBorder Font _menuFont CreateCustomMenuScreen setTitle Custom Menu Sample add new RichTextField Creating a custom menu 4 Geben Sie im Bildschirmkonstruktor die Darstellung des Men s an Erstellen Sie den Abstand f r den Men rahmen durch Erstellen eines XYEdges Objekts 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 Legen Sie im
137. hlen nicht dr cken m ssen Sie k nnen auch zulassen dass Benutzer in Telefonnummernfeldern die folgenden Aktionen ausf hren e Eingeben des Pluszeichens f r internationale Telefonnummern e Eingeben von Formatierungszeichen z B das Minuszeichen den Punkt Klammern und Leerzeichen e Eingeben eines Nummernzeichens oder Sternchens e _ Anzeigen einer Pause durch Eingeben eines Kommas oder Anzeigen einer Wartezeit durch Eingeben eines Ausrufezeichens e Anzeigen einer Durchwahl durch Dr cken der Alt Taste und Dr cken von E X oder T 115 Entwicklungshandbuch Textfelder Art des Textfelds Beschreibung Mussen Benutzer ein Feld Telefonnummer auf einer virtuellen Tastatur eingeben wird die Zahlentastatur angezeigt Sie k nnen auch zulassen dass Benutzer in Telefonnummernfeldern die folgenden Aktionen ausf hren e Eingeben eines Nummernzeichens oder Sternchens e Anzeigen einer Pause oder einer Durchwahl durch Gedr ckthalten der Sternchen Taste e Anzeigen einer Wartezeit oder einer Durchwahl durch Gedr ckthalten der Nummernzeichen Taste Text 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 erfolgt ein Zeilenumbruch in die n chste Zeile In Textfeldern k nnen BlackBerry Ger te Telefonnummern Webseiten und E Mail Adressen auch automatisch in Li
138. hleunigung 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 19 Entwicklungshandbuch Abrufen der Beschleunigungssensordaten in bestimmten Abstanden Sie k nnen die Beschleunigungssensor APls im net rim device api system Paket f r die Reaktion auf die Beschleunigung des BlackBerry Ger ts verwenden Sie m ssen zuerst bestimmen ob das BlackBerry Ger t einen Beschleunigungssensor durch Aufrufen von net rim device api system AccelerometerSensor isSupported unterst tzt Wenn die Methode den Wert true zur 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 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 openRawDataCha
139. htung des Bildschirms abzurufen Die Display Klasse enth lt die Konstanten die den Formaten entsprechen die das Ger t mit Touchscreen zum Anzeigen von Informationen verwenden kann Zum Beispiel entsprechen das Hochformat Querformat und quadratische Ausrichtungen den Display ORIENTATION_PORTRAIT Display ORIENTATION_LANDSCAPE und Display ORIENTATION_SQUARE Konstanten Um das Format des Bildschirms abzurufen k nnen Sie dieDisplay getOrientation Methode aufrufen Diese Methode gibt eine Ganzzahl zur ck die einer der Ausrichtungen entspricht die auf dem BlackBerry Ger t verwendet werden k nnen Damit Ausrichtungs nderungen erkannt werden k nnen Sie Screen sublayout berschreiben Bei dieser Methode rufen Sie super sublayout auf und suchen nach nderungen bei den width und height Werten 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 Sie k nnen die net rim device api system Display Klasse dienet rim dev
140. i Men eintr ge Wenn ein Untermen mehr als sechs Elemente enth lt sollten Sie die Elemente im Untermen in zwei Abschnitten anordnen Platzieren Sie die h ufig verwendeten Men eintr ge oben im Untermen f gen Sie ein Trennzeichen ein und ordnen Sie anschlie end die brigen Elemente alphabetisch an Wenn ein Men eintrag mehr als nur ein Klick vom Benutzer erfordert z B wenn der Benutzer ein Datum festlegen muss ffnen Sie ein Dialogfeld Vermeiden Sie dass h ufig verwendete oder wichtige Men eintr ge in Untermen s angeordnet werden Vermeiden Sie verschachtelte Untermen s Richtlinien f r Bezeichnungen 132 Verwenden Sie im vollst ndigen Men kurze aussagekr ftige Bezeichnungen die die Aktion deutlich definieren Benutzer sollten nicht das Untermen ffnen m ssen um die Elementbedeutung im vollst ndigen Men zu verstehen Verwenden Sie im vollst ndigen Men verbale Bezeichnungen Verwenden Sie Substantive nur dann wenn die Bedeutung klar ist Wird z B E Mail Konten im vollst ndigen Men angezeigt ordnen Sie jedes E Mail Konto in einem Untermen an Entwicklungshandbuch Untermen s e Vermeiden Sie dass sich Verben in Untermen s wiederholen Vermeiden Sie zum Beispiel die Verwendung von Sortieren nach im vollst ndigen Men und Sortieren nach Datum sowie Sortieren nach Namen im Untermen e Verwenden Sie die bliche Gro Kleinschreibung f r Bezeichnungen Schreiben Sie das erste Wo
141. ic void main String args PictureScrollFieldDemo app new PictureScrollFieldDemo app enterEventDispatcher public PictureScrollFieldDemo pushScreen new PictureScrollFieldDemoScreen class PictureScrollFieldDemoScreen extends MainScreen public PictureScrollFieldDemoScreen setTitle PictureScrollField Demo Bitmap images new Bitmap 3 String labels new String 3 String tooltips new String 3 124 Entwicklungshandbuch Anzeigen mehrerer Bilder zum Scrollen images 0 Bitmap getBitmapResource imgl jpg labels 0 Label for image 1 tooltips 0 Tooltip for image 1 images 1 Bitmap getBitmapResource img2 jpg labels 1 Label for image 2 tooltips 1 Tooltip for image 2 images 2 Bitmap getBitmapResource img3 jpg labels 2 Label for image 3 tooltips 2 Tooltip for image 3 ScrollEntry entries ScrollEntry 3 for int i 0 i lt entries length i PictureScrollField pictureScrollField new PictureScrollField 150 100 pictureScrollField setData entries pictureScrollField setHighlightStyle HighlightStyle ILLUMINATE pictureScrollField setHighlightBorderColor Color BLUE pictureScrollField setBackground BackgroundFactory createSolidTransparentBackground Color RED 150 pictureScrollField setLabelsVisible true add pictureScrollField entries i new ScrollEntry images i labels i tooltips i Anzeigen meh
142. ice api ui Ui Klasse und dienet rim device api ui UiEngineInstance Klasse verwenden um die Richtung zu steuern die das BlackBerry Ger t verwendet um Informationen auf dem Bildschirm anzuzeigen Die Display Klasse enth lt Konstanten die den Richtungen entsprechen die das Ger t zum Anzeigen von Informationen verwenden kann Zum Beispiel entsprechen Norden Westen und Osten den Display DIRECTION_NORTH Display DIRECTION_WEST und Display DIRECTION_EAST Konstanten Sie k nnen ein Objekt der net rim device api ui Ui Klasse erstellen und Ui getUiEnginelnstance aufrufen um ein Objekt der UiEngineInstance Klasse abzurufen Durch Aufrufen von UiEngineInstance setAcceptableDirections mit einer 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 16 Entwicklungshandbuch Festlegen des Formats und der Richtung des Bildschirms 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 APl Anwendung Use c
143. ichkeit um auf die h ufigsten Aktionen f r ein markiertes Element zuzugreifen Sie k nnen ein Popup Men auch dann verwenden wenn ein markiertes Element mitmehreren Aktionen verkn pft ist oder wenn mit einem markierten Element keine prim ren Aktionen verkn pft sind Sie k nnen ein Popup Men erstellen das neun Aktionen sechs Aktionen oder drei Aktionen enth lt Aktion BlackBerry Ger te nur mit Trackpad ffnen eines Popup Men e Klicken mit dem Trackpad e Wenn bereits eine prim re Aktion mit einem Element verkn pft wurde zum Beispiel das ffnen einer Nachricht k nnen die Benutzer mit dem Trackpad klicken und es halten um ein Popup Men zu ffnen BlackBerry Ger te mit Touchscreen und Trackpad Tippen auf das Element Klicken mit dem Trackpad Wenn bereits eine prim re Aktion mit einem Element verkn pft wurde zum Beispiel das ffnen einer Nachricht k nnen die Benutzer mit dem Trackpad klicken und es halten oder den 135 Entwicklungshandbuch Popup Men s BlackBerry Ger te mit Touchscreen und Aktion BlackBerry Ger te nur mit Trackpad Trackpad Touchscreen mit einem Finger ber hren um ein Popup Men zu ffnen Ausw hlen eines Elements e Klicken mit dem Trackpad e Tippen auf das Element aus einem Popup Men e Dr cken Sie die Eingabetaste e Klicken mit dem Trackpad e Dr cken Sie die Eingabetaste Schlie en eines Popup Dr cken der Esc Taste e Tippen Sie auf eine Position Men s au
144. ie 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 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 einem BlackBerry Ger t zu interagieren Sie k nnen sie auch in barrierefreien Anwendungen wie z B Sprache in Text Konvertern verwenden F r eine Beispielanwendung die die Ereignisinjektion demonstriert besuchen Sie www blackberry com go toucheventinjectorsampleapp um die Beispielanwendung des Ber hrungsereignisinjektors herunterzuladen Weitere Informationen zur Beispielanwendung finden Sie unter www blackberry com go docs developers im Touch Event Injector Sample Application Overview berblick ber die Beispielanwendung des Ber hrungsereignisinjektors 37 Entwicklungshandbuch Command Framework API Command Framework API Sie k nnen das Command Framework APlim net rim device api command Paket verwenden um die Funktionalitat zu definieren
145. im Bildschirmkonstruktor Benutzeroberflachen Komponenten die das Popup Men aufrufen k nnen Im folgenden Codebeispiel verwendet die Bezeichnung die Field FOCUSABLE Eigenschaft um Benutzern zu erlauben das Feld zu markieren LabelField labelField new LabelField Click to invoke pop up menu Field FOCUSABLE emailAddress new EmailAddressEditField Email address name blackberry com 40 140 Entwicklungshandbuch Popup Men s 6 Konfigurieren Sie im Bildschirmkonstruktor die Benutzeroberfl chen Komponenten als Lieferant der Befehlselemente Das DefaultContextMenuProvider Objekt sucht Felder die als Lieferanten f r Befehlselemente konfiguriert wurden und verwendet diese zur Erstellung und Anzeige eines Popup Men s Rufen Sie f r jede Komponente Field setCommandItemProvider auf um das Feld als einen allgemeinen Befehlselementlieferanten zu konfigurieren Die ItemProvider Klasse wird in Schritt 7 beschrieben ItemProvider itemProvider new ItemProvider labelField setCommandItemProvider itemProvider emai lAddress setCommandItemProvider itemProvider 7 Implementieren Sie auf dem benutzerdefinierten Bildschirm die CommandI temProvider Schnittstelle Geben Sie in getContext das Feld zur ck das als Befehlselementlieferant konfiguriert wurde Erstellen Sie in getItems ein Vector Objekt dem die Popup Men eintr ge hinzugef gt werden sollen class ItemProvider implements CommandItemProvider public Object g
146. import java util public class DatePick extends UiApplication public static void main String args DatePick theApp new DatePick theApp enterEventDispatcher public DatePick class DatePickScreen extends MainScreen pushScreen new DatePickScreen public DatePickScreen setTitle Date Picker Sample add new RichTextField Trying Date Picker UiApplication getUiApplication invokeLater new Runnable public void run DateTimePicker datePicker DateTimePicker getInstance datePicker doModal Calendar cal datePicker getDateTime Date date cal getTime Dalalloerzallena Yoleseilleetrede ZZ daitertoserin ODE ln Erstellen einer Dateiauswahl 1 Importieren Sie die erforderlichen Klassen und Schnittstellen 98 Auswahltool Entwicklungshandbuch Auswahltool 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 java util 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die FilePickScreen Klasse stellt den in Schritt 3 beschriebenen benutzerd
147. invoke pop up menu Field FOCUSABLE emailAddress new EmailAddressEditField Email address name blackberry com 40 ItemProvider itemProvider new ItemProvider LabelField setCommandItemProvider itemProvider emailAddress setCommandItemProvider itemProvider add labelField add emailAddress To override the default functionality that prompts the user to save changes before the application closes override the MainScreen onSavePrompt method In the following code sample the return value is true which indicates that the application does not prompt the user before closing wu protected boolean onSavePrompt 142 Entwicklungshandbuch Hinzuf gen eines Men eintrags zu einer BlackBerry Device Software return true class ItemProvider implements CommandItemProvider public Object getContext Field field return field public Vector getItems Field field Vector items new Vector CommandItem defaultCmd Image myIcon ImageFactory createImage Bitmap getBitmapResource my_logo png if field equals emailAddress defaultCmd new CommandItem new StringProvider Email Address myIcon new Command new DialogCommandHandler else defaultCmd new CommandItem new StringProvider Label Field myIcon new Command new DialogCommandHandler items addElement defaultCmd return items class DialogCommandHandler extends CommandHandler i public void execute Rea
148. isse 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 ButtonField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf 4 Pr fen Sie ob der Wert den TouchGesture getSwipeDirection zur ckgibt 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 perurm Erue return false Reagieren auf einen Benutzer der einen Finger schnell nach unten Uber 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 public class newButtonField extends ButtonField 3 Rufen Sie in Ihrer Imp
149. ist zu binden In diesem Beispiel handelt es sich bei den Daten um Kontaktinformationen und die Datenquelle ist die Kontaktliste Das erste Argument dasSiean addDataSource bergeben ist eine eindeutige ID Das zweite Argument bindet das BasicFilteredList an eine Datenquelle Das dritte Argument gibt den Satz von Datenquellenfeldern an mit denen verglichen wird Das 108 Entwicklungshandbuch Suche vierte Argument gibt den Satz von Datenquellenfeldern an die bereitgestellt werden sollen wenn eine Ubereinstimmung gefunden wird In diesem Beispiel sind die Felder mit denen verglichen wird identisch mit den Feldern die bereitgestellt werden sollen wenn eine 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 il 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 i
150. konstruktor ein String Objekt das die Formulardaten angibt die Ihre Anwendung an die Webseite sendet String postData fieldnamel valuel amp fieldname2 value2 Erstellen Sie im Bildschirmkonstruktor ein Hashtable Objekt um die Kopfzeileninformationen f r die Formulardaten zu speichern Hashtable header new Hashtable 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 Rufen Sie im Bildschirmkonstruktor BrowserField requestContent auf um die Formulardaten an die Webseite zu senden und die Webseite anzuzeigen browserField requestContent baseURL postData getBytes new HttpHeaders header Entwicklungshandbuch Dialogfelder Codebeispiel Senden von Formulardaten an eine Webadresse in einem Browserfeld import import import import import import import public net rim device api browser field2 net rim device api io http net rim device api system NSC FIM CAVITIES ZO Ui net rim device api ui container java lang ever Wied hs class BrowserFieldDemo extends UiApplication public static void main String args BrowserFieldDemo app new BrowserFieldDemo app enterEventDispatcher public BrowserFieldDemo pushScreen new BrowserFieldDemoScreen class BrowserFieldDemoScreen ext
151. lementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf 28 Entwicklungshandbuch Reagieren auf Touchscreen Ereignisse 4 Pr fen Sie ob der Wert den TouchGesture getSwipeDirection zur ckgibt gleich TouchGesture SWIPE_SOUTH 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 SwWIPE SOUTH Dialog alert Downward swipe occurred return Erue return false Reagieren auf einen Benutzer der einen Finger schnell nach rechts Uber 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 public class newButtonField extends ButtonField 3 Rufen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf 4 Pr fen Sie ob der Wert den TouchGesture getSwipeDirection zur ckgibt gleich TouchGesture SWIPE_EAST ist protected boolean touchEvent TouchEvent message switch message getEvent cas
152. len Registry gespeichert sind 5 Definieren Sie optional Befehls und Kontextkategorien f r den Befehl Anwendungen die den Befehl verwenden nutzen die Kategorien um Befehle in einer Registry zu finden und um zu bestimmen ob ein Befehl ausf hrbar ist Kategorietyp Beschreibung Befehl Legt eine Kategorisierungsart f r den Befehl fest Anwendungen die Befehle verwenden k nnen eine Registry nach Befehlen in festgelegten Kategorien abfragen Kontext Legt den f r Ihren Befehl geeigneten Ausf hrungskontext fest Anhand dieser Kategorie k nnen Sie den Anwendungen die den Befehl verwenden mitteilen welche Kontextobjektarten an CommandHandler Execute bergeben werden k nnen String myCommandCategories app contacts action view metadata setCommandCategories new CategoryCollection myCommandCategories String myContextCategories emailaddr metadata setContextCategories new CategoryCollection myContextCategories 6 Registrieren Sie den Befehl a Wenn Ihr Befehl nur in Ihrer Anwendung verf gbar sein soll verwenden Sie ein LocalCommandRegistrarConnection Objekt Die lokale Registry ist nur im aktuellen Prozess verf gbar LocalCommandRegistrarConnection connection new LocalCommandRegistrarConnection connection registerCommand new ViewContactCommand metadata Anmerkung Um den Anwendungen zu erm glichen Instanzen des Befehls dynamisch zu erstellen m ssen Sie den Befehl nur mit den Metadaten
153. len 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 addSpellCheckUlListener mit einem SpellCheckUIListener Objekt als Parameter auf _spellCheckUI addSpellCheckUIListener new SpellCheckUIListener 6 Um eine Anwendung eine Rechtschreibpr fung f r Benutzeroberfl chenfelder durchf hren und BlackBerry Ger tebenutzern Rechtschreibkorrekturen vorschlagen zu lassen rufen Sie ein SpellCheckEngine Objekt ab und rufen Sie getSpellCheckEngine auf _spellCheckEngine _spellCheckUI getSpellCheckEngine 7 Um eine Korrektur f r ein falsch buchstabiertes Wort zu verwenden rufen Sie SpellCheckEngine learnCorrection auf Verwenden Sie die Parameter new StringBuffer text new StringBuffer correction wobei text das falsch buchstabierte Wort und correction das richtige Wort darstellt 152 Entwicklungshandbuch Empfangen von Rechtschreibpr fungsereignissen _spellCheckEngine learnCorrection new StringBuffer text new StringBuffer correction Um f r ein Feld Rechtschreibpr fungsvorg nge auszuf hren rufen Sie SpellCheckUI spellCheck mit field als Parameter auf _spellCheckUI spellCheck field Um ein falsch buchstabiertes Wort als richtig buchstabi
154. 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 3 This is 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 17 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 einer Textrichtung von links nach rechts von rechts nach links oder von oben nach unten in Gebietsschemas mit einer 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 Sie k nnen durch Aufrufen von GridFieldManager setColumnProperty die Spaltenbreite und durch Au
155. llEntry images i labels i tooltips i PictureScrollField pictureScrollField new PictureScrollField 150 100 pictureScrollField setData entries Legen Sie im Konstruktor den PictureScrollField Stil fest Rufen Sie setHighlightStyle auf um festzulegen wie das ausgew hlte Bild hervorgehoben wird Rufen Sie setHighlightBorderColor auf um die Rahmenfarbe des ausgew hlten Bilds festzulegen Rufen Sie setBackground auf um den PictureScrollField Hintergrund festzulegen Rufen Sie setLabelVisible auf um festzulegen ob das PictureScrollField die Bezeichnung des ausgew hlten Bilds anzeigt Entwicklungshandbuch Anzeigen mehrerer Bilder zum Scrollen pictureScrollField setHighlightStyle HighlightStyle ILLUMINATE pictureScrollField setHighlightBorderColor Color BLUE pictureScrollField setBackground BackgroundFactory createSolidTransparentBackground Color RED 150 pictureScrollField setLabelsVisible true 9 Rufen Sie im Konstruktor add auf um das PictureScrollField anzuzeigen add pictureScrollField 127 Entwicklungshandbuch Men befehle Men befehle Se 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 UWMOOrC MSC fill CeVviEe ajo Wil import net rim device api ui component import net rim device api ui container
156. llen 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 DATA_FIELD_CONTACTS_BIRTHDAY Felds in der DATA_SOURCE_CONTACTS Datenquelle vergleichen und den Wert des entsprechenden DATA_FIELD_CONTACTS_NAME_FULL Felds zur 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 e Ein Array wortlicher Zeichenfolgen Ein Array von Objekten das toString unterst tzt e Datenquellen auf einem BlackBerry Ger t wie z B Kontakte Notizen Aufgaben und verschiedene Arten von Mediendateien e 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 Importieren Sie die erforderlichen Klassen und S
157. llenwert ein gr ere Trackball Bewegung ist erforderlich um ein Navigationsereignis zu erzeugen 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 rollt Die Trackball Empfindlichkeit steigt vor bergehend an wenn der Benutzer den Trackball l ngere Zeit ununterbrochen rollt Trackwheel BlackBerry Ger te vor der BlackBerry Pearl 8100 Series verwenden ein Trackwheel als prim re Steuerung der Benutzernavigation Das Trackwheel befindet sich an der rechten Seite des BlackBerry Ger ts Benutzer k nnen folgende Aktionen ausf hren Entwicklungshandbuch Tastatur 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 T
158. ltem Konstruktor mit einer Ganzzahl 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 Text des Men eintrags festzulegen 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 ContactsDemoMenultem contactsDemoMenultem new ContactsDemoMenultem 6 Rufen Sie ApplicationMenultemRepository addMenultem auf um den Men eintrag zur entsprechenden Anwendungsdatenbank auf dem BlackBerry Ger t hinzuzuf gen repository addMenultem ApplicationMenultemRepository MENUITEM ADDRESSCARD_ VIEW contactsDemoMenultem 7 Implementieren Sie run um das Verhalten des Men eintrags festzulegen Im folgenden Codebeispiel ruft die ContactsDemo Anwendung das Ereignis und ContactsDemo enterEventDispatcher auf wenn ein Benutzer auf den neuen Men eintrag klickt und ein Contact Objekt vorhanden ist public Object run Object context BlackBerryContact c BlackBerryContact context ir e le mull y new ContactsDemo enterEventDispatcher 144 Entwicklungs
159. lumn grid insert new LabelField insert 0 1 The grid now looks like this one insert two iif three four five delete a cell second row second column Sinidadeiketeiee E The grid now looks like this w one insert two three five Add field to first unoccupied cell grid add new LabelField new The grid now looks like this if one insert two iif three new five Anzeigen von Feldern in einem Paar tempor rer Manager 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 auf dem Bildschirm 1 Importieren Sie die erforderlichen Klassen und Schnittstellen 48 Entwicklungshandbuch Anzeigen von Felder
160. m String 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 y Entwicklungshandbuch Bilder Bilder Verwenden von codierten Bildern Zugriff auf ein codiertes Bild Uber einen Eingabestream 1 Importieren Sie die erforderlichen Klassen import java io InputStream Speichern Sie das Bild im Projektordner oder in einem Unterordner F gen Sie das Bild dem Projekt im BlackBerry Java Plug in Eclipse oder im BlackBerry Java Development Environment hinzu 4 Rufen Sie getClass getResourceAsStream auf um das Bild als Eingabestream in Bytes abzurufen private InputStream input Class _ class this getClass input _class getResourceAsStream images example png Codieren eines Bilds 1 Importieren Sie die erforderlichen Klassen import net rim device api system EncodedImage 2 Rufen Sie EncodedImage createEncodedImage auf Diese Methode verwendet die unverarbeiteten Bilddaten im Byte Array um eine EncodedImage Instanz zu erstellen 3 Pr fen Sie das IllegalArgumentException Objekt das von EncodedImage createEncodedImage ausgegeben wird wenn das von Ihnen als Parameter bereitgestellte Byte Array kein anerkanntes Bildformat enth lt Store the contents of the image file private byte data new byte 2430
161. m Bildschirm 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api system 1MPORE Net hIMAdeviGe apie Ui import net rim device api ui container import net rim device api ui component 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene AbsoluteFieldManagerDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class AbsoluteFieldManagerDemo extends UiApplication public static void main String args AbsoluteFieldManagerDemo app new AbsoluteFieldManagerDemo app enterEventDispatcher public AbsoluteFieldManagerDemo pushScreen new AbsoluteFieldManagerDemoScreen 3 Erstellen Sie das Framework f r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse Rufen Sie setTitle auf um den Text festzulegen der im Titelbereich des Bildschirms angezeigt wird class AbsoluteFieldManagerDemoScreen extends MainScreen public AbsoluteFieldManagerDemoScreen setTitle AbsoluteFieldManager Demo 4 Erstellen Sie im Bildschirmkonstruktor eine Instanz der AbsoluteFieldManager Klas
162. mentieren von Listen und Tabellen 79 Enstellenceines Listenfeld Sarir techs Metis cesssnateascccesscedaxexteansesdte ccunsteGasssuvesscevesschasdevasdteSeetevsatavdcti essere 80 Optionsfelden seneceiesnnennenn ie Aal in aa a E aa a dl abauetd saedh aKa Ena 82 Bew hrtes Verfahren Implementieren von Optionsfeldern cccccccccsssccccsssececessseccessseecceseeceeesseeeeeeeaes 8 Erstellen eines Optionsfeldes cc ccccccssscccesssscccccssseeccccsseececessasecccsssecececsaeeeccsesseeecessasesecesseeceeeesteeeessaaes 83 Aktivitats und Fortschrittsanzeigen u u 1 00 nennen nenne 85 Bew hrtes Verfahren Implementieren von Aktivit ts und Fortschrittsanzeigen neneeeeeeeeeenee 86 Anzeigen von Aktivit t oder Aufgabenfortschritt cccccccccsssccccssececessseeccesseececssseeeccaseeeesssseeeessaeeeees 87 AUSWADICOO DE PER EEE ENTER a O DIENETE PONELNENEENEESS ALTERS TRCHFIRSERECTENBEU TEILTE DERIFTTEEE SCHE SERE NELENE 94 Bew hrtes Verfahren Implementieren von AUSWAHIEN cccccccccecsssscccecessseeccessseececesseeeeceesseeeeeesaas 96 Erstellen einer Datumsauswahl u nnsnn seen nenne nes ehren 96 Erstellen einer Dateiauswahl uu002240000ssssnnenssnnnennnennnnnnennnnnnnnnnnnnnnnnnnnnnnnennnnennennnnnnnsnnnnnsnnnnnennnennann 98 Suche none nich en nee dha shdeueusdudaberbavectesdecwaeigents shogees 101 Bew hrtes Verfahren Implementieren von SUCHFUNKTIONEN cccccccessecceessecceesseceesseeeecaeece
163. mit Text Verwenden Sie eine Fortschrittsanzeige wenn Sie die Dauer einer Aktion bestimmen k nnen Fortschrittsanzeigen enthalten neben einer Bezeichnung die die Aktion beschreibt eine horizontale Leiste die sich mit dem Aktionsfortschritt von links nach rechts f llt Ein Prozentsatz zeigt in der Leiste an wie viel der Aktion bereits verarbeitet wurde 85 Entwicklungshandbuch will be removed but you can still read messages in these languages BEnglis t Deutsch W Espa ol Removing languages 64 Nederlands J Portugu s Portugu s Brasil Update Return to Setup Aktivitats und Fortschrittsanzeigen Bew hrtes Verfahren Implementieren von Aktivit ts und Fortschrittsanzeigen e Zeigen Sie immer den Fortschritt an wenn f r den Abschluss eines Vorgangs mehr als 2 Sekunden ben tigt werden e Verwenden Sie eine Fortschrittsanzeige wenn Sie die Dauer einer Aktion bestimmen k nnen e Verwenden Sie eine Aktivit tsanzeige wenn Sie die Dauer einer Aktion nicht bestimmen k nnen e Verwenden Sie die ActivityIndicatorView Klasse um Aktivit tsanzeigen zu erstellen Verwenden Sie die ProgressIndicatorView Klasse um Fortschrittsanzeigen zu erstellen e Stellen Sie hilfreiche Fortschrittsinformationen bereit Wenn zum Beispiel Benutzer eine Anwendung auf ihr Ger t herunterladen zeigen Sie den Prozentsatz der Daten an den das BlackBerry Ger t heruntergeladen hat Seien Sie bei den Fortschrittsin
164. mportieren 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 Bin roptionen die Benutzer problemlos verstehen k nnen Verwenden Sie zum Beispiel ein Kontrollk stchen f r eine Option die ein und ausgeschaltet werden kann Benutzer k nnen mit einem Kontrollk stchen die folgende Aktion ausf hren T i BlackBerry Ger te mit Touchscreen und Aktion BlackBerry Ger te nur mit Trackpad ry Trackpad Ausw hlen eines Dr cken der Leertaste oder Klicken mit e Tippen auf das Element e Dr cken Sie die Leertaste e Klicken mit dem Trackpad Kontrollk stchens dem Trackpad My Profile Display Name Karla Tetzel PIN 12A34B56C PIN Barcode Show Personal Message Status Available v Wi Show what I m listening to L Show my location 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 ausw hlen ffnen Sie zum Beispiel keinen neuen Bildschirm Richten Sie Kontrollk stchen senkrecht aus 55 Entwicklungshandbuch Kontrollk stchen e _ Gruppieren und ordnen Si
165. n 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 mit dem Trackball oder Trackwheel Eine BlackBerry Java Application sollte weitestgehendst das folgende Eingabe und Navigationsmodell verwenden 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 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 Funktionalit t ohne weiteres Anpassen Sie m ssen allerdings die gew nschten Men eintr ge 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 d
166. n TouchEvent getEvent zur ckgibt gleich TouchEvent MOVE ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent MOVE return true return false Reagieren auf einen Benutzer der den Bildschirm an zwei Stellen gleichzeitig ber hrt 1 Importieren Sie die folgenden Klassen net net net net net rim device rim device rim device rim device rim device api api api api api ui ui ui ui ui TouchEvent Field Manager Screen 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 ButtonField 33 Entwicklungshandbuch Pinch Gesten 3 Pr fen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode ob die folgenden Methodenaufrufe Werte zur ckgeben die gr er Null sind 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 0 amp amp message getY 2 gt 0 Dialog alert Second finger touched moved return true return false Pinch Gesten Pinch Gesten werden auf BlackBerry Ger ten mit Touchs
167. n Men s und des Untermen s Dr cken Sie zweimal die ESC Taste ffnen oder Schlie en der Schiebeh lle Ein Pfeil zeigt an dass Untermen eintr ge f r ein Element des vollst ndigen Men s verf gbar sind 131 Entwicklungshandbuch Untermen s 3G 277 4 Monday May 10 2010 gt 4 Monday May 10 2010 Goto Today Go to Today Go To Date Go To Date Select Calendar Select Calendar View View Week Search Search Month Reminder Alerts Send As Text Message Agenda Options Reminder Alerts Help Options Close Help Ein Element im vollst ndigen Men mit einem Pfeil Ein vollst ndiges Men und ein Untermen Bew hrtes Verfahren Implementieren von Untermen s Verwenden Sie die Submenu Unterklasse um Untermen s zu erstellen Verwenden Sie Untermen s um im vollst ndigen Men die Anzahl der Men eintr ge zu verringern Wenn z B die Benutzer scrollen m ssen um in einem vollst ndigen Men alle Elemente anzuzeigen ordnen Sie einige Men eintr ge in einem Untermen an Ordnen Sie verwandte Elemente in einem Untermen an Wenn im vollst ndigen Men z B Sortieren nach angezeigt wird ordnen Sie Datum Name und Betreff in einem Untermen an Erweiterte Funktionen sollten in einem Untermen angeordnet werden Verwenden Sie z B Zus tzliche Optionen im vollst ndigen Men und ordnen Sie die Optionen im Untermen an Vermeiden Sie die Verwendung von Untermen s f r einen oder zwe
168. n horizontalen Bildlauf zu aktivieren Anderenfalls werden auf dem Bildschirm so viele Benutzeroberfl chenkomponenten wie innerhalb der verf gbaren Bildschirmbreite m glich angezeigt wobei die brigen entfallen Die Benutzeroberfl chenkomponenten sind vorhanden aber nicht sichtbar Dies kann zu einem unerwarteten Verhalten beim Scrollen f hren Dieser Layout Manager ordnet Benutzeroberfl chenkomponenten auf dem Bildschirm von oben nach unten in einer einzelnen vertikalen Spalte an Da dieser Layout Manager Elemente vertikal anordnet k nnen Sie keine 43 Entwicklungshandbuch Anordnen von Benutzeroberflachenkomponenten Layout Manager Beschreibung vertikalen Stile an Benutzeroberflachenkomponenten zum Beispiel Field FIELD TOP Field FIELD BOTTOM oder Field FIELD_VCENTER anwenden Sie k nnen horizontale Stile zum Beispiel Field 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 anzuordnen 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 Benutzerober
169. n 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 bis 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 Stile anwenden zumBeispielField FIELD_TOP Field FIELD_BOTTOModer Field FIELD_VCENTER um die Benutzeroberfl chenkomponenten innerhalb ihrer Zeile vertikal auszurichten Dieser Layout Manager ordnet Benutzeroberfl chenkomponenten in einer einzelnen horizontalen Zeile vom linken zum rechten Rand des Bildschirms an Da dieser Layout Manager Benutzeroberfl chenkomponenten horizontal anordnet k nnen Sie keine horizontalen Stile an Benutzeroberfl chenkomponenten zum Beispiel Field FIELD_LEFT Field FIELD_HCENTER oder Field FIELD RIGHT anwenden Sie k nnen vertikale Stile zum Beispiel Field FIELD_TOP Field FIELD BOTTOM oder Field FIELD_VCENTER anwenden Wenn die Benutzeroberfl chenkomponenten nicht in die verf gbare Breite des Bildschirms passen sollten Sie den Manager HORIZONTAL_SCROLL Stil verwenden um eine
170. n in einem Paar tempor rer Manager import net rim device api system 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 extension container 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor 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 Agee EyelidFieldManagerDemo pushScreen new EyelidFieldManagerDemoScreen 3 Erstellen Sie das Framework f r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class EyelidFieldManagerDemoScreen extends MainScreen public EyelidFieldManagerDemoScreen 4 Rufen Sie im Bildschirmkonstruktor setTitle auf um den Text festzulegen der im Titelbereich des Bildschirms angezeigt wird setTitle EyelidFieldManager Demo 5 Erstellen Sie im Bildschirmkonstruktor eine Instanz der EyelidFieldMan
171. nd den unten stehenden nummerierten Positionen von am h ufigsten bis zu den am wenigsten verwendeten Elementen ein Nutzen Sie das Ged chtnisverm gen der Benutzer und versuchen Sie die Reihenfolge der Aktionen vertr glich zur Aktionenreihenfolge in anderenBlackBerry Ger teanwendungen zu implementieren e Wenn die Positionen dynamisch gef llt werden zeigen Sie keine Men eintr ge an die nicht verf gbar sind Erlauben Sie dass sich die Position der verf gbaren Men eintr ge ndern kann e Wenn die Anzahl der Aktionen zum F llen eines Men s nicht ausreicht verwenden Sie ein kleineres Men Wenn eine oder zwei Positionen aufgef llt werden m ssen verwenden Sie n tzliche Aktionen wie z B Kopieren oder Suchen Wenn Sie eine Position nicht f llen wird Anwendung wechseln oder Startseite angezeigt Info ber das Einf gen von Elementen in Popup Men s Popup Men s zeigen in Abh ngigkeit von der Elementanzahl Men eintr ge in einem Rasterformat 3x3 3x2 oder 3x1 an Standardm ig enth lt das Popup Men immer ein Element zum ffnen des vollst ndigen Men s Sie k nnen bis zu acht zus tzliche Elemente bereitstellen Wenn Sie mehr als acht Elemente bereitstellen werden die zus tzlichen Elemente nicht angezeigt Stattdessen k nnen Sie dem vollst ndigen Men zus tzliche Elemente hinzuf gen Das erste Element das Sie dem Vektor der CommandI tem Elemente hinzuf gen ist das Standardelement im Popup Men Da
172. nem Finger nach oben oder unten ber den Bildschirm Schieben eines Fingers in irgendeine Richtung Dr cken der Esc Taste Touchscreen Ergebnis Wenn Benutzer in einer Nachrichtenliste einen Finger auf den 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 Bildschirm 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 schnell
173. ngen Verwenden Sie kurze klare Bezeichnungen Stellen Sie sicher dass die Bezeichnung klar beschreibt was ausgef hrt wird wenn Benutzer das Optionsfeld aktivieren Wenn die Bezeichnungen zu lang sind erfolgt ein Zeilenumbruch Platzieren Sie Bezeichnungen rechts von den Optionsfeldern Verwenden Sie die bliche Gro Kleinschreibung f r S tze Verwenden Sie keine Satzzeichen am Ende der Bezeichnung Erstellen eines Optionsfeldes Mithilfe der RadioButtonGroup Klasse k nnen Sie eine Gruppe von Optionsfeldern erstellen Ein Benutzer kann nur eine Option aus einer Gruppe von Optionsfeldern ausw hlen 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 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor 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
174. nks umwandeln Webadresse Benutzer k nnen durch Dr cken der Leertaste einen Punkt in ein Adressfeld einf gen Bew hrtes Verfahren Implementieren von Textfeldern Verwenden Sie die TextField Klasse um Textfelder zu erstellen W hlen Sie den Typ des Textfelds basierend darauf aus welche Art von Eingabe Sie von den Benutzern erwarten Die Verwendung eines geeigneten 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 von Ihnen ausgew hlte Feld 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 F gen Sie ggf einen Hinweistext als Anleitung f r die Benutzer hinzu Verwenden Sie einen Hinweistext wenn nicht gen gend Platz auf dem Bildschirm vorhanden ist um eine Bezeichnung oder eine Anweisung anzuzeigen Der Hinweistext wird im Feld angezeigt und ausgeblendet sobald die Benutzer Eingaben vornehmen Richtlinien f r Bezeichnungen 116 Verwenden Sie kurze klare beschreibende Bezeichnungen Vermeiden Sie Bezeichnungen mit Zeilenumbr chen Verwenden Sie die bliche Gro Kl
175. nnel 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 durch Aufrufen von AccelerometerSensor Channel getLastAccelerationData abrufen 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 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 sy
176. nschaulicht besuchen Sie www blackberry com go screentransitionssample Weitere Informationen zur Beispielanwendung finden Sie unter www blackberry com go devguides im 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 die BlackBerry Java Development Environment Abrufen von Beschleunigungssensordaten 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 ist zur 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 der net rim device api system AccelerometerSensor Klasse in der API Referenz f r die BlackBerry Java Development Environment Sie k nnen einer BlackBerry Ger teanwendung erm glichen auf die Besc
177. nt import net rim device api ui container Umportsneitarimadeviieesapieuimdeeore 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 14 Entwicklungshandbuch Festlegen des Formats und der Richtung des Bildschirms public ScreenTransitionSample _secondaryScreen new FullScreen _secondaryScreen setBackground BackgroundFactory createSolidBackground Color LIGHTBLUE LabelField labelField new LabelField The screen closes automatically in two seconds 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 UiEngineInstance engine Ui getUiEngineInstance engine setTransition null _secondaryScreen UiEngineInstance TRIGGER PUSH transition transition new TransitionContext TransitionContext TRANSITION FADE transition setIntAttribute TransitionContext ATTR_DURATION 500 transition setIntAttribute TransitionContext ATTR_KI
178. ntwicklungshandbuch Datum 158 Verlauf der Dokumentrevision Beschreibung Verwenden eines Befehl in mindestens einer Anwendung Verwenden eines Befehls mit einer Benutzeroberflachenkomponente Verwenden von codierten Bildern Die folgenden Codebeispiele wurden hinzugef gt Codebeispiel Erstellen eines Popup Men s Codebeispiel Erstellen eines Untermen s Codebeispiel Anzeigen einer Reihe von Bildern zum Scrollen Codebeispiel Anzeigen einer Bezeichnung an einer absoluten Bildschirmposition Codebeispiel Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken Die folgenden Themen wurden ge ndert Aktivit ts und Fortschrittsanzeigen Schaltfl chen Erstellen einer Benutzeroberfl che die mit den standardm igen BlackBerry Benutzeroberfl chen vertr glich ist Dialogfelder Dropdown Listen Listen und Tabellen Auswahltool Optionsfelder Suche Drehfelder Textfelder Strukturansichten Die folgenden Themen wurden entfernt Hinzuf gen eines Symbols zu einem Men eintrag Hinzuf gen eines Symbols zu einem Men eintrag Codebeispiel Hinzuf gen eines Symbols zu einem Men eintrag Entwicklungshandbuch Rechtliche Hinweise Rechtliche Hinweise 2010 Research In Motion Limited Alle Rechte vorbehalten BlackBerry RIM Research In Motion und die zugeh rigen Marken Namen und Logos sind Eigentum von Research In Motion Limited und sind in den USA und weiteren Landern weltweit als Marken eingetrag
179. o ON N2L 3W8 Canada Research In Motion UK Limited Centrum House 36 Station Road Egham Surrey TW20 9LF United Kingdom Ver ffentlicht in Kanada 161
180. oCompleteField autoCompleteField new AutoCompleteField filterList add autoCompleteField Erstellen eines autocomplete Textfelds aus einer Datenquelle 1 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 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie pushScreen im Anwendungskonstruktor auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die HomeScreen Klasse stellt den in Schritt 3 beschriebenen benutzerdefinierten Bildschirm dar public class AutoCompleteFieldApp extends UiApplication public static void main String args AutoCompleteFieldApp app new AutoCompleteFieldApp app enterEventDispatcher public AutoCompleteFieldApp pushScreen new HomeScreen 3 Erstellen Sie den benutzerdefinierten Bildschirm f r die Anwendung durch Erweitern der MainScreen Klasse class HomeScreen extends MainScreen public HomeScreen 4 Erstellen Sie im Bildschirmkonstruktor ein BasicFilteredList Objekt Rufen Sie addDataSource auf um eine Datenquelle an BasicFilteredL
181. och angezeigt Rufen Sie add auf um die Dropdown Liste dem Bildschirm hinzuzuf gen Entwicklungshandbuch Dropdown Listen String choices Monday Tuesday Wednesday Thursday Friday Saturday Sunday WMG WSSelO 2 add new ObjectChoiceField First Drop down List choices iSetTo 5 Erstellen Sie im Bildschirmkonstruktor mithilfe der Numer i cChoiceField 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 iIncrement 1 iSetTo 10 add new NumericChoiceField Numeric Drop Down List iStartAt iEndAt iIncrement iSetTo 6 Um die Standardfunktionalit t zu berschreiben die den Benutzer auffordert nderungen vor dem Schlie en der Anwendung zu speichern berschreiben Sie in der Erweiterung der MainScreen Klasse die Methode MainScreen onSavePrompt Im folgenden Codebeispiel wird true zur ckgegeben Dies bedeutet dass vor dem Schlie en keine Benutzerauf
182. ode like this before invoking UiApplication pushScreen int direction Display DIRECTION_NORTH Ui getUiEngineInstance 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 die net rim device api system Display Klasse 2 RufenSienet rim device api system Display getOrientation auf int orientation Display getOrientation Schranken Sie die Richtung des Touchscreens ein 1 Importieren Sie die folgenden Klassen e net rim device api ui Ui e net rim device api ui UiEngineInstance 2 RufenSienet rim device api ui Ui getUiEngineInstance auf UiEngineInstance _ue _ue Ui getUiEngineInstance 3 RufenSienet rim device api ui UiEngineInstance setAcceptableDirections byte flags auf und geben Sie das Argument f r die Richtung von Screen weiter _ue setAcceptableDirections Display DIRECTION WEST Benachrichtigen lassen wenn sich die Gr e des Zeichenbereichs auf dem Touchscreen ndert 1 Importieren Sie die folgenden Klassen 17 Entwicklung
183. oder h her verwenden um eine BlackBerry Ger teanwendung zu erstellen k nnen Sie die Anwendung aktivieren damit sie die Aktion identifizieren kann die der BlackBerry Ger tebenutzer auf dem Touchscreen durch Erweitern der net rim device api ui Screen Klasse der net rim device api ui Field Klasse oder einer der Unterklassen der Field Klasse und das Uberschreiben der touchEvent Methode ausf hrt Innerhalb der touchEvent Methode vergleichen Sie den Wert den TouchEvent getEvent an die Konstanten von der net rim device api ui TouchEvent Klasse und der net rim device api ui TouchGesture Klasse aus zur ckgibt Die TouchEvent Klasse enth lt die Konstanten die die verschiedenen Aktionen darstellen die ein Benutzer auf dem Touchscreen ausf hren kann Zum Beispiel entsprechen Klick Ber hrungs und Bewegungsaktionen den TouchEvent CLICK TouchEvent DOWN und TouchEvent MOVE Konstanten Die TouchGesture Klasse enth lt die Konstanten die die verschiedenen Gesten darstellen die ein Benutzer auf einem Touchscreen ausf hren kann Zum Beispiel entsprechen Tipp und Fingerstrich Gesten den TouchGesture TAP und TouchGesture SWIPE Konstanten Codebeispiel Identifizieren der Aktion die ein Benutzer auf dem Touchscreen ausf hrt Im folgenden Codebeispiel wird eine switch Anweisung zur Identifizierung der Aktion verwendet 26 Entwicklungshandbuch Reagieren auf Touchscreen Ereignisse protected boolean touchEvent TouchEvent message
184. opThread SOD Crue if _paused If the thread is in a paused state wake it up this notify private final class DemoProgressIndicatorListener implements ProgressIndicatorListener public void cancelled _progressThread setPaused true public void resumed _progressThread setPaused false public void reset Not implemented 93 Entwicklungshandbuch Auswahltool ak void setNonProgrammaticValue int value Not implemented ee void configurationChanged Adjustment source Not implemented ee void valueChanged Adjustment source l Not implemented In der im BlackBerry Java SDK bereitgestellten Progress Indicator Demo Beispielanwendung wird eine Fortschrittsanzeige erstellt und ge ndert Auswahltool Sie k nnen Auswahlen verwenden um den Benutzern die einfache Auswahl von Elementen aus einer Liste zu erm glichen Auswahltyp Beschreibung Ablegen Mithilfe dieser Auswahl k nnen Benutzer ihr BlackBerry Ger t nach Dateien durchsuchen Yorr Shuffle Songs 03 Track 3 04 Dream A Little Dream 04 Track 4 05 Track 5 19 Track 19 Ort Mithilfe dieser Auswahl k nnen Benutzer einen von Ihnen definierten Ort bzw eine Position aus einer Liste ausw hlen Zum Beispiel k nnen Sie den Benutzern erm glichen ihre GPS Position oder einen vorher selektierten Ort auszuw hlen 94 Entwicklungshandbuch Auswahltyp Datum Uhrzeit Auswahltool Beschreib
185. portieren Sie dienet rim device api ui Screen Klasse 2 Verwalten Sie Navigationsereignisse durch Erweitern der net rim device api ui Screen Klasse oder einer ihrer Unterklassen und berschreiben Sie die folgenden Navigationsmethoden navigationClick int status int time navigationUnclick 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 die net rim device api system KeypadListener Schnittstelle Implementieren Sie die net rim device api system KeypadListener Schnittstelle Erweitern Sie die Screen Klasse die Field Klasse oder beide oP ww ON 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 dienavigationClick int status 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 KeypadListener STATUS TRACKWHEEL KeypadListener STATUS TRACKWHEEL Input came from the trackwheel else if status amp KeypadListener STATUS FOUR_WAY KeypadListener STATUS FOUR_WAY Input cam
186. rSensor 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 Beschleunigungssensordaten vom Puffer f r jede Achse abzurufen short xAccel short yAccel short zAccel accData getXAccHistory accData getYAccHistory accData getZAccHistory Ermitteln des Zeitpunkts des Abrufens eines Werts vom Beschleunigungssensor Importieren Sie dienet rim device api system AccelerometerData Klasse Fragen Sie Beschleunigungssensordaten aus dem Puffer ab AccelerometerData accData accData bufferedChannel getAccelerometerData Rufen Sie AccelerometerData getSampleTsHistory auf long queryTimestamps accData getSampleTsHistory 23 Entwicklungshandbuch Ereignisse Ereignisse So 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 Im
187. rem Bildschirm von einer beliebigen Benutzeroberfl chen Komponente zum Beispiel von Elementen in vollst ndigen Men s Schaltfl chen usw verwendet werden Da canExecute nicht implementiert ist ist dieser Befehl immer ausf hrbar Im folgenden Codebeispiel wird ein Dialogfeld angezeigt wenn der Benutzer auf einen Popup Men eintrag klickt 141 Entwicklungshandbuch Popup Men s class DialogCommandHandler extends CommandHandler public void execute ReadOnlyCommandMetadata metadata Object context Dialog alert Executing command for context toString Codebeispiel Erstellen eines Popup Men s import net rim device api command import net rim device api system 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 menu import net rim device api ui image import net rim device api util import java util public class MyPopUpMenuApp extends UiApplication public static void main String args MyPopUpMenuApp theApp new MyPopUpMenuApp theApp enterEventDispatcher public MyPopUpMenuApp pushScreen new MyPopUpMenuScreen class MyPopUpMenuScreen extends MainScreen EmailAddressEditField emailAddress public MyPopUpMenuScreen setTitle Pop Up Menu Demo setContextMenuProvider new DefaultContextMenuProvider LabelField labelField new LabelField Click to
188. rerer Bilder zum Scrollen 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api system import net rim device api ui import net rim device api ui component import net rim device api ui container WMO NSC FIM CAVIES 291 Wil ClEOIr F import net rim device api ui extension component 2 Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication Klasse Erstellen Sie unter main eine Instanz der neuen Klasse und rufen Sie enterEventDispatcher auf um die Anwendung f r das Empfangen von Ereignissen zu aktivieren Rufen Sie im Konstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene PictureScrollFieldDemoScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class PictureScrollFieldDemo extends UiApplication public static void main String args PictureScrollFieldDemo app new PictureScrollFieldDemo app enterEventDispatcher public PictureScrollFieldDemo pushScreen new PictureScrollFieldDemoScreen 125 Entwicklungshandbuch Anzeigen mehrerer Bilder zum Scrollen 3 126 Erstellen Sie das Framework f r den benutzerdefinierten Bildschirm durch Erweitern der MainScreen Klasse class PictureScrollFieldDemoScreen extends MainScreen public PictureScrollFieldDemoScreen Rufen Sie im Konstruktor setTitle auf um den Text festzule
189. rt im Untermen auch dann gro wenn es eine Pr position ist Verwenden Sie zum Beispiel Senden gt Als E Mail und nicht als E Mail e Vermeiden Sie den Begriff Mehr im vollst ndigen Men es sei denn dass die Position des Men eintrags verdeutlicht auf was sich Mehr bezieht Werden z B im vollst ndigen Men die Eintr ge Posteingang Postausgang und Mehr zwischen Trennzeichen angezeigt ordnen Sie die mit einer Mailbox verkn pften zus tzlichen Optionen in einem Untermen an Erstellen eines Untermen s Sie k nnen ein Untermen f r Ihre BlackBerry Ger teanwendung erstellen Ein Untermen wird angezeigt wenn ein Benutzer einen Men eintrag ausw hlt der mit einem Untermen verkn pft ist 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 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 Anwendungskonstruktor pushScreen auf um den benutzerdefinierten Bildschirm f r die Anwendung anzuzeigen Die in Schritt 3 beschriebene CreateSubmenuScreen Klasse stellt den benutzerdefinierten Bildschirm dar public class CreateSubmenu extends UiApplication public static void main
190. s 2 Unread Berry MVS Important BlackB Calendar 16 00 18 00 20 00 Sie k nnen Elemente unter Kopfzeilen anordnen damit die Benutzer einfacher durch lange Listen navigieren k nnen Zum Beispiel k nnen Sie Kopfzeilen erstellen die ausgeblendet werden wodurch die Benutzer die Elemente in der Liste einfacher finden k nnen 7100 C g keyboard 510 2004 keyboard 7730 7730 2004 keyboard Sie k nnen auch Elemente unter Kopfzeilen anordnen die immer am Anfang der Liste angezeigt werden Zum Beispiel k nnen Sie ein Datum als Kopfzeile hinzuf gen und unter der Kopfzeile die Nachrichten anordnen die an diesem Datum empfangen wurden Benutzer k nnen eine Kopfzeile markieren um eine Aktion f r die Gruppe der Elemente auszuf hren oder sie k nnen Tastenkombinationen verwenden um durch die Liste zu navigieren 78 Entwicklungshandbuch Listen und Tabellen Mon May 10 2010 B Hitoshi Hishikura 12 17 amp Joseph Venditti 12 16 Hearts a ni ns Marc Gervais 12 13 Tonight s game B Megan Acheson 12 13 Upcoming interview B Ahmed Farrakha 12 11 Welcome back Wed May 5 2010 gi O KA A ZS Benutzer k nnen die folgenden Aktionen in Listen und Tabellen ausf hren BlackBerry Ger te mit Touchscreen und Aktion BlackBerry Ger te nur mit Trackpad Trackpad Durch die Elemente der Liste Fahren Sie mit einem Finger senkrecht e Ziehen Sie einen Finger senkrecht scrollen ber das
191. s zum Beispiel e Klicken und halten Sie mit dem das Anrufen eines Kontakts Trackpad Sie k nnen Inhalte in Ihrer Anwendung registrieren damit diese in den Suchergebnissen aufgenommen werden k nnen Sie k nnen au erdem Ihre Anwendung registrieren um den Benutzern die M glichkeit zu geben ihre Suche zu erweitern Wenn die Benutzer zum Beispiel nach einem Lied in der Medienanwendung suchen und das Lied dort nicht finden k nnen Sie den Benutzern das Durchsuchen Ihrer Anwendung erlauben und so eine alternative Quelle f r die Suchergebnisse bereitstellen Weitere Informationen zum Registrieren von Inhalten oder einer Anwendung finden Sie im BlackBerry Java Application Integration Development Guide Bew hrtes Verfahren Implementieren von Suchfunktionen e Verwenden Sie das net rim device api unifiedsearch Paket um Suchfunktionen zu implementieren e Selektieren Sie gezielt die Inhalte die Sie zur Anzeige in den Suchergebnissen registrieren Registrieren Sie nur die Inhalte die den Benutzern bedeutungsvolle Suchergebnisse bereitstellen e Versuchen Sie die relevantesten Elemente am Anfang der Suchergebnisliste anzuzeigen Wenn Benutzer beispielsweise ein Restaurant suchen das an mehreren verschiedenen Standorten zu finden ist zeigen Sie am Anfang der Suchergebnisliste das Restaurant an das sich am n chsten zum Benutzerstandort befindet e Markieren Sie in den Suchergebnissen den Text in Fettschrift der mit dem vom Benutzer eingegebenen
192. s Standardelement wird in der Mitte des Rasters hervorgehoben angezeigt wenn der BlackBerry Ger tebenutzer das Popup Men ffnet Die anderen Elemente werden im Popup Men in der Reihenfolge positioniert in der Sie sie hinzuf gen Wenn die Anzahl der im Popup Men hinzugef gten Elemente Zellen im Raster frei lassen werden dem Men F llelemente hinzugef gt Das erste F llelement ist eine Option zum Wechseln von Anwendungen Das zweite F llelement ist eine Option zum Zur ckkehren zur Startseite 137 Entwicklungshandbuch Popup Men s Unterst tzung f r ltere Kontextmen s Seit BlackBerry Java SDK 6 0 wird das Kontextmen oder das kurze Men einer Anwendung in ein Popup Men umgewandelt Unabh ngig davon ob Sie Men eintr ge zu einem Kontextmen hinzugef gt oder die einem Kontextmen standardm ig zugef gten Elemente verwendet haben muss Ihr Code nicht ge ndert werden um diese Elemente stattdessen in einem Popup Men anzuzeigen BlackBerry Java SDK 6 0 enth lt jedoch Klassen und Schnittstellen die Sie zum Erstellen von Popup Men s verwenden k nnen sowie das Command Framework API mit dem Sie den Code modularer aufbauen k nnen Wenn Ihre Anwendung zum Beispiel eine Benutzeroberfl chenkomponente und ein Men eintrag enth lt der die gleiche Funktion ausf hrt k nnen Sie diesen Funktions Code mithilfe des Command Framework APIs einmal erfassen und in der gesamten Anwendung sowie in anderen Anwendungen
193. s die Benutzer in den Elementen der Liste blattern zum Beispiel in einer Nachrichtenliste oder einem Feed weisen Sie Tastenkombinationen zu um zum n chsten oder vorherigen Listenelement zu gelangen Wenn m glich erlauben Sie es den Benutzern der deutschen Version mit W zum n chsten Listenelement und mit Z zum vorherigen Listenelement zu gelangen Erstellen eines Listenfelds Verwenden Sie ein Listenfeld um eine Liste anzuzeigen aus der Benutzer eine oder mehrere Werte ausw hlen k nnen 1 80 Importieren Sie die folgenden Klassen import net rim device api system WMOOIrE NSE Wi CEviee eyo Wil import net rim device api ui component import net rim device api ui container import java util Vector Erstellen Sie das Anwendungsframework durch Erweitern der UiApplication 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 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 Erstellen Sie den benutzerdefinierten Bil
194. s ein uesssessesessenssssssnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnn Benachrichtigen lassen wenn sich die Gr e des Zeichenbereichs auf dem Touchscreen ndert Beschleunleungssensat une alien Arten von Beschleunigungssensor Daten cccccccssssssssscccccscassssansccecessssssesneessseceeecassesaaneeseceeesessssauensseeeseaees Abrufen von Beschleunigungssensordaten cccccccssssccccssssceccesssseeeccsssseeccesssseecccssseeeceseaseeesessaseeseeeesueeeeensaes Abrufen der Beschleunigungssensordaten in bestimmten AbDStanden ccccccsccccccssssseceeessssseeeecesssseeeeeeeees Abfragen des Beschleunigungssensors wenn sich die Anwendung im Vordergrund befindet Abfragen des Beschleunigungssensors wenn sich die Anwendung im Hintergrund befindet Speichern der ausgelesenen Beschleunigungssensorwerte in einem Puffer uessessssssssnensennnenssnnnennennnenennnn Abrufen von Beschleunigungssensordaten aus einem PUPFEL ccccccccecessscecceessseeeceseseeeecesssseeceeesaeeeeeeeses Ermitteln des Zeitpunkts des Abrufens eines Werts vom BeschleunigungsSensol ccccccccessssssseceeesssssseeees Erelonisse nie nee Reagierenauf Navigationsereignisse Bestimmen der Art der Eingabemethode Modelle f r Touchscreen Interaktionen cccccssccccesseeceseseeeceesneeeeseseeeesseeeeeeseeeeseeaeeeeeeeaeeeeeeeueeeseneeeenenaeeeeee Reagieren auf TOUCHSCEEN EFCISMISSC iss cecs
195. s mithilfe eines Befehls Der Befehl fungiert als Proxy zu einer Befehlsverarbeitungs Instanz die die Funktionalit t des Popup Men eintrags definiert So k nnten Sie beispielsweise Befehlselemente f r eine E Mail Adresse bereitstellen um einen Kontakt in Abh ngigkeit davon ob die ausgew hlte E Mail Adresse in der Kontaktliste des Benutzers vorhanden ist hinzuzuf gen oder anzuzeigen Die Befehlsverarbeitung w rde den Code enthalten um den Kontakt hinzuzuf gen oder anzuzeigen Weitere Informationen zu Befehlen und zur Befehlsverarbeitung finden Sie unterCommand Framework API In der im BlackBerry Java SDK bereitgestellten Command Framework Beispielanwendung werden Befehle und Befehlsverarbeitungen veranschaulicht Wenn Sie ein lteres Kontextmen verwenden konvertiert BlackBerry Device Software Device Software 6 0 die Kontextmen eintr ge in Befehlselemente und stellt diese dem Lieferant der Befehlselemente zur Verf gung Weitere Informationen finden Sie unterUnterst tzung f r ltere Kontextmen s Erstellen eines Popup Men s 1 Importieren Sie die erforderlichen import net import net import net import net rim device rim device rim device rim device api api api api Klassen und Schnittstellen command system sli oe ui component 139 Entwicklungshandbuch Popup Men s import net rim device api ui container import net rim device api ui menu import net rim device
196. se AbsoluteFieldManager manager new AbsoluteFieldManager 51 Entwicklungshandbuch Anzeigen eines Felds an einer absoluten Position auf dem Bildschirm 5 Erstellen und initialisieren Sie im Bildschirmkonstruktor eine Variable um die Y Koordinate zu speichern die der vertikalen Mitte des Bildschirms entspricht int halfwayDown Display getHeight 2 6 Rufen Sie im Bildschirmkonstruktor AbsoluteFieldManager add auf um an der vertikalen Mitte des Bildschirms ein LabelField Objekt mit einem X Koordinatenwert von 2 hinzuzuf gen manager add new LabelField Hello world 2 halfwayDown 7 Rufen Sie im Bildschirmkonstruktor add auf um dem Bildschirm AbsoluteFieldManager hinzuzuf gen add manager Codebeispiel Anzeigen einer Bezeichnung an einer absoluten Bildschirmposition import net rim device api system Impor Net hal MadevaGe apie ug import net rim device api ui container import net rim device api ui component public class AbsoluteFieldManagerDemo extends UiApplication public static void main String args AbsoluteFieldManagerDemo app new AbsoluteFieldManagerDemo app enterEventDispatcher public AbsoluteFieldManagerDemo pushScreen new AbsoluteFieldManagerDemoScreen class AbsoluteFieldManagerDemoScreen extends MainScreen public AbsoluteFieldManagerDemoScreen setTitle AbsoluteFieldManager Demo AbsoluteFieldManager manager new AbsoluteFieldManager
197. shandbuch Festlegen des Formats und der Richtung des Bildschirms e javax microedition Lcdui Canvas e net rim device api ui component Dialog 2 Erweitern Sie javax microedition 1lcdui Canvas 3 Uberschreiben Sie Canvas sizeChanged int int protected void sizeChanged int w int h Dialog alert The size of the Canvas has changed 18 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 X Y und Z Achse wahrnehmen Ein Ger tebenutzer kann die Ausrichtung des Ger ts ndern das die Bildschirmrichtung von einem Bildschirm f r eine BlackBerry Ger teanwendung aus zwischen Hoch und Querformat ndern kann Sie k nnen die Accelerometer APIs im net 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 eines sich bewegenden Objekts auf dem Bildschirm zu ndern w hrend ein Benutzer das BlackBerry Ger t mit verschiedenen Geschwindigkeiten bewegt und dreht Um eine Beispielanwendung herunterzuladen die die Verwendung des Beschleunigungssensors vera
198. ss newButtonField extends ButtonField berpr fen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode ob ein TouchGesture TAP Ereignis vorliegt und ob TouchGesture getTapCount 2 zur ckgibt protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent GESTURE TouchGesture gesture message getGesture switch gesture getEvent case TouchGesture TAP if gesture getTapCount 2 Dialog alert Double tap occurred FEwrUFM Erue return false 31 Entwicklungshandbuch Reagieren auf Touchscreen Ereignisse Reagieren auf einen Benutzer der ein Element auf dem Bildschirm ber hrt und zieht 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 Erstellen Sie eine Klasse die die Manager Klasse die Screen Klasse die Field Klasse oder eine der Field Unterklassen erweitert public class newButtonField extends ButtonField Rufen Sie in Ihrer Implementierung der touchEvent TouchEvent message Methode TouchEvent getEvent auf Pr fen Sie ob der Wert den TouchEvent getEvent zur ckgibt gleich TouchEvent MOVE ist protected boolean touchEvent TouchEvent message switch message getEvent case TouchEvent MOVE Dialog alert Move event occurred return true return false
199. sssseceeessssecccessseecceessecceesaseeeesseeeeees 61 Anzeigen von HTML Inhalten von einer Webseite in einem Browserfeld cccccccccccccssscceesssssececsseeees 63 Anzeigen von HTML Inhalten aus einer Ressource in Ihrer ANW NdUNG ccccceccesssseceeecesesstsseeeeeeeseeees 64 Konfigurieren eines Browserfeldes u seen euer 66 Senden von Formulardaten an eine Webadresse in einem Browserfeld 67 Dialogfelder 4uu nein E E une 69 Bew hrtes Verfahren Implementieren von Dialogfeldern cccccccccesscccccesssseccesessseeceessseeeeceessseeeeessaaees 70 Erstellen eines Dialogfelds ccccccccccccccsssssssseeescescesesseeeeeceseeeeeseeeeeeeeeseeeesseeeeeeseeeeesseeeeeeeeseeeesaseeeseeees 72 Dropdown listen csssssassnssigenesenne inann engen nt nenne E ce nenn an cute anne indeusssusachees E E 72 Bew hrtes Verfahren Implementieren von Dropdown Listen ccccccccccsssscceessssececesssseeeeesseeeeeessaees 73 Erstellen einer Dropdown Liste 74 BEZGICMMUM BOING ctcces vs lt cesseurscecwacecehadeaseangocaczwosteasetianeasantedvaaeenawesconaedeansaucwacaactedesasdasecsccsnsbeacece tesenustetecncteceonsexes eas 76 Bew hrtes Verfahren Implementieren von BeZeichnUngen cccccccssssccccessssseecccessseeeceesseseeeeeessaaaes 76 Erstelleneines Textetiketts naen eine nee nenne ehren renden ade andern 76 listem und Tabelle mkaa eae a a E E e a EE aAA EERIE ERRA AA EEEE a AE AE AEE EEA 77 Bew hrtes Verfahren Imple
200. stem AccelerometerSensor Channel e net rim device api system AccelerometerSensor 2 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 20 Entwicklungshandbuch Abfragen des Beschleunigungssensors wenn sich die Anwendung im Vordergrund befindet 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 rawDataChannel 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 1 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
201. t net rim device api ui container 2 Erstellen Sie ein Bild das Animations Frames enth lt und f gen Sie es Ihrem Projekt hinzu Das Bild muss aus einer Reihe von horizontal angeordneten Animations Frames bestehen Die Bildbreite muss der Breite eines Frames multipliziert mit die Anzahl der Frames entsprechen Zum Beispiel verf gt das folgende Bild ber f nf gleich gro e Frames o ee oo oo e ee oo s gt e oe 3 Erstellen Sie aus dem Bild eine Bitmap Bitmap bitmap Bitmap getBitmapResource spinner png 4 Erstellen Sie ein ActivityIndicatorView Objekt Sie k nnen einen Stil f r die Ansicht im Konstruktor festlegen 87 Entwicklungshandbuch Aktivitats und Fortschrittsanzeigen ActivityIndicatorView view new ActivityIndicatorView Field USE ALL WIDTH Um einen Manager zur Verwendung von Layout und Fokus festzulegen geben Sie beim Erstellen der ActivityIndicatorView ein zweites Argument an Wenn Sie keinen Manager festlegen wird ein VerticalFieldManager Objekt verwendet 5 Erstellen Sie ein Modell und einen Controller ActivityIndicatorModel model new ActivityIndicatorModel ActivityIndicatorController controller new ActivityIndicatorController 6 Verbinden Sie die Ansicht das Modell und den Controller view setController controller view setModel model controller setModel model controller setView view model setController controller 7 Erstellen Sie das Feld das die Aktivit t aus dem Bi
202. tCommand request c Verwenden Sie den Befehl Das folgende Beispiel f hrt den Befehl in Abh ngigkeit vom Kontext aus command execute context context is the context object Codebeispiele Zwei Beispielanwendungen die das Command Framework API verwenden sind im BlackBerry Java SDK enthalten 42 Command Framework Demo Remote App veranschaulicht wie ein Befehl erstellt und in der globalen Registry zur Verwendung in anderen Anwendungen gespeichert wird Command Framework Demo veranschaulicht wie Befehle erstellt in der lokalen Registry gespeichert und als Men eintr ge in Popup Men s f r Felder in Abh ngigkeit zum Feldinhalt hinzugef gt werden Diese Beispielanwendung f hrt au erdem einen Befehl aus der von der Beispielanwendung Command Framework Demo Remote App in der globalen Registry gespeichert wird Entwicklungshandbuch Anordnen von Anordnen von Benutzeroberflachenkomponenten Benutzeroberflachenkomponenten Sie k nnen die Benutzeroberflachenkomponenten auf einem Anwendungsbildschirm mit dem BlackBerry Layout Manager API anordnen Die folgenden Klassen erweitern die im net rim device apu ui Paket bereitgestellte Manager Klasse und stellen vordefinierte Layouts f r die Benutzeroberfl chenkomponenten auf dem Bildschirm Ihrer Anwendung bereit Layout Manager FlowFieldManager HorizontalFieldManager VerticalFieldManager Beschreibung Dieser Layout Manager ordnet Benutzeroberfl chenkomponente
203. tener f r die Dateiauswahl zu registrieren Rufen Sie show auf um die Dateiauswahl auf dem Bildschirm anzuzeigen class FilePickScreen extends MainScreen public FilePickScreen Seen el Ga elem ralGleiga sam piliens x add new LabelField Trying File Picker UiApplication getUiApplication invokeLater new Runnable public void run FilePicker fp FilePicker getInstance FilePickListener fileListener new FilePickListener Tpesek alstenernthulelsistenen s fp show DE 6 Rufen Sie Dialog alert auf um ein Dialogfeld mit einer Meldung zu erstellen die anzeigt welche Datei ausgew hlt wurde Rufen SieDialog alert in einer Klasse auf die die FilePicker Listener Schnittstelle durch berschreiben von selectionDone implementiert Die Anwendung ruft selectionDone auf wenn der Benutzer mithilfe der Dateiauswahl eine Datei ausw hlt 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 impotene erimedevileerapizunseontannege gt impon MNCs CAVITIES 291 TO public class FilePick extends UiApplication public static void main String args 100 Entwicklungshandbuch Suche FilePick theApp new FilePick theApp enterEventDispatcher
204. tmap ausgibt view createActivityImageField bitmap 5 Field FIELD_HCENTER In diesem Beispiel besteht das Bitmap aus f nf Frames und wird im Manager der Ansicht zentriert angezeigt 8 F gen Sie Ihrem Bildschirm die Ansicht hinzu add view 9 Steuern Sie die Aktivit tsanzeige indem Sie bei Bedarf das Modell der Ansicht steuern Menultem _stopIndicator new Menultem Stop spinner 66000 0 public void run view getModel cancel IE Menultem _resumeIndicator new Menultem Resume spinner 66010 0 public void run view getModel resume I Dieses Beispiel ruft die cancel Methode des Modells auf um die Animation anzuhalten Das Beispiel ruft die resume Methode des Modells auf um die Animation wieder aufzunehmen Codebeispiel public class ActivityIndicatorScreen extends MainScreen 88 ActivityIndicatorView view new ActivityIndicatorView Field USE_ALL WIDTH ActivityIndicatorModel model new ActivityIndicatorModel ActivityIndicatorController controller new ActivityIndicatorController public ActivityIndicatorScreen Entwicklungshandbuch Aktivitats und Fortschrittsanzeigen setTitle Activity Indicator Demo view setController controller view setModel model controller setModel model controller setView view model setController controller Define the indicator image and create a field from it Bitmap bitmap Bitmap getBitmapResource spinner png vie
205. try Read the image data into the byte array input read data Treaitche GOEXGepitaonme im Handle exception EEY EncodedImage image EncodedImage createEncodedImage data 0 data length catch IllegalArgumentException iae System out printin Image format not recognized 121 Entwicklungshandbuch Anzeigen eines Bilds zum Vergr ern Verkleinern und Schwenken Anzeigen eines codierten Bilds 1 Importieren Sie die erforderliche Klasse import net rim device api ui component BitmapField 2 Rufen Sie BitmapField setImage auf um das codierte Bild einem BitmapField zuzuweisen 3 Rufen Sie add auf um dem Bildschirm das BitmapFieeld hinzuzuf gen BitmapField field new BitmapField field setlImage image add field Festlegen der Anzeigegr e eines codierten Bilds 1 Importieren Sie die erforderliche Klasse import net rim device api system EncodedImage 2 Rufen Sie EncodedImage scalelmage32 int scaleX int scaleY auf Die bergebenen Skalierungswert Parameter m ssen net rim device api math Fixed32 Zahlen sein 0 lt Skalierung lt 1 f r das Hochskalieren und Skalierung gt 1 f r das Herunterskalieren scaleImage32 erstellt ein neues EncodedImage statt das aktuelle Bild zu ndern Festlegen des Decodierungsmodus fir ein Bild 1 Importieren Sie die erforderliche Klasse import net rim device api system EncodedImage 2 Rufen Sie EncodedImage setDecodeMode auf und verwenden
206. tyle 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 Field setExtent int int Sie auf um die erforderlichen Dimensionen f r das Feld festzulegen protected void layout int width int height _font getFont _labelHeight _font getHeight _labelWidth _font getAdvance _label width Math min width getPreferredWidth height Math min height getPreferredHeight setExtent width height 6 Implementieren Sie getPreferredWidth 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 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
207. uchscreen k nnen Sie Schaltfl chen f r kritische Aktionen verwenden Verwenden Sie Kontrollk stchen f r Optionen z B zum Ein und Ausschalten einer Funktion Verwenden Sie die ButtonField Klasse um Schaltfl chen zu erstellen 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 Richtlinien f r Bezeichnungen 54 Verwenden Sie kurze klare Bezeichnungen 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 zeigt ein Auslassungspunkt an dass der Text abgeschnitten ist Verwenden Sie f r Bezeichnungen Verben die die verkn pfte Aktion beschreiben zum Beispiel Abbrechen L schen Verwerfen oder Speichern Falls erforderlich f gen Sie weitere Beschreibungen anderswo auf dem Bildschirm hinzu zum Beispiel in einer Anwendungsnachricht Vermeiden Sie die Verwendung der Bezeichnungen Ja und Nein 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 Entwicklungshandbuch Kontrollk stchen Erstellen einer Schaltfl che 1 I
208. uf um den Titel f r den Bildschirm anzugeben class MyUiScreen extends MainScreen public MyUiScreen setTitle UI Component Sample Erstellen Sie im Bildschirmkonstruktor mithilfe der DateField Klasse ein Datumsfeld Stellen Sie System currentTimeMillis als Parameter bereit um die aktuelle Uhrzeit zur ckzugeben Verwenden SiedenDateField DATE_TIME Stil um sowohl das Datum als auch die Uhrzeit anzuzeigen Sie k nnen andere Stile verwenden um nur das Datum oder nur die Uhrzeit anzuzeigen add new DateField Date System currentTimeMillis DateField DATE_TIME Erstellen eines Kennwortfelds 118 Importieren Sie dienet rim device api ui component PasswordEditField Klasse 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 pwd new PasswordEditField PasswordEditField Entwicklungshandbuch Strukturansichten Strukturansichten Verwenden Sie eine Strukturansicht um Objekte z B Ordner in einer hierarchischen Weise anzuzeigen Objekte in der Strukturansicht sind Knoten Der oberste Knoten ist der Stammknoten Ein Knoten im Baum kann ber untergeordnete Knoten verf gen Ein Knoten der ber einen untergeordneten Knoten verf gt ist ein bergeordneter Knoten Benutzer k nnen in einer Strukturansicht die folgende Aktion ausf
209. ung Chnnse Inratinn Select Location Enter location My current location Find on a map Mithilfe dieser Auswahl k nnen Benutzer einen bestimmten Tag Monat oder ein bestimmtes Jahr ausw hlen Zum Beispiel k nnen Sie den Benutzern erm glichen einen Monat und ein Jahr auszuw hlen um anzugeben wann ihre Kreditkarte abl uft 12 21 PM Send Using lDesktop Subject New appointment Location OK Cancel Eastern Time 5 v Mithilfe dieser Auswahl k nnen Benutzer eine bestimmte Stunde Minute oder Sekunde ausw hlen 95 Entwicklungshandbuch Auswahltyp Beschreibung Auswahltool Bew hrtes Verfahren Implementieren von Auswahlen Verwenden Sie die Klassen FilePicker LocationPickerund DateTimePicker um Auswahlen zu erstellen Richtlinien f r Dateiauswahlen e _ Legen Sie eine bestimmte Ansicht fest um die Dateitypen anzuzeigen die mit dem Ziel des Benutzers bereinstimmen Wenn ein Benutzer beispielsweise Bilder durchsucht zeigen Sie in der Dateiauswahl Bilder an e Wenn m glich erlauben Sie es den Benutzern das Durchsuchen von einem entsprechenden Standardordner aus zu starten Erstellen einer Datumsauswahl 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import import import import import net rim device net rim device net rim device net rim device JAVA VETS api api api api Wis ail si ail component
210. urch 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 Leichtes Ber hren des Bildschirms Tippen auf den Bildschirm Zweimaliges Tippen auf den Bildschirm Den Finger auf einem Element halten Ergebnis 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 In Anwendungen die eine Vollbildanzeige unterst tzen wie z B BlackBerry Maps und BlackBerry Browser wird durch diese Aktion die Shortcut Leiste verborgen bzw angezeigt In einer Webseite Karte Bild oder Pr sentationsanlage zoomt diese Aktion in die jeweilige Webseite Karte Bild oder Pr sentationsanlage Durch diese Aktion wird auf der Shortcut Leiste ein QuickInfo angezeigt das die Aktion beschreibt die das Symbol darstellt Entwicklungshandbuch Aktion 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 ei
211. utzerdefinierten Schriftart in einer BlackBerry Java Anwendung 149 Codebeispiel Installieren und Verwenden einer benutzerdefinierten Schriftart in einer BlackBerry Java ANWENdUNB m tee ssavedecddecceuaicaabtonds valecease an rennen naeh sided exter a RE 150 12 RECM CNED NTUN cs ce saa ceiacsenidacesacitessxaazcees seen 152 Hinzuf gen einer Funktion zur RechtschreibprufUng ccccssssscccccesccssssssseceececceesseeesssseeeeeecesseeesessaaeeeeees 152 Empfangen von RechtschreibprufUungsereignisSen cccccccccssssccccccccsssssceeecccecsessseeesecesecsssseeeeeeseeesaeeeeeseeeeeea 153 13 Verwandte Ressoureen san ssiss ee ee 154 Gere A rar Haaesr user marten AA Meee 155 15 R ckmeldung ee ee ee 156 16 Verlauf Ger Do kumeantrevlSiOM een 157 cD ANS Ul Soe egg at ol otc See ere Ee emer EUR et oct E CE RE E eg EE EET EMTALA rege TST 159 Entwicklungshandbuch Erstellen einer Benutzeroberflache die mit den standardm igen BlackBerry Benutzeroberfl chen vertr glich ist Erstellen einer Benutzeroberfl che die mit den ME standardm igen BlackBerry Benutzeroberfl chen vertr glich ist Mithilfe der Standard MIDP APIs und der BlackBerry Benutzeroberfl chen APIs k nnen Sie eine Benutzeroberfl che f r die BlackBerry Java Application erstellen Die Benutzeroberflachen Komponenten in den BlackBerry Benutzeroberfl chen APlIs wurden daf r entworfen Layouts und Verhaltensweisen bereitzustellen die den BlackBerry De
212. vice Software Anwendungen entsprechen Wenn Sie diese APIs nutzen k nnen Sie zum einen Komponenten verwenden mit denen BlackBerry Benutzer vertraut sind und zum anderen Zeit sparen da Sie diese Komponenten nicht selbst erstellen m ssen e _ Bildschirmkomponenten k nnen ein Standardbildschirmlayout ein Standardmen und ein Standardverhalten bereitstellen wenn ein BlackBerry Ger tebenutzer die Esc Taste dr ckt mit dem Trackpad klickt oder den Touchscreen ber hrt e _ Feldkomponenten k nnen die standardm igen Benutzeroberflachenelemente f r die Datumsauswahl Optionsschaltfl chen Kontrollk stchen Listen Textfelder Bezeichnungen und Fortschrittsanzeigen bereitstellen e _ Layout Manager k nnen einer Anwendung die M glichkeit geben die Komponenten auf standardm ige Weise auf einem BlackBerry Ger tebildschirm anzuordnen z B horizontal vertikal oder von links nach rechts Mithilfe der BlackBerry Benutzeroberflachen APls k nnen Sie eine Benutzeroberfl che mit Tabellen Rastern und anderen speziellen Funktionen erstellen Sie k nnen ein standardm iges Java Ereignismodell verwenden um bestimmte Ereignisarten zu empfangen und auf diese zu antworten Eine BlackBerry Ger teanwendung kann Benutzerereignisse z B wenn der Benutzer mit dem Trackpad klickt oder Eingaben ber die Tastatur vornimmt sowie Systemereignisse z B globale Warnungen Uhrzeit nderungen und USB Anschlussverbindungen empfangen und auf sie antworte
213. void close Dialog alert You selected String spinBoxDays get spinBoxDays getSelectedIndex and String spinBoxMonths get spinBoxMonths getSelectedIndex super close 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 igen 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 Komponenten auf dem Bildschirm angezeigt werden e Verwenden Sie die Klassen SpinBoxField und SpinBoxFieldManager um Drehfelder zu erstellen e F gen Sie Drehfelder m glichst Dialogfeldern statt Bildschirmen hinzu e Wenn Benutzer ein Drehfeld markieren zeigen Sie drei bis f nf Elemente bereinander an 114 Entwicklungshandbuch Textfelder e Verwenden Sie ein erkennbares Muster f r die Abfolge der Elemente zum Beispiel 5 10 15 damit Benutzer absch tzen k nnen wie weit sie scrollen m ssen um das Zielelement zu finden e Vermeiden Sie Benutzer horizontal scrollen zu lassen um mehrere Drehfelder anzuzeigen Unterteilen Sie Drehfelder falls notwendig in mehrere Felder e Wenn der Text in einem Drehfeld zu lang ist verwenden Sie Auslassungspunkte Textfelder Benutz
214. w createActivityImageField bitmap 5 Field FIELD_HCENTER add the view to the screen add view Menultem _stopIndicator new Menultem Stop spinner 66000 0 public void run Ws MenuItem _resumeIndicator new MenuItem Resume spinner 66010 0 view getModel cancel public void run Ie addMenultem _stopIndicator addMenultem _resumelndicator view getModel resume In der im BlackBerry Java SDK bereitgestellten Progress Indicator Demo Beispielanwendung werden eine Reihe von Aktivit tsanzeigen einschlie lich des oben angezeigten Drehfelds erstellt und ge ndert Anzeigen des Fortschritts Sie k nnen ein Feld in Ihrer BlackBerry Ger teanwendung anzeigen das darauf hinweist dass eine Aufgabe ausgef hrt wird Der Fortschritt wird durch eine Leiste dargestellt die sich w hrend der Aufgabenausf hrung f llt bis die Aufgabe abgeschlossen ist 1 Importieren Sie die erforderlichen Klassen und Schnittstellen import net rim device api ui import net rim device api ui container import net rim device api ui component progressindicator Erstellen Sie ein ProgressIndicatorView Objekt Sie k nnen einen Stil f r die Ansicht im Konstruktor festlegen Im folgenden Beispiel ist kein Stil festgelegt ProgressIndicatorView view new ProgressIndicatorView Um einen Manager zur Verwendung von Layout und Fokus festzulegen geben Sie beim Erstellen der ProgressIndicatorVi
215. wenden und einen Layout Manager hinzuf gen 11 Entwicklungshandbuch Verwalten eines Zeichenbereichs Class Beschreibung 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 Standardmenti mit einem Men element Schlie en e Standardmafige 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 eines MainScreen 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 diegesamte Zeichenoberfl che dar die f r die BlackBerry Ger teanwendung verf gbar ist Um diesen Bereich zu begrenzen unterteilen Sie es in XYRect Objekte Jedes XYPoint stellt einen Punkt auf dem Bildschirm dar der sich aus einer X Koordinate und einer Y Koordinate zusammensetzt 1 12 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 Erstellen Sie XYPoint Objekte um den linken oberen Punkt und den rechten unteren Punkt eines R
216. zu erstellen protected void makeMenu Menu menu int instance SubMenu statusSubMenu new SubMenu null My Status 300 3 statusSubMenu add _status1 statusSubMenu add _status2 menu add statusSubMenu super makeMenu menu instance Wee Codebeispiel Erstellen eines Untermen s import net rim device api ui import net rim device api ui component import net rim device api ui container public class CreateSubmenu extends UiApplication public static void main String args CreateSubmenu theApp new CreateSubmenu theApp enterEventDispatcher public CreateSubmenu class CreateSubmenuScreen extends MainScreen pushScreen new CreateSubmenuScreen 134 Entwicklungshandbuch Popup Men s 100 1 200 2 public CreateSubmenuScreen setTitle Create Submenu Sample add new RichTextField Create a submenu private Menultem _statusl new Menultem Available public void run Dialog inform I m available he private Menultem _status2 new Menultem Unavailable public void run Dialog inform I m unavailable Ir protected void makeMenu Menu menu int instance SubMenu statusSubMenu new SubMenu null My Status 300 3 statusSubMenu add _statusl statusSubMenu add _status2 menu add statusSubMenu super makeMenu menu instance He Popup Men s Ein Popup Men bietet den Benutzern eine schnelle M gl
217. zur Verf gung stellen Ein Kontextmen eintrag enthielt eine Ordinalzahl die im Men die Platzierung des Elements festgelegt hat Um so niedriger die Ordinalzahl um so h her die Position des Elements im Men Wenn ein Kontextmen in ein Popup Men umgewandelt wird wird der Men eintrag mit der niedrigsten Ordinalzahl zum standardm igen Popup Men eintrag Die brigen Elemente werden zum Popup Men von der niedrigsten Ordinalzahl zur h chsten hinzugef gt Wenn ein Symbol mit einem Men eintrag des lteren Kontextmen s verkn pft war wird es f r das Element im Popup Men verwendet Andernfalls wird ein Standardsymbol verwendet hnlich zu anderen Popup Men s werden nur die ersten acht Kontextmen eintr ge im Popup Men angezeigt Wenn das Kontextmen mehr als acht Men eintr ge beinhaltet stellen Sie sicher dass Sie die Ordinalzahlen f r die Men eintr ge entsprechend verwenden damit die wichtigsten und n tzlichsten Elemente im Popup Men angezeigt werden Weitere Informationen zum Erstellen von Kontextmen s finden Sie im BlackBerry Developer Resource Center unter www blackberry com developer Lesen Sie hier den Artikel Distinguish between a full menu and a primary actions menu Erstellen eines Popup Men s Sie k nnen ein Popup Men mithilfe von Klassen erstellen deimnet rim device api ui menu Paketverf gbar sind Au erdem k nnen Sie die Funktionalit t der Popup Men eintr ge mithilfe des Command Framework AP

BlackBerry Java SDK - 6.0

Contents

Download Pdf Manuals

Related Search

Related Contents