michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.dialogs
michael@0: 
michael@0: Dieses Plugin ermöglicht den Zugriff auf einige native Dialog-UI-Elemente.
michael@0: 
michael@0: ## Installation
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.dialogs
michael@0:     
michael@0: 
michael@0: ## Methoden
michael@0: 
michael@0: *   `navigator.notification.alert`
michael@0: *   `navigator.notification.confirm`
michael@0: *   `navigator.notification.prompt`
michael@0: *   `navigator.notification.beep`
michael@0: 
michael@0: ## navigator.notification.alert
michael@0: 
michael@0: Zeigt eine benutzerdefinierte Warnung oder Dialogfeld Feld. Die meisten Implementierungen von Cordova ein native Dialogfeld für dieses Feature verwenden, aber einige Plattformen des Browsers `alert` Funktion, die in der Regel weniger anpassbar ist.
michael@0: 
michael@0:     Navigator.Notification.Alert (Message, AlertCallback, [Titel], [ButtonName])
michael@0:     
michael@0: 
michael@0: *   **Nachricht**: Dialogfeld Nachricht. *(String)*
michael@0: 
michael@0: *   **AlertCallback**: Callback aufgerufen wird, wenn Warnungs-Dialogfeld geschlossen wird. *(Funktion)*
michael@0: 
michael@0: *   **Titel**: Dialog "Titel". *(String)* (Optional, Standard ist`Alert`)
michael@0: 
michael@0: *   **ButtonName**: Name der Schaltfläche. *(String)* (Optional, Standard ist`OK`)
michael@0: 
michael@0: ### Beispiel
michael@0: 
michael@0:     function alertDismissed() {
michael@0:         // do something
michael@0:     }
michael@0:     
michael@0:     navigator.notification.alert(
michael@0:         'You are the winner!',  // message
michael@0:         alertDismissed,         // callback
michael@0:         'Game Over',            // title
michael@0:         'Done'                  // buttonName
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 und 8 Eigenarten
michael@0: 
michael@0: *   Es gibt keine eingebaute Datenbanksuchroutine-Warnung, aber Sie können binden, wie folgt zu nennen `alert()` im globalen Gültigkeitsbereich:
michael@0:     
michael@0:         window.alert = navigator.notification.alert;
michael@0:         
michael@0: 
michael@0: *   Beide `alert` und `confirm` sind nicht blockierende Aufrufe, die Ergebnisse davon nur asynchron sind.
michael@0: 
michael@0: ### Firefox OS Macken:
michael@0: 
michael@0: Beide Native blockierenden `window.alert()` und nicht-blockierende `navigator.notification.alert()` stehen zur Verfügung.
michael@0: 
michael@0: ## navigator.notification.confirm
michael@0: 
michael@0: Zeigt das Dialogfeld anpassbare Bestätigung.
michael@0: 
michael@0:     navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
michael@0:     
michael@0: 
michael@0: *   **Nachricht**: Dialogfeld Nachricht. *(String)*
michael@0: 
michael@0: *   **ConfirmCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)*
michael@0: 
michael@0: *   **Titel**: Dialog "Titel". *(String)* (Optional, Standard ist`Confirm`)
michael@0: 
michael@0: *   **ButtonLabels**: Array von Zeichenfolgen, die Schaltflächenbezeichnungen angeben. *(Array)* (Optional, Standard ist [ `OK,Cancel` ])
michael@0: 
michael@0: ### confirmCallback
michael@0: 
michael@0: Die `confirmCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Dialogfeld zur Bestätigung drückt.
michael@0: 
michael@0: Der Rückruf dauert das Argument `buttonIndex` *(Anzahl)*, die der Index der Schaltfläche gedrückt ist. Beachten Sie, dass der Index 1-basierte Indizierung, verwendet, sodass der Wert ist `1` , `2` , `3` , etc..
michael@0: 
michael@0: ### Beispiel
michael@0: 
michael@0:     function onConfirm(buttonIndex) {
michael@0:         alert('You selected button ' + buttonIndex);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.confirm(
michael@0:         'You are the winner!', // message
michael@0:          onConfirm,            // callback to invoke with index of button pressed
michael@0:         'Game Over',           // title
michael@0:         ['Restart','Exit']     // buttonLabels
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Windows Phone 7 und 8 Eigenarten
michael@0: 
michael@0: *   Es gibt keine integrierte Browser-Funktion für `window.confirm` , aber Sie können es binden, indem Sie zuweisen:
michael@0:     
michael@0:         window.confirm = navigator.notification.confirm;
michael@0:         
michael@0: 
michael@0: *   Aufrufe von `alert` und `confirm` sind nicht blockierend, so dass das Ergebnis nur asynchron zur Verfügung steht.
michael@0: 
michael@0: ### Firefox OS Macken:
michael@0: 
michael@0: Beide Native blockierenden `window.confirm()` und nicht-blockierende `navigator.notification.confirm()` stehen zur Verfügung.
michael@0: 
michael@0: ## navigator.notification.prompt
michael@0: 
michael@0: Zeigt eine native Dialogfeld, das mehr als des Browsers anpassbar ist `prompt` Funktion.
michael@0: 
michael@0:     navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
michael@0:     
michael@0: 
michael@0: *   **Nachricht**: Dialogfeld Nachricht. *(String)*
michael@0: 
michael@0: *   **PromptCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)*
michael@0: 
michael@0: *   **Titel**: Dialog Title *(String)* (Optional, Standard ist`Prompt`)
michael@0: 
michael@0: *   **ButtonLabels**: Array von Zeichenfolgen angeben Schaltfläche Etiketten *(Array)* (Optional, Standard ist`["OK","Cancel"]`)
michael@0: 
michael@0: *   **DefaultText**: Standard-Textbox Eingabewert ( `String` ) (Optional, Standard: leere Zeichenfolge)
michael@0: 
michael@0: ### promptCallback
michael@0: 
michael@0: Die `promptCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Eingabedialogfeld drückt. Die `results` an den Rückruf übergebene Objekt enthält die folgenden Eigenschaften:
michael@0: 
michael@0: *   **ButtonIndex**: der Index der Schaltfläche gedrückt. *(Anzahl)* Beachten Sie, dass der Index 1-basierte Indizierung, verwendet, sodass der Wert ist `1` , `2` , `3` , etc..
michael@0: 
michael@0: *   **Eingang1**: in Eingabedialogfeld eingegebenen Text. *(String)*
michael@0: 
michael@0: ### Beispiel
michael@0: 
michael@0:     function onPrompt(results) {
michael@0:         alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
michael@0:     }
michael@0:     
michael@0:     navigator.notification.prompt(
michael@0:         'Please enter your name',  // message
michael@0:         onPrompt,                  // callback to invoke
michael@0:         'Registration',            // title
michael@0:         ['Ok','Exit'],             // buttonLabels
michael@0:         'Jane Doe'                 // defaultText
michael@0:     );
michael@0:     
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Windows Phone 7 und 8
michael@0: 
michael@0: ### Android Eigenarten
michael@0: 
michael@0: *   Android unterstützt maximal drei Schaltflächen und mehr als das ignoriert.
michael@0: 
michael@0: *   Auf Android 3.0 und höher, werden die Schaltflächen in umgekehrter Reihenfolge für Geräte angezeigt, die das Holo-Design verwenden.
michael@0: 
michael@0: ### Firefox OS Macken:
michael@0: 
michael@0: Beide Native blockierenden `window.prompt()` und nicht-blockierende `navigator.notification.prompt()` stehen zur Verfügung.
michael@0: 
michael@0: ## navigator.notification.beep
michael@0: 
michael@0: Das Gerät spielt einen Signalton sound.
michael@0: 
michael@0:     navigator.notification.beep(times);
michael@0:     
michael@0: 
michael@0: *   **Zeiten**: die Anzahl der Wiederholungen des Signaltons. *(Anzahl)*
michael@0: 
michael@0: ### Beispiel
michael@0: 
michael@0:     // Beep twice!
michael@0:     navigator.notification.beep(2);
michael@0:     
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Amazon Fire OS Macken
michael@0: 
michael@0: *   Amazon Fire OS spielt die Standardeinstellung **Akustische Benachrichtigung** unter **Einstellungen/Display & Sound** Bereich angegeben.
michael@0: 
michael@0: ### Android Eigenarten
michael@0: 
michael@0: *   Android spielt die Standardeinstellung **Benachrichtigung Klingelton** unter **Einstellungen/Sound & Display** -Panel angegeben.
michael@0: 
michael@0: ### Windows Phone 7 und 8 Eigenarten
michael@0: 
michael@0: *   Stützt sich auf eine generische Piepton-Datei aus der Cordova-Distribution.
michael@0: 
michael@0: ### Tizen Macken
michael@0: 
michael@0: *   Tizen implementiert Signaltöne durch Abspielen einer Audiodatei über die Medien API.
michael@0: 
michael@0: *   Die Beep-Datei muss kurz sein, befinden muss einem `sounds` Unterverzeichnis des Stammverzeichnisses der Anwendung, und muss den Namen`beep.wav`.