RAD Studio - Benutzerbeiträge [de]

Ausfüllen der Bereitstellungsseite

2016-07-26T10:42:31Z

Esabatell: Updated. LOC-22918

{{Parent|Schritte bei der Entwicklung von geräteübergreifenden Anwendungen}}

Das Ausfüllen des '''Bereitstellungsprofils''' auf der Seite '''[[Bereitstellungsseite|Bereitstellung]]''' ist ein erforderlicher, vorbereitender Schritt bei:

* Der Weitergabe von Anwendungen für die Zielpattformen '''OS X''' und '''Android'''.
* Der Ausführung und der Weitergabe von Anwendungen für die Zielplattformen '''iOS-Gerät - 32 Bit''' und '''iOS-Gerät - 64 Bit'''.

Die erforderlichen Schritte hängen, wie in den folgenden Anleitungen gezeigt, vom Build-Typ ab, der eine Kombination einer [[Unterstützte Zielplattformen|Zielplattform]] und einer [[Übersicht über Zielplattformen#Verwenden des Konfigurationsknotens|Plattformkonfiguration]] ist.

:'''Hinweis:''' Sie können die Seite '''Bereitstellung''' entweder im Dialogfeld {{Menu|Tools-Optionen}} oder im Dialogfeld {{Menu|Projektoptionen}} öffnen:
:* In den {{Menu|Tools-Optionen}} können Sie die Werte festlegen, die {{Product}} verwendet, wenn Sie keinen Wert in den {{Menu|Projektoptionen}} angegeben haben.
:* Im Dialogfeld {{Menu|Projektoptionen}} können Sie Werte für das '''aktuelle Projekt''' festlegen.

==Erforderliche Schritte für bestimmte Build-Typen==

===OS X-Plattform===

# Öffnen Sie die Seite '''[[Bereitstellungsseite|Bereitstellung]]''' im Dialogfeld "Tools-Optionen" oder im Dialogfeld "Projektoptionen".
#: '''Hinweis:''' Beim Konfigurieren der Seite '''Bereitstellung''' im Dialogfeld "Projektoptionen" müssen Sie in der Dropdown-Liste '''Ziel''' die Plattform '''OS X''' auswählen.
# Wählen Sie '''OS X - Anwendungs-Store''' in der Dropdown-Liste '''Build-Typ''' aus.
# Geben Sie in das Feld '''Mac-Entwicklerzertifikat für Fremdhersteller''' den [[Bereitstellungsseite#Entwicklerzertifikat|Namen Ihres Mac-Entwickleranwendungszertifikats für Fremdhersteller]]. Zum Beispiel: <code> Mac-Entwickleranwendung für Fremdhersteller: Embarcadero Technologies...</code>
# Geben Sie in das Feld '''Mac-Installationszertifikat für Fremdhersteller''' den [[Bereitstellungsseite#Entwicklerzertifikat|Namen Ihres Mac-Entwicklerinstallationszertifikats für Fremdhersteller]]. Zum Beispiel: <code>Mac-Entwicklerinstallationsprogramm für Fremdhersteller: Embarcadero Technologies...</code>

===iOS-Geräteplattform (Entwicklung)===

# Öffnen Sie die Seite '''[[Bereitstellungsseite|Bereitstellung]]''' entweder im Dialogfeld {{Menu|Tools-Optionen}} oder im Dialogfeld {{Menu|Projektoptionen}}.
#: '''Hinweis:''' Beim Konfigurieren der Seite '''Bereitstellung''' im Dialogfeld {{Menu|Projektoptionen}} müssen Sie in der Dropdown-Liste '''Ziel''' die Plattform '''iOS-Gerät''' auswählen.
# Wählen Sie in der Dropdown-Liste '''Build-Typ''' entweder '''iOS-Gerät - 32 Bit - Entwicklung''' oder '''iOS-Gerät - 64 Bit - Entwicklung''' aus.
# Wählen Sie im Feld '''Bereitstellungsprofil''' <code>Auto</code> oder einen gültigen [[Bereitstellungsseite#Bereitstellungsprofil|Namen des Bereitstellungsprofils]] aus.
# Wählen Sie im Feld '''Entwicklerzertifikat''' <code>Auto</code> oder einen gültigen [[Bereitstellungsseite#Entwicklerzertifikat|Namen des Entwicklerzertifikats]] an.

===iOS-Geräteplattform (Ad-hoc)===

# Öffnen Sie die Seite '''[[Bereitstellungsseite|Bereitstellung]]''' entweder im Dialogfeld {{Menu|Projektoptionen}} oder im Dialogfeld {{Menu|Tools-Optionen}}.
#: '''Hinweis:''' Beim Konfigurieren der Seite '''Bereitstellung''' im Dialogfeld {{Menu|Projektoptionen}} müssen Sie in der Dropdown-Liste '''Ziel''' die Plattform '''iOS-Gerät''' auswählen.
# Wählen Sie in der Dropdown-Liste '''Build-Typ''' entweder '''iOS-Gerät - 32 Bit - Ad-hoc''' oder '''iOS-Gerät - 64 Bit - Ad-hoc''' aus.
# Wählen Sie im Feld '''Bereitstellungsprofil''' <code>Auto</code> oder einen gültigen [[Bereitstellungsseite#Bereitstellungsprofil|Namen des Bereitstellungsprofils]] aus.
# Wählen Sie im Feld '''Entwicklerzertifikat''' <code>Auto</code> oder einen gültigen [[Bereitstellungsseite#Entwicklerzertifikat|Namen des Distributionszertifikats]] aus.

===iOS-Geräteplattform (Anwendungs-Store)===

: '''Hinweis:''' Der App Store akzeptiert nur Anwendungsarchivdateien, die 64-Bit-iOS-Geräte unterstützen. Wenn Sie auch 32-Bit-iOS-Geräte unterstützen möchten, müssen Sie eine Anwendungsarchivdatei erzeugen, die 32-Bit- und 64-Bit-iOS-Geräte unterstützt. Siehe [[Bereitstellen von iOS-Anwendungen für die Übermittlung an den App Store#Unterstützen von 32-Bit-iOS-Geräten|Bereitstellen von iOS-Anwendungen für die Übermittlung an den App Store, Unterstützen von 32-Bit-iOS-Geräten]].

# Öffnen Sie die Seite '''[[Bereitstellungsseite|Bereitstellung]]''' entweder im Dialogfeld {{Menu|Tools-Optionen}} oder im Dialogfeld {{Menu|Projektoptionen}}.
#: '''Hinweis:''' Beim Konfigurieren der Seite '''Bereitstellung''' im Dialogfeld {{Menu|Projektoptionen}} müssen Sie in der Dropdown-Liste '''Ziel''' die Plattform '''iOS-Gerät''' auswählen.
# Wählen Sie '''iOS-Gerät - 64 Bit - Anwendungs-Store''' in der Dropdown-Liste '''Build-Typ''' aus.
# Wählen Sie im Feld '''Bereitstellungsprofil''' <code>Auto</code> oder einen gültigen [[Bereitstellungsseite#Bereitstellungsprofil|Namen des Bereitstellungsprofils]] aus.
# Wählen Sie im Feld '''Entwicklerzertifikat''' <code>Auto</code> oder einen gültigen [[Bereitstellungsseite#Entwicklerzertifikat|Namen des Distributionszertifikats]] aus.

===Android-Plattform (Anwendungs-Store)===

# Öffnen Sie die Seite '''[[Bereitstellungsseite|Bereitstellung]]''' entweder im Dialogfeld {{Menu|Projektoptionen}} oder im Dialogfeld {{Menu|Tools-Optionen}}.
#: '''Hinweis:''' Beim Konfigurieren der Seite '''Bereitstellung''' im Dialogfeld {{Menu|Projektoptionen}} müssen Sie in der Dropdown-Liste '''Ziel''' die Plattform '''Android''' auswählen.
# Wählen Sie '''Android - Anwendungs-Store''' in der Dropdown-Liste '''Build-Typ''' aus.
# Klicken Sie unter '''Keystore''' im Feld '''Datei''' auf '''...''', und wählen Sie dann eine vorhandene Keystore-Datei aus. Wenn Sie keine Keystore-Datei haben, klicken Sie auf '''Neuer Keystore''', um den Experten [[Neuen Keystore/Alias erstellen|Neuen Keystore/Alias erstellen]] zu öffnen und [[Erstellen einer KeyStore-Datei|eine Keystore-Datei zum Signieren zu erstellen]].
# Geben Sie das Passwort für die angegebene Keystore-Datei in das Feld '''Passwort''' ein.
# Wählen Sie im Feld '''Alias im Keystore''' den Alias aus der angegebenen Keystore-Datei aus, die Sie zum Signieren verwenden möchten.
# Geben Sie in das Feld '''Aliaspasswort''' das Passwort für den angegebenen Alias ein.

==Themen==

* [[Erstellen einer KeyStore-Datei|Erstellen einer KeyStore-Datei]]
* [[Hinzufügen eines Zertifikats zu einer Keystore-Datei|Hinzufügen eines Zertifikats zu einer Keystore-Datei]]

==Siehe auch==

* [[Bereitstellen von iOS-Anwendungen|Bereitstellen von iOS-Anwendungen]]
* [[Bereitstellungsseite|Bereitstellungsseite]]
* [[OS X-Anwendungsentwicklung|OS X-Anwendungsentwicklung]]
* [[Mobile iOS-Anwendungsentwicklung|Mobile iOS-Anwendungsentwicklung]]
* [[Vorbereiten von Android-Anwendungen für die Bereitstellung|Vorbereiten von Android-Anwendungen für die Bereitstellung]]

{{DEFAULTSORT:Ausfullen der Bereitstellungsseite}}
[[Category:XE4]]
[[Category:Geräteübergreifend]]
[[Category:AMMigrate]]

[[en:Completing the Provisioning Page]]
[[fr:Compléter la page Approvisionnement]]
[[ja:［プロビジョニング］ページに必要な情報をすべて入力する]]

Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering

2016-07-22T09:41:18Z

Esabatell: 1 Version: Internal review. LOC-22647

{{Parent|Verwenden von App-Tethering}}

Die App-Tethering-Implementierung der [[RTL|RTL]] stellt die Unterstützung für das Teilen von Daten zwischen verbundenen Anwendungen bereit.

==Senden von Daten an verbundene Anwendungen==

Sie können mit den folgenden Verfahren Daten mithilfe von App-Tethering senden:

* [[#Teilen von Ressourcen|Definieren von geteilten Ressourcen]]. Ein Ressource enthält einen Wert. Verbundene Anwendungen können den Wert einer geteilten Ressource lesen und eine geteilte Ressource abonnieren, um bei Änderungen des Werts der geteilten Ressource Aktualisierungen zu erhalten.
* [[#Senden von Daten als temporäre Ressource|Senden von Daten als temporäre Ressource]]. Sie können zur Laufzeit Strings und Streams senden, die verbundene Anwendungen als temporäre Ressourcen empfangen. Verbundene Anwendungen können keine temporären Ressourcen für Aktualisierungen empfangen, weil Ihre Anwendung temporäre Ressourcen nur einmal sendet.

===Teilen von Ressourcen===

Eine [[lib_de:System.Tether.AppProfile.TLocalResource|TLocalResource]] ist ein Wrapper für einen Standarddatentyp ([[lib_de:System.Boolean|Boolean]], [[lib_de:System.Integer|Integer]], [[lib_de:System.Int64|Int64]], [[lib_de:System.Single|Single]], [[lib_de:System.Double|Double]], [[lib_de:System.String|String]]) oder einen [[lib_de:System.Classes.TStream|TStream]]. Sie können Ressourcen mit verbundenen Anwendungen mithilfe von App-Tethering teilen.

So erstellen und teilen Sie eine Ressource:

# Wählen Sie im '''[[Formular-Designer|Formular-Designer]]''' Ihre [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente aus, und doppelklicken Sie im '''[[Objektinspektor|Objektinspektor]]''' auf die Eigenschaft [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.Resources|Resources]].
# Klicken Sie im angezeigten [[Aktionslisten-Editor|Listen-Editor]] auf [[File:New.png|Neu]], um der Liste eine neue TLocalResource hinzuzufügen.
# Wählen Sie im Listen-Editor Ihre neue TLocalResource aus, und geben Sie im '''Objektinspektor''' für deren Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Name|Name]] einen eindeutigen Namen an.

:[[Image:TLocalResource Editing.png]]

Ihre Ressource wird jetzt per App-Tethering geteilt. Verbundene Anwendungen können den Wert dieser Ressource lesen und die Ressource abonnieren, um Aktualisierungen zu erhalten, sodass bei Änderungen des Ressourcenwerts in Ihren Anwendungen verbundene Anwendungen über die Änderung benachrichtigt werden und den neuen Wert lesen können.

Nachdem Sie Ihre Ressource beim Entwurf definiert haben, müssen Sie ihr zur Laufzeit einen Wert zuweisen:
<l s="delphi" />

* In {{Delphi}}:
**<source lang="delphi" enclose="none">TetheringAppProfile1.Resources.FindByName('ResourceName').Value := 'SomeValue';</source>
**<source lang="delphi" enclose="none">TetheringAppProfile1.Resources.Items[ResourceNumber].Value := 'SomeValue';</source>

<l e="delphi" />
<l s="cpp" />

* In C++:
**<source lang="cpp" enclose="none">TetheringAppProfile1->Resources->FindByName("ResourceName")->Value = "SomeValue";</source>
**<source lang="cpp" enclose="none">TetheringAppProfile1->Resources->Items[ResourceNumber]->Value = "SomeValue";</source>

<l e="cpp" />

: Beschreibung:
:* {{Code|ResourceName}} ist der Name, den Sie in die Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Name|Name]] der Ressource eingeben, wenn Sie sie zur Laufzeit erstellen.
:* {{Code|SomeValue}} ist der Wert, den Sie für die Ressource festlegen möchten. Dieser Wert kann einen der oben aufgeführten Standarddatentypen haben.
:* {{Code|ResourceNumber}} ist die Anzahl der Einträge in der Eigenschaft [[lib_de:System.Tether.AppProfile.TResourceCollection.Items|Items]] der [[lib_de:System.Tether.AppProfile.TResourceCollection|TResourceCollection]], wenn Sie sie in Entwurfszeit erstellen.

Verbundene Anwendungen können jederzeit den Wert Ihrer geteilten Ressource anfordern und die geteilte Ressource abonnieren, um Aktualisierungen zu erhalten, sodass bei Änderungen des Ressourcenwerts die abonnierten Remote-Anwendungsprofile die aktualisierte Ressource erhalten.

===Senden von Daten als temporäre Ressource===

Anstatt Ressourcen zu teilen, können Sie mit den Methoden [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SendString|SendString]] und [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SendStream|SendStream]] der [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente Strings oder Streams an verbundene Anwendungen senden.

Remote-Anwendungsprofile empfangen den Wert, der in einer temporären Ressource enthalten ist. Eine temporäre Ressource wird von Ihrem Anwendungsprofil nur einmal an verbundene Anwendungen gesendet. Diese temporäre Ressource wird anschließend gelöscht; verbundene Anwendungen können diese Ressource nicht abonnieren, um Aktualisierungen zu erhalten.

Diese Methode erwartet die folgenden Parameter:

* {{Arg|AProfile}} ist ein Remote-Anwendungsprofil als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]]. Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] der [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente stellt eine Liste der Remote-Anwendungsprofile bereit, die mit Ihrem Profil verbunden sind; Sie können diese Liste nach dem gewünschten Remote-Anwendungsprofil durchsuchen.
* {{Arg|Description}} ist ein String, der den Inhalt des gesendeten Wertes beschreibt.
* {{Arg|AString}} oder {{Arg|AStream}} ist der Wert, der gesendet werden soll.

Wenn Sie mit temporären Ressourcen andere Standarddatentypen als String senden möchten, müssen Sie diese Datentypen vor dem Senden in Strings konvertieren und dann in der verbundenen Anwendung, die den String empfängt, wieder zurück in ihren Originaltyp konvertieren. Siehe [[JSON|JSON]].

==Empfangen von Daten von verbundenen Anwendungen==

Ihre Anwendung kann eine Ressource erhalten, entweder weil das [[#Senden von Daten an verbundene Anwendungen|Remote-Anwendungsprofil es sendet]], oder weil Sie [[#Anfordern von Remote-Ressourcen|es anfordern]]. Sie können [[#Verarbeiten von eingehenden Remote-Ressourcen|jede eingehende Remote-Ressource mit Ihrer TTetheringAppProfile-Komponente verarbeiten]].

Darüber hinaus können Sie [[#Abonnieren von Remote-Ressourcen, um Aktualisierungen zu erhalten|eine Remote-Ressource abonnieren, um Aktualisierungen zu erhalten]]. Wenn sich der Wert der Remote-Ressource ändert, wird Ihre Anwendung über die Änderung informiert und empfängt den neuen Wert der Remote-Ressource. Wenn Sie [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering#Verbinden von Anwendungen über Gruppen|die Verbindung zu Remote-Anwendungen über Gruppen herstellen]], können Sie alternativ [[#Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen|mit lokalen Ressourcen Remote-Ressourcen abonnieren]] und separate Methoden definieren, um Aktualisierungen jeder einzelnen der abonnierten Remote-Ressourcen zu verarbeiten.

===Anfordern von Remote-Ressourcen===

Die [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente stellt eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue|GetRemoteResourceValue]], bereit, mit der Sie Remote-Ressourcen anfordern können.

Sie können eine Remote-Ressource für die Anforderung mit einer der folgenden Parametergruppen festlegen:

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]] und den Namen der Remote-Ressource enthält.

: Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] Ihrer [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente enthält eine Liste der Remote-Anwendungsprofile, die mit Ihrem Profil verbunden sind.

* Stellen Sie eine Instanz von [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]] bereit.

: Die TTetheringAppProfile-Komponente enthält eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteProfileResources|GetRemoteProfileResources]], die eine Liste der Remote-Ressourcen zurückgibt, die von einem gegebenen Remote-Anwendungsprofil geteilt werden. Das Remote-Anwendungsprofil ist als Instanz von TTetheringProfileInfo festgelegt.

===Verarbeiten von eingehenden Remote-Ressourcen===

Die TTetheringAppProfile-Komponente kann Remote-Ressourcen aus einem der folgenden Gründe erhalten:

* Ein Remote-Anwendungsprofil sendet eine temporäre Ressource.
* Sie fordern eine Remote-Ressource an.

Wenn die TTetheringAppProfile-Komponente eine Ressource empfängt, werden zwei Ereignisse der TTetheringAppProfile-Komponente in der folgenden Reihenfolge ausgelöst: OnAcceptResource und OnResourceReceived. Zur Verarbeitung von eingehenden Ressourcen müssen Sie diese Ereignisse behandeln.

:[[Image:OnAcceptResource Image.png]]

====Annehmen oder Ablehnen einer eingehenden Remote-Ressource====

Sie können [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnAcceptResource|OnAcceptResource]] behandeln, um festzulegen, ob Sie eine eingehende Ressource akzeptieren oder nicht. Dieses Ereignis stellt die folgenden Parameter bereit:

* {{Arg|Sender}} ist Ihre TTetheringAppProfile-Komponente, die gerade die eingehende Ressource empfängt.
* {{Arg|AProfileId}} ist der [[lib_de:System.Tether.Manager.TTetheringProfileInfo.ProfileIdentifier|ProfileIdentifier]] des Remote-Anwendungsprofils, das die Ressource sendet. Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] der [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente stellt eine Liste der Remote-Anwendungsprofile bereit, die mit Ihrem Profil verbunden sind; Sie können diese Liste nach dem mit der angegebenen Profil-ID übereinstimmenden Remote-Anwendungsprofil durchsuchen.
* {{Arg|AResource}} ist eine Instanz von [[lib_de:System.Tether.AppProfile.TCustomRemoteItem|TCustomRemoteItem]], die Eigenschaften enthält, die Sie lesen können, um festzulegen, ob Sie die eingehende Remote-Ressource annehmen oder nicht, z. B. den [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Name|Namen]] der Ressource oder einen [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Hint|Hinweis]], der deren Inhalt beschreibt.
* {{Arg|AcceptResource}} ist ein boolescher Wert, der standardmäßig auf {{True}} gesetzt ist. Sie können diesen Wert in {{False}} ändern, wenn Sie die eingehende Ressource nicht empfangen möchten.

====Lesen einer eingehenden Remote-Ressource====

Wenn Sie das Ereignis OnAcceptResource nicht behandeln oder in Ihrer Ereignisbehandlungsroutine den Wert von {{Arg|AcceptResource}} nicht in {{False}} ändern, wird das Ereignis [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnResourceReceived|OnResourceReceived]] ausgelöst. Sie können dieses Ereignis behandeln, um die Daten aus der Ressource zu lesen. Dieses Ereignis stellt die folgenden Parameter bereit:

* {{Arg|Sender}} ist Ihre TTetheringAppProfile-Komponente, die gerade die eingehende Ressource empfängt.
* {{Arg|AResource}} ist eine Instanz von [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]]. TRemoteResource erweitert TCustomRemoteItem um zwei Eigenschaften, über die Sie auf den tatsächlichen Wert der Ressource zugreifen können:
** [[lib_de:System.Tether.AppProfile.TRemoteResource.ResType|TRemoteResource.ResType]] gibt an, ob die Ressource einen Standarddatentyp (TRemoteResourceType.Data) oder einen TStream (TRemoteResourceType.Stream) enthält.
** Mit [[lib_de:System.Tether.AppProfile.TRemoteResource.Value|TRemoteResource.Value]] können Sie auf den Wert zugreifen. So rufen Sie den Wert ab:
*** Wenn der Wert ein Standarddatentyp ist, überprüfen Sie [[lib_de:System.Tether.AppProfile.TResourceValue.DataType|TRemoteResource.Value.DataType]], um den Typ der Daten zu ermitteln, und lesen Sie die entsprechende TRemoteResource.Value-Eigenschaft: AsBoolean, AsInteger, AsInt64, AsSingle, AsDouble, AsString.
*** Wenn der Wert ein Stream ist, lesen Sie den Stream aus TRemoteResource.Value.AsStream.

===Abonnieren von Remote-Ressourcen, um Aktualisierungen zu erhalten===

Wenn Ihre Anwendung mit einer Anwendung verbunden ist, die Ressourcen teilt, können Sie diese geteilten Ressourcen abonnieren, um Aktualisierungen zu erhalten, sodass Ihre Anwendung diese geteilten Ressourcen erhält, sobald sich deren Wert in der verbundenen Anwendung ändert.

Wenn Sie [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering#Verbinden von Anwendungen über Gruppen|mit Gruppen Verbindungen zu anderen Anwendungen herstellen]], können Sie [[#Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen|beim Entwurf die Remote-Ressourcen zu lokalen Ressourcen zuordnen]]. Diese lokalen Ressourcen verfügen ein Ereignis, mit dem Sie die Änderungen des Wertes der Remote-Ressource behandeln können.

Alternativ können Sie [[#Abonnieren von Remote-Ressourcen mit SubscribeToRemoteItem|die Remote-Ressourcen zur Laufzeit über ihren Ressourcennamen abonnieren]].

: '''Hinweis:''' Sie dürfen eine Remote-Ressource nicht gleichzeitig mit einer lokalen Ressource und SubscribeToRemoteItem abonnieren. Verwenden Sie für jede Remote-Ressource nur eine dieser Abonnementmethoden.

====Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen====

So ordnen Sie beim Entwurf eine lokale Ressource einer Remote-Ressource zu:

# Befolgen Sie die obigen Schritte, um eine Ressource zu erstellen und mithilfe von App-Tethering zu teilen.
# Wählen Sie im Ressourcenlisten-Editor Ihre neue [[lib_de:System.Tether.AppProfile.TLocalResource|TLocalResource]] aus, und ändern Sie im '''Objektinspektor''' deren Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Kind|Kind]] in [[lib_de:System.Tether.AppProfile.TTetheringRemoteKind|Mirror]].

:[[Image: TLocalResource Kind Property.png]]

Wenn Sie die Eigenschaft Kind Ihrer TLocalResource in Mirror ändern, wird Ihre TLocalResource nicht mit Remote-Anwendungen geteilt. Sondern bei jeder Änderung des Wertes einer Remote-Ressource mit demselben [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Name|Namen]] wie der Name, den Sie in Ihrer TLocalResource angegeben haben, wird der Wert Ihrer lokalen Ressource aktualisiert und das Ereignis [[lib_de:System.Tether.AppProfile.TLocalResource.OnResourceReceived|TLocalResource.OnResourceReceived]] ausgelöst.

====Abonnieren von Remote-Ressourcen mit SubscribeToRemoteItem====

Die TTetheringAppProfile-Komponente stellt eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SubscribeToRemoteItem|SubscribeToRemoteItem]], bereit, mit der Sie Remote-Ressourcen abonnieren können, um Aktualisierungen zu erhalten.

Sie können eine Remote-Ressource zum Abonnieren mit einer der folgenden Parametergruppen festlegen:

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]] und den Namen der Remote-Ressource enthält.

: Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] Ihrer [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente enthält eine Liste der Remote-Anwendungsprofile, die mit Ihrem Profil verbunden sind.

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von TTetheringProfileInfo und eine Instanz von [[lib_de:System.Tether.AppProfile.TCustomRemoteItem|TCustomRemoteItem]] enthält.

: Die [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente enthält eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteProfileActions|GetRemoteProfileActions]], die eine Liste der Remote-Ressourcen zurückgibt, die von einem gegebenen Remote-Anwendungsprofil geteilt werden. Das Remote-Anwendungsprofil ist als Instanz von TTetheringProfileInfo festgelegt.

Ändert sich der Wert einer Remote-Ressource mit demselben Namen wie die Instanz von TCustomRemoteItem, die Sie abonniert haben, wird der Wert der abonnierten Instanz von TCustomRemoteItem aktualisiert und das Ereignis [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnResourceUpdated|OnResourceUpdated]] ausgelöst.

:'''Hinweise:'''
:* Um den Wert der abonnierten Instanz von TCustomRemoteItem zu lesen, müssen Sie den Typ dieser Instanz in [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]] umwandeln und deren Daten lesen. Siehe [[#Lesen einer eingehenden Remote-Ressource|Lesen einer eingehenden Remote-Ressource]].
:* Ändert sich eine Remote-Ressource, die einen Stream enthält, wird das Ereignis OnResourceUpdated ausgelöst, aber der Wert der abonnierten Instanz von TCustomRemoteItem wird nicht aktualisiert. Sie müssen den neuen Ressourcenwert manuell anfordern. Siehe [[#Anfordern von Remote-Ressourcen|Anfordern von Remote-Ressourcen]].
:* Das Ereignis OnResourceUpdated wird nicht ausgelöst, wenn Sie dieselbe Remote-Ressource mit einer lokalen Ressource abonnieren.

==Siehe auch==

* [[Hinzufügen von App-Tethering zu Anwendungen|Hinzufügen von App-Tethering zu Anwendungen]]
* [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering|Verbinden zu Remote-Anwendungen mithilfe von App-Tethering]]
* [[Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering|Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering]]

* [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]
* [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]
* [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]]

* [[lib_de:System.Classes.TStream|TStream]]
* [[lib_de:System.String|String]]

* [[samp_en:RTL.BDShoppingList Sample|BDShoppingList]] (Beispiel)
* [[samp_en:RTL.DesktopCast Sample|DesktopCast]] (Beispiel)
* [[samp_en:RTL.MediaPlayer Sample|MediaPlayer]] (Beispiel)
* [[samp_en:RTL.PhotoWall Sample|PhotoWall]] (Beispiel)

[[Category:XE6]]
[[Category:AMMigrate]]

Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering

2016-07-22T09:41:15Z

Esabatell: Internal review. LOC-22647

Manuelles Sandboxing der Mac OS X-Anwendung

2016-07-22T09:28:23Z

Esabatell: Esabatell verschob die Seite Manuelles Sandboxing der Mac OS X-Anwendung nach Manuelles Sandboxing der OS X-Anwendung: Renamed in English

#WEITERLEITUNG [[Manuelles Sandboxing der OS X-Anwendung]]

Manuelles Sandboxing der macOS-Anwendung

2016-07-22T09:28:23Z

Esabatell: Esabatell verschob die Seite Manuelles Sandboxing der Mac OS X-Anwendung nach Manuelles Sandboxing der OS X-Anwendung: Renamed in English

{{Parent|OS X-Anwendungsentwicklung}}

: '''Hinweis:''' [[Sandboxing der OS X-Anwendung|Die Verwendung der IDE]] wird für das Sandboxing empfohlen. Manuelle Schritte sind viel komplexer als die Verwendung der IDE und werden hier nur für diejenigen kurz umrissen, die außerhalb der IDE arbeiten müssen.

Wenn Sie nicht mit der {{Product}}-IDE ein Sandbox-Anwendungspaket einer OS X-Anwendung erstellen, können Sie die erforderlichen Schritte auf Ihrem Mac ausführen. Dieser Abschnitt enthält eine grundlegende Einführung in diesen Vorgang, die Details finden Sie in der [https://developer.apple.com/library/mac/documentation/Security/Conceptual/AppSandboxDesignGuide/AboutAppSandbox/AboutAppSandbox.html Apple-Dokumentation] (siehe die entsprechenden Links).

Auf dem Mac müssen Sie eine [[Apple-Anwendungsberechtigungsdatei (*.entitlements)|{{Placeholder|Projekt}}.entitlements]]-Datei erstellen und diese in das Anwendungspaket platzieren, das Paket mit einer Codesignatur versehen, es komprimieren und bei Apple einreichen.

==Anforderungen von Apple==

Im Folgenden sind die erforderlichen Elemente und die relevanten Informationen von Apple aufgeführt:

* Die zugehörige [[Apple-Anwendungsberechtigungsdatei (*.entitlements)|{{Placeholder|Projekt}}.entitlements]]-Datei.
* Befehl "codesign":
** [https://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/codesign.1.html man page for code-sign command (EN)]
** [https://developer.apple.com/library/mac/#documentation/Security/Conceptual/CodeSigningGuide/Introduction/Introduction.html Code Signing Guide]
** [https://developer.apple.com/library/mac/#documentation/ToolsLanguages/Conceptual/OSXWorkflowGuide/CodeSigning/CodeSigning.html#//apple_ref/doc/uid/TP40011201-CH7-SW1 Code Signing Your App]
** Beispiel:
**:<code>codesign -s"Name des Zertifikats" -f "Name des Anwendungspakets" </code>
* Befehl "productbuild"
** [https://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/productbuild.1.html man page for productbuild command (EN)]
** [https://developer.apple.com/library/mac/#releasenotes/General/SubmittingToMacAppStore/_index.html Submitting Your Application Using Application Loader]
* Befehl "installer" (zum Testen der Installation Ihrer Anwendung)
** [https://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man8/installer.8.html man page for installer command (EN)]

==Manuelles Signieren des Codes und Erzeugen einer OS X-Anwendung auf dem Mac==

Wenn Sie Ihre Anwendung im Mac App Store bereitstellen möchten, ist eine Codesignatur und eine Bereitstellung der Voraussetzungen erforderlich. Sie können diese Schritte entweder in der IDE (weiter oben beschrieben) oder manuell (indem Sie die folgenden allgemeinen Anleitungen befolgen) durchführen.

'''Hinweise:'''

:
:* Sie müssen zum Bereitstellen von Apps im Mac App Store [[Bereitstellen von OS X-Anwendungen|ein Distributionszertifikat anfordern]].
:* Für das Mac-Sandboxing ist eine [[Apple-Anwendungsberechtigungsdatei (*.entitlements)|{{Placeholder|Projekt}}.entitlements]]-Datei erforderlich.

'''So signieren Sie Ihren Code und erzeugen ein Produktinstallationsprogramm für Ihre OS X-Anwendung manuell:'''

# Erzeugen Sie die Anwendung in der IDE, und stellen Sie sie in OS X bereit.
# Öffnen Sie auf dem Mac ein Terminalfenster.
# Wechseln Sie in das Verzeichnis "scratch-dir" von PAServer:
#: {{Path|Applications/{{Company}}/PAServer/{{VersionNumber}}/scratch-dir/machinename-remoteprofilename/}}
# Führen Sie die folgenden Befehle aus:
#*Codesignatur für die Anwendung:
#*: {{Code|sudo codesign -f -v -s "Mac-Entwickler: Vorname Nachname" "App-Name.app"}}
#* Führen Sie "productbuild" aus, um ein Installationspaket zu erstellen:
#*: {{Code|sudo productbuild --component "App-Name.app" /Applications --sign "Mac-Entwickler: Vorname Nachname" --product "App-Name.app/Contents/info.plist" AppName.pkg}}

==Siehe auch==

* [[Sandboxing der OS X-Anwendung|Sandboxing einer OS X-Anwendung]] mit {{Product}}
* [https://developer.apple.com/library/mac/#referencelibrary/GettingStarted/RoadMapOSX/books/RM_PrepareForAppStore_Mac/PrepareForAppStore/PrepareForAppStore.html OS X Roadmap for Mac App Store]

[[Category:OS X]]
[[Category:AMMigrate]]

[[en:Sandboxing Your OS X Application Manually]]
[[fr:Sandboxing manuel de votre application OS X]]
[[ja:Mac OS X アプリケーションの手動でのサンドボックス化]]

Standardbehandlung von F1-Hilfe in VCL-Anwendungen

2016-07-19T14:49:54Z

Esabatell: Changes

{{Parent|Aufrufen von HTML-Hilfe aus Anwendungen}}
__TOC__
Das Drücken von F1 ist das Standardvorgehen zum Aktivieren von Hilfe in Anwendungen. Die IDE von {{Variables|Product}} unterstützt Optionen zur Definition von Hilfeparametern für die automatische Erzeugung von Code zur Aktivierung der Hilfe beim Drücken von F1. In diesem Fall erzeugt {{Variables|Product}} automatisch den Standardcode, der zum Ausführen eines entsprechenden Aufrufs der Hilfebehandlungsfunktion beim Drücken von F1 in VCL-Anwendungen erforderlich ist.

In diesem Thema wird die Definition von Parametern für Aufrufe der Hilfebehandlungsfunktionen und die Ausführung dieser Aufrufe beschrieben. Die folgenden Erläuterungen beziehen sich ausschließlich auf VCL-GUI-Anwendungen.

==Erforderliche Hilfeparameter==

Beim Drücken von F1 wird in dem Formular, das den Fokus hat, das Ereignis '''[[lib_de:Vcl.Forms.TForm.OnHelp|OnHelp]]''' ausgelöst. Die Anwendung führt als Ergebnis die Standard-Ereignisbehandlungsroutine des Ereignisses '''OnHelp''' aus. Die IDE erzeugt die '''OnHelp'''-Ereignisbehandlungsroutine mit den angegebenen Hilfeparametern. Sie können in der IDE die Hilfeparameter '''HelpFile''', '''HelpType''', '''HelpContext''' und '''HelpKeyword''' festlegen. Diese Parameter werden in den folgenden Abschnitten beschrieben.

===HelpFile===

Zunächst müssen Sie die Hilfedateien festlegen, die die Hilfethemen für Ihre Anwendung enthalten. Sie können eine oder mehrere Hilfedateien angeben. Die Haupthilfedatei für eine Anwendung kann mit der Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpFile|TApplication.HelpFile]]''' des globalen '''[[lib_de:Vcl.Forms.TApplication|Application]]'''-Objekts und individuelle Hilfedateien für einzelne Formulare können mit der Eigenschaft '''[[lib_de:Vcl.Forms.TForm.HelpFile|TForm.HelpFile]]''' des zugehörigen '''[[lib_de:Vcl.Forms.TForm|Form]]'''-Objekts festgelegt werden.

Diese '''HelpFile'''-Dateien können beim Entwurf als entsprechende IDE-Eigenschaften für die programmseitige Definition der '''HelpFile'''-Eigenschaften des zugehörigen Objekts angegeben werden.

Normalerweise wird einer Anwendung die Haupthilfedatei über die Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpFile|HelpFile]]''' des globalen '''Application'''-Objekts zugewiesen.

Öffnen Sie das Dialogfeld '''Projektoptionen''' ('''Projekt > Optionen'''), und wählen Sie die Seite '''Erscheinungsbild''' (unter '''Anwendung''') aus. Geben Sie in das Feld '''Hilfedatei''' die Hilfedatei ein. Klicken Sie auf '''Durchsuchen'''. Das Dialogfeld '''Hilfedatei der Anwendung''' zeigt per Vorgabe nur die Dateien mit der Erweiterung .hlp an. Zum Festlegen von anderen Hilfedateitypen wählen Sie im Steuerelement '''Dateitypen''' den Typ <code>Alle Dateien (*.*)</code> aus. Anschließend können Sie Hilfedateien der Typen .CHM, .HTML und andere auswählen.)

Diese Option setzt die Eigenschaft '''Application.HelpFile'''. Diese Eigenschaft definiert die Haupthilfedatei für die Anwendung. Wenn die Anwendung einen Hilfebehandlungsbefehl empfängt, führt sie standardmäßig den Hilfebefehl mit dieser Hilfedatei aus.

Eine einzelne Hilfedatei für ein bestimmtes Formular können Sie mit der Eigenschaft '''HelpFile''' dieses Formulars festlegen.

Wählen Sie im Formular-Designer das Formular aus; im Objektinspektor werden die Eigenschaften dieses Formulars (siehe die folgende Abbildung) angezeigt:

[[Image:Help HelpFile.PNG|HelpFile]]

Geben Sie in der rechten Spalte der Eigenschaft '''HelpFile''' den Namen <code>Form1.chm</code> ein. Damit wird die Eigenschaft '''TForm.HelpFile''' des Objekts '''Form1''' definiert. Diese Eigenschaft setzt die Hilfedatei <code>Form1.chm</code> für das Formular '''Form1'''.

Die Anwendung sucht in der Regel die Hilfedatei in dem Verzeichnis, aus dem die ausführbare Datei der Anwendung ausgeführt wird. Wenn die angegebene Hilfedatei sich in einem anderen Verzeichnis befindet, sollten Sie daher den relativer Pfad zu dieser Datei angeben. Sie könnten beispielsweise <code>.\Help\Form1.chm</code> angeben.

Die '''OnHelp'''-Standard-Ereignisbehandlungsroutine verwendet die in der Eigenschaft '''HelpFile''' des Formulars mit dem Fokus angegebene Hilfedatei. Wenn die Eigenschaft '''TForm.HelpFile''' einen leeren String enthält, dann verwendet die Ereignisbehandlungsroutine die in der Eigenschaft '''HelpFile''' des globalen '''Application'''-Objekts angegebene Hilfedatei.

===HelpType, HelpContext und HelpKeyword===

Zum Erzeugen des Codes für die Standard-Ereignisbehandlungsroutine des Ereignisses '''OnHelp''' muss die IDE über das anzuzeigende Hilfethema informiert sein. Die Werte der Eigenschaften '''HelpContext''' und '''HelpKeyword''' können definieren, welches Thema angezeigt werden soll. Die Eigenschaft '''HelpType''' definiert, welche dieser beiden Eigenschaften verwendet werden soll.

Klicken Sie im Objektinspektor für das Formular mit der rechten Maustaste in die rechte Spalte der Eigenschaft '''HelpType'''. Wenn Sie den Wert <code>htContext</code> auswählen, dann wird der in der Eigenschaft '''HelpContext''' angegebene Wert verwendet. Bei dem Wert <code>htKeyword</code> wird der in der Eigenschaft '''HelpKeyword''' angegebene Wert verwendet.

==Ergänzen des erzeugten Codes==

Mit {{Variables|Product}} entwickelte Anwendungen verwenden zur Anzeige verschiedener Typen von Hilfedateien externe Hilfe-Viewer. Sie müssen Ihrer Anwendung mitteilen, welcher externe Hilfe-Viewer verwendet werden soll.

===Wrapper von externen Hilfe-Viewern===

Die VCL ist unabhängig von externen Hilfe-Viewer. Alle von den Standard-Ereignisbehandlungsroutinen der Hilfe verwendeten Hilfefunktionen sind in Interfaces der Unit '''[[lib_de:System.HelpIntfs|System.HelpIntfs]]''' deklariert. Die VCL stellt Packages mit Klassen bereit, die diese Interfaces mit einem bestimmten externen Hilfe-Viewer (für den speziellen Typ der Hilfedatei) implementieren. Beispielweise implementiert die Unit '''Vcl.HtmlHelpViewer''' für die Viewer von '''CHM'''-Hilfedateien (Microsoft HTML Help) einen Wrapper für die '''HTMLHelp'''-API.

Diese Unabhängigkeit (von externen Hilfe-Viewern) bedeutet, dass Sie nur in der '''uses'''-Klausel die geeignete Unit angeben müssen, die die Implementierung der '''HelpIntfs'''-Interfaces für einen bestimmten externen Hilfe-Viewer bereitstellt. Sie können beispielsweise die Unit '''Vcl.HtmlHelpViewer'''' zur Anzeige von '''CHM'''-Hilfedateien angeben.

Wenn Sie die Eigenschaften '''HelpFile''', '''HelpType''', '''HelpContext''' und '''HelpKeyword''' definiert haben, kann die '''OnHelp'''-Standard-Ereignisbehandlungsroutine die Hilfebehandlungsfunktion folgendermaßen verwenden:

IHelpSystem.ShowContextHelp(Form1.HelpContext, Form1.HelpFile);

Bei <code>HelpType = htContext</code> wie folgt:

IHelpSystem.ShowHelp(Form1.HelpKeyword, Form1.HelpFile);

Bei <code>HelpType = htKeyword</code>. Hier ist '''IHelpSystem''' das in der Unit '''HelpIntfs''' deklariert Interface.

===Zugreifen auf externe Hilfe-Viewer===

In den folgenden Abschnitten wird die Implementierung von '''IHelpSystem''' und anderen in der Unit '''HelpIntfs''' deklarierten Interfaces durch Klassen in einer Unit erläutert, die einen Wrapper für einen externen Hilfe-Viewer bereitstellt. Die Unit '''Vcl.HtmlHelpViewer''' enthält beispielsweise einen Wrapper für die '''HTMLHelp'''-Funktions-API. Die Unit ''''Vcl.HtmlHelpViewer''' implementiert die Klasse '''THTMLHelpViewer''', die eine Implementierung für Interfaces aus der Unit '''HelpIntfs''' bereitstellt. Die Klasse '''THTMLHelpViewer''' ist aber im '''implementation'''-Abschnitt der Unit deklariert. Deshalb müssen Sie wissen, wie auf Member dieser Klasse von außerhalb der Unit '''Vcl.HtmlHelpViewer''' zugegriffen werden kann.

Die Unit '''HelpIntfs''' enthält zwei globale Funktionen: '''[[lib_de:System.HelpIntfs.RegisterViewer|RegisterViewer]]''' und '''[[lib_de:System.HelpIntfs.GetHelpSystem|GetHelpSystem]]'''. Diese Funktionen haben die folgenden Deklarationen:

function RegisterViewer(const newViewer: ICustomHelpViewer; out Manager: IHelpManager): Integer;
function GetHelpSystem(out System: IHelpSystem): Boolean;

Im '''initialization'''-Abschnitt der Unit '''Vcl.HtmlHelpViewer''' werden die folgenden Aufrufe ausgeführt:

HelpViewer := THtmlHelpViewer.Create;
HelpIntfs.RegisterViewer(HelpViewerIntf, HelpViewer.FHelpManager);

Diese Aufrufe erstellen ein Objekt vom Typ '''THtmlHelpViewer''' und registrieren das gekapselte externe Hilfe-Viewer-Objekt als ein Hilfesystem-Managerobjekt (''HelpViewer.FHelpManager'') vom Typ '''[[lib_de:System.HelpIntfs.IHelpManager|IHelpManager]]'''.

Zum Aufrufen des registrierten externen Hilfe-Viewers kann im Code die Funktion '''HelpIntfs.GetHelpSystem''' aufgerufen werden, die auf das im '''HelpViewer.FHelpManager''' gespeicherte Objekt zugreift und dann ein '''IHelpManager'''-Typobjekt im Typobjekt '''[[lib_de:System.HelpIntfs.IHelpSystem|IHelpSystem]]''' zurückgibt. '''TApplication''' hat die Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpSystem|HelpSystem]]''', die auch den Zugriff auf dieses '''IHelpSystem'''-Typobjekt ermöglicht, über das '''TApplication'''-Methoden die Hilfe-Viewer-Funktionen aufrufen. '''IHelpSystem'''-Typobjekte stellen unter anderem die Hilfefunktionen '''[[lib_de:System.HelpIntfs.IHelpSystem.ShowContextHelp|IHelpSystem.ShowContextHelp]]''' und '''[[lib_de:System.HelpIntfs.IHelpSystem.ShowHelp|IHelpSystem.ShowHelp]]''' bereit. Diese Funktionen können von der Standard-Ereignisbehandlungsroutine '''OnHelp''' und dem Benutzercode aufgerufen werden.

==Schritte für die Anzeige der F1-Hilfe==

Wenn Sie F1 drücken, aktiviert die Anwendung die Standard-Ereignisbehandlungsroutine für das Ereignis '''OnHelp''' des Formulars mit dem Fokus. In den vorherigen Abschnitten dieses Themas wurden die theoretischen Aspekte des Setzens der Hilfeeigenschaften im Objektinspektor und das Hinzufügen des zur ordnungsgemäßen Aktivierung der Hilfeseite erforderlichen Codes behandelt.

Befolgen Sie zum Umsetzen dieser theoretischen Aspekte in die Praxis die folgenden Schritte.

===So zeigen Sie die F1-Hilfe an:===

# Setzen Sie die Eigenschaft '''HelpFile''' des globalen '''Application'''-Objekts (die Eigenschaft '''TApplication.HelpFile''') oder eines bestimmten Formulars (die Eigenschaft '''TForm.HelpFile'''). Zum Beispiel:

:
:: <code>TForm.HelpFile = Form1.chm</code>

<ol start="2"><li>Wählen Sie für ein bestimmtes Formular die Eigenschaft '''HelpType''' aus, und setzen Sie <code>htContext</code> oder <code>htKeyword</code>. Zum Beispiel:
</li>
</ol>

:
:: <code>TForm.HelpType = htContext</code>

:
:: Setzen Sie dann in der Eigenschaft '''TForm.HelpContext''' den entsprechenden <code>ContextID</code>-Wert. <code>ContextID</code> sollte ein Integerwert sein, der ein Thema in der in '''HelpFile''' angegebenen Hilfedatei festlegt. Bei CHM-Hilfedateien müssen Sie beispielsweise im '''[MAP]'''-Abschnitt Ihrer Projektdatei (.hhp) symbolische Kontext-IDs von Hilfethemen zu numerischen <code>ContextID</code>-Werten zuordnen. Zum Beispiel:
:: <code>TForm.HelpContext = 714</code>
:: Durch Drücken von F1 wird nun das Thema mit der <code>ContextID</code><code>714</code> aus einer in '''HelpFile''' angegebenen CHM-Hilfedatei angezeigt.
:: Oder:
:: <code>TForm.HelpType = htKeyword</code>
:: Setzen Sie dann in der Eigenschaft '''TForm.HelpKeyword''' den entsprechenden <code>Keyword</code>-Wert. Durch Drücken von F1 wird nun das Thema angezeigt, dessen <code>Alink</code>-Tag-Wert mit dem angegebenen <code>Keyword</code>-Wert übereinstimmt.

<ol start="3"><li>In {{Delphi}}-Anwendungen fügen Sie der '''uses'''-Klausel des Hauptmoduls Ihrer Anwendung die Unit '''Vcl.HtmlHelpViewer''' hinzu. 
In C++-Anwendungen fügen Sie die Direktive <code>#include Vcl.HtmlHelpViewer.hpp</code> hinzu.
 Fügen Sie <code>#pragma package(smart_init)</code> und <code>#pragma link "Vcl.HtmlHelpViewer"</code> hinzu. 
Damit wird definiert, dass Ihre Anwendung die API der Funktion '''HTMLHelp''' verwendet, die die CHM-Hilfedateien anzeigt.</li>
<li>Wählen Sie den Befehl '''Start > Start'''. Ihre Anwendung wird geöffnet.</li>
<li>Wählen Sie das Formular Form1 aus. Drücken Sie F1. Die automatisch erzeugte Standard-Ereignisbehandlungsroutine '''OnHelp''' zeigt das im '''HelpContext'''- (oder '''HelpKeyword'''-)Wert in der festgelegten .CHM-Hilfedatei angegebene Thema an.</li>
</ol>

Hierbei war keine manuelle Programmierung erforderlich. Die gesamte Behandlung für das Drücken von F1 wurde automatisch implementiert. Sie müssen nur die passenden Hilfeparameter im Objektinspektor eingeben.

==Siehe auch==

*[[Aufrufen von HTML-Hilfe aus Anwendungen|Aufrufen von HTML-Hilfe aus Anwendungen]]
**[[HTML-Hilfetypen|HTML-Hilfetypen]]
**[[Anpassen der F1-Hilfe in VCL-Anwendungen|Anpassen der F1-Hilfe in VCL-Anwendungen]]
**[[Anzeigen von Hilfe mit Hilfe-Schaltflächen|Anzeigen von Hilfe mit Hilfe-Schaltflächen]]
**[[Zuordnen von Hilfe zu Menübefehlen|Zuordnen von Hilfe zu Menübefehlen]]
**[[Anzeigen von Hilfe zu ausgewählten Menübefehlen|Anzeigen von Hilfe zu ausgewählten Menübefehlen]]
**[[Anzeigen von Kontexthilfe zu Bildschirmobjekten mit der Eigenschaft Hint|Anzeigen von Kontexthilfe zu Bildschirmobjekten mit der Eigenschaft Hint]]
* [[Hilfesystem-Interfaces|Hilfesystem-Interfaces]]
* [[Hilfe in einer VCL-Anwendung verwenden|Hilfe in einer VCL-Anwendung verwenden]]

[[Category:Windows-Entwicklerhandbuch]]
[[Category:Delphi]]
[[Category:C++]]

Standardbehandlung von F1-Hilfe in VCL-Anwendungen

2016-07-19T14:46:59Z

Esabatell: 1 Version: Internal review. LOC-22582

{{Parent|Aufrufen von HTML-Hilfe aus Anwendungen}}
__TOC__
Das Drücken von F1 ist das Standardvorgehen zum Aktivieren von Hilfe in Anwendungen. Die IDE von {{Variables|Product}} unterstützt Optionen zur Definition von Hilfeparametern für die automatische Erzeugung von Code zur Aktivierung der Hilfe beim Drücken von F1. In diesem Fall erzeugt {{Variables|Product}} automatisch den Standardcode, der zum Ausführen eines entsprechenden Aufrufs der Hilfebehandlungsfunktion beim Drücken von F1 in VCL-Anwendungen erforderlich ist.

In diesem Thema wird die Definition von Parametern für Aufrufe der Hilfebehandlungsfunktionen und die Ausführung dieser Aufrufe beschrieben. Die folgenden Erläuterungen beziehen sich ausschließlich auf VCL-GUI-Anwendungen.

==Erforderliche Hilfeparameter==

Beim Drücken von F1 wird in dem Formular, das den Fokus hat, das Ereignis '''[[lib_de:Vcl.Forms.TForm.OnHelp|OnHelp]]''' ausgelöst. Die Anwendung führt als Ergebnis die Standard-Ereignisbehandlungsroutine des Ereignisses '''OnHelp''' aus. Die IDE erzeugt die '''OnHelp'''-Ereignisbehandlungsroutine mit den angegebenen Hilfeparametern. Sie können in der IDE die Hilfeparameter '''HelpFile''', '''HelpType''', '''HelpContext''' und '''HelpKeyword''' festlegen. Diese Parameter werden in den folgenden Abschnitten beschrieben.

===HelpFile===

Zunächst müssen Sie die Hilfedateien festlegen, die die Hilfethemen für Ihre Anwendung enthalten. Sie können eine oder mehrere Hilfedateien angeben. Die Haupthilfedatei für eine Anwendung kann mit der Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpFile|TApplication.HelpFile]]''' des globalen '''[[lib_de:Vcl.Forms.TApplication|Application]]'''-Objekts und individuelle Hilfedateien für einzelne Formulare können mit der Eigenschaft '''[[lib_de:Vcl.Forms.TForm.HelpFile|TForm.HelpFile]]''' des zugehörigen '''[[lib_de:Vcl.Forms.TForm|Form]]'''-Objekts festgelegt werden.

Diese '''HelpFile'''-Dateien können beim Entwurf als entsprechende IDE-Eigenschaften für die programmseitige Definition der '''HelpFile'''-Eigenschaften des zugehörigen Objekts angegeben werden.

Normalerweise wird einer Anwendung die Haupthilfedatei über die Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpFile|HelpFile]]''' des globalen '''Application'''-Objekts zugewiesen.

Öffnen Sie das Dialogfeld '''Projektoptionen''' ('''Projekt > Optionen'''), und wählen Sie die Seite '''Erscheinungsbild''' (unter '''Anwendung''') aus. Geben Sie in das Feld '''Hilfedatei''' die Hilfedatei ein. Klicken Sie auf '''Durchsuchen'''. Das Dialogfeld '''Hilfedatei der Anwendung''' zeigt per Vorgabe nur die Dateien mit der Erweiterung .hlp an. Zum Festlegen von anderen Hilfedateitypen wählen Sie im Steuerelement '''Dateitypen''' den Typ <code>Alle Dateien (*.*)</code> aus. Anschließend können Sie Hilfedateien der Typen .CHM, .HTML und andere auswählen.)

Diese Option setzt die Eigenschaft '''Application.HelpFile'''. Diese Eigenschaft definiert die Haupthilfedatei für die Anwendung. Wenn die Anwendung einen Hilfebehandlungsbefehl empfängt, führt sie standardmäßig den Hilfebefehl mit dieser Hilfedatei aus.

Eine einzelne Hilfedatei für ein bestimmtes Formular können Sie mit der Eigenschaft '''HelpFile''' dieses Formulars festlegen.

Wählen Sie im Formular-Designer das Formular aus; im Objektinspektor werden die Eigenschaften dieses Formulars (siehe die folgende Abbildung) angezeigt:

[[Image:Help HelpFile.PNG|HelpFile]]

Geben Sie in der rechten Spalte der Eigenschaft '''HelpFile''' den Namen <code>Form1.chm</code> ein. Damit wird die Eigenschaft '''TForm.HelpFile''' des Objekts '''Form1''' definiert. Diese Eigenschaft setzt die Hilfedatei <code>Form1.chm</code> für das Formular '''Form1'''.

Die Anwendung sucht in der Regel die Hilfedatei in dem Verzeichnis, aus dem die ausführbare Datei der Anwendung ausgeführt wird. Wenn die angegebene Hilfedatei sich in einem anderen Verzeichnis befindet, sollten Sie daher den relativer Pfad zu dieser Datei angeben. Sie könnten beispielsweise <code>.\Help\Form1.chm</code> angeben.

Die '''OnHelp'''-Standard-Ereignisbehandlungsroutine verwendet die in der Eigenschaft '''HelpFile''' des Formulars mit dem Fokus angegebene Hilfedatei. Wenn die Eigenschaft '''TForm.HelpFile''' einen leeren String enthält, dann verwendet die Ereignisbehandlungsroutine die in der Eigenschaft '''HelpFile''' des globalen '''Application'''-Objekts angegebene Hilfedatei.

===HelpType, HelpContext und HelpKeyword===

Zum Erzeugen des Codes für die Standard-Ereignisbehandlungsroutine des Ereignisses '''OnHelp''' muss die IDE über das anzuzeigende Hilfethema informiert sein. Die Werte der Eigenschaften '''HelpContext''' und '''HelpKeyword''' können definieren, welches Thema angezeigt werden soll. Die Eigenschaft '''HelpType''' definiert, welche dieser beiden Eigenschaften verwendet werden soll.

Klicken Sie im Objektinspektor für das Formular mit der rechten Maustaste in die rechte Spalte der Eigenschaft '''HelpType'''. Wenn Sie den Wert <code>htContext</code> auswählen, dann wird der in der Eigenschaft '''HelpContext''' angegebene Wert verwendet. Bei dem Wert <code>htKeyword</code> wird der in der Eigenschaft '''HelpKeyword''' angegebene Wert verwendet.

==Ergänzen des erzeugten Codes==

Mit {{Variables|Product}} entwickelte Anwendungen verwenden zur Anzeige verschiedener Typen von Hilfedateien externe Hilfe-Viewer. Sie müssen Ihrer Anwendung mitteilen, welcher externe Hilfe-Viewer verwendet werden soll.

===Wrapper von externen Hilfe-Viewern===

Die VCL ist unabhängig von externen Hilfe-Viewer. Alle von den Standard-Ereignisbehandlungsroutinen der Hilfe verwendeten Hilfefunktionen sind in Interfaces der Unit '''[[lib_de:System.HelpIntfs|System.HelpIntfs]]''' deklariert. Die VCL stellt Packages mit Klassen bereit, die diese Interfaces mit einem bestimmten externen Hilfe-Viewer (für den speziellen Typ der Hilfedatei) implementieren. Beispielweise implementiert die Unit '''Vcl.HtmlHelpViewer''' für die Viewer von '''CHM'''-Hilfedateien (Microsoft HTML Help) einen Wrapper für die '''HTMLHelp'''-API.

Diese Unabhängigkeit (von externen Hilfe-Viewern) bedeutet, dass Sie nur in der '''uses'''-Klausel die geeignete Unit angeben müssen, die die Implementierung der '''HelpIntfs'''-Interfaces für einen bestimmten externen Hilfe-Viewer bereitstellt. Sie können beispielsweise die Unit '''Vcl.HtmlHelpViewer'''' zur Anzeige von '''CHM'''-Hilfedateien angeben.

Wenn Sie die Eigenschaften '''HelpFile''', '''HelpType''', '''HelpContext''' und '''HelpKeyword''' definiert haben, kann die '''OnHelp'''-Standard-Ereignisbehandlungsroutine die Hilfebehandlungsfunktion folgendermaßen verwenden:

IHelpSystem.ShowContextHelp(Form1.HelpContext, Form1.HelpFile);

Bei <code>HelpType = htContext</code> wie folgt:

IHelpSystem.ShowHelp(Form1.HelpKeyword, Form1.HelpFile);

Bei <code>HelpType = htKeyword</code>. Hier ist '''IHelpSystem''' das in der Unit '''HelpIntfs''' deklariert Interface.

===Zugreifen auf externe Hilfe-Viewer===

In den folgenden Abschnitten wird die Implementierung von '''IHelpSystem''' und anderen in der Unit '''HelpIntfs''' deklarierten Interfaces durch Klassen in einer Unit erläutert, die einen Wrapper für einen externen Hilfe-Viewer bereitstellt. Die Unit '''Vcl.HtmlHelpViewer''' enthält beispielsweise einen Wrapper für die '''HTMLHelp'''-Funktions-API. Die Unit ''''Vcl.HtmlHelpViewer''' implementiert die Klasse '''THTMLHelpViewer''', die eine Implementierung für Interfaces aus der Unit '''HelpIntfs''' bereitstellt. Die Klasse '''THTMLHelpViewer''' ist aber im '''implementation'''-Abschnitt der Unit deklariert. Deshalb müssen Sie wissen, wie auf Member dieser Klasse von außerhalb der Unit '''Vcl.HtmlHelpViewer''' zugegriffen werden kann.

Die Unit '''HelpIntfs''' enthält zwei globale Funktionen: '''[[lib_de:System.HelpIntfs.RegisterViewer|RegisterViewer]]''' und '''[[lib_de:System.HelpIntfs.GetHelpSystem|GetHelpSystem]]'''. Diese Funktionen haben die folgenden Deklarationen:

function RegisterViewer(const newViewer: ICustomHelpViewer; out Manager: IHelpManager): Integer;
function GetHelpSystem(out System: IHelpSystem): Boolean;

Im '''initialization'''-Abschnitt der Unit '''Vcl.HtmlHelpViewer''' werden die folgenden Aufrufe ausgeführt:

HelpViewer := THtmlHelpViewer.Create;
HelpIntfs.RegisterViewer(HelpViewerIntf, HelpViewer.FHelpManager);

Diese Aufrufe erstellen ein Objekt vom Typ '''THtmlHelpViewer''' und registrieren das gekapselte externe Hilfe-Viewer-Objekt als ein Hilfesystem-Managerobjekt (''HelpViewer.FHelpManager'') vom Typ '''[[lib_de:System.HelpIntfs.IHelpManager|IHelpManager]]'''.

Zum Aufrufen des registrierten externen Hilfe-Viewers kann im Code die Funktion '''HelpIntfs.GetHelpSystem''' aufgerufen werden, die auf das im '''HelpViewer.FHelpManager''' gespeicherte Objekt zugreift und dann ein '''IHelpManager'''-Typobjekt im Typobjekt '''[[lib_de:System.HelpIntfs.IHelpSystem|IHelpSystem]]''' zurückgibt. '''TApplication''' hat die Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpSystem|HelpSystem]]''', die auch den Zugriff auf dieses '''IHelpSystem'''-Typobjekt ermöglicht, über das '''TApplication'''-Methoden die Hilfe-Viewer-Funktionen aufrufen. '''IHelpSystem'''-Typobjekte stellen unter anderem die Hilfefunktionen '''[[lib_de:System.HelpIntfs.IHelpSystem.ShowContextHelp|IHelpSystem.ShowContextHelp]]''' und '''[[lib_de:System.HelpIntfs.IHelpSystem.ShowHelp|IHelpSystem.ShowHelp]]''' bereit. Diese Funktionen können von der Standard-Ereignisbehandlungsroutine '''OnHelp''' und dem Benutzercode aufgerufen werden.

==Schritte für die Anzeige der F1-Hilfe==

Wenn Sie F1 drücken, aktiviert die Anwendung die Standard-Ereignisbehandlungsroutine für das Ereignis '''OnHelp''' des Formulars mit dem Fokus. In den vorherigen Abschnitten dieses Themas wurden die theoretischen Aspekte des Setzens der Hilfeeigenschaften im Objektinspektor und das Hinzufügen des zur ordnungsgemäßen Aktivierung der Hilfeseite erforderlichen Codes behandelt.

Befolgen Sie zum Umsetzen dieser theoretischen Aspekte in die Praxis die folgenden Schritte.

===So zeigen Sie die F1-Hilfe an:===

# Setzen Sie die Eigenschaft '''HelpFile''' des globalen '''Application'''-Objekts (die Eigenschaft '''TApplication.HelpFile''') oder eines bestimmten Formulars (die Eigenschaft '''TForm.HelpFile'''). Zum Beispiel:

:
:: <code>TForm.HelpFile = Form1.chm</code>

<ol start="2"><li>Wählen Sie für ein bestimmtes Formular die Eigenschaft '''HelpType''' aus, und setzen Sie <code>htContext</code> oder <code>htKeyword</code>. Zum Beispiel:
</li>
</ol>

:
:: <code>TForm.HelpType = htContext</code>

:
:: Setzen Sie dann in der Eigenschaft '''TForm.HelpContext''' den entsprechenden <code>ContextID</code>-Wert. <code>ContextID</code> sollte ein Integerwert sein, der ein Thema in der in '''HelpFile''' angegebenen Hilfedatei festlegt. Bei CHM-Hilfedateien müssen Sie beispielsweise im '''[MAP]'''-Abschnitt Ihrer Projektdatei (.hhp) symbolische Kontext-IDs von Hilfethemen zu numerischen <code>ContextID</code>-Werten zuordnen. Zum Beispiel:
:: <code>TForm.HelpContext = 714</code>
:: Durch Drücken von F1 wird nun das Thema mit der <code>ContextID</code><code>714</code> aus einer in '''HelpFile''' angegebenen CHM-Hilfedatei angezeigt.
:: Oder:
:: <code>TForm.HelpType = htKeyword</code>
:: Setzen Sie dann in der Eigenschaft '''TForm.HelpKeyword''' den entsprechenden <code>Keyword</code>-Wert. Durch Drücken von F1 wird nun das Thema angezeigt, dessen <code>Alink</code>-Tag-Wert mit dem angegebenen <code>Keyword</code>-Wert übereinstimmt.

<ol start="3"><li>In {{Delphi}}-Anwendungen fügen Sie der '''uses'''-Klausel des Hauptmoduls Ihrer Anwendung die Unit '''Vcl.HtmlHelpViewer''' hinzu. 
In C++-Anwendungen fügen Sie die Direktive <code>#include Vcl.HtmlHelpViewer.hpp</code> hinzu.
 Fügen Sie <code>#pragma package(smart_init)</code> und <code>#pragma link "Vcl.HtmlHelpViewer"</code> hinzu. 
Damit wird definiert, dass Ihre Anwendung die API der Funktion '''HTMLHelp''' verwendet, die die CHM-Hilfedateien anzeigt.</li>
<li>Wählen Sie den Befehl '''Start > Start'''. Ihre Anwendung wird geöffnet.</li>
<li>Wählen Sie das Formular Form1 aus. Drücken Sie F1. Die automatisch erzeugte Standard-Ereignisbehandlungsroutine '''OnHelp''' zeigt das im '''HelpContext'''- (oder '''HelpKeyword'''-)Wert in der festgelegten .CHM-Hilfedatei angegebene Thema an.</li>
</ol>

Hierbei war keine manuelle Programmierung erforderlich. Die gesamte Behandlung für das Drücken von F1 wurde automatisch implementiert. Sie müssen nur die passenden Hilfeparameter im Objektinspektor eingeben.

==Siehe auch==

*[[Aufrufen von HTML-Hilfe aus Anwendungen|Aufrufen von HTML-Hilfe aus Anwendungen]]
**[[HTML-Hilfetypen|HTML-Hilfetypen]]
**[[Anpassen der F1-Hilfe in VCL-Anwendungen|Anpassen der F1-Hilfe in VCL-Anwendungen]]
**[[Anzeigen von Hilfe mit Hilfe-Schaltflächen|Anzeigen von Hilfe mit Hilfe-Schaltflächen]]
**[[Zuordnen von Hilfe zu Menübefehlen|Zuordnen von Hilfe zu Menübefehlen]]
**[[Anzeigen von Hilfe zu ausgewählten Menübefehlen|Anzeigen von Hilfe zu ausgewählten Menübefehlen]]
**[[Anzeigen von Kontexthilfe zu Bildschirmobjekten mit der Eigenschaft Hint|Anzeigen von Kontexthilfe zu Bildschirmobjekten mit der Eigenschaft Hint]]
* [[Hilfesystem-Interfaces|Hilfesystem-Interfaces]]
* [[Hilfe in einer VCL-Anwendung verwenden|Hilfe in einer VCL-Anwendung verwenden]][[en:Default Handling of F1 Help in VCL Applications|en:Default Handling of F1 Help in VCL Applications]]

[[Category:Windows-Entwicklerhandbuch]]
[[Category:Delphi]]
[[Category:C++]]

Standardbehandlung von F1-Hilfe in VCL-Anwendungen

2016-07-19T14:46:55Z

Esabatell: Internal review. LOC-22582

{{Parent|Aufrufen von HTML-Hilfe aus Anwendungen}}
__TOC__
Das Drücken von F1 ist das Standardvorgehen zum Aktivieren von Hilfe in Anwendungen. Die IDE von {{Variables|Product}} unterstützt Optionen zur Definition von Hilfeparametern für die automatische Erzeugung von Code zur Aktivierung der Hilfe beim Drücken von F1. In diesem Fall erzeugt {{Variables|Product}} automatisch den Standardcode, der zum Ausführen eines entsprechenden Aufrufs der Hilfebehandlungsfunktion beim Drücken von F1 in VCL-Anwendungen erforderlich ist.

In diesem Thema wird die Definition von Parametern für Aufrufe der Hilfebehandlungsfunktionen und die Ausführung dieser Aufrufe beschrieben. Die folgenden Erläuterungen beziehen sich ausschließlich auf VCL-GUI-Anwendungen.

==Erforderliche Hilfeparameter==

Beim Drücken von F1 wird in dem Formular, das den Fokus hat, das Ereignis '''[[lib_de:Vcl.Forms.TForm.OnHelp|OnHelp]]''' ausgelöst. Die Anwendung führt als Ergebnis die Standard-Ereignisbehandlungsroutine des Ereignisses '''OnHelp''' aus. Die IDE erzeugt die '''OnHelp'''-Ereignisbehandlungsroutine mit den angegebenen Hilfeparametern. Sie können in der IDE die Hilfeparameter '''HelpFile''', '''HelpType''', '''HelpContext''' und '''HelpKeyword''' festlegen. Diese Parameter werden in den folgenden Abschnitten beschrieben.

===HelpFile===

Zunächst müssen Sie die Hilfedateien festlegen, die die Hilfethemen für Ihre Anwendung enthalten. Sie können eine oder mehrere Hilfedateien angeben. Die Haupthilfedatei für eine Anwendung kann mit der Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpFile|TApplication.HelpFile]]''' des globalen '''[[lib_de:Vcl.Forms.TApplication|Application]]'''-Objekts und individuelle Hilfedateien für einzelne Formulare können mit der Eigenschaft '''[[lib_de:Vcl.Forms.TForm.HelpFile|TForm.HelpFile]]''' des zugehörigen '''[[lib_de:Vcl.Forms.TForm|Form]]'''-Objekts festgelegt werden.

Diese '''HelpFile'''-Dateien können beim Entwurf als entsprechende IDE-Eigenschaften für die programmseitige Definition der '''HelpFile'''-Eigenschaften des zugehörigen Objekts angegeben werden.

Normalerweise wird einer Anwendung die Haupthilfedatei über die Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpFile|HelpFile]]''' des globalen '''Application'''-Objekts zugewiesen.

Öffnen Sie das Dialogfeld '''Projektoptionen''' ('''Projekt > Optionen'''), und wählen Sie die Seite '''Erscheinungsbild''' (unter '''Anwendung''') aus. Geben Sie in das Feld '''Hilfedatei''' die Hilfedatei ein. Klicken Sie auf '''Durchsuchen'''. Das Dialogfeld '''Hilfedatei der Anwendung''' zeigt per Vorgabe nur die Dateien mit der Erweiterung .hlp an. Zum Festlegen von anderen Hilfedateitypen wählen Sie im Steuerelement '''Dateitypen''' den Typ <code>Alle Dateien (*.*)</code> aus. Anschließend können Sie Hilfedateien der Typen .CHM, .HTML und andere auswählen.)

Diese Option setzt die Eigenschaft '''Application.HelpFile'''. Diese Eigenschaft definiert die Haupthilfedatei für die Anwendung. Wenn die Anwendung einen Hilfebehandlungsbefehl empfängt, führt sie standardmäßig den Hilfebefehl mit dieser Hilfedatei aus.

Eine einzelne Hilfedatei für ein bestimmtes Formular können Sie mit der Eigenschaft '''HelpFile''' dieses Formulars festlegen.

Wählen Sie im Formular-Designer das Formular aus; im Objektinspektor werden die Eigenschaften dieses Formulars (siehe die folgende Abbildung) angezeigt:

[[Image:Help HelpFile.PNG|HelpFile]]

Geben Sie in der rechten Spalte der Eigenschaft '''HelpFile''' den Namen <code>Form1.chm</code> ein. Damit wird die Eigenschaft '''TForm.HelpFile''' des Objekts '''Form1''' definiert. Diese Eigenschaft setzt die Hilfedatei <code>Form1.chm</code> für das Formular '''Form1'''.

Die Anwendung sucht in der Regel die Hilfedatei in dem Verzeichnis, aus dem die ausführbare Datei der Anwendung ausgeführt wird. Wenn die angegebene Hilfedatei sich in einem anderen Verzeichnis befindet, sollten Sie daher den relativer Pfad zu dieser Datei angeben. Sie könnten beispielsweise <code>.\Help\Form1.chm</code> angeben.

Die '''OnHelp'''-Standard-Ereignisbehandlungsroutine verwendet die in der Eigenschaft '''HelpFile''' des Formulars mit dem Fokus angegebene Hilfedatei. Wenn die Eigenschaft '''TForm.HelpFile''' einen leeren String enthält, dann verwendet die Ereignisbehandlungsroutine die in der Eigenschaft '''HelpFile''' des globalen '''Application'''-Objekts angegebene Hilfedatei.

===HelpType, HelpContext und HelpKeyword===

Zum Erzeugen des Codes für die Standard-Ereignisbehandlungsroutine des Ereignisses '''OnHelp''' muss die IDE über das anzuzeigende Hilfethema informiert sein. Die Werte der Eigenschaften '''HelpContext''' und '''HelpKeyword''' können definieren, welches Thema angezeigt werden soll. Die Eigenschaft '''HelpType''' definiert, welche dieser beiden Eigenschaften verwendet werden soll.

Klicken Sie im Objektinspektor für das Formular mit der rechten Maustaste in die rechte Spalte der Eigenschaft '''HelpType'''. Wenn Sie den Wert <code>htContext</code> auswählen, dann wird der in der Eigenschaft '''HelpContext''' angegebene Wert verwendet. Bei dem Wert <code>htKeyword</code> wird der in der Eigenschaft '''HelpKeyword''' angegebene Wert verwendet.

==Ergänzen des erzeugten Codes==

Mit {{Variables|Product}} entwickelte Anwendungen verwenden zur Anzeige verschiedener Typen von Hilfedateien externe Hilfe-Viewer. Sie müssen Ihrer Anwendung mitteilen, welcher externe Hilfe-Viewer verwendet werden soll.

===Wrapper von externen Hilfe-Viewern===

Die VCL ist unabhängig von externen Hilfe-Viewer. Alle von den Standard-Ereignisbehandlungsroutinen der Hilfe verwendeten Hilfefunktionen sind in Interfaces der Unit '''[[lib_de:System.HelpIntfs|System.HelpIntfs]]''' deklariert. Die VCL stellt Packages mit Klassen bereit, die diese Interfaces mit einem bestimmten externen Hilfe-Viewer (für den speziellen Typ der Hilfedatei) implementieren. Beispielweise implementiert die Unit '''Vcl.HtmlHelpViewer''' für die Viewer von '''CHM'''-Hilfedateien (Microsoft HTML Help) einen Wrapper für die '''HTMLHelp'''-API.

Diese Unabhängigkeit (von externen Hilfe-Viewern) bedeutet, dass Sie nur in der '''uses'''-Klausel die geeignete Unit angeben müssen, die die Implementierung der '''HelpIntfs'''-Interfaces für einen bestimmten externen Hilfe-Viewer bereitstellt. Sie können beispielsweise die Unit '''Vcl.HtmlHelpViewer'''' zur Anzeige von '''CHM'''-Hilfedateien angeben.

Wenn Sie die Eigenschaften '''HelpFile''', '''HelpType''', '''HelpContext''' und '''HelpKeyword''' definiert haben, kann die '''OnHelp'''-Standard-Ereignisbehandlungsroutine die Hilfebehandlungsfunktion folgendermaßen verwenden:

IHelpSystem.ShowContextHelp(Form1.HelpContext, Form1.HelpFile);

Bei <code>HelpType = htContext</code> wie folgt:

IHelpSystem.ShowHelp(Form1.HelpKeyword, Form1.HelpFile);

Bei <code>HelpType = htKeyword</code>. Hier ist '''IHelpSystem''' das in der Unit '''HelpIntfs''' deklariert Interface.

===Zugreifen auf externe Hilfe-Viewer===

In den folgenden Abschnitten wird die Implementierung von '''IHelpSystem''' und anderen in der Unit '''HelpIntfs''' deklarierten Interfaces durch Klassen in einer Unit erläutert, die einen Wrapper für einen externen Hilfe-Viewer bereitstellt. Die Unit '''Vcl.HtmlHelpViewer''' enthält beispielsweise einen Wrapper für die '''HTMLHelp'''-Funktions-API. Die Unit ''''Vcl.HtmlHelpViewer''' implementiert die Klasse '''THTMLHelpViewer''', die eine Implementierung für Interfaces aus der Unit '''HelpIntfs''' bereitstellt. Die Klasse '''THTMLHelpViewer''' ist aber im '''implementation'''-Abschnitt der Unit deklariert. Deshalb müssen Sie wissen, wie auf Member dieser Klasse von außerhalb der Unit '''Vcl.HtmlHelpViewer''' zugegriffen werden kann.

Die Unit '''HelpIntfs''' enthält zwei globale Funktionen: '''[[lib_de:System.HelpIntfs.RegisterViewer|RegisterViewer]]''' und '''[[lib_de:System.HelpIntfs.GetHelpSystem|GetHelpSystem]]'''. Diese Funktionen haben die folgenden Deklarationen:

function RegisterViewer(const newViewer: ICustomHelpViewer; out Manager: IHelpManager): Integer;
function GetHelpSystem(out System: IHelpSystem): Boolean;

Im '''initialization'''-Abschnitt der Unit '''Vcl.HtmlHelpViewer''' werden die folgenden Aufrufe ausgeführt:

HelpViewer := THtmlHelpViewer.Create;
HelpIntfs.RegisterViewer(HelpViewerIntf, HelpViewer.FHelpManager);

Diese Aufrufe erstellen ein Objekt vom Typ '''THtmlHelpViewer''' und registrieren das gekapselte externe Hilfe-Viewer-Objekt als ein Hilfesystem-Managerobjekt (''HelpViewer.FHelpManager'') vom Typ '''[[lib_de:System.HelpIntfs.IHelpManager|IHelpManager]]'''.

Zum Aufrufen des registrierten externen Hilfe-Viewers kann im Code die Funktion '''HelpIntfs.GetHelpSystem''' aufgerufen werden, die auf das im '''HelpViewer.FHelpManager''' gespeicherte Objekt zugreift und dann ein '''IHelpManager'''-Typobjekt im Typobjekt '''[[lib_de:System.HelpIntfs.IHelpSystem|IHelpSystem]]''' zurückgibt. '''TApplication''' hat die Eigenschaft '''[[lib_de:Vcl.Forms.TApplication.HelpSystem|HelpSystem]]''', die auch den Zugriff auf dieses '''IHelpSystem'''-Typobjekt ermöglicht, über das '''TApplication'''-Methoden die Hilfe-Viewer-Funktionen aufrufen. '''IHelpSystem'''-Typobjekte stellen unter anderem die Hilfefunktionen '''[[lib_de:System.HelpIntfs.IHelpSystem.ShowContextHelp|IHelpSystem.ShowContextHelp]]''' und '''[[lib_de:System.HelpIntfs.IHelpSystem.ShowHelp|IHelpSystem.ShowHelp]]''' bereit. Diese Funktionen können von der Standard-Ereignisbehandlungsroutine '''OnHelp''' und dem Benutzercode aufgerufen werden.

==Schritte für die Anzeige der F1-Hilfe==

Wenn Sie F1 drücken, aktiviert die Anwendung die Standard-Ereignisbehandlungsroutine für das Ereignis '''OnHelp''' des Formulars mit dem Fokus. In den vorherigen Abschnitten dieses Themas wurden die theoretischen Aspekte des Setzens der Hilfeeigenschaften im Objektinspektor und das Hinzufügen des zur ordnungsgemäßen Aktivierung der Hilfeseite erforderlichen Codes behandelt.

Befolgen Sie zum Umsetzen dieser theoretischen Aspekte in die Praxis die folgenden Schritte.

===So zeigen Sie die F1-Hilfe an:===

# Setzen Sie die Eigenschaft '''HelpFile''' des globalen '''Application'''-Objekts (die Eigenschaft '''TApplication.HelpFile''') oder eines bestimmten Formulars (die Eigenschaft '''TForm.HelpFile'''). Zum Beispiel:

:
:: <code>TForm.HelpFile = Form1.chm</code>

<ol start="2"><li>Wählen Sie für ein bestimmtes Formular die Eigenschaft '''HelpType''' aus, und setzen Sie <code>htContext</code> oder <code>htKeyword</code>. Zum Beispiel:
</li>
</ol>

:
:: <code>TForm.HelpType = htContext</code>

:
:: Setzen Sie dann in der Eigenschaft '''TForm.HelpContext''' den entsprechenden <code>ContextID</code>-Wert. <code>ContextID</code> sollte ein Integerwert sein, der ein Thema in der in '''HelpFile''' angegebenen Hilfedatei festlegt. Bei CHM-Hilfedateien müssen Sie beispielsweise im '''[MAP]'''-Abschnitt Ihrer Projektdatei (.hhp) symbolische Kontext-IDs von Hilfethemen zu numerischen <code>ContextID</code>-Werten zuordnen. Zum Beispiel:
:: <code>TForm.HelpContext = 714</code>
:: Durch Drücken von F1 wird nun das Thema mit der <code>ContextID</code><code>714</code> aus einer in '''HelpFile''' angegebenen CHM-Hilfedatei angezeigt.
:: Oder:
:: <code>TForm.HelpType = htKeyword</code>
:: Setzen Sie dann in der Eigenschaft '''TForm.HelpKeyword''' den entsprechenden <code>Keyword</code>-Wert. Durch Drücken von F1 wird nun das Thema angezeigt, dessen <code>Alink</code>-Tag-Wert mit dem angegebenen <code>Keyword</code>-Wert übereinstimmt.

<ol start="3"><li>In {{Delphi}}-Anwendungen fügen Sie der '''uses'''-Klausel des Hauptmoduls Ihrer Anwendung die Unit '''Vcl.HtmlHelpViewer''' hinzu. 
In C++-Anwendungen fügen Sie die Direktive <code>#include Vcl.HtmlHelpViewer.hpp</code> hinzu.
 Fügen Sie <code>#pragma package(smart_init)</code> und <code>#pragma link "Vcl.HtmlHelpViewer"</code> hinzu. 
Damit wird definiert, dass Ihre Anwendung die API der Funktion '''HTMLHelp''' verwendet, die die CHM-Hilfedateien anzeigt.</li>
<li>Wählen Sie den Befehl '''Start > Start'''. Ihre Anwendung wird geöffnet.</li>
<li>Wählen Sie das Formular Form1 aus. Drücken Sie F1. Die automatisch erzeugte Standard-Ereignisbehandlungsroutine '''OnHelp''' zeigt das im '''HelpContext'''- (oder '''HelpKeyword'''-)Wert in der festgelegten .CHM-Hilfedatei angegebene Thema an.</li>
</ol>

Hierbei war keine manuelle Programmierung erforderlich. Die gesamte Behandlung für das Drücken von F1 wurde automatisch implementiert. Sie müssen nur die passenden Hilfeparameter im Objektinspektor eingeben.

==Siehe auch==

*[[Aufrufen von HTML-Hilfe aus Anwendungen|Aufrufen von HTML-Hilfe aus Anwendungen]]
**[[HTML-Hilfetypen|HTML-Hilfetypen]]
**[[Anpassen der F1-Hilfe in VCL-Anwendungen|Anpassen der F1-Hilfe in VCL-Anwendungen]]
**[[Anzeigen von Hilfe mit Hilfe-Schaltflächen|Anzeigen von Hilfe mit Hilfe-Schaltflächen]]
**[[Zuordnen von Hilfe zu Menübefehlen|Zuordnen von Hilfe zu Menübefehlen]]
**[[Anzeigen von Hilfe zu ausgewählten Menübefehlen|Anzeigen von Hilfe zu ausgewählten Menübefehlen]]
**[[Anzeigen von Kontexthilfe zu Bildschirmobjekten mit der Eigenschaft Hint|Anzeigen von Kontexthilfe zu Bildschirmobjekten mit der Eigenschaft Hint]]
* [[Hilfesystem-Interfaces|Hilfesystem-Interfaces]]
* [[Hilfe in einer VCL-Anwendung verwenden|Hilfe in einer VCL-Anwendung verwenden]][[en:Default Handling of F1 Help in VCL Applications|en:Default Handling of F1 Help in VCL Applications]]

[[Category:Windows-Entwicklerhandbuch]]
[[Category:Delphi]]
[[Category:C++]]

C++-Compiler Erweitert

2016-07-04T09:04:10Z

Esabatell: 1 Version: Internal review. LOC-21921

{{Parent|C++-Compiler}}

{{Menu|Projekt > Optionen > C++-Compiler > Erweitert}}

In diesem Dialogfeld legen Sie erweiterte Optionen für den C++-Compiler fest.

{| border="1" frame="hsides" rules="rows"
|-
! '''Optionen'''
! '''Beschreibung'''
|- valign="top"
|
Ziel, Übernehmen, Speichern
|
Siehe [[Optionen für das Ziel|Optionen für das Ziel]].
|- valign="top"
|
Gemeinsame Elemente
|
Siehe [[Gemeinsame Elemente auf den Projektoptionsseiten|Gemeinsame Elemente auf den Projektoptionsseiten]].
|}

==Assembler-Optionen==

{| border="1" frame="hsides" rules="cells"
|-
! rowspan="2" | '''Assembler-Optionen'''
! rowspan="2" | '''Beschreibung'''
! colspan="6" | {{f|cmd|Compiler-Optionen|Compiler-Unterstützung}}
|-
! bcc32
! bcc32c
! bcc64
! bccosx
! bcciosarm
! bcciosarm64
! bccaarm
|- valign="top"
|
Assembler-Optionen
|
Geben Sie zusätzliche Assembler-Optionen (wie z. B. {{Code|-TX}} oder {{Code|-T}}) ein, die für das aktuelle Projekt verwendet werden sollen. Übergibt die angegebenen Optionen an den Assembler, der mit der Option '''Zu verwendenden Assembler festlegen''' festgelegt wurde, oder an den Standard-Assembler (TASM32 in 32-Bit-Windows).

32-Bit-Compiler, die durch Clang erweitert wurden, erstellen keine Assembly-Dateien, die mit TASM32 assembliert werden können.
| {{f|cmd||{{V}}}}
| {{f|cmd|N/A}}
| {{f|cmd|Plattform nicht unterstützt}}
| {{f|cmd|Plattform nicht unterstützt}}
| {{f|cmd|Plattform nicht unterstützt}}
| {{f|cmd|Plattform nicht unterstützt}}
| {{f|cmd|Plattform nicht unterstützt}}
|- valign="top"
|
In .ASM compilieren, dann in .OBJ zusammenstellen
|
{{f|cmd|Veranlasst, dass der Compiler zunächst aus dem C++-Quelltext (oder C-Quelltext) eine .ASM-Datei (entspricht der Befehlszeilenoption -S) erzeugt.|Veranlasst, dass der Compiler zunächst aus dem C++-Quelltext (oder C-Quelltext) eine .ASM-Datei erzeugt.}} Dann ruft der Compiler TASM32 (oder den mit der Option '''Zu verwendenden Assembler festlegen''' angegebenen Assembler) auf, um eine .OBJ-Datei aus der .ASM-Datei zu erstellen. Die .ASM-Datei wird anschließend gelöscht.

Das Programm kann nicht mit der Option -B compiliert werden, wenn im C- oder C++-Quelltext statische globale Variablen deklariert werden, die Schlüsselwörter in der Assembler-Sprache sind. Der Compiler stellt nämlich statischen globalen Variablen keinen Unterstrich voran (wie bei anderen Variablen), und die Assembler-Schlüsselwörter erzeugen Fehler, wenn der Code zusammengestellt wird. Der Vorgabewert ist False.
|
{{f|cmd|'''In .ASM compilieren''' -S '''In .OBJ zusammenstellen''' -B|{{V}}}}
|
{{f|cmd|N/A Plattform nicht unterstützt}}
|
{{f|cmd|N/A Plattform nicht unterstützt}}
|
{{f|cmd|N/A N/A}}
|
{{f|cmd|N/A Plattform nicht unterstützt}}
|
{{f|cmd|N/A Plattform nicht unterstützt}}
|
{{f|cmd|N/A Plattform nicht unterstützt}}
|- valign="top"
|
Zu verwendenden Assembler festlegen
|
Stellt Anweisungen zusammen und verwendet dabei den angegebenen Dateinamen als Assembler. Der 32-Bit-Windows-Compiler verwendet TASM32 als Standard-Assembler. Die [[Image:ProjectOptionsEllipsis.jpg|Ellipse]]-Popup-Schaltfläche ist unter [[Gemeinsame Elemente auf den Projektoptionsseiten|Gemeinsame Elemente auf den Projektoptionsseiten]] beschrieben.
|
{{f|cmd|-E|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|N/A}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|}

==Gleitkomma-Optionen==

{| border="1" frame="hsides" rules="cells"
|-
! rowspan="2" | '''Gleitkomma-Optionen'''
! rowspan="2" | '''Beschreibung'''
! colspan="7" | {{f|cmd|Compiler-Optionen|Compiler-Unterstützung}}
|-
!   bcc32  
!   bcc32c  
!   bcc64  
!   bccosx  
!   bcciosarm  
!   bcciosarm64  
!   bccaarm  
|- valign="top"
|
FDIV-Fehler korrigieren
|
Einige Pentium-Prozessoren der ersten Serie führen bestimmte Gleitkommadivisionen nicht mit voller Genauigkeit aus. Auch wenn die Chancen gering sind, dass dieses Problem heute noch auftaucht, kann mit dieser Option Code eingefügt werden, der eine Gleitkommaoperation so emuliert, dass sicher das richtige Ergebnis geliefert wird. Die Geschwindigkeit der Ausführung des Prozessorbefehls FDIV sinkt dann allerdings. Diese Option korrigiert FDIV-Befehle nur in Modulen, die Sie compilieren. Die Laufzeitbibliothek enthält ebenfalls FDIV-Befehle, die von dieser Option nicht verändert werden. Wenn Sie das Problem auch in den Laufzeitbibliotheken beheben möchten, müssen Sie sie mit dieser Einstellung neu compilieren.

Die folgenden Funktionen verwenden FDIV-Befehle der Assembler-Sprache und werden von dieser Option nicht korrigiert:

<code>acos</code>, <code>acosl</code>, <code>acos</code>, <code>asin</code>, <code>asinl</code>, <code>atan</code>, <code>atan2</code>, <code>atan2l</code>, <code>atanl</code>, <code>cos</code>, <code>cosh</code>, <code>coshl</code>, <code>cosl</code>, <code>exp</code>, <code>expl</code>,
<code>fmod</code>, <code>fmodl</code>, <code>pow</code>, <code>pow10</code>,
<code>pow10l</code>, <code>powl</code>, <code>sin</code>, <code>sinh</code>,
<code>sinhl</code>, <code>sinl</code>, <code>tan</code>, <code>tanh</code>,
<code>tanhl</code>, <code>tanl</code>

Funktionen, die eine Gleitkommazahl in einen String konvertieren oder umgekehrt (z. B. '''printf''' oder '''scanf'''), werden von dieser Option ebenfalls nicht korrigiert. Der Vorgabewert ist False.
|
{{f|cmd|-fp|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-fp|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|- valign="top"
|
Schnelles Gleitkomma
|
Gleitkommaoperationen können ohne Berücksichtigung expliziter oder impliziter Typkonvertierungen optimiert werden. Berechnungen werden dann schneller als im ANSI-Modus durchgeführt.

Diese Option dient dazu, bestimmte Optimierungen zu ermöglichen, die auf technischer Ebene keiner korrekten C-Semantik entsprechen.

<source lang="cpp">
double x; x = (float) (3.5*x);
</source>
Um dies korrekt ausführen zu können, wird x mit 3,5 multipliziert. Das daraus resultierende Double wird entsprechend der Gleitkommagenauigkeit gekürzt und dann als Double in x gespeichert. Bei der schnellen Gleitkommaoperation wird das lange Double-Produkt direkt in ein Double konvertiert. Da nur wenige Programme auf diese hohe Genauigkeit angewiesen sind, ist das schnelle Gleitkomma die Standardeinstellung.

Wenn diese Option deaktiviert ist {{f|cmd|(-ff-)}}, folgt der Compiler strikt den ANSI-Regeln zur Gleitkommakonvertierung. 
Der Vorgabewert ist True.
|
{{f|cmd|-ff|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-ff|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|- valign="top"
|
Stille Gleitkommavergleiche
|
Verwendet die stille Gleitkommaanweisung (FUCOMP). 

Der Vorgabewert ist True.
|
{{f|cmd|-fq|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-fq|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|- valign="top"
|
Benötigte mathematische Funktionen zur Angabe von Fehlern
|
Diese Option gibt dem Compiler an, dass Programme {{code|errno}} verlässlich testen können, nachdem mathematische Standard-Bibliotheksfunktionen aufgerufen wurden. 
Der Vorgabewert ist True.
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-fmath-errno|{{V}}}}
|
{{f|cmd|-fmath-errno|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-fmath-errno|{{V}}}}
|
{{f|cmd|-fmath-errno|{{V}}}}
|
{{f|cmd|-fmath-errno|{{V}}}}
|}

==Weitere Optionen==

{| border="1" frame="hsides" rules="cells"
|-
! rowspan="2" | '''Weitere Optionen'''
! rowspan="2" | '''Beschreibung'''
! colspan="7" | {{f|cmd|Compiler-Optionen|Compiler-Unterstützung}}
|-
!      bcc32     
!      bcc32c     
!     bcc64    
!     bccosx    
!     bcciosarm    
!     bcciosarm64    
!     bccaarm    
|- valign="top"
|
Weitere Optionen für die Übergabe an den Compiler
|
Geben Sie weitere Compiler-Optionen ein, die für das aktuelle Projekt hinzugefügt werden sollen.
| {{f|cmd||{{V}}}}
| {{f|cmd||{{V}}}}
| {{f|cmd||{{V}}}}
| {{f|cmd||{{V}}}}
| {{f|cmd||{{V}}}}
| {{f|cmd||{{V}}}}
| {{f|cmd||{{V}}}}
|- valign="top"
|
Codeseite
|
Legt den '''Standardzeichensatz für Text''' fest, der im ANSI-Quellcode verwendet wird, wenn der Quellcode kein BOM (Byte Order Mark) enthält.

Bietet Unterstützung für benutzerdefinierte Codeseiten. Damit wird dem Compiler mitgeteilt, wie Multibyte-Zeichensätze (MBCS) analysiert und konvertiert werden sollen.

Im Eingabefeld können Sie Folgendes angeben:
* Die tatsächliche [http://msdn.microsoft.com/en-us/library/dd317756%28v=vs.85%29.aspx Codeseitennummer (EN)]. Zum Beispiel:
** 1250 für europäisch
** 932 für japanisch
* Textbezeichner für die Codeseitencodierungen, wie [http://www.unicodetools.com/unicode/codepage-utf8.php UTF8 (EN)], UTF32 oder SJIS (für Shift-JIS für japanisch)

Wenn Sie beispielsweise 65001 oder UTF8 für die Option -CP angeben, unterstützt der Compiler die UTF8-Codierung für Quellcode ohne BOM.

Es gibt zwei wesentliche Bereiche, wo Codeseiten eine Rolle spielen:
* String-Konstanten, Kommentare, #error- und #pragma-Direktiven
:Für MBCS-Strings, die zu dieser Gruppe gehören, müssen Sie die korrekte Codeseite mit einem Aufruf der Windows-API-Funktion '''IsDBCSLeadByteEx''' angeben. Mit dieser Funktion geben Sie die Codeseite an, um die MBCS-Strings für eine bestimmte Gebietseinstellung korrekt zu analysieren (z. B. kann der Compiler damit Backslashes in nachgestellten MBCS-Bytes korrekt analysieren).
* Wide-Zeichen-String-Konstanten {{f|cmd|(wie [[BCC32.EXE: Der C++-32-Bit-Befehlszeilen-Compiler#Verzeichnisse für Befehlszeilenoptionen|durch L]]'<MBCS string>') angegeben}}
:Für MBCS-Strings, die zu dieser Gruppe gehören (Wide-Zeichen-String-Konstanten), geben Sie die korrekte Codeseite an, um die MBCS-Strings mit der Windows-API-Funktion '''MultiByteToWideChar''' in Unicode-Strings umzuwandeln.

{{f|cmd|
'''Syntax'''

Aktivieren Sie das Code-Paging mit der folgenden Befehlszeilenoption:
: {{Code|-CPnnnn}}

In dieser Syntax ist ''nnnn'' der numerische Wert der Codeseite, die für eine bestimmte Gebietseinstellung verwendet werden soll.
 }}
Es gelten folgende Regeln:
# Bei der Einstellung des Code-Paging müssen die numerischen Werte zu den Werten der Microsoft NLS Code Page ID passen. Zum Beispiel:
#* Verwenden Sie 437 für MS-DOS-Anwendungen aus den Vereinigten Staaten.
#* Verwenden Sie 932 für japanische.
# Der numerische Wert nnnn muss eine gültige Codeseite sein, die vom Betriebssystem unterstützt wird.
# Benutzer müssen eventuell die relevanten Windows NLS-Dateien installieren, um sicherzustellen, dass asiatische Gebietseinstellungen und Codeseiten zugänglich sind. Nähere Informationen hierzu finden Sie in der Dokumentation zu [http://msdn.microsoft.com/en-us/library/ee265892(v=bts.10).aspx Microsoft NLS Code Page (EN)].
# Wenn Sie keinen Codeseitenwert angeben, ruft der Compiler die Windows-API-Funktion '''GetACP''' auf, um die Standard-Codeseite des Systems zu ermitteln. Dieser Wert wird dann verwendet, wenn Strings wie oben dargestellt behandelt werden müssen.

Die Vorgabe ist, keine Codeseite zu verwenden.
|
{{f|cmd|-CP|{{V}}}}
|
{{f|cmd|2=-finput-charset=0}}
|
{{f|cmd|N/A}}
|
{{f|cmd|-CP|{{V}}}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|- valign="top"
|
Ausführungszeichensatz
|
Legt den '''Ausführungszeichensatz''' fest, der für ANSI-Strings in der ausführbaren Datei verwendet wird.

Die Option '''Ausführungszeichensatz''' ist für die Verwendung in geräteübergreifenden Anwendungen konzipiert.
 
Für den Windows-Host oder ein Windows-Ziel entspricht die Standardtextcodierung der ANSI-Codierung (der Option '''Codeseite''') der Anwendung.
 
Bei geräteübergreifenden Anwendungen kann die ANSI-Codierung des Ziels von der ANSI-Codierung des Host abweichen. POSIX-Systeme (einschließlich OS X und das neueste Linux) verwenden z. B. UTF8 als Systemcodierung, daher muss der '''Ausführungszeichensatz''' "UTF8" sein.
Wenn Sie eine Anwendung mit "932" als '''Ausführungszeichensatz''' compilieren, werden alle String-Literale in der "932"-Codierung (japanisches SJIS) codiert, ungeachtet dessen, ob die Compilier-Umgebung "932" ist. Wide-String-Literale (z. B. L"Test") sind von dieser Option nicht betroffen.

In manchen Fällen wird der Wert der Option '''Codeseite''' für die Option '''Ausführungszeichensatz''' verwendet. Die folgende Matrix verdeutlicht die Beziehung zwischen den Optionen '''Codeseite''' und '''Ausführungszeichensatz''':
{| class="wikitable"
|-
! colspan="2" | Ist die Option festgelegt?
! rowspan="2" | Beschreibung
|- valign="top"
! Codeseite
! Ausführungszeichensatz
|- valign="top"
|
|
|
*Für Windows-Ziele verwendet der Compiler die Windows-Systemcodeseite ({{Code|CP_ACP}}) als Textzeichensatz und als Ausführungszeichensatz.
*Für Mac OS X-Ziele verwendet der Compiler die Windows-Systemcodeseite ({{Code|CP_ACP}}) als Textzeichensatz und UTF-8 als Ausführungszeichensatz auf Mac OS X.
|- valign="top"
|
{{V}}
|
|
Der Compiler verwendet den Wert der '''Codeseite''' als Textzeichensatz und als Ausführungszeichensatz.
|- valign="top"
|
|
{{V}}
|
Der Compiler verwendet den Wert des '''Ausführungszeichensatzes''' als Ausführungszeichensatz und die Systemcodeseite ({{Code|CP_ACP}}) für ein Windows-Ziel oder eine plattformspezifische Codierung für ein plattformübergreifendes Ziel ({{Code|LC_CTYPE}} auf Mac OS X).
|- valign="top"
|
{{V}}
|
{{V}}
|
Der Compiler verwendet den Wert der '''Codeseite''' als Textzeichensatz und den Wert des '''Ausführungszeichensatzes''' als Ausführungszeichensatz.
|}
|
{{f|cmd|-CE|{{V}}}}
|
{{f|cmd|2=-fexec-charset=0}}
|
{{f|cmd|N/A}}
|
{{f|cmd|-CE|{{V}}}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|- valign="top"
|
Minimale fortlaufende Blockgröße für Speicherzuweisung
|
Gibt die minimale Größe an, die für die fortlaufende Speicherzuweisung verwendet wird.

Der Vorgabewert ist (no =nMB). Das bedeutet, dass der größtmögliche Block verwendet wird.

Diese Option können Sie beispielsweise zum Compilieren von großen Projekten ohne PCH oder für sehr große (evtl. vom Computer erzeugte) Quelldateien verwenden, solche, die umfangreichen Quelltext enthalten, der zu vielen Deklarationen pro Datei führt.
|
{{f|cmd|-savemem|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-savemem|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|- valign="top"
|
Vorzeichenloser char-Typ
|
Der Compiler behandelt die '''char'''-Deklarationen so, als würde es sich um einen '''unsigned char'''-Typ (vorzeichenloser Zeichentyp) handeln, der für die Kompatibilität mit anderen Compilern sorgt. 
Vorgabe = False ('''char'''-Typ mit Vorzeichen).
|
{{f|cmd|-K|{{V}}}}
|
{{f|cmd|-funsigned-char}}
|
{{f|cmd|N/A}}
|
{{f|cmd|-K|{{V}}}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|- valign="top"
|
Universelle iOS-Binärdatei generieren (armv7 + arm64)
|
Der Compiler erstellt eine universelle Binärdatei für 32-Bit- und 64-Bit-iOS. 
Die Vorgabe ist False (nur eine 64-Bit-Binärdatei wird erstellt).
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd||{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|}

==Quelltextoptionen==

{| border="1" frame="hsides" rules="cells"
|-
! rowspan="2" | '''Quelltextoptionen'''
! rowspan="2" | '''Beschreibung'''
! colspan="7" | {{f|cmd|Compiler-Optionen|Compiler-Unterstützung}}
|-
!   bcc32  
!   bcc32c  
!   bcc64  
!   bccosx  
!   bcciosarm  
!   bcciosarm64  
!   bccaarm  
|- valign="top"
|
Verschachtelte Kommentare aktivieren
|
Verschachtelt Kommentare in C- und C++-Quelltextdateien. Solche Kommentare sind in Standard-C-Implementierungen nicht zulässig, und sie sind auch nicht portierbar.
 Der Vorgabewert ist False.<blockquote>'''Hinweis:''' Sie können mit konditionalen Compilier-Direktiven große Codeblöcke, die Kommentare enthalten, in Kommentare umwandeln:
<source lang="cpp">
#if 0
// ...
/* ... */
#endif
</source></blockquote>
|
{{f|cmd|-C|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-C|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|- valign="top"
|
Bezeichnerlänge
|
Gibt die Anzahl signifikanter Zeichen (jene, die vom Compiler erkannt werden) in einem Bezeichner an. Mit Ausnahme von C++, wo es für Bezeichner keine Längenbeschränkung gibt, werden Bezeichner nur dann als unterschiedlich angesehen, wenn sie sich in den signifikanten Zeichen unterscheiden. Dies betrifft Variablen, Namen von Präprozessor-Makros und Namen von Struktur-Membern.

Gültige Werte für die Länge sind 0 und 8 bis 250, wobei 0 die Maximallänge von 250 Zeichen bedeutet. {{CBuilder}} unterscheidet standardmäßig 250 Zeichen pro Bezeichner. Andere Systeme (darunter auch einige UNIX-Compiler) ignorieren das neunte und alle folgenden Zeichen. Wenn Sie eine Anwendung auf andere Systeme portieren möchten, sollten Sie den Quelltext mit einer kleineren Anzahl signifikanter Zeichen compilieren. So können Sie Namenskonflikte in langen Bezeichnern aufspüren, die abgeschnitten wurden. Der Vorgabewert beträgt 250.
|
{{f|cmd|-i|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|-i|{{V}}}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|
{{f|cmd|Plattform nicht unterstützt}}
|}

==String-Optionen==

{| border="1" frame="hsides" rules="cells"
|-
! rowspan="2" | '''String-Optionen'''
! rowspan="2" | '''Beschreibung'''
! colspan="7" | {{f|cmd|Compiler-Optionen|Compiler-Unterstützung}}
|-
!   bcc32  
!   bcc32c  
!   bcc64  
!   bccosx  
!   bcciosarm  
!   bcciosarm64  
!   bccaarm  
|- valign="top"
|
Doppelte Strings zusammenführen
|
Verbindet zwei literale Strings, wenn einer mit dem anderen identisch ist. Daraus entstehen kleinere Programme, die jedoch etwas mehr Zeit zum Compilieren benötigen. Fehler können dann entstehen, wenn einer der Strings verändert wird. Der Vorgabewert ist False.
|
{{f|cmd|-d|{{V}}}}
|
{{f|cmd|-fmerge-all-constants}}
|
{{f|cmd|N/A}}
|
{{f|cmd|-d|{{V}}}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|- valign="top"
|
Schreibgeschützte Strings
|
Stellt für Strings zugewiesenen Speicher in das schreibgeschützte Datensegment. Der Vorgabewert ist False.
|
{{f|cmd|-dc|{{V}}}}
|
{{f|cmd|-fconst-strings}}
|
{{f|cmd|N/A}}
|
{{f|cmd|-dc|{{V}}}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|- valign="top"
|
Schreibbare Strings
|
Stellt für Strings zugewiesenen Speicher in das beschreibbare Datensegment. 
Der Vorgabewert ist False.
|
{{f|cmd|-dw|{{V}}}}
|
{{f|cmd|-fwritable-strings}}
|
{{f|cmd|N/A}}
|
{{f|cmd|-dw|{{V}}}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|
{{f|cmd|N/A}}
|}

==Siehe auch==

* [[C++ (Gemeinsame Optionen)|C++ (Gemeinsame Optionen)]]
* [[BCC32C.EXE|BCC32C.EXE]]
* [[BCC32.EXE: Der C++-32-Bit-Befehlszeilen-Compiler|BCC32.EXE: Der C++-Compiler für 32-Bit-Windows]]
* [[BCC64.EXE: Der C++-Compiler für 64-Bit-Windows|BCC64.EXE: Der C++-Compiler für 64-Bit-Windows]]
* [[BCCOSX.EXE: Der C++-Compiler für OS X|BCCOSX.EXE: Der C++-Compiler für OS X]]
* [[BCCIOSARM.EXE: Der C++-Compiler für 32-Bit-iOS-Geräte|BCCIOSARM: Der C++-Compiler für 32-Bit-iOS-Geräte]]
* [[BCCIOSARM64.EXE: Der C++-Compiler für 64-Bit-iOS-Geräte|BCCIOSARM64: Der C++-Compiler für 64-Bit-iOS-Geräte]]
* [[BCCAARM.EXE: Der C++-Compiler für Android|BCCAARM.EXE: Der C++-Compiler für Android]]

[[Category:C++]]
[[Category:IDE-Referenz]]
[[Category:AMMigrate]]

C++-Compiler Erweitert

2016-07-04T09:04:09Z

Esabatell: Internal review. LOC-21921

Mobile-Tutorial: Verwenden einer Landkarten-Komponente für die Arbeit mit Landkarten (iOS und Android)

2016-07-04T09:01:47Z

Esabatell: 1 Version: Internal review. LOC-21921

{{Parent|Mobile-Tutorials: Mobile Anwendungsentwicklung (iOS und Android)}}

{{FM}} kapselt eine Landkarten-Komponente als '''[[lib_de:FMX.Maps.TMapView|TMapView]]'''. Mit dieser Komponente können Sie auf Landkarten-APIs zugreifen, die folgendermaßen von der Zielplattform abhängig sind:

* Auf Android-Geräten: [https://developers.google.com/maps/documentation/android/ Google Maps Android API (EN)]
* Auf iOS-Geräten: [https://developer.apple.com/library/ios/documentation/MapKit/Reference/MapKit_Framework_Reference Map Kit Framework (EN)]

In diesem Tutorial wird beschrieben, wie Sie eine einfache {{FM}}-Anwendung erstellen, in der die Komponente '''[[lib_de:FMX.Maps.TMapView|TMapView]]''' verwendet wird.

{|
|-
!''' iOS'''
! ''' Android'''
|-
| style="vertical-align: top;" |
[[File:MapKit maps.png|300px]] 
'''iPad'''
|
[[File:Google maps.png|266px]] 
'''Android (LG - E612)'''
|}

==Grundlegende Funktionen der TMapView-Komponente==

Die [[lib_de:FMX.Maps.TMapView|TMapView]]-Komponente fügt mobilen Anwendungen interaktive Landkarten hinzu. Grundlegende Funktionen dieser Komponente:

* '''Vier Kartenarten''': Normal, Satellit, Hybrid und (nur für Android) Terrain
* '''Gesten-Steuerelement''': Gesten-Steuerelemente für intuitive Neigung, Drehen und Zoomen
* '''Steuerung der Kartenansicht''': Möglichkeit, die Karteneigenschaften, wie Kartenmittelpunktkoordinaten, Kartenausrichtung usw., zu steuern

==Erstellen einer Beispielanwendung==

In diesem Abschnitt wird eine einfache Anwendung (für die Android- und iOS-Zielplattformen) erstellt, in der die Verwendung der [[lib_de:FMX.Maps.TMapView|TMapView]]-Komponente gezeigt wird. Die Anwendung demonstriert die folgenden Techniken:

* Auswählen einer Kartenart
* Drehen der Karte
* Angeben der Koordinaten des Kartenmittelpunkts
* Hinzufügen von Markern zu der Karte

===Konfigurieren von Android-Anwendungen für die Verwendung der TMapView-Komponente===

Bevor Sie Google Maps verwenden können, benötigen Sie einen Key für '''Google Maps Android API v2''' (kostenlos erhältlich). Ohne diesen Key erzeugt Ihre App einen Laufzeitfehler.

Außerdem müssen Sie einige [[Verwendet Berechtigungen|Berechtigungen]] und Projektoptionen für Ihre Anwendung konfigurieren.

Eine detaillierte Anleitung zum Konfigurieren Ihrer Anwendung finden Sie unter '''[[Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps|Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps]]'''.

===Entwerfen der Benutzeroberfläche===

# Erstellen Sie eine neue [[Geräteübergreifende Anwendung|geräteübergreifende Anwendung]], indem Sie Folgendes auswählen:
#* <l s="delphi" /> Für '''{{Delphi}}''': {{Menu|Datei > Neu > Geräteübergreifende Anwendung - {{Delphi}} > Leere Anwendung}}<l e="delphi" />
#* <l s="cpp" /> Für '''C++''': {{Menu|Datei > Neu > Geräteübergreifende Anwendung - {{CBuilderUI}} > Leere Anwendung}}<l e="cpp" />
# Wählen Sie in der [[Tool-Palette|Tool-Palette]] zwei '''[[lib_de:FMX.StdCtrls.TToolBar|TToolBar]]'''-Komponenten aus, und ziehen Sie sie in den [[Formular-Designer|Formular-Designer]].
# Wählen Sie in der [[Tool-Palette|Tool-Palette]] die Komponente '''[[lib_de:FMX.Maps.TMapView|TMapView]]''' aus, und ziehen Sie sie in den [[Formular-Designer|Formular-Designer]].
# Setzen Sie im [[Objektinspektor|Objektinspektor]] die Eigenschaft '''Align''' von '''TMapView''' auf <code>Client</code>.
# Setzen Sie im [[Objektinspektor|Objektinspektor]] die Eigenschaften '''Align''' der beiden TToolBar-Komponenten auf <code>Top</code> bzw. <code>Bottom</code>.

====Entwerfen der Symbolleisten für die Anwendung====

Setzen Sie alle Steuerelemente in die Symbolleisten. Die Anwendung verwendet zwei Symbolleisten (eine oben und eine unten).

'''So gestalten Sie die obere Symbolleiste:'''

* Wählen Sie in der [[Tool-Palette|Tool-Palette]] die folgenden Komponenten aus, und ziehen Sie sie auf die obere Symbolleiste:
** [[lib_de:FMX.StdCtrls.TTrackBar|TTrackBar]]: Zum Drehen der Karte.
** Zwei [[lib_de:FMX.Edit.TEdit|TEdit]]-Komponenten: Zum Festlegen der Koordinaten des Kartenmittelpunkts (Breiten- und Längengrad).
** [[lib_de:FMX.StdCtrls.TButton|TButton]]: Zum Aktualisieren der Karte anhand der aktuellen Koordinaten des Kartenmittelpunkts.

Führen Sie die folgenden Schritte aus, um die entsprechenden Eigenschaften für die Steuerelemente festzulegen:

# Im '''[[Formular-Designer|Formular-Designer]]''' wählen Sie '''TrackBar1''' aus und setzen Sie die Eigenschaft [[lib_de:FMX.StdCtrls.TCustomTrack.Max|Max]] auf {{Code|359}}.
# Wählen Sie '''Edit1''' aus, und setzen Sie die Eigenschaften '''Name''' und '''Text''' auf <code>edLat</code> bzw. <code>0.0</code>.
# Wählen Sie '''Edit2''' aus, und setzen Sie die Eigenschaften '''Name''' und '''Text''' auf <code>edLong</code> bzw. <code>0.0</code>.
# Wählen Sie '''Button1''' aus, und setzen Sie die Eigenschaft '''Text''' auf <code>Go</code>.

'''So gestalten Sie die untere Symbolleiste:'''

# Wählen Sie in der [[Tool-Palette|Tool-Palette]] die Komponente '''TLayout''' aus, und ziehen Sie sie auf die untere Symbolleiste.
# Legen Sie im [[Objektinspektor|Objektinspektor]] die folgenden Eigenschaften der '''Layout1'''-Komponente fest:
#* Setzen Sie die Eigenschaft '''Align''' auf <code>Center</code>.
#* Setzen Sie die Eigenschaft '''Width''' auf 241.
# Wählen Sie in der [[Tool-Palette|Tool-Palette]] drei '''TSpeedButton'''-Komponenten aus, und fügen Sie sie als untergeordnete Elemente von '''Layout1''' hinzu.
# Legen Sie im [[Objektinspektor|Objektinspektor]] die folgenden Eigenschaften dieser drei Schaltflächen fest:
#* Setzen Sie die Eigenschaft '''Text''' der Schaltflächen auf <code>Normal</code>, <code>Satellite</code> bzw. <code>Hybrid</code>.
#* Setzen Sie die Eigenschaft '''GroupName''' aller drei Schaltflächen auf <code>Selector</code>.
#* Setzen Sie die Eigenschaft '''StyleLookup''' auf <code>segmentedbuttonleft</code>, <code>segmentedbuttonmiddle</code> bzw. <code>segmentedbuttonright</code>.

Nach Abschluss der obigen Schritte sollte der [[Formular-Designer|Formular-Designer]] in etwa wie der folgende Screenshot aussehen:

[[File:TMapView toolbar.png]]

====Implementieren der Funktionalität der Steuerelemente====

Um die Anwendungsentwicklung abzuschließen, müssen Sie Ereignisbehandlungsroutinen für alle Steuerelemente auf den Symbolleisten implementieren.

'''So implementieren Sie die OnClick-Ereignisbehandlungsroutinen für die Symbolschaltflächen: '''

<ol><li>Doppelklicken Sie im [[Formular-Designer|Formular-Designer]] auf eine Symbolschaltfläche ('''Normal''', '''Satellite''' oder '''Hybrid''').</li>
<li>Fügen Sie im [[Quelltext-Editor|Quelltext-Editor]] den folgenden Code für die Ereignisbehandlungsroutinen jeder Schaltfläche hinzu:
<l s="delphi" />'''{{Delphi}}''': 
<source lang="Delphi">
//-------------------For Normal button -----------------------------------------
procedure TForm1.SpeedButton1Click(Sender:TObject) ;
begin
MapView1.MapType := TMapType.Normal;
TrackBar1.Value := 0.0;
end;
// -------------------For Satellite button---------------------------------------

procedure TForm1.SpeedButton2Click(Sender:TObject) ;
begin
MapView1.MapType := TMapType.Satellite;
TrackBar1.Value := 0.0;
end;
// --------------------For Hybrid button-----------------------------------------

procedure TForm1.SpeedButton3Click(Sender:TObject) ;
begin
MapView1.MapType := TMapType.Hybrid;
TrackBar1.Value := 0.0;
end;
</source><l e="delphi" /><l s="cpp" />'''{{CBuilder}}:''' 
<source lang="cpp">
//-------------------For Normal button -----------------------------------------
void __fastcall TForm1::SpeedButton1Click(TObject *Sender) {
MapView1->MapType = TMapType::Normal;
TrackBar1->Value = 0.0;
}
// -------------------For Satellite button---------------------------------------

void __fastcall TForm1::SpeedButton2Click(TObject *Sender) {
MapView1->MapType = TMapType::Satellite;
TrackBar1->Value = 0.0;
}
// --------------------For Hybrid button-----------------------------------------

void __fastcall TForm1::SpeedButton3Click(TObject *Sender) {
MapView1->MapType = TMapType::Hybrid;
TrackBar1->Value = 0.0;
}</source><l e="cpp" /></li>
</ol>

'''So implementieren Sie die OnChange-Ereignisbehandlungsroutine für das Schieberegler-Element:'''

<ol><li>Wählen Sie im [[Formular-Designer|Formular-Designer]] TrackBar1 aus.</li>
<li>Öffnen Sie im [[Objektinspektor|Objektinspektor]] die Registerkarte '''Ereignisse''', und doppelklicken Sie neben '''OnChange'''. 
Geben Sie den folgenden Code an:
<l s="delphi" />'''{{Delphi}}''': 
<source lang="Delphi">
procedure TForm1.TrackBar1Change(Sender: TObject);
begin
MapView1.Bearing := TrackBar1.Value;
end;</source><l e="delphi" /><l s="cpp" />'''{{CBuilder}}:''' 
<source lang="cpp">
void __fastcall TForm1::TrackBar1Change(TObject *Sender)
{
MapView1->Bearing = TrackBar1->Value;
}</source><l e="cpp" /></li>
</ol>

'''So implementieren Sie die OnClick-Ereignisbehandlungsroutine für die Go-Schaltfläche:'''

<ol><li>Doppelklicken Sie im [[Formular-Designer|Formular-Designer]] auf die Schaltfläche '''Go'''.</li>
<li>Geben Sie im [[Quelltext-Editor|Quelltext-Editor]] den folgenden Code ein:
<l s="delphi" />'''{{Delphi}}''': 
<source lang="Delphi">
procedure TForm1.Button1Click(Sender: TObject);
var
mapCenter: TMapCoordinate;
begin
mapCenter := TMapCoordinate.Create(StrToFloat(edLat.Text),
StrToFloat(edLong.Text));
MapView1.Location := mapCenter;
end;</source><l e="delphi" /><l s="cpp" />'''{{CBuilder}}:''' 
<source lang="cpp">
void __fastcall TForm1::Button1Click(TObject *Sender) {
TMapCoordinate mapCenter = TMapCoordinate::Create(StrToFloat(edLat->Text),
StrToFloat(edLong->Text));
MapView1->Location = mapCenter;
}</source><l e="cpp" /></li>
</ol>

Marker bezeichnen Positionen auf der Karte. Wenn Sie der Karte Marker hinzufügen möchten, können Sie die '''OnMapClick'''-Ereignisbehandlungsroutine für die Karte folgendermaßen hinzufügen.

'''So implementieren Sie die OnMapClick-Ereignisbehandlungsroutine für die Karte:'''

<ol><li>
Wählen Sie in der [[Strukturansicht|Strukturansicht]] '''MapView1''' aus.
</li>
<li>
Öffnen Sie im [[Objektinspektor|Objektinspektor]] die Registerkarte '''Ereignisse''', und doppelklicken Sie neben '''OnMapClick'''.
</li>
<li>
Fügen Sie im [[Quelltext-Editor|Quelltext-Editor]] den folgenden Code für die Ereignisbehandlungsroutine hinzu:
<l s="delphi" />'''{{Delphi}}''': 
<source lang="Delphi">
procedure TForm1.MapView1MapClick(const Position: TMapCoordinate);
var
MyMarker: TMapMarkerDescriptor;
begin
MyMarker := TMapMarkerDescriptor.Create(Position, 'MyMarker');
// Make a marker draggable
MyMarker.Draggable := True;
// Make a marker visible
MyMarker.Visible :=True;
MapView1.AddMarker(MyMarker);
end;</source><l e="delphi" /><l s="cpp" />'''{{CBuilder}}:''' 
<source lang="cpp">
void __fastcall TForm1::MapView1MapClick(const TMapCoordinate &Position) {
TMapMarkerDescriptor myMarker = TMapMarkerDescriptor::Create(Position, "MyMarker");
// Make a marker draggable
myMarker.Draggable = true;
// Make a marker visible
myMarker.Visible = true;
MapView1->AddMarker(myMarker);
}</source><l e="cpp" /></li>
</ol>

==Ausführen der Beispielanwendung==

Gehen Sie folgendermaßen vor, um diese Anwendung auszuführen:

<ol><li> Wählen Sie in der [[Projektverwaltung|Projektverwaltung]] die Zielplattform aus (Android und iOS werden unterstützt).
<blockquote>
'''Wichtig''': Vor dem Ausführen dieser Anwendung auf Android-Geräten müssen Sie die Schritte unter [[Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps|Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps]] abgeschlossen haben.
</blockquote></li>
<li> Drücken Sie <code>Umschalt+Strg+F9</code>, um die Anwendung ohne Debugger auszuführen.</li>
</ol>

Mit dem folgenden Szenario können Sie Ihre Anwendung testen:

# Klicken Sie auf die Schaltfläche '''Hybrid'''.
# Geben Sie den neuen Kartenmittelpunkt an (standardmäßig ist der Kartenmittelpunkt (0.0, 0.0)):
#* Legen Sie im linken Textfeld den Wert für den Breitengrad (z. B. 50 Grad) fest.
#* Legen Sie im rechten Textfeld den Wert für den Längengrad (z. B. 20 Grad) fest.
#* Klicken Sie auf die Schaltfläche '''Go'''.
# Klicken Sie auf einen beliebigen Punkt auf der Karte, um einen Marker hinzuzufügen.
# Tippen Sie auf das Schieberegler-Element, und verschieben Sie den Regler an eine bestimmte Position. [''Dadurch wird die Ausrichtung der Karte (Peilung) geändert. Die Kartenausrichtung ist die Richtung, in die eine vertikale Linie auf der Karte zeigt, gemessen in Grad im Uhrzeigersinn von Norden her.'']

{|
|-
!''' iOS'''
! ''' Android'''
|-
| style="vertical-align: top;" |
[[File:Maps iOS.png|300px]] 
'''iPad'''
| style="vertical-align: top;" |
[[File:Maps Android.png|266px]] 
'''Android (LG - E612)'''
|}

==Siehe auch==

* [[lib_de:FMX.Maps.TMapView|TMapView]]
* [[Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps|Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps]]
* [[Mobile-Tutorial: Verwenden von Positionssensoren (iOS und Android)|Mobile-Tutorial: Verwenden von Positionssensoren (iOS und Android)]]

===Codebeispiele===

* [[samp_en:FMX.Tabbed Map Sample|Tabbed Map (Beispiel)]]
* [[samp_en:FMX.Map Sample|Map (Beispiel)]]

[[Category:Delphi]]
[[Category:FMX]]
[[Category:C++]]
[[Category:IOS]]
[[Category:XE8]]
[[Category:Android]]
[[Category:AMMigrate]]

Mobile-Tutorial: Verwenden einer Landkarten-Komponente für die Arbeit mit Landkarten (iOS und Android)

2016-07-04T09:01:41Z

Esabatell: Internal review. LOC-21921

Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering

2016-07-01T07:41:27Z

Esabatell: 1 Version: Internal review. LOC-22647

{{Parent|Verwenden von App-Tethering}}

Die App-Tethering-Implementierung der [[RTL|RTL]] stellt die Unterstützung für das Teilen von Daten zwischen verbundenen Anwendungen bereit.

==Senden von Daten an verbundene Anwendungen==

Sie können mit den folgenden Verfahren Daten mithilfe von App-Tethering senden:

* [[#Teilen von Ressourcen|Definieren von geteilten Ressourcen]]. Ein Ressource enthält einen Wert. Verbundene Anwendungen können den Wert einer geteilten Ressource lesen und eine geteilte Ressource abonnieren, um bei Änderungen des Werts der geteilten Ressource Aktualisierungen zu erhalten.
* [[#Senden von Daten als temporäre Ressource|Senden von Daten als temporäre Ressource]]. Sie können zur Laufzeit Strings und Streams senden, die verbundene Anwendungen als temporäre Ressourcen empfangen. Verbundene Anwendungen können keine temporären Ressourcen für Aktualisierungen empfangen, weil Ihre Anwendung temporäre Ressourcen nur einmal sendet.

===Teilen von Ressourcen===

Eine [[lib_de:System.Tether.AppProfile.TLocalResource|TLocalResource]] ist ein Wrapper für einen Standarddatentyp ([[lib_de:System.Boolean|Boolean]], [[lib_de:System.Integer|Integer]], [[lib_de:System.Int64|Int64]], [[lib_de:System.Single|Single]], [[lib_de:System.Double|Double]], [[lib_de:System.String|String]]) oder einen [[lib_de:System.Classes.TStream|TStream]]. Sie können Ressourcen mit verbundenen Anwendungen mithilfe von App-Tethering teilen.

So erstellen und teilen Sie eine Ressource:

# Wählen Sie im '''[[Formular-Designer|Formular-Designer]]''' Ihre [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente aus, und doppelklicken Sie im '''[[Objektinspektor|Objektinspektor]]''' auf die Eigenschaft [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.Resources|Resources]].
# Klicken Sie im angezeigten [[Aktionslisten-Editor|Listen-Editor]] auf [[File:New.png|Neu]], um der Liste eine neue TLocalResource hinzuzufügen.
# Wählen Sie im Listen-Editor Ihre neue TLocalResource aus, und geben Sie im '''Objektinspektor''' für deren Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Name|Name]] einen eindeutigen Namen an.

:[[Image:TLocalResource Editing.png]]

Ihre Ressource wird jetzt per App-Tethering geteilt. Verbundene Anwendungen können den Wert dieser Ressource lesen und die Ressource abonnieren, um Aktualisierungen zu erhalten, sodass bei Änderungen des Ressourcenwerts in Ihren Anwendungen verbundene Anwendungen über die Änderung benachrichtigt werden und den neuen Wert lesen können.

Nachdem Sie Ihre Ressource beim Entwurf definiert haben, müssen Sie ihr zur Laufzeit einen Wert zuweisen:
<l s="delphi" />

* In {{Delphi}}:
**<source lang="delphi" enclose="none">TetheringAppProfile1.Resources.FindByName('ResourceName').Value := 'SomeValue';</source>
**<source lang="delphi" enclose="none">TetheringAppProfile1.Resources.Items[ResourceNumber].Value := 'SomeValue';</source>

<l e="delphi" />
<l s="cpp" />

* In C++:
**<source lang="cpp" enclose="none">TetheringAppProfile1->Resources->FindByName("ResourceName")->Value = "SomeValue";</source>
**<source lang="cpp" enclose="none">TetheringAppProfile1->Resources->Items[ResourceNumber]->Value = "SomeValue";</source>

<l e="cpp" />

: Beschreibung:
:* {{Code|ResourceName}} ist der Name, den Sie in die Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Name|Name]] der Ressource eingeben, wenn Sie sie zur Laufzeit erstellen.
:* {{Code|SomeValue}} ist der Wert, den Sie für die Ressource festlegen möchten. Dieser Wert kann einen der oben aufgeführten Standarddatentypen haben.
:* {{Code|ResourceNumber}} ist die Anzahl der Einträge in der Eigenschaft [[lib_de:System.Tether.AppProfile.TResourceCollection.Items|Items]] der [[lib_de:System.Tether.AppProfile.TResourceCollection|TResourceCollection]], wenn Sie sie in Entwurfszeit erstellen.

Verbundene Anwendungen können jederzeit den Wert Ihrer geteilten Ressource anfordern und die geteilte Ressource abonnieren, um Aktualisierungen zu erhalten, sodass bei Änderungen des Ressourcenwerts die abonnierten Remote-Anwendungsprofile die aktualisierte Ressource erhalten.

===Senden von Daten als temporäre Ressource===

Anstatt Ressourcen zu teilen, können Sie mit den Methoden [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SendString|SendString]] und [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SendStream|SendStream]] der [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente Strings oder Streams an verbundene Anwendungen senden.

Remote-Anwendungsprofile empfangen den Wert, der in einer temporären Ressource enthalten ist. Eine temporäre Ressource wird von Ihrem Anwendungsprofil nur einmal an verbundene Anwendungen gesendet. Diese temporäre Ressource wird anschließend gelöscht; verbundene Anwendungen können diese Ressource nicht abonnieren, um Aktualisierungen zu erhalten.

Diese Methode erwartet die folgenden Parameter:

* {{Arg|AProfile}} ist ein Remote-Anwendungsprofil als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]]. Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] der [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente stellt eine Liste der Remote-Anwendungsprofile bereit, die mit Ihrem Profil verbunden sind; Sie können diese Liste nach dem gewünschten Remote-Anwendungsprofil durchsuchen.
* {{Arg|Description}} ist ein String, der den Inhalt des gesendeten Wertes beschreibt.
* {{Arg|AString}} oder {{Arg|AStream}} ist der Wert, der gesendet werden soll.

Wenn Sie mit temporären Ressourcen andere Standarddatentypen als String senden möchten, müssen Sie diese Datentypen vor dem Senden in Strings konvertieren und dann in der verbundenen Anwendung, die den String empfängt, wieder zurück in ihren Originaltyp konvertieren. Siehe [[JSON|JSON]].

==Empfangen von Daten von verbundenen Anwendungen==

Ihre Anwendung kann eine Ressource erhalten, enweder weil das [[#Senden von Daten an verbundene Anwendungen|Remote-Anwendungsprofil es sendet]], oder weil Sie [[#Anfordern von Remote-Ressourcen|es anfordern]]. Sie können [[#Verarbeiten von eingehenden Remote-Ressourcen|jede eingehende Remote-Ressource mit Ihrer TTetheringAppProfile-Komponente verarbeiten]].

Darüber hinaus können Sie [[#Abonnieren von Remote-Ressourcen, um Aktualisierungen zu erhalten|eine Remote-Ressource abonnieren, um Aktualisierungen zu erhalten]]. Wenn sich der Wert der Remote-Ressource ändert, wird Ihre Anwendung über die Änderung informiert und empfängt den neuen Wert der Remote-Ressource. Wenn Sie [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering#Verbinden von Anwendungen über Gruppen|die Verbindung zu Remote-Anwendungen über Gruppen herstellen]], können Sie alternativ [[#Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen|mit lokalen Ressourcen Remote-Ressourcen abonnieren]] und separate Methoden definieren, um Aktualisierungen jeder einzelnen der abonnierten Remote-Ressourcen zu verarbeiten.

===Anfordern von Remote-Ressourcen===

Die [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente stellt eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue|GetRemoteResourceValue]], bereit, mit der Sie Remote-Ressourcen anfordern können.

Sie können eine Remote-Ressource für die Anforderung mit einer der folgenden Parametergruppen festlegen:

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]] und den Namen der Remote-Ressource enthält.

: Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] Ihrer [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente enthält eine Liste der Remote-Anwendungsprofile, die mit Ihrem Profil verbunden sind.

* Stellen Sie eine Instanz von [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]] bereit.

: Die TTetheringAppProfile-Komponente enthält eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteProfileResources|GetRemoteProfileResources]], die eine Liste der Remote-Ressourcen zurückgibt, die von einem gegebenen Remote-Anwendungsprofil geteilt werden. Das Remote-Anwendungsprofil ist als Instanz von TTetheringProfileInfo festgelegt.

===Verarbeiten von eingehenden Remote-Ressourcen===

Die TTetheringAppProfile-Komponente kann Remote-Ressourcen aus einem der folgenden Gründe erhalten:

* Ein Remote-Anwendungsprofil sendet eine temporäre Ressource.
* Sie fordern eine Remote-Ressource an.

Wenn die TTetheringAppProfile-Komponente eine Ressource empfängt, werden zwei Ereignisse der TTetheringAppProfile-Komponente in der folgenden Reihenfolge ausgelöst: OnAcceptResource und OnResourceReceived. Zur Verarbeitung von eingehenden Ressourcen müssen Sie diese Ereignisse behandeln.

:[[Image:OnAcceptResource Image.png]]

====Annehmen oder Ablehnen einer eingehenden Remote-Ressource====

Sie können [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnAcceptResource|OnAcceptResource]] behandeln, um festzulegen, ob Sie eine eingehende Ressource akzeptieren oder nicht. Dieses Ereignis stellt die folgenden Parameter bereit:

* {{Arg|Sender}} ist Ihre TTetheringAppProfile-Komponente, die gerade die eingehende Ressource empfängt.
* {{Arg|AProfileId}} ist der [[lib_de:System.Tether.Manager.TTetheringProfileInfo.ProfileIdentifier|ProfileIdentifier]] des Remote-Anwendungsprofils, das die Ressource sendet. Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] der [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente stellt eine Liste der Remote-Anwendungsprofile bereit, die mit Ihrem Profil verbunden sind; Sie können diese Liste nach dem mit der angegebenen Profil-ID übereinstimmenden Remote-Anwendungsprofil durchsuchen.
* {{Arg|AResource}} ist eine Instanz von [[lib_de:System.Tether.AppProfile.TCustomRemoteItem|TCustomRemoteItem]], die Eigenschaften enthält, die Sie lesen können, um festzulegen, ob Sie die eingehende Remote-Ressource annehmen oder nicht, z. B. den [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Name|Namen]] der Ressource oder einen [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Hint|Hinweis]], der deren Inhalt beschreibt.
* {{Arg|AcceptResource}} ist ein boolescher Wert, der standardmäßig auf {{True}} gesetzt ist. Sie können diesen Wert in {{False}} ändern, wenn Sie die eingehende Ressource nicht empfangen möchten.

====Lesen einer eingehenden Remote-Ressource====

Wenn Sie das Ereignis OnAcceptResource nicht behandeln oder in Ihrer Ereignisbehandlungsroutine den Wert von {{Arg|AcceptResource}} nicht in {{False}} ändern, wird das Ereignis [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnResourceReceived|OnResourceReceived]] ausgelöst. Sie können dieses Ereignis behandeln, um die Daten aus der Ressource zu lesen. Dieses Ereignis stellt die folgenden Parameter bereit:

* {{Arg|Sender}} ist Ihre TTetheringAppProfile-Komponente, die gerade die eingehende Ressource empfängt.
* {{Arg|AResource}} ist eine Instanz von [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]]. TRemoteResource erweitert TCustomRemoteItem um zwei Eigenschaften, über die Sie auf den tatsächlichen Wert der Ressource zugreifen können:
** [[lib_de:System.Tether.AppProfile.TRemoteResource.ResType|TRemoteResource.ResType]] gibt an, ob die Ressource einen Standarddatentyp (TRemoteResourceType.Data) oder einen TStream (TRemoteResourceType.Stream) enthält.
** Mit [[lib_de:System.Tether.AppProfile.TRemoteResource.Value|TRemoteResource.Value]] können Sie auf den Wert zugreifen. So rufen Sie den Wert ab:
*** Wenn der Wert ein Standarddatentyp ist, überprüfen Sie [[lib_de:System.Tether.AppProfile.TResourceValue.DataType|TRemoteResource.Value.DataType]], um den Typ der Daten zu ermitteln, und lesen Sie die entsprechende TRemoteResource.Value-Eigenschaft: AsBoolean, AsInteger, AsInt64, AsSingle, AsDouble, AsString.
*** Wenn der Wert ein Stream ist, lesen Sie den Stream aus TRemoteResource.Value.AsStream.

===Abonnieren von Remote-Ressourcen, um Aktualisierungen zu erhalten===

Wenn Ihre Anwendung mit einer Anwendung verbunden ist, die Ressourcen teilt, können Sie diese geteilten Ressourcen abonnieren, um Aktualisierungen zu erhalten, sodass Ihre Anwendung diese geteilten Ressourcen erhält, sobald sich deren Wert in der verbundenen Anwendung ändert.

Wenn Sie [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering#Verbinden von Anwendungen über Gruppen|mit Gruppen Verbindungen zu anderen Anwendungen herstellen]], können Sie [[#Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen|beim Entwurf die Remote-Ressourcen zu lokalen Ressourcen zuordnen]]. Diese lokalen Ressourcen verfügen ein Ereignis, mit dem Sie die Änderungen des Wertes der Remote-Ressource behandeln können.

Alternativ können Sie [[#Abonnieren von Remote-Ressourcen mit SubscribeToRemoteItem|die Remote-Ressourcen zur Laufzeit über ihren Ressourcennamen abonnieren]].

: '''Hinweis:''' Sie dürfen eine Remote-Ressource nicht gleichzeitig mit einer lokalen Ressource und SubscribeToRemoteItem abonnieren. Verwenden Sie für jede Remote-Ressource nur eine dieser Abonnementmethoden.

====Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen====

So ordnen Sie beim Entwurf eine lokale Ressource einer Remote-Ressource zu:

# Befolgen Sie die obigen Schritte, um eine Ressource zu erstellen und mithilfe von App-Tethering zu teilen.
# Wählen Sie im Ressourcenlisten-Editor Ihre neue [[lib_de:System.Tether.AppProfile.TLocalResource|TLocalResource]] aus, und ändern Sie im '''Objektinspektor''' deren Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Kind|Kind]] in [[lib_de:System.Tether.AppProfile.TTetheringRemoteKind|Mirror]].

:[[Image: TLocalResource Kind Property.png]]

Wenn Sie die Eigenschaft Kind Ihrer TLocalResource in Mirror ändern, wird Ihre TLocalResource nicht mit Remote-Anwendungen geteilt. Sondern bei jeder Änderung des Wertes einer Remote-Ressource mit demselben [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Name|Namen]] wie der Name, den Sie in Ihrer TLocalResource angegeben haben, wird der Wert Ihrer lokalen Ressource aktualisiert und das Ereignis [[lib_de:System.Tether.AppProfile.TLocalResource.OnResourceReceived|TLocalResource.OnResourceReceived]] ausgelöst.

====Abonnieren von Remote-Ressourcen mit SubscribeToRemoteItem====

Die TTetheringAppProfile-Komponente stellt eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SubscribeToRemoteItem|SubscribeToRemoteItem]], bereit, mit der Sie Remote-Ressourcen abonnieren können, um Aktualisierungen zu erhalten.

Sie können eine Remote-Ressource zum Abonnieren mit einer der folgenden Parametergruppen festlegen:

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]] und den Namen der Remote-Ressource enthält.

: Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] Ihrer [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente enthält eine Liste der Remote-Anwendungsprofile, die mit Ihrem Profil verbunden sind.

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von TTetheringProfileInfo und eine Instanz von [[lib_de:System.Tether.AppProfile.TCustomRemoteItem|TCustomRemoteItem]] enthält.

: Die [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente enthält eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteProfileActions|GetRemoteProfileActions]], die eine Liste der Remote-Ressourcen zurückgibt, die von einem gegebenen Remote-Anwendungsprofil geteilt werden. Das Remote-Anwendungsprofil ist als Instanz von TTetheringProfileInfo festgelegt.

Ändert sich der Wert einer Remote-Ressource mit demselben Namen wie die Instanz von TCustomRemoteItem, die Sie abonniert haben, wird der Wert der abonnierten Instanz von TCustomRemoteItem aktualisiert und das Ereignis [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnResourceUpdated|OnResourceUpdated]] ausgelöst.

:'''Hinweise:'''
:* Um den Wert der abonnierten Instanz von TCustomRemoteItem zu lesen, müssen Sie den Typ dieser Instanz in [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]] umwandeln und deren Daten lesen. Siehe [[#Lesen einer eingehenden Remote-Ressource|Lesen einer eingehenden Remote-Ressource]].
:* Ändert sich eine Remote-Ressource, die einen Stream enthält, wird das Ereignis OnResourceUpdated ausgelöst, aber der Wert der abonnierten Instanz von TCustomRemoteItem wird nicht aktualisiert. Sie müssen den neuen Ressourcenwert manuell anfordern. Siehe [[#Anfordern von Remote-Ressourcen|Anfordern von Remote-Ressourcen]].
:* Das Ereignis OnResourceUpdated wird nicht ausgelöst, wenn Sie dieselbe Remote-Ressource mit einer lokalen Ressource abonnieren.

==Siehe auch==

* [[Hinzufügen von App-Tethering zu Anwendungen|Hinzufügen von App-Tethering zu Anwendungen]]
* [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering|Verbinden zu Remote-Anwendungen mithilfe von App-Tethering]]
* [[Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering|Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering]]

* [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]
* [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]
* [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]]

* [[lib_de:System.Classes.TStream|TStream]]
* [[lib_de:System.String|String]]

* [[samp_en:RTL.BDShoppingList Sample|BDShoppingList]] (Beispiel)
* [[samp_en:RTL.DesktopCast Sample|DesktopCast]] (Beispiel)
* [[samp_en:RTL.MediaPlayer Sample|MediaPlayer]] (Beispiel)
* [[samp_en:RTL.PhotoWall Sample|PhotoWall]] (Beispiel)

[[Category:XE6]]
[[Category:AMMigrate]]

Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering

2016-07-01T07:41:25Z

Esabatell: Internal review. LOC-22647

{{Parent|Verwenden von App-Tethering}}

Die App-Tethering-Implementierung der [[RTL|RTL]] stellt die Unterstützung für das Teilen von Daten zwischen verbundenen Anwendungen bereit.

==Senden von Daten an verbundene Anwendungen==

Sie können mit den folgenden Verfahren Daten mithilfe von App-Tethering senden:

* [[#Teilen von Ressourcen|Definieren von geteilten Ressourcen]]. Ein Ressource enthält einen Wert. Verbundene Anwendungen können den Wert einer geteilten Ressource lesen und eine geteilte Ressource abonnieren, um bei Änderungen des Werts der geteilten Ressource Aktualisierungen zu erhalten.
* [[#Senden von Daten als temporäre Ressource|Senden von Daten als temporäre Ressource]]. Sie können zur Laufzeit Strings und Streams senden, die verbundene Anwendungen als temporäre Ressourcen empfangen. Verbundene Anwendungen können keine temporären Ressourcen für Aktualisierungen empfangen, weil Ihre Anwendung temporäre Ressourcen nur einmal sendet.

===Teilen von Ressourcen===

Eine [[lib_de:System.Tether.AppProfile.TLocalResource|TLocalResource]] ist ein Wrapper für einen Standarddatentyp ([[lib_de:System.Boolean|Boolean]], [[lib_de:System.Integer|Integer]], [[lib_de:System.Int64|Int64]], [[lib_de:System.Single|Single]], [[lib_de:System.Double|Double]], [[lib_de:System.String|String]]) oder einen [[lib_de:System.Classes.TStream|TStream]]. Sie können Ressourcen mit verbundenen Anwendungen mithilfe von App-Tethering teilen.

So erstellen und teilen Sie eine Ressource:

# Wählen Sie im '''[[Formular-Designer|Formular-Designer]]''' Ihre [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente aus, und doppelklicken Sie im '''[[Objektinspektor|Objektinspektor]]''' auf die Eigenschaft [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.Resources|Resources]].
# Klicken Sie im angezeigten [[Aktionslisten-Editor|Listen-Editor]] auf [[File:New.png|Neu]], um der Liste eine neue TLocalResource hinzuzufügen.
# Wählen Sie im Listen-Editor Ihre neue TLocalResource aus, und geben Sie im '''Objektinspektor''' für deren Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Name|Name]] einen eindeutigen Namen an.

:[[Image:TLocalResource Editing.png]]

Ihre Ressource wird jetzt per App-Tethering geteilt. Verbundene Anwendungen können den Wert dieser Ressource lesen und die Ressource abonnieren, um Aktualisierungen zu erhalten, sodass bei Änderungen des Ressourcenwerts in Ihren Anwendungen verbundene Anwendungen über die Änderung benachrichtigt werden und den neuen Wert lesen können.

Nachdem Sie Ihre Ressource beim Entwurf definiert haben, müssen Sie ihr zur Laufzeit einen Wert zuweisen:
<l s="delphi" />

* In {{Delphi}}:
**<source lang="delphi" enclose="none">TetheringAppProfile1.Resources.FindByName('ResourceName').Value := 'SomeValue';</source>
**<source lang="delphi" enclose="none">TetheringAppProfile1.Resources.Items[ResourceNumber].Value := 'SomeValue';</source>

<l e="delphi" />
<l s="cpp" />

* In C++:
**<source lang="cpp" enclose="none">TetheringAppProfile1->Resources->FindByName("ResourceName")->Value = "SomeValue";</source>
**<source lang="cpp" enclose="none">TetheringAppProfile1->Resources->Items[ResourceNumber]->Value = "SomeValue";</source>

<l e="cpp" />

: Beschreibung:
:* {{Code|ResourceName}} ist der Name, den Sie in die Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Name|Name]] der Ressource eingeben, wenn Sie sie zur Laufzeit erstellen.
:* {{Code|SomeValue}} ist der Wert, den Sie für die Ressource festlegen möchten. Dieser Wert kann einen der oben aufgeführten Standarddatentypen haben.
:* {{Code|ResourceNumber}} ist die Anzahl der Einträge in der Eigenschaft [[lib_de:System.Tether.AppProfile.TResourceCollection.Items|Items]] der [[lib_de:System.Tether.AppProfile.TResourceCollection|TResourceCollection]], wenn Sie sie in Entwurfszeit erstellen.

Verbundene Anwendungen können jederzeit den Wert Ihrer geteilten Ressource anfordern und die geteilte Ressource abonnieren, um Aktualisierungen zu erhalten, sodass bei Änderungen des Ressourcenwerts die abonnierten Remote-Anwendungsprofile die aktualisierte Ressource erhalten.

===Senden von Daten als temporäre Ressource===

Anstatt Ressourcen zu teilen, können Sie mit den Methoden [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SendString|SendString]] und [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SendStream|SendStream]] der [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente Strings oder Streams an verbundene Anwendungen senden.

Remote-Anwendungsprofile empfangen den Wert, der in einer temporären Ressource enthalten ist. Eine temporäre Ressource wird von Ihrem Anwendungsprofil nur einmal an verbundene Anwendungen gesendet. Diese temporäre Ressource wird anschließend gelöscht; verbundene Anwendungen können diese Ressource nicht abonnieren, um Aktualisierungen zu erhalten.

Diese Methode erwartet die folgenden Parameter:

* {{Arg|AProfile}} ist ein Remote-Anwendungsprofil als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]]. Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] der [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente stellt eine Liste der Remote-Anwendungsprofile bereit, die mit Ihrem Profil verbunden sind; Sie können diese Liste nach dem gewünschten Remote-Anwendungsprofil durchsuchen.
* {{Arg|Description}} ist ein String, der den Inhalt des gesendeten Wertes beschreibt.
* {{Arg|AString}} oder {{Arg|AStream}} ist der Wert, der gesendet werden soll.

Wenn Sie mit temporären Ressourcen andere Standarddatentypen als String senden möchten, müssen Sie diese Datentypen vor dem Senden in Strings konvertieren und dann in der verbundenen Anwendung, die den String empfängt, wieder zurück in ihren Originaltyp konvertieren. Siehe [[JSON|JSON]].

==Empfangen von Daten von verbundenen Anwendungen==

Ihre Anwendung kann eine Ressource erhalten, enweder weil das [[#Senden von Daten an verbundene Anwendungen|Remote-Anwendungsprofil es sendet]], oder weil Sie [[#Anfordern von Remote-Ressourcen|es anfordern]]. Sie können [[#Verarbeiten von eingehenden Remote-Ressourcen|jede eingehende Remote-Ressource mit Ihrer TTetheringAppProfile-Komponente verarbeiten]].

Darüber hinaus können Sie [[#Abonnieren von Remote-Ressourcen, um Aktualisierungen zu erhalten|eine Remote-Ressource abonnieren, um Aktualisierungen zu erhalten]]. Wenn sich der Wert der Remote-Ressource ändert, wird Ihre Anwendung über die Änderung informiert und empfängt den neuen Wert der Remote-Ressource. Wenn Sie [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering#Verbinden von Anwendungen über Gruppen|die Verbindung zu Remote-Anwendungen über Gruppen herstellen]], können Sie alternativ [[#Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen|mit lokalen Ressourcen Remote-Ressourcen abonnieren]] und separate Methoden definieren, um Aktualisierungen jeder einzelnen der abonnierten Remote-Ressourcen zu verarbeiten.

===Anfordern von Remote-Ressourcen===

Die [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente stellt eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue|GetRemoteResourceValue]], bereit, mit der Sie Remote-Ressourcen anfordern können.

Sie können eine Remote-Ressource für die Anforderung mit einer der folgenden Parametergruppen festlegen:

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]] und den Namen der Remote-Ressource enthält.

: Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] Ihrer [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente enthält eine Liste der Remote-Anwendungsprofile, die mit Ihrem Profil verbunden sind.

* Stellen Sie eine Instanz von [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]] bereit.

: Die TTetheringAppProfile-Komponente enthält eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteProfileResources|GetRemoteProfileResources]], die eine Liste der Remote-Ressourcen zurückgibt, die von einem gegebenen Remote-Anwendungsprofil geteilt werden. Das Remote-Anwendungsprofil ist als Instanz von TTetheringProfileInfo festgelegt.

===Verarbeiten von eingehenden Remote-Ressourcen===

Die TTetheringAppProfile-Komponente kann Remote-Ressourcen aus einem der folgenden Gründe erhalten:

* Ein Remote-Anwendungsprofil sendet eine temporäre Ressource.
* Sie fordern eine Remote-Ressource an.

Wenn die TTetheringAppProfile-Komponente eine Ressource empfängt, werden zwei Ereignisse der TTetheringAppProfile-Komponente in der folgenden Reihenfolge ausgelöst: OnAcceptResource und OnResourceReceived. Zur Verarbeitung von eingehenden Ressourcen müssen Sie diese Ereignisse behandeln.

:[[Image:OnAcceptResource Image.png]]

====Annehmen oder Ablehnen einer eingehenden Remote-Ressource====

Sie können [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnAcceptResource|OnAcceptResource]] behandeln, um festzulegen, ob Sie eine eingehende Ressource akzeptieren oder nicht. Dieses Ereignis stellt die folgenden Parameter bereit:

* {{Arg|Sender}} ist Ihre TTetheringAppProfile-Komponente, die gerade die eingehende Ressource empfängt.
* {{Arg|AProfileId}} ist der [[lib_de:System.Tether.Manager.TTetheringProfileInfo.ProfileIdentifier|ProfileIdentifier]] des Remote-Anwendungsprofils, das die Ressource sendet. Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] der [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente stellt eine Liste der Remote-Anwendungsprofile bereit, die mit Ihrem Profil verbunden sind; Sie können diese Liste nach dem mit der angegebenen Profil-ID übereinstimmenden Remote-Anwendungsprofil durchsuchen.
* {{Arg|AResource}} ist eine Instanz von [[lib_de:System.Tether.AppProfile.TCustomRemoteItem|TCustomRemoteItem]], die Eigenschaften enthält, die Sie lesen können, um festzulegen, ob Sie die eingehende Remote-Ressource annehmen oder nicht, z. B. den [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Name|Namen]] der Ressource oder einen [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Hint|Hinweis]], der deren Inhalt beschreibt.
* {{Arg|AcceptResource}} ist ein boolescher Wert, der standardmäßig auf {{True}} gesetzt ist. Sie können diesen Wert in {{False}} ändern, wenn Sie die eingehende Ressource nicht empfangen möchten.

====Lesen einer eingehenden Remote-Ressource====

Wenn Sie das Ereignis OnAcceptResource nicht behandeln oder in Ihrer Ereignisbehandlungsroutine den Wert von {{Arg|AcceptResource}} nicht in {{False}} ändern, wird das Ereignis [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnResourceReceived|OnResourceReceived]] ausgelöst. Sie können dieses Ereignis behandeln, um die Daten aus der Ressource zu lesen. Dieses Ereignis stellt die folgenden Parameter bereit:

* {{Arg|Sender}} ist Ihre TTetheringAppProfile-Komponente, die gerade die eingehende Ressource empfängt.
* {{Arg|AResource}} ist eine Instanz von [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]]. TRemoteResource erweitert TCustomRemoteItem um zwei Eigenschaften, über die Sie auf den tatsächlichen Wert der Ressource zugreifen können:
** [[lib_de:System.Tether.AppProfile.TRemoteResource.ResType|TRemoteResource.ResType]] gibt an, ob die Ressource einen Standarddatentyp (TRemoteResourceType.Data) oder einen TStream (TRemoteResourceType.Stream) enthält.
** Mit [[lib_de:System.Tether.AppProfile.TRemoteResource.Value|TRemoteResource.Value]] können Sie auf den Wert zugreifen. So rufen Sie den Wert ab:
*** Wenn der Wert ein Standarddatentyp ist, überprüfen Sie [[lib_de:System.Tether.AppProfile.TResourceValue.DataType|TRemoteResource.Value.DataType]], um den Typ der Daten zu ermitteln, und lesen Sie die entsprechende TRemoteResource.Value-Eigenschaft: AsBoolean, AsInteger, AsInt64, AsSingle, AsDouble, AsString.
*** Wenn der Wert ein Stream ist, lesen Sie den Stream aus TRemoteResource.Value.AsStream.

===Abonnieren von Remote-Ressourcen, um Aktualisierungen zu erhalten===

Wenn Ihre Anwendung mit einer Anwendung verbunden ist, die Ressourcen teilt, können Sie diese geteilten Ressourcen abonnieren, um Aktualisierungen zu erhalten, sodass Ihre Anwendung diese geteilten Ressourcen erhält, sobald sich deren Wert in der verbundenen Anwendung ändert.

Wenn Sie [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering#Verbinden von Anwendungen über Gruppen|mit Gruppen Verbindungen zu anderen Anwendungen herstellen]], können Sie [[#Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen|beim Entwurf die Remote-Ressourcen zu lokalen Ressourcen zuordnen]]. Diese lokalen Ressourcen verfügen ein Ereignis, mit dem Sie die Änderungen des Wertes der Remote-Ressource behandeln können.

Alternativ können Sie [[#Abonnieren von Remote-Ressourcen mit SubscribeToRemoteItem|die Remote-Ressourcen zur Laufzeit über ihren Ressourcennamen abonnieren]].

: '''Hinweis:''' Sie dürfen eine Remote-Ressource nicht gleichzeitig mit einer lokalen Ressource und SubscribeToRemoteItem abonnieren. Verwenden Sie für jede Remote-Ressource nur eine dieser Abonnementmethoden.

====Abonnieren von Remote-Ressourcen mit lokalen Ressourcen für über Gruppen verbundene Anwendungen====

So ordnen Sie beim Entwurf eine lokale Ressource einer Remote-Ressource zu:

# Befolgen Sie die obigen Schritte, um eine Ressource zu erstellen und mithilfe von App-Tethering zu teilen.
# Wählen Sie im Ressourcenlisten-Editor Ihre neue [[lib_de:System.Tether.AppProfile.TLocalResource|TLocalResource]] aus, und ändern Sie im '''Objektinspektor''' deren Eigenschaft [[lib_de:System.Tether.AppProfile.TCustomLocalItem.Kind|Kind]] in [[lib_de:System.Tether.AppProfile.TTetheringRemoteKind|Mirror]].

:[[Image: TLocalResource Kind Property.png]]

Wenn Sie die Eigenschaft Kind Ihrer TLocalResource in Mirror ändern, wird Ihre TLocalResource nicht mit Remote-Anwendungen geteilt. Sondern bei jeder Änderung des Wertes einer Remote-Ressource mit demselben [[lib_de:System.Tether.AppProfile.TCustomRemoteItem.Name|Namen]] wie der Name, den Sie in Ihrer TLocalResource angegeben haben, wird der Wert Ihrer lokalen Ressource aktualisiert und das Ereignis [[lib_de:System.Tether.AppProfile.TLocalResource.OnResourceReceived|TLocalResource.OnResourceReceived]] ausgelöst.

====Abonnieren von Remote-Ressourcen mit SubscribeToRemoteItem====

Die TTetheringAppProfile-Komponente stellt eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.SubscribeToRemoteItem|SubscribeToRemoteItem]], bereit, mit der Sie Remote-Ressourcen abonnieren können, um Aktualisierungen zu erhalten.

Sie können eine Remote-Ressource zum Abonnieren mit einer der folgenden Parametergruppen festlegen:

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]] und den Namen der Remote-Ressource enthält.

: Die Eigenschaft [[lib_de:System.Tether.Manager.TTetheringManager.RemoteProfiles|RemoteProfiles]] Ihrer [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]-Komponente enthält eine Liste der Remote-Anwendungsprofile, die mit Ihrem Profil verbunden sind.

* Stellen Sie das Remote-Anwendungsprofil bereit, das die Remote-Ressource als Instanz von TTetheringProfileInfo und eine Instanz von [[lib_de:System.Tether.AppProfile.TCustomRemoteItem|TCustomRemoteItem]] enthält.

: Die [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]-Komponente enthält eine Methode, [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.GetRemoteProfileActions|GetRemoteProfileActions]], die eine Liste der Remote-Ressourcen zurückgibt, die von einem gegebenen Remote-Anwendungsprofil geteilt werden. Das Remote-Anwendungsprofil ist als Instanz von TTetheringProfileInfo festgelegt.

Ändert sich der Wert einer Remote-Ressource mit demselben Namen wie die Instanz von TCustomRemoteItem, die Sie abonniert haben, wird der Wert der abonnierten Instanz von TCustomRemoteItem aktualisiert und das Ereignis [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.OnResourceUpdated|OnResourceUpdated]] ausgelöst.

:'''Hinweise:'''
:* Um den Wert der abonnierten Instanz von TCustomRemoteItem zu lesen, müssen Sie den Typ dieser Instanz in [[lib_de:System.Tether.AppProfile.TRemoteResource|TRemoteResource]] umwandeln und deren Daten lesen. Siehe [[#Lesen einer eingehenden Remote-Ressource|Lesen einer eingehenden Remote-Ressource]].
:* Ändert sich eine Remote-Ressource, die einen Stream enthält, wird das Ereignis OnResourceUpdated ausgelöst, aber der Wert der abonnierten Instanz von TCustomRemoteItem wird nicht aktualisiert. Sie müssen den neuen Ressourcenwert manuell anfordern. Siehe [[#Anfordern von Remote-Ressourcen|Anfordern von Remote-Ressourcen]].
:* Das Ereignis OnResourceUpdated wird nicht ausgelöst, wenn Sie dieselbe Remote-Ressource mit einer lokalen Ressource abonnieren.

==Siehe auch==

* [[Hinzufügen von App-Tethering zu Anwendungen|Hinzufügen von App-Tethering zu Anwendungen]]
* [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering|Verbinden zu Remote-Anwendungen mithilfe von App-Tethering]]
* [[Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering|Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering]]

* [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]]
* [[lib_de:System.Tether.Manager.TTetheringManager|TTetheringManager]]
* [[lib_de:System.Tether.Manager.TTetheringProfileInfo|TTetheringProfileInfo]]

* [[lib_de:System.Classes.TStream|TStream]]
* [[lib_de:System.String|String]]

* [[samp_en:RTL.BDShoppingList Sample|BDShoppingList]] (Beispiel)
* [[samp_en:RTL.DesktopCast Sample|DesktopCast]] (Beispiel)
* [[samp_en:RTL.MediaPlayer Sample|MediaPlayer]] (Beispiel)
* [[samp_en:RTL.PhotoWall Sample|PhotoWall]] (Beispiel)

[[Category:XE6]]
[[Category:AMMigrate]]

Interne Datenformate (Delphi)

2016-06-30T08:02:41Z

Esabatell: 1 Version: Internal review. LOC-22606

__TOC__
{{Parent|Speicherverwaltung auf der Win32-Plattform - Index}}
<ideTag id="Integer"></ideTag>
<ideTag id="Type"></ideTag>
<ideTag id="integer"></ideTag>
<ideTag id="type"></ideTag>
<ideTag id="Shortint"></ideTag>
<ideTag id="Byte"></ideTag>
<ideTag id="Smallint"></ideTag>
<ideTag id="Word"></ideTag>
<ideTag id="Longint"></ideTag>
<ideTag id="LongWord"></ideTag>
<ideTag id="Int64"></ideTag>
<ideTag id="Char"></ideTag>
<ideTag id="AnsiChar"></ideTag>
<ideTag id="Char"></ideTag>
<ideTag id="WideChar"></ideTag>
<ideTag id="Boolean"></ideTag>
<ideTag id="WordBool"></ideTag>
<ideTag id="LongBool"></ideTag>
<ideTag id="ByteBool"></ideTag>
<ideTag id="{$Z1}"></ideTag>
<ideTag id="{$Z2}"></ideTag>
<ideTag id="{$Z4}"></ideTag>
<ideTag id="+"></ideTag>
<ideTag id="-"></ideTag>
<ideTag id="Real"></ideTag>
<ideTag id="Enumerated"></ideTag>
<ideTag id="/"></ideTag>
<ideTag id="+/-"></ideTag>
<ideTag id="Real48"></ideTag>
<ideTag id="Inf"></ideTag>
<ideTag id="NaN"></ideTag>
<ideTag id="Extended"></ideTag>
<ideTag id="Double"></ideTag>
<ideTag id="Single"></ideTag>
<ideTag id="Comp"></ideTag>
<ideTag id="Currency"></ideTag>
<ideTag id="Currency"></ideTag>
<ideTag id="Pointer"></ideTag>
<ideTag id="ShortString"></ideTag>
<ideTag id="LongString"></ideTag>
<ideTag id="AnsiString"></ideTag>
<ideTag id="WideString"></ideTag>
<ideTag id="nil"></ideTag>
<ideTag id="Set"></ideTag>
<ideTag id="Min"></ideTag>
<ideTag id="Max"></ideTag>
<ideTag id="Static Array"></ideTag>
<ideTag id="System Array"></ideTag>
<ideTag id="Dynamic Array"></ideTag>
<ideTag id="Record"></ideTag>
<ideTag id="packed"></ideTag>
<ideTag id="Ordinal"></ideTag>
<ideTag id="Real"></ideTag>
<ideTag id="Short"></ideTag>
<ideTag id="Array"></ideTag>
<ideTag id="UserData"></ideTag>
<ideTag id="RecSize"></ideTag>
<ideTag id="Private"></ideTag>
<ideTag id="BufPtr"></ideTag>
<ideTag id="BufSize"></ideTag>
<ideTag id="BufPos"></ideTag>
<ideTag id="BufEnd"></ideTag>
<ideTag id="Openfunc"></ideTag>
<ideTag id="InOutFunc"></ideTag>
<ideTag id="FlushFunc"></ideTag>
<ideTag id="CloseFunc"></ideTag>
<ideTag id="Procedural"></ideTag>
<ideTag id="Class"></ideTag>
<ideTag id="System.MulticastDelegate"></ideTag>
<ideTag id="System.Reflection"></ideTag>
<ideTag id="Pointer"></ideTag>
<ideTag id="Class Reference"></ideTag>
<ideTag id="Class-Reference"></ideTag>
<ideTag id="Variant"></ideTag>
<ideTag id="System"></ideTag>
<ideTag id="TVarData"></ideTag>
<ideTag id="VType"></ideTag>
<ideTag id="varTypeMask"></ideTag>
<ideTag id="varArray"></ideTag>
<ideTag id="varByRef"></ideTag>
<ideTag id="Reserved1"></ideTag>
<ideTag id="Reserved2"></ideTag>
<ideTag id="Reserved3"></ideTag>
<ideTag id="varString"></ideTag>
<ideTag id="varOleStr"></ideTag>
In den folgenden Themen werden die internen Datenformate von {{Delphi}}-Datentypen beschrieben.

==Integertypen==

Integerwerte haben in {{Delphi}} die folgende interne Darstellung.

===Plattformunabhängige vorzeichenlose Integertypen===

Werte von plattformunabhängigen Integertypen belegen auf jeder Plattform dieselbe Bitanzahl.

Werte von vorzeichenlosen Integertypen sind immer positiv und haben kein '''Vorzeichenbit''' wie Integertypen mit Vorzeichen. Alle Bits von vorzeichenlosen Integertypen belegen die Größe des Wertes und haben keine andere Bedeutung.

====Byte, UInt8====

[[lib_de:System.Byte|Byte]] und [[lib_de:System.UInt8|UInt8]] sind 1 Byte (8 Bit) große vorzeichenlose positive Integerzahlen. Die '''Größe''' belegt alle 8 Bit.

: [[Image:IntegerUnsigned8.png|Integer, 8 Bit ohne Vorzeichen]]

====Word und UInt16====

[[lib_de:System.Word|Word]] und [[lib_de:System.UInt16|UInt16]] sind 2 Byte (16 Bit) große vorzeichenlose Integerzahlen.

: [[Image:IntegerUnsigned16.png|Integer, 16 Bit ohne Vorzeichen]]

====FixedUInt, Cardinal und UInt32====

[[lib_de:System.FixedUInt|FixedUInt]], [[lib_de:System.Cardinal|Cardinal]] und [[lib_de:System.UInt32|UInt32]] sind 4 Byte (32 Bit) große vorzeichenlose Integerzahlen.

: [[Image:IntegerUnsigned32.png|Integer, 32 Bit ohne Vorzeichen]]

====UInt64====

[[lib_de:System.UInt64|UInt64]] sind 8 Byte (64 Bit) große vorzeichenlose Integerzahlen.

: [[Image:IntegerUnsigned64.png|Integer, 64 Bit ohne Vorzeichen]]

===Plattformunabhängige Integertypen mit Vorzeichen===

Werte von Integertypen mit Vorzeichen stellen das Vorzeichen einer Zahl durch ein führendes ''Vorzeichenbit'' dar, ausgedrückt durch das höchstwertige Bit. Das Vorzeichenbit ist für positive Zahlen 0 und für negative Zahlen 1. Die anderen Bits in einer positiven Integerzahl mit Vorzeichen werden von der Größe belegt. In einer negativen Integerzahl mit Vorzeichen werden die anderen Bits durch die ''2er-Komplement''-Darstellung der Größe des Wertes (absoluter Wert) belegt.

So ermitteln Sie das 2er-Komplement für eine Größe:

# Suchen Sie beginnend von rechts die erste "1".
# Invertieren Sie alle Bits links davon.

Zum Beispiel:

{|
|-
!
! Beispiel 1
! Beispiel 2
|-
|'''Größe'''
|<code>01010'''1'''0</code>
|<code>101010'''1'''</code>
|-
|
'''2er-Komplement'''
|<code>'''10101'''10</code>
|<code>'''010101'''1</code>
|}

====ShortInt, Int8====

[[lib_de:System.Shortint|Shortint]] und [[lib_de:System.Int8|Int8]] sind 1 Byte (8 Bit) große Integerzahlen mit Vorzeichen. Das '''Vorzeichenbit''' belegt das höchstwertige siebte Bit, die '''Größe''' oder das '''2er-Komplement''' belegt die anderen 7 Bit.

: [[Image:IntegerSignPositive8.png|Integer, 8 Bit positiv mit Vorzeichen]]
: [[Image:IntegerSignNegative8.png|Integer, 8 Bit negativ mit Vorzeichen]]

====SmallInt und Int16====

[[lib_de:System.Smallint|SmallInt]] und [[lib_de:System.Int16|Int16]] sind 2 Byte (16 Bit) große Integerzahlen mit Vorzeichen.

: [[Image:IntegerSignPositive16.png|Integer, 16 Bit positiv mit Vorzeichen]]
: [[Image:IntegerSignNegative16.png|Integer, 16 Bit negativ mit Vorzeichen]]

====FixedInt, Integer und Int32====

[[lib_de:System.FixedInt|FixedInt]], [[lib_de:System.Integer|Integer]] und [[lib_de:System.Int32|Int32]] sind 4 Byte (32 Bit) große Integerzahlen mit Vorzeichen.

: [[Image:IntegerSignPositive32.png|Integer, 32 Bit positiv mit Vorzeichen]]
: [[Image:IntegerSignNegative32.png|Integer, 32 Bit negativ mit Vorzeichen]]

====Int64====

[[lib_de:System.Int64|Int64]] sind 8 Byte (64 Bit) große Integerzahlen mit Vorzeichen.

: [[Image:IntegerSignPositive64.png|Integer, 64 Bit positiv mit Vorzeichen]]
: [[Image:IntegerSignNegative64.png|Integer, 64 Bit negativ mit Vorzeichen]]

===Plattformabhängige Integertypen===

Die plattformabhängigen Integertypen werden konvertiert, damit sie zu der Bitgröße der aktuellen Zielplattform passen. Auf 64-Bit-Plattformen belegen Sie 64 Bit, auf 32-Bit-Plattformen 32 Bit (mit Ausnahme der Typen [[lib_de:System.Longint|LongInt]] und [[lib_de:System.LongWord|LongWord]]).
Wenn die Größe der Zielplattform und die Größe der CPU-Plattform identisch sind, dann stimmt eine plattformabhängige Integerzahl exakt mit der Größe der CPU-Register überein. Diese Typen werden häufig verwendet, wenn eine bestmögliche Leistung für einen bestimmten CPU-Typ und ein bestimmtes Betriebssystem erwünscht ist.

====Vorzeichenloser NativeUInt-Integer====

[[lib_de:System.NativeUInt|NativeUInt]] ist der plattformabhängige vorzeichenlose Integertyp. Die Größe und interne Darstellung von [[lib_de:System.NativeUInt|NativeUInt]] hängen von der aktuellen Plattform ab. Auf 32-Bit-Plattformen entspricht [[lib_de:System.NativeUInt|NativeUInt]] dem Typ [[lib_de:System.Cardinal|Cardinal]]. Auf 64-Bit-Plattformen entspricht [[lib_de:System.NativeUInt|NativeUInt]] dem Typ [[lib_de:System.UInt64|UInt64]].

====NativeInt-Integer mit Vorzeichen====

[[lib_de:System.NativeInt|NativeInt]] ist der plattformabhängige Integertyp mit Vorzeichen. Die Größe und interne Darstellung von [[lib_de:System.NativeInt|NativeInt]] hängen von der aktuellen Plattform ab. Auf 32-Bit-Plattformen entspricht [[lib_de:System.NativeInt|NativeInt]] dem Typ [[lib_de:System.Integer|Integer]]. Auf 64-Bit-Plattformen entspricht [[lib_de:System.NativeInt|NativeInt]] dem Typ [[lib_de:System.Int64|Int64]].

====LongInt und LongWord====

[[lib_de:System.Longint|LongInt]] definiert den Integertyp mit Vorzeichen und [[lib_de:System.LongWord|LongWord]] den Integertyp ohne Vorzeichen.
Die Größe der plattformabhängigen Integertypen [[lib_de:System.Longint|LongInt]] und [[lib_de:System.LongWord|LongWord]] ist auf jeder Plattform anders, mit Ausnahme von 64-Bit-Windows; hier bleibt die Größe unverändert (32 Bit).

{|
|-
! colspan="3" |Größe
|-
|
| '''32-Bit-Plattformen und 64-Bit-Windows-Plattformen'''
| '''64-Bit-iOS-Plattformen'''
|-
|'''LongInt'''
|32 Bit (4 Byte)
|64 Bit (8 Byte)
|-
|
'''LongWord'''
|32 Bit (4 Byte)
|64 Bit (8 Byte)
|}

:'''Hinweis:'''
Zu 32-Bit-Plattformen gehören in {{Product}} 32-Bit-Windows, OSX32, 32-Bit-iOS und Android.

Verwenden Sie auf '''64-Bit-iOS-Plattformen''':

:
:* '''[[lib_de:System.Integer|Integer]]''' oder '''[[lib_de:System.FixedInt|FixedInt]]''' statt [[lib_de:System.Longint|LongInt]], wenn Sie den 32-Bit-Integertyp mit Vorzeichen verwenden möchten.
:* '''[[lib_de:System.Cardinal|Cardinal]]''' oder '''[[lib_de:System.FixedUInt|FixedUInt]]''' statt [[lib_de:System.LongWord|LongWord]], wenn Sie den 32-Bit-Integertyp ohne Vorzeichen verwenden möchten.

==Integer-Teilbereichstypen==

Wenn Sie mit Integerkonstanten die Ober- und Unterbereichsgrenzen von [[Einfache Typen#Teilbereichstypen|Teilbereichstypen]] festlegen, definieren Sie einen ''Integer-Teilbereichstyp''. Ein Integer-Teilbereich ist eine Untermenge der Werte eines anderen Integertyps (des sogenannten ''Basistyps''). Der Basistyp ist der kleinste Integertyp, der den angegebenen Bereich enthält (enthält die Ober- und Unterbereichsgrenzen).

Das interne Datenformat, in dem eine Variable eines Integer-Teilbereichstyps dargestellt werden kann, hängt von den Bereichsgrenzen ab:

* Liegen beide Grenzen im Bereich -128..127 ([[lib_de:System.Shortint|ShortInt]]), wird die Variable als ein Byte mit Vorzeichen gespeichert.
* Liegen beide Grenzen im Bereich 0..255 ([[lib_de:System.Byte|Byte]]), wird die Variable als ein Byte ohne Vorzeichen gespeichert.
* Liegen beide Grenzen im Bereich -32768..32767 ([[lib_de:System.Smallint|SmallInt]]), wird die Variable als ein Word mit Vorzeichen gespeichert.
* Liegen beide Grenzen im Bereich 0..65535 ([[lib_de:System.Word|Word]]), wird die Variable als ein Word ohne Vorzeichen gespeichert.
* Liegen beide Grenzen im Bereich -2147483648..2147483647 ([[lib_de:System.FixedInt|FixedInt]] und [[lib_de:System.Longint|LongInt]] auf 32-Bit-Plattformen und 64-Bit-Windows-Plattformen), wird die Variable als ein Double Word mit Vorzeichen gespeichert.
* Liegen beide Grenzen im Bereich 0..4294967295 ([[lib_de:System.FixedUInt|FixedUInt]] und [[lib_de:System.LongWord|LongWord]] auf 32-Bit-Plattformen und 64-Bit-Windows-Plattformen), wird die Variable als ein Double Word ohne Vorzeichen gespeichert.
* Liegen beide Grenzen im Bereich -2^63..2^63-1 ([[lib_de:System.Int64|Int64]] und [[lib_de:System.Longint|LongInt]] auf 64-Bit-iOS-Plattformen), wird die Variable als Quadruple Word mit Vorzeichen gespeichert.
* Liegen beide Grenzen im Bereich 0..2^64-1 ([[lib_de:System.UInt64|UInt64]] und [[lib_de:System.LongWord|LongWord]] auf 64-Bit-iOS-Plattformen), wird die Variable als Quadruple Word ohne Vorzeichen gespeichert.

<blockquote>'''Hinweis:''' Ein "Word" belegt zwei Byte.</blockquote>

==Zeichentypen==

Auf 32-Bit- und 64-Bit-Plattformen:

* [[lib_de:System.Char|Char]] und [[lib_de:System.WideChar|WideChar]] werden als Word-Variable ohne Vorzeichen in der Regel in der Codierung UTF-16 oder Unicode gespeichert.

* [[lib_de:System.AnsiChar|AnsiChar]] wird als Byte ohne Vorzeichen gespeichert. In {{Delphi}} 2007 und früher wurde '''Char''' als ein '''AnsiChar''' dargestellt. Der Zeichentyp für [[lib_de:System.ShortString|kurze Strings]] ist immer [[lib_de:System.AnsiChar|AnsiChar]]. Er wird in vorzeichenlosen Byte-Werten gespeichert.

* Der Standardtyp für lange Strings (string) ist jetzt [[lib_de:System.UnicodeString|UnicodeString]], dessen Referenzzählung der von [[lib_de:System.AnsiString|AnsiString]] entspricht. AnsiString war früher der Standardtyp für lange Strings. Um die Kompatibilität mit älterem Quelltext aufrechtzuerhalten, könnte die Verwendung des Typs [[lib_de:System.AnsiString|AnsiString]] erforderlich sein.

* [[lib_de:System.WideString|WideString]] setzt sich aus [[lib_de:System.WideChar|WideChars]] wie [[lib_de:System.UnicodeString|UnicodeString]] zusammen, verfügt aber über keine Referenzzählung.

==Boolesche Typen==

Ein '''Boolean'''-Typ wird als ein '''Byte''', ein '''ByteBool'''-Typ wird als ein '''Byte''', ein '''WordBool'''-Typ wird als ein '''Word''' und ein '''LongBool'''-Typ wird als ein '''Longint''' gespeichert.

Ein '''Boolean'''-Typ kann die Werte 0 ('''False''') und 1 ('''True''') annehmen. Die Typen '''ByteBool''', '''WordBool''' und '''LongBool''' können die Werte 0 ('''False''') oder ungleich 0 ('''True''') annehmen.

==Aufzählungstypen==

Ein Aufzählungstyp wird als ein Byte ohne Vorzeichen gespeichert, wenn die Aufzählung nicht mehr als 256 Werte umfasst und der Typ im Status {$Z1} (Voreinstellung) deklariert wurde. Enthält der Aufzählungstyp mehr als 256 Werte oder wurde er im Status {$Z2} deklariert, wird er als ein Word ohne Vorzeichen gespeichert. Wird ein Aufzählungstyp im Status {$Z4} deklariert, wird er als ein Double Word ohne Vorzeichen gespeichert.

==Reelle Typen==

Reelle Typen speichern die binäre Entsprechung des Vorzeichens (<code>'''+'''</code> oder <code>'''-'''</code>), eines Exponenten und einer <code>''Mantisse''</code>. Ein reeller Wert wird in der folgenden Form dargestellt:

+/- ''significand'' * 2^''exponent''

Dabei wird für die <code>''Mantisse''</code> links vom binären Dezimalpunkt ein einziges Bit verwendet (das heißt, <code>0 <= ''Mantisse'' < 2</code>).

In den folgenden Abbildungen befindet sich das höchstwertige Bit immer auf der linken Seite, das niedrigstwertige Bit immer auf der rechten Seite. Die Zahlen am oberen Rand geben die Breite jedes Feldes in Bit an. Die Elemente ganz links werden an den höchsten Adressen gespeichert. Bei einem '''[[lib_de:System.Real48|Real48]]'''-Wert wird beispielsweise <code>e</code> im ersten Byte, <code>''f''</code> in den nächsten fünf Byte und <code>''s''</code> im höchstwertigen Bit des letzten Byte gespeichert.

===Der Typ Real48===

Auf 32-Bit- und 64-Bit-Plattform wird eine '''[[lib_de:System.Real48|Real48]]'''-Zahl mit 6 Byte (48 Bit) in drei Felder unterteilt:

{| style="border: 1px solid #000;"
|-
| style="border: 1px solid #000; background-color: #FFF" |
1
| style="border: 1px solid #000; background-color: #FFF" |
          
39
          
          
          
| style="border: 1px solid #000; background-color: #FFF" |
    
8
    
|-
| style="border: 1px solid #000;" |
<code>s</code>
| style="border: 1px solid #000;" |
          <code>f</code>
| style="border: 1px solid #000;" |
    <code>e</code>
|}

Wenn gilt <code>0 < ''e'' <= 255</code>, ergibt sich der Wert <code>''v''</code> der Zahl folgendermaßen:

''v'' = (-1)s * 2(e-129) * (1.f)

Wenn <code>e = 0</code>, ist <code>v = 0</code>.

Der Typ '''[[lib_de:System.Real48|Real48]]''' eignet sich nicht zum Speichern von denormalisierten Werten, NaN-Werten (Not a Number = keine Zahl) und unendlichen Werten. Denormalisierte Zahlen werden zu null, wenn sie als '''[[lib_de:System.Real48|Real48]]''' gespeichert werden, und das Speichern von NaN- und unendlichen Werten in '''[[lib_de:System.Real48|Real48]]'''-Variablen führt zu einem Überlauffehler.

===Der Typ Single===

Auf 32-Bit- und 64-Bit-Plattform wird eine '''[[lib_de:System.Single|Single]]'''-Zahl mit 4 Byte (32 Bit) in drei Felder unterteilt:

{| style="border: 1px solid #000;"
|-
| style="border: 1px solid #000; background-color: #FFF" |
1
| style="border: 1px solid #000; background-color: #FFF" |
    
8
    
| style="border: 1px solid #000; background-color: #FFF" |
          
23
          
|-
| style="border: 1px solid #000;" |
<code>s</code>
| style="border: 1px solid #000;" |
    
<code>e</code>
| style="border: 1px solid #000;" |
          
<code>f</code>
|}

Der Wert <code>''v''</code> der Zahl ergibt sich folgendermaßen:

*Wenn <code> 0 < e < 255</code>, dann ist <code>v = (-1)s * 2(e-127) * (1.f)</code>

*Wenn <code>e = 0</code> und <code>f <> 0</code>, dann ist <code>v = (-1)s * 2(-126) * (0.f)</code>

*Wenn <code>e = 0</code> und <code>f = 0</code>, dann ist <code>v = (-1)s * 0</code>

*Wenn <code>e = 255</code> und <code>f = 0</code>, dann ist <code>v = (-1)s * Inf</code>

*Wenn <code>e = 255</code> und <code>f <> 0</code>, dann ist <code>v</code> ein NaN-Wert

===Der Typ Double===

Der generische Typ '''[[lib_de:System.Real|Real]]''' entspricht in seiner aktuellen Implementierung dem Typ '''[[lib_de:System.Double|Double]]'''.

Auf 32-Bit- und 64-Bit-Plattform wird eine '''[[lib_de:System.Double|Double]]'''-Zahl mit 8 Byte (64 Bit) in drei Felder unterteilt:

{| style="border: 1px solid #000;"
|-
| style="border: 1px solid #000; background-color: #FFF" |
1
| style="border: 1px solid #000; background-color: #FFF" |
     
11
     
| style="border: 1px solid #000; background-color: #FFF" |
          
               
52
               
          
|-
| style="border: 1px solid #000;" |
<code>s</code>
| style="border: 1px solid #000;" |
     
<code>e</code>
| style="border: 1px solid #000;" |
          
               
<code>f</code>
|}

Der Wert <code>''v''</code> der Zahl ergibt sich folgendermaßen:

*Wenn <code> 0 < e < 2047</code>, dann ist <code>v = (-1)s * 2(e-1023) * (1.f)</code>

*Wenn <code>e = 0</code> und <code>f <> 0</code>, dann ist <code>v = (-1)s * 2(-1022) * (0.f)</code>

*Wenn <code>e = 0</code> und <code>f = 0</code>, dann ist <code>v = (-1)s * 0</code>

*Wenn <code>e = 2047</code> und <code>f = 0</code>, dann ist <code>v = (-1)s * Inf</code>

*Wenn <code>e = 2047</code> und <code>f <> 0</code>, dann ist <code>v</code> ein NaN-Wert

===Der Typ Extended===

'''[[lib_de:System.Extended|Extended]]''' bietet eine höhere Präzision auf 32-Bit Intel-Plattformen an als andere reelle Typen, ist aber weniger portierbar. Seien Sie vorsichtig, wenn Sie '''[[lib_de:System.Extended|Extended]]''' verwenden, wenn Sie gemeinsame und plattformübergreifende Datendateien erstellen. Beachten Sie, dass:

Auf der 32-Bit-Intel-Plattformen wird eine '''[[lib_de:System.Extended|Extended]]'''-Zahl mit 10 Byte (80 Bit) dargestellt. Eine '''[[lib_de:System.Extended|Extended]]'''-Zahl ist in vier Felder unterteilt.

{| style="border: 1px solid #000;"
|-
| style="border: 1px solid #000; background-color: #FFF" |
1
| style="border: 1px solid #000; background-color: #FFF" |
        
15
        
| style="border: 1px solid #000; background-color: #FFF" |
1
| style="border: 1px solid #000; background-color: #FFF" |
                
                
63
                
                
|-
| style="border: 1px solid #000;" |
<code>s</code>
| style="border: 1px solid #000;" |
        
<code>e</code>
| style="border: 1px solid #000;" |
<code>i</code>
| style="border: 1px solid #000;" |
                
                
<code>f</code>
|}

Der Wert <code>''v''</code> der Zahl ergibt sich folgendermaßen:

*Wenn <code>0 <= e < 32767</code>, dann ist <code>v = (-1)s * 2(e-16383) * (i.f)</code>
*Wenn <code>e = 32767</code> und <code>f = 0</code>, dann ist <code>v = (-1)s * Inf</code>
*Wenn <code>e = 32767</code> und <code>f <> 0</code>, dann ist <code>v</code> ein NaN-Wert

Auf der 64-Bit Intel-Plattform und ARM-Plattform ist der '''[[lib_de:System.Extended|Extended]]'''-Typ jedoch ein Alias für '''[[lib_de:System.Double|Double]]''', das nur 8 Bytes hat. Dieser Unterschied kann sich auf numerische Prezision in Gelitkomma-Operationen auswirken. Weitere Informationen finden Sie unter [[Gesichtspunkte für geräteübergreifende Delphi-Anwendungen|Gesichtspunkte für geräteübergreifende Delphi-Anwendungen]]. Auf MAC OS X-Systemen ist die Größe von '''[[lib_de:System.Extended|Extended]]''' 16 Bytes, um mit [[BCCOSX|BCCOSX]] kompatibel zu sein.

===Der Typ Comp===

Eine '''[[lib_de:System.Comp|Comp]]'''-Zahl mit 8 Byte (64 Bit) wird als 64-Bit-Integer mit Vorzeichen gespeichert.

===Der Typ Currency===

Eine '''[[lib_de:System.Currency|Currency]]'''-Zahl mit 8 Byte (64 Bit) wird als skalierter 64-Bit-Integer mit Vorzeichen gespeichert. Dabei stehen die 4 niedrigstwertigen Ziffern implizit für 4 Dezimalstellen.

==Zeigertypen==

Auf 32-Bit-Plattformen wird ein [[Zeiger und Zeigertypen (Delphi)|Zeigertyp]] in 4 Byte als 32-Bit-Adresse gespeichert.

Auf [[64-Bit-Windows-Datentypen im Vergleich zu 32-Bit-Windows-Datentypen|64-Bit-Plattformen]] wird ein [[Zeiger und Zeigertypen (Delphi)|Zeigertyp]] in 8 Byte als 64-Bit-Adresse gespeichert.

Der Zeigerwert '''nil''' wird als null gespeichert.

==[[String-Typen (Delphi)#Kurze String-Typen|Kurze String]]-Typen==

Die Anzahl der Bytes eines [[lib_de:System.ShortString|ShortString]]-Strings ergibt sich aus seiner maximalen Länge + 1. Das erste Byte enthält die aktuelle dynamische Länge des Strings, die folgenden Bytes seine Zeichen.

Das Längenbyte und die Zeichen werden als Werte ohne Vorzeichen betrachtet. Die maximale Länge eines Strings beträgt 255 Zeichen plus ein Längenbyte (string[255]).

==Lange String-Typen==

Eine String-Variable vom Typ '''[[lib_de:System.UnicodeString|UnicodeString]]''' oder '''[[lib_de:System.AnsiString|AnsiString]]''' belegt auf 32-Bit-Plattformen 4 Byte (und auf 64-Bit 8 Byte) im Arbeitsspeicher, die einen Zeiger auf einen dynamisch zugewiesenen String enthalten. Wenn eine String-Variable leer ist (also einen String der Länge 0 enthält), ist der String-Zeiger '''nil''', und der String-Variable wird kein dynamischer Speicher zugewiesen. Andernfalls referenziert der String-Zeiger einen dynamisch zugewiesenen Speicherblock, der neben dem String-Wert Informationen zur Beschreibung des Strings enthält. Die nachfolgenden Tabellen zeigen den Aufbau eines Speicherblocks für einen langen String.

'''Format des Datentyps [[lib_de:System.UnicodeString|UnicodeString]] (32 Bit und 64 Bit)'''

{| border="1" frame="hsides" rules="rows"
|-
! Feld
! '''Codeseite'''
! '''Elementgröße'''
! '''Referenzzählung '''
! '''Länge '''
!'''String-Daten '''

(Elementgröße)
! ''' Nullterminiert'''
|-
| style="text-align: left; vertical-align: top;" |
'''Offset'''
| style="text-align: left; vertical-align: top;" |
<code>-12</code>
| style="text-align: left; vertical-align: top;" |
<code>-10</code>
| style="text-align: left; vertical-align: top;" |
<code>-8</code>
| style="text-align: left; vertical-align: top;" |
<code>-4</code>
| style="text-align: left; vertical-align: top;" |
<code>0..(Länge - 1)</code>
| style="text-align: left; vertical-align: top;" |
<code>Länge * Elementgröße</code>
|-
| style="text-align: left; vertical-align: top;" |
''' Inhalt '''
| style="text-align: left; vertical-align: top;" |
16-Bit-Codeseite der String-Daten
| style="text-align: left; vertical-align: top;" |
16-Bit-Elementgröße der String-Daten
| style="text-align: left; vertical-align: top;" |
32-Bit-Referenzzählung
| style="text-align: left; vertical-align: top;" |
Länge in Zeichen
| style="text-align: left; vertical-align: top;" |
Zeichen-String mit Daten nach Größe der Elemente
| style="text-align: left; vertical-align: top;" |
NULL-Zeichen
|}

Die Zahlen in der Zeile '''Offset''' stellen die Offsets der Felder dar, welche den String-Inhalt ab dem String-Zeiger beschreiben, der auf das Feld '''String-Daten''' zeigt (<code>Offset = 0</code>), das einen Speicherblock mit den tatsächlichen String-Werten enthält.

Das NULL-Zeichen am Ende des Speicherblocks eines Strings wird vom Compiler und den integrierten String-Routinen automatisch verwaltet. Durch das NULL-Zeichen kann ein String direkt in einen nullterminierten String umgewandelt werden.

Siehe auch [[Unicode in RAD Studio#Neuer String-Typ: UnicodeString|Neuer String-Typ: UnicodeString]].

Für String-Literale erzeugt der Compiler einen Speicherblock mit demselben Aufbau wie bei einem dynamisch zugewiesenen String, aber mit einem Referenzzähler von -1. String-Konstanten werden genauso behandelt, der einzige Unterschied zu Literalen ist, dass eine String-Konstante ein Zeiger auf einen -1-Referenzzählerblock ist.

Wenn ein Zeiger auf eine String-Struktur ('''Quelle''') einer String-Variable ('''Ziel''') zugewiesen wird, schreibt der Referenzzähler vor, wie dies ausgeführt wird. Normalerweise wird der Referenzzähler für das Ziel erhöht und für die Quelle verringert, da beide Zeiger (Quelle und Ziel) nach der Zuweisung auf denselben Speicherblock zeigen.

Wenn der Referenzzähler der Quelle -1 (String-Konstante) ist, wird eine neue Struktur mit einem Referenzzähler von 1 erstellt. Wenn das Ziel nicht '''nil''' ist, wird der Referenzzähler verringert. Wenn er 0 erreicht, wird die Struktur aus dem Speicher freigegeben. Wenn das Ziel '''nil''' ist, werden keine weiteren Aktionen dafür ausgeführt.
Das Ziel zeigt dann auf die neue Struktur.
<source lang="delphi">
var
destination : String;
source : String;
...
destination := 'qwerty'; // reference count for the newly-created block of memory (containing the 'qwerty' string) pointed at by the "destination" variable is now 1
...
source := 'asdfgh'; // reference count for the newly-created block of memory (containing the 'asdfgh' string) pointed at by the "destination" variable is now 1
destination := source; // reference count for the memory block containing the 'asdfgh' string is now 2, and since reference count for the block of memory containing the 'qwerty' string is now 0, the memory block is deallocated.
</source>

Wenn der Referenzzähler für die Quelle nicht -1 ist, wird er nicht erhöht, und das Ziel zeigt darauf.
<source lang="delphi">
var
destination, destination2, destination3: String;
destination := 'Sample String'; //reference count for the newly-created block of memory containing 'Sample string' is 1.
destination2 := destination; //reference count for the block of memory containing 'Sample string' is now 2.
destination3 := destination; //reference count for the block of memory containing 'Sample string' is now 3.
</source>

<blockquote>'''Hinweis:''' String-Variablen können nicht auf eine Struktur mit einer Referenzzählung von 0 zeigen. Strukturen werden immer freigegeben, wenn sie die Referenzzählung 0 erreichen, und sie können nicht geändert werden, wenn ihre Referenzzählung -1 ist.</blockquote>

==WideString-Typen==

Auf 32-Bit-Plattformen belegt eine WideString-Variable 4 Byte (und auf 64-Bit-Plattformen 8 Byte), die einen Zeiger auf einen dynamisch zugewiesenen String enthalten. Wenn eine WideString-Variable leer ist (also einen String der Länge 0 enthält), ist der String-Zeiger '''nil''', und der Variable wird kein dynamischer Speicher zugewiesen. Andernfalls referenziert der String-Zeiger einen dynamisch zugewiesenen Speicherblock, der neben dem String-Wert eine Längenangabe von 32 Bit enthält. Die nachstehende Tabelle zeigt den Aufbau eines Speicherblocks für einen WideString in Windows.

''' Aufbau des Speichers für einen WideString (32 Bit und 64 Bit) '''

{| border="1" frame="hsides" rules="rows"
|-
| style="text-align: left; vertical-align: top;" |
''' Offset '''
| style="text-align: center; vertical-align: top;" |
<code>-4</code>
| style="text-align: center; vertical-align: top;" |
<code>0..(Länge - 1)</code>
| style="text-align: center; vertical-align: top;" |
<code>Länge</code>
|-
| style="text-align: left; vertical-align: top;" |
''' Inhalt '''
| style="text-align: center; vertical-align: top;" |
32-Bit-Längenindikator (in Byte)
| style="text-align: center; vertical-align: top;" |
Zeichen-String
| style="text-align: center; vertical-align: top;" |
NULL-Zeichen
|}

Die Länge des Strings ergibt sich aus der Anzahl der Bytes und ist damit doppelt so groß wie die Anzahl der Wide-Zeichen, die er enthält.

Das NULL-Zeichen am Ende des Speicherblocks eines WideStrings wird vom Compiler und den integrierten String-Routinen automatisch verwaltet. Durch das NULL-Zeichen kann ein WideString direkt in einen nullterminierten String umgewandelt werden.

==Mengentypen==

Eine Menge ist ein Array von Bits. Jedes Bit zeigt an, ob ein Element in der Menge enthalten ist oder nicht. Da die maximale Anzahl der Elemente einer Menge 256 beträgt, belegt eine Menge nie mehr als 32 Byte. Die Anzahl der Bytes, die eine bestimmte Menge belegt, ergibt sich wie folgt:

(''Max'' div 8) - (''Min'' div 8) + 1

wobei <code>''Max''</code> und <code>''Min''</code> die obere und die untere Grenze des Basistyps der Menge sind. Die Byte-Anzahl eines bestimmten Elements ''E'' ergibt sich wie folgt:

(''E'' div 8) - (''Min'' div 8)

und die Bitanzahl in diesem Byte ergibt sich aus

''E'' mod 8

wobei <code>''E''</code> der ordinale Wert des Elements ist. Der Compiler speichert Mengen nach Möglichkeit in CPU-Registern. Eine Menge bleibt jedoch immer im Speicher, wenn sie größer als der plattformabhängige Integertyp ist oder im Quelltext des Programms auf die Adresse der Menge zugegriffen wird.

==Statische Array-Typen==

Auf der 32-Bit-Plattform belegt eine statische Array-Variable 4 Byte im Speicher (und 8 Byte auf der 64-Bit-Plattform), die einen Zeiger auf ein statisch zugewiesenes Array enthalten. Ein statisches Array wird als fortlaufende Folge von Variablen des Komponententyps des Arrays gespeichert. Die Komponenten mit den niedrigsten Indizes werden an der niedrigsten Speicheradresse abgelegt. Bei einem mehrdimensionalen Array liegt die äußerste rechte Dimension an der Basis des belegten Speicherblocks.

==Dynamische Array-Typen==

Auf der 32-Bit-Plattform belegt eine dynamische Array-Variable 4 Byte im Speicher (und 8 Byte auf der 64-Bit-Plattform), die einen Zeiger auf ein dynamisch zugewiesenes Array enthalten. Ist eine Variable leer (also nicht initialisiert), ist der Zeiger '''nil''', und der Variable wird kein dynamischer Speicher zugewiesen. Andernfalls referenziert die Variable einen dynamisch zugewiesenen Speicherblock, der neben dem Array eine Längenangabe von 32 Bit (unter Win64 von 64 Bit) und einen Referenzzähler von 32 Bit enthält. Die nachstehende Tabelle zeigt den Aufbau eines Speicherblocks für ein dynamisches Array.

''' Aufbau des Speichers für ein dynamisches Array (32 Bit und 64 Bit) '''

{| border="1" frame="hsides" rules="rows"
|-
| style="text-align: left; vertical-align: top;" |
''' Offset 32 Bit'''
| style="text-align: center; vertical-align: top;" |
<code>-8</code>
| style="text-align: center; vertical-align: top;" |
<code>-4</code>
| style="text-align: center; vertical-align: top;" |
<code>0..(Länge * Größe_des_Elements - 1)</code>
|-
| style="text-align: left; vertical-align: top;" |
''' Offset 64 Bit'''
| style="text-align: center; vertical-align: top;" |
<code>-12</code>
| style="text-align: center; vertical-align: top;" |
<code>-8</code>
| style="text-align: center; vertical-align: top;" |
<code>0..(Länge * Größe_des_Elements - 1)</code>
|-
| style="text-align: left; vertical-align: top;" |
''' Inhalt '''
| style="text-align: center; vertical-align: top;" |
32-Bit-Referenzzählung
| style="text-align: center; vertical-align: top;" |
32 Bit oder 64 Bit auf 64-Bit-Plattformen Längenindikator (Anzahl der Elemente)
| style="text-align: center; vertical-align: top;" |
Array-Elemente
|}

==Record-Typen==

Wenn ein Record-Typ mit dem Status <code>{$A+}</code> (Vorgabe) deklariert wird und die Deklaration nicht den Modifizierer '''packed''' enthält, handelt es sich um einen ungepackten Record-Typ. Die Felder des Records werden so ausgerichtet, dass die CPU entsprechend der jeweiligen Plattform möglichst effizient darauf zugreifen kann. Die Ausrichtung wird vom Typ des jeweiligen Feldes gesteuert. Jeder Datentyp besitzt eine implizite Ausrichtungsmaske, die vom Compiler automatisch berechnet wird. Sie kann die Werte 1, 2, 4 oder 8 haben und entspricht dem Byte-Raster, in dem ein Wert dieses Typs für den optimalen Zugriff im Speicher angeordnet werden muss. Die folgende Tabelle enthält die Ausrichtungsmasken für alle Datentypen.

''' Ausrichtungsmasken für Typen (nur 32 Bit) '''

{| border="1" frame="hsides" rules="rows"
|-
! ''' Typ '''
! ''' Ausrichtung '''
|-
| style="text-align: left; vertical-align: top;" |
Ordinale Typen
| style="text-align: left; vertical-align: top;" |
Größe des Typs (1, 2, 4 oder 8)
|-
| style="text-align: left; vertical-align: top;" |
Reelle Typen
| style="text-align: left; vertical-align: top;" |
2 für ''Real48'', 4 für ''Single'', 8 für ''Double'' und ''Extended''
|-
| style="text-align: left; vertical-align: top;" |
Kurze String-Typen
| style="text-align: left; vertical-align: top;" |
1
|-
| style="text-align: left; vertical-align: top;" |
Array-Typen
| style="text-align: left; vertical-align: top;" |
Entspricht dem Typ der Array-Elemente
|-
| style="text-align: left; vertical-align: top;" |
Record-Typen
| style="text-align: left; vertical-align: top;" |
Die größte Ausrichtungsmaske der Felder im Record
|-
| style="text-align: left; vertical-align: top;" |
Mengentypen
| style="text-align: left; vertical-align: top;" |
Größe des Typs bei 1, 2 oder 4, andernfalls 1
|-
| style="text-align: left; vertical-align: top;" |
Alle anderen Typen
| style="text-align: left; vertical-align: top;" |
Werden von der $A-Direktive festgelegt
|}

Um die korrekte Ausrichtung der Felder in einem ungepackten Record-Typ zu gewährleisten, fügt der Compiler vor den Feldern mit der Ausrichtungsmaske 2 ein leeres Byte ein. Bei Feldern mit der Ausrichtungsmaske 4 werden nach Bedarf bis zu 3 leere Byte eingefügt. Schließlich erweitert der Compiler die gesamte Größe des Records bis zu der Byte-Grenze, die sich aus der größten Ausrichtungsmaske der enthaltenen Felder ergibt.

====Implizites Packen von Feldern mit einer gemeinsamen Typspezifikation====

In früheren Versionen des {{Delphi}}-Compilers, wie {{Delphi}} 7 und vorher, wurde die Ausrichtung '''packed''' implizit für Felder angewendet, die gemeinsam deklariert wurden, d. h., für Felder, die eine gemeinsame Typspezifikation haben. Neuere Compiler können dieses Verhalten erzeugen, wenn Sie die Direktive {$OLDTYPELAYOUT ON} angeben. Diese Direktive packt (auf Byte-Basis) die Felder mit einer gemeinsamen Typspezifikation, auch wenn in der Deklaration der Modifizierer '''packed''' nicht enthalten ist und der Record-Typ nicht mit dem Status <code>{$A-}</code> deklariert wurde.

Betrachten Sie folgende Deklaration:

<source lang="delphi">
{$OLDTYPELAYOUT ON}
type
TMyRecord = record
A, B: Extended;
C: Extended;
end;
{$OLDTYPELAYOUT OFF}
</source>

<code>A</code> und <code>B</code> werden gepackt (an Byte-Grenzen ausgerichtet), weil die Direktive {$OLDTYPELAYOUT ON} angegeben ist und <code>A</code> und <code>B</code> dieselbe Typspezifikation verwenden. Für das separat deklarierte Feld <code>C</code> verwendet der Compiler aber das Standardverhalten und füllt die Struktur mit unbenutzten Bytes auf, damit das Feld an einer Quadword-Grenze erscheint.

Wenn ein Record-Typ mit dem Status <code>{$A-}</code> deklariert wird oder die Deklaration den Modifizierer '''packed''' enthält, werden die Felder des Records nicht ausgerichtet, sondern an aufeinander folgenden Offsets abgelegt. Die Gesamtgröße eines solchen gepackten Records ergibt sich aus der Größe aller Felder. Da sich die Datenausrichtung ändern kann, bieten sich gepackte Record-Typen für alle Record-Strukturen an, die auf die Festplatte geschrieben oder im Speicher an ein Modul übergeben werden sollen, das mit einer anderen Version des Compilers compiliert wird.

==Dateitypen==

Dateitypen werden als Records dargestellt. Typisierte und untypisierte Dateien belegen auf 32-Bit-Plattformen 592 Byte und auf 64-Bit-Plattformen 616 Byte, die sich wie folgt verteilen:

<source lang="delphi">
type
TFileRec = packed record
Handle: NativeInt;
Mode: word;
Flags: word;
case Byte of
0: (RecSize: Cardinal);
1: (BufSize: Cardinal;
BufPos: Cardinal;
BufEnd: Cardinal;
BufPtr: _PAnsiChr;
OpenFunc: Pointer;
InOutFunc: Pointer;
FlushFunc: Pointer;
CloseFunc: Pointer;
UserData: array[1..32] of Byte;
Name: array[0..259] of WideChar; );
end;
</source>

Textdateien belegen auf 32-Bit-Plattformen 730 Byte und auf 64-Bit-Plattformen 754 Byte, die sich wie folgt verteilen:

<source lang="delphi">
type
TTextBuf = array[0..127] of Char;
TTextRec = packed record
Handle: NativeInt;
Mode: word;
Flags: word;
BufSize: Cardinal;
BufPos: Cardinal;
BufEnd: Cardinal;
BufPtr: _PAnsiChr;
OpenFunc: Pointer;
InOutFunc: Pointer;
FlushFunc: Pointer;
CloseFunc: Pointer;
UserData: array[1..32] of Byte;
Name: array[0..259] of WideChar;
Buffer: TTextBuf; //
CodePage: Word;
MBCSLength: ShortInt;
MBCSBufPos: Byte;
case Integer of
0: (MBCSBuffer: array[0..5] of _AnsiChr);
1: (UTF16Buffer: array[0..2] of WideChar);
end;
</source>

<code>Handle</code> enthält das Handle der Datei (wenn die Datei geöffnet ist).

Das Feld <code>Mode</code> kann einen der folgenden Werte annehmen:

<source lang="delphi">
const
fmClosed = $D7B0;
fmInput= $D7B1;
fmOutput = $D7B2;
fmInOut= $D7B3;
</source>

<code>fmClosed</code> gibt dabei an, dass die Datei geschlossen ist. <code>fmInput</code> und <code>fmOutput</code> geben an, dass es sich bei der Datei um eine Textdatei handelt, die zurückgesetzt (<code>fmInput</code>) oder neu geschrieben (<code>fmOutput</code>) wurde. <code>fmInOut</code> gibt an, dass die Datei eine typisierte oder eine untypisierte Datei ist, die zurückgesetzt oder neu geschrieben wurde. Jeder andere Wert gibt an, dass die Dateivariable nicht zugeordnet (und damit nicht initialisiert) wurde.

Das Feld <code>UserData</code> wird für benutzerdefinierte Routinen freigehalten, um Daten zu speichern.

<code>Name</code> enthält den Dateinamen. Dieser besteht aus einer Folge von Zeichen, die mit einem Null-Zeichen (#0) abgeschlossen ist.

Bei typisierten und untypisierten Dateien enthält <code>RecSize</code> die Record-Länge in Byte. Das Feld <code>Private</code> ist reserviert und wird nicht verwendet.

Bei Textdateien ist <code>BufPtr</code> ein Zeiger auf einen Puffer mit <code>BufSize</code> Byte, <code>BufPos</code> ist der Index des nächsten zu lesenden oder zu schreibenden Zeichens des Puffers. <code>BufEnd</code> entspricht der Anzahl der gültigen Zeichen im Puffer. <code>OpenFunc</code>, <code>InOutFunc</code>, <code>FlushFunc</code> und <code>CloseFunc</code> sind Zeiger auf die E/A-Routinen, die die Datei verwalten. Weitere Informationen zu diesem Thema finden Sie unter "Gerätefunktionen". <code>Flags</code> legt die Art des Zeilenumbruchs fest.

{| border="1" frame="hsides" rules="rows"
|-
| style="text-align: left; vertical-align: top;" |
Bit 0 nicht gesetzt
| style="text-align: left; vertical-align: top;" |
LF-Zeilenumbruch
|-
| style="text-align: left; vertical-align: top;" |
Bit 0 gesetzt
| style="text-align: left; vertical-align: top;" |
CRLF-Zeilenumbruch
|}

Alle anderen <code>Flags</code>-Bits sind für die zukünftige Verwendung reserviert.

<blockquote>'''Hinweis:''' Für den Typ '''UnicodeString''' (dem Standard-String-Typ in {{Delphi}}) sind die verschiedenen Stream-Typen aus der Unit '''Classes''' ('''TFileStream''', '''TStreamReader''', '''TStreamWriter''' usw.) nützlicher, weil die älteren Dateitypen (besonders ältere Textdateitypen) nur über eine begrenzte Unicode-Funktionalität verfügen. </blockquote>

==Prozedurale Typen==

Auf der 32-Bit-Plattform wird ein Prozedurzeiger als 32-Bit-Zeiger auf den Eintrittspunkt einer Prozedur oder Funktion gespeichert. Ein Methodenzeiger wird als 32-Bit-Zeiger auf den Eintrittspunkt einer Methode gespeichert, dem ein 32-Bit-Zeiger auf ein Objekt folgt.

Auf der 64-Bit-Plattform wird ein Prozedurzeiger als 64-Bit-Zeiger auf den Eintrittspunkt einer Prozedur oder Funktion gespeichert. Ein Methodenzeiger wird als 64-Bit-Zeiger auf den Eintrittspunkt einer Methode gespeichert, dem ein 64-Bit-Zeiger auf ein Objekt folgt.

==Klassentypen==

Auf der 32-Bit-Plattform (Win32, OSX, iOS und Android) wird der Wert eines Klassentyps als 32-Bit-Zeiger auf eine Instanz der Klasse (bzw. als 64-Bit-Zeiger auf der 64-Bit-Plattform) gespeichert. Die Instanz einer Klasse wird auch als ''Objekt'' bezeichnet. Das interne Datenformat eines Objekts gleicht dem eines Records. Die Felder eines Objekts werden in der Reihenfolge ihrer Deklaration als fortlaufende Folge von Variablen gespeichert. Die Felder werden wie bei einem ungepackten Record-Typ immer ausgerichtet. Die Ausrichtung entspricht deshalb der größten Ausrichtungsmaske der Felder im ''Objekt''. Alle von einer Vorfahrklasse geerbten Felder werden vor den neuen Feldern gespeichert, die in der abgeleiteten Klasse definiert wurden.

Auf der 32-Bit-Plattform ist das erste, 4 Byte große Feld aller Objekte (bzw. auf der 64-Bit-Plattform das erste, 8 Byte große Feld) ein Zeiger auf die ''virtuelle Methodentabelle'' (VMT) der Klasse. Es gibt nur eine VMT pro Klasse (und nicht eine für jedes Objekt). Verschiedene Klassentypen verwenden nie dieselbe VMT. VMTs werden automatisch vom Compiler erstellt und nie direkt von einem Programm geändert. Ebenso werden die Zeiger auf VMTs automatisch von den Konstruktormethoden in den erstellten Objekten gespeichert und nie direkt von einem Programm geändert.

Die folgende Tabelle zeigt die Struktur einer VMT. Auf der 32-Bit-Plattform besteht eine VMT bei positiven Offsets aus einer Liste mit 32-Bit-Methodenzeigern (64-Bit-Methodenzeiger auf der 64-Bit-Plattform). Für jede benutzerdefinierte virtuelle Methode des Klassentyps ist ein Zeiger vorhanden. Die Zeiger sind in der Reihenfolge der Deklaration angeordnet. Jeder Eintrag enthält die Adresse des Eintrittspunkts der entsprechenden virtuellen Methode. Dieses Layout ist zur V-Tabelle von C++ und zu COM kompatibel. Bei negativen Offsets enthält eine VMT die Anzahl der Felder, die in {{Delphi}} intern implementiert sind. In einer Anwendung sollten diese Informationen mit den Methoden von TObject abgerufen werden, da sich dieses Layout bei künftigen Implementierungen von {{Delphi}} ändern kann.

''' Struktur der virtuellen Methodentabelle'''

{| border="1" frame="hsides" rules="rows"
|-
! Offset Win32, OSX
! Offset Win64
! Offset iOS/ARM, Android/ARM
! Offset iOS/Simulator
! ''' Typ '''
! ''' Beschreibung '''
! ''' Konstante in System.pas '''
|-
| style="text-align: left; vertical-align: top;" |
-88
| style="text-align: left; vertical-align: top;" |
-200
| style="text-align: left; vertical-align: top;" |
-108
| style="text-align: left; vertical-align: top;" |
-96
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die virtuelle Methodentabelle (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtSelfPtr
|-
| style="text-align: left; vertical-align: top;" |
-84
| style="text-align: left; vertical-align: top;" |
-192
| style="text-align: left; vertical-align: top;" |
-104
| style="text-align: left; vertical-align: top;" |
-92
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die Interface-Tabelle (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtIntfTable
|-
| style="text-align: left; vertical-align: top;" |
-80
| style="text-align: left; vertical-align: top;" |
-184
| style="text-align: left; vertical-align: top;" |
-100
| style="text-align: left; vertical-align: top;" |
-88
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die Informationstabelle zur Automatisierung (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtAutoTable
|-
| style="text-align: left; vertical-align: top;" |
-76
| style="text-align: left; vertical-align: top;" |
-176
| style="text-align: left; vertical-align: top;" |
-96
| style="text-align: left; vertical-align: top;" |
-84
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die Instanzeninitialisierungstabelle (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtInitTable
|-
| style="text-align: left; vertical-align: top;" |
-72
| style="text-align: left; vertical-align: top;" |
-168
| style="text-align: left; vertical-align: top;" |
-92
| style="text-align: left; vertical-align: top;" |
-80
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die Typinformationstabelle (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtTypeInfo
|-
| style="text-align: left; vertical-align: top;" |
-68
| style="text-align: left; vertical-align: top;" |
-160
| style="text-align: left; vertical-align: top;" |
-88
| style="text-align: left; vertical-align: top;" |
-76
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die Felddefinitionstabelle (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtFieldTable
|-
| style="text-align: left; vertical-align: top;" |
-64
| style="text-align: left; vertical-align: top;" |
-152
| style="text-align: left; vertical-align: top;" |
-84
| style="text-align: left; vertical-align: top;" |
-72
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die Methodendefinitionstabelle (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtMethodTable
|-
| style="text-align: left; vertical-align: top;" |
-60
| style="text-align: left; vertical-align: top;" |
-144
| style="text-align: left; vertical-align: top;" |
-80
| style="text-align: left; vertical-align: top;" |
-68
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf die dynamische Methodentabelle (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtDynamicTable
|-
| style="text-align: left; vertical-align: top;" |
-56
| style="text-align: left; vertical-align: top;" |
-136
| style="text-align: left; vertical-align: top;" |
-76
| style="text-align: left; vertical-align: top;" |
-64
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf einen kurzen String, der den Klassennamen enthält
| style="text-align: left; vertical-align: top;" |
vmtClassName
|-
| style="text-align: left; vertical-align: top;" |
-52
| style="text-align: left; vertical-align: top;" |
-128
| style="text-align: left; vertical-align: top;" |
-72
| style="text-align: left; vertical-align: top;" |
-60
| style="text-align: left; vertical-align: top;" |
Cardinal
| style="text-align: left; vertical-align: top;" |
Instanzgröße in Byte
| style="text-align: left; vertical-align: top;" |
vmtInstanceSize
|-
| style="text-align: left; vertical-align: top;" |
-48
| style="text-align: left; vertical-align: top;" |
-120
| style="text-align: left; vertical-align: top;" |
-68
| style="text-align: left; vertical-align: top;" |
-56
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf einen Zeiger auf die Vorfahrklasse (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtParent
|-
| style="text-align: left; vertical-align: top;" |
n/v
| style="text-align: left; vertical-align: top;" |
n/v
| style="text-align: left; vertical-align: top;" |
-64
| style="text-align: left; vertical-align: top;" |
-52
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode __ObjAddRef
| style="text-align: left; vertical-align: top;" |
vmtObjAddRef
|-
| style="text-align: left; vertical-align: top;" |
n/v
| style="text-align: left; vertical-align: top;" |
n/v
| style="text-align: left; vertical-align: top;" |
-60
| style="text-align: left; vertical-align: top;" |
-48
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode __ObjRelease
| style="text-align: left; vertical-align: top;" |
vmtObjRelease
|-
| style="text-align: left; vertical-align: top;" |
-44
| style="text-align: left; vertical-align: top;" |
-112
| style="text-align: left; vertical-align: top;" |
-56
| style="text-align: left; vertical-align: top;" |
-44
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode Equals
| style="text-align: left; vertical-align: top;" |
vmtEquals
|-
| style="text-align: left; vertical-align: top;" |
-40
| style="text-align: left; vertical-align: top;" |
-104
| style="text-align: left; vertical-align: top;" |
-52
| style="text-align: left; vertical-align: top;" |
-40
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode GetHashCode
| style="text-align: left; vertical-align: top;" |
vmtGetHashCode
|-
| style="text-align: left; vertical-align: top;" |
-36
| style="text-align: left; vertical-align: top;" |
-96
| style="text-align: left; vertical-align: top;" |
-48
| style="text-align: left; vertical-align: top;" |
-36
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode ToString
| style="text-align: left; vertical-align: top;" |
vmtToString
|-
| style="text-align: left; vertical-align: top;" |
-32
| style="text-align: left; vertical-align: top;" |
-88
| style="text-align: left; vertical-align: top;" |
-44
| style="text-align: left; vertical-align: top;" |
-32
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Zeiger auf den Eintrittspunkt der Methode ''SafecallException'' (oder '''nil''')
| style="text-align: left; vertical-align: top;" |
vmtSafeCallException
|-
| style="text-align: left; vertical-align: top;" |
-28
| style="text-align: left; vertical-align: top;" |
-80
| style="text-align: left; vertical-align: top;" |
-40
| style="text-align: left; vertical-align: top;" |
-28
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode ''AfterConstruction''
| style="text-align: left; vertical-align: top;" |
vmtAfterConstruction
|-
| style="text-align: left; vertical-align: top;" |
-24
| style="text-align: left; vertical-align: top;" |
-72
| style="text-align: left; vertical-align: top;" |
-36
| style="text-align: left; vertical-align: top;" |
-24
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode ''BeforeDestruction''
| style="text-align: left; vertical-align: top;" |
vmtBeforeDestruction
|-
| style="text-align: left; vertical-align: top;" |
-20
| style="text-align: left; vertical-align: top;" |
-64
| style="text-align: left; vertical-align: top;" |
-32
| style="text-align: left; vertical-align: top;" |
-20
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode ''Dispatch''
| style="text-align: left; vertical-align: top;" |
vmtDispatch
|-
| style="text-align: left; vertical-align: top;" |
-16
| style="text-align: left; vertical-align: top;" |
-56
| style="text-align: left; vertical-align: top;" |
-28
| style="text-align: left; vertical-align: top;" |
-16
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode ''DefaultHandler''
| style="text-align: left; vertical-align: top;" |
vmtDefaultHandler
|-
| style="text-align: left; vertical-align: top;" |
-12
| style="text-align: left; vertical-align: top;" |
-48
| style="text-align: left; vertical-align: top;" |
-24
| style="text-align: left; vertical-align: top;" |
-12
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode ''NewInstance''
| style="text-align: left; vertical-align: top;" |
vmtNewInstance
|-
| style="text-align: left; vertical-align: top;" |
-8
| style="text-align: left; vertical-align: top;" |
-40
| style="text-align: left; vertical-align: top;" |
-20
| style="text-align: left; vertical-align: top;" |
-8
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der Methode ''FreeInstance''
| style="text-align: left; vertical-align: top;" |
vmtFreeInstance
|-
| style="text-align: left; vertical-align: top;" |
-4
| style="text-align: left; vertical-align: top;" |
-32
| style="text-align: left; vertical-align: top;" |
-16
| style="text-align: left; vertical-align: top;" |
-4
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt des Destruktors ''Destroy''
| style="text-align: left; vertical-align: top;" |
vmtDestroy
|-
| style="text-align: left; vertical-align: top;" |
0
| style="text-align: left; vertical-align: top;" |
0
| style="text-align: left; vertical-align: top;" |
0
| style="text-align: left; vertical-align: top;" |
0
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der ersten benutzerdefinierten virtuellen Methode
|
|-
| style="text-align: left; vertical-align: top;" |
4
| style="text-align: left; vertical-align: top;" |
8
| style="text-align: left; vertical-align: top;" |
4
| style="text-align: left; vertical-align: top;" |
4
| style="text-align: left; vertical-align: top;" |
Zeiger
| style="text-align: left; vertical-align: top;" |
Eintrittspunkt der zweiten benutzerdefinierten virtuellen Methode
|
|}

==Klassenreferenztypen==

Auf der 32-Bit-Plattform (Win32, OSX, iOS und Android) wird der Wert einer Klassenreferenz als 32-Bit-Zeiger auf die virtuelle Methodentabelle (VMT) einer Klasse gespeichert.

Auf der 64-Bit-Plattform (Win64) wird der Wert einer Klassenreferenz als 64-Bit-Zeiger auf die virtuelle Methodentabelle (VMT) einer Klasse gespeichert.

==Variante Typen==

Varianten sind beim Implementieren von variantenbezogenen RTL-Funktionen vom Boxing und Unboxing von Daten in einen Objekt-Wrapper sowie von {{Delphi}}-Hilfsklassen abhängig.

Auf der 32-Bit-Plattform wird eine Variante als 16-Byte-Record gespeichert, der einen Typcode und einen Wert (oder eine Referenz auf einen Wert) des durch den Code bezeichneten Typs enthält. Auf der 64-Bit-Plattform wird eine Variante als 24-Byte-Record gespeichert. Die Units [[lib_de:System|System]] und [[lib_de:System.Variants|System.Variants]] definieren Konstanten und Typen für Varianten.

Der Typ [[lib_de:System.TVarData|TVarData]] steht für die interne Struktur einer [[lib_de:System.Variant|Variante]] (in Windows entspricht er dem Typ [[lib_de:System.Variant|Variant]], der von COM und der Win32-API verwendet wird). Mit dem Typ [[lib_de:System.TVarData|TVarData]] kann bei einer Typumwandlung von Varianten auf die interne Struktur einer Variable zugegriffen werden. Der Record [[lib_de:System.TVarData|TVarData]] enthält die folgenden Felder:

* Das Feld '''VType''' mit dem Typ [[lib_de:System.TVarType|TVarType]] hat die Größe [[lib_de:System.Word|Word]] (16 Bit). '''VType''' enthält den Typcode der Variante in den niederwertigen 12 Bit (die Bits, die von der Konstante [[Lib en:System#Konstanten|varTypeMask]] <code>= $FFF</code> definiert werden). Zusätzlich zeigt das Bit [[Lib en:System#Konstanten|varArray]] <code>= $2000</code> an, ob es sich bei der Variante um ein Array handelt. Das Bit [[Lib en:System#Konstanten|varByRef]] (<code>= $4000</code>) gibt an, ob die Variante eine Referenz oder einen Wert enthält.
* Die Felder '''Reserved1''', '''Reserved2''' und '''Reserved3''' ([[lib_de:System.Word|Word]]-Größe) werden nicht verwendet.

Der Inhalt der restlichen 8 Byte (32-Bit-Plattform) oder 16 Byte (64-Bit-Plattform) eines [[lib_de:System.TVarData|TVarData]]-Records hängt folgendermaßen vom Feld '''VType''' ab:

* Wenn weder das Bit [[Lib en:System#Konstanten|varArray]] noch das Bit [[Lib en:System#Konstanten|varByRef]] gesetzt ist, enthält die Variante einen Wert des gegebenen Typs.
* Wenn das Bit [[Lib en:System#Konstanten|varArray]] gesetzt ist, enthält die Variante einen Zeiger auf eine [[lib_de:System.TVarArray|TVarArray]]-Struktur, die das Array definiert. Der Typ jedes Array-Elements ist durch die [[Lib en:System#Konstanten|varTypeMask]]-Bits des Feldes '''VType''' festgelegt.
* Wird das Bit [[Lib en:System#Konstanten|varByRef]] gesetzt, enthält die Variante eine Referenz auf einen Wert des Typs, der durch die Bits '''varTypeMask''' und '''varArray''' im Feld '''VType''' definiert ist.

Der Typcode [[lib_de:System.TVarType|varString]] ist "private". Varianten, die einen [[lib_de:System.TVarType|varString]]-Wert enthalten, sollten nicht an Nicht-{{Delphi}}-Funktionen übergeben werden. Auf der Windows-Plattform sorgt die Automatisierungsunterstützung von {{Delphi}} dafür, dass [[lib_de:System.TVarType|varString]]-Varianten vor der Übergabe an externe Funktionen automatisch in [[lib_de:System.TVarType|varOleStr]]-Varianten umgewandelt werden.

==Siehe auch==

* [[Speicherverwaltung|Speicherverwaltung]]
* [[64-Bit-Windows-Datentypen im Vergleich zu 32-Bit-Windows-Datentypen|64-Bit-Windows-Datentypen im Vergleich zu 32-Bit-Windows-Datentypen]]
* [[Überblick über Datentypen (Delphi)|Überblick über Datentypen (Delphi)]]
* [[String-Typen (Delphi)|String-Typen (Delphi)]]
* [[Strukturierte Typen|Strukturierte Typen (Delphi)]]

[[Category:Delphi]]
[[Category:Delphi-Sprachreferenz]]
[[Category:AMMigrate]]

Interne Datenformate (Delphi)

2016-06-30T08:02:34Z

Esabatell: Internal review. LOC-22606

XLINK.EXE: Der macOS-Linker

2016-06-24T10:56:40Z

Esabatell: Updated. LOC-22885

{{Parent|Befehlszeilenhilfsprogramme - Index}}

XLINK.EXE ist die Befehlszeilenoberfläche von [[XLINK|XLINK]], der C++-Linker für Mac OS X.

==Befehlszeilenhilfe==

<code>
</code>

<code>C:\>xlink
Turbo Incremental Link 1.00 Copyright (c) 1997-2011 {{Company}} Technologies, Inc.
Syntax: ILINK objfiles, exefile, mapfile, libfiles, deffile, resfiles
@xxxx indicates use response file xxxx
General Options: -Af:nnnn Specify file alignment
-C Clear state before linking -Ao:nnnn Specify object alignment
-wxxx Warning control -ax Specify application type
-Enn Max number of errors -b:xxxx Specify image base addr
-r Verbose linking -Txx Specify output file type
-q Suppress banner -H:xxxx Specify heap reserve size
-c Case sensitive linking -Hc:xxxx Specify heap commit size
-v Full debug information -S:xxxx Specify stack reserve size
-Gn No state files -Sc:xxxx Specify stack commit size
-Gi Generate import library -Vd.d Specify Windows version
-GD Generate .DRC file -Dstring Set image description
Map File Control: -Vd.d Specify subsystem version
-M Map with mangled names -Ud.d Specify image user version
-m Map file with publics -GC Specify image comment str
-s Detailed segment map -GF Set image flags
-x No map -Gl Static package
Paths: -Gpd Design time only package
-I Intermediate output dir -Gpr Runtime only package
-L Specify library search paths -GS Set section flags
-j Specify object search paths -Gt Fast TLS
Image Control: -Gz Do image checksum
-d Delay load a .DLL -Rr Replace resources
</code>

==Erzeugen der Ausgabe==

Mit der Optionsfamilie <code>-Txx</code> können Sie das Erzeugen der Ausgabe steuern:

{|
|-
! Option
! Befehl
|-
|
<code>-Tmd</code>
|
Mach-dylib erzeugen
|-
|
<code>-Tme</code>
|
Ausführbare Mach-Datei erzeugen
|-
|
<code>-Tmp</code>
|
Mach-Package erzeugen
|}

==Festlegen der Bibliotheken==

Die Suchpfade für die XLINK-Bibliothek können mit den folgenden Optionen gesteuert werden:

{|
|-
! Option
! Beschreibung
|-
|
<code>-Fr</code>
|
Legt das logische Stammverzeichnis: <code>$(SYSROOT)</code> fest. Diese Option muss einmal angegeben werden. (Für [[BCCOSX.EXE: Der C++-Compiler für OS X|BCCOSX]] würden Sie die Option <code>--sysroot</code> verwenden.)
|-
|
<code>-Fp</code>
|
Gibt die Remote-Bibliothekspfade an. Pfaden, die mit <code>-Fp</code> angegeben werden, wird <code>$(SYSROOT)</code> vorangestellt und das Ergebnis dem Bibliothekspfad hinzugefügt. In einem {{Variables|Product}}-Projekt werden die Remote-Bibliotheken in dem Fenster [[SDK-Manager|SDK-Manager]] angegeben (Sie sollten die SDK-Remote-Pfade bearbeiten). Diese Option kann mehrmals angegeben werden. Dieser Option sollte die Option <code>-Fr</code> vorausgehen.
|-
|
<code>-L</code>
|
Legt die lokalen Bibliothekssuchpfade fest.
|}

Sie können die Optionen <code>-L</code> und <code>-Fp</code> verschachteln.

==Festlegen des Frameworks==

Verwenden Sie die Option <code>-Ff</code>, um ein bestimmtes Framework einzubinden.

{|
|-
! Option
! Beschreibung
|-
|
<code>-Ff</code>
|
Weist XLINK an, das angegebene Framework einzubinden. Um beispielsweise das Framework '''Carbon''' einzubinden, geben Sie <code>-FfCarbon</code> an.
|-
|
<code>[[--framework|--framework]]</code> (BCCOSX-Option)
|
Weist BCCOSX an, das angegebene Framework einzubinden. Die auf diese Weise angegebenen Framework-Namen werden mit der Option <code>-Ff</code> an XLINK umgeleitet.
|}

In einem {{Variables|Product}}-Projekt können die Frameworks in dem Fenster [[SDK-Manager|SDK-Manager]] angegeben werden (Sie sollten die SDK-Remote-Pfade bearbeiten).

==Parameter für ausführbare Header==

Einer dynamischen OS X-Bibliothek ist ein '''Installationsname''' (oder '''ID-Name''') zugeordnet. Dieser String wird in die Datei .dylib eingebettet, die den Pfad der .dylib-Datei repräsentiert. Der '''Installationsname''' von '''CoreServices''' lautet beispielsweise <code>/System/Library/Frameworks/CoreServices.framework/Versions/A/CoreServices</code>. Beim Erzeugen einer ausführbaren OS X-Datei oder dynamischen Bibliothek, die von '''CoreServices''' abhängt, fügt XLINK einen Record mit der '''Installationsnamensinformation''' von '''CoreServices''' in das binäre Image ein.

Ein binäres OS X-Image enthält die Header mit den Parametern für das Laden. Einige dieser Parameter enthalten dynamische Bibliothekspfade, die beim Linken unbekannt sein könnten. Solche Pfade können gepatcht werden, das kann aber problematisch werden, wenn der Linker nicht genügend Speicher in dem Image-Header reserviert. Mit der Option <code>-Gr</code> können Sie die Anzahl der zusätzlich zu reservierenden Bytes festlegen.

==Themen==

* [[Linken einer C++-Anwendung Hello World für OS X|Linken einer C++-Anwendung Hello World für OS X]]

==Siehe auch==

* [[Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile|Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile]]
* [[Gesichtspunkte für geräteübergreifende C++-Anwendungen|Gesichtspunkte für geräteübergreifende C++-Anwendungen]]
* [[Pragma link|#pragma link]]
* [[ILINK32.EXE: Der inkrementelle 32-Bit-Linker|ILINK32.EXE: Der inkrementelle 32-Bit-Linker]]
* [[ILINK64.EXE: Der inkrementelle 64-Bit-Linker|ILINK64.EXE: Der inkrementelle 64-Bit-Linker]]

[[Category:XE4]]
[[Category:OS X]]
[[Category:Geräteübergreifend]]

[[en:XLINK.EXE, the OS X Linker]]
[[fr:XLINK.EXE, le lieur OS X]]
[[ja:XLINK.EXE - OS X リンカ]]

Neuerungen in Seattle

2016-06-24T10:56:26Z

Esabatell: Updated. LOC-22885

{{Parent|Neuerungen in den letzten Releases}}

Das {{Version|Seattle}}-Release enthält die folgenden neuen und verbesserten Features.

:'''Hinweis:''' Informationen zur Kompatibilität mit OS X 10.11 (El Capitan) und iOS 9 finden Sie unter [[#Hinweise zu OS X 10.11 und iOS 9|Hinweise zu OS X 10.11 und iOS 9]].

==[[Compiler für C++|Compiler für C++]]==

===Neuer durch Clang erweiterter C++-Compiler für 32-Bit-Windows===

'''[[BCC32C|BCC32C]]''' ist ein [[Durch Clang erweiterte C++-Compiler|durch Clang erweiterter C++-Compiler]] für 32-Bit-Windows. Mit BCC32C können Sie die Vorteile [[Kompatibilitätsstatus der C++11-Sprach-Features|vieler C++11-Features]] nutzen und einfacher eine einzige Codebasis für 32-Bit- und 64-Bit-Windows verwalten.

BCC32C ersetzt BCC32 nicht; in {{Product|Seattle}} können Sie wählen, welchen Compiler Sie für das jeweilige Projekt verwenden möchten. BCC32 ist der Standard-C++-Compiler für 32-Bit-Windows. Um für ein Projekt zu BCC32C zu wechseln, wählen Sie {{Menu|Projekt > Optionen > [[C++-Compiler|C++-Compiler]]}} und deaktivieren unter '''Klassischer Compiler''' die Option "'Klassischen' Borland-Compiler verwenden".

===Aktualisierte Clang- und LLVM-Versionen===

'''[[BCC32C|BCC32C]]''' und '''[[BCC64|BCC64]]''', [[Durch Clang erweiterte C++-Compiler|durch Clang erweiterte C++-Compiler]] für Windows, wurden auf '''Clang 3.3''' und '''LLVM 3.3''' aktualisiert.

===Parallele Compilierung für durch Clang erweiterte C++-Compiler===

In {{Version|Seattle}} können Sie [[Durch Clang erweiterte C++-Compiler#Verwenden der parallelen Compilierung|in C++-Compilern, die durch Clang erweitert wurden, die parallele Compilierung aktivieren]], um die Compilierungsdauer auf Systemen mit Mehrkernprozessoren signifikant zu reduzieren.

===Einschränkungen des Schlüsselworts __property bei C++-Compilern der vorherigen Generation===

Die BCC32- und BCCOSX-Compiler unterstützen das Schlüsselwort {{Code|default}} für indizierte Eigenschaften nicht. Weitere Informationen finden Sie unter [[Property#Compiler-Unterstützung|__property - Compiler-Unterstützung]].

===Neue Konstante für durch Clang erweiterte C++-Compiler===

Die Konstante [[Unterschiede zwischen C++-Compilern, die durch Clang erweitert wurden, und C++-Compilern der vorherigen Generation#Vordefinierte Makros|RTLVersion]] wird von C++-Compilern, die durch Clang erweitert wurden, nicht unterstützt. Sie können stattdessen '''RTLVersionC''' verwenden.

==[[FireMonkey|FireMonkey]]==

==={{FM|Seattle}} unterstützt Windows 10===

{{FM|Seattle}} unterstützt das Erstellen von nativen Anwendungen für '''Windows 10''' vollständig. Das Framework ermittelt automatisch die Zielplattform, lädt zur Laufzeit den entsprechenden nativen Stil und zeigt ihn an, ohne dass Sie ein Stilbuch oder Code hinzufügen müssen.

===Übernehmen von Daten in andere Anwendungen auf OS X per Drag&Drop===

[[lib_de:FMX.Platform.IFMXDragDropService|IFMXDragDropService]], der [[FireMonkey-Plattformdienste|FireMonkey-Plattformdienst]], der die Unterstützung für Drag&Drop-Operationen bereitstellt, unterstützt jetzt das Ziehen von Daten aus einer {{FM|Seattle}}-Anwendung in eine andere Anwendung.

===Neue {{FM|Seattle}}-Stile===

Neue {{FM|Seattle}}-Stile für '''Windows 10''' sind in {{Version|Seattle}} enthalten: '''Win10Modern.Style''', '''Win10ModernBlue.Style''' und '''Win10ModernDark.Style'''.

Die {{FM|Seattle}}-Stile finden Sie unter {{Code|{{StylesPath|Seattle}}}}.

===Neue native Windows-Darstellung von {{FM|Seattle}}===

Die folgenden Steuerelemente unterstützen die native Darstellung auf der Windows-Plattform:

* [[lib_de:FMX.Edit.TEdit|TEdit]]
* [[lib_de:FMX.Memo.TMemo|TMemo]]
* [[lib_de:FMX.ScrollBox.TPresentedScrollBox|TPresentedScrollBox]]

Informationen [[Native FireMonkey-Windows-Steuerelemente|über die Steuerung der Z-Reihenfolgenunterstützung für Windows durch FireMonkey]].

Weitere Informationen über native Windows-Steuerelemente finden Sie unter [[Native FireMonkey-Windows-Steuerelemente|Native Windows-Steuerelemente von FireMonkey]].

===Registerkartenwechsel im Register-Steuerelement===

Die Komponente [[lib_de:FMX.TabControl.TTabControl|TTabControl]] unterstützt die Registerkartennavigation durch einen Bildlauf, wenn die Registerkarten nicht in die Breite des Register-Steuerelements passen. Um diese Funktion zu verwenden, müssen Sie die Eigenschaft [[lib_de:FMX.TabControl.TTabControl.FullSize|FullSize]] auf {{False}} setzen.

Wenn die Breite aller Registerkarten nicht in die Breite des Register-Steuerelements passt, werden beim Entwurf rechts und links Schaltflächen angezeigt, die angeben, dass ein Bildlauf zu verborgenen Registerkarten zur Laufzeit möglich ist. Auf Geräten [[lib_de:FMX.TabControl.TTabControl.HasTouchScreen|mit Touch-Screens]] können Sie die Registerkarten durch Wischen verschieben. Auf Geräten ohne Touch-Screens können Sie zwischen den Registerkarten mit den rechten und linken Schaltflächen sowie mit der Maus wechseln. Die rechten und linken Schaltflächen werden nur beim Entwurf angezeigt, auf Geräten ohne Touch-Screens auch zur Laufzeit.

Sie können die [[lib_de:FMX.TabControl.TTabItem.Height|Höhe]] der [[lib_de:FMX.TabControl.TTabItem|Registereinträge]] ändern. Zum Ändern der Höhe muss die Eigenschaft [[lib_de:FMX.TabControl.TTabItem.AutoSize|AutoSize]] {{False}} sein.

===Entfernung der Größenbeschränkungen von TCalendar===

In {{Product|Seattle}} {{Version|Seattle}} bestehen für die [[lib_de:FMX.Calendar.TCalendar|TCalendar]]-Komponente keine Größenbeschränkungen.

Sie können jetzt die Höhe ([[lib_de:FMX.Calendar.TCalendar.Height|Height]]) und Breite ([[lib_de:FMX.Calendar.TCalendar.Width|Width]]) von TCalendar ändern und sogar die Eigenschaft [[lib_de:FMX.Calendar.TCalendar.Align|Align]] auf <code>[[lib_de:FMX.Types.TAlignLayout|Client]]</code> setzen.

:'''Hinweis:''' Die Größenbeschränkungen für [[lib_de:FMX.Calendar.TCalendar|TCalendar]] wurden auch für native iOS-Kalenderkomponenten entfernt; Sie können die Größe der nativen Kalender für iOS 6 oder später ändern.

===Native iOS-Listenansicht unterstützt benutzerdefinierte Erscheinungsbilder===

Sie können in [[Native FireMonkey-iOS-Steuerelemente|nativen iOS-Listenansichts-Steuerelementen]] [[Anpassen der Darstellung von FireMonkey-Listenansichten|benutzerdefinierte Erscheinungsbilder ändern]].

===Visuelle {{FM|Seattle}}-Steuerelemente können Hinweise anzeigen, wenn der Mauszeiger darüber geführt wird===

Visuelle {{FM|Seattle}}-Steuerelemente unterstützen jetzt Hinweise auf Desktop-Plattformen. Um einen Hinweis festzulegen, geben Sie den Text im [[Objektinspektor|Objektinspektor]] in die Eigenschaft [[lib_de:FMX.Controls.TControl.Hint|Hint]] des Steuerelements ein und setzen die Eigenschaft [[lib_de:FMX.Controls.TControl.ShowHint|ShowHint]] auf {{True}}. Weitere Informationen zur Verwendung von Hinweisen finden Sie unter [[Verwenden von Hinweisen zum Anzeigen von Kontexthilfe in einer FireMonkey-Anwendung|Verwenden von Hinweisen zum Anzeigen von Kontexthilfe in einer FireMonkey-Anwendung]].

:'''Hinweis:''' Hinweise werden unter Windows und OS X 10.10 oder neuer unterstützt.

===Touch-Animation für Android===

In {{Version|Seattle}} wurden Touch-Animationen für die Android-Plattform aufgenommen. Dieser neue Animationstyp simuliert die Touch-Animation aus den Google-Anleitungen für Material Design.

Sie müssen die Animation nicht aktivieren oder deaktivieren, sie ist bereits standardmäßig aktiviert.
Die Animation wurde für [[lib_de:FMX.ListBox.TListBox|TListBox]] und für Schaltflächen, wie [[lib_de:FMX.StdCtrls.TButton|TButton]], [[lib_de:FMX.StdCtrls.TCornerButton|TCornerButton]] und [[lib_de:FMX.StdCtrls.TSpeedButton|TSpeedButton]], hinzugefügt.

Weitere Einzelheiten finden Sie bei der Klasse [[lib_de:FMX.Styles.Objects.TTouchAnimationAdapter|TTouchAnimationAdapter]] und den Eigenschaften [[lib_de:FMX.Styles.Objects.TActiveStyleObject.TouchAnimation|TActiveStyleObject.TouchAnimation]] und [[lib_de:FMX.Styles.Objects.TButtonStyleObject.TouchAnimation|TButtonStyleObject.TouchAnimation]].

===Systembenachrichtigungen wurden in die RTL verschoben und werden von Windows unterstützt===

Die Unit {{Code|FMX.Notification}} wurde durch [[lib_de:System.Notification|System.Notification]] ersetzt.

Die Komponente [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]] unterstützt jetzt Windows 8 und neuere Windows-Versionen. An dieser Komponente wurden zudem einige kleinere Änderungen vorgenommen:

* Sie verfügt jetzt über die Eigenschaft [[lib_de:System.Notification.TCustomNotificationCenter.Loaded|Loaded]] zum Überprüfen, ob die Mitteilungszentrale verwendungsbereit ist oder nicht.
* Der Typ von [[lib_de:System.Notification.TNotificationCenter.ApplicationIconBadgeNumber|ApplicationIconBadgeNumber]] wurde von [[lib_de:System.Word|Word]] in [[lib_de:System.Integer|Integer]] geändert.
* Die Methode {{Code|Supported}} ist nicht mehr nötig und wurde entfernt.

Die Klasse [[lib_de:System.Notification.TBaseNotificationCenter|TBaseNotificationCenter]] hat das Interface {{Code|IFMXNotificationCenter}} ersetzt. Klassen für die Implementierung des Interface {{Code|IFMXNotificationCenter}} müssen Unterklassen von [[lib_de:System.Notification.TBaseNotificationCenter|TBaseNotificationCenter]] sein und die virtuellen abstrakten Methoden ihrer übergeordneten Klasse implementieren.

===[[FireMonkey-Stil-Designer|FireMonkey-Stil-Designer]]===

====Plattformstile====

Mit dem {{FM|Seattle}}-Stil-Designer können Sie nun beim Entwurf für jede Plattform Ihres Projekts einen andern Stil festlegen. Nur ein [[lib_de:FMX.Controls.TStyleBook|TStyleBook]] kann jetzt eine Sammlung von Stilen unterstützen.

====Anpassung von Steuerelementen====

Mit {{Product|Seattle}} können Sie nun Komponenten für unterschiedliche Plattformen beim Entwurf anpassen.

Weitere Informationen finden Sie unter [[Mobile-Tutorial: Verwenden von Schaltflächen-Komponenten mit unterschiedlichen Stilen (iOS und Android)|Mobile-Tutorial: Verwenden von Schaltflächen-Komponenten mit unterschiedlichen Stilen (iOS und Android)]].

====Neuer Bitmap-Verknüpfungseditor====

Mit einem neuen Editor können Sie Grafiken für [[lib_de:FMX.Styles.Objects.TBitmapLink|TBitmapLink]]-Eigenschaften für mit Stilen versehene Objekte direkt in der IDE bearbeiten.

[[lib_de:FMX.Styles.Objects.TBitmapLink|TBitmapLink]]-Eigenschaften können jetzt auf einfache und visuelle Weise mit dem [[BitmapLinks-Editor|BitmapLinks-Editor]] bearbeitet werden.

Weitere Informationen finden Sie unter [[BitmapLinks-Editor|BitmapLinks-Editor]] und [[Tutorial: Verwenden des BitmapLinks-Editors|Tutorial: Verwenden des BitmapLinks-Editors]].

====Weitere Verbesserungen====

* Neue Symbolleiste zum Laden, Speichern und Bereinigen von .style-Dateien.
* Verschiedene Hintergründe für die Stilbearbeitung. Sie können jetzt zwischen keinem und einem hellen/dunklen Hintergrund wählen. Anhand der Farbe können Sie feststellen, wie das angepasste Steuerelement auf dunklen oder hellen Farben angezeigt wird.
* Auswählen und Verwalten der verschiedenen Stil-Layoutobjekte und -Layoutkomponenten direkt im Stil-Designer.
* Hinzufügen neuer Steuerelemente zum Stil-Designer durch Doppelklicken auf das Steuerelement in der Tool-Palette.

===Neue Funktion "GetFirstWeekday"===

{{FM|Seattle}} stellt im Interface [[lib_de:FMX.Platform.IFMXLocaleService|IFMXLocaleService]] die neue Funktion [[lib_de:FMX.Platform.IFMXLocaleService.GetFirstWeekday|GetFirstWeekday]] bereit.

[[lib_de:FMX.Platform.IFMXLocaleService.GetFirstWeekday|GetFirstWeekday]] gibt den [[lib_de:System.DateUtils.DayOfTheWeek|ersten Tag der Woche]] in einem vereinheitlichten plattformunabhängigen Format zurück.

:'''Hinweis:''' [[lib_de:FMX.Platform.IFMXLocaleService.GetLocaleFirstDayOfWeek|GetLocaleFirstDayOfWeek]] ist veraltet. Verwenden Sie stattdessen [[lib_de:FMX.Platform.IFMXLocaleService.GetFirstWeekday|GetFirstWeekday]].

===Mit Stilen versehene Darstellungskonstruktoren erhalten das Datenmodell und das Steuerelement===

In {{Version|Seattle}} erhalten [[lib_de:FMX.Presentation.Style.TStyledPresentation|mit Stilen versehene Darstellungsklassen]] ihr [[lib_de:FMX.Presentation.Style.TStyledPresentation.GetModel|Datenmodell]] und ihr [[lib_de:FMX.Presentation.Style.TStyledPresentation.PresentedControl|dargestelltes Steuerelement]] im [[lib_de:FMX.Presentation.Style.TStyledPresentation.Create|Konstruktor]], wodurch das Erstellen von Darstellungsklassen erheblich vereinfacht wird.

Um Ihre Darstellungsklassen aus {{Version|XE8}} nach {{Version|Seattle}} zu portieren, müssen Sie Code für die verzögerte Initialisierung des Datenmodells und des dargestellten Steuerelements entfernen und diesen Code in den Konstruktor verschieben.

===Umgestaltung des Listenansichts-Steuerelements===

Viele Member, die früher in {{Code|TCustomListView}} enthalten waren, befinden sich jetzt in einer anderen Klasse oder sogar in einer anderen Unit. In eine andere Klasse verschobene Member sind weiterhin aufgrund der Vererbung Teil von {{Code|TCustomListView}}.

Eine detaillierte Änderungsliste finden Sie unter '''[[Refactoring des Listenansichts-Steuerelements in Seattle|Refactoring des Listenansichts-Steuerelements in Seattle]]'''.

===TStyledPresentationProxy ersetzt alle mit Stilen versehenen Proxy-Klassen===

[[lib_de:FMX.Presentation.Style.TStyledPresentation|Mit Stilen versehene Darstellungsklassen]] müssen keine Proxy-Klasse mehr definieren. Mit der neuen Klasse [[lib_de:FMX.Presentation.Style.TStyledPresentationProxy|TStyledPresentationProxy]] kann ein Proxy-Objekt für alle Stildarstellungsklassen erstellt werden. Alle vorhandenen Stildarstellungs-Proxy-Klassen wurden entfernt:

{| class="wikitable"
|-
! {{Version|XE8}}
! {{Version|Seattle}}
|- valign="top"
|
{{Code|TStyledCalendarProxy}} 
{{Code|TStyledCalendarEditProxy}} 
{{Code|TStyledComboEditProxy}} 
{{Code|TStyledComboTrackBarProxy}} 
{{Code|TStyledEditProxy}} 
{{Code|TStyledEditBoxProxy}} 
{{Code|TStyledMemoProxy}} 
{{Code|TStyledOverlayLayoutProxy}} 
{{Code|TStyledShadowedLayoutProxy}} 
{{Code|TStyledNumberBoxProxy}} 
{{Code|TStyledScrollBoxProxy}} 
{{Code|TStyledSearchBoxProxy}} 
{{Code|TStyledSpinBoxProxy}} 
{{Code|TStyledSwitchProxy}}
|
[[lib_de:FMX.Presentation.Style.TStyledPresentationProxy|TStyledPresentationProxy]]
|}

===Umgestaltung von TCalendar===

'''[[lib_de:FMX.Calendar.TCalendar|TCalendar]]-Änderungen''':

* [[lib_de:FMX.Calendar.TCustomCalendar|TCustomCalendar]] wurde als Basisklasse für Steuerelemente, die einen Monatskalender anzeigen, eingeführt. <code>TCalendar</code> ist jetzt von <code>TCustomCalendar</code> abgeleitet. Beide Klassen befinden sich in der Unit [[lib_de:FMX.Calendar|FMX.Calendar]].

* Die neue Eigenschaft [[lib_de:FMX.Calendar.TCalendar.TouchTargetExpansion|TouchTargetExpansion]] wurde hinzugefügt.

'''[[lib_de:FMX.Calendar.Style.TStyledCalendar|TStyledCalendar]]-Änderungen''':

* Die Methode [[lib_de:FMX.Calendar.Style.TStyledCalendar.TryFindDayItem|TryFindDayItem]] wurde hinzugefügt, um den Zugriff auf das [[lib_de:FMX.ListBox.TListBoxItem|Listenfeldelement]] bereitzustellen, das einen [[lib_de:FMX.Calendar.TCalendar|TCalendar]]-Tag darstellt.

* Die Methode <code>TStyledCalendar.FillList</code> aus XE8 wurde jetzt in die folgenden Prozeduren unterteilt:

:
:* [[lib_de:FMX.Calendar.Style.TStyledCalendar.FillYears|TStyledCalendar.FillYears]]
:* [[lib_de:FMX.Calendar.Style.TStyledCalendar.FillWeeksNumbers|TStyledCalendar.FillWeeksNumbers]]
:* [[lib_de:FMX.Calendar.Style.TStyledCalendar.FillWeekDays|TStyledCalendar.FillWeekDays]]
:* [[lib_de:FMX.Calendar.Style.TStyledCalendar.FillDays|TStyledCalendar.FillDays]]
:* [[lib_de:FMX.Calendar.Style.TStyledCalendar.FillCalendar|TStyledCalendar.FillCalendar]]

===Weitere {{FM|Seattle}}-Änderungen===

* Sie müssen den Typ von [[lib_de:FMX.ListView.TListViewBase.Selected|TListView.Selected]] jetzt in [[lib_de:FMX.ListView.Appearances.TListViewItem|Appearances.TListViewItem]] umwandeln, um es als solches zu verwenden.
* Einige Konstanten, die Dateierweiterungen repräsentieren, wurden geändert, um Rechtschreibfehler zu korrigieren. Beispielsweise wurde {{Const|SBMPImageExtention}} in {{Const|SBMPImageExtension}} geändert. Diese Konstanten befinden sich in der Datei {{Path|FMX.Consts.pas}}.
* Das protected Feld {{Code|FDisableDayChange}} von [[lib_de:FMX.Calendar.Style.TStyledCalendar|TStyledCalendar]] wurde durch die published Eigenschaft [[lib_de:FMX.Calendar.Style.TStyledCalendar.DisableDayChange|DisableDayChange]] ersetzt. {{Code|TStyledCalendar}} veröffentlicht jetzt auch seine Stilobjekte: [[lib_de:FMX.Calendar.Style.TStyledCalendar.Years|Years]], [[lib_de:FMX.Calendar.Style.TStyledCalendar.Month|Month]], [[lib_de:FMX.Calendar.Style.TStyledCalendar.Weeks|Weeks]], [[lib_de:FMX.Calendar.Style.TStyledCalendar.Week|Week]], [[lib_de:FMX.Calendar.Style.TStyledCalendar.Days|Days]], [[lib_de:FMX.Calendar.Style.TStyledCalendar.Today|Today]], [[lib_de:FMX.Calendar.Style.TStyledCalendar.Prev|Prev]], [[lib_de:FMX.Calendar.Style.TStyledCalendar.Next|Next]].
* Die Eigenschaft [[lib_de:FMX.Controls.TControl.TouchTargetExpansion|TouchTargetExpansion]] von [[lib_de:FMX.DateTimeCtrls.TDateEdit|TDateEdit]] und [[lib_de:FMX.DateTimeCtrls.TTimeEdit|TTimeEdit]] ist jetzt published.
* Für den [[lib_de:FMX.Styles.Objects.TTintedStages.Create|Konstruktor]] von [[lib_de:FMX.Styles.Objects.TTintedStages|TTintedStages]] muss das [[lib_de:FMX.Styles.Objects.TTintedStages.StyleObject|Eigentümer]]-[[lib_de:FMX.Styles.Objects.TCustomStyleObject|Stilobjekt]] als Parameter angegeben werden.
* Neue Darstellung und neues Verhalten von [[lib_de:FMX.StdCtrls.TSwitch|TSwitch]] für Windows 10. Beispielsweise ändert sich die Hintergrundfarbe bei Mausberührung, wenn der Umschalter eingeschaltet ist.
* Der [[lib_de:FMX.MultiView.TMultiView.Mode|Standardmodus]] von [[lib_de:FMX.MultiView.TMultiView|TMultiView]] ist in Windows 10 {{Const|NavigationPane}}. Weitere Einzelheiten finden Sie unter [[Mobile-Tutorial: Verwenden von MultiView-Komponenten zur Anzeige von alternativen Ansichten von Informationen (iOS und Android)#Navigationsbereichsmodus|Navigationsbereichsmodus]].
* Neuer [[Bitmap-Stil-Designer#Stil-Viewer|Stil-Viewer]] für den Windows 10-Stil im [[Bitmap-Stil-Designer|Bitmap-Stil-Designer]].
* Erweiterte Zwischenablagenunterstützung für das Kopieren und Einfügen von Bitmaps. Beispiele finden Sie unter:

:
:* {{Path|{{DelphiSamplesPath|Seattle}}\Multi-Device Samples\User Interface\CopyPaste}}
:* {{Path|{{CppSamplesPath|Seattle}}\Multi-Device Samples\User Interface\CopyPaste}}

* Mit der neuen Klasse [[lib_de:System.Beacon.Components.TBeaconDevice|TBeaconDevice]] können Sie simulieren, dass ein Gerät mit [[Verwenden von Bluetooth Low Energy|BluetoothLE]] ein Beacon ist. Siehe das [[Samp:RTL.BeaconDevice Sample|Beispiel "BeaconDevice"]].
* [[lib_de:FMX.ListBox.TListBoxSelector|TListBoxSelector]] stellt eine Alternative für die Methode [[lib_de:FMX.ListBox.TListBoxSelector.MouseSelectFinish|MouseSelectFinish]] bereit, die das Listenfeld ausführt, bevor das Ereignis [[lib_de:FMX.ListBox.TCustomListBox.OnItemClick|OnItemClick]] der Kombinationsfeld-Komponente ausgelöst wird: [[lib_de:FMX.ListBox.TListBoxSelector.MouseSelectFinishing|MouseSelectFinishing]].
* [[lib_de:FMX.Controls.TControl|Steuerelemente]] verfügen über die folgenden protected Methoden: [[lib_de:FMX.Controls.TControl.EnabledChanged|EnabledChanged]], [[lib_de:FMX.Controls.TControl.PaddingChanged|PaddingChanged]] und [[lib_de:FMX.Controls.TControl.VisibleChanged|VisibleChanged]]. Wenn der Wert von [[lib_de:FMX.Controls.TControl.Enabled|Enabled]], [[lib_de:FMX.Controls.TControl.Padding|Padding]] oder [[lib_de:FMX.Controls.TControl.Visible|Visible]] in einem Steuerelement geändert wird, führt dieses Steuerelement die entsprechende Methode aus.

==[[Überblick zu VCL|VCL]]==

===Neue VCL-Steuerelemente für Windows 10===

Die folgenden Steuerelemente wurden der VCL hinzugefügt:

* '''[[lib_de:Vcl.WinXCtrls.TRelativePanel|TRelativePanel]]''': RelativePanel ist ein neuer Layout-Bereich, mit dem Sie untergeordnete Objekte in Relation zueinander und zu ihrem übergeordneten Bereich positionieren und ausrichten können. Beispielsweise können Sie angeben, dass Text immer links in dem Bereich und eine Schaltfläche immer unter dem Text positioniert wird. Verwenden Sie RelativePanel als Alternative zu TGridPanel beim Erstellen von Benutzeroberflächen, die kein klares lineares Muster haben.
* '''[[lib_de:Vcl.WinXCtrls.TSplitView|TSplitView]]''': Mit dem neuen SplitView-Steuerelement können Sie transienten Inhalt einfach anzeigen und ausblenden. Beispielsweise können Sie es als Navigationsmenü der obersten Ebene verwenden, wobei der Navigationsinhalt verborgen ist und bei Bedarf eingeblendet wird (auch als Hamburger-Menü bezeichnet).
* '''[[lib_de:Vcl.WinXCtrls.TToggleSwitch|TToggleSwitch]]''': Der Umschalter simuliert einen physischen Schalter, mit dem Benutzer etwas ein- oder ausschalten können. Das Steuerelement hat zwei Zustände: ein und aus. Sie können die Beschriftungen des Umschalters ändern oder entfernen.
* '''[[lib_de:Vcl.WinXCtrls.TActivityIndicator|TActivityIndicator]]''': Ein Ringindikator für den Status "unbestimmt" ({{Code|indeterminate}}). Für diesen Indikator können Sie unter mehreren Typen auswählen und viele visuelle Eigenschaften, wie Größe, Geschwindigkeit der Animation, Farbe des Indikators, ändern.
* '''[[lib_de:Vcl.WinXCtrls.TSearchBox|TSearchBox]]''': Ein Eingabefeld mit Suchfunktionalität, ähnlich dem {{FM|Seattle}}-[[lib_de:FMX.SearchBox.TSearchBox|TSearchBox]]-Feld.

Diese Steuerelemente sind speziell für Windows 10 zugeschnitten, unterstützen aber alle Windows-Versionen.

Beispielanwendungen für die neuen VCL-Steuerelemente für Windows 10 zeigen die Verwendung und Funktionen dieser Steuerelemente:

* '''[[samp_en:VCL.ActivityIndicator Sample|ActivityIndicator (Beispiel)]]'''
* '''[[samp_en:VCL.RelativePanel Sample|RelativePanel (Beispiel)]]'''
* '''[[samp_en:VCL.SearchBox Sample|SearchBox (Beispiel)]]'''
* '''[[samp_en:VCL.SplitView Sample|SplitView (Beispiel)]]'''
* '''[[samp_en:VCL.ToggleSwitch Sample|ToggleSwitch (Beispiel)]]'''

===Neue TSharingContract-Komponente===

Die [[lib_de:Vcl.ShareContract.TSharingContract|TSharingContract]]-Komponente unterstützt Verträge, den Systemmechanismus für das Teilen von Informationen mit anderen Windows 10-Anwendungen. Anwendungen können sich mit der neuen SharingContract-Komponente wie Vertragsquellen verhalten.

Weitere Informationen über App-Verträge und die Teilen-Funktionalität finden Sie unter [https://msdn.microsoft.com/en-us/library/windows/apps/hh464906.aspx Windows Dev Center - App contracts and extensions (EN)].

===Neue VCL-Stile===

* In {{Version|Seattle}} sind neue VCL-Stile für '''Windows 10''' enthalten: '''Windows10''', '''Windows10 Blue''' und '''Windows10 Dark'''.
* Neuer '''OnyxBlue'''-Stil.

Über {{menu | Projekt > Optionen > Anwendung > Erscheinungsbild}} können Sie auf die VCL-Stile zugreifen.

===Verbesserungen von VCL-Stilen===

* Unterstützung für Stile für allgemeine Dialogfelder. Weitere Informationen finden Sie unter [[lib_de:Vcl.Themes.TStyleManager.SystemHooks|SystemHooks]].

* [[lib_de:SHDocVw.TWebBrowser|TWebBrowser]]-Komponente unterstützt nun Stile.

Weitere Informationen über VCL-Stile finden Sie unter [[Arbeiten mit VCL-Stilen|Arbeiten mit VCL-Stilen]].

===Modernisiertes Dialogfeld "Verzeichnis auswählen"===

[[lib_de:Vcl.FileCtrl.SelectDirectory|SelectDirectory]] wurde geändert, damit es ein modernisiertes Dialogfeld "Verzeichnis auswählen" anzeigt. Verwenden Sie die dritte Signatur der Funktion [[lib_de:Vcl.FileCtrl.SelectDirectory|SelectDirectory]], und definieren Sie Ihren Optionssatz als [[lib_de:Vcl.FileCtrl.TSelectDirFileDlgOpts|TSelectDirFileDlgOpts]].

[[File:ModernizedSelectDirectory.png|500px]]

==[[RTL|RTL]]==

===Registrieren Ihrer Anwendung für die Behandlung von Android-Intents===

In {{Version|XE8}} konnten Intents nur über lokale oder Push-Benachrichtigungen empfangen werden. In {{Version|Seattle}} ermöglicht die [[Verwenden der in RAD Studio integrierten Java-Bibliotheken für Android|integrierte RAD Studio-Java-Bibliothek]] {{Code|Androidapi.JNI.Embarcadero}} die Registrierung Ihrer Anwendung für die Behandlung von Intent-Aktionen.

Die [[samp_en:FMX.Android Intents Sample|Beispielanwendung "Android Intents"]] zeigt, wie einfache Daten von einer anderen Anwendung mit Android-Intents behandelt werden.

:'''Hinweis:''' Für die Behandlung von Android-Intents müssen Sie dem Abschnitt <source lang="xml" enclose="none"><intent-filter></source> der [[rad_de:Vorbereiten von Android-Anwendungen für die Bereitstellung#Anpassen der Datei "AndroidManifest.xml"|Datei AndroidManifest.xml]] das entsprechende <source lang="xml" enclose="none"><action></source>-Tag hinzufügen.

===JSON-Verbesserungen===

Der Gültigkeitsbereich von [[lib_de:System.JSON|System.JSON]] wurde um viele neue Units erweitert, die Unterstützung für Folgendes bereitstellen:

* [[lib_de:System.JSON.BSON|BSON]], eine binäre Alternative zum JSON-Format.
* JSON-[[lib_de:System.JSON.Readers|Reader]] und -[[lib_de:System.JSON.Writers|Writer]], um JSON-Daten ad hoc zu generieren und zu analysieren, ohne zuerst eine vollständige JSON-Hierarchie im Arbeitsspeicher erstellen zu müssen.
* [http://docs.mongodb.org/manual/reference/mongodb-extended-json/ MongoDB extended JSON (EN)], eine Erweiterung des JSON-Formats für die Unterstützung weiterer Datentypen. Sie können diese JSON-Erweiterung in JSON-Readern und -Writern über deren Eigenschaft {{Code|ExtendedJsonMode}} aktivieren.

Außerdem ermöglichen [[lib_de:System.JSON.TJSONObject.ParseJSONValue|TJSONObject.ParseJSONValue]] und [[lib_de:System.JSON.TJSONObject.Parse|TJSONObject.Parse]] das Erstellen eines [[lib_de:System.JSON.TJSONBool|TJSONBool]]-Wertes aus den analysierten Daten.

===Ausführen asynchroner Remote-Aktionen===

Mit der neuen Methode [[lib_de:System.Tether.AppProfile.TTetheringAppProfile.RunRemoteActionAsync|RunRemoteActionAsync]] können Sie [[lib_de:System.Tether.AppProfile.TRemoteAction|Remote-Aktionen]] asynchron ausführen.
Bei der Verwendung asynchroner Aktionen wird die Funktion, die diese Methode aufruft, während der Ausführung der Remote-Aktion nicht blockiert.

Weitere Informationen dazu finden Sie unter [[Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering#Ausführen von Remote-Aktionen|Ausführen von Remote-Aktionen]].

===GATT-Serverunterstützung für Android 5===

In {{Version|Seattle}} können Sie einen [[Verwenden von Bluetooth Low Energy#BluetoothLE-Server|Bluetooth Low Energy-Server]] für Android 5 erstellen.

===Unterstützung für internationalisierte Domänennamen===

Das HTTP-Framework unterstützt jetzt [[Wikipedia:Internationalized domain name|internationalisierte Domainnamen (EN)]] (IDN). Zwei neue public Methoden sind verfügbar: [[lib_de:System.Net.URLClient.TURI.UnicodeToIDNA|TURI.UnicodeToIDNA]] und [[lib_de:System.Net.URLClient.TURI.IDNAToUnicode|TURI.IDNAToUnicode]].

===Unterstützung für SHA-2 Hashing===

Die Unit [[lib_de:System.Hash|System.Hash]] enthält einen neuen Member, [[lib_de:System.Hash.THashSHA2|THashSHA2]], der die Hash-Funktionsfamilie [[Wikipedia:SHA-2|SHA-2]] implementiert.

===Verbesserungen bei Bluetooth===

* Mit der neuen Eigenschaft [[lib_de:System.Bluetooth.TBluetoothLEDevice.ScannedAdvertiseData|ScannedAdvertiseData]] von [[lib_de:System.Bluetooth.TBluetoothLEDevice|TBluetoothLEDevice]] können Sie auf die Daten zugreifen, die ein Remote-Gerät als Instanz von [[lib_de:System.Bluetooth.TBluetoothLEAdvertiseData|TBluetoothLEAdvertiseData]] bekanntgibt, sodass Sie nützliche Informationen, wie [[lib_de:System.Bluetooth.TBluetoothLEAdvertiseData.ManufacturerSpecificData|herstellerspezifische Informationen]], auf einfache Weise lesen können.
* Mit [[lib_de:System.Bluetooth.TBluetoothGattServer.AddService|TBluetoothGattServer.AddService]] können Sie angeben, ob der hinzugefügte Dienst bekanntgegeben werden soll (Vorgabe) oder nicht.
* [[lib_de:System.Bluetooth.TBluetoothLEManager.StartDiscovery|TBluetoothLEManager.StartDiscovery]] unterstützt einen neuen Parameter, {{Arg|ForceConnect}}, zum Herstellen von Verbindungen mit allen ermittelten Remote-Geräten, um eine vollständige Liste der Dienste, die jedes Remote-Gerät bereitstellt, zu erhalten. Dies ermöglicht das Filtern von Remote-Geräten auf Basis der von ihnen bereitgestellten Dienste, unabhängig davon, ob sie [[lib_de:System.Bluetooth.TBluetoothLEDevice.ScannedAdvertiseData|sie bekanntgeben]] oder nicht.
* Neue Hilfsklasse [[lib_de:System.Bluetooth.TBluetoothUUIDHelper|TBluetoothUUIDHelper]] für die Arbeit mit unterschiedlichen Formaten von Bluetooth-UUIDs.

===Refactoring der App-Tethering-Kommunikation===

Die Basisklasse für App-Tethering-Profile, [[lib_de:System.Tether.Manager.TTetheringProfile|TTetheringProfile]], implementiert jetzt die Logik für die Analyse von [[lib_de:System.Tether.Manager.TTetheringCommand|App-Tethering-Befehlen]] (die früher in der [[lib_de:System.Tether.Manager.TTetheringProtocol|Basisklasse für App-Tethering-Protokolle]] implementiert war) sowie die Logik für die Behandlung von [[lib_de:System.Tether.Manager.TTetheringProfileInfo|Remote-Profilen]] und [[lib_de:System.Tether.Manager.TTetheringConnection|Verbindungen]], die früher in der untergeordneten Klasse [[lib_de:System.Tether.AppProfile.TTetheringAppProfile|TTetheringAppProfile]] implementiert war.

Eine detaillierte Änderungsliste finden Sie unter '''[[Refactoring der App-Tethering-Kommunikation in Seattle|Refactoring der App-Tethering-Kommunikation in Seattle]]'''.

===Weitere RTL-Änderungen===

* [[lib_de:System.Hash.THashSHA2.GetHMACAsBytes|THashSHA2.GetHMACAsBytes]], [[lib_de:System.Hash.THashSHA1.GetHMACAsBytes|THashSHA1.GetHMACAsBytes]] und [[lib_de:System.Hash.THashMD5.GetHMACAsBytes|THashMD5.GetHMACAsBytes]] akzeptieren jetzt die Parameter {{Arg|Data}} und {{Arg|Key}} als [[lib_de:System.String|String]] oder als [[lib_de:System.SysUtils.TBytes|Bytes]].
* [[lib_de:System.IOUtils.TPath.GetSharedDocumentsPath|GetSharedDocumentsPath]] gibt jetzt auf der Android-Plattform einen anderen Pfad zurück. Der neue Pfad zeigt auf ein systemweites Verzeichnis im externen Speicher.
* [[lib_de:System.Threading.TThreadPool|TThreadPool]] enthält eine neue Klasseneigenschaft, [[lib_de:System.Threading.TThreadPool.Current|Current]], die den Thread-Pool der [[lib_de:System.Threading.TTask.CurrentTask|aktuellen Aufgabe]] bereitstellt.
* Die Klasse [[lib_de:System.Zip.TZipFile|TZipFile]] hat nun ein Callback für die Abfrage des aktuellen Fortschritts des Vorgangs. Weitere Informationen finden Sie unter [[lib_de:System.Zip.TZipFile.ExtractZipFile|TZipFile.ExtractZipFile]] und [[lib_de:System.Zip.TZipFile.OnProgress|TZipFile.OnProgress]].

==[[IDE-Referenz und Hilfsprogramme|IDE]]==

===Verbesserungen des Arbeitsspeichers===

In {{Version|Seattle}} enthält die {{Product|Seattle}}-IDE einige bemerkenswerte Verbesserungen hinsichtlich des Speicherbedarfs und der Speicherverwaltung:

* Die IDE kann jetzt bis zu 4 GiB verwenden und ist nicht mehr auf 2 GiB beschränkt.
*: '''Hinweis:''' IDE-Erweiterungen müssen [[Erweitern der IDE mit der Tools-API#IDE-Erweiterungen müssen große Speicheradressen unterstützen|große Speicheradressen]] unterstützen.
* Die IDE-Speicherverwaltung von geöffneten Projekten wurde verbessert. Die IDE kann nun eine größere Anzahl von geöffneten Projekten verwalten.

{{f| radstudio|

===Neues Android-Dienstprojekt===

{{Product|Seattle}} stellt einen neuen {{Delphi|Seattle}}-Projekttyp zum Erstellen von Android-Diensten bereit.

Der neue Projekttyp deckt die verschiedenen Diensttypen ab: lokal und remote, und er enthält die Unterstützung für asynchrone Aufgaben mit Intents.

Das [[Android-Dienst|Android-Dienstprojekt]] besteht aus einem [[Datenmodule verwenden|Datenmodul]] zum Erstellen der Methoden und Ereignisse für den Dienst. Beim Erzeugen des Projekts werden die Binärdateien, die die Hauptanwendung benötigt, gemäß dem ausgewählten Diensttyp erstellt, wie z. B. die Java-Archivdatei (*.JAR).

So erstellen Sie einen '''Android-Dienst''':

* Die IDE stellt einen neuen Experten zum Erstellen des [[Android-Dienst|Android-Dienstprojekts]] bereit.
* Die IDE stellt einen neuen Experten zum Hinzufügen von Android-Diensten zu einer [[Geräteübergreifende Anwendung|geräteübergreifenden Anwendung]] bereit.

Weitere Informationen finden Sie unter [[Android-Dienst|Android-Dienst]] und [[Erstellen von Android-Diensten|Erstellen von Android-Diensten]].}}

===Verbesserte Unterstützung für mehrere Bildschirmkonfigurationen===

{{Version|Seattle}} verbessert die Benutzererfahrung bei Konfigurationen mit mehreren Bildschirmen.

===Integration der Castalia-Funktionen in der IDE===

Einige Castalia-Funktionen wurden in {{Product|Seattle}} {{Version|Seattle}} in die IDE integriert:

* '''[[Zwischenablageverlauf|Zwischenablageverlauf]]''': Zeigt die gespeicherten Elemente beim Kopieren von Text an. Sie öffnen das Fenster "Zwischenablageverlauf" über {{Menu|Ansicht > Zwischenablageverlauf}}.
* '''[[Mehrfach einfügen|Mehrfach einfügen]]''': Ermöglicht die Bearbeitung von Text vor dem Einfügen. Sie können auf das Fenster "Mehrfach einfügen" über {{Menu|Bearbeiten > Mehrfach einfügen}} zugreifen.
* '''[[Projektstatistik|Projektstatistik]]''': Zeigt die Zeit an, die in verschiedenen Bereichen Ihres Projekts verbracht wurde. Sie öffnen das Fenster "Projektstatistik" über {{Menu|Ansicht > Projektstatistik}}.
* '''[[Quelltext-Editor#Navigationssymbolleiste|Navigationssymbolleiste]]''': Wird im Quelltext-Editor angezeigt, um die Navigation in Ihrem Code zu vereinfachen. Die Navigationssymbolleiste enthält die '''Projektsymbolsuche'''.
* '''[[Quelltext-Editor#Synchronisieren_von_Prototypen|Synchronisierung von Prototypen]]''': Funktion zum Synchronisieren der interface- und implementation-Versionen Ihrer Methodenprototypen.
* '''[[Quelltext-Editor#Strukturhervorhebung|Strukturhervorhebung]]''': Hebt die Codestruktur mit Linien sowie die Verwendung von Prozeduren hervor, die den linearen Ausführungsablauf in Ihrem Code unterbrechen. Auf der [[Strukturhervorhebung|Optionsseite für die Strukturhervorhebung]] finden Sie weitere Optionen für diese Funktion.
* '''[[Quelltext-Editor#Intelligente_Tasten|Intelligente Tasten]]''': Stellt Tastenkürzel bereit, um den Cursor an den Anfang der Zeile oder des Textes zu setzen; sowie eine schnelle Möglichkeit, Ihren Code in "()", "[]" oder "{}" einzuschließen. Diese Funktionen können auf der [[Tastaturbelegung|Optionsseite "Tastaturbelegung"]] aktiviert oder deaktiviert werden.

===Auto-Wiederherstellen===

Die Funktion [[Auto-Wiederherstellen|Auto-Wiederherstellen]] ermöglicht Ihre Dateien wiederherzustellen, wenn die IDE unerwartet geschlossen wird.

Auf der [[Auto-Wiederherstellen|Optionsseite "Auto-Wiederherstellen"]] finden Sie weitere Einstellungen für diese Funktion.

===Ändern der Schriftgröße im Quelltext-Editor===

Sie können die Größe der Schrift im [[Quelltext-Editor|Quelltext-Editor]] mit dem Kontextmenü des Quelltext-Editors oder mit Tastenkombinationen vergrößern oder verkleinern:

* Verwenden Sie die Optionen '''Schrift vergrößern''' und '''Schrift verkleinern''' im [[Kontextmenü des Quelltext-Editors|Kontextmenü des Quelltext-Editors]], um die Schrift zu vergrößern bzw. zu verkleinern.

* Verwenden Sie die Tastenkombinationen '''Strg+Num+''' und '''Strg+Num-''', um die Größe der Schrift zu vergrößern bzw. zu verkleinern. Unter [[Tastenzuordnungen - Index|Tastenzuordnungen - Index]] finden Sie weitere Tastenkombinationen.

===Aktualisierung der Subversion-Bibliotheken in der IDE===

{{Version|Seattle}} {{Version|Seattle}} enthält die Subversion-Bibliotheken der Version 1.8.13.

Weitere Einzelheiten über in der IDE integrierte Versionskontrollsysteme finden Sie unter [[Subversion-Integration in der IDE|Subversion-Integration in der IDE]] und [[Versionskontrollsysteme in der IDE|Versionskontrollsysteme in der IDE]].

===Verbesserungen des [[GetIt-Package-Manager|GetIt-Package-Managers]]===

Die folgenden Verbesserungen wurden in {{Version|Seattle}} zum GetIt-Package-Manager hinzugefügt:

* Neue verbesserte Benutzeroberfläche für das [[Fenster "GetIt-Package-Manager"|Fenster "GetIt-Package-Manager"]].
* Möglichkeit, Packages nach Kategorie zu filtern.
* {{Product|Seattle}} {{Version|Seattle}} Subscription Update 1 enthält die neue Optionsseite {{Menu|Tools > Optionen > [[GetIt (Optionen)|GetIt]]}}, auf der Sie den '''GetIt-Package-Manager''' so konfigurieren können, dass beim Start nach Package-Updates gesucht wird.

===Umbenannte Beschriftungen auf der Bereitstellungsseite "OS X - Anwendungs-Store"===

Die [[Bereitstellungsseite|Bereitstellungsoptionen]] für die Codesignierung einer [[Bereitstellungsseite#OS_X_-_Anwendungs-Store|OS X-Anwendung für den '''Anwendungs-Store''']] wurde in '''Mac-Entwicklerzertifikat für Fremdhersteller''' und '''Mac-Installationszertifikat für Fremdhersteller''' umbenannt, damit sie mit den Namen, die Apple für diese Zertifikate verwendet, übereinstimmen.

Weitere Informationen über die Codesignierung von Anwendungen finden Sie unter '''[[Bereitstellungsseite|Bereitstellung]]'''.

===Neue Option für den Zugriff von iOS 9-Anwendungen auf Nicht-SSL-URLs===

: '''Hinweis:''' Dies betrifft nur {{Product|Seattle}} {{Version|Seattle}} Subscription Update 1.

Neue Option in {{Menu| Projekt > Optionen > [[Berechtigungsliste|Berechtigungsliste]]}} zur Aktivierung von HTTP-Protokollanforderungen unter iOS 9.0. Diese Option ist standardmäßig aktiviert.

===Neue Option zum Hinzufügen der Unterstützung für die Ausführung im Hintergrund unter iOS===

In der IDE können Sie jetzt die Datei [[Apple-Anwendungsinformationsdatei (*.info.plist)|{{Code|Info.plist}}]] zur Unterstützung des Ausführungsmodus im Hintergrund für iOS-Anwendungen hinzufügen.

In {{Menu|Projekt > Optionen > Versionsinformationen}} können Sie dem Array-Schlüssel {{Code|UIBackgroundModes}} die Stringwerte für die Dienste hinzufügen, die weiterhin im Hintergrund ausgeführt werden müssen.

===Neue Option zur Aktivierung der High-DPI-Unterstützung in Ihren VCL-Anwendungen===

In der IDE können Sie jetzt die High-DPI-Unterstützung für Ihre [[VCL|VCL-Anwendungen]] aktivieren.

Sie können in {{Menu|Projekt > Optionen > [[Anwendungsoptionen|Anwendung]]}} die Option '''Hochauflösung aktivieren''' für Ihr Projekt auswählen.

===Verbesserungen des [[Objektinspektor|Objektinspektors]]===

* In einem neuen Filterfeld werden Eigenschaften oder Ereignisse angezeigt, die mit dem angegebenen Muster übereinstimmen. Die neue Option befindet sich unter der '''Instanzliste''' des '''Objektinspektors'''.

* Größere Feinabstimmung im '''Objektinspektor'''. Mit der neuen Option '''Anzeigen''' im Kontextmenü können Sie verschiedene Teile des '''Objektinspektors''' ein- oder ausblenden.
** Instanzliste
** Filterfeld
** Schnellzugriffsbereich
** Beschreibungsbereich (standardmäßig ausgeblendet)
** Statuszeile

Auf die neuen Optionen kann auch über {{menu | Tools > Optionen}} | {{menu | Umgebungsoptionen > Objektinspektor}} zugegriffen werden.

Weitere Informationen finden Sie unter [[Objektinspektor#Optionen des Menüs "Anzeigen"|Optionen im Objektinspektor]].

===Neue Symbole für die Strukturansicht===

Die Symbole in der [[Strukturansicht|Strukturansicht]] stimmen jetzt mit den Symbolen in der [[Tool-Palette|Tool-Palette]] überein. Anhand der Miniaturansichten können Sie auf einfache Weise die Anwendungskomponenten in der '''Strukturansicht''' finden.

===Neuer Standardwert für den Parameter InstallLocation im Android-Manifest===

Der neue Standardwert für den Parameter '''InstallLocation''' in der [[Anwendungsmanifestdatei für Android (AndroidManifest.xml)|Android-Anwendungsmanifestdatei]] ist {{Code|auto}}. Weitere Informationen finden Sie unter [[Versionsinformationen#Android-Versionsinformationen|Android-Versionsinformationen]]. Durch Ändern dieses Wertes in älteren Projekten können einige spezifische [[Ausführen von Android-Anwendungen auf einem Android-Gerät#Debugger wird nicht gestartet oder Haltepunkte werden ignoriert|Debugging-Probleme]] behoben werden.

===Neue Option zum Ausblenden nicht-visueller Komponenten beim Entwurf===

In der IDE können Sie jetzt nicht-visuelle Komponenten beim Entwurf [[Nicht-visuelle Komponenten ausblenden|ein- oder ausblenden]].

===Neues Aussehen und Verhalten des Dialogfeldes "Verzeichnis auswählen"===

In der IDE wird jetzt ein modernisiertes [[lib_de:Vcl.FileCtrl.SelectDirectory|Dialogfeld "Verzeichnis auswählen"]] für das Suchen von Ordnern angezeigt. In das [[lib_de:Vcl.FileCtrl.SelectDirectory|Dialogfeld "Verzeichnis auswählen"]] können Sie einen Ordnerpfad eingeben oder einfügen.

[[File:ModernizedSelectDirectory.png|500px]]

Dieses Dialogfeld wird beispielsweise im '''Datei-Finder''' (<code>Strg-Umschalt-F</code>) angezeigt.

===Verbesserungen der Tools-API===

* '''Editor-Interface zum Zeichnen''': Neue Tools-API-Interfaces zum Zeichnen wurden zur Erweiterung des Quelltext-Editors hinzugefügt, um das benutzerdefinierte Zeichnen zu verbessern.

Siehe [[Erweitern der IDE mit der Tools-API|Erweitern der IDE mit der Tools-API]].
{{f|radstudio|

===Verbesserte Unterstützung für ältere Projekte===

{{Version|Seattle}} unterstützt den Import von Projekten aus {{Delphi|Seattle}} {{Version|1}} bis {{Version|XE8}} und {{CBuilder|Seattle}} {{Version|3}} bis {{Version|XE8}}. }}

==Änderungen für Datenbanken==

{{f|datasnap|

===[[DataSnap-Anwendungen entwickeln|DataSnap]]===

====Komprimierte Übertragung von FireDAC-Datenmengen====

In {{Version|Seattle}} erfolgt die Übertragung von FireDAC-Datenmengen zwischen einem DataSnap-Server und einem DataSnap-Client komprimiert. Als Ergebnis belegen Server und Client ungefähr ein Drittel des Speichers als bei {{Version|XE8}}.

====Bestimmte DataSnap-Clientanwendungen benötigen OpenSSL nicht mehr====

Bestimmte [[DataSnap-Anwendungen entwickeln|DataSnap-Clientanwendungen]] benötigen OpenSSL nicht mehr für die Unterstützung von HTTPS:

* Ein [[DataSnap-Anwendungen entwickeln|DataSnap-Client]] mit [[lib_de:Datasnap.DSClientRest.TDSRestConnection|TDSRestConnection]] benötigt OpenSSL nicht.
* Ein [[DataSnap-Anwendungen entwickeln|DataSnap-Client]] mit [[lib_de:Data.SqlExpr.TSQLConnection|TSQLConnection]] benötigt OpenSSL eventuell nicht.

:'''Hinweis:''' Für DataSnap-Clientanwendungen, die [[Filtern des DataSnap-Byte-Streams|Filter]] verwenden, ist die Installation von OpenSSL-Bibliotheken erforderlich.

====Neue DataSnap-Demobeispiele====

{{Product|Seattle}} enthält zwei neue Beispiele für die Verwendung von [[lib_de:FireDAC.Comp.Client.TFDSchemaAdapter|FDSchemaAdapter]] in [[DataSnap-Anwendungen entwickeln|DataSnap]]-Anwendungen:

* Das [[Samp:DataSnap.FireDAC Sample|FireDAC]]-Beispiel in {{Path|Object Pascal\DataSnap\FireDAC}}.
* Das [[Samp:DataSnap.FireDAC DBX Sample|FireDAC DBX]]-Beispiel in {{Path|Object Pascal\DataSnap\FireDAC_DBX}}.

}}

===[[FireDAC|FireDAC]]===

====Optimierung von FireDAC-ETL-Komponenten====

[[lib_de:FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|TFDBatchMoveSQLWriter]] unterstützt alle möglichen [[lib_de:FireDAC.Comp.BatchMove.TFDBatchMove.Mode|Modi]] der [[lib_de:FireDAC.Comp.BatchMove.TFDBatchMove|TFDBatchMove]]-Datenbewegung.

:'''Hinweis:''' Der Modus {{Const|dmAppendUpdate}} wird nur unterstützt, wenn die Datenbank MERGE, INSERT OR REPLACE oder ähnliche DML-Anweisungen unterstützt.

====Unterstützung für die NoSQL MongoDB-Datenbank====

In {{Version|Seattle}} enthält FireDAC die vollständige Unterstützung für die NoSQL MongoDB-Datenbank.

Entwickeln Sie mit dem neuen FireDAC-Verbindungstreiber, den API-Klassen und den neuen Komponenten Anwendungen, die eine Verbindung mit der MongoDB-Datenbank herstellen.

Einzelheiten finden Sie unter [[Herstellen einer Verbindung zur MongoDB-Datenbank (FireDAC)|Herstellen einer Verbindung zu einer MongoDB-Datenbank mit FireDAC]].

'''Einrichten einer Verbindung zu einer MongoDB-Datenbank'''

Verwenden Sie den neuen MongoDB-Treiber von FireDAC, um eine Verbindung zu der MongoDB-Datenbank einzurichten.

* Verwenden Sie in der [[lib_de:FireDAC.Comp.Client.TFDConnection|TFDConnection]]-Komponente die neue Treiber-ID '''Mongo''' als [[lib_de:FireDAC.Comp.Client.TFDCustomConnection.DriverName|DriverName]].
* Neue '''[[lib_de:FireDAC.Phys.MongoDB.TFDPhysMongoDriverLink|TFDPhysMongoDriverLink]]'''-Komponente und die '''[[lib_de:FireDAC.Phys.MongoDB|FireDAC.Phys.MongoDB]]'''-Unit.

'''MongoDB-Wrapper-Klassen'''

FireDAC enthält nun Wrapper-Klassen zum Kapseln von MongoDB-Datenbankanweisungen, -methoden und -strukturen:

* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoConnection|TMongoConnection]]: Klasse zum Verwalten von Verbindungen zu einem MongoDB-Server, zum Zugreifen auf Datenbanken und Objektsammlungen.
* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoDatabase|TMongoDatabase]]: Klasse zum Verwalten einer MongoDB-Datenbank, Sammlungen und Benutzer in der MongoDB-Datenbank.
* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoCollection|TMongoCollection]]: Klasse, die eine MongoDB-Sammlung repräsentiert.
* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoCursor|TMongoCursor]]: Klasse, die ein Ergebnismengendokument aus einem MongoDB-Cursor abruft.

'''MongoDB-Anweisungs- und -Methodengeneratoren'''

FireDAC unterstützt jetzt Anweisungen für MongoDB-Abfragen, -Pipelines und -Aktualisierungen mit dem Stilbefehl '''fluent''' und Methodengeneratoren.

* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoUpdate|TMongoUpdate]]: repräsentiert den Generator [https://docs.mongodb.org/manual/reference/operator/update/ MongoDB Update (EN)].
* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoSelector|TMongoSelector]]: repräsentiert den Generator [http://docs.mongodb.org/manual/reference/method/db.collection.remove/ MongoDB Selector (EN)].
* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoInsert|TMongoInsert]]: repräsentiert den Generator [http://docs.mongodb.org/manual/reference/method/db.collection.insert/ MongoDB Insert (EN)].
* [[lib_de:FireDAC.Phys.MongoDBWrapper.TMongoIndex|TMongoIndex]]: repräsentiert den Definitionsgenerator [http://docs.mongodb.org/manual/reference/method/db.collection.insert/ MongoDB Index (EN)].

'''Neue MongoDB-Datenmengen'''

FireDAC-spezifische MongoDB-Datenmengen rufen die Daten aus einer MongoDB-Datenbank ab und verwalten sie.

* Mit der Komponente [[lib_de:FireDAC.Phys.MongoDBDataSet.TFDMongoDataSet|TFDMongoDataSet]] verknüpfen Sie die Datenmenge mit dem MongoDB-Cursor.
* Mit der Komponente [[lib_de:FireDAC.Phys.MongoDBDataSet.TFDMongoQuery|TFDMongoQuery]] führen Sie Abfragen der MongoDB-Sammlungen aus.
* Mit der Komponente [[lib_de:FireDAC.Phys.MongoDBDataSet.TFDMongoPipeline|TFDMongoPipeline]] führen Sie Pipelines der MongoDB-Sammlung aus.

====Erweiterungen des [[Herstellen einer Verbindung zu ODBC-Datenquellen (FireDAC)|ODBC-Treibers]]====

Der [[Herstellen einer Verbindung zu ODBC-Datenquellen (FireDAC)|ODBC-Treiber]] für FireDAC wurde verbessert:

* Wenn Sie den ODBC-Treiber und eine [http://www.pervasive.com/database/Home/Products/PSQLv10.aspx Pervasive 10-Datenbank (EN)] verwenden, ist der Parameter '''NumericFormat''' standardmäßig <code>String</code>.

====Weitere FireDAC-Änderungen====

*Die Eigenschaft '''AutoCommitUpdates''' wurde aus [[lib_de:FireDAC.Comp.DataSet.TFDDataSet|TFDDataSet]] nach [[lib_de:FireDAC.Stan.Option.TFDUpdateOptions|TFDUpdateOptions]] verschoben.
** Die Eigenschaft '''AutoCommitUpdates''' wurde aus [[lib_de:FireDAC.Comp.Client.TFDSchemaAdapter|TFDSchemaAdapter]] nach [[lib_de:FireDAC.Stan.Option.TFDUpdateOptions|TFDUpdateOptions]] verschoben.
** [[lib_de:FireDAC.Comp.Client.TFDSchemaAdapter|TFDSchemaAdapter]] enthält nun die Eigenschaft '''UpdateOptions'''.
** Wenn [[lib_de:FireDAC.Stan.Option.TFDUpdateOptions.AutoCommitUpdates|AutoCommitUpdates]] '''True''' ist, dann entfernt [[lib_de:FireDAC.Comp.DataSet.TFDDataSet.ApplyUpdates|ApplyUpdates]] alle Änderungen, die für alle Datensätze im Änderungsprotokoll der Datenmenge erfolgreich übernommen wurden.
* [[lib_de:FireDAC.Comp.Client.TFDTable|TFDTable]].[[lib_de:FireDAC.Comp.DataSet.TFDDataSet.FetchOptions|FetchOptions]].[[lib_de:FireDAC.Stan.Option.TFDFetchOptions.LiveWindowParanoic|LiveWindowParanoic]] ist jetzt standardmäßig {{True}}.
* Wenn Ihre SQL-Anweisung nicht parametrisiert ist, können Sie jetzt den Parameter {{Arg|AParams}} in Aufrufen von [[lib_de:FireDAC.Comp.Client.TFDCustomConnection.ExecSQL|TFDConnection.ExecSQL]] weglassen, anstatt einen nil-Parameter zu übergeben.
* Verwenden Sie den neuen Parameter im nativen Informix-Treiber, '''TxSupported''', um anzugeben, ob die Informix-Datenbank SQL-Transaktionen unterstützt oder nicht. Weitere Informationen finden Sie unter [[Herstellen einer Verbindung zu Informix (FireDAC)|Herstellen einer Verbindung zu Informix (FireDAC)]].

===[[REST-Clientbibliothek|REST-Clientbibliothek]] und [[Übersicht über BaaS|BaaS]]===

* [[lib_de:REST.Client.TRESTRequestParameterList.AddItem|TRESTRequestParameterList.AddItem]] akzeptiert Werte als [[lib_de:System.SysUtils.TBytes|Byte-Arrays]] oder [[lib_de:System.Classes.TStream|Streams]].
* [[lib_de:REST.Client.TCustomRESTRequest|TCustomRESTRequest]] hat eine neue schreibgeschützte Eigenschaft, [[lib_de:REST.Client.TCustomRESTRequest.Body|Body]], mit der Sie den Text, den Sie zuvor mit [[lib_de:REST.Client.TCustomRESTRequest.AddBody|AddBody]] definiert haben, lesen können.
* Die [[REST-Clientbibliothek|REST-Clientbibliothek]] und [[Übersicht über BaaS|BaaS]] unterstützen jetzt JSON-[[lib_de:System.JSON.Readers|Reader]] und -[[lib_de:System.JSON.Writers|Writer]].
* Der Typ [[lib_de:REST.Json.Types.TParseDate|TParseDate]] unterstützt das Parse-Date-Objekt im korrekten Format.

<source lang="javascript">
{
"__type": "Date",
"iso": "2015-08-25T18:32:12.265Z"
}
</source>

==[[Entwickeln von Cloud-Anwendungen|Cloud]]==

===Für die Cloud-API ist OpenSSL nicht mehr erforderlich===

[[lib_de:Data.Cloud.AmazonAPI|AmazonAPI]] und [[lib_de:Data.Cloud.AzureAPI|AzureAPI]] benötigen OpenSSL nicht mehr für die Unterstützung von HTTPS.

===Einige Member von [[lib_de:Data.Cloud.CloudAPI|CloudAPI]] sind veraltet===

* [[lib_de:Data.Cloud.CloudAPI.Encode64|Encode64]] ist veraltet, verwenden Sie [[lib_de:System.NetEncoding.TNetEncoding.Encode|TNetEncoding.Encode]] (für die Eigenschaft [[lib_de:System.NetEncoding.TNetEncoding.Base64|base64]]).
* [[lib_de:Data.Cloud.CloudAPI.EncodeBytes64|EncodeBytes64]] ist veraltet, verwenden Sie [[lib_de:System.NetEncoding.TNetEncoding.EncodeBytesToString|TNetEncoding.EncodeBytesToString]] (für die Eigenschaft [[lib_de:System.NetEncoding.TNetEncoding.Base64|base64]]).
* [[lib_de:Data.Cloud.CloudAPI.Decode64|Decode64]] ist veraltet, verwenden Sie [[lib_de:System.NetEncoding.TNetEncoding.Decode|TNetEncoding.Decode]] (für die Eigenschaft [[lib_de:System.NetEncoding.TNetEncoding.Base64|base64]]).
* [[lib_de:Data.Cloud.CloudAPI.DecodeBytes64|DecodeBytes64]] ist veraltet, verwenden Sie [[lib_de:System.NetEncoding.TNetEncoding.DecodeStringToBytes|TNetEncoding.DecodeStringToBytes]] (für die Eigenschaft [[lib_de:System.NetEncoding.TNetEncoding.Base64|base64]]).
* [[lib_de:Data.Cloud.CloudAPI.XMLEscape|XMLEscape]] ist veraltet, verwenden Sie [[lib_de:System.NetEncoding.TNetEncoding.Encode|TNetEncoding.Encode]] (für die Eigenschaft [[lib_de:System.NetEncoding.TNetEncoding.HTML|HTML]]).

===Amazon===

*[[lib_de:Data.Cloud.AmazonAPI|AmazonAPI]] unterstützt jetzt die '''neuesten API-Versionen''':
** Amazon Simple Storage Service (S3): {{Code|API Version 2006-03-01}}
** Amazon Simple DB: {{Code|API Version 2009-04-15}}
** Amazon Simple Queue Service (SQS): {{Code|API Version 2012-11-05}}
*[[lib_de:Data.Cloud.AmazonAPI|AmazonAPI]] unterstützt jetzt '''AWS Signature Version 4''':
** Diese Änderung ist für den Benutzer transparent.
** Die API verwendet [http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html AWS Signature Version 4 (EN)], wo immer möglich, behält aber die Abwärtskompatibilität bei.

===Azure===

*[[lib_de:Data.Cloud.AzureAPI|AzureAPI]] unterstützt jetzt die '''neuesten API-Versionen''':
** Microsoft Azure Blob Service: {{Code|API Version 2014-02-14}}
** Microsoft Azure Table Service: {{Code|API Version 2014-02-14}}
** Microsoft Azure Queue Service: {{Code|API Version 2014-02-14}}
* Bei der Methode zum [[lib_de:Data.Cloud.AzureAPI.TAzureBlobService.AcquireBlobLease|Leasen eines Blobs]] kann jetzt ein {{Arg|LeaseDuration}}-Parameter angegeben werden. Weitere Informationen über den neuen Parameter {{Arg|LeaseDuration}} finden Sie unter [https://msdn.microsoft.com/en-us/library/azure/ee691972.aspx Microsoft Azure - Lease Blob (EN)].

==Änderungen des Debuggers für {{Version|Seattle}}==

===[[Debuggen von geräteübergreifenden Anwendungen|Remotes Debugging auf iOS-64-Bit-Geräten]]===

In {{Version|Seattle}} wird jetzt das [[Debuggen von geräteübergreifenden Anwendungen|Debugging]] von iOS64-Anwendungen unterstützt. In der IDE ist nun '''F9''' für die Zielplattform '''iOS-Gerät - 64 Bit''' aktiviert.

Weitere Informationen zur Unterstützung von Remote-Debugging für 64-Bit-iOS-Anwendungen finden Sie unter [[Debuggen von iOS-Apps#Debuggen von Apps, die auf dem 64-Bit-iOS-Gerät ausgeführt werden|Debuggen von Apps, die auf dem 64-Bit-iOS-Gerät ausgeführt werden]].

===Verbesserte OS X-Exception-Behandlung===

Die OS X-Exception-Behandlung wurde in {{Version|Seattle}} verbessert.

{{f|radstudio|

==Änderungen des Test-Frameworks für {{Version|Seattle}}==

In {{Product|Seattle}} {{Version|Seattle}} wurde die Unterstützung für '''DUnitX'''-Unit-Tests für mobile Plattformen (iOS und Android) erweitert. Dieses Test-Framework ermöglicht jetzt die Entwicklung und Ausführung von Tests für iOS-Geräte, Android und iOS-Simulator.

Weitere Informationen finden Sie unter [[Überblick über DUnitX|Überblick über DUnitX]].
}}

==Integrierte Frameworks und SDKs==

* Microsoft Windows 10 SDK wird jetzt mit {{Product|Seattle}} {{Version|Seattle}} installiert. {{Product|Seattle}} {{Version|Seattle}} unterstützt zudem die folgenden SDKs:
** Microsoft Windows 8.x SDK
** Microsoft Windows 7 SDK
* {{Product|Seattle}} {{Version|Seattle}} unterstützt jetzt die [https://msdn.microsoft.com/en-us/library/windows/desktop/dn554295%28v=vs.85%29.aspx Windows RT API (EN)] (Windows Runtime API) und die [https://msdn.microsoft.com/en-us/library/windows/desktop/ff818516%28v=vs.85%29.aspx Windows API (EN)].

==[[Hilfe zur Hilfe|Hilfe]]==

===Beispielanwendungen enthalten bessere Readme-Dateien===

Die Projektunterordner im Ordner mit den Beispielanwendungen enthalten nun aus dem Inhalt der [[Samp:Category:Sample|Dokumentation der Beispielanwendungen]] generierte HTML-Readme-Dateien. Diese Readme-Dateien beinhalten detaillierte Informationen zu jeder Beispielanwendung, einschließlich einer Beschreibung, Schritten zum Ausführen der Beispielanwendung und Links zu verwandten Hilfequellen.

===In der Bibliotheksdokumentation werden Unit-Packages angezeigt===

Auf den Unit-Seiten in der [[lib_de:Main Page|Bibliotheksdokumentation]] werden jetzt die in einem Package enthaltenen Units angezeigt. Wenn Sie wissen möchten, in welchem Package eine bestimmte Unit enthalten ist, öffnen Sie die API-Referenzseite für diese Unit, wie z. B. [[lib_de:System.SysUtils|System.SysUtils]] oder [[lib_de:FMX.Controls|FMX.Controls]].

===Verbesserte Navigation mithilfe von Seiten mit Begriffserklärungen und Umleitungen===

Für einige der am häufigsten gesuchten Begriffe in der [[Hauptseite|Themen-Online-Dokumentation]] stehen nun Seiten mit Begriffserklärungen und Umleitungen zur Verfügung, die die Suche nach der gewünschten Dokumentation erleichtern. Suchen Sie beispielsweise nach [[Special:Search/datasnap|datasnap]], [[Special:Search/android|android]], [[Special:Search/paserver|paserver]] oder [[Special:Search/listview|listview]].

==Hinweise zu OS X 10.11 und iOS 9==

===PAServer-Hotfix für {{Product|Seattle}} {{Version|Seattle}}===

Dieser Hotfix stellt Korrekturen für die Erzeugung der folgenden Anwendungen bereit:

* OS X 10.11 (El Capitan)
* iOS-Anwendungen unter iOS 7, iOS 8 und iOS 9 mit dem iOS 9 SDK

Sie können den Hotfix hier herunterladen: [http://cc.embarcadero.com/item/30398 http://cc.embarcadero.com/item/30398]

[[Category:Seattle]]
[[Category:AMMigrate]]

[[en:What's New in Seattle]]
[[fr:Nouveautés de Seattle]]
[[ja:Seattle の新機能]]

Versionsinformationen

2016-06-24T10:55:53Z

Esabatell: Updated. LOC-22885

{{Parent|Projektoptionen (Dialogfeld)}}

{{Menu|Projekt > Optionen > Versionsinformationen}}

In diesem Dialogfeld legen Sie Versionsinformationen für ein Projekt fest. Wenn ein Benutzer mit der rechten Maustaste auf das Programmsymbol klickt und "Eigenschaften" wählt, werden die Versionsinformationen angezeigt.
__TOC__

{| border="1" frame="hsides" rules="rows"
|-
! '''Optionen'''
! '''Beschreibung'''
|- valign="top"
|
Ziel, Übernehmen, Speichern
|
Siehe [[Optionen für das Ziel|Optionen für das Ziel]].
|- valign="top"
|
Gemeinsame Elemente
|
Siehe [[Gemeinsame Elemente auf den Projektoptionsseiten|Gemeinsame Elemente auf den Projektoptionsseiten]].
|}

Auf der Seite '''Versionsinformationen''' werden je nach im Feld '''Ziel''' ausgewählter Zielplattform unterschiedliche Felder angezeigt:

* '''[[#Windows-Versionsinformationen|Windows-Versionsinformationen]]'''
* '''[[#OS X- und iOS-Versionsinformationen|OS X- und iOS-Versionsinformationen]]'''
* '''[[#Android-Versionsinformationen|Android-Versionsinformationen]]'''

==Windows-Versionsinformationen==

Wenn es sich bei der im Feld '''Ziel''' ausgewählten Zielplattform entweder um '''32-Bit-Windows''' oder um '''64-Bit-Windows''' handelt, enthält die Seite '''Versionsinformationen''' die folgenden Felder:

{| border="1" frame="hsides" rules="rows"
|-
! '''Element'''
! '''Beschreibung'''
|- valign="top"
|
Versionsinformationen in das Projekt übernehmen
|
Legt fest, ob der Benutzer Produktidentifikationsinformationen anzeigen kann.
|- valign="top"
|
Versionsnummer des Moduls
|
Legt eine hierarchisch strukturierte Identifikationsnummer bestehend aus Versionsnummern (Haupt- und Nebenversion), Release-Nummer und Build-Nummer fest (z. B. 2.1.3.5):
*In den Feldern '''Hauptversion''', '''Nebenversion''', '''Ausgabe''' und '''Build''' können vorzeichenlose Ganzzahlen im Bereich von 0 bis 65.535 eingegeben werden. Der daraus zusammengesetzte String bildet eine eindeutige Versionsnummer für die Anwendung.

Um die '''Versionsnummer''' auf einer Windows-Plattform anzuzeigen, klicken Sie mit der rechten Maustaste im Windows-Datei-Explorer auf die EXE-Datei und wählen im Kontextmenü '''Eigenschaften'''. Im Dialogfeld "Eigenschaften" wird u. a. die '''Dateiversion''' angezeigt.

Um programmseitig Versionsinformationen Ihrer compilierten Win32-Anwendung zu ermitteln, verwenden Sie die '''Windows-API-Funktionen [http://msdn.microsoft.com/en-us/library/ms647003%28v=VS.85%29.aspx GetFileVersionInfo (EN)]''' und '''[http://msdn.microsoft.com/en-us/library/ms647464(VS.85).aspx VerQueryValue (EN)]'''.

Versionsinformationen für einen emulierten Win32-Prozess, der in einer Win64-Umgebung ausgeführt wird, erhalten Sie mit der Funktion [http://msdn.microsoft.com/en-us/library/ms724340(VS.85).aspx GetNativeSystemInfo (EN)].
|- valign="top"
|
Optionen für Build-Nummern
|
Legt fest, wie die Build-Nummer geändert wird, wenn Sie '''Projekt > <Projekt> erzeugen''' wählen. Durch andere Compilierungsarten wird die Build-Nummer nicht geändert (die vierte Zahl in der Versionsnummer, z. B. 1.2.3.4).
*'''Build-Nr. automatisch erzeugen''' erzeugt die '''Ausgabe'''- und '''Build'''-Nummer und inkrementiert die Nummern bei jedem Aufruf von '''Projekt > <Projekt> erzeugen'''. Wenn '''Build-Nr. automatisch erzeugen''' festgelegt ist:
** '''Ausgabe''' = Anzahl der Tage seit dem 1. Januar 2000
** '''Build''' = Anzahl der Sekunden seit Mitternacht (00:00:00) dividiert durch 2
<blockquote>'''Hinweis:''' Für '''Build-Nr. automatisch erzeugen''' müssen Sie eventuell die Umgebungsvariable (SAVEVRC=TRUE) setzen.
Wählen Sie '''Tools > Optionen > Umgebungsoptionen > [[Umgebungsvariablen|Umgebungsvariablen]]''', und fügen Sie eine neue Benutzervariable mit dem Namen '''SAVEVRC''' und dem Wert '''TRUE''' hinzu.
Durch diese Variable wird das Generieren einer VRC-Datei mit einer automatisch erzeugten Build-Nummer und anderen Informationen aktiviert.
Diese Informationen werden compiliert und der RES-Datei hinzugefügt. Wenn Sie mit der rechten Maustaste auf Ihre ausführbare Datei klicken, wird die generierte Build-Nummer angezeigt.</blockquote>
* Mit der Option '''Build-Nr. automatisch erhöhen''' wird die Build-Nummer jedes Mal erhöht, wenn der Menübefehl '''Projekt > <Projekt> erzeugen''' gewählt wird. Bei anderen Arten der Compilierung wird die Build-Nummer nicht erhöht.
* '''Build-Nr. nicht ändern''' behält die vorhandene Build-Nummer bei. Dies ist die Vorgabe.
|- valign="top"
|
Modulattribute
|
Gibt den Zweck dieser Version an: Fehlersuche, Testversion usw. Modulattribute können zu Informationszwecken in die Versionsinformationen aufgenommen werden. Wird ein Projekt im Debug-Modus compiliert, wird das entsprechende Flag in die Versionsinformationen aufgenommen. Die verbleibenden Flags können nach Bedarf gesetzt werden.
*'''Debug-Build''' – Das Projekt wurde im Debug-Modus compiliert.
*'''Testversion''' – Die Version ist keine endgültige Version.
*'''DLL''' – Das Projekt enthält eine dynamische Link-Bibliothek (DLL).
*'''Spezielles Build''' – Die Version ist eine Abwandlung der Standardversion.
*'''Privates Build''' – Die Version wurde nicht unter den üblichen Gesichtspunkten für Ausgabeversionen compiliert.
|- valign="top"
|
Sprache
|
Gibt die Codeseite an, die zur Ausführung der Anwendung auf dem System des Benutzers erforderlich ist. Die '''Länderkennungs-ID''' kann in Hex angezeigt werden; zum Beispiel $0409 = Codeseite 1033.

Sie können hier nur eine Sprache auswählen, die im Dialogfeld '''Regions- und Sprachoptionen''' Ihres Computers aufgeführt ist. In einigen Windows-Versionen werden nicht alle Sprachen (z. B. fernöstliche Sprachen) unterstützt. Sie müssen mit Hilfe des entsprechenden Sprachpakets separat installiert werden.
|- valign="top"
|
Liste "Schlüssel/Wert"
|
Legt typische Daten zur Produktidentifikation fest. Die Schlüsseleinträge können geändert werden, indem der Schlüssel ausgewählt und der Name neu eingegeben wird. Klicken Sie zum Hinzufügen von Schlüsseleinträgen mit der rechten Maustaste in die Tabelle "Schlüssel/Wert", und wählen Sie '''Schlüssel hinzufügen'''. Um den Wert für einen Schlüssel einzugeben oder zu ändern, tippen Sie ihn einfach in das Feld '''Wert''' ein.
|}

==OS X- und iOS-Versionsinformationen==

Wenn im Feld '''Ziel''' als Zielplattform '''OS X''', '''iOS-Gerät - 32 Bit''', '''iOS-Gerät - 64 Bit''' oder '''iOS-Simulator''' ausgewählt wird, enthält die Seite '''Versionsinformationen''' die folgenden Felder:

{| border="1" frame="hsides" rules="rows"
|-
! '''Element'''
! '''Beschreibung'''
|- valign="top"
|
Versionsinformationen in das Projekt übernehmen
|
Legt fest, ob der Benutzer Produktidentifikationsinformationen anzeigen kann.
|- valign="top"
|
Versionsnummer des Moduls
|
Legt eine hierarchisch strukturierte Identifikationsnummer bestehend aus Versionsnummern (Haupt- und Nebenversion) und Build-Nummer fest (z. B. 2.1.5):
*In den Feldern '''Hauptversion''', '''Nebenversion''' und '''Build''' können vorzeichenlose Ganzzahlen im Bereich von 0 bis 65.535 eingegeben werden. Der daraus zusammengesetzte String bildet eine eindeutige Versionsnummer für die Anwendung.
|- valign="top"
|
Optionen für Build-Nummern
|
Legt fest, wie die Build-Nummer geändert wird, wenn Sie '''Projekt > <Projekt> erzeugen''' wählen. Durch andere Compilierungsarten wird die Build-Nummer nicht geändert (die dritte Zahl in der Versionsnummer, z. B. 1.2.3).
* '''Build-Nr. automatisch erzeugen''' erzeugt die '''Build'''-Nummer und inkrementiert die Nummern bei jedem Aufruf von '''Projekt > <Projekt> erzeugen'''. Ist '''Build-Nr. automatisch erzeugen''' festgelegt, dann ist '''Build''' die Anzahl der Sekunden seit Mitternacht (00:00:00) dividiert durch 2.
<blockquote>'''Hinweis:''' Für '''Build-Nr. automatisch erzeugen''' müssen Sie eventuell die Umgebungsvariable (SAVEVRC=TRUE) setzen: Wählen Sie '''Tools > Optionen > Umgebungsoptionen > [[Umgebungsvariablen|Umgebungsvariablen]]''', und fügen Sie eine neue Benutzervariable mit dem Namen '''SAVEVRC''' und dem Wert '''TRUE''' hinzu. Durch diese Variable wird das Generieren einer VRC-Datei mit einer automatisch erzeugten Build-Nummer und anderen Informationen aktiviert.</blockquote>
* Mit der Option '''Build-Nr. automatisch erhöhen''' wird die Build-Nummer jedes Mal erhöht, wenn der Menübefehl '''Projekt > <Projekt> erzeugen''' gewählt wird. Bei anderen Arten der Compilierung wird die Build-Nummer nicht erhöht.
* '''Build-Nr. nicht ändern''' behält die vorhandene Build-Nummer bei. Dies ist die Vorgabe.
|- valign="top"
|
Liste "Schlüssel/Wert"
|
Definiert Schlüssel-/Wertpaare, die der [[Apple-Anwendungsinformationsdatei (*.info.plist)|{{Path|info.plist}}-datei]] Ihres Projekts hinzugefügt werden müssen.

In der folgenden Tabelle sind die Standardfelder, die {{Product}} bereitstellt, aufgeführt. Um der Datei {{Path|info.plist}} ein neues Feld hinzuzufügen, klicken Sie mit der rechten Maustaste in die Feldliste und wählen Sie '''Schlüssel hinzufügen'''. Wenn Sie komplexe Schlüssel-/Wertpaare hinzufügen müssen, die Sie nicht mit dem Listenfeld definieren können, siehe [[Anpassen der Datei info.plist|Anpassen der Datei info.plist]].
{| class="wikitable"
|-
! Schlüssel
! Standardwert
! Hinweise
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-109585 CFBundleName (EN)]
|
$(ModuleName)
|
Wenn Sie [[Bereitstellen von iOS-Anwendungen für die Übermittlung an den App Store|Ihre Anwendung an den Mac App Store übermitteln]], müssen Sie Ihre "Mac App BundleID" in dieses Feld eingeben. Ansonsten könnte der Mac AppLoader melden, dass die Anwendungsdatei nicht mit der verwendeten "Store BundleId" übereinstimmt.
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-130430-BAJJHDJH CFBundleDevelopmentRegion (EN)] 
(nur iOS)
|
en
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-110725-TPXREF135 CFBundleDisplayName (EN)]
|
$(ModuleName)
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102070-TPXREF105 CFBundleIdentifier (EN)]
|
$(ModuleName)
|
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-102088 CFBundleInfoDictionaryVersion (EN)] 
(nur iOS)
|
7.1
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102364-TPXREF106 CFBundleVersion (EN)]
|
1.0.0 (OS X) 
1.0.0.0 (iOS)
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-111321-TPXREF112 CFBundlePackageType (EN)]
|
APPL
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-SW8 CFBundleSignature (EN)]
|
????
|
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-SW2 LSRequiresIPhoneOS (EN)] 
(nur iOS)
|
true
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-130418-TPXREF104 CFBundleAllowMixedLocalizations (EN)]
|
YES
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-101909-BCIIDGJG CFBundleExecutable (EN)]
|
$(ModuleName)
|
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/GraphicsAnimation/Conceptual/HighResolutionOSX/Explained/Explained.html NSHighResolutionCapable (EN)] 
(nur OS X)
|
true
|
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-SW8 LSApplicationCategoryType (EN)] 
(nur OS X)
|
public.app-category.utilities
|
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW11 UIDeviceFamily (EN)] 
(nur iOS)
|
iPhone & iPad
|
Gibt die von Ihrer Anwendung unterstützten iOS-Geräte an. Mögliche Werte:
* '''iPhone''' – Unterstützung für iPhone- und iPod-Touch-Geräte.
* '''iPad''' – Unterstützung für iPad-Geräte.
* '''iPhone & iPad''' – Unterstützung für iPhone-, iPod-Touch- und iPad-Geräte. (Vorgabe)
|- valign="top"
|
CFBundleResourceSpecification 
(nur iOS)
|
ResourceRules.plist
|
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW18 NSLocationAlwaysUsageDescription (EN)]
|
Der Grund, warum auf die Standortinformationen des Benutzers zugegriffen wird
|
Diese Beschreibung wird angezeigt, wenn die Autorisierung benötigt wird.
|- valign="top"
|
[https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW26 NSLocationWhenInUseUsageDescription (EN)]
|
Der Grund, warum auf die Standortinformationen des Benutzers zugegriffen wird
|
Diese Beschreibung wird angezeigt, wenn die Autorisierung benötigt wird.
|- valign="top"
|
FMLocalNotificationPermission 
(nur iOS)
|
false
|
|- valign="top"
|
[https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/plist/info/UIBackgroundModes UIBackgroundModes (EN)] 
(nur iOS)
|
|
Gibt die App-Dienste an, die weiter im Hintergrund ausgeführt werden müssen. Wählen Sie die gewünschten Stringwerte aus, die dem Array dieses Schlüssels hinzugefügt werden sollen.
|}
|}

==Android-Versionsinformationen==

Für die Zielplattform '''Android''' werden auf der Seite '''Versionsinformationen''' die folgenden Felder angezeigt, die in der Datei [[Anwendungsmanifestdatei für Android (AndroidManifest.xml)|AndroidManifest.xml]] verwendet werden:

{| border="1" frame="hsides" rules="rows"
|-
! '''Element'''
! '''Beschreibung'''
|- valign="top"
|
Versionscode
|
Integerwert, der die Version Ihrer Anwendung auf den '''Android'''-Plattformen festlegt.

Für manche Anwendungs-Stores, wie Google Play, müssen neuere Versionen Ihrer Anwendung immer einen höheren Versionscode als die Vorgängerversionen aufweisen. Deshalb ist es wichtig, dass Sie diesen Wert immer inkrementieren, bevor Sie Ihre Anwendung für Anwendungs-Stores bereitstellen.
|- valign="top"
|
Versionscodeoptionen
|
Legt fest, wie der Versionscode bei Auswahl von '''Projekt > <Projekt> erzeugen''' geändert wird, wenn '''Anwendungs-Store''' als [[Übersicht über Zielplattformen#Verwenden des Konfigurationsknotens|Plattformkonfiguration]] ausgewählt ist. Bei anderen Arten der Compilierung wird der Versionscode nicht geändert.
* '''Für Anwendungs-Store automatisch erhöhen''' aktualisiert den Versionscode und erhöht ihn jedes Mal um 1, wenn Sie '''Projekt > <Projekt> erzeugen''' wählen und der '''Anwendungs-Store''' als [[Übersicht über Zielplattformen#Verwenden des Konfigurationsknotens|Plattformkonfiguration]] ausgewählt ist.
* '''Nicht ändern''' behält den vorhandenen Versionscode bei. Dies ist die Vorgabe.
|- valign="top"
|
Liste "Schlüssel/Wert"
|
Legt Eigenschaften für Informationen zu Ihrer Anwendung fest. Die folgende Eigenschaftsliste ist verfügbar:
{| class="wikitable"
|-
! '''Schlüssel'''
! '''Beschreibung'''
|- valign="top"
|
package
|
Ein Paketname, der Ihre Anwendung eindeutig bezeichnet.

Der Name muss den folgenden Formatanforderungen entsprechen:
* Sie dürfen nur lateinische Groß- oder Kleinbuchstaben (A-Z, a-z), Zahlen (0-9) und Unterstriche (_) verwenden.
* Einzelne Teile von Paketnamen müssen mit Buchstaben beginnen.

In manchen Android-Anwendungs-Stores, wie Google Play, können Sie nur neue Versionen Ihrer Anwendung veröffentlichen, wenn die alte und die neue Version denselben Paketnamen haben. Außerdem kann der Paketname von anderen Android-Anwendungen zum Identifizieren Ihrer Anwendung verwendet werden; zum Beispiel, um Android mitzuteilen, dass diese Anwendungen Ihre Anwendung als Voraussetzung benötigen.

In der [http://developer.android.com/guide/topics/manifest/manifest-element.html#package Android-Dokumentation (EN)] finden Sie weitere Informationen.
|- valign="top"
|
label
|
Der Anzeigename Ihrer Anwendung.
|- valign="top"
|
versionCode
|
Der Versionscode Ihrer Anwendung.

Sie können diesen Wert im numerischen Feld '''Versionscode''' ändern.
|- valign="top"
|
versionName
|
Die angezeigte Versionsnummer Ihrer Anwendung. Zum Beispiel: "2.0".
|- valign="top"
|
persistent
|
Ob Ihre Anwendung immer ausgeführt werden soll oder nicht. In der [http://developer.android.com/guide/topics/manifest/application-element.html#persistent Android-Dokumentation (EN)] finden Sie weitere Informationen.
|- valign="top"
|
restoreAnyVersion
|
Ob Ihre Anwendung von einer neueren Version Ihrer Anwendung geschriebene Daten lesen kann oder nicht. In der [http://developer.android.com/guide/topics/manifest/application-element.html#restoreany Android-Dokumentation (EN)] finden Sie weitere Informationen.
|- valign="top"
|
installLocation
|
Der bevorzugte Speicherort für die Installation Ihrer Anwendung. Mögliche Werte:
* '''internalOnly''' – Die Anwendung nur im internen Speicher installieren. Falls im internen Speicher nicht genügend freier Speicherplatz vorhanden ist, schlägt die Installation der Anwendung fehl.
* '''auto''' (Vorgabe) – Die Anwendung im internen Speicher installieren. Falls im internen Speicher nicht genügend freier Speicherplatz vorhanden ist, wird die Anwendung in einem externen Speicher installiert.
* '''preferExternal''' – Die Anwendung im externen Speicher installieren (z. B. auf einer SD-Karte). Falls im externen Speicher nicht genügend freier Speicherplatz vorhanden ist, wird die Anwendung im internen Speicher installiert.

In der [http://developer.android.com/guide/topics/manifest/manifest-element.html#install Android-Dokumentation (EN)] finden Sie weitere Informationen.
|- valign="top"
|
largeHeap
|
Ob die Prozesse Ihrer Anwendung mit einem großen Dalvik-Heap erstellt werden sollen. 
Für die meisten Apps ist dies nicht erforderlich. Stattdessen sollte deren Gesamtspeichernutzung reduziert werden, um eine verbesserte Leistung zu erzielen.

In der [http://developer.android.com/guide/topics/manifest/application-element.html#largeHeapl Android-Dokumentation (EN)] finden Sie weitere Informationen.
|- valign="top"
|
theme
|
Ob Ihre Anwendung im Vollbildmodus ausgeführt wird. In Android-Apps kann das Vollbildverhalten nicht mit der Eigenschaft '''[[lib_de:FMX.Forms.TForm.BorderStyle|BorderStyle]]''' wie in iOS-Apps festgelegt werden. Anstelle [[lib_de:FMX.Forms.TForm.BorderStyle|BorderStyle]] festzulegen, müssen Sie mit dem Schlüssel '''theme''' das Vollbildverhalten für alle Formulare in Ihrer Android-App definieren.

Mögliche Werte:
*'''TitleBar''' (Vorgabe). In Ihrer Anwendung wird die Android-Statusleiste angezeigt.
*: Das Ergebnis ist das Verhalten, das Sie in iOS-Apps erhalten, wenn Sie in allen Formularen <code>[[lib_de:FMX.Forms.TCommonCustomForm.BorderStyle|BorderStyle]]</code> ≠ <code>None</code> festlegen.
*'''Keine TitleBar'''. Ihre Anwendung wird im Vollbildmodus ausgeführt.
*: Das Ergebnis ist das Verhalten, das Sie in iOS-Apps erhalten, wenn Sie in allen Formularen <code>[[lib_de:FMX.Forms.TCommonCustomForm.BorderStyle|BorderStyle]]</code> = <code>None</code> festlegen.

Weitere Informationen finden Sie unter [[lib_de:FMX.Forms.TForm.BorderStyle|FMX.Forms.TForm.BorderStyle]].
|- valign="top"
|
hardwareAccelerated
|
Ermöglicht die Aktivierung/Deaktivierung der Hardwarebeschleunigung auf Anwendungsebene auf der Zielplattform.

Diese Option fügt dem <application>-Tag das folgende Attribut hinzu, um die Hardwarebeschleunigung für die ganze Anwendung zu aktivieren.

<application android:hardwareAccelerated="true" ...>
<application android:hardwareAccelerated="false" ...>
Vorgabe = true

Weitere Informationen finden Sie unter [http://developer.android.com/guide/topics/manifest/application-element.html#hwaccel developer.android.com (EN)]
|- valign="top"
|
apiKey
|
Ermöglicht, den API-Schlüssel für den Zugriff auf die Google Maps-Dienste zu definieren. Weitere Informationen finden Sie unter [[Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps|Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps]].
|}
|}

==Siehe auch==

* [[Anwendungsoptionen|Anwendungsoptionen]]
* [[Bereitstellungsseite|Bereitstellungsseite]]
* [[Verwendet Berechtigungen|Verwendet Berechtigungen]]
* [[Berechtigungsliste|Berechtigungsliste]]
* [[Vorbereiten von iOS-Anwendungen für die Bereitstellung|Vorbereiten von iOS-Anwendungen für die Bereitstellung]]
* [[Vorbereiten von Android-Anwendungen für die Bereitstellung|Vorbereiten von Android-Anwendungen für die Bereitstellung]]

[[Category:IDE-Referenz]]
[[Category:AMMigrate]]

[[en:Version Info]]
[[fr:Informations de version]]
[[ja:［バージョン情報］]]

Verwenden von TImageList-Bilderlisten als zentralisierte Bildersammlungen

2016-06-24T10:54:38Z

Esabatell: Updated. LOC-22885

__TOC__
{{Parent|FireMonkey-Anwendungsdesign}}
[[lib_de:FMX.ImgList.TImageList|TImageList]]-Bilderlisten von {{FM}} bieten Tools mit vielfältigen Funktionen für die Verwendung von zentralisierten Sammlungen kleiner Bilder durch GUI-Elemente (Steuerelemente, Menüs und andere) in {{FM}}-Anwendungen.
{{f|vcl|
Die [[lib_de:FMX.ImgList.TImageList|TImageList]]-Bilderlisten in {{FM}} dienen demselben Zweck wie die [[lib_de:Vcl.Controls.TImageList|Vcl.Controls.TImageList]]-Bilderlisten in der VCL, bieten aber fortgeschrittenere Funktionen.}} Die [[lib_de:FMX.ImgList.TImageList|TImageList]]-Bilderlisten in {{FM}} werden verwendet, um große Mengen von Symbolen oder Bitmaps effektiv zu verwalten, und sie sind für plattformübergreifende Anwendungen geeignet.

Da {{FM}} ein plattformübergreifendes Framework (Windows, iOS, OS X und Android) ist, können {{FM}}-Anwendungen auf Geräten mit unterschiedlicher Punktdichte und Auflösung des Bildschirms ausgeführt werden.
Bei Verwendung der [[lib_de:FMX.MultiResBitmap|Bitmaps mit Mehrfachauflösung]] von {{FM}} werden Ihre Bilder und Symbole in {{FM}}-Anwendungen korrekt in verschiedenen Punktdichten, Auflösungen und auf unterschiedlichen Plattformen (Windows, iOS, OS X und Android) dargestellt. Ein Bitmap mit Mehrfachauflösung ist eine Sammlung von Bitmap-Elementen, die dasselbe Bild in unterschiedlichen Skalierungen enthält.

==Gründe für die Verwendung von Bilderlisten==

In einer GUI-Anwendung kann eine Vielzahl von Steuerelementen (wie Schaltflächen, Menüeinträge, Einträge in verschiedenen Listen) kleine Bilder (Symbole, Piktogramme oder Widgets) enthalten. Beispielsweise hat [[lib_de:FMX.Menus.TMenuItem|TMenuItem]] die Eigenschaft [[lib_de:FMX.Menus.TMenuItem.Bitmap|Bitmap]]. Mit dieser Eigenschaft können Sie ein Bild aus einer Datei laden. Dies ist die einfachste und anscheinend die bequemste Art des Ladens von Bildern in Ihre Anwendungen. In jedes neue Steuerelement können Sie ein bestimmtes Bild laden und es anzeigen.

Eine andere Möglichkeit stellt das Speichern aller in einer Anwendung verwendeten Bilder in einer zentralisierten Sammlung dar. Für jedes Steuerelement wird dabei nur ein Verweis auf ein Bild in dieser Sammlung gespeichert. Beispielsweise können Sie ein Bild aus einem Stil verwenden. Wählen Sie zum Beispiel im Objektinspektor für eine Schaltfläche die Eigenschaft '''StyleLookup''' aus, klicken Sie auf den Pfeil, um die Dropdown-Liste zu erweitern, und wählen Sie {{Code|searchtoolbutton}} aus. Das Symbol "Vergrößerungsglas" wird für die Schaltfläche angezeigt. Wir haben diese Möglichkeit beibehalten, weil sie für eine feste Sammlung der meisten Standardsymbole sehr praktisch ist. Für reale Anwendungen müssen Sie aber häufig individuell gestaltete Symbole laden und speichern. Für solche Fälle kann die [[lib_de:FMX.ImgList.TImageList|TImageList]]-Komponente sehr nützlich sein.

Das schematische Vorgehen bei der Verwendung von [[lib_de:FMX.ImgList.TImageList|TImageList]] kann folgendermaßen beschrieben werden:

# Fügen Sie einem Formular (besser einem speziell erstellten Datenmodul) eine [[lib_de:FMX.ImgList.TImageList|TImageList]]-Bilderliste (nicht sichtbare Komponente) hinzu.
# Laden Sie Ihre Bilder in dieses [[lib_de:FMX.ImgList.TImageList|TImageList]]-Objekt.
# Wählen Sie im Objektinspektor die Eigenschaft '''Images''' Ihres Steuerelements aus, klicken Sie auf den Pfeil, um die Dropdown-Liste zu erweitern, und wählen Sie den Verweis auf das [[lib_de:FMX.ImgList.TImageList|TImageList]]-Objekt aus.
# Wählen Sie in der Eigenschaft '''ImageIndex''' die Anzahl der Bilder in dem Bilderlisten-Objekt aus, die Sie anzeigen möchten.

Wiederholen Sie die Schritte 3 und 4 für jedes neue Steuerelement. Wenn das [[lib_de:FMX.ImgList.TImageList|TImageList]]-Objekt kein passendes Bild enthält, wiederholen Sie Schritt 2.
Im ersten Moment könnte dieses Vorgehen zu kompliziert wirken. Anhand der folgenden [[lib_de:FMX.ImgList.TImageList|TImageList]]-Verwendungsbeispiele werden die Vorteile dieser Schritte und die Verwendung von [[lib_de:FMX.ImgList.TImageList|TImageList]] gegenüber dem einfachen Auswählen des gewünschten Bildes aus einem Ordner erläutert.

Das erste Beispiel: Eine Sammlung von Bildern eines erfahrenen Programmierers kann ohne Weiteres 9.000 bis 10.000 Bilder enthalten. Die Suche nach einem bestimmten Bild in solchen Sammlungen kann sehr mühsam sein. Andererseits können auch in recht komplexen Anwendungen bis zu 100 – 200 Bilder verwendet werden. Für viele Steuerelemente in einer Anwendung kann dasselbe (oder ein ähnliches) Bild verwendet werden, und eine gewisse Konsistenz bei der Verwendung dieser Bilder ist wünschenswert. Beispielsweise hat etwa vor einem Jahr ein früherer Kollege von Ihnen bei der Entwicklung der ersten Version Ihres Programms der '''Speichern'''-Schaltfläche ein Symbol mit einer blauen 3-Zoll-Diskette zugewiesen. Bei der Entwicklung der neuen Version Ihres Programms müssen Sie jetzt ein neues Formular mit derselben '''Speichern'''-Schaltfläche erstellen und ihr dasselbe Symbol zuweisen. Dieses Symbol zu finden, könnte sich jedoch als schwierig erweisen. Bei der Verwendung des [[lib_de:FMX.ImgList.TImageList|TImageList]]-Objekts hätten Sie dieses Problem nicht, weil Sie einfach dieses Symbol aus der für Ihr [[lib_de:FMX.ImgList.TImageList|TImageList]]-Objekt erweiterten Dropdown-Liste auswählen könnten.

Das zweite Beispiel: Angenommen, Ihr Chef hat entschieden, dass es nun an der Zeit ist, ein Symbol mit der modernen Energiesparlampe anstatt des Symbols mit der alten Glühbirne zu verwenden. Wie viele Steuerelemente (und Menüeinträge) verwenden dieses Symbol? Wie lange brauchen Sie, um all diese Symbole zu ändern? Wenn all Ihre Symbole in einer zentralisierten Bildersammlung gespeichert sind, dann sind solche Massenersetzungen ein Kinderspiel. Sie müssen nur dieses Symbol in Ihrer zentralisierten Bildersammlung ändern.
Im Anschluss daran können Sie auch ein Datenmodul, das eine Sammlung mit Bildern (Bilderliste) enthält, erstellen und dieses Modul mehreren Anwendungen hinzufügen, die Bilder aus dieser Sammlung verwenden müssen.

Ein kurzes drittes Beispiel: Die dynamische Erstellung von vielen Steuerelementen, die zur Laufzeit Symbole anzeigen, produziert ein Menge von doppelten Grafikdaten. Wenn Sie '''TImageList''' verwenden, speichert jedes Steuerelement nur einen Index auf das zu zeichnende Symbol in der '''TImageList'''-Sammlung.

Die Verwendung der gemeinsamen '''TImageList'''-Sammlung trägt also dazu bei, ähnliche Aufgaben wie die Wiederverwendung von Code, aber in Bezug auf Grafikdaten, zu lösen.

==Verwendung von Bilderlisten==

Sehen Sie sich das [http://youtu.be/QI_dwMWtpuc Video, das die typischen Schritte beim Erstellen einer neuen Bilderliste in einem FireMonkey-Projekt demonstriert], und das [http://youtu.be/IZfG2S9KGcU Video, das zeigt, wie mit dem Bilderlisten-Editor eine Bilderliste bearbeitet wird], an.

Das detaillierte Vorgehen bei der Verwendung von [[lib_de:FMX.ImgList.TImageList|TImageList]] kann folgendermaßen beschrieben werden:

# Erstellen Sie ein Datenmodul, und setzen Sie es vor das Hauptformular in der Modulliste eines Projekts.
# Fügen Sie den Unit-Namen des Datenmoduls in den '''uses'''-Abschnitt des Hauptmoduls ein.
# Ziehen Sie aus der '''Tool-Palette''' ein '''TImageList'''-Objekt auf das Datenmodul.
# Doppelklicken Sie auf das '''TImageList'''-Objekt. Der leere [[Bilderlisten-Editor (FireMonkey)|Bilderlisten-Editor ({{FM}})]] wird geöffnet.
# Klicken Sie auf die Schaltfläche '''Hinzufügen'''.
# Suchen Sie im Dialogfeld '''Bilder hinzufügen''' die gewünschte Grafikdatei, und klicken Sie auf '''Öffnen'''. Wechseln Sie beispielsweise zum Ordner '''{{InstallPath}}\Images\GlyFX\Icons\XP\PNG\16x16''' , und wählen Sie darin eine Grafikdatei aus.
# Im Bereich '''Liste der Bilder''' wird eine Vorschau aller geöffneten Bilder angezeigt. Sie können die Reihenfolge der Bilder durch Ziehen mit der Maus ändern.
#: '''Hinweis:''' Die Komponente '''TImageList''' selbst hat keine allgemeinen '''Width'''- und '''Height'''-Eigenschaften. Jedes Bild wird so skaliert, dass es am besten zu der Form des Steuerelements passt, in dem das Bild angezeigt wird. Wenn Sie die Größe des Bereichs '''Liste der Bilder''' ändern, wird die Größe der Bilder entsprechend geändert.
#:'''Hinweis:''' Beachten Sie, dass Sie zwar Bilder in beliebiger Größe hinzufügen können, '''TImageList''' aber für die Aufnahme von vielen kleinen Bildern konzipiert ist, die in verschiedenen GUI-Elementen (Schaltflächen, Menüeinträge, Listen usw.) angezeigt werden können. Standardmäßig werden Bilder ohne Änderungen gespeichert. Sie werden bei Bedarf skaliert. Wenn Sie einige große Bilder oder Fotos laden, werden diese daher nicht wie erwartet auf einer 24x24-Schaltfläche angezeigt, und eine Anwendung auf einem mobilen Gerät könnte einfach aufgrund mangelnder Systemressourcen hängen bleiben.
# Klicken Sie jetzt auf '''OK''', um den [[Bilderlisten-Editor (FireMonkey)|Bilderlisten-Editor]] zu schließen.
# Suchen Sie in der '''Tool-Palette''' das Grafiksteuerelement [[lib_de:FMX.ImgList.TGlyph|TGlyph]]. Die Funktionalität von [[lib_de:FMX.ImgList.TGlyph|TGlyph]] ist vergleichbar mit der von [[lib_de:FMX.Objects.TImage|TImage]], aber TGlyph enthält keine Grafikdaten.
# Suchen Sie im '''Objektinspektor''' die Eigenschaft [[lib_de:FMX.ImgList.TGlyph.Images|Images]] des TGlyph-Steuerelements. Die Liste in [[lib_de:FMX.ImgList.TGlyph.Images|Images]] enthält alle '''TImageList'''-Sammlungen des Projekts.
# Wählen Sie die gewünschte '''TImageList'''-Sammlung aus, und suchen Sie die Eigenschaft [[lib_de:FMX.ImgList.TGlyph.ImageIndex|ImageIndex]]. '''ImageIndex''' ist der Index (Nummer) eines Bildes in der Bilderliste. Die Liste in [[lib_de:FMX.ImgList.TGlyph.ImageIndex|ImageIndex]] enthält alle Bilder, die in der ausgewählten '''TImageList'''-Sammlung enthalten sind. Sie können ein gewünschtes Bild auswählen oder den ganzzahligen Index ('''ImageIndex''') des Bildes, das Sie anzeigen möchten, eingeben. Wenn für den angegebenen '''ImageIndex''' kein Bild vorhanden ist, wird kein Bild ausgewählt.

[[lib_de:FMX.ImgList.TGlyph|TGlyph]] ist von [[lib_de:FMX.Controls.TControl|TControl]] abgeleitet und kann in Stilen zum Erstellen von Steuerelementen verwendet werden. [[lib_de:FMX.ImgList.TGlyph|TGlyph]] ist in vielen Steuerelementen enthalten, die die Verwendung von Bilderlisten unterstützen.

[[lib_de:FMX.ImgList.TGlyph|TGlyph]]-Steuerelemente verfügen über die Eigenschaft [[lib_de:FMX.ImgList.TGlyph.AutoHide|AutoHide]]. [[lib_de:FMX.ImgList.TGlyph.AutoHide|AutoHide]] legt fest, dass das [[lib_de:FMX.ImgList.TGlyph|TGlyph]]-Steuerelement den Wert der Eigenschaft [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] selbst verwaltet:

* Wenn während der Laufzeit einer Anwendung [[lib_de:FMX.ImgList.TGlyph.AutoHide|AutoHide]] {{True}} ist, dann ist [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] {{True}}, falls das Steuerelement Grafiken enthält ([[lib_de:FMX.ImgList.TGlyph.BitmapExists|BitmapExists]] ist {{True}}). Andernfalls hat [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] den Wert {{False}}. Wenn im Code der Anwendung versucht wird, [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] auf einen neuen Wert zu setzen, dann wird dieser Wert ignoriert. Der [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]]-Wert ist für die Eigenschaft [[lib_de:FMX.ImgList.TGlyph.Align|Align]] von Bedeutung, wenn [[lib_de:FMX.ImgList.TGlyph.Align|Align]] nicht {{Code|None}} ist. Wenn [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] {{True}} ist, dann zeichnet ein leeres sichtbares Steuerelement den leeren Raum, der von dem Steuerelement belegt wird. Wenn [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] {{False}} ist, dann zeichnet ein leeres unsichtbares Steuerelement den leeren Raum nicht.
* Wenn [[lib_de:FMX.ImgList.TGlyph.AutoHide|AutoHide]] {{True}} ist, dann ist im Entwurfsmodus [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] immer {{True}}, und es kann nicht darauf zugegriffen werden.

Viele Grafiksteuerelemente (Schaltflächen, Menüs, Listen usw.) und Aktionen enthalten die neuen Eigenschaften '''Images''' und '''ImageIndex'''. Bitte beachten Sie, dass für Komponenten, die Listen mit Elementen bereitstellen, im '''Objektinspektor''' nur die Eigenschaft '''Images''' angezeigt wird. Für Elemente dieser Listen zeigt der '''Objektinspektor''' nur die Eigenschaft '''ImageIndex''' an. Die Eigenschaft '''Images''' aller Elemente des Listensteuerelements hat denselben Wert wie '''Images''' im Listensteuerelement. Das heißt, alle Menüeinträge verwenden immer die '''Images'''-Sammlung, die in der Eigenschaft '''Images''' des Menüs festgelegt ist.

Einige Steuerelemente, die über die Eigenschaften '''Images''' und '''ImageIndex''' verfügen, können die Eigenschaft '''Bitmap''' haben, die auch ein Bild referenzieren kann. Wenn die Eigenschaften '''Images''' und '''ImageIndex''' auf ein vorhandenes Bild zeigen, dann wird dieses Bild gezeichnet. Wenn '''ImageIndex''' auf kein vorhandenes Bild zeigt, dann zeichnet das Steuerelement das Bild, das von '''Bitmap''' referenziert wird. Beachten Sie, dass ein von '''Bitmap''' referenziertes, aber nicht verwendetes Bild nur ignoriert und nicht automatisch gelöscht wird, um Datenverluste zu vermeiden. Zum Beispiel, wenn Sie versehentlich '''ImageIndex''' festlegen, um ein nicht-vorhandenes Bild zu referenzieren. Sie können dieses referenzierte Bild manuell löschen, indem Sie die Eigenschaft '''Bitmap''' bearbeiten.

==TImageList-Struktur der obersten Ebene==

Im Allgemeinen kennt eine {{FM}}-Anwendung die erforderliche Größe eines zu zeichnenden Bildes nicht. Die Größe hängt von dem jeweiligen Steuerelement, dem Steuerelementstil und der [[lib_de:FMX.Controls.IScene.GetSceneScale|Skalierung]] der [[lib_de:FMX.Controls.IScene|Szene]] ab (und diese Skalierung kann nicht nur 1, 1,5 oder 2 sein), was wiederum von dem jeweiligen Computer oder dem mobilen Gerät abhängt. Deshalb werden Bilder häufig skaliert, damit sie in die gewünschten Begrenzungen zu passen. Aus diesem Grund wurde die Klasse [[lib_de:FMX.ImgList.TMultiResBitmap|TMultiResBitmap]] eingeführt. [[lib_de:FMX.MultiResBitmap.TCustomMultiResBitmap|Bitmaps mit Mehrfachauflösung]] speichern mehrere Varianten desselben für verschiedene Größen optimierten Bildes. Dadurch werden beim Skalieren von Bildern Qualitätseinbußen minimiert. Als Nächstes wurden die [[lib_de:FMX.ImgList.TImageList|TImageList]]-Bilderlisten eingeführt. [[lib_de:FMX.ImgList.TImageList|TImageList]]-Objekte speichern Sammlungen von [[lib_de:FMX.ImgList.TMultiResBitmap|TMultiResBitmap]]-Bildern. Jedes dieser [[lib_de:FMX.MultiResBitmap.TCustomMultiResBitmap|Bitmaps mit Mehrfachauflösung]] ist eine Menge von mehreren Varianten desselben Bildes in unterschiedlichen Größen.

Um die Bedeutung und Funktionalität der Elemente im [[Bilderlisten-Editor (FireMonkey)|Bilderlisten-Editor]] zu verdeutlichen, wird im Folgenden die [[lib_de:FMX.ImgList.TImageList|TImageList]]-Struktur der Komponente erläutert.

Jede [[lib_de:FMX.ImgList.TImageList|TImageList]]-Komponente enthält zwei Sammlungen mit Bildern:

* Die Sammlung [[lib_de:FMX.ImgList.TImageList.Source|Source]] enthält die Daten der Quellgrafiken. Mit diesen Daten werden die Bilder in der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] erstellt.
* Die Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] enthält die Daten, die zum Erstellen derjenigen Bilder erforderlich sind, die als Bilder der [[lib_de:FMX.ImgList.TImageList|TImageList]]-Sammlung gezeichnet werden sollen.

In der '''[[Strukturansicht|Strukturansicht]]''' des [[samp_en:FMX.ImageList Sample|Beispiels ImageList]] wird die {{Code|ImageList1}}-Struktur wie in der folgenden Abbildung angezeigt:

[[Image:ImageListEditor StructureView.png|center|200px|Strukturansicht im Bilderlisten-Editor]]

In dieser Abbildung hat jedes Bild in der [[lib_de:FMX.ImgList.TImageList.Source|Source]]-Sammlung:

* Einen eindeutigen Namen (ohne Berücksichtigung der Groß-/Kleinschreibung) (in jeder [[lib_de:FMX.ImgList.TImageList|TImageList]]-Sammlung). Beispielsweise hat das Bild {{Code|0}} den Namen {{Code|Stop}}, das Bild {{Code|1}} den Namen {{Code|TImageList}} und das Bild {{Code|2}} den Namen {{Code|folder}}.
* Die Eigenschaft '''MultiResBitmap'''. Jedes Element in einer '''MultiResBitmap'''-Sammlung repräsentiert wiederum eine Variante desselben Bildes mit einer bestimmten Größe (Skalierung). Beispielsweise enthält die '''MultiResBitmap'''-Sammlung des Bildes {{Code|folder}} 5 Bitmaps für die Skalierungen {{Code|1.0}}, {{Code|2.0}}, {{Code|1.5}}, {{Code|3.0}} und {{Code|16.0}}.

Diese Abbildung zeigt auch, dass jedes Element in der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] mehrere Ebenen enthalten kann, die in der Sammlung [[lib_de:FMX.ImgList.TDestinationItem.Layers|Layers]] enthalten sind. Beispielsweise besteht das Bild {{Code|3}} aus 2 Ebenen: die Ebene {{Code|0}} enthält das Bitmap mit Mehrfachauflösung {{Code|folder}} und die Ebene {{Code|1}} enthält das Bitmap mit Mehrfachauflösung {{Code|delete}}. Jede Ebene enthält den Namen des Quell-Bitmaps mit Mehrfachauflösung und Koordinaten eines Abschnitts dieses Bitmaps (immer in der Skalierung {{Code|1}}). Dieser Abschnitt des Bitmaps wird gezeichnet und somit das Bild generiert. Beim Generieren eines Bildes zeichnet {{FM}} zuerst das Bitmap mit Mehrfachauflösung aus der Ebene {{Code|0}}, das Bitmap mit Mehrfachauflösung aus der Ebene {{Code|1}} wird über das erhaltene Bild gezeichnet, das Bitmap mit Mehrfachauflösung aus der Ebene {{Code|2}} wird über das erhaltene Bild gezeichnet usw. Dies wird detaillierter im Abschnitt [[#Bereich "Ausgewähltes Bild"|Bereich "Ausgewähltes Bild"]] erläutert. Wenn ein Bitmap mit Mehrfachauflösung in einer Ebene Bitmaps mit mehreren Skalierungen enthält, dann wird das Bitmap mit der passendsten Skalierung verwendet. Die Skalierung wird entsprechend der erforderlichen Größe des fertigen Bildes und der Skalierung der Szene ausgewählt.

Wenn die Struktur von [[lib_de:FMX.ImgList.TImageList|TImageList]] bekannt ist, können zur Laufzeit Teile der gesamten [[lib_de:FMX.ImgList.TImageList|TImageList]]-Instanz gebildet werden. Das [[samp_en:FMX.ImageList Sample|Beispiel ImageList]] enthält solchen Code.

Zum Bearbeiten einer [[lib_de:FMX.ImgList.TImageList|TImageList]]-Sammlung in der IDE können Sie die '''Strukturansicht''' und den '''Objektinspektor''' verwenden. Es steht aber auch speziell dafür der [[#Verwenden des Bilderlisten-Editors|'''Bilderlisten'''-Editor]] zur Verfügung, der für die Verwaltung des Inhalts von [[lib_de:FMX.ImgList.TImageList|TImageList]]-Sammlungen besser geeignet ist.

<blockquote>
===Unterschiede der TImageList-Implementierung in der VCL===

In der VCL ist eine [[lib_de:Vcl.Controls.TImageList|Vcl.Controls.TImageList]]-Bilderliste eine Sammlung von Bildern mit derselben festen Größe. Dies führt zu Problemen, wenn in Ihrer Anwendung Bilder mit unterschiedlichen Skalierungen gezeichnet werden sollen. Um in VCL-Anwendungen Bilder mit unterschiedlichen Skalierungen zu zeichnen, müssen Sie mehrere '''TImageList'''-Objekte erstellen. Jedes '''TImageList'''-Objekt enthält eine spezielle Sammlung von Bildern für eine bestimmte Größe. In all diesen '''TImageList'''-Objekten sollten dieselben Bilder dieselben Nummern ('''Indizes''') haben. Eine VCL-Anwendung kann nur Bilder mit diesen Skalierungen zeichnen. In VCL-Anwendungen ist es schwierig, Bilder während der Laufzeit zu ändern.

</blockquote>

==Verwenden des Bilderlisten-Editors==

Das [http://youtu.be/IZfG2S9KGcU Video zeigt, wie mit dem Bilderlisten-Editor eine Bilderliste erstellt und bearbeitet wird (EN)]. Dieses Video demonstriert einige fortgeschrittene und wichtige Leistungsmerkmale des Bilderlisten-Editors.

Im Folgenden werden Eigenschaften des [[Bilderlisten-Editor (FireMonkey)|Bilderlisten-Editors]] anhand des [[samp_en:FMX.ImageList Sample|Beispiels ImageList]] beschrieben, das als Muster für die Verwendung von Bilderlisten dient. Laden Sie das Projekt "ImageListDemo.dproj", und doppelklicken Sie in der '''Projektverwaltung''' auf das Modul "UnitDataModule.dfm". Doppelklicken Sie im [[Formular-Designer|Formular-Designer]] auf das Symbol '''ImageList1'''. Der [[Bilderlisten-Editor (FireMonkey)|Bilderlisten-Editor]] wird mit der Komponente '''ImageList1''' geöffnet. Der '''Bilderlisten'''-Editor enthält drei Bereiche: '''Liste der Bilder''', '''Quellen der Bilder''' und '''Ausgewähltes Bild'''.

[[Image:ImageListEditor.png|center|550px|Bilderlisten-Editor]]

===Bereich "Liste der Bilder"===

Im Bereich '''Liste der Bilder''' wird die horizontale Liste der Bilder angezeigt. Jedes Bild ist eine Vorschau eines entsprechenden Bildes in der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]]. Diese Bilder werden in der Eigenschaft '''ImageIndex''' jedes Steuerelements angezeigt, das diese Bildersammlung verwendet.

Im Bereich '''Liste der Bilder''' können Sie Bilder mit der Maus ziehen, um deren Reihenfolge in der '''ImageList1'''-Bildersammlung zu ändern.

Mit der Schaltfläche '''Hinzufügen''' wird ein Bild aus einer Datei hinzugefügt. Durch Klicken auf '''Hinzufügen''' wird das Dialogfeld '''Bilder hinzufügen''' geöffnet, in dem Sie eine Bilddatei suchen können. Wenn ein hinzuzufügendes Bild um ein Vielfaches der angegebenen '''Breite''' und '''Höhe''' größer ist, werden Sie in einem Dialogfeld gefragt, ob der '''Bilderlisten-Editor''' es in mehrere Bilder aufteilen soll. Dies ist speziell für Symbolleisten-Bitmaps hilfreich, die normalerweise aus mehreren aufeinanderfolgenden kleinen Grafiken bestehen und als größeres Bitmap gespeichert werden. Das hinzugefügte Bild wird in der Vorschauliste des Bereichs '''Liste der Bilder''' hervorgehoben aufgeführt und im Bereich '''Ausgewähltes Bild''' angezeigt. Das Bild wird der Sammlung '''Source''' hinzugefügt und im Bereich '''Quellen der Bilder''' angezeigt.

Mit der Schaltfläche '''Exportieren''' können Sie alle Bilder aus der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] in eine Grafikdatei speichern. Das in dieser Datei gespeicherte Bild besteht aus Fragmenten, die alle Bilder aus dem Bereich '''Liste der Bilder''' enthalten. Alle Fragmente haben dieselbe durch '''Breite''' und '''Höhe''' festgelegte Größe.

Mit der Schaltfläche '''Löschen''' wird das ausgewählte Bild aus der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] gelöscht. (Mit '''Löschen''' wird das zugehörige Bild nicht aus der Sammlung [[lib_de:FMX.ImgList.TImageList.Source|Source]] gelöscht.)

Mit der Schaltfläche [[File:New.png]] ('''Neues Bild''') in der Symbolleiste (in der linken oberen Ecke des Bereichs) wird ein zuvor geladenes Bild (mit einer Ebene) hinzugefügt. Wenn sich der Fokus im Bereich '''Quellen der Bilder''' befindet, dann wird das ausgewählte Bild hinzugefügt. Ansonsten wird ein Bild in einer ausgewählten Ebene im Bereich '''Ausgewähltes Bild''' hinzugefügt. Das hinzugefügte Bild wird im Bereich '''Liste der Bilder''' hervorgehoben angezeigt.

===Bereich "Quellen der Bilder"===

Im Bereich '''Quellen der Bilder''' (siehe die Abbildung [[#Verwenden des Bilderlisten-Editors| '''Bilderlisten-Editor''']] weiter oben) werden alle Bilder in der [[lib_de:FMX.ImgList.TImageList.Source|Source]]-Sammlung der aktuellen [[lib_de:FMX.ImgList.TImageList|TImageList]]-Bilderliste angezeigt. Mit diesen Quellbildern werden Bilder in der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] erstellt (angezeigt im Bereich '''Liste der Bilder''').

Wie bereits erwähnt, wird durch Klicken auf '''Löschen''' im Bereich '''Liste der Bilder''' das ausgewählte Bild aus der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] gelöscht. Mit '''Löschen''' wird das zugehörige Bild nicht aus der Sammlung [[lib_de:FMX.ImgList.TImageList.Source|Source]] gelöscht, die im Bereich '''Quellen der Bilder''' angezeigt wird. Um ein Bild aus der Sammlung [[lib_de:FMX.ImgList.TImageList.Source|Source]] zu löschen, verwenden Sie die Schaltfläche [[File:Action delete.jpg]] '''Quelle löschen''' in der Symbolleiste.

Mit den Pfeilschaltflächen [[File:Arrow up.jpg]] und [[File:Arrow down.jpg]] in der Symbolleiste können Sie die Reihenfolge der Bilder ändern, indem Sie einzelne Bilder nach oben oder unten verschieben.

Klicken Sie auf die Schaltfläche [[File:New.png]] ('''Neue Quelle''') in der Symbolleiste, um der Sammlung [[lib_de:FMX.ImgList.TImageList.Source|Source]] ein neues Bild hinzuzufügen. Durch Klicken auf diese Schaltfläche wird ein Dialogfeld geöffnet, in dem Sie den '''Namen des neuen Quellelements''' eingeben müssen. Anschließend wird der [[MultiResBitmap-Editor|MultiResBitmap-Editor]] aktiviert.

====Verwenden des MultiResBitmap-Editors====

Das [http://youtu.be/oFl925XuFgc Video demonstriert die typische Verwendung des MultiResBitmap-Editors (EN)].

Mit dem [[MultiResBitmap-Editor|MultiResBitmap-Editor]] können Sie mehrere, für verschiedene Skalierungen optimierte Bilder hinzufügen:

[[Image:MultiResBitmapEditor ImageList.png|center|400px|ImageList im MultiResBitmap-Editor]]

Während der Laufzeit wählt eine Anwendung ein Bild aus, das über die am besten geeignete Skalierung verfügt.

Wie bereits erwähnt, ist die Komponente [[lib_de:FMX.ImgList.TImageList|TImageList]] für die Speicherung von Listen mit einer großen Anzahl kleiner Bilder vorgesehen. Bilder aus der Komponente [[lib_de:FMX.ImgList.TImageList|TImageList]] sind für die Verwendung als Symbole in Steuerelementen, Menüs, Listen usw gedacht.

Wenn Sie nur Dateien mit großen Bildern haben, dann können Sie deren Größe beim Hinzufügen dieser Bilder im [[MultiResBitmap-Editor|MultiResBitmap-Editor]] anpassen. Klicken Sie, bevor Sie ein großes Bild aus einer Datei hinzufügen, auf das Steuerelement '''[[MultiResBitmap-Editor#Steuerelemente|SizeKind]]''', und wählen Sie in der geöffneten Liste '''Benutzerdefinierte Größe''' aus. Die Eingabefelder '''Breite''' und '''Höhe''' werden angezeigt, falls sie nicht schon zuvor vorhanden waren. '''Breite''' und '''Höhe''' legen die Eigenschaften [[lib_de:FMX.MultiResBitmap.TCustomMultiResBitmap.Width|Width]] und [[lib_de:FMX.MultiResBitmap.TCustomMultiResBitmap.Height|Height]] für das Bild mit <code>Scale = 1</code> fest. Wenn Sie beispielsweise ein Bild für <code>Scale = 1.5</code> laden, dann wird die angegebene '''Breite''' und '''Höhe''' mit <code>1,5</code> multipliziert. Um ein Bild für eine bestimmte '''Skalierung''' zu laden, klicken Sie in diesem Skalierungs-Eingabefeld auf die Schaltfläche [[Image:Fill All From File.png]]. Um ein Bild für alle '''Skalierungen''' zu laden, klicken Sie in der Symbolleiste des '''MultiResBitmap-Editors''' auf die Schaltfläche [[Image:Fill All From File.png]] '''Alle aus Datei füllen'''.

Beachten Sie bitte, dass mit der Option '''Benutzerdefinierte Größe''' nicht das Bild in einer Quelldatei geändert wird. '''Benutzerdefinierte Größe''' ändert nur die Größe des in der FMX- oder DFM-Datei gespeicherten Bildes.

Die vom '''MultiResBitmap-Editor''' verwendeten Entwurfszeitinformationen enthalten '''Transparente Farbe''', '''SizeKind''', '''Breite''', '''Höhe''' und die Namen von Dateien mit Quellbildern. Diese Eigenschaften werden nicht veröffentlicht, sie werden nur beim Entwurf verwendet. Nach Bearbeitung des Bitmaps mit Mehrfachauflösung können diese Eigenschaften aus der FMX- oder DFM-Datei mit der Schaltfläche [[Image:Clear design time info and close.png]] ('''Fertig stellen''') der Symbolleiste entfernt werden. Mit der Schaltfläche [[Image:Clear design time info and close.png]] des '''MultiResBitmap-Editors''' werden die Entwurfszeitinformationen nur aus dem Bitmap mit Mehrfachauflösung entfernt, das gerade im '''MultiResBitmap-Editor''' bearbeitet wird. Mit der Schaltfläche [[Image:Clear design time info and close.png]] des '''Bilderlisten-Editors''' werden die Entwurfszeitinformationen aller Bilder in der aktuellen Bilderliste entfernt.

===Bereich "Ausgewähltes Bild"===

Im Bereich '''Ausgewähltes Bild''' (siehe die Abbildung [[#Verwenden des Bilderlisten-Editors| '''Bilderlisten-Editor''']] weiter oben) werden detaillierte Informationen über das im Bereich '''Liste der Bilder''' ausgewählte Bild angezeigt. Im Bereich '''Liste der Bilder''' wird eine Vorschau der Bilder in der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] angezeigt.

Wie bereits im Abschnitt [[#TImageList-Struktur der obersten Ebene| '''TImageList'''-Struktur]] erläutert (siehe die Abbildung [[#TImageList-Struktur der obersten Ebene| '''Strukturansicht''']] weiter oben), kann jedes Bild in der Sammlung [[lib_de:FMX.ImgList.TImageList.Destination|Destination]] mehrere [[lib_de:FMX.ImgList.TDestinationItem.Layers|Ebenen]] enthalten. Für jede [[lib_de:FMX.ImgList.TLayer|Ebene]] wird ein [[lib_de:FMX.ImgList.TLayer.Layers|Name]] eines Bildes aus der Sammlung [[lib_de:FMX.ImgList.TImageList.Source|Source]] und dem zugehörigen [[lib_de:FMX.ImgList.TLayer.MultiResBitmap|Bitmap mit Mehrfachauflösung]] angezeigt. Außerdem enthält jede Ebene [[lib_de:FMX.ImgList.TLayer.SourceRect|Koordinaten eines Abschnitts dieses Bitmaps mit Mehrfachauflösung]] (immer in der Skalierung 1, unabhängig von der Skalierung des zu verwendenden Bitmaps). Nur dieser Abschnitt des Bitmaps mit Mehrfachauflösung wird im fertigen Bild gezeichnet.

Normalerweise enthält jedes Bild nur eine Ebene. In manchen Situationen könnte aber die Verwendung mehrerer Ebenen zum Erstellen eines zusammengesetzten Bildes erforderlich sein. Beispielsweise könnte es zweckmäßig sein, eine separate Ebene für ein "durchgestrichenes" oder "Vergrößerungsglas"-Bild zu verwenden. Diese Ebene kann dann über eine Ebene mit einem anderen Bild gelegt werden. Beispielsweise könnte das Bild in der Ebene über eine Ebene mit einem "Ordner"- oder einem "Umschlag"-Bild gezeichnet werden. Dann können diese beiden Ebenen ein kombiniertes Bild bilden, z. B. ein Bild mit einem "durchgestrichenen Ordner" oder einem "Vergrößerungsglas über einem Umschlag".

Beim Generieren eines Bildes zeichnet FireMonkey zuerst das Bitmap mit Mehrfachauflösung aus der Ebene 0, das Bitmap mit Mehrfachauflösung aus der Ebene 1 wird über das erhaltene Bild gezeichnet, das Bitmap mit Mehrfachauflösung aus der Ebene 2 wird über das erhaltene kombinierte Bild gezeichnet usw. Wenn ein Bild mit dem in einer Ebene angegebenen Namen nicht vorhanden ist oder sich der angegebene Sektor außerhalb des Bildes befindet, dann zeichnet die Ebene nichts, und es wird keine Exception ausgelöst. Wenn ein Bitmap mit Mehrfachauflösung in einer Ebene Bitmaps mit mehreren Skalierungen enthält, dann wird das Bitmap mit der passendsten Skalierung verwendet. Die Skalierung wird entsprechend der erforderlichen Größe des fertigen Bildes und der Skalierung der Szene ausgewählt.

Diese Funktionalität wird im Folgenden anhand von Bildern aus dem [[samp_en:FMX.ImageList Sample|Beispiel ImageList]] demonstriert. Wählen Sie im Bereich '''Liste der Bilder''' (siehe [[#Verwenden des Bilderlisten-Editors|Verwenden des Bilderlisten-Editors]] weiter oben) das Bild mit <code>ImageIndex = 3</code> aus. Dies ist der "durchgestrichene Ordner". Im Bereich '''Ausgewähltes Bild''' werden die beiden folgenden Ebenen angezeigt:

[[Image:SelectedImage Folder1.png|center|250px|Bereich "Ausgewähltes Bild" für den "durchgestrichenen Ordner"]]

Vergleichen Sie dies mit der Darstellung des Destination-Bildes mit <code>ImageIndex = 3</code> in der '''Strukturansicht''':

[[Image:StructureView Folder1.png|center|Strukturansicht für den "durchgestrichenen Ordner"]]

In dieser Abbildung befindet sich das Bild {{Code|folder}} in der Ebene {{Code|0}} und das Bild {{Code|delete}} in der Ebene {{Code|1}}. Im Bereich '''Liste der Bilder''' wird das Ergebnis dieser beiden Ebenen angezeigt, nämlich das folgende Zielbild "durchgestrichener Ordner":

[[Image:StrikeThroughFolder.png|center|Durchgestrichener Ordner]]

Das Bild {{Code|delete}} aus der Ebene {{Code|1}} wird über das Bild {{Code|folder}} aus der Ebene {{Code|0}} gezeichnet.

Die Eingabefelder '''Links''', '''Oben''', '''Breite''' und '''Höhe''' in einem Ebenenbereich legen die [[lib_de:FMX.ImgList.TLayer.SourceRect|Koordinaten eines Abschnitts des Bitmaps mit Mehrfachauflösung]] fest, der in der Ebene gespeichert ist. Diese Koordinaten haben in der Abbildung '''Bereich "Ausgewähltes Bild" für den "durchgestrichenen Ordner"''' für das Bild {{Code|delete}} die Werte {{Code|(0,0,16,16)}}. Setzen Sie nun für das Bild {{Code|delete}} '''Links''' auf {{Code|4}} und '''Oben''' auf {{Code|4}}. Klicken Sie auf '''Übernehmen'''. In der '''Strukturansicht''' werden nun die Koordinaten {{Code|(4,4,20,20)}} des Abschnitts für das Bild {{Code|delete}} angezeigt. Im Bereich '''Liste der Bilder''' hat sich das Zielbild "durchgestrichener Ordner" geändert. Das Bild "durchgestrichener Ordner" wurde nach links oben verschoben:

[[Image:StrikeThroughFolder Moved.png|center|"Durchgestrichener Ordner" wurde verschoben]]

Um zu zeigen, wie Koordinaten des Abschnitts eines Bitmaps mit Mehrfachauflösung verwendet werden können, doppelklicken Sie auf das Bild "durchgestrichen". Der '''MultiResBitmap-Editor''' wird geöffnet:

[[Image:MultiResBitmapEditor Section.png|center|400px|Im MultiResBitmap-Editor anzuzeigender Abschnitt]]

Diese Abbildung zeigt, welcher Abschnitt des "durchgestrichen"-Bildes in der Ebene gezeichnet wird. Klicken Sie in das Auswahlrechteck, das den anzuzeigenden Abschnitt angibt. Versuchen Sie, die Größe des Auswahlrechtecks zu ändern. Versuchen Sie, das Auswahlrechteck zu verschieben, und beachten Sie die entsprechenden Änderungen der Eigenschaften '''Links''', '''Oben''', '''Breite''' und '''Höhe''' des Auswahlrechtecks (in der Ebene im Bereich '''Ausgewähltes Bild''') und die Änderungen des Vorschaubildes im Bereich '''Liste der Bilder'''.

Die Funktionen der Schaltflächen in der Symbolleiste des Bereichs '''Ausgewähltes Bild''' sind weitgehend selbsterklärend. [[File:New.png]] – Fügt dem Bereich '''Ausgewähltes Bild''' eine neue Ebene hinzu. [[File:Action delete.jpg]] – Löscht die ausgewählte Ebene aus dem Bereich '''Ausgewähltes Bild'''. Die Pfeile [[File:Arrow up.jpg]] und [[File:Arrow down.jpg]] verschieben die ausgewählte Ebene nach oben bzw. unten und ändern so die Reihenfolge der Ebenen. Dies kann nützlich sein, weil das Bild in einer Ebene mit einer höheren Nummer über Bilder aus vorherigen Ebenen gezeichnet wird.

==Grundlegende Klassen von TImageList==

Die Informationen über grundlegende Merkmale und Funktionen der Bilderlistenklassen können für die Entwicklung benutzerdefinierter Komponenten, die Bilderlisten verwenden, sehr hilfreich sein.

===Unit "System.ImageList"===

Ab Version XE8 stellt {{Product}} die neue RTL-Unit [[lib_de:System.ImageList|System.ImageList]] bereit. [[lib_de:System.ImageList|System.ImageList]] enthält die Gemeinsamkeiten für {{FM}}- und VCL-Code und implementiert die grundlegendsten geräteunabhängigen Funktionen von Bilderlisten.
[[lib_de:System.ImageList|System.ImageList]] enthält den Code zur Unterstützung der Interaktion zwischen Bildern in einer Bilderliste und deren Verwendung in Komponenten (wie Steuerelemente, Menüeinträge usw.).

Die Unit [[lib_de:System.ImageList|System.ImageList]] definiert die Klassen [[lib_de:System.ImageList.TBaseImageList|TBaseImageList]] und [[lib_de:System.ImageList.TImageLink|TImageLink]].

====Klasse "TBaseImageList"====

Die Klasse [[lib_de:System.ImageList.TBaseImageList|TBaseImageList]]stellt Methoden und Eigenschaften für die Behandlung von Interaktionen zwischen einer Bilderliste und allen GUI-Komponenten bereit, die Bilder aus dieser Bilderliste verwenden.
{{f|vcl|
Ab der Version {{Product}} XE8 erben die Klassen [[lib_de:FMX.ImgList.TCustomImageList|FMX.ImgList.TCustomImageList]] und [[lib_de:Vcl.ImgList.TCustomImageList|Vcl.ImgList.TCustomImageList]] diese [[lib_de:System.ImageList.TBaseImageList|TBaseImageList]]-Klasse.}}

====Klasse "TImageLink"====

Ein [[lib_de:System.ImageList.TBaseImageList|TBaseImageList]]-Bilderlisten-Objekt sendet mit [[lib_de:System.ImageList.TImageLink|TImageLink]]-Objekten Benachrichtigungen über Änderungen, die in dem Bilderlisten-Objekt aufgetreten sind, an Komponenten, die das Bilderlisten-Objekt verwenden.

Wenn Änderungen der Eigenschaft [[lib_de:System.ImageList.TImageLink.ImageIndex|ImageIndex]] oder [[lib_de:System.ImageList.TImageLink.Images|Images]] aufgetreten sind, dann ruft das [[lib_de:System.ImageList.TImageLink|TImageLink]]-Objekt die virtuelle Methode [[lib_de:System.ImageList.TImageLink.Change|Change]] auf. Beachten Sie, dass jede Änderung in [[lib_de:System.ImageList.TBaseImageList|TBaseImageList]] zur Änderung von [[lib_de:System.ImageList.TImageLink.Images|Images]] führt.

Damit Ihre Komponente eine adäquate Reaktion auf Änderungen in einer Bilderliste bereitstellen kann, muss Ihre Komponente eine Instanz eines [[lib_de:System.ImageList.TImageLink|TImageLink]]-Nachkommens enthalten. Dieser [[lib_de:System.ImageList.TImageLink|TImageLink]]-Nachkomme muss korrekte '''Images'''- und '''ImageIndex'''-Eigenschaften haben und die Methode [[lib_de:System.ImageList.TImageLink.Change|Change]] überschreiben, oder die Ereignisbehandlungsroutine [[lib_de:System.ImageList.TImageLink.OnChange|OnChange]] muss definiert sein.

[[lib_de:System.ImageList.TBaseImageList|TBaseImageList]] enthält die Array-Eigenschaft [[lib_de:System.ImageList.TBaseImageList.Links|Links]], die [[lib_de:System.ImageList.TImageLink|TImageLink]]-Instanzen enthält. Wenn Sie die Eigenschaft [[lib_de:System.ImageList.TImageLink.Images|TImageLink.Images]] auf eine Komponente setzen, dann wird diese Bilderliste diesem [[lib_de:System.ImageList.TBaseImageList.Links|Links]]-Array hinzugefügt.
Nach Änderungen von [[lib_de:System.ImageList.TImageLink.Images|Images]] oder [[lib_de:System.ImageList.TImageLink.ImageIndex|ImageIndex]] übernehmen Nachkommen von [[lib_de:System.ImageList.TBaseImageList|TBaseImageList]] sequenziell alle Bildverknüpfungsobjekte aus dem Array '''Links''' und rufen [[lib_de:System.ImageList.TImageLink.Change|Change]] für alle (oder nur für einige) dieser Bildverknüpfungen (Komponenten) auf.

''' Eigenschaft TImageLink.IgnoreIndex'''

Ist die Eigenschaft [[lib_de:System.ImageList.TImageLink.IgnoreIndex|IgnoreIndex]] {{True}}, dann wird [[lib_de:System.ImageList.TImageLink.Change|Change]] nicht ausgeführt, wenn ein Bild oder die Reihenfolge der Bilder in einer [[lib_de:System.ImageList.TBaseImageList|TBaseImageList]]-Bilderliste geändert wurde. Normalerweise gehen Benachrichtigungen ein, wenn ein Bild an einem Index geändert wird. Durch Setzen von [[lib_de:System.ImageList.TImageLink.IgnoreIndex|IgnoreIndex]] auf {{True}} werden derartige Benachrichtigungen unterdrückt. Diese Eigenschaft kann verwendet werden, wenn eine Anwendung die gesamte Bilderliste anzeigen muss, beispielsweise in einem Editorfenster.

'''Eigenschaft TImageLink.IgnoreImages'''

Ist die Eigenschaft [[lib_de:System.ImageList.TImageLink.IgnoreImages|IgnoreImages]] {{True}}, dann wird [[lib_de:System.ImageList.TImageLink.Change|Change]] nicht ausgeführt, wenn der [[lib_de:System.ImageList.TImageLink.Images|Images]]-Wert geändert wurde. {{f|vcl|Diese Eigenschaft wird aus Kompatibilitätsgründen mit VCL-Klassen verwendet, die Klassen aus [[lib_de:System.ImageList|System.ImageList]] erben.}}

===Unit "FMX.ImgList"===

Die Unit [[lib_de:FMX.ImgList|FMX.ImgList]] definiert die grundlegenden {{FM}}-Klassen, die {{FM}}-Bilderlisten implementieren.

====Klasse "FMX.ImgList.TCustomImageList"====

Die Komponente [[lib_de:FMX.ImgList.TCustomImageList|FMX.ImgList.TCustomImageList]] implementiert die Kernfunktionalität von {{FM}}-Bilderlisten. [[lib_de:FMX.ImgList.TImageList|FMX.ImgList.TImageList]] unterscheidet sich von der Klasse [[lib_de:FMX.ImgList.TCustomImageList|FMX.ImgList.TCustomImageList]] nur durch die Neudeklaration einiger Eigenschaften als '''Published'''. Im Fall von [[lib_de:FMX.ImgList.TImageList|FMX.ImgList.TImageList]] sind dies die folgenden '''Published'''-Eigenschaften: [[lib_de:FMX.ImgList.TImageList.Source|Source]], [[lib_de:FMX.ImgList.TImageList.Destination|Destination]], [[lib_de:FMX.ImgList.TImageList.OnChanged|OnChanged]] und [[lib_de:FMX.ImgList.TImageList.OnChange|OnChange]].

'''Eigenschaft TCustomImageList.Dormant'''

Die Eigenschaft [[lib_de:FMX.ImgList.TCustomImageList.Dormant|Dormant]] ist {{True}}, wenn die Eigenschaft [[lib_de:FMX.MultiResBitmap.TCustomBitmapItem.Dormant|Dormant]] aller Bitmaps mit Mehrfachauflösung in der Sammlung [[lib_de:FMX.ImgList.TCustomImageList.Source|Source]] {{True}} ist.

'''Eigenschaft TCustomImageList.CacheSize'''

Die Eigenschaft [[lib_de:FMX.ImgList.TCustomImageList.CacheSize|CacheSize]] gibt die maximale Anzahl an Bildern an, die im internen Zwischenspeicher des aktuellen [[lib_de:FMX.ImgList.TCustomImageList|TCustomImageList]]-Objekts gespeichert werden können.

Das Zeichnen jedes Bildes besteht aus mehreren Schritten mit ziemlichem Ressourcenaufwand. Um das Skalieren und Zeichnen mehrerer Ebenen zur Anzeige desselben Bildes in jedem betroffenen Steuerelement zu vermeiden, wird das generierte Bild in ein Array im internen Zwischenspeicher gesetzt und dann das fertige Bild aus diesem Zwischenspeicher-Array übernommen. Ein neu generiertes Bild wird an das Ende dieses Zwischenspeicher-Arrays angehängt, und alle vorhandenen Bilder werden um eine Position in Richtung des Anfangs des Arrays verschoben. Wenn die Anzahl der im Zwischenspeicher-Array zu speichernden Bilder die angegebene [[lib_de:FMX.ImgList.TCustomImageList.CacheSize|CacheSize]]-Anzahl an Bildern übersteigt, dann wird das älteste Bild aus dem Zwischenspeicher entfernt. Eine große [[lib_de:FMX.ImgList.TCustomImageList.CacheSize|CacheSize]]-Anzahl erhöht die Verarbeitungsgeschwindigkeit, aber auch den verwendeten Speicher. Die standardmäßige Maximalanzahl an im Zwischenspeicher-Array zu speichernder Bilder ist 8; die Minimalanzahl ist 1.

'''Methode TCustomImageList.ClearCache'''

[[lib_de:FMX.ImgList.TCustomImageList.ClearCache|ClearCache]] entfernt das durch die {{Arg|Index}}-Nummer angegebene Bild aus dem internen Zwischenspeicher-Array. Im Zwischenspeicher können mehrere Bilder mit derselben Nummer, aber mit unterschiedlicher Größe gespeichert sein. Wenn {{Arg|Index}} {{Code|-1}} (die Vorgabe) ist, dann werden alle Bilder aus dem Zwischenspeicher entfernt (der Zwischenspeicher wird geleert). Normalerweise wird [[lib_de:FMX.ImgList.TCustomImageList.ClearCache|ClearCache]] automatisch aufgerufen, wenn sich das [[lib_de:FMX.ImgList.TImageList|TImageList]]-Objekt ändert.

'''Methode TCustomImageList.BitmapExists'''

Die Methode [[lib_de:FMX.ImgList.TCustomImageList.BitmapExists|BitmapExists]] gibt {{True}} zurück, wenn ein Bild mit der angegebenen Nummer vorhanden ist und tatsächlich ein Bitmap enthält. Das heißt, wenn das angegebene Bild mindestens eine Ebene mit einem [[lib_de:FMX.ImgList.TLayer.Name|Namen]] eines vorhandenen [[lib_de:FMX.ImgList.TSourceItem|Quellbildes]] mit einem [[lib_de:FMX.ImgList.TLayer.SourceRect|zu zeichnenden Rechteck]] enthält, das über einen Schnittpunkt ungleich null mit dem Rechteck des Bildes verfügt.

Ein nicht vorhandenes Bild wird im [[Bilderlisten-Editor (FireMonkey)|Bilderlisten-Editor]] als leeres gestricheltes Rechteck angezeigt. Siehe das Bild mit der Nummer {{Code|9}} im Bereich '''Liste der Bilder''' in der Abbildung des [[#Verwenden des Bilderlisten-Editors|'''Bilderlisten-Editors''']] weiter oben. Wenn das [[lib_de:FMX.ImgList.TLayer.SourceRect|zu zeichnende Rechteck]] Grafikdaten enthält, aber all diese Grafiken transparent sind (siehe [[MultiResBitmap-Editor#Steuerelemente|Transparente Farbe]]), dann gibt die Methode [[lib_de:FMX.ImgList.TCustomImageList.BitmapExists|BitmapExists]] {{True}} zurück, aber diese Ebene zeichnet keine Grafiken. [[lib_de:FMX.ImgList.TCustomImageList.BitmapExists|BitmapExists]] wird in der Klasse [[lib_de:FMX.ImgList.TGlyph|TGlyph]] verwendet, um die Eigenschaft [[lib_de:FMX.ImgList.TGlyph.Visible|Visible]] festzulegen, wenn [[lib_de:FMX.ImgList.TGlyph.AutoHide|AutoHide]] {{True}} ist.

'''Methode TCustomImageList.Bitmap'''

Die Methode [[lib_de:FMX.ImgList.TCustomImageList.Bitmap|Bitmap]] gibt das im Zwischenspeicher gespeicherte [[lib_de:FMX.Graphics.TBitmap|TBitmap]]-Objekt zurück, das dem in {{Arg|Index}} angegebenen Bild entspricht und das die angegebene Größe {{Arg|Size}} hat.

Wenn das in {{Arg|Index}} angegebene Bild mit der Größe {{Arg|Size}} im Zwischenspeicher nicht vorhanden ist, dann versucht [[lib_de:FMX.ImgList.TCustomImageList.Bitmap|Bitmap]], ein passendes Bild zu erstellen und es dem Zwischenspeicher hinzuzufügen. Wenn kein {{Arg|Index}}-Bild in der [[lib_de:FMX.ImgList.TCustomImageList.Source|Source]]-Sammlung vorhanden ist oder [[lib_de:FMX.ImgList.TCustomImageList.Bitmap|Bitmap]] kein Bitmap mit der angegebenen Größe {{Arg|Size}} erstellen oder es dem Zwischenspeicher hinzufügen kann, dann gibt [[lib_de:FMX.ImgList.TCustomImageList.Bitmap|Bitmap]] {{Code|nil}} zurück.

Da Bilder im Zwischenspeicher von internen [[lib_de:FMX.ImgList.TCustomImageList|TCustomImageList]]-Funktionen erstellt und freigegeben werden, sollten Sie das zurückgegebene, im Zwischenspeicher gespeicherte [[lib_de:FMX.Graphics.TBitmap|TBitmap]]-Objekt nicht explizit freigeben oder versuchen, einen Verweis auf dieses Objekt zu speichern.

Wenn Sie nur ein Bild aus der [[lib_de:FMX.ImgList.TCustomImageList|TCustomImageList]]-Liste zeichnen müssen, verwenden Sie die Methode [[lib_de:FMX.ImgList.TCustomImageList.Draw|Draw]]. Wenn Sie das erhaltene [[lib_de:FMX.Graphics.TBitmap|TBitmap]]-Objekt tatsächlich für die zukünftige Verwendung speichern müssen, sollten Sie ein weiteres [[lib_de:FMX.Graphics.TBitmap|TBitmap]]-Objekt erstellen und mit [[lib_de:FMX.Graphics.TBitmap.Assign|Assign]] eine Kopie des erhaltenen [[lib_de:FMX.Graphics.TBitmap|TBitmap]]-Objekts erstellen.

'''Methode TCustomImageList.BitmapItemByName'''

Die Methode [[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] gibt {{True}} zurück, wenn ein Bild mit dem angegebenen {{Arg|Name}} in der [[lib_de:FMX.ImgList.TCustomImageList.Source|Source]]-Sammlung gefunden wird.

Wenn [[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] {{True}} zurückgibt, dann gibt {{Arg|Item}} das gefundene Bitmap für eine am besten für 1 geeignete Skalierung zurück, und {{Arg|Size}} gibt die [[lib_de:System.Types.TSize|Größe]] des zurückgegebenen Bitmaps zurück. Wenn [[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] {{False}} zurückgibt, dann werden {{Arg|Item}} und {{Arg|Size}} nicht geändert.

'''Methode TCustomImageList.UpdateImmediately'''

Die Methode [[lib_de:FMX.ImgList.TCustomImageList.UpdateImmediately|UpdateImmediately]] initiiert das unverzügliche Neuzeichnen aller Komponenten, die diese Bilderliste verwenden.

Wenn ein Bild geändert wird, dann sollten alle Komponenten, die dieses Bild verwenden, darüber benachrichtigt werden, dass sie ihr Bild aktualisieren müssen.
Standardmäßig werden solche Benachrichtigungen kurz nach den Änderungen gesendet, um ein mehrfaches Neuzeichnen beim Umgestalten einer Bilderliste zu vermeiden. Wenn während dieser Zeit mehrere Änderungen vorgenommen werden, wird nur eine Benachrichtigung gesendet, und Steuerelemente werden nur einmal neu gezeichnet.

'''Eigenschaft TCustomImageList.Source'''

Die Eigenschaft [[lib_de:FMX.ImgList.TCustomImageList.Source|Source]] enthält den Verweis auf die [[lib_de:FMX.ImgList.TSourceCollection|TSourceCollection]]-Sammlung mit den [[lib_de:FMX.ImgList.TCustomSourceItem|TCustomSourceItem]]-Quell-Bitmaps mit Mehrfachauflösung. Quellsammlungen werden von der Methode [[lib_de:FMX.ImgList.TCustomImageList.CreateSource|CreateSource]] erstellt. Sie können diese Methode überschreiben, um Sammlungen mit einem eigenen Typ zu erstellen. Die wichtige Methode von [[lib_de:FMX.ImgList.TSourceCollection|TSourceCollection]]-Quellsammlungen ist [[lib_de:FMX.ImgList.TSourceCollection.IndexOf|IndexOf]], die den Index des Bildes in den Quellsammlungen zurückgibt, das dem angegebenen {{Code|Name}} entspricht. Wird kein Bild gefunden, wird {{Code|nil}} zurückgegeben.

====Klasse "TCustomSourceItem"====

Die Klasse [[lib_de:FMX.ImgList.TCustomSourceItem|TCustomSourceItem]] definiert Elemente von [[lib_de:FMX.ImgList.TSourceCollection|TSourceCollection]]-Quellsammlungen. Jedes [[lib_de:FMX.ImgList.TCustomSourceItem|TCustomSourceItem]]-Objekt hat einen eindeutigen [[lib_de:FMX.ImgList.TCustomSourceItem.Name|Namen]] des Bildelements (ohne Berücksichtigung der Groß-/Kleinschreibung) in der [[lib_de:FMX.ImgList.TCustomImageList.Source|Source]]-Sammlung und eine [[lib_de:FMX.ImgList.TCustomSourceItem.MultiResBitmap|MultiResBitmap]]-Eigenschaft mit einem Bitmap mit Mehrfachauflösung, das die Menge der Bilder mit derselben Form für verschiedene Skalierungen enthält.

====Eigenschaft "TCustomImageList.Destination"====

Die Eigenschaft [[lib_de:FMX.ImgList.TCustomImageList.Destination|Destination]] enthält den Verweis auf die [[lib_de:FMX.ImgList.TDestinationCollection|TDestinationCollection]]-Sammlung mit den [[lib_de:FMX.ImgList.TCustomDestinationItem|TCustomDestinationItem]]-Elementen. Zielelemente enthalten Informationen, die zum Vorbereiten der zu zeichnenden Bilder benötigt werden. Zielsammlungen werden von [[lib_de:FMX.ImgList.TCustomImageList.CreateDestination|CreateDestination]] erstellt.

====Klasse "TCustomDestinationItem"====

[[lib_de:FMX.ImgList.TCustomDestinationItem|TCustomDestinationItem]]-Objekte sind Elemente von [[lib_de:FMX.ImgList.TDestinationCollection|TDestinationCollection]]-Sammlungen. Jedes [[lib_de:FMX.ImgList.TCustomDestinationItem|TCustomDestinationItem]]-Element enthält die [[lib_de:FMX.ImgList.TCustomDestinationItem.Layers|Layers]]-Sammlung mit [[lib_de:FMX.ImgList.TLayer|TLayer]]-Elementen. [[lib_de:FMX.ImgList.TCustomDestinationItem.Layers|Layers]] wird mit [[lib_de:FMX.ImgList.TCustomDestinationItem.CreateLayers|CreateLayers]] erstellt. Die Funktion [[lib_de:FMX.ImgList.TCustomDestinationItem.LayersCount|LayersCount]] gibt die Anzahl der nicht leeren Ebenen zurück. Beachten Sie den Unterschied zur Eigenschaft [[lib_de:System.Classes.TCollection.Count|TLayers.Count]], die die Gesamtanzahl der Ebenen in der Ebenen-Sammlung enthält.

====Klasse "TLayers"====

Die [[lib_de:FMX.ImgList.TLayers|TLayers]]-Sammlung enthält [[lib_de:FMX.ImgList.TLayer|TLayer]]-Ebenen. Bei der Generierung der fertigen Bilder werden Bitmaps mit den am besten passenden Skalierungen aus allen sichtbaren Ebenen beginnend mit der Ebene 0 bis zur letzten Ebene [[lib_de:System.Classes.TCollection.Count|Count]] sequenziell gezeichnet.

====Klasse "TLayer"====

Die Ebene [[lib_de:FMX.ImgList.TLayer|TLayer]] enthält Informationen über ein Quellbild, das beim Zeichnen eines fertigen Bildes verwendet wird.

'''Eigenschaft TLayer.MultiResBitmap'''

Die Eigenschaft [[lib_de:FMX.ImgList.TLayer.MultiResBitmap|MultiResBitmap]] enthält ein [[lib_de:FMX.ImgList.TLayer.MultiResBitmap|Bitmap mit Mehrfachauflösung]] aus der [[lib_de:FMX.ImgList.TImageList.Source|Source]]-Sammlung.

'''Eigenschaft TLayer.Name'''

Die Eigenschaft [[lib_de:FMX.ImgList.TLayer.Name|Name]] enthält den Namen (ohne Berücksichtigung der Groß-/Kleinschreibung) eines Bildes aus der [[lib_de:FMX.ImgList.TImageList.Source|Source]]-Sammlung. Die Funktion [[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] gibt das [[lib_de:FMX.ImgList.TLayer.MultiResBitmap|Bitmap mit Mehrfachauflösung]] mit dem [[lib_de:FMX.ImgList.TLayer.Name|Namen]] in der [[lib_de:FMX.ImgList.TCustomImageList.Source|Source]]-Sammlung zurück.

'''Eigenschaft TLayer.SourceRect'''

Die Eigenschaft [[lib_de:FMX.ImgList.TLayer.SourceRect|SourceRect]] enthält die [[lib_de:FMX.ImgList.TLayer.SourceRect|Koordinaten eines Abschnitts dieses Bitmaps mit Mehrfachauflösung]] (immer in der Skalierung 1, unabhängig von der Skalierung des zu verwendenden Bitmaps). Nur dieser Abschnitt des Bitmaps mit Mehrfachauflösung wird im fertigen Bild gezeichnet.

==Codebeispiel "FMX.TImageList"==

Sehen Sie sich das [http://youtu.be/oAEHD44BnQQ Video, das Funktionen aus dem "Beispiel FMX.ImageList" demonstriert], an.

Im Folgenden werden typische Codefragmente aus dem [[samp_en:FMX.ImageList Sample|Beispiel FMX.ImageList]] behandelt, das als Muster für die Verwendung von Bilderlisten dient, mit deren Hilfe Standardoperationen mit Bilderlisten programmiert werden.

Öffnen Sie das Projekt '''ImageListDemo.dproj''', wie im [[samp_en:FMX.ImageList Sample|Beispiel FMX.ImageList]] beschrieben. Rufen Sie den [[rad_de:Formular-Designer|Formular-Designer]] mit dem Modul '''UnitMain''' auf, und öffnen Sie die Registerkarte '''Bitmap and Image'''. Diese Registerkarte enthält mehrere Steuerelemente, die Bilder aus der Bilderliste verwenden. Hier wird die Codeimplementierungsfunktionalität der Schaltflächen '''[[#Ereignisbehandlungsroutine der Schaltfläche "Add New Source"|Add New Source]]''' und '''[[#Ereignisbehandlungsroutine der Schaltfläche "Update Text"|Update Text]]''' und der Pfeilschaltflächen '''Right''' und '''Left''' besprochen, die das nächste bzw. vorherige Bild aus der {{Code|ImageList1}}-Bilderliste auf den Titel '''None''' der Registerkarte '''None''' zeichnen. Der Code für die Pfeilschaltflächen '''Right''' und '''Left''' zeigt, [[#Verwenden von Bilderlisten in Steuerelementen|wie ein Bild aus einer Bilderliste auf die Oberfläche Ihres Steuerelements gezeichnet wird]].

Um den Code zur Behandlung eines Steuerelements im '''Quelltext-Editor''' zu öffnen, doppelklicken Sie im '''Formular-Designer''' einfach auf dieses Steuerelement.

===Ereignisbehandlungsroutine der Schaltfläche "Add New Source"===

Doppelklicken Sie im '''Formular-Designer''' auf die Schaltfläche '''Add New Source'''. Der '''Quelltext-Editor''' zeigt die '''ActnAddSourceExecute'''-Implementierung der Methode an. '''ActnAddSourceExecute''' ist die '''OnClick'''-Ereignisbehandlungsroutine für die Schaltfläche '''Add New Source'''. '''ActnAddSourceExecute''' ruft {{Code|AddSourceToItem(9)}} auf. Der Kern von '''ActnAddSourceExecute''' ist die interne Methode 

:<code>DrawPicture(Canvas: TCanvas; R: TRectF; Scale: Single)</code> 

Diese Methode zeichnet einfach ein Bild auf das angegebene {{Code|Canvas}}. Weiterer Code von {{Code|AddSourceToItem(9)}} bereitet Parameter für den Aufruf von {{Code|DrawPicture}} vor. Die Methode {{Code|AddSourceToItem(9)}} weist den angegebenen Parameterwert {{Code|9}} dem {{Code|ImageIndex}} des neuen in {{Code|ImageList1}} eingefügten Bildes zu. Das heißt <code>ImageIndex=9</code>. Zuerst überprüft {{Code|AddSourceToItem}}, ob das Bild in der '''Destination'''-Sammlung mit dem <code>ImageIndex=9</code> über mindestens eine '''Ebene (Layer)''' verfügt. Falls nicht, wird die '''Ebene''' 0 erstellt. Wenn die '''Ebene''' 0 ein Bild enthält, dann wird das Bild in der Variable {{Code|SourceName}} gespeichert: 

:<code>SourceName := Layer.Name;</code> 

[[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] wird aufgerufen 

:<code>MainDataModule.ImageList1.BitmapItemByName(SourceName, Item, Size)</code> 

um ein Element abzurufen, das dem angegebenen {{Code|SourceName}}-Namen aus der Sammlung '''Source''' entspricht. Bei Erfolg wird davon ausgegangen, dass das Bild bereits hinzugefügt wurde, und es wird nichts ausgeführt. Ansonsten wird der Sammlung '''Source''' ein neues Bild hinzugefügt. Wenn die '''Ebene''' vorhanden ist und den {{Code|SourceName}}-Namen enthält, dann wird der {{Code|SourceName}}-Name den hinzugefügten Bild zugewiesen. Andernfalls wird der Standardname verwendet.

Jetzt werden zyklisch mehrere Bilder für unterschiedliche Skalierungen erstellt. Ein neues Element wird in '''TMultiResBitmap''' eingefügt und dessen Standardskalierung ermittelt: 

:<code>S := Item.Scale;</code> 

Mit {{Code|S}} und '''SourceRect''' der '''Ebene''' wird die Größe des '''Quellbildes''' berechnet: 

:<code>Size.cx := Round(Layer.SourceRect.Width * S);</code> 

Anschließend wird dieses Bild mit der transparenten Farbe gefüllt 

:<code>Item.Bitmap.Clear(TAlphaColorRec.Null);</code> 

und ein Bild gezeichnet: 

:<code>DrawPicture(Item.Bitmap.Canvas, R, S);</code> 

:
:: '''Hinweis:''' Öffnen Sie die Unit '''UnitDataModule''' im [[Formular-Designer|Formular-Designer]], und doppelklicken Sie auf das Bild {{Code|ImageList1}}. Im Bereich '''Liste der Bilder''' sehen Sie, dass das Bild mit dem <code>ImageIndex=9</code> leer ist.

Mit der aktuellen Implementierung wird durch Klicken auf '''Add New Source''' das neue Bild mit dem <code>ImageIndex=9</code> in die Bilderliste {{Code|ImageList1}} eingefügt.

'''So überprüfen Sie die Funktionalität der Schaltfläche "Add New Source":'''

# Lesen Sie, wie das [[samp_en:FMX.ImageList Sample|Beispiel FMX.ImageList]] verwendet wird.
# Wählen Sie in der Anwendung ''' Demo of images''' die Registerkarte '''Bitmap and Image''' aus.
# Klicken Sie wiederholt auf die Pfeilschaltfläche '''Right'''. Die Bilder aus der Bilderliste {{Code|ImageList1}} werden sequenziell auf den Titel '''None''' der Registerkarte '''None''' gezeichnet.
# Wenn Sie zum neunten Mal auf die Pfeilschaltfläche '''Right''' klicken, wird der folgende Text in der Beschriftung {{Code|Label1}} angezeigt: 

:
::
:::<code>Images: 'ImageList1': Counts 11 </code> 
:::<code>ImageIndex: 9; Width 16; Height 16 </code>
:: und das leere Bild auf den Titel '''None''' gezeichnet (es wird kein Bild gezeichnet).

<ol start="5"><li> Klicken Sie auf der Registerkarte '''Bitmap and Image''' auf '''Add New Source'''. Das Bild mit dem <code>ImageIndex=9</code> wird der {{Code|ImageList1}} hinzugefügt.</li>
<li>Das hinzugefügte Bild erscheint auf dem Titel '''None'''.</li>
</ol>

===Ereignisbehandlungsroutine der Schaltfläche "Update Text"===

Doppelklicken Sie im '''Formular-Designer''' auf die Schaltfläche '''Update Text'''. Der '''Quelltext-Editor''' zeigt die '''ActnUpdateTextExecute'''-Implementierung der Methode an. '''ActnUpdateTextExecute''' ist die '''OnClick'''-Ereignisbehandlungsroutine für die Schaltfläche '''Update Text'''.

Der zu zeichnende Text wird aus dem Integerfeld {{Code|FNumber}} ermittelt, indem es in die String-Repräsentation {{Code|FNumber.[[lib_de:System.SysUtils.TIntegerHelper.ToString|ToString]]}} konvertiert wird. Jeder Klick auf '''Update Text''' erhöht den Wert dieses Feldes um {{Code|Inc(FNumber)}}.

'''ActnUpdateTextExecute''' ruft Folgendes auf 

: <code>DrawTextOnLayer(8,FNumber.ToString)</code> 

Hier gibt der erste Parameter {{Code|8}} den Index des Bildes in der '''Destination'''-Sammlung der {{Code|ImageList1}}-Bilderliste an, das geändert werden soll.

:
:: '''Hinweis:''' Öffnen Sie die Unit '''UnitDataModule''' im [[Formular-Designer|Formular-Designer]], und doppelklicken Sie auf das Bild {{Code|ImageList1}}. Klicken Sie im Bereich '''Liste der Bilder''' auf das Bild mit dem <code>ImageIndex=8</code>. Im Bereich '''Ausgewähltes Bild''' sehen Sie, dass dieses Bild zwei '''Ebenen''' enthält. Die Ebene {{Code|0}} ist leer, und die Ebene {{Code|1}} enthält das '''TMultiResBitmap''' mit dem '''Namen''' {{Code|mail}}, das einen Umschlag darstellt:

[[Image:ImageListEditor Image8.png|200px|center|Bild 8]]

Der zweite Parameter {{Code|FNumber.ToString}} gibt den zu zeichnenden Text an.

{{Code|DrawTextOnLayer}} entspricht weitgehend {{Code|DrawPicture}}. Zuerst überprüft {{Code|DrawTextOnLayer}}, ob das Bild in der '''Destination'''-Sammlung mit dem <code>ImageIndex=8</code> über mindestens eine '''Ebene (Layer)''' verfügt. Anschließend wird überprüft, ob die oberste '''Ebene''' ein Bild enthält, und dann wird das Bild in der Variable {{Code|SourceName}} gespeichert: 

:<code>SourceName := Layer.Name;</code> 

[[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] wird aufgerufen 

:<code>MainDataModule.ImageList1.BitmapItemByName(SourceName, Item, Size)</code> 

um ein Element abzurufen, das dem angegebenen {{Code|SourceName}}-Namen aus der Sammlung '''Source''' entspricht.

Wenn [[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] kein Element mit dem {{Code|SourceName}} entsprechenden Namen ermittelt, wird ein neues '''Quellelement''' hinzugefügt: 

:<code>NewSource := MainDataModule.ImageList1.Source.Add;</code> 

Diesem Element wird der Name {{Code|SourceName}} zugewiesen: 

:<code>NewSource.Name := SourceName;</code> 

Dann wird versucht, {{Code|Item}} abzurufen: 

:<code>Item := NewSource.MultiResBitmap.ItemByScale(1, False, True);</code> 

Wenn {{Code|Item}} nicht vorhanden ist, dann wird der '''MultiResBitmap'''-Sammlung ein neues Element hinzugefügt: 

:<code>Item := NewSource.MultiResBitmap.Add;</code> 

und dessen Größe festgelegt: 

:<code>Item.Bitmap.SetSize(Size.cx, Size.cy);</code> 

Entsprechend 

:<code>Size.cx := Round(Layer.SourceRect.Rect.Width);</code> 
:<code>Size.cy := Round(Layer.SourceRect.Rect.Height);</code> 

Danach oder wenn [[lib_de:FMX.ImgList.TCustomImageList.BitmapItemByName|BitmapItemByName]] erfolgreich war, zeichnet {{Code|DrawTextOnLayer}} den {{Code|Text}} (gleich {{Code|FNumber.ToString}}) auf das erhaltene Bild: 

:<code>Item.Bitmap.Canvas.FillText(</code> 
:<code> TRectF.Create(1,0,Size.cx - 1,Size.cy div 2),</code> 
:<code> Text, False, 1, [], TTextAlign.Center, TTextAlign.Center);</code> 

Mit der aktuellen Implementierung wird durch Klicken auf '''Update Text''' eine Zahl auf das Bild mit dem <code>ImageIndex=8</code> in die Bilderliste {{Code|ImageList1}} gezeichnet. Mit jedem Klick wird die gezeichnete Zahl um {{Code|1}} erhöht.

'''So überprüfen Sie die Funktionalität der Schaltfläche "Update Text":'''

# Wählen Sie in der Anwendung ''' Demo of images''' die Registerkarte '''Bitmap and Image''' aus.
# Klicken Sie wiederholt auf die Pfeilschaltfläche '''Right'''. Die Bilder aus der Bilderliste {{Code|ImageList1}} werden sequenziell auf den Titel '''None''' der Registerkarte '''None''' und in das {{Code|Glyph1}}-Steuerelement gezeichnet.
# Wenn Sie zum achten Mal auf die Pfeilschaltfläche '''Right''' klicken, wird das Umschlag-Bild mit dem <code>ImageIndex=8</code> gezeichnet.
# Die folgende Abbildung zeigt, dass der String {{Code|4}} auf das Bild im Titel '''None''' und in das {{Code|Glyph1}}-Steuerelement gezeichnet wurde.

[[Image:Glyph with 4.png|center|Umschlag mit einer darüber gezeichneten 4]]

===Verwenden von Bilderlisten in Steuerelementen===

Im Folgenden wird erläutert, wie Bilder aus einer Bilderliste auf die Oberfläche Ihrer Steuerelemente gezeichnet werden. Ähnlich können Sie beim Erstellen Ihrer eigenen Steuerelemente mit Bildern aus Bilderlisten verfahren.

Dieses Beispiel zeichnet Bilder aus der Bilderliste {{Code|ImageList1}} auf die Oberfläche des vierten Registerkarten-Steuerelements auf den Titel '''None'''. Um dies anzuzeigen, klicken Sie wiederholt auf die Pfeilschaltfläche '''Right''' oder '''Left'''. Die Bilder aus der Bilderliste {{Code|ImageList1}} werden sequenziell auf den Titel '''None''' gezeichnet.

'''Funktionsweise des Zeichnens von Bildern'''

Im {{Code|TMainForm.Create}}-Konstruktor des Formulars wird das Feld {{Code|FImageLink}} mit dem Typ [[lib_de:System.ImageList.TImageLink|TImageLink]] erstellt. Dann weist 

: <code>FImageLink.Images := MainDataModule.ImageList1;</code> 

diesem Feld die Bilderliste {{Code|ImageList1}} zu. Anschließend wird die Ereignisbehandlungsroutine {{Code|OnImagesChange}} für das Ereignis {{Code|OnChange}} zugewiesen. {{Code|OnImagesChange}} wird ausgeführt, wenn das Programm ein Bild auf einem Steuerelement mit der Bilderliste {{Code|ImageList1}} zeichnen muss. {{Code|OnImagesChange}} kann folgendermaßen aussehen:

: <code>... TabItem4.Repaint; ...</code>

Das Zeichnen eines Bildes wird von der Ereignisbehandlungsroutine {{Code|TabItem4Paint}} der Ereignisbehandlungsroutine '''OnPaint''' des Registerkarten-Steuerelements {{Code|TabItem4}} durchgeführt:
<source lang="delphi">
procedure TMainForm.TabItem4Paint(Sender: TObject; Canvas: TCanvas;
const ARect: TRectF);
var
R: TRectF;
begin
R := TRectF.Create(ARect.Right - 22, 4, ARect.Right - 6, 20);
MainDataModule.ImageList1.Draw(TabItem4.Canvas, R,
Glyph1.ImageIndex);
end; </source>

Hier ist {{Code|R}} das Rechteck auf dem Registerkarten-Steuerelement {{Code|TabItem4}}, in das das Bild gezeichnet wird. [[lib_de:FMX.ImgList.TCustomImageList.Draw|Draw]] zeichnet das {{Code|Glyph1.ImageIndex}}-Bild in {{Code|R}} auf die angegebene {{Code|TabItem4.Canvas}}-Zeichenfläche.

Sie können auch Nachkommen von {{Code|TImageLink}} ableiten, in denen die Methode [[lib_de:System.ImageList.TImageLink.Change|Change]] überschrieben werden soll, anstatt die Ereignisbehandlungsroutine {{Code|OnChange}} zu erstellen.

:
:: '''Hinweis:''' Vergessen Sie nicht das erstellte {{Code|FImageLink}}-Feld im Destruktor freizugeben. Verwenden Sie dazu die Methode [[lib_de:System.TObject.DisposeOf|DisposeOf]].

Wenn Ihr Steuerelement die Verwendung von [[FireMonkey-Aktionen|Aktionen]] unterstützt, dann unterstützt dieses Steuerelement wahrscheinlich das Interface [[lib_de:FMX.ActnList.IGlyph|IGlyph]]. In diesem Fall sollten Sie ein [[lib_de:FMX.ImgList.TGlyphImageLink|TGlyphImageLink]]-Objekt erstellen, das die Methode [[lib_de:FMX.ActnList.IGlyph.ImagesChanged|ImagesChanged]] aufruft. Dann müssen Sie die Ereignisbehandlungsroutine {{Code|OnChange}} nicht zuweisen.

Die Eigenschaften '''ImageIndex''' und '''Images''' Ihres Steuerelements müssen korrekte Werte haben. Normalerweise werden Eigenschaften mit dem folgenden Stil verwendet:

<source lang="delphi">
property ImageIndex: TImageIndex read GetImageIndex write SetImageIndex
stored ImageIndexStored;
…
function TMyControl.GetImageIndex: TImageIndex;
begin
Result := FImageLink.ImageIndex;
end;

procedure TGlyph.SetImageIndex(const Value: TImageIndex);
begin
FImageLink.ImageIndex := Value;
end;
</source>

==Siehe auch==

* [[Bilderlisten-Editor (FireMonkey)|Bilderlisten-Editor (FireMonkey)]]
* [http://youtu.be/IZfG2S9KGcU Video, das zeigt, wie mit dem Bilderlisten-Editor eine Bilderliste erstellt und bearbeitet wird (EN)] Es werden einige fortgeschrittene und wichtige Leistungsmerkmale des Bilderlisten-Editors demonstriert.

* [http://youtu.be/QI_dwMWtpuc Video, das die typischen Schritte beim Erstellen einer neuen Bilderliste in einem FireMonkey-Projekt demonstriert (EN)]

* [[samp_en:FMX.ImageList Sample|FMX.ImageList (Beispiel)]]
* [http://youtu.be/oAEHD44BnQQ Video, das Funktionen aus dem "Beispiel FMX.ImageList" demonstriert (EN)]

* [[Verwenden von Bitmaps mit Mehrfachauflösung|Verwenden von Bitmaps mit Mehrfachauflösung]]
* [[MultiResBitmap-Editor|MultiResBitmap-Editor]]
* [http://youtu.be/oFl925XuFgc Video, das die typische Verwendung des MultiResBitmap-Editors demonstriert (EN)]

[[en:Using TImageList Image Lists as Centralized Collections of Images]]
[[fr:Utilisation des listes d'images de TImageList en tant que collections centralisées d'images]]
[[ja:画像の一元的なコレクションとしての TImageList 画像リストの使用]]

Verwenden des Experten für neue Komponenten

2016-06-24T10:54:12Z

Esabatell: Updated. LOC-22885

{{Parent|Neue Komponente}}

{{f| radstudio | Mit dem Experten {{menu | Komponente > [[Neue Komponente|Neue Komponente]]}} können Sie entweder eine VCL-Komponente oder eine neue {{FM}}-Komponente für Ihre Anwendung erstellen. }}
{{f| appmethod | Mit dem Experten {{menu | Komponente > [[Neue Komponente|Neue Komponente]]}} können Sie eine neue {{FM}}-Komponente für Ihre Anwendung erstellen. }}
Wenn ein Projekt geöffnet ist oder Sie ein Produkt mit nur einer Personality ausführen, ermittelt der Experte die Personality und erstellt den passenden Komponententyp ({{Delphi}} oder C++).

==Übersicht: Schritte bei der Erstellung einer neuen Komponente==

# [[#Ein Skeleton-Package erstellen (optional)|Erstellen Sie ein neues Skeleton-Package]] (dieser Schritt ist optional, wird aber empfohlen).
# [[#Den Experten starten und die Personality, das Framework und die Plattform festlegen|Starten Sie den Experten, und geben Sie '''Personality, Framework und Plattform''' an]].
# [[#Vorfahrkomponente auswählen|Wählen Sie auf der Seite '''Vorfahrkomponente''' eine Vorfahrkomponente aus]].
# [[#Klassennamen und andere Eigenschaften festlegen|Legen Sie auf der Seite '''Komponente''' einen Klassennamen und andere Eigenschaften fest]].
#[[#Unit erstellen und installieren|Wählen Sie eine Methode zum Erstellen und Installieren der Unit aus]]:
#* '''Unit anlegen''' auf der Seite '''Unit erstellen'''
#* '''In vorhandenes Package installieren''' auf der Seite '''Vorhandenes Package'''
#* '''In neues Package installieren''' auf der Seite '''Neues Package'''
#* Fügen Sie die Unit zu einem Skeleton-Package hinzu, das Sie vor dem Start des Experten in dem aktuellen Projekt erstellt haben.

:'''Hinweis:''' Weitere Informationen zum Erstellen von Win64-Komponenten finden Sie unter '''[[Neue Komponente|Neue Komponente]]'''.

===Ein Skeleton-Package erstellen (optional)===

# Erstellen Sie durch Auswahl von {{menu | Datei > Neu > Weitere > {{Delphi}}- oder C++-Projekte}} ein neues Skeleton-Package für die neue Komponente.
# Doppelklicken Sie auf das Symbol '''Package'''. Mit diesem Schritt wird der '''[[Projektverwaltung|Projektverwaltung]]''' ein neues Package-Projekt hinzugefügt und die Option '''Unit dem Projekt <Mein_neues_Package> hinzufügen''' auf der Seite '''Unit anlegen''' des Experten aktiviert.

===Den Experten starten und die Personality, das Framework und die Plattform festlegen===

Die Seite '''Personality, Framework und Plattform''' des Experten wird nur angezeigt, wenn Sie den Experten ohne in der IDE geöffnetes Projekt starten.

:1. Wählen Sie in der IDE einen der folgenden Befehle:
:* {{menu | Komponente > [[Neue Komponente|Neue Komponente]]}}
:* {{menu | Datei > Neu > Weitere > {{Delphi}}-Projekte > {{Delphi}}-Dateien > Komponente > {{Delphi}}-Dateien}}
:* {{menu | Datei > Neu > Weitere > {{CBuilderUI}}-Projekte > {{CBuilderUI}}-Dateien > Komponente > C++-Dateien}} {{f| radstudio |
:2. Wenn die erste Seite des Experten '''Neue Komponente''' (die Seite '''Personality, Framework und Plattform''') angezeigt wird, wählen Sie die Personality ({{Delphi}} oder C++), das Framework (Bibliothek) und die gewünschte Plattform aus. Wählen Sie eine der folgenden Optionen:
:*'''VCL für C++''' oder '''VCL für {{Delphi}}'''
:*: VCL wird nur auf Windows unterstützt.}}

{{f| appmethod | :2. Wenn Sie die erste Seite des Experten '''Neue Komponente''' (Seite '''Personality, Framework und Plattform''') sehen, wählen Sie die gewünschte Personality ({{Delphi}} oder C++) aus. Wählen Sie eine der folgenden Optionen:}}

:
:*'''{{FM}} für C++''' oder '''{{FM}} für {{Delphi}}'''
:*: {{Delphi}} unterstützt {{FM}} auf Win32, Win64, OS X, 32-Bit- und 64-Bit-iOS-Gerät, iOS-Simulator und Android.
:*: {{CBuilderUI}} unterstützt {{FM}} auf Win32, Win64, OS X, 32-Bit- und 64-Bit-iOS-Gerät, iOS-Simulator und Android.
:* Klicken Sie auf '''Weiter'''. Die Seite '''Vorfahrkomponente''' wird angezeigt.

===Vorfahrkomponente auswählen===

# Sehen Sie sich auf der Seite '''Vorfahrkomponente''' die Liste aller Komponenten und den Namen der Unit an, die die jeweilige Komponente definiert. Wählen Sie eine Vorfahrkomponente in der Liste aus.
# Klicken Sie auf '''Weiter'''. Die Seite '''Komponente''' wird angezeigt.

===Klassennamen und andere Eigenschaften festlegen===

# Auf der Seite '''Komponente''' enthalten die folgenden Felder bereits Einträge:
#* '''Klassenname'''
#* '''Palettenseite'''
#* '''Unit-Name'''
#* '''Suchpfad'''
#: Sie können diese Standardwerte übernehmen oder die Werte ändern. Wenn Sie die Standardwerte übernehmen möchten, fahren Sie mit dem letzten Schritt dieser Anleitung fort.
# Um den Standardklassennamen zu ändern, geben Sie den gewünschten Namen in das Textfeld '''Klassenname''' ein.
# Um die Standardpalettenseite für die Komponente zu ändern, geben Sie den gewünschten Namen in das Textfeld '''Palettenseite''' ein oder klicken auf den nach unten weisenden Pfeil, um eine Palettenseite auszuwählen.
# Im Textfeld '''Unit-Name''' können Sie den vollständigen Pfad des Unit-Namens eingeben oder bearbeiten. Klicken Sie auf [...], um die gewünschte Unit auszuwählen.
# Geben Sie den Suchpfad in das Textfeld '''Suchpfad''' ein, oder ändern Sie ihn. Der Standardsuchpfad ist der für den Bibliothekspfad auf der folgenden Seite festgelegte Wert:
#* {{menu | Tools > Optionen > Umgebungsoptionen > C++-Optionen > [[Pfade und Verzeichnisse (C++)|Pfade und Verzeichnisse (C++)]]}}
#* {{menu | Tools > Optionen > Umgebungsoptionen > {{Delphi}}-Optionen > [[Bibliothek|Bibliothek]]}} ({{Delphi}})
# Klicken Sie auf '''Weiter'''. Die Seite '''Unit erstellen''' des Experten wird geöffnet.

===Unit erstellen und installieren===

:Auf der Seite '''Unit anlegen''' finden Sie vier Optionen:
:* '''Unit erstellen'''
:* '''In vorhandenes Package installieren'''
:* '''In neues Package installieren'''
:* '''Unit dem Projekt <Mein_neues_Package> hinzufügen''' (diese Option wird nur angezeigt, wenn Sie vor dem Start des Experten ein neues Package erstellt haben)
:'''So erstellen Sie eine Unit:'''
:# Wählen Sie auf der Seite '''Unit erstellen''' das Optionsfeld '''Unit anlegen'''.
:# Klicken Sie auf '''Fertig stellen'''. Die neue Unit wird im '''Quelltext-Editor''' geöffnet.
:'''So installieren Sie eine Unit in ein vorhandenes Package:'''
:# Wählen Sie auf der Seite '''Unit erstellen''' das Optionsfeld '''In vorhandenes Package installieren'''.
:# Klicken Sie auf '''Weiter'''. Eine Liste mit allen vorhandenen Packages wird erzeugt.
:# Wählen Sie auf der Seite '''Vorhandenes Package''' das Package aus, in das Sie die Unit installieren möchten.
:# Klicken Sie auf '''Fertig stellen'''. Die neue Unit wird im '''Quelltext-Editor''' geöffnet.
:'''So installieren Sie eine Unit in ein neues Package:'''
:# Wählen Sie auf der Seite '''Unit erstellen''' das Optionsfeld '''In neues Package installieren'''.
:# Klicken Sie auf '''Weiter'''.
:# Geben Sie auf der Seite '''Neues Package''' einen Namen für das Package in das Textfeld '''Package-Name''' ein.
:# Geben Sie in das Textfeld '''Beschreibung''' eine Beschreibung für Ihr neues Package ein.
:# Klicken Sie auf '''Fertig stellen'''. Die neue Unit wird im '''Quelltext-Editor''' geöffnet.
:''' So installieren Sie eine Unit in ein Skeleton-Package, das Sie vor der Ausführung des Experten erstellt haben:'''
:# Wählen Sie auf der Seite '''Unit erstellen''' das Optionsfeld '''Unit dem Projekt <Mein_neues_Package> hinzufügen'''. (Diese Option ist aktiviert, wenn Sie ein Skeleton-Package vor dem Start des Experten erstellt haben, wie oben unter '''Ein Skeleton-Package erstellen (optional)''' beschrieben.)
:# Klicken Sie auf '''Fertig stellen'''. Die neue Unit wird im '''Quelltext-Editor''' geöffnet.

==Siehe auch==

{{f| radstudio |*[[Überblick zu VCL|Überblick zu VCL]] }}

* [[Neue Komponente|Experte für neue Komponenten]] (Experte)
* [[Erstellen einer FireMonkey-Komponente (Delphi)|Erstellen einer FireMonkey-Komponente (Delphi)]]
* [[Erstellen einer FireMonkey-Komponente (C++)|Erstellen einer FireMonkey-Komponente (C++)]]
* [[Neue Komponenten erzeugen|Neue Komponenten erzeugen]]

{{DEFAULTSORT:Verwenden des Experten fur neue Komponenten}}
[[Category:Mit Delphi für Windows arbeiten]]
[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]

[[en:Using the New Component Wizard]]
[[fr:Utilisation de l'expert Nouveau composant]]
[[ja:［コンポーネントの新規作成］ウィザードを使用する]]

Verwenden der macOS-Mitteilungszentrale

2016-06-24T10:53:59Z

Esabatell: Updated. LOC-22885

__TOC__
{{Parent|OS X-Anwendungsentwicklung}}

Durch lokale Mitteilungen können Hintergrund- oder inaktive Anwendungen Benutzer darüber informieren, dass ein Ereignis aufgetreten ist, das von Interesse ist oder die App betrifft. In diesem Thema werden die grundlegenden Schritte für die Verwendung von lokalen Mitteilungen für '''OS X'''-Anwendungen beschrieben.

In Mountain Lion (OS X 10.8) wurden die Mitteilungsfunktionen und die '''Mitteilungszentrale''' hinzugefügt. Diese entspricht weitgehend der '''iOS'''-Mitteilungszentrale, in der Sie lokale Mitteilungen terminieren oder sofort anzeigen können.

==Mitteilungsarten==

In '''OS X''' gibt es drei Arten von Mitteilungen:

{| class="wikitable"
|-
! Mitteilungsart
! Beschreibung
! Vorschau
|- valign="top"
|
Hinweis
|
Wird in der rechten oberen Ecke auf dem Mac angezeigt. Der Hinweis verbleibt auf dem Bildschirm, bis der Benutzer eine Aktion ausführt.
|
[[File:Notification Alert.png]]
|- valign="top"
|
Banner
|
Wird für eine kurze Zeit in der rechten oberen Ecke auf dem Mac angezeigt und gleitet dann nach rechts aus dem Bildschirm.
|
[[File:Notification Banner.png]]
|- valign="top"
|
Kennzeichen
|
Ein rotes Kennzeichen mit einer Zahl wird rechts oben auf dem Symbol einer App angezeigt. Die Zahl gibt die Anzahl der Mitteilungen an, die für Sie in einer App vorhanden sind.
: '''Hinweis:''' Das Kennzeichen wird nicht unterstützt. Ein Beispiel der Implementierung von Kennzeichen ohne Verwendung der Komponente [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]] finden Sie unter [[samp_en:OSX Dock Badges (Delphi)|OSX Dock Badges]]
|
|}

==Zugreifen auf den Mitteilungsdienst==

{{Product}} stellt die Komponente [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]] bereit, über die Sie schnell auf den Mitteilungsdienst zugreifen können.

Um auf den Mitteilungsdienst zuzugreifen, legen Sie eine '''TNotificationCenter'''-Komponente auf Ihrem Formular ab.

<l s="delphi" />

* {{Product}} fügt die folgende Unit für {{Delphi}} hinzu:

<source lang="Delphi">
uses
System.Notification;
</source><l e="delphi" />

<l s="cpp" />

* {{Product}} fügt den folgenden '''include'''-Operator der Projekt-Header-Datei für C++ hinzu:

<source lang="cpp">
#include <System.Notification.hpp>
</source><l e="cpp" />

==Mitteilungszentrale unter OS X==

Alle [http://support.apple.com/kb/ht5362 Mitteilungen (EN)], für die keine Aktionen ausgeführt werden, werden in die '''Mitteilungszentrale''' übernommen. Wenn eine Popup-Mitteilung auf dem Bildschirm erscheint und der Benutzer nicht darauf klickt, wird sie in die '''Mitteilungszentrale''' übernommen. Hinweise verbleiben so lange in der Mitteilungszentrale, bis der Benutzer die geeignete Aktion ausführt.

Sie können die '''Mitteilungszentrale''' ein- und ausblenden, indem Sie einfach auf der rechten Seite der Menüleiste auf [[File:Notification Center icon.png]] klicken. Wenn der Benutzer in der '''Mitteilungszentrale''' auf eine Mitteilung klickt, wird die App geöffnet oder in den Vordergrund gesetzt.

[[File:Notification Center on Menu Bar.png]]

Eine Mitteilung kann als Popup-Banner oder als Hinweis angezeigt werden, wenn die App im Hintergrund ausgeführt wird oder inaktiv ist. Der Benutzer kann die Art und Weise festlegen, wie diese Mitteilungen in '''OS X''' dargestellt werden:

[[File:Notifications Icon.png]]

# Öffnen Sie '''Systemeinstellungen''' > '''Mitteilungen'''.
# Suchen Sie links die App.
# Wählen Sie '''Keine''', '''Banner''' oder '''Hinweise'''.

: '''Hinweis:''' Wenn der Benutzer '''Keine''' auswählt, wird keine Popup-Mitteilung angezeigt, und Mitteilungen werden direkt in die '''Mitteilungszentrale''' übernommen. Standardmäßig zeigt Ihre App das Mitteilungsbanner an.

Der folgende Screenshot zeigt das Konfigurationsfenster der '''Mitteilungszentrale''':

[[File:OSXNotificationCenter.png|500 px]]

==Erstellen von Mitteilungen==

Damit Ihre App lokale Mitteilungen unter '''OS X''' anzeigen kann, müssen Sie eine Instanz des Klassenobjekts [[lib_de:System.Notification.TNotification|TNotification]] erstellen. Sie können diese Instanz mit der Methode '''[[lib_de:System.Notification.TCustomNotificationCenter.CreateNotification|System.Notification.TNotificationCenter.CreateNotification]]''' erstellen.

Beim Erstellen eines lokalen Mitteilungsobjekts kann die App die Mitteilung entweder mit dem Betriebssystem terminieren oder sie sofort anzeigen. Lokale Mitteilungen eignen sich ideal für Apps mit zeitbasiertem Verhalten. Sie können die Uhrzeit festlegen, zu der das Betriebssystem die Mitteilung liefert; die Uhrzeit wird auch '''Auslösungszeitpunkt''' genannt.
Sie können die geplante Mitteilung auch wiederholen.

So nehmen Sie Mitteilungen in Ihre '''OS X'''-Apps auf:

# Erstellen Sie eine Instanz der Klasse [[lib_de:System.Notification.TNotification|TNotification]].
# Erstellen Sie mit [[lib_de:System.Notification.TCustomNotificationCenter.CreateNotification|CreateNotification]] eine Mitteilung.
# Legen Sie die Felder [[lib_de:System.Notification.TNotification.Name|Name]], [[lib_de:System.Notification.TNotification.AlertBody|AlertBody]] und [[lib_de:System.Notification.TNotification.FireDate|FireDate]] fest.
#* Um die Mitteilung zu planen und sie in der '''Mitteilungszentrale''' anzuzeigen, verwenden Sie die Methode [[lib_de:System.Notification.TCustomNotificationCenter.ScheduleNotification|ScheduleNotification]], die die Klasse [[lib_de:System.Notification.TNotificationCenter|TNotificationCenterclass]] von [[lib_de:System.Notification.TCustomNotificationCenter|TCustomNotificationCenter]] erbt.
#* Um eine geplante Mitteilung zu wiederholen und für die '''Mitteilungszentrale''' bereitzustellen, erstellen Sie eine geplante Mitteilung und verwenden Sie die Eigenschaft [[lib_de:System.Notification.TNotification.RepeatInterval|RepeatInterval]] der Klasse [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]].
#* Um die Mitteilung sofort anzuzeigen, verwenden Sie die Methode [[lib_de:System.Notification.TCustomNotificationCenter.PresentNotification|PresentNotification]], die die Klasse [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]] von [[lib_de:System.Notification.TCustomNotificationCenter|TCustomNotificationCenter]] erbt.

Mitteilungen verbleiben in der '''Mitteilungszentrale''', bis Sie sie löschen.

Jede Mitteilung ist durch die Eigenschaft '''Name''' des '''TNotification'''-Objekts eindeutig festgelegt.

'''So aktualisieren oder löschen Sie eine Mitteilung:'''

* Um eine geplante Mitteilung zu aktualisieren, rufen Sie erneut die Methode [[lib_de:System.Notification.TCustomNotificationCenter.ScheduleNotification|ScheduleNotification]] mit einer Instanz von '''TNotificationCenter''' auf, die denselben Namen (Eigenschaft '''Name''') hat.
* Um eine Mitteilung zu stornieren, rufen Sie die Methode [[lib_de:System.Notification.TCustomNotificationCenter.CancelNotification|CancelNotification]] mit dem verwendeten Bezeichner auf.
* Um alle Mitteilungen zu stornieren, rufen Sie die Methode [[lib_de:System.Notification.TCustomNotificationCenter.CancelAll|CancelAll]] auf.

==Siehe auch==

* [[Verwenden von Mitteilungen|Verwenden von Mitteilungen]]
* [[lib_de:System.Notification.TNotification|System.Notification.TNotification]]
* [[lib_de:System.Notification.TNotificationCenter|System.Notification.TNotificationCenter]]
* [[samp_en:FMX.SendCancelNotification Sample|FMX.SendCancelNotification (Beispiel)]]
* [[samp_en:FMX.Notification.Mac (Delphi)|FMX.Notification.Mac (Delphi-Codebeispiel)]]
* [[samp_en:FMX.Notification.Mac (C++)|FMX.Notification.Mac (C++-Codebeispiel)]]
* [[Mobile-Tutorial: Verwenden von Mitteilungen (iOS und Android)|Mobile-Tutorial: Verwenden von Mitteilungen (iOS und Android)]]
* [[Mobile-Tutorial: Verwenden von Remote-Mitteilungen (iOS und Android)|Mobile-Tutorial: Verwenden von Remote-Mitteilungen (iOS und Android)]]

[[Category:Delphi]]
[[Category:C++]]
[[Category:FMX]]
[[Category:Geräteübergreifend]]
[[Category:XE6]]
[[Category:AMMigrate]]

[[en:Using the OS X Notification Center]]
[[fr:Utilisation du Centre de notifications Mac OS X]]
[[ja:Mac OS X 通知センターの使用]]

Verwenden von SQLite mit FireDAC

2016-06-24T10:53:35Z

Esabatell: Updated. LOC-22885

{{Parent|Arbeiten mit DBMS (FireDAC)}}

Dieser Referenzartikel ist in mehrere Abschnitte gegliedert:

* '''Einführung in SQLite''': bietet einen Überblick über SQLite-Funktionen, fehlende Funktionen, mögliche Anwendungen und nicht für SQLite geeignete Anwendungen.
* '''Verwenden von SQLite-Datenbanken''': erläutert, wie eine SQLite-Datenbank in einer {{Delphi}}-Anwendung erstellt, eine Verbindung mit der Datenbank hergestellt und die Datenbank verwaltet wird.
* '''Verschlüsselte SQLite-Datenbanken:''' die Datenbankverschlüsselung stellt eine der wichtigsten SQLite-Funktionen dar. In diesem Abschnitt wird die Funktionsweise der Verschlüsselung und deren Steuerung erklärt.
* '''SQLite-Datentypen:''' SQLite verwendet ein spezielles Datentypsystem. Ohne Kenntnis der Funktionsweise dieses Systems ist es schwierig, Daten in {{Delphi}}-Anwendungen zu speichern und abzurufen.
* '''SQL-Anweisungen von SQLite:''' Hauptaspekte des SQL-Dialekts von SQLite für {{Delphi}}-Anwendungsentwickler.
* '''Transaktionen, Sperren und Cursors in SQLite:''' erläutert die Arbeit mit Transaktionen in einer SQLite-Umgebung.
* '''Erweitern der SQLite-Engine:''' als eingebettetes DBMS kann die SQLite-Engine durch {{Delphi}}-Anwendungscode erweitert werden.
* '''Fortgeschrittene SQLite-Techniken:''' in diesem Abschnitt werden schließlich einige fortgeschrittene SQLite-Konzepte, wie Protokollierung von Aktualisierungen und SQL-Autorisierung, vorgestellt.

Für diesen Artikel ist die Kenntnis der FireDAC-Grundlagen und der Hauptbibliotheks-APIs erforderlich. Anfängern wird empfohlen, mit dem Artikel [[Einführung (FireDAC)|Einführung]] zu beginnen und sich die Demo "FireDAC\Samples\Getting Started\SQLite" anzusehen.

==Einführung in SQLite==

===SQLite-Datenbank===

[http://www.sqlite.org/ SQLite (EN)] ist eine eingebettete SQL-Datenbank-Engine, die vom SQLite Consortium entwickelt wurde. Sie ist das weltweit [http://www.sqlite.org/mostdeployed.html am häufigsten eingesetzte DBMS (EN)] mit circa 500 Millionen Installationen. Sie wird auf mobilen iOS- und Android-Geräten genauso wie auf Mac OS-Desktops eingesetzt. Sie wird von Firefox, Skype und McAfee-Antivirus verwendet.

===SQLite-Funktionen===

Auf der [http://www.sqlite.org/features.html SQLite-Website (EN)] sind die folgenden Funktionen aufgeführt:

* '''Transaktionen''' sind ACID (Atomic, Consistent, Isolated und Durable), auch nach Systemabstürzen und Stromausfällen.
* '''Konfigurationsfrei''' – keine Konfiguration oder Administration erforderlich.
* Implementiert einen '''Großteil der SQL92-Funktionen'''. Unterstützt Tabellen-Trigger und -Sichten.
* Eine komplette Datenbank wird in einer '''einzelnen plattformübergreifenden Datei''' gespeichert.
* Unterstützt '''Datenbanken in Terabyte-Größe''' sowie Strings und Blobs in Gigabyte-Größe.
* '''Schneller''' als populäre Client/Server-Datenbank-Engines bei den häufigsten Operationen.
* '''Eigenständig''': keine externen Abhängigkeiten.
* '''Geräteübergreifend''': Windows, OS X, iOS und Android werden ohne Zusatzaufwand unterstützt.
* Die Quelltexte befinden sich in der öffentlichen Domäne. Deren Verwendung für beliebige Zwecke ist '''kostenlos'''.
* '''Sehr leistungsstarke API''', die die Erweiterung der Engine in praktisch allen Bereichen zulässt.
* SQLite erreicht im Vergleich zu anderen eingebetteten, Dateiserver- und Client-Server-Datenbank-Engines, die in {{Delphi}}-Anwendungen eingesetzt werden, eine der '''besten Datenzugriffsleistungen'''. Es gibt viele erfolgreiche Datenbankenanwendungen mit mehreren Gigabyte. Silwood Technology Saphir wurde beispielsweise mit SQLite, {{Delphi}} und FireDAC entwickelt.

===Fehlende SQLite-Funktionen===

Entwickler suchen häufig nach den folgenden Funktionen, die in SQLite nicht vorhanden sind:

* '''Gespeicherte Prozeduren''' – FireDAC bietet eine API für benutzerdefinierte Funktionen.
* Umfangreiche '''integrierte Funktionen''' – FireDAC installiert ungefähr 50 Standardfunktionen vor.
* '''Sicherheitssystem''', einschließlich Benutzerkonzept und Rechtekonzept – FireDAC bietet eine passwortgeschützte verschlüsselte Datenbank und spezielle Callback-Funktionen zum Filtern von Benutzeraktionen.
* '''Sortierungen''' (nur ASCII und binär) – FireDAC ermöglicht die Definition von benutzerdefinierten Sortierungen.

===SQLite-Anwendungen===

Auf der [http://www.sqlite.org/whentouse.html SQLite-Website (EN)] sind die folgenden Funktionen aufgeführt:

* '''Format der Anwendungsdatei''' – SQLite wurde mit großem Erfolg als On-Disk-Dateiformat für Desktop-Plattformen eingesetzt.
* '''Eingebettete Geräte und Anwendungen''' – Weil die SQLite-Datenbank keine oder nur wenig Administration erfordert, ist SQLite eine gute Wahl für Geräte oder Dienste, die unbeaufsichtigt und ohne menschliche Unterstützung arbeiten.
* '''Websites''' – SQLite funktioniert in der Regel als Datenbank-Engine für Websites mit geringem oder mittlerem Verkehr (d. h. 99,9 % aller Websites) gut.
* '''Ersatz für Ad-hoc-Datenträgerdateien''' – SQLite funktioniert insbesondere gut als Ersatz für diese Ad-hoc-Datendateien.
* '''Interne oder temporäre Datenbanken''' – In Programmen kann das Sichten und Sortieren von Daten auf unterschiedliche Weise einfacher ausgeführt werden, indem Daten in die SQLite-Datenbank im Arbeitsspeicher geladen werden und die komplette SQL-Anweisung ausgeführt wird.
* '''Ersatz für eine Unternehmensdatenbank''' bei Demos oder Tests.
* '''Datenbankpädagogik'''.

===Nicht für SQLite geeignete Anwendungen===

Auf derselben [http://www.sqlite.org/whentouse.html SQLite-Website (EN)] sind die folgenden Funktionen aufgeführt:

* '''Hohe Parallelität''' – SQLite verwendet Lese-/Schreibsperren für die gesamte Datenbankdatei. Wenn also ein Prozess einen Teil der Datenbank liest, können alle anderen Prozesse nicht in einen anderen Teil der Datenbank schreiben. Ebenso können alle anderen Prozesse keinen anderen Teil der Datenbank lesen, während ein Prozess in die Datenbank schreibt.
* '''Client/Server-Anwendungen''' – Wenn viele Client-Programme auf eine gemeinsame Datenbank über ein Netzwerk zugreifen, sollten Sie die Verwendung einer Client/Server-Datenbank-Engine anstelle von SQLite in Betracht ziehen. SQLite arbeitet über ein Netzwerkdateisystem, aber wegen der den meisten Netzwerkdateisystemen zugeordneten Wartezeit ist die Leistung nicht ideal.
* '''Sehr große Datenmengen''' (N TB).

==Verwenden von SQLite-Datenbanken==

===Verbinden mit einer SQLite-Datenbank aus einer {{Delphi}}-Anwendung===

Fügen Sie TFDPhysSQLiteDriverLink einem Formular oder einen Datenmodul hinzu, um den SQLite-Treiber von FireDAC mit einer {{Delphi}}-Anwendung zu verknüpfen. Um eine Verbindung mit einer SQLite-Datenbank herzustellen, geben Sie [[Herstellen einer Verbindung zu SQLite-Datenbanken (FireDAC)|SQLite-Treiberparameter]] an, zumindest die folgenden:

<source lang="delphi">
DriverID=SQLite
Database=<path to SQLite database>
</source>

Standardmäßig werden alle SQLite-Treibereinstellungen für einen einzelnen Hochleistungszugriff auf eine Datenbank in einer stabilen Umgebung festgelegt. Mit der Anweisung [http://www.sqlite.org/pragma.html PRAGMA (EN)] können Sie SQLite konfigurieren. Viele FireDAC SQLite-Treiberparameter entsprechen Pragma-Anweisungen. Darüber hinaus ermöglicht '''SQLiteAdvanced''' die Angabe von mehreren durch ";" getrennten Pragma-Anweisungen als einzelnen Verbindungsparameter.

Weitere SQLite-Anwendungsfälle:

{| border="1" frame="hsides" rules="rows"
|-
! '''Nr.'''
! '''Besonderheiten der Anwendung'''
! '''Beschreibung'''
|-
| style="text-align: left; vertical-align: top;" | 1
| style="text-align: left; vertical-align: top;" | Lesen großer DBs.
| style="text-align: left; vertical-align: top;" | Setzen Sie '''CacheSize''' auf eine höhere Anzahl an Seiten, die für die Zwischenspeicherung der DB-Daten verwendet werden. Die gesamte Größe des Zwischenspeichers beträgt "CacheSize * <DB-Seitengröße>".
|-
| style="text-align: left; vertical-align: top;" | 2
| style="text-align: left; vertical-align: top;" | Exklusives Aktualisieren von DBs.
| style="text-align: left; vertical-align: top;" | Setzen Sie '''JournalMode''' ggf. auf [http://www.sqlite.org/pragma.html#pragma_journal_mode WAL (EN)] ([http://www.sqlite.org/draft/wal.html weitere Informationen (EN)]).
|-
| style="text-align: left; vertical-align: top;" | 3
| style="text-align: left; vertical-align: top;" | Lange Aktualisierungstransaktionen.
| style="text-align: left; vertical-align: top;" | Setzen Sie '''CacheSize''' auf eine höhere Anzahl an Seiten. Dadurch können Sie Transaktionen mit vielen Aktualisierungen ausführen, ohne den Arbeitsspeicher-Zwischenspeicher mit modifizierten Seiten zu überladen.
|-
| style="text-align: left; vertical-align: top;" | 4
| style="text-align: left; vertical-align: top;" | Einige wenige gleichzeitige Aktualisierungsprozesse.
| style="text-align: left; vertical-align: top;" | Setzen Sie '''LockingMode''' auf Normal, um den gemeinsamen DB-Zugriff zu aktivieren. Setzen Sie '''Synchronous''' auf Normal oder Full, damit übergebene Daten für andere sichtbar sind. Setzen Sie '''UpdateOptions.LockWait''' auf True, um das Warten auf Sperren zu aktivieren. Erhöhen Sie '''BusyTimeout''', um die Wartezeit auf Sperren zu verlängern. Setzen Sie '''JournalMode''' ggf. auf WAL.
|-
| style="text-align: left; vertical-align: top;" | 5
| style="text-align: left; vertical-align: top;" | Einige wenige gleichzeitige Aktualisierungs-Threads.
| style="text-align: left; vertical-align: top;" | Siehe (4). Setzen Sie zudem '''SharedCache''' auf False, um Sperrkonflikte zu minimieren.
|-
| style="text-align: left; vertical-align: top;" | 6
| style="text-align: left; vertical-align: top;" | Einige wenige gleichzeitige Aktualisierungstransaktionen.
| style="text-align: left; vertical-align: top;" | Siehe (4) oder (5). Setzen Sie zudem '''TxOptions.Isolation''' auf xiSnapshot oder xiSerializible, um mögliche Transaktions-Deadlocks zu verhindern.
|-
| style="text-align: left; vertical-align: top;" | 7
| style="text-align: left; vertical-align: top;" | Hohe Sicherheit.
| style="text-align: left; vertical-align: top;" | Setzen Sie '''Synchronous''' auf Full, um die DB vor Verlusten von übergebenen Daten zu schützen. Siehe auch (3). Ziehen Sie die Verschlüsselung der Datenbank in Betracht, um die Integrität zu wahren.
|-
| style="text-align: left; vertical-align: top;" | 8
| style="text-align: left; vertical-align: top;" | Hohe Vertraulichkeit.
| style="text-align: left; vertical-align: top;" | Verschlüsseln Sie die Datenbank, um Vertraulichkeit und Integrität bereitzustellen.
|-
| style="text-align: left; vertical-align: top;" | 9
| style="text-align: left; vertical-align: top;" | Entwicklungszeit.
| style="text-align: left; vertical-align: top;" | Setzen Sie '''LockingMode''' auf Normal, um die simultane Verwendung der SQLite-DB in der IDE und einem gedebuggten Programm zu aktivieren.
|}

===Erstellen einer SQLite-Datenbank in einer {{Delphi}}-Anwendung===

Standardmäßig wird die SQLite-Datenbank bei der Verbindungseinrichtung erstellt, falls sie nicht vorhanden ist. Um eine explizite Steuerung zu erreichen, kann in der {{Delphi}}-Anwendung Folgendes angegeben werden:

<source lang="delphi">
OpenMode=CreateUTF8 | CreateUTF16 | ReadWrite | ReadOnly
</source>

Die beiden ersten für die Erstellung verwendeten Werte unterscheiden sich hinsichtlich der Codierung, die für die neue Datenbank verwendet wird. Außerdem wird empfohlen, [http://www.sqlite.org/pragma.html#pragma_page_size page_size (EN)] für Datenbanken, die Tabellen mit mehreren Zeilen enthalten, auf 4096 oder höher zu setzen. Dafür können Sie bei der Erstellung den folgenden Code angeben:

<source lang="delphi">
SQLiteAdvanced=page_size=4096
</source>

Ziehen Sie die Angabe von Parametern mittels SQLiteAdvanced in Betracht:

* [http://www.sqlite.org/pragma.html#pragma_auto_vacuum auto_vacuum (EN)]
* [http://www.sqlite.org/pragma.html#pragma_default_cache_size default_cache_size (EN)]

Nach Erstellung der Datenbankdatei hat sie eine Größe von null. Als Folge werden Datenbankcodierung, Seitengröße und andere persistente Parameter nicht in der Datenbank aufgezeichnet. Damit diese Parameter persistent werden, muss in der Anwendung mindestens eine Tabelle erstellt werden.

===Verwenden einer SQLite-Datenbank im Arbeitsspeicher in einer {{Delphi}}-Anwendung===

Die nächste SQLite-spezifische Funktion ist die Möglichkeit, mit [http://www.sqlite.org/inmemorydb.html reinen Arbeitsspeicherdatenbanken (EN)] zu arbeiten. Das bedeutet, dass keine Daten zum Speichern von Datenbankobjekten erstellt werden, sondern alles im Arbeitsspeicher verbleibt. Auf diese Weise profitieren Sie in einer {{Delphi}}-Anwendung von einer höheren Sicherheit, einer größeren Leistung und weniger Anforderungen für Zugriffsrechte in der Umgebung.

Verwenden Sie die folgenden Parameter, um eine SQLite-Datenbank im Arbeitsspeicher zu erstellen und zu öffnen:
<source lang="delphi">
DriverID=SQLite
Database=:memory:
</source>

Oder lassen Sie den Parameter Database einfach leer:
<source lang="delphi">
DriverID=SQLite
</source>

Ein FireDAC-Kunde hat eine SQLite-Datenbank auf einer freigegebenen Netzwerkressource gespeichert. Die Datenbank ist ein schreibgeschützter Produktkatalog mit vielen gespeicherten Produktattributen. Um die Leistung extrem zu steigern, hat der Kunde mit TFDSQLiteBackup die gesamte Datenbank in die Datenbank im Arbeitsspeicher verschoben. Der Beispielcode:
<source lang="delphi">
FDConnection1.DriverName := 'SQLite';
FDConnection1.Open;

FDSQLiteBackup1.Database := '\\srv\db\data.sdb';
FDSQLiteBackup1.DestDatabaseObj := FDConnection1.CliObj;
FDSQLiteBackup1.DestMode := smCreate;
FDSQLiteBackup1.Backup;
</source>

===Arbeiten mit Unicode und SQLite-Datenbanken===

[[Unicode-Unterstützung (FireDAC)|FireDAC unterstützt Unicode]] von {{Delphi}} <f s="radstudio" t="span" /> (ab {{Delphi}} 2009) <f e="radstudio" t="span" /> vollständig. Für SQLite bedeutet das:

* FireDAC richtet automatisch eine SQLite-Datenbank für den Austausch aller Metadaten in der UTF-16-Codierung ein, wenn {{Delphi}} <f s="radstudio" t="span" /> 2009 oder höher <f e="radstudio" t="span" /> verwendet wird. <f s="radstudio" t="span" /> In {{Delphi}} 2007 oder früher sind die Metadaten in ANSI codiert.<f e="radstudio" t="span" />
* Die Daten werden so definiert und ausgetauscht, wie im Kapitel "Zuordnen von SQLite- zu FireDAC-Datentypen" beschrieben.

===Verwenden von mehreren SQLite-Datenbanken in einer {{Delphi}}-Anwendung===

SQLite ermöglicht die Verwendung mehrerer Datenbanken in einer einzelnen Verbindung. Eine im Parameter Database angegebene DB ist die Hauptdatenbank. Um weitere Datenbanken hinzuzufügen, muss in der {{Delphi}}-Anwendung die [http://www.sqlite.org/lang_attach.html ATTACH-Anweisung (EN)] verwendet werden. Zum Beispiel:

<source lang="delphi">
FDConnection1.ExecSQL('ATTACH ''c:\hr.sdb'' AS hr');
FDConnection1.ExecSQL('ATTACH ''c:\cust.sdb'' AS cust');
FDQuery1.Open('select * from "Orders" o ' +
'left join hr."Employees" e on o.EmployeeID = e.EmployeeID ' +
'left join cust."Customers" c on o.CustomerID = c.CustomerID');
</source>

<blockquote>
'''Hinweis:''' FireDAC interpretiert einen Datenbanknamen als Katalognamen.
</blockquote>

===Verwalten einer SQLite-Datenbank in einer {{Delphi}}-Anwendung===

In einer guten {{Delphi}}-SQLite-Datenbankanwendung (und nicht nur dort) muss Folgendes berücksichtigt werden:

* Die SQLite-Datenbank kann nach vielen "harten" Datensatzaktualisierungen oder -löschungen fragmentiert und nicht optimal sein. Durch Aufruf der Methode [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteValidate.Sweep|TFDSQLiteValidate.Sweep]] wird die Datenbank optimiert. Diese Methode entspricht den Anweisungen [http://www.sqlite.org/lang_vacuum.html VACUUM (EN)] und [http://www.sqlite.org/pragma.html#pragma_auto_vacuum PRAGMA auto_vacuum (EN)]. Beispiel:

<source lang="delphi">
FDSQLiteValidate1.Database := 'c:\db.sdb';
FDSQLiteValidate1.Sweep;
</source>

* Durch die Optimierung von SQLite-Abfragen wird ein besserer Abfrageausführungsplan erstellt, wenn eine aktuelle Datenbankstatistik vorliegt. SQLite aktualisiert die Statistik nicht automatisch. Durch Aufruf der Methode [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteValidate.Analyze|TFDSQLiteValidate.Analyze]] wird die Statistik erfasst. Diese Methode verwendet die Anweisung [http://www.sqlite.org/lang_analyze.html ANALYZE (EN)]. Eine Anwendung kann die Statistik für die vollständige Datenbank erfassen:

<source lang="delphi">
FDSQLiteValidate1.Database := 'c:\db.sdb';
FDSQLiteValidate1.Analyze;
</source>

* Die SQLite-Datenbank kann beschädigt oder nicht wohlgeformt werden. Verwenden Sie die Methode [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteValidate.CheckOnly|TFDSQLiteValidate.CheckOnly]], um die Integrität zu überprüfen. Um eine beschädigte SQLite-Datenbank zu reparieren, muss die {{Delphi}}-Anwendung sie aus einer Sicherung wiederherstellen. Die Methode CheckOnly verwendet die Ereignisbehandlungsroutine [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteValidate.OnProgress|OnProgress]], um über Probleme zu informieren. Diese Methode führt die Anweisung [http://www.sqlite.org/pragma.html#pragma_integrity_check PRAGMA integrity_check (EN)] aus.

<source lang="delphi">
procedure TForm1.FDSQLiteValidate1Progress(ASender: TFDPhysDriverService; const AMessage: String);
begin
Memo1.Lines.Add(AMessage);
end;

FDSQLiteValidate1.Database := 'c:\db.sdb';
FDSQLiteValidate1.OnProgress := Form1Progress;
FDSQLiteValidate1.CheckOnly;
</source>

* Die SQLite-Datenbank muss regelmäßig gesichert werden, um Datenverluste zu vermeiden. Die Komponente [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteBackup|TFDSQLiteBackup]] führt eine Sicherung der Datenbank durch. Der einfachste Code zum Ausführen einer Sicherung lautet wie folgt:

<source lang="delphi">
FDSQLiteBackup1.Database := 'c:\db.sdb';
FDSQLiteBackup1.DestDatabase := 'c:\db.backup';
FDSQLiteBackup1.DestMode := smCreate;
FDSQLiteBackup1.Backup;
</source>

==Verschlüsselte SQLite-Datenbanken==

===Ansatz===

Eine der spezifischen SQLite-Funktionen ist extrem schnelle, starke Verschlüsselung von Datenbanken. Damit wird der Inhalt der Datenbankdatei vertraulich und die Integritätssteuerung für die Datenbankdatei verstärkt.

Das verschlüsselte Datenbankformat ist nicht mit anderen ähnlichen SQLite-Verschlüsselungserweiterungen kompatibel. Das bedeutet, dass Sie keine verschlüsselte Datenbank verwenden können, die mit Nicht-FireDAC-Bibliotheken verschlüsselt wurden. Wenn Sie eine derartig verschlüsselte Datenbank verwenden möchten, dann müssen Sie die Datenbank mit dem Originaltool entschlüsseln und mit FireDAC erneut verschlüsseln.

Die Verschlüsselung wird im offiziell unterstützten SQLite-Ansatz bereitgestellt – benutzerdefinierter Codec-Code und Compilierung mit definiertem SQLITE_HAS_CODEC. Alle Verschlüsselungsroutinen sind in {{Delphi}} implementiert und im sqlite3-Code eingebettet. Daher wird die Verschlüsselung für folgende Elemente korrekt behandelt:

* [http://www.sqlite.org/lang_attach.html ATTACH (EN)].
* [http://www.sqlite.org/lang_vacuum.html VACUUM (EN)].
* Datenbankwiederherstellung.
* [http://www.sqlite.org/backup.html Datenbanksicherung (EN)].

===Verschlüsselungsmodi===

{| border="1" frame="hsides" rules="rows"
|-
! '''Modus'''
! '''Beschreibung'''
! '''Verwendung'''
|-
| style="text-align: left; vertical-align: top;" |'''AES-NNN'''
| style="text-align: left; vertical-align: top;" | Die Algorithmen aes-NNN sind generische Zusammensetzungen von AES-CTR und AES-CBC-MAC. Diese Zusammensetzungen '''garantieren Vertraulichkeit und Integrität'''. Das bedeutet, dass nur Entitäten mit Zugriff auf das korrekte Passwort die Seiten der verschlüsselten Datenbank lesen und ändern können. Diese Algorithmen fügen der verschlüsselten Datenbank einen linearen Overhead von 32 Byte pro Seite hinzu.

Mit diesem Algorithmus können Sie die bösartigsten Versuche aufdecken, Daten in die Datenbank einzufügen, aber solche Versuche werden nicht verhindert, und Sie erhalten keine Unterstützung für die Rückgängigmachung derartiger Änderungen. Es handelt sich um Grunde um eine Ergänzung häufiger Sicherungen, aber dieser Algorithmus ist besser als die meisten anderen Verschlüsselungsschemas für Datenbanken, da er eine Warnung ausgibt, wenn Sie Ziel eines Angriffs geworden sind und Sie Ihre Datenbank aus einer Sicherung wiederherstellen sollten. Bitte beachten Sie, das der aes-NNN-Algorithmus alleine weder die Löschung von ganzen Seiten am Ende der Datenbank (sondern nur Löschungen in der Mitte der Datenbank), noch Angriffe entdeckt, die darin bestehen, die Datenbank auf eine ältere Version zurückzusetzen, die mit demselben Passwort verschlüsselt ist.
| style="text-align: left; vertical-align: top;" | Der AES-NNN-Algorithmus stellt eine optimale Vertraulichkeit und Integrität bereit. Daraus resultiert jedoch eine gewisse Leistungsminderung, die gegenüber anderen Verschlüsselungsmodi deutlich wahrnehmbar ist.
|-
| style="text-align: left; vertical-align: top;" |'''AES-CTR-NNN'''
| style="text-align: left; vertical-align: top;" | Die Algorithmen aes-ctr-NNN umfassen nur AES-CTR. Sie '''erkennen keine Änderungen an der Datenbank''', aber Sie '''stellen Vertraulichkeit''' bei passiven Angriffen bereit. Solange ein Angreifer keinen Zugriff au Ihr Passwort hat und nicht versucht, die Datenbank zu ändern, um auszuprobieren, wie Ihre Anwendung auf die Änderungen reagiert, bleiben Ihre Daten so geheim, wie Ihre Anwendung es zulässt.

Die Algorithmen schützen die Datenbankdatei nur gegen Angreifer, die nicht in der Lage sind, in Ihre FireDAC-Anwendung einzudringen, beispielsweise mit einem Debugger, und das Passwort so zu extrahieren. Wenn Sie Ihr Passwort in einer Konfigurationsdatei oder als eine Konstante in der Software selbst speichern, ist es sogar für nicht sehr versierte Angreifer ein Kinderspiel es zu finden und Ihre Sicherheit zu gefährden.
| style="text-align: left; vertical-align: top;" | Der AES-CTR-NNN-Algorithmus stellt eine optimale Vertraulichkeit, aber keine Integrität bereit. Damit erzielen Sie eine bessere Leistung.
|-
| style="text-align: left; vertical-align: top;" |'''AEC-ECB-NNN'''
| style="text-align: left; vertical-align: top;" | Die Algorithmen aes-ecb-NNN umfassen nur AES-ECB. Sie '''erkennen keine Änderungen an der Datenbank''' und '''stellen keine Vertraulichkeit''' bei passiven Angriffen bereit, im Gegensatz zu AES-NNN und AES-CTR-NNN.
| style="text-align: left; vertical-align: top;" | Der Algorithmus AES-ECB-NNN stellt eine vergleichsweise schwache Vertraulichkeit und keine Integrität bereit. Er liefert jedoch im Vergleich mit anderen Verschlüsselungsmodi die beste Leistung.
|}

NNN ist die Schlüsselgröße; 128, 192 oder 256 Bit.

===Konfigurieren der Verschlüsselung===

Die Verschlüsselung kann durch Folgendes gesteuert werden:

* durch die Verbindungsdefinitionsparameter Encrypt, NewPassword und Password.
* durch die Dienstkomponente TFDSQLiteSecurity.

Die password-Verbindungsdefinitionsparameter können die folgende Form haben:

<source lang="delphi">
[aes-128 | aes-192 | aes-256 | aes-ctr-128 | aes-ctr-192 | aes-ctr-256 |
aes-ecb-128 | aes-ecb-192 | aes-ecb-256:] password
</source>

"aes-XXX-NNN": ist ein optionaler Präfix, der den zu verwendenden Verschlüsselungsalgorithmus steuert. Wenn er nicht angegeben ist, dann wird Folgendes verwendet:

* ein Algorithmus, der im Parameter '''Encrypt''' angegeben ist
* '''aes-256''', wenn nichts angegeben ist

FireDAC unterstützt Verschlüsselungsoperationen:

{| border="1" frame="hsides" rules="rows"
|-
! '''Operation'''
! '''Verwendung von Parametern'''
! '''Verwendung von TFDSQLiteSecurity'''
|-
| style="text-align: left; vertical-align: top;" | Öffnen einer verschlüsselten Datenbank
| style="text-align: left; vertical-align: top;" | Password=xxxx
| style="text-align: left; vertical-align: top;" | ---
|-
| style="text-align: left; vertical-align: top;" | Verschlüsseln einer nicht verschlüsselten Datenbank
| style="text-align: left; vertical-align: top;" | NewPassword=xxxx
| style="text-align: left; vertical-align: top;" | FDSQLiteSecurity1.Database := '...';

FDSQLiteSecurity1.Password := 'xxxx';

FDSQLiteSecurity1.SetPassword;
|-
| style="text-align: left; vertical-align: top;" | Ändern des Passworts einer verschlüsselten Datenbank
| style="text-align: left; vertical-align: top;" | Password=xxxx

NewPassword=yyyy
| style="text-align: left; vertical-align: top;" | FDSQLiteSecurity1.Database := '...';

FDSQLiteSecurity1.Password := 'xxxx';

FDSQLiteSecurity1.ToPassword := 'yyyy';

FDSQLiteSecurity1.ChangePassword;
|-
| style="text-align: left; vertical-align: top;" | Entschlüsseln einer verschlüsselten Datenbank
| style="text-align: left; vertical-align: top;" | Password=xxxx

NewPassword=
| style="text-align: left; vertical-align: top;" | FDSQLiteSecurity1.Database := '...';

FDSQLiteSecurity1.Password := 'xxxx';

FDSQLiteSecurity1.RemovePassword;
|-
| style="text-align: left; vertical-align: top;" | Überprüfen des Verschlüsselungsstatus einer Datenbank
| style="text-align: left; vertical-align: top;" | ---

NewPassword=
| style="text-align: left; vertical-align: top;" | FDSQLiteSecurity1.Database := '...';

FDSQLiteSecurity1.Password := 'xxxx';

ShowMessage(FDSQLiteSecurity1.CheckEncryption);
|}

===SQL-Erweiterung===

Die Anweisung ATTACH hat eine Erweiterung. Die vollständige Syntax von ATTACH lautet nun:
<source lang="delphi">
ATTACH [DATABASE] 'filename' [AS name] [KEY 'password']
</source>

Wenn KEY weggelassen wird, dann wird der Passwortwert von der Hauptdatenbank geerbt. Um ein leeres Passwort zum Anfügen einer nicht verschlüsselten Datenbank anzugeben, verwenden Sie Code wie den folgenden:
<source lang="delphi">
ATTACH 'D:\tmp\test.db' AS tst KEY ''
</source>

==SQLite-Datentypen==

===Zuordnen von SQLite- zu FireDAC-Datentypen===

SQLite verwendet ein "typenloses" [http://www.sqlite.org/datatype3.html Datentypsystem (EN)]. Das bedeutet, dass Sie praktisch jeden beliebigen Bezeichner als Datentypname einer Spalte verwenden können. Beispielsweise funktioniert auch "{{Delphi}}" und entspricht dem String-Datentyp. Damit der SQLite-Ansatz kompatibler zu anderen DBMSs und {{Delphi}}, aber auch einfacher für {{Delphi}}-Anwendungsentwickler wird, erkennt FireDAC die in der folgenden Tabelle aufgeführten Datentypnamen:

{| border="1" frame="hsides" rules="rows"
|-
! '''Typname'''
! '''Beschreibung'''
|-
| style="text-align: left; vertical-align: top;" | ROWID | _ROWID_ | OID
| style="text-align: left; vertical-align: top;" | dtInt64, Attrs = [caSearchable, caAllowNull, caROWID]
|-
| style="text-align: left; vertical-align: top;" | BIT | BOOL | BOOLEAN | LOGICAL | YESNO
| style="text-align: left; vertical-align: top;" | dtBoolean
|-
| style="text-align: left; vertical-align: top;" | TINYINT | SHORTINT | INT8 [UNSIGNED]
| style="text-align: left; vertical-align: top;" | dtSByte / dtByte
|-
| style="text-align: left; vertical-align: top;" | BYTE | UINT8
| style="text-align: left; vertical-align: top;" | dtByte
|-
| style="text-align: left; vertical-align: top;" | SMALLINT | INT16 [UNSIGNED]
| style="text-align: left; vertical-align: top;" | dtInt16 / dtUInt16
|-
| style="text-align: left; vertical-align: top;" | WORD | UINT16 | YEAR
| style="text-align: left; vertical-align: top;" | dtUInt16
|-
| style="text-align: left; vertical-align: top;" | MEDIUMINT | INTEGER | INT | INT32 [UNSIGNED]
| style="text-align: left; vertical-align: top;" | dtInt32 / dtUInt32
|-
| style="text-align: left; vertical-align: top;" | LONGWORD | UINT32
| style="text-align: left; vertical-align: top;" | dtUInt32
|-
| style="text-align: left; vertical-align: top;" | BIGINT | INT64 | COUNTER | AUTOINCREMENT | IDENTITY [UNSIGNED]
| style="text-align: left; vertical-align: top;" | dtInt64 / dtUInt64
|-
| style="text-align: left; vertical-align: top;" | LONGLONGWORD | UINT64
| style="text-align: left; vertical-align: top;" | dtUInt64
|-
| style="text-align: left; vertical-align: top;" | REAL | FLOAT | DOUBLE
| style="text-align: left; vertical-align: top;" | dtDouble
|-
| style="text-align: left; vertical-align: top;" | SINGLE [PRECISION] [(P, S)]
| style="text-align: left; vertical-align: top;" | dtSingle / dtBCD / dtFmtBCD
|-
| style="text-align: left; vertical-align: top;" | DECIMAL | DEC | NUMERIC | NUMBER [UNSIGNED] [(P, S)]
| style="text-align: left; vertical-align: top;" |dtSByte / dtInt16 / dtInt32 / dtInt64

dtByte / dtUInt16 / dtUInt32 / dtUInt64

dtBCD / dtFmtBCD
|-
| style="text-align: left; vertical-align: top;" | MONEY | SMALLMONEY | CURRENCY | FINANCIAL [(P, S)]
| style="text-align: left; vertical-align: top;" | dtCurrency
|-
| style="text-align: left; vertical-align: top;" | DATE | SMALLDATE
| style="text-align: left; vertical-align: top;" | dtDate
|-
| style="text-align: left; vertical-align: top;" | DATETIME | SMALLDATETIME
| style="text-align: left; vertical-align: top;" | dtDateTime
|-
| style="text-align: left; vertical-align: top;" | TIMESTAMP
| style="text-align: left; vertical-align: top;" | dtDateTimeStamp
|-
| style="text-align: left; vertical-align: top;" | TIME
| style="text-align: left; vertical-align: top;" | dtTime
|-
| style="text-align: left; vertical-align: top;" | CHAR | CHARACTER [(L)]
| style="text-align: left; vertical-align: top;" | dtAnsiString, Len = L, Attrs = [caFixedLen]
|-
| style="text-align: left; vertical-align: top;" | VARCHAR | VARCHAR2 | TYNITEXT | CHARACTER VARYING | CHAR VARYING [(L)]
| style="text-align: left; vertical-align: top;" | dtAnsiString, Len = L
|-
| style="text-align: left; vertical-align: top;" | NCHAR | NATIONAL CHAR | NATIONAL CHARACTER [(L)]
| style="text-align: left; vertical-align: top;" | dtWideString, Len = L, Attrs = [caFixedLen]
|-
| style="text-align: left; vertical-align: top;" | NVARCHAR | NVARCHAR2 | NATIONAL CHAR VARYING | STRING [(L)]
| style="text-align: left; vertical-align: top;" | dtWideString, Len = L
|-
| style="text-align: left; vertical-align: top;" | RAW | TYNIBLOB | VARBINARY | BINARY | BINARY VARYING [(L)]
| style="text-align: left; vertical-align: top;" | dtByteString, Len = L
|-
| style="text-align: left; vertical-align: top;" | BLOB | MEDIUMBLOB | IMAGE | LONGBLOB | LONG BINARY | LONG RAW | LONGVARBINARY | GENERAL | OLEOBJECT | TINYBLOB
| style="text-align: left; vertical-align: top;" | dtBlob
|-
| style="text-align: left; vertical-align: top;" | MEDIUMTEXT | LONGTEXT | CLOB | MEMO | NOTE | LONG | LONG TEXT | LONGCHAR | LONGVARCHAR | TINYTEXT
| style="text-align: left; vertical-align: top;" | dtMemo
|-
| style="text-align: left; vertical-align: top;" | TEXT | NTEXT | WTEXT | NCLOB | NMEMO | LONG NTEXT | LONG WTEXT | NATIONAL TEXT | LONGWCHAR | LONGWVARCHAR | HTML
| style="text-align: left; vertical-align: top;" | dtWideMemo
|-
| style="text-align: left; vertical-align: top;" | XMLDATA | XMLTYPE | XML
| style="text-align: left; vertical-align: top;" | dtXML
|-
| style="text-align: left; vertical-align: top;" | GUID | UNIQUEIDENTIFIER
| style="text-align: left; vertical-align: top;" | dtGUID
|-
| style="text-align: left; vertical-align: top;" | Andere Datentypen
| style="text-align: left; vertical-align: top;" | dtWideString
|}

<blockquote>
'''Hinweis:''' Mit SQLite funktioniert FormatOptions.StrsTrim für alle String-Datentypen.
</blockquote>

===Spezielle SQLite-Datentypen===

Um einer Tabelle eine [http://www.sqlite.org/autoinc.html Auto-Inkrementierungsspalte (EN)] hinzuzufügen, definieren Sie eine Spalte als INTEGER PRIMARY KEY AUTOINCREMENT. Dieser Typ wird zu dtInt32, Attrs = [caAutoInc] zugeordnet. Weitere Einzelheiten über die Behandlung von Auto-Inkrementierungsspalten finden Sie unter [[Auto-Inkrementierungsfelder (FireDAC)|Auto-Inkrementierungsfelder]].

Die Spalten mit den Typnamen ROWID, _ROWID_ oder OID werden als [http://www.sqlite.org/lang_createtable.html#rowid Kennzeichnungsspalten für Zeilen (EN)] betrachtet. Diese Typen werden zu dtInt64, Attrs = [caSearchable, caAllowNull, caROWID] zugeordnet. Weitere Einzelheiten über die Behandlung von Kennzeichnungsspalten für Zeilen finden Sie unter [[Eindeutige Kennzeichnungsfelder (FireDAC)|Eindeutige Kennzeichnungsfelder]]. SQLite ROWID bietet den schnellsten Weg zum Zugreifen auf eine bestimmte Zeile:

<source lang="delphi">
SELECT * FROM Orders WHERE ROWID = :RID
</source>

===Anpassen der FireDAC-Zuordnung===

Bestimmte [[Herstellen einer Verbindung zu SQLite-Datenbanken (FireDAC)|SQLite-Treiberparameter]] ermöglichen, dass in der {{Delphi}}-Anwendung die Datendarstellung geändert wird:

{| border="1" frame="hsides" rules="rows"
|-
! '''Parameter'''
! '''Beschreibung'''
|-
| style="text-align: left; vertical-align: top;" | StringFormat = Choose | Unicode
| style="text-align: left; vertical-align: top;" | Bei Unicode werden alle dtAnsiString- und dtMemo-Daten für einen Client als dtWideString- und dtWideMemo-Daten dargestellt.
|-
| style="text-align: left; vertical-align: top;" | GUIDFormat = String | Binary
| style="text-align: left; vertical-align: top;" | Bei Binary werden dtGUID-Daten in einer Datenbank als binäre TGUID-Werte gespeichert. Bei String werden die Daten als String im Format {xxxxxxx} dargestellt. Für Binary ist weniger Speicherplatz in der DB erforderlich, und String kann einfacher gelesen werden.
|-
| style="text-align: left; vertical-align: top;" | DateTimeFormat = String | Binary
| style="text-align: left; vertical-align: top;" | Bei Binary werden die dtDate-, dtTime-, dtDateTime-Daten in einer Datenbank als double-Wert im Julianischen Datumsformat gespeichert. Bei String werden die Daten als Zeichen-String im Format "jjjj-mm-tt hh24:mi:ss" gespeichert. Für Binary ist weniger Speicherplatz in der DB erforderlich, und String kann einfacher gelesen werden.
|}

<blockquote>
'''Hinweis:''' Wenn die Datenbank nicht leer ist und GUIDFormat oder DateTimeFormat geändert wird, können Fehler auftreten, weil FireDAC möglicherweise die gespeicherten Werte nicht lesen und analysieren kann.
</blockquote>

Bei Ausdrücken in SELECT-Listen vermeidet SQLite Typnamensinformationen. Wenn die Ergebnismenge nicht leer ist, verwendet FireDAC die Wertdatentypen aus dem ersten Datensatz. Wenn die Ergebnismenge leer ist, beschreibt FireDAC diese Spalten als dtWideString. Um den Spaltendatentyp explizit anzugeben, hängen Sie "::<Typname>" an den Spaltenalias an:

<source lang="delphi">
SELECT count(*) as "cnt::INT" FROM mytab
</source>

Wenn für die {{Delphi}}-Anwendung die native SQLite-Datentyprepräsentation erforderlich ist, dann verwendet FireDAC Zuordnungsregeln. Zum Beispiel: Zuordnen von TEXT-Spalten zu dtAnsiString und von INT-Spalten zu dtInt64:
<source lang="delphi">
with FDQuery1.FormatOptions do begin
OwnMapRules := True;
with MapRules do begin
SourceDataType := dtMemo;
TargetDataType := dtAnsiString;
end;
with MapRules do begin
SourceDataType := dtInt32;
TargetDataType := dtInt64;
end;
end;
</source>

===Zahlen mit hoher Genauigkeit===

Aufgrund des [http://www.sqlite.org/datatype3.html SQLite-Typsystems (EN)] wird von langen Zahlen (>= 20 Stellen) angenommen, dass sie eine Affinität zum Typ REAL haben. Deshalb wird ein Wert auf einen REAL-Typ (double-{{Delphi}}-Typ) mit einer Genauigkeit von 15 Stellen gerundet. Um dieses Problem zu lösen, sollte in einer Anwendung TEXT oder ein ähnlicher Datentyp und eine Zuordnungsregel verwendet werden, mit der dtAnsiString in dtFmtBCD oder einen ähnlichen Datentyp umgewandelt wird. Hierbei handelt es sich nicht um ein FireDAC-Problem, und gegenwärtig kann es nicht anders gelöst werden.

==SQL-Anweisungen in SQLite==

===SQL-Dialekt===

SQLite ist nah an ANSI SQL 92 angelehnt, trotzdem werden einige Funktionen und Anweisungen nicht unterstützt, aber andere leistungsstarke wurden hinzugefügt. Weitere Informationen über den SQL.Dialekt von SQLite finden Sie unter:

* [http://www.sqlite.org/lang.html SQL As Understood By SQLite (EN)] (SQL in SQLite).
* [http://www.sqlite.org/omitted.html SQLite / ANSI SQL Commands and Features Not Supported (EN)] (Nicht unterstützte SQLite/ANSI-SQL-Anweisungen und Funktionen).

===SQLite-SQL-Anweisungsstapel===

Der FireDAC SQLite-Treiber unterstützt die [[Anweisungsstapel (FireDAC)|SQL-Anweisungsstapel]]. SQL-Anweisungen müssen durch ";" getrennt werden. In SQLite können Sie beliebige Anweisungen, einschließlich DDL und DML, in einem Stapel zusammen verwenden. Zum Beispiel:

{{#tag:source|
with FDQuery1.SQL do begin

SQL.Clear;
SQL.Add('create table dbms (id integer, name varchar(20));');
SQL.Add('insert into tab values (1, ''sqlite'');');
SQL.Add('insert into tab values (2, ''mysql'');');
SQL.Add('insert into tab values (3, ''firebird'');');
SQL.Add('create table langs (id integer, name varchar(20));');
SQL.Add('insert into tab values (1, ''{{lc:Delphi}}'');');
SQL.Add('insert into tab values (2, ''c'');');
SQL.Add('insert into tab values (3, ''c++'');');
SQL.Add('select * from dbms;');
SQL.Add('select * from langs;');

end;
FDQuery1.Open;
// process here the DBMS list
FDQuery1.NextRecordSet;
// process here the programming languages list
|lang=delphi}}

===SQL-Skriptdialekt===

[[lib_de:FireDAC.Comp.Script.TFDScript|TFDScript]] von FireDAC unterstützt keine Skriptsteuerungsanweisungen der SQLite-Syntax, die mit "." beginnen.

===Array DML===

Ab v 3.7.11 unterstützt SQLite die [http://www.sqlite.org/lang_insert.html Anweisung INSERT (EN)] mit mehreren VALUES. FireDAC implementiert mit diesem Feature [[Array DML (FireDAC)|Array DML]], wenn "Params.BindMode = pbByNumber". Ansonsten emuliert FireDAC Array DML. Zum Beispiel:

<source lang="delphi">
// here ADQuery1.Params collection is filled by 3 parameters
FDQuery1.SQL.Text := 'insert into MyTab values (:p1, :p2, :p3)';
// set "by number" parameter binding mode
FDQuery1.Params.BindMode := pbByNumber;
FDQuery1.Params.ArraySize := 100;
for i := 0 to FDQuery1.Params.ArraySize - 1 do begin
FDQuery1.Params[0].AsIntegers[i] := i;
FDQuery1.Params[1].AsStrings[i] := 'qwe';
FDQuery1.Params[2].Clear(i);
end;
FDQuery1.Execute(FDQuery1.Params.ArraySize);
</source>

==Transaktionen, Sperren, Threads und Cursors in SQLite==

===Sperren und gleichzeitige Aktualisierungen===

Nähere Informationen finden Sie in den Original-SQLite-Artikeln:

* [http://www.sqlite.org/lang_transaction.html BEGIN TRANSACTION (EN)]
* [http://www.sqlite.org/sharedcache.html SQLite Shared-Cache Mode (EN)]
* [http://www.sqlite.org/cvstrac/wiki?p=CorruptionFollowingBusyError Corruption Following Busy (EN)]

SQLite als Dateiserver-DBMS sperrt die Datenbanktabellen bei Aktualisierungen. Die folgenden Einstellungen wirken sich auf den gleichzeitigen Zugriff aus:

* Setzen Sie den Verbindungsparameter '''SharedCache''' auf False, wenn mehrere Threads dieselbe Datenbank aktualisieren. Dadurch werden mögliche Deadlocks vermieden.
* Setzen Sie '''LockingMode''' auf Normal, um den gleichzeitigen Zugriff auf die Tabellen zu ermöglichen, wenn mehrere Prozesse oder Threads dieselben Datenbanktabellen aktualisieren. Setzen Sie außerdem den Verbindungsparameter '''Synchronous''' auf Full oder Normal. Auf diese Weise aktualisiert SQLite eine Datenbankdatei direkt nach dem Abschluss der Transaktion und ermöglicht anderen Verbindungen die Kenntnisnahme über Aktualisierungen auf einer vorhersehbaren Basis.
* Setzen Sie UpdateOptions.LockWait auf True und '''BusyTimeout''' auf einen höheren Wert, um Sperrkonfikte zwischen Verbindungen zu vermeiden.
* Setzen Sie TADConnection.TxOptions.Isolation auf xiSnapshot oder xiSerializible, um Sperrkonfikte zwischen länger laufenden Aktualisierungstransaktionen zu vermeiden.

===Transaktionen und Isolationsmodi===

SQLite unterstützt normale [[Verwalten von Transaktionen (FireDAC)|Transaktionen]] und verschachtelte Transaktionen (Prüfpunkte). Mehrere Transaktionen werden nicht unterstützt. Im Folgenden finden Sie eine Liste der von SQLite unterstützten Isolationsmodi:

{| border="1" frame="hsides" rules="rows"
|-
! '''Modus'''
! '''Entspricht'''
|-
| style="text-align: left; vertical-align: top;" | xiDirtyRead
| style="text-align: left; vertical-align: top;" |[http://www.sqlite.org/pragma.html#pragma_read_uncommitted PRAGMA read_uncommitted (EN)] = 1
|-
| style="text-align: left; vertical-align: top;" | xiReadCommitted
| style="text-align: left; vertical-align: top;" |[http://www.sqlite.org/lang_transaction.html BEGIN TRANSACTION DEFERRED (EN)]
|-
| style="text-align: left; vertical-align: top;" | xiRepeatableRead
| style="text-align: left; vertical-align: top;" | Siehe xiReadCommitted.
|-
| style="text-align: left; vertical-align: top;" | xiSnapshot
| style="text-align: left; vertical-align: top;" | BEGIN TRANSACTION IMMEDIATE
|-
| style="text-align: left; vertical-align: top;" | xiSerializible
| style="text-align: left; vertical-align: top;" | BEGIN TRANSACTION EXCLUSIVE
|}

===Transaktionen und DML-Anweisungen===

Durch das Einfügen von Schreib-Anweisungen in eine Transaktion kann die Leistung von SQLite erheblich gesteigert werden. Dies gilt besonders bei großen Datenänderungen. Dies kann auch für das FireDAC-Feature [[Array DML (FireDAC)|Array DML]] angewendet werden. Fügen Sie daher den Code für die Datenänderung in eine Transaktion ein, um die beste Leistung zu erzielen:

<source lang="delphi">
FDConnection1.StartTransaction;
try
FDQuery1.SQL.Text := 'insert into tab values (:id, :name)';
FDQuery1.Params.ArraySize := 10;
for i := 0 to FDQuery1.Params.ArraySize - 1 do begin
FDQuery1.Params[0].AsIntegers[i] := i;
FDQuery1.Params[0].AsStrings[i] := 'name' + IntTostr(i);
end;
FDQuery1.Execute(FDQuery1.Params.ArraySize, 0);
FDConnection1.Commit;
except
FDConnection1.Rollback;
raise;
end;
</source>

===Transaktionen und Cursors===

In SQLite ist das Zurücksetzen einer Transaktion nicht möglich, wenn Anweisungen mit Ergebnismengen vorhanden sind, die noch nicht abgerufen wurden. Um dies zu vermeiden, ruft FireDAC beim Aufruf der Methode Rollback alle verbleibenden Datensätze aus einer Ergebnismenge ab. Siehe [[lib_de:FireDAC.Stan.Option.TFDFetchOptions.AutoFetchAll|FetchOptions.AutoFetchAll]].

==Erweitern der SQLite-Engine==

===Benutzerdefinierte Funktionen===

SQLite unterstützt das Konzept der gespeicherten Prozeduren oder Funktionen nicht, da Sie die Funktionalität der Engine anhand der Host-Sprache erweitern können. SQLite ermöglicht die Registrierung der Host-Sprachfunktionen in der SQLite-Engine und deren Verwendung in SQL-Anweisungen. FireDAC vereinfacht dies durch Einführung der Komponente [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteFunction|TFDSQLiteFunction]].

Zum Erstellen einer Funktion muss der Entwickler [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteFunction.FunctionName|FunctionName]], [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteFunction.ArgumentsCount|ArgumentsCount]] setzen und die Ereignisbehandlungsroutine [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteFunction.OnCalculate|OnCalculate]] erstellen. Durch Setzen von [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteFunction.Active|Active]] auf True wird die benutzerdefinierte Funktion bei der SQLite-Engine registriert. Zum Beispiel:

<source lang="delphi">
procedure TForm1.FDSQLiteFunction1Calculate(AFunc: TSQLiteFunction;
AInputs: TSQLiteInputs; AOutput: TSQLiteOutput; var AUserData: TObject);
begin
AOutput.AsInteger := AInputs[0].AsInteger * AInputs[1].AsInteger;
end;

FDSQLiteFunction1.DriverLink := FDPhysSQLiteDriverLink1;
FDSQLiteFunction1.FunctionName := 'XmY';
FDSQLiteFunction1.ArgumentsCount := 2;
FDSQLiteFunction1.OnCalculate := FDSQLiteFunction1Calculate;
FDSQLiteFunction1.Active := True;
</source>

Die Verwendung dieser Funktion:
<source lang="delphi">
FDQuery1.Open('select RegionID, XmY(RegionID, 10) from "Region"');
</source>

Eine Funktion kann die FireDAC-Methoden zum Abfragen einer Datenbank aufrufen. Sie müssen denselben [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteFunction.FunctionName|FunctionName]] mit der Standard- oder einer anderen Anzahl an Argumenten angeben, um eine benutzerdefinierte Funktion mit der Standard- oder einer anderen Anzahl an Argumenten zu erstellen. Damit wird in der SQLite-Engine eine überladene Funktion registriert.

Im Ordner "FireDAC\Samples\DBMS Specific\SQLite\UserFunc" finden Sie das obige und andere Funktionsbeispiele.

FireDAC implementiert und installiert für eine SQLite-Verbindung rund [[Erstellen von Ausdrücken (FireDAC)|50 Funktionen]], die in der Praxis für viele DBMSs Standard sind und von der lokalen FireDAC-Ausdrucks-Engine implementiert werden. Beachten Sie bitte, dass Sie beim Einrichten einer SQLite-Verbindung zur Laufzeit die Unit FireDAC.Stan.ExprFuncs in die "uses"-Klausel aufnehmen müssen, sonst wird eine Exception ausgelöst:

<source lang="delphi">
[FireDAC][Phys][SQLite] ERROR: no such function: UCASE.
</source>

Erstellen Sie ein benutzerdefiniertes Entwurfszeit-Package mit einem Datenmodul, legen Sie die Komponenten in diesem Modul ab, und konfigurieren Sie es ordnungsgemäß, damit zur Entwurfszeit auf benutzerdefinierte Funktionen zugegriffen werden kann. Erstellen Sie das Modul im "initialization"-Abschnitt der Modul-Unit, und geben Sie es im "finalization"-Abschnitt frei. Installieren Sie danach Ihr Package in der {{Delphi}}-IDE.

Siehe auch das Video von [http://www.youtube.com/watch?v=2H2r4SIF53c Ron Grove (EN)].

===Benutzerdefinierte Sortierungen===

SQLite speichert und behandelt alle Zeichendaten abhängig vom Verbindungsparameter OpenMode entweder in UTF8 oder UTF16. Wenn SQLite Zeichendaten vergleichen oder sortieren muss, müssen die dafür zu verwendenden Regeln bekannt sein. Diese Regeln ergeben die Sortierung.

SQLite verfügt über mehrere integrierte Sortierungen. Keine davon erzeugt eine korrekte Sortierfolge für deutsche, kyrillische, arabische und andere Ausdrücke. Sie müssen die Komponente [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation|TFDSQLiteCollation]] zum Erstellen einer eigenen Sortierung verwenden. Legen Sie [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation.CollationName|CollationName]], [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation.Flags|Flags]] und [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation.LocaleName|LocaleName]] fest, und setzen Sie dann [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation.Active|Active]] auf True, um die Sortierung bei der SQLite-Engine zu registrieren. Zum Beispiel:

<source lang="delphi">
FDSQLiteCollation1.DriverLink := FDPhysSQLiteDriverLink1;
FDSQLiteCollation1.CollationName := 'UTF16NoCase';
FDSQLiteCollation1.Flags := [sfIgnoreCase];
FDSQLiteCollation1.Active := True;
</source>

Die obige Komponentenkonfiguration mit dem Standardwert [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation.CollationKind|CollationKind]]=scCompareString implementiert eine Unicode-Standardsortierung, die Groß-/Kleinschreibung berücksichtigt. Die Anwendung kann Sortierungen mit [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation.CollationKind|CollationKind]]=scCustomUTF16 oder scCustomUTF8 und der Implementierung der Ereignisbehandlungsroutine [[lib_de:FireDAC.Phys.SQLite.TFDSQLiteCollation.OnCompare|OnCompare]] implementieren. Sie können diese Sortierung folgendermaßen verwenden:
<source lang="sql">
SELECT * FROM "Employees" ORDER BY LastName COLLATE UTF16NoCase
</source>

Um eine Standardsortierung für eine Spalte festzulegen, können Sie folgenden Code verwenden:
<source lang="sql">
CREATE TABLE IF NOT EXISTS test_col (f1 VARCHAR(10) COLLATE UTF16NoCase)
</source>

<blockquote>
'''Hinweis:''' Wenn es keine Möglichkeit gibt, die Standardsortierung für eine Verbindung, eine Datenbank oder eine Tabelle festzulegen. Im Ordner "FireDAC\Samples\DBMS Specific\SQLite\UserCollation" finden Sie die obigen Sortierbeispiele.
</blockquote>

Wenn Sie keine eigenen Sortierungen verwenden, dann verwendet SQLite standardmäßig die binäre Sortierreihenfolge. Für den Modus [[Durchsuchen von Tabellen (FireDAC)|Live-Datenfenster]] von [[lib_de:FireDAC.Comp.Client.TFDTable|TFDTable]] ist es wichtig, dass die Client-Seite und die Datenbank dieselbe Sortierreihenfolge verwendet. Setzen Sie [[lib_de:FireDAC.Stan.Option.TFDFormatOptions.SortLocale|FormatOptions.SortLocale]] auf 0, um die binäre Sortierreihenfolge auf der Client-Seite zu aktivieren.

===Datenbankereignisse===

[[Datenbankwarnungen (FireDAC)|FireDAC unterstützt Benachrichtigungen]] einer {{Delphi}}-Anwendung von einem SQLite-Datenbank-Trigger über bestimmte Ereignisse, z. B. eine Datenänderung. Dazu verwendet FireDAC ein ähnliches Vorgehen wie Firebird und registriert die benutzerdefinierte Funktion POST_EVENT. Gehen Sie folgendermaßen vor, um diese Funktion aus einen Trigger aufzurufen:

<source lang="sql">
CREATE TRIGGER update_orders UPDATE ON "Orders"
BEGIN
SELECT POST_EVENT('Orders');
END;
</source>

Zum Empfangen einer Ereignisbenachrichtigung verwendet die {{Delphi}}-Anwendung die Komponente [[lib_de:FireDAC.Comp.Client.TFDEventAlerter|TFDEventAlerter]]. Zum Beispiel:
<source lang="delphi">
FDEventAlerter1.Names.Text := 'Orders';
FDEventAlerter1.Options.Synchronize := True;
FDEventAlerter1.OnAlter := DoAlert;
FDEventAlerter1.Active := True;

procedure TForm1.DoAlert(ASender: TFDCustomEventAlerter;
const AEventName: String; const AArgument: Variant);
begin
if CompareText(AEventName, 'Orders') = 0 then
qryOrders.Refresh;
end;
</source>

===Benutzerdefinierte Datenquellen===

Die [[Local SQL (FireDAC)|Local SQL]]-Engine ermöglicht die Verwendung von TDataSet-Nachkommen in SQL-Abfragen. FireDAC implementiert Local SQL mittels der [http://www.sqlite.org/vtab.html SQLite-API für virtuelle Tabellen (EN)].

==Fortgeschrittene SQLite-Techniken==

===Einbeziehen von Datenbankaktualisierungen===

SQLite stellt eine spezielle API bereit, die die [http://www.sqlite.org/c3ref/update_hook.html Überwachung aller Datenbankaktualisierungen (EN)] ermöglicht. Damit können beispielsweise alle Aktualisierungen einer DB protokolliert werden. Zur Verwendung dieser API muss in einer {{Delphi}}-Anwendung die Ereignisbehandlungsroutine OnUpdate des Objekts TSQLiteDatabase, dem Objekt zum Kapseln der Datenbankverbindung, festgelegt werden. Beziehen Sie dieses Ereignis nach dem Öffnen der Datenbankverbindung ein. Zum Beispiel:

<source lang="delphi">
procedure TForm1.DoUpdate(ADB: TSQLiteDatabase; AOper: Integer; const ADatabase, ATable: String; ARowid: sqlite3_int64);
begin
Memo1.Lines.Add(Format('%d - %s - %s - %u', [AOper, ADatabase, ATable, ARowid]));
end;

FDConnection1.Connected := True;
TSQLiteDatabase(FDConnection1.ConnectionIntf.CliObj).OnUpdate := DoUpdate;
</source>

Sie finden dieses Beispiel im Ordner "FireDAC\Samples\DBMS Specific\SQLite\OnUpdate".

===Steuern von Datenbankzugriffsrechten===

SQLite ist ein eingebettetes DBMS. Es arbeitet mit einem Einzelbenutzer-DBMS und benötigt keine Konzepte wie "Benutzer", "Zugriffsrechte" usw. Trotzdem kann eine Steuerung der Zugriffsrechte für manche Anwendungen sinnvoll sein, zum Beispiel:

* Eine Anwendung kann Rechte abhängig von einer Endbenutzerlizenz einschränken. Eine Demolizenz beinhaltet weniger Möglichkeiten, eine Volllizenz bietet alle Möglichkeiten.
* Mehrschichtige Datenzugriffs-Frameworks können eigene Konzepte verwenden und Datenzugriffsrechte durch ein generisches Vorgehen steuern.

Auch dafür bietet SQLite ein spezielles Feature, das die [http://www.sqlite.org/c3ref/set_authorizer.html Autorisierung von SQL-Anweisungen zulässt oder nicht (EN)]. Zur Verwendung dieser API muss in einer {{Delphi}}-Anwendung die Ereignisbehandlungsroutine OnAutorize des Objekts TSQLiteDatabase, dem Objekt zum Kapseln der Datenbankverbindung, festgelegt werden. Beziehen Sie dieses Ereignis nach dem Öffnen der Datenbankverbindung ein. Zum Beispiel:

<source lang="delphi">
procedure TForm1.DoAuthorize(ADB: TSQLiteDatabase; ACode: Integer; const AArg1, AArg2, AArg3, AArg4: String; var AResult: Integer);
begin
Memo1.Lines.Add(Format('%d - %s - %s - %s - %s', [ACode, AArg1, AArg2, AArg3, AArg4]));

// Deny any delete operation
if ACode = SQLITE_DELETE then
AResult := SQLITE_DENY
else
AResult := SQLITE_OK;
end;

FDConnection1.Connected := True;
TSQLiteDatabase(FDConnection1.ConnectionIntf.CliObj).OnAutorize := DoAuthorize;
</source>

Sie finden dieses Beispiel im Ordner "FireDAC\Samples\DBMS Specific\SQLite\OnAuthorize".

===Verwenden der Low-Level-API von SQLite===

Wenn Sie die maximale Leistung für SQLite-Datenzugriffe erzielen möchten, dann sollten Sie die Verwendung der Kapselungsklassen der FireDAC SQLite-API in Betracht ziehen. Dabei handelt es sich um eine auf schlanke Low-Level-Objekte bezogene API, die vom FireDAC SQLite-Treiber verwendet wird. Diese API ist nicht dokumentiert und wird nicht offiziell unterstützt.

Das folgende Beispiel zeigt, wie Transaktionen gesteuert und Datensätze mit einer parametrisierten SELECT-Anweisung abgerufen werden:

<source lang="delphi">
uses
FireDAC.Phys.SQLiteWrapper;

procedure TForm1.FormCreate(Sender: TObject);
var
oDB: TSQLiteDatabase;
oTran: TSQLiteStatement;
oStmt: TSQLiteStatement;
i: Integer;
begin
FDConnection1.Connected := True;
oDB := TSQLiteDatabase(FDConnection1.CliObj);

oTran := TSQLiteStatement.Create(oDB);
try
// start transaction
oTran.Prepare('BEGIN');
oTran.Execute;

oStmt := TSQLiteStatement.Create(oDB);
try
// prepare statement
oStmt.Prepare('select * from "Orders" where OrderID > :ID1 and OrderID < :ID2');

// add bind variables (parameters)
for i := 1 to oStmt.ParamDefsCount do
TSQLiteBind.Create(oStmt.Params);

// add column variables (fields)
for i := 1 to oStmt.ColumnDefsCount do
TSQLiteColumn.Create(oStmt.Columns).Index := i - 1;

// set parameter values and execute
oStmt.Params[0].AsInteger := 11000;
oStmt.Params[1].AsInteger := 12000;
oStmt.Execute;

// fetch records and read columns
while oStmt.Fetch do
Memo1.Lines.Add(Format('OrderID: %d, CustomerID: %s',
[oStmt.Columns[0].AsInteger, oStmt.Columns[1].AsString]));
finally
oStmt.Free;
end;

// commit transaction
oTran.Unprepare;
oTran.Prepare('COMMIT');
oTran.Execute;
finally
oTran.Free;
end;
end;
</source>

==Siehe auch==

* [[Herstellen einer Verbindung zu SQLite-Datenbanken (FireDAC)|Herstellen einer Verbindung zu SQLite-Datenbanken]]{{f|radstudio|
* [[Mobile-Tutorial: Verwenden von FireDAC in mobilen Anwendungen (iOS und Android)|Mobile-Tutorial: Verwenden von FireDAC in mobilen Anwendungen (iOS und Android)]]}}
* [[Mobile-Tutorial: Verwenden von FireDAC und SQLite (iOS und Android)|Mobile-Tutorial: Verwenden von FireDAC und SQLite (iOS und Android)]]

===Beispiele===

* [[samp_en:FireDAC.SQLite Sample|FireDAC SQLite]] (Beispiel)

[[Category:FireDAC]]
[[Category:AMMigrate]]

[[en:Using SQLite with FireDAC]]
[[fr:Utilisation de SQLite avec FireDAC]]
[[ja:FireDAC での SQLite の使用]]

Verwenden von Mitteilungen

2016-06-24T10:53:04Z

Esabatell: Updated. LOC-22885

{{Parent|Verwenden der RTL in geräteübergreifenden Anwendungen}}

'''Mitteilungen''' sind Meldungen, die Anwendungen senden, um Informationen oder Warnungen weiterzugeben.

:'''Hinweis:''' In diesem Thema werden '''lokale Mitteilungen''' behandelt, die von Geräteanwendungen gesendete Mitteilungen darstellen; Informationen zu '''Remote-Mitteilungen''' finden Sie unter [[Push-Benachrichtigungen|Push-Benachrichtigungen]].

{{Product}} enthält die Komponente [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]] für die Verwaltung geräteübergreifender Mitteilungen. Die Mitteilungszentrale ermöglicht das Senden von Mitteilungen aus einer ausgeführten Anwendung. Anwendungen können anhand von Mitteilungen den Benutzer über etwas informieren.

Die Komponente [[lib_de:System.Notification.TNotification|TNotification]] ist die Mitteilung, die die Anwendung an die Mitteilungszentrale sendet und die im ausgewiesenen Benachrichtigungsbereich der jeweiligen Plattform angezeigt werden soll.

Sie können Mitteilungen für {{f|vcl|Windows mit der VCL oder für}} Ihre [[Geräteübergreifende Anwendungen - Index|geräteübergreifenden Anwendungen]] mit {{FM}} erstellen.

==Unterstützung von Mitteilungen nach Plattform==

{| class="wikitable"
|-
! '''Element'''
! '''Windows'''
! '''OS X'''
! '''iOS'''
! '''Android'''
|- valign="top"
| '''Plattformunterstützung'''
| style="text-align: center;" | {{V}}

Windows 10 und Windows 8
| style="text-align: center;" | {{V}}

10.8+
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''Name des Benachrichtigungsbereichs'''
| style="text-align: center;" | [https://en.wikipedia.org/wiki/Action_Center Aktionszentrale]
| style="text-align: center;" | [https://en.wikipedia.org/wiki/Notification_Center Mitteilungszentrale]
| style="text-align: center;" | [https://en.wikipedia.org/wiki/Notification_Center Mitteilungszentrale]
| style="text-align: center;" | [http://developer.android.com/guide/topics/ui/notifiers/notifications.html Mitteilungsschublade]
|- valign="top"
| colspan="5" style="background: #d7d7d7;" | '''[[lib_de:System.Notification.TNotification|TNotification]]'''
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.Name|TNotification.Name]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.AlertBody|TNotification.AlertBody]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}

Obligatorisch
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.Title|TNotification.Title]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}

Wenn kein Titel vorhanden ist, wird der App-Name als Titel verwendet.
| style="text-align: center;" | Nicht unterstützt.

Der App-Name wird als Titel verwendet.
| style="text-align: center;" | {{V}}

Wenn kein Titel vorhanden ist, wird der App-Name als Titel verwendet.
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.FireDate|TNotification.FireDate]]'''
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.Number|TNotification.Number]]'''
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | {{V}}

Legt die Zahl auf dem Kennzeichensymbol fest.
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.EnableSound|TNotification.EnableSound]]'''
| style="text-align: center;" | Nicht unterstützt.

Ton ist immer aktiviert.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.AlertAction|TNotification.AlertAction]]'''
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | Nicht unterstützt.
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.HasAction|TNotification.HasAction]]'''
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | Nicht unterstützt.
|- valign="top"
| '''[[lib_de:System.Notification.TNotification.RepeatInterval|TNotification.RepeatInterval]]'''
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| colspan="5" style="background: #d7d7d7;" | '''[[lib_de:System.Notification.TCustomNotificationCenter|TCustomNotificationCenter]]'''
|- valign="top"
| '''[[lib_de:System.Notification.TCustomNotificationCenter.ApplicationIconBadgeNumber|TCustomNotificationCenter.ApplicationIconBadgeNumber]]'''
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | Nicht unterstützt.

Siehe [[samp_en:OSX Dock Badges (Delphi)|OS X Badge (Beispiel) (EN)]].
| style="text-align: center;" | {{V}}
| style="text-align: center;" | Nicht unterstützt.
|- valign="top"
| '''[[lib_de:System.Notification.TCustomNotificationCenter.ScheduleNotification|TCustomNotificationCenter.ScheduleNotification]]'''
| style="text-align: center;" | Nicht unterstützt.
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|- valign="top"
| '''[[lib_de:System.Notification.TCustomNotificationCenter.PresentNotification|TCustomNotificationCenter.PresentNotification]]'''
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
| style="text-align: center;" | {{V}}
|}

===Windows-Mitteilungen===

Popupbenachrichtigungen sind mit den folgenden Windows-Versionen kompatibel:

* '''Windows 8''': Windows 8 zeigt die Benachrichtigungen eine kurze Zeit lang an, danach kann der Benutzer nicht mehr darauf zugreifen.
* '''Windows 10''': Windows 10 zeigt die Benachrichtigungen eine kurze Zeit lang an, danach sind die Benachrichtigungen in der '''Aktionszentrale''' verfügbar.

Um die Aktionszentrale zum Anzeigen der Benachrichtigungen zu öffnen, klicken Sie in der Taskleiste auf das Symbol "Aktionszentrale". Je nachdem, ob Benachrichtigungen verfügbar sind, wird das Symbol unterschiedlich dargestellt:

:
{| class="wikitable"
|-
! Ausstehende Benachrichtigungen
! Keine ausstehenden Benachrichtigungen
|- valign="center"
| style="text-align: center" | [[File:W10-NotificationsPending.png]]
| style="text-align: center" | [[File:W10-NoNotificationsPending.png]]
|}

===OS X-Mitteilungen===

OS X unterstützt Mitteilungen ab der Version 10.8. Weitere Informationen über OS X finden Sie unter [[Verwenden der OS X-Mitteilungszentrale|Verwenden der OS X-Mitteilungszentrale]].

===iOS-Mitteilungen===

====Berechtigungen für Mitteilungen====

Fügen Sie Ihrer Anwendung Mitteilungsberechtigungen hinzu, um Mitteilungen in iOS verwenden zu können:

# Wählen Sie {{Menu|Projekt > Optionen > [[Versionsinformationen|Versionsinformationen]]}}
# Wählen Sie die entsprechende iOS-Zielplattform aus.
# Setzen Sie im Listenfeld "Schlüssel-Wert" den Wert von {{Code|FMLocalNotificationPermission}} auf {{True}}.

: [[File:FMLocalNotificationPermission.png]]

====Mitteilungshinweis====

In iOS kann der Benutzer festlegen, ob Mitteilungen einer App als Banner oder als Hinweis angezeigt werden. Banner werden nur eine kurze Zeit lang auf dem Bildschirm angezeigt, aber Hinweise verbleiben auf dem Bildschirm, bis der Benutzer eine Interaktion mit dem Hinweis ausführt.

Um Mitteilungen als Hinweise anzuzeigen, muss der Endbenutzer in den Mitteilungseinstellungen auf dem iOS-Gerät, die Einstellung '''Hinweisstil''' in '''Hinweise''' ändern.

==Erstellen von Mitteilungen==

Mitteilungen werden mit der Klasse [[lib_de:System.Notification.TNotification|TNotification]] erstellt. Zum Verwalten einer oder mehrerer [[lib_de:System.Notification.TNotification|TNotification]]-Instanzen benötigen Sie die Komponente [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]].

Nachdem Sie eine [[lib_de:System.Notification.TNotificationCenter|TNotificationCenter]]-Komponente auf Ihrem Formular platziert haben, können Sie die Variable <code>TNotification</code> deklarieren und die Methode [[lib_de:System.Notification.TCustomNotificationCenter.CreateNotification|CreateNotification]] zum Erstellen der Mitteilung aufrufen.

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
MyNotification:= NotificationCenter1.CreateNotification;
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
TNotification *MyNotification = NotificationCenter1->CreateNotification();
</source><l e="cpp" />

Nach dem Erstellen der Mitteilung sollten Sie mindestens die folgenden Felder festlegen:

* [[lib_de:System.Notification.TNotification.Name|Name]]: Eindeutiger Name der Mitteilung.
* [[lib_de:System.Notification.TNotification.AlertBody|AlertBody]]: Text des Steuerelements. Das Feld <code>AlertBody</code> ist in iOS obligatorisch.

Sie können andere Einstellungen für Ihre Mitteilungen verwalten:

* [[lib_de:System.Notification.TNotification.Title|Title]]: Titel der Mitteilung.
iOS ist mit dem Feld <code>Title</code> nicht kompatibel; iOS zeigt immer den App-Namen als Titel an.

* [[lib_de:System.Notification.TNotification.Number|Number]]: Mit diesem Feld aktualisieren Sie die Mitteilungsnummer in Android oder die Zahl auf dem Anwendungskennzeichen in iOS.

* [[lib_de:System.Notification.TCustomNotificationCenter.ApplicationIconBadgeNumber|ApplicationIconBadgeNumber]]: Mit dieser Eigenschaft aktualisieren Sie die Zahl auf dem Anwendungskennzeichen in iOS.

:
{| class="wikitable"
|-
! '''Zahl auf dem iOS-Kennzeichensymbol'''
! '''Android-Mitteilungsnummer'''
|- valign="center"
| [[File:IOSNotification.PNG|120px]]
| [[File:Android Notification with number.png]]
|}

==Auslösen von Mitteilungen==

Mit [[lib_de:System.Notification.TNotification.FireDate|FireDate]] legen Sie das [[lib_de:System.TDateTime|Datum und die Uhrzeit]] fest, zu der die Mitteilung ausgelöst werden soll.

Um die Zeit festzulegen, zu der die Mitteilung ausgelöst werden soll, können Sie zwei Typen von Mitteilungen erstellen.

* [[#Sofortige Mitteilungen|Sofortige Mitteilungen]]
* [[#Geplante Mitteilungen|Geplante Mitteilungen]]

===Sofortige Mitteilungen===

Standardmäßig ist [[lib_de:System.Notification.TNotification.FireDate|FireDate]] auf [[lib_de:System.SysUtils.Now|Now]] gesetzt. Wenn Sie den Wert von [[lib_de:System.Notification.TNotification.FireDate|FireDate]] nicht ändern, wird daher die Mitteilung sofort ausgelöst.

===Geplante Mitteilungen===

Der Zeitpunkt, zu dem Mitteilungen ausgelöst werden, kann geplant werden. Setzen Sie [[lib_de:System.Notification.TNotification.FireDate|FireDate]] auf das [[lib_de:System.TDateTime|Datum und die Uhrzeit]], zu der die Mitteilung ausgelöst werden soll.

====Auslösen von Mitteilungen zu einem bestimmten Zeitpunkt====

Sie können festlegen, dass eine Mitteilung zu einem bestimmten Zeitpunkt ausgelöst werden muss. Wenn eine Mitteilung beispielsweise am ''16. Dezember 2015, um 17:30'', ausgelöst werden soll, können Sie [[lib_de:System.Notification.TNotification.FireDate|FireDate]] wie folgt festlegen:

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
MyNotification.FireDate := EncodeDateTime(2015, 12, 16, 17, 30, 00, 00);
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
MyNotification->FireDate = System::Dateutils::EncodeDateTime(2015, 12, 16, 17, 30, 00, 00);
</source><l e="cpp" />

Denken Sie beim Planen von Mitteilungen für einen bestimmten Zeitpunkt daran, dass die Mitteilung sofort ausgelöst wird, wenn das festgelegte <code>FireDate</code> bereits vorüber ist.

====Auslösen von Mitteilungen nach einer bestimmten Zeitspanne====

Sie können festlegen, dass eine Mitteilung nach einer bestimmten Zeitspanne ausgelöst werden muss. Um die Mitteilung beispielsweise in 1 Minute und 30 Sekunden auszulösen, können Sie Folgendes angeben:

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
MyNotification.FireDate := Now + EncodeTime(0, 1, 30, 0);
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
MyNotification->FireDate = Now() + EncodeTime(0, 1, 30, 0);
</source><l e="cpp" />

Wenn eine Mitteilung geplant ist und Sie eine andere Mitteilung mit dem gleichen Namen (geplant oder nicht) erstellen, wird die geplante Mitteilung überschrieben.

==Wiederholen von Mitteilungen==

Sie können mit [[lib_de:System.Notification.TNotification.RepeatInterval|RepeatInterval]] geplante Mitteilungen nach einer bestimmten Zeitspanne wiederholen. Dazu stehen die folgenden von [[lib_de:System.Notification.TRepeatInterval|TRepeatInterval]] definierten Intervalltypen zur Verfügung: <code>None</code>, <code>Second</code>, <code>Minute</code>, <code>Hour</code>, <code>Day</code>, <code>Week</code>, <code>Weekday</code>, <code>Month</code>, <code>Quarter</code>, <code>Year</code> oder <code>Era</code>.

:'''Warnung:''' Wenn Sie mit <code>RepeatInterval</code> die Wiederholung einer Mitteilung nach einer bestimmten Zeitspanne planen, wird die Mitteilung weiterhin wiederholt, auch wenn die Anwendung geschlossen ist; achten Sie darauf, dass [[#Stornieren von Mitteilungen|Mitteilungen korrekt storniert werden]].

Damit eine Mitteilung jede Stunde wiederholt wird, könnten Sie beispielsweise Folgendes angeben:

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
MyNotification.RepeatInterval := TRepeatInterval.Hour;
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
MyNotification->RepeatInterval = TRepeatInterval::Hour;
</source><l e="cpp" />

==Mitteilungston==

===Aktivieren von Mitteilungstönen===

Sie können Töne mit [[lib_de:System.Notification.TNotification.EnableSound|EnableSound]] aktivieren oder deaktivieren. Standardmäßig ist <code>EnableSound</code> auf {{True}} gesetzt.

* Bei '''OS X''' und '''iOS''' wird, selbst wenn Töne aktiviert sind, der Mitteilungston nicht abgespielt, wenn sich die Anwendung im Vordergrund befindet; OS X und iOS spielen den Mitteilungston ab, wenn sich die Anwendung im Hintergrund befindet oder geschlossen ist.
* Bei '''Windows''' wird der Mitteilungston immer abgespielt; auch wenn Sie den Ton mit <code>EnableSound</code> deaktivieren.

===Anpassen von Mitteilungstönen===

Sie können den Ton Ihrer Mitteilungen anpassen, indem Sie [[lib_de:System.Notification.TNotification.SoundName|SoundName]] festlegen.

Führen Sie die folgenden Schritte aus, um einen benutzerdefinierten Mitteilungston hinzuzufügen:

# Ziehen Sie in der [[Projektverwaltung|Projektverwaltung]] die Tondatei auf dem Namen Ihres Projekts, und bestätigen Sie, dass Sie diese Datei hinzufügen möchten.
# Geben Sie in {{Menu|Projekt > [[Bereitstellungs-Manager|Bereitstellung]]}} die richtigen Remote-Pfade der Datei für die verschiedenen Plattformen an.
#* '''iOS:'''{{Path|.\}}
# Geben Sie den benutzerdefinierten Tonnamen an, und legen Sie <code>SoundName</code> der Plattform entsprechend fest.

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
{$IFDEF IOS}
MyNotification.SoundName := 'nameOfSound.caf';
{$ENDIF}
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
#if defined(_PLAT_IOS)
myNotification->SoundName = "nameOfSound.caf";
#endif
</source><l e="cpp" />

:'''Hinweis:''' Laut der iOS-Dokumentation sollte die Tondatei die Dateierweiterung {{Path|aiff}}, {{Path|wav}} oder {{Path|caf}} haben.

Achten Sie darauf, Ihrem Projekt die richtige Unit hinzuzufügen:

<l s="delphi" />'''{{Delphi}}:''' Fügen Sie [[lib_de:System.IOUtils|System.IOUtils]] in die uses-Klausel ein.
<source lang="delphi">
System.IOUtils;
</source><l e="delphi" />

<l s="cpp" />'''C++:''' Fügen Sie [[lib_de:System.IOUtils|System.IOUtils.hpp]] in die Header-Datei {{Path|.h}} Ihres Projekts ein.
<source lang="cpp">
#include <System.IOUtils.hpp>
</source><l e="cpp" />

Wenn das Gerät die benutzerdefinierte Tondatei, die Sie in Ihrem Projekt festgelegt haben, nicht finden kann, spielt iOS den Standardton, Android dagegen keinen Ton ab.

==Mitteilungsaktionen==

Durch Klicken auf die Mitteilungen in '''OS X''', '''iOS''' oder '''Android''' wird die Anwendung, die die Mitteilung gesendet hat, in den Vordergrund gesetzt, unabhängig davon, ob diese Anwendung im Hintergrund ausgeführt wird oder geschlossen ist.

Für '''Windows''' ist kein bestimmtes Verhalten vorgesehen, wenn der Benutzer auf die Mitteilung klickt.

===Hinzufügen von Mitteilungsaktionen===

Sie können Aktionen ausführen, wenn der Benutzer auf eine Mitteilung klickt. Beim Klicken auf eine Mitteilung wird das Ereignis [[lib_de:System.Notification.TNotificationCenter.OnReceiveLocalNotification|OnReceiveLocalNotification]] ausgelöst. Schreiben Sie eine Ereignisbehandlungsroutine, um eine Aktion festzulegen.

Die Ereignisbehandlungsroutine für <code>OnReceiveLocalNotification</code> empfängt auch die im Parameter {{Arg|ANotification}} angegebene TNotitication, auf die der Benutzer klickt; mit dem Parameter {{Arg|ANotification}} ermitteln Sie weitere Einzelheiten über die Mitteilung, auf die der Benutzer geklickt hat.

So zeigen Sie eine Meldung gemäß der Mitteilung, auf die der Benutzer geklickt hat, an:

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
if ANotification.Name='ProcessCompleted' then
ShowMessage('The process is completed.');
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
if (ANotification->Name == "ProcessCompleted") {
ShowMessage("The process is completed.");
}
</source><l e="cpp" />

===Mitteilungsaktionen (OS X und iOS)===

Sie können einem Hinweis eine Aktions-Schaltfläche hinzufügen, mit der der Benutzer die Anwendung öffnen kann. Dazu muss der Benutzer in den Mitteilungseinstellungen den Stil der Mitteilung auf "Hinweise" festlegen; weitere Informationen dazu finden Sie unter [[Verwenden der OS X-Mitteilungszentrale#Verwenden der OS X-Mitteilungszentrale|Mitteilungshinweise in OS X]] und [[#Mitteilungshinweis|Mitteilungshinweise in iOS]].

Um eine Aktions-Schaltfläche hinzuzufügen, setzen Sie das Feld [[lib_de:System.Notification.TNotification.HasAction|HasAction]] auf {{True}}. Im Feld [[lib_de:System.Notification.TNotification.AlertAction|AlertAction]] können Sie den Text für die Schaltfläche angeben.

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
MyNotification.HasAction := True;
MyNotification.AlertAction := 'Open App';
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
MyNotification->HasAction = True;
MyNotification->AlertAction = "Open App";
</source><l e="cpp" />

==Senden von Mitteilungen an die Mitteilungszentrale==

Wenn Sie alle Einstellungen für Ihre Mitteilung konfiguriert haben, müssen Sie Ihre Mitteilung an die Mitteilungszentrale zur Verarbeitung senden.

Sie können Mitteilungen an die Mitteilungszentrale mit einer der beiden folgenden Methoden senden.

* [[#ScheduleNotification|ScheduleNotification]]
* [[#PresentNotification|PresentNotification]]

===ScheduleNotification===

[[lib_de:System.Notification.TCustomNotificationCenter.ScheduleNotification|ScheduleNotification]] sendet eine geplante Mitteilung an die Mitteilungszentrale. Wenn [[lib_de:System.Notification.TNotification.FireDate|FireDate]] [[lib_de:System.SysUtils.Now|Now]] ist oder <code>FireDate</code> einen vergangenen Zeitpunkt (TDateTime) enthält, dann wird die Mitteilung sofort angezeigt; ansonsten wird die Mitteilung wie angegeben geplant.

: '''Warnung:''' Windows unterstützt <code>ScheduleNotification</code> nicht.

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
NotificationCenter1.ScheduleNotification(MyNotification);
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
NotificationCenter1->ScheduleNotification(MyNotification);
</source><l e="cpp" />

===PresentNotification===

[[lib_de:System.Notification.TCustomNotificationCenter.PresentNotification|PresentNotification]] zeigt die Mitteilung sofort an, unabhängig vom Wert von [[lib_de:System.Notification.TNotification.FireDate|FireDate]].

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
NotificationCenter1.PresentNotification(MyNotification);
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
NotificationCenter1->PresentNotification(MyNotification);
</source><l e="cpp" />

==Stornieren von Mitteilungen==

Sie können Mitteilungen, die geplant sind, und Mitteilungen, die wiederholt werden, stornieren sowie Mitteilungen entfernen, die bereits in der Aktionszentrale, der Mitteilungszentrale oder der Mitteilungsschublade angezeigt werden.

===CancelNotification===

Mit [[lib_de:System.Notification.TCustomNotificationCenter.CancelNotification|CancelNotification]] wird eine geplante Mitteilung oder eine Mitteilung, die wiederholt wird, storniert. Um eine Mitteilung zu stornieren, benötigen Sie den [[lib_de:System.Notification.TNotification.Name|Namen]] der Mitteilung.

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
NotificationCenter1.CancelNotification('MyNotificationName');
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
NotificationCenter1->CancelNotification("MyNotificationName");
</source><l e="cpp" />

===CancelAll===

[[lib_de:System.Notification.TCustomNotificationCenter.CancelAll|CancelAll]] storniert alle Mitteilungen:

:
:* Geplante Mitteilungen werden nicht ausgelöst.
:* Mitteilungen mit einem Wiederholungsintervall werden storniert.
:* Mitteilungen, die in der Aktionszentrale, der Mitteilungszentrale oder der Mitteilungsschublade für diese Anwendung verfügbar sind, werden gelöscht.

<l s="delphi" />'''{{Delphi}}: '''
<source lang="delphi">
NotificationCenter1.CancelAll;
</source><l e="delphi" />

<l s="cpp" />'''C++: '''
<source lang="cpp">
NotificationCenter1->CancelAll();
</source><l e="cpp" />

==Aktualisieren von Mitteilungen==

Sie können ausstehende Mitteilungen anhand des <code>Namens</code>, des eindeutigen Bezeichners der Mitteilung, aktualisieren. Führen Sie die folgenden Schritte aus, um eine Mitteilung zu aktualisieren:

# [[#Erstellen von Mitteilungen|Erstellen Sie eine Instanz von TNotification]] mit dem gleichen <code>Namen</code> wie die zu aktualisierende Mitteilung.
# Konfigurieren Sie die neue Instanz mit den gewünschten Einstellungen.
# [[#Senden von Mitteilungen an die Mitteilungszentrale|Senden Sie die Mitteilung an die Mitteilungszentrale]].

Durch die Aktualisierung von zukünftigen Mitteilungen, geplanten Mitteilungen oder Mitteilungen mit einem Wiederholungsintervall werden die Mitteilungen, die sich bereits in der Aktionszentrale, der Mitteilungszentrale oder der Mitteilungsschublade befinden, gelöscht und zukünftige Mitteilungen überschrieben.

==Siehe auch==

* [[Verwenden der OS X-Mitteilungszentrale|Verwenden der OS X-Mitteilungszentrale]]
* [[Mobile-Tutorial: Verwenden von Mitteilungen (iOS und Android)|Mobile-Tutorial: Verwenden von Mitteilungen (iOS und Android)]]
* [[Push-Benachrichtigungen|Push-Benachrichtigungen]]
* [[lib_de:System.Notification.TNotification|System.Notification.TNotification]]
* [[lib_de:System.Notification.TNotificationCenter|System.Notification.TNotificationCenter]]

===Codebeispiele===

* [[samp_en:FMX.SendCancelNotification Sample|{{FM}} Send Cancel Notification (EN)]] (Beispiel)
* [[samp_en:FMX.Android Notification Service Sample|{{FM}} Android Notification Service (EN)]] (Beispiel)
* [[samp_en:FMX.SetResetBadgeNumber Sample|{{FM}} Set Reset Badge Number (EN)]] (Beispiel)
* [[samp_en:OSX Dock Badges (Delphi)|OSX Dock Badges (EN)]] (Delphi)
* [[samp_en:FMX.Notification.Mac (Delphi)|{{FM}} Notification Mac (EN)]] (Delphi)
* [[samp_en:FMX.Notification.Mac (C++)|{{FM}} Notification Mac (EN)]] (C++)

[[Category:C++]]
[[Category:Delphi]]
[[Category:Geräteübergreifend]]
[[Category:AMMigrate]]

[[en:Using Notifications]]
[[fr:Utilisation de notifications]]
[[ja:通知の使用]]

Verwenden von Hinweisen zum Anzeigen von Kontexthilfe in einer FireMonkey-Anwendung

2016-06-24T10:52:41Z

Esabatell: Updated. LOC-22885

{{Parent|FireMonkey-Anwendungsdesign}}

Auf dieser Seite wird beschrieben, wie Sie Hinweise in einer {{FM}}-Anwendung verwenden. Außerdem finden Sie hier einige Codefragmente.

==Plattformunterstützung für Hinweise==

{| class="wikitable" style="text-align: center;"
|-
! Plattform
! Unterstützt
|- valign="top"
|
Windows
|
{{V}}
|- valign="top"
|
OS X
|
{{V}} (10.10+)
|- valign="top"
|
iOS
|
|- valign="top"
|
Android
|
|}

==Aktivieren von Hinweisen==

===Aktivieren von Hinweisen für Ihre Anwendung===

In Ihrer Anwendung können standardmäßig Hinweise angezeigt werden. Die Eigenschaft, mit der die Anzeige von Hinweisen aktiviert/deaktiviert wird, ist [[lib_de:FMX.Forms.TApplication.ShowHint|TApplication.ShowHint]]. Dabei handelt es sich um eine globale Einstellung, die alle hinweisbezogenen Aktionen, wie die Anzeige von Hinweisen und hinweisbezogene Ereignisse, betrifft.
Verwenden Sie den folgenden Code, um Hinweise für Ihre Anwendung zu deaktivieren:
<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
Application.ShowHint := False;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
Application->ShowHint = false;
</source><l e="cpp" />

===Aktivieren von Hinweisen für ein Steuerelement===

Führen Sie einen der folgenden Schritte aus, um Hinweise für das aktuelle Steuerelement zu aktivieren:

* Setzen Sie [[lib_de:FMX.Controls.TControl.ShowHint|ShowHint]] des Steuerelements auf '''True'''.
* Setzen Sie [[lib_de:FMX.Controls.TControl.ParentShowHint|ParentShowHint]] des Steuerelements auf '''True''' und [[lib_de:FMX.Controls.TControl.ShowHint|ShowHint]] des übergeordneten Steuerelements ebenfalls auf '''True'''.

:'''Hinweis:''' [[lib_de:FMX.Controls.TControl.ShowHint|ShowHint]] und [[lib_de:FMX.Controls.TControl.ParentShowHint|ParentShowHint]] des Steuerelements dürfen nicht gleichzeitig {{True}} sein.

====Vererbung von ParentShowHint====

Wenn Sie ein Steuerelement auf dem Formular platzieren und einen Hinweis für dieses Steuerelement festlegen, ist der Hinweis standardmäßig aktiviert. Und zwar, weil [[lib_de:FMX.Forms.TForm.ShowHint|TForm.ShowHint]] standardmäßig {{True}} ist und [[lib_de:FMX.Controls.TControl.ParentShowHint|ParentShowHint]] des Steuerelements ebenfalls standardmäßig {{True}} ist.

Wenn Sie jedoch ein anderes Steuerelement als untergeordnetes Steuerelement des vorherigen hinzufügen und einen Hinweis für das neue Steuerelement festlegen, wird dieser Hinweis aufgrund der Nichtbeachtung der im Abschnitt [[#Aktivieren von Hinweisen für ein Steuerelement|Aktivieren von Hinweisen für ein Steuerelement]] dargestellten Regeln nicht standardmäßig angezeigt. In diesem Fall ist [[lib_de:FMX.Controls.TControl.ParentShowHint|ParentShowHint]] des untergeordneten Steuerelements {{True}}, aber [[lib_de:FMX.Controls.TControl.ShowHint|ShowHint]] des übergeordneten Steuerelements ist {{False}}. Ändern Sie eine dieser Eigenschaften entsprechend der [[#Aktivieren von Hinweisen für ein Steuerelement|Regeln]] zum Aktivieren von Hinweisen für das untergeordnete Steuerelement.

==Festlegen von Hinweisen==

Sie können den Hinweistext beim Entwurf im [[Objektinspektor|Objektinspektor]] in die Eigenschaft [[lib_de:FMX.Controls.TControl.Hint|Hint]] eines Steuerelements eingeben, oder Sie können einen Hinweis zur Laufzeit programmseitig festlegen. Der folgende Code zeigt, wie ein Hinweis für eine [[lib_de:FMX.StdCtrls.TButton|Schaltfläche]] festgelegt und aktiviert wird:
<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
Button1.Hint := 'This is a button';
Button1.ShowHint := True;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
Button1->Hint = "This is a button";
Button1->ShowHint = true;
</source><l e="cpp" />

===Kurze und lange Hinweise===

Sie können für denselben Hinweis einen kurzen und einen langen Text festlegen. Trennen Sie dazu die beiden Texte einfach durch einen senkrechten Strich ('''|''' Pipe). Zum Beispiel:

A hint|A much longer hint

Wenn Sie einen Hinweis anzeigen, können Sie mit den folgenden Methoden aus der Unit [[lib_de:FMX.Utils|FMX.Utils]] entweder den kurzen oder den langen Teil des Hinweises abrufen:

* [[lib_de:FMX.Utils.GetLongHint|GetLongHint]]
* [[lib_de:FMX.Utils.GetShortHint|GetShortHint]]

:'''Hinweis:''' Sie müssen dem uses-Abschnitt/der Header-Datei im [[Quelltext-Editor|Quelltext-Editor]] die Unit [[lib_de:FMX.Utils|FMX.Utils]] hinzufügen.

Wenn Sie für Ihren Hinweis keinen kurzen oder langen Teil festgelegt haben, wird durch Aufruf der obigen Methoden dasselbe Ergebnis, nämlich der gesamte Hinweistext, zurückgegeben.

Der folgende Code zeigt, wie der lange Hinweis in der Ereignisbehandlungsroutine [[lib_de:FMX.Forms.TApplication.OnHint|TApplication.OnHint]] abgerufen wird:
<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
procedure TForm1.OnApplicationHint(Sender: TObject);
begin
Label1.Text := GetLongHint(Application.Hint);
end;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
void _fastcall TForm1::OnApplicationHint(TObject* Sender);
{
Label1->Text = GetLongHint(Application->Hint);
}
</source><l e="cpp" />

==Hinweise und Ereignisse==

Bei jedem Auslösen eines Hinweises wird das Ereignis [[lib_de:FMX.Forms.TApplication.OnHint|TApplication.OnHint]] ausgelöst. Mit diesem Ereignis können Sie alle Hinweise in Ihrer Anwendung abfangen und verwenden. Beispielsweise können Sie dem Ereignis [[lib_de:FMX.Forms.TApplication.OnHint|TApplication.OnHint]] eine benutzerdefinierte Ereignisbehandlungsroutine zuweisen und damit alle Hinweise in einer Beschriftung anzeigen:
<l s="delphi" />'''{{Delphi}}:''' 
Deklarieren der benutzerdefinierten Ereignisbehandlungsroutine:
<source lang="delphi">
private
{ Private declarations }
procedure OnApplicationHint(Sender: TObject);
</source>
Hinzufügen der Implementierung:
<source lang="delphi">
procedure TForm1.FormCreate(Sender: TObject);
begin
Application.OnHint := OnApplicationHint;
end;

procedure TForm1.OnApplicationHint(Sender: TObject);
begin
Label1.Text := Application.Hint;
end;
</source><l e="delphi" />

<l s="cpp" />'''C++:''' 
Hinzufügen der folgenden Deklaration zur Projekt-Header-Datei:
<source lang="cpp">
private: // User declarations
void __fastcall OnApplicationHint(TObject* Sender);
</source>
Die Implementierung des benutzerdefinierten Ereignisses:
<source lang="cpp">
__fastcall TForm1:FormCreate(TObject* Sender);
{
Application->OnHint = OnApplicationHint;
}

void __fastcall TForm1:OnApplicationHint(TObject* Sender);
{
Label1->Text = Application->Hint;
}
</source><l e="cpp" />

===Unterdrücken von Hinweisen===

Möglicherweise möchten Sie die Anzeige eines Hinweises unterdrücken, diesen Hinweis aber dennoch abfangen. Sie erreichen dies durch Aufrufen von [[lib_de:FMX.Forms.TApplication.HideHint|TApplication.HideHint]] in der Ereignisbehandlungsroutine [[lib_de:FMX.Forms.TApplication.OnHint|TApplication.OnHint]]:
<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
procedure TForm1.OnApplicationHint(Sender: TObject);
begin
Label1.Text := Application.Hint;
Application.HideHint;
end;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
void __fastcall TForm1:OnApplicationHint(TObject* Sender);
{
Label1->Text = Application->Hint;
Application->HideHint;
}
</source><l e="cpp" />

==Besondere Aspekte==

Es gibt einige Ausnahmen und besondere Anwendungsfälle, die Sie bei der Verwendung von Hinweisen berücksichtigen sollten.

===Menüs===

Sie können für [[lib_de:FMX.Menus.TMenuItem|Menüeinträge]] Hinweise festlegen, aber sie werden nicht wie bei anderen Steuerelementen angezeigt, sondern an die Ereignisbehandlungsroutine weitergegeben. Wenn Sie also einen Hinweis für einen Menüeintrag festlegen, können Sie ihn mit einer benutzerdefinierten [[lib_de:FMX.Forms.TApplication.OnHint|TApplication.OnHint]]-Ereignisbehandlungsroutine abfangen und anzeigen. Hinweise für Menüeinträge können nicht deaktiviert werden. Wenn Sie einen Hinweis für einen Menüeintrag deaktivieren möchten, weisen Sie als Hinweis einen leeren String zu.

:'''Hinweis:''' Menüeinträge der obersten Ebene unterstützen keine Hinweise.

===Statuszeile===

Ein Sonderfall in Bezug auf Hinweise stellt das Steuerelement [[lib_de:FMX.StdCtrls.TStatusBar|TStatusBar]] dar. Wenn Sie Ihrer Anwendung eine Statuszeile hinzufügen und die Eigenschaft [[lib_de:FMX.StdCtrls.TStatusBar.AutoHint|TStatusBar.AutoHint]] auf {{True}} setzen, empfängt das Ereignis [[lib_de:FMX.StdCtrls.TStatusBar.OnHint|TStatusBar.OnHint]] automatisch alle Hinweise.

Verwenden Sie diesen Code in der Ereignisbehandlungsroutine, um Hinweise in einer Beschriftung anzuzeigen, wenn Ihr Formular über eine Statuszeile verfügt:
<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
procedure TForm1.StatusBar1Hint(Sender: TObject);
begin
Label1.Text := Application.Hint;
end;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
__fastcall TForm1:StatusBar1Hint(TObject* Sender);
{
Label1->Text = Application->Hint;
}
</source><l e="cpp" />

====Gleichzeitiges Verwenden beider OnHint-Ereignisse====

Wenn Sie eine benutzerdefinierte [[lib_de:FMX.Forms.TApplication.OnHint|TApplication.OnHint]]-Ereignisbehandlungsroutine in einer Anwendung mit einer Statuszeile festlegen, wird das Ereignis [[lib_de:FMX.StdCtrls.TStatusBar.OnHint|TStatusBar.OnHint]] ungeachtet der Eigenschaft [[lib_de:FMX.StdCtrls.TStatusBar.AutoHint|TStatusBar.AutoHint]] nicht ausgelöst. Wenn Sie dennoch beide Ereignisse verwenden möchten, können Sie dies durch Aufrufen von [[lib_de:FMX.StdCtrls.TStatusBar.OnHint|TStatusBar.OnHint]] aus der [[lib_de:FMX.Forms.TApplication.OnHint|TApplication.OnHint]]-Ereignisbehandlungsroutine erreichen.

<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
procedure TForm1.OnApplicationHint(Sender:TObject);
begin
Label1.Text := Application.Hint;
StatusBar1Hint(Sender);
end;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
void __fastcall TForm1:OnApplicationHint(TObject* Sender);
{
Label1->Text = Application->Hint;
StatusBar1Hint(Sender);
}
</source><l e="cpp" />

===Aktionen===

[[FireMonkey-Aktionen|{{FM}}-Aktionen]] unterstützen ebenfalls Hinweise. Sie können einen Hinweis für eine Aktion angeben, und dieser Hinweis wird für alle Steuerelemente, die diese Aktion verwenden, übernommen. Sie können Aktionshinweise nicht deaktivieren (sie verfügen nicht über die Eigenschaft {{Code|ShowHint}}). Die globale [[lib_de:FMX.Forms.TApplication.ShowHint|TApplication.ShowHint]]-Einstellung betrifft auch Aktionen.

====Festlegen von Aktionshinweisen====

Sie können einen Hinweis für eine Aktion im [[Objektinspektor|Objektinspektor]] oder zur Laufzeit festlegen. Ein Beispiel zur Definition eines Hinweises für eine Aktion zur Laufzeit finden Sie unter [[#Aktionsereignis OnHint |Aktionsereignis OnHint]]. Sie müssen aber trotzdem Hinweise für dieses Steuerelement [[#Aktivieren von Hinweisen für ein Steuerelement|aktivieren]], ansonsten ist der Hinweis deaktiviert.

====Tastenkürzel für Aktionen====

Aktionen ermöglichen auch, das Tastenkürzel ([[lib_de:FMX.ActnList.TAction.ShortCut|TAction.ShortCut]]) als Teil des Hinweises anzuzeigen. Dazu müssen Sie [[lib_de:FMX.Forms.TApplication.HintShortCuts|TApplication.HintShortCuts]] auf {{True}} setzen.

:'''Hinweis:''' Auch wenn Sie keinen Hinweis für eine Aktion festlegen, wird im Hinweis das Tastenkürzel angezeigt, wenn [[lib_de:FMX.Forms.TApplication.HintShortCuts|TApplication.HintShortCuts]] {{True}} ist.

====Aktionsereignis OnHint====

Aktionen haben ein eigenes unabhängiges [[lib_de:System.Actions.TContainedAction.OnHint|OnHint]]-Ereignis. Wenn Sie eine benutzerdefinierte Ereignisbehandlungsroutine für dieses Ereignis implementieren, können Sie den Text des Hinweises programmseitig festlegen oder ändern oder diesen Hinweis unterdrücken.

Der folgende Code ist ein Beispiel für eine [[lib_de:System.Actions.TContainedAction.OnHint|OnHint]]-Ereignisbehandlungsroutine für eine Aktion, die den Text des Hinweises ändert.

:'''Hinweis:''' Der Parameter {{Arg|CanShow}} führt nichts aus.

<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
procedure TForm1.Action1Hint(var HintStr: string; var CanShow: Boolean);
begin
HintStr := HintStr + 'My hint text';
end;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
__fastcall TForm1:Action1Hint(System:UnicodeString HintStr, boolean CanShow);
{
HintStr = HintStr + "My hint text";
}
</source><l e="cpp" />

Wenn Sie den Hinweis entfernen möchten, können Sie dies im [[Objektinspektor|Objektinspektor]] tun oder den Hinweis zur Laufzeit unterdrücken:
<l s="delphi" />'''{{Delphi}}:'''
<source lang="delphi">
procedure TForm1.Action1Hint(var HintStr: string; var CanShow: Boolean);
begin
HintStr := '';
end;
</source><l e="delphi" />

<l s="cpp" />'''C++:'''
<source lang="cpp">
__fastcall TForm1:Action1Hint(System:UnicodeString HintStr, boolean CanShow);
{
HintStr = "";
}
</source><l e="cpp" />

:'''Hinweis:''' Wenn Sie einem Steuerelement eine Aktion mit einem Hinweis zuweisen und dann den Hinweis aus den Eigenschaften des Steuerelements entfernen, wird der Aktionshinweis trotzdem angezeigt. Informationen zu diesem Szenario finden Sie in der [[#Steuerelementhinweise und Aktionshinweise|folgenden Tabelle]].

====Steuerelementhinweise und Aktionshinweise====

Wenn Sie einem Steuerelement eine Aktion zuweisen, erbt das Steuerelement automatisch den Hinweis dieser Aktion. Wenn Sie den Hinweis später ändern möchten, können Sie dazu entweder den Hinweis der Aktion oder den Hinweis des Steuerelements ändern. Es gibt jedoch bestimmte Szenarien, die Sie berücksichtigen sollten. In der folgenden Tabelle sind die verschiedenen Szenarien und der sich ergebende Hinweis aufgeführt.

{| class="wikitable"
|-
! Schritte
! Angezeigter Hinweis
|- valign="top"
|
# Festlegen eines Hinweises für die Aktion: {{Code|ActionHint}}
# Zuweisen dieser Aktion zu einem Steuerelement
|
{{Code|ActionHint}}
|- valign="top"
|
# Festlegen eines Hinweises für die Aktion: {{Code|ActionHint}}
# Zuweisen dieser Aktion zu einem Steuerelement
# [[#Aktionsereignis OnHint|Unterdrücken des Hinweises]] zur Laufzeit (Zuweisen eines leeren Strings)
|
|- valign="top"
|
# Festlegen eines Hinweises für die Aktion: {{Code|ActionHint}}
# Zuweisen dieser Aktion zu einem Steuerelement
# Ändern des Hinweises in den Eigenschaften des Steuerelements, Festlegen des Hinweises als {{Code|ControlHint}}
|
{{Code|ControlHint}}
|- valign="top"
|
# Festlegen eines Hinweises für die Aktion: {{Code|ActionHint}}
# Zuweisen dieser Aktion zu einem Steuerelement
# Entfernen des Hinweises aus den Eigenschaften des Steuerelements
|
{{Code|ActionHint}}
|}

:'''Hinweis:''' Berücksichtigen Sie bei den Szenarien in der obigen Tabelle die [[#Tastenkürzel für Aktionen|Tastenkürzel]].

==Siehe auch==

===Bibliotheken===

* [[lib_de:FMX.Controls.THint|FMX.Controls.THint]]
* [[lib_de:FMX.Controls.TControl.Hint|FMX.Controls.TControl.Hint]]
* [[lib_de:FMX.Controls.TControl.ShowHint|FMX.Controls.TControl.ShowHint]]
* [[lib_de:FMX.StdCtrls.TStatusBar.OnHint|FMX.StdCtrls.TStatusBar.OnHint]]
* [[lib_de:FMX.StdCtrls.TStatusBar.AutoHint|FMX.StdCtrls.TStatusBar.AutoHint]]
* [[lib_de:FMX.Forms.TApplication.OnHint|FMX.Forms.TApplication.OnHint]]
* [[lib_de:FMX.Forms.TApplication.Hint|FMX.Forms.TApplication.Hint]]
* [[lib_de:FMX.Forms.TApplication.ShowHint|FMX.Forms.TApplication.ShowHint]]
* [[lib_de:FMX.Forms.TApplication.HideHint|FMX.Forms.TApplication.HideHint]]
* [[lib_de:FMX.Forms.TApplication.HintShortCuts|FMX.Forms.TApplication.HintShortCuts]]
* [[lib_de:FMX.Utils.GetLongHint|FMX.Utils.GetLongHint]]
* [[lib_de:FMX.Utils.GetShortHint|FMX.Utils.GetShortHint]]

===Themen===

[[FireMonkey-Aktionen|{{FM}}-Aktionen]]

[[Category:Seattle]]
[[Category:FMX]]
[[Category:AMMigrate]]

[[en:Using Hints to Show Contextual Help in a FireMonkey Application]]
[[fr:Utilisation des conseils pour afficher de l'aide contextuelle dans une application FireMonkey]]
[[ja:FireMonkey アプリケーションでヒントを使用して状況依存ヘルプを表示する方法]]

Verwenden von Gesten in Anwendungen

2016-06-24T10:52:29Z

Esabatell: Updated. LOC-22885

{{Parent|So erstellen Sie eine Anwendung mit Gesten-Komponenten}}

===So fügen Sie Ihrer Anwendung Funktionen für Gesten hinzu:===

# Fügen Sie im '''[[Formular-Designer|Formular-Designer]]''' die Komponente oder Komponenten hinzu, die mit Gesten verwendet werden sollen.
#: Große Komponenten, wie Tafeln (TPanel) und Tafelgruppen, eignen sich gut für Gesten.
# Für Desktop-Plattformen fügen Sie dem Projekt eine '''GestureManager'''-Komponente hinzu, geben ihr optional einen bestimmten Namen und weisen sie dem Gestenmanager zu:
#: '''Hinweis:''' Mobile Plattformen unterstützen per Vorgabe Gesten.
## Suchen Sie in der '''[[Tool-Palette|Tool-Palette]]''' in der Kategorie '''Gesten''' die GestureManager-Komponente, und doppelklicken Sie darauf:
##: [[Image:GMIcon2.png]]
##: (entweder '''[[lib_de:Vcl.Touch.GestureMgr.TGestureManager|Vcl.Touch.GestureMgr.TGestureManager]]''' oder '''[[lib_de:FMX.Types.TCustomTouchManager.GestureManager|FMX.Types.TCustomTouchManager.GestureManager]]''').
##: [[Image:AssignGestureManager.png|thumb|right|300px|Gesten sind für das Steuerelement nicht aktiviert, wenn im Feld '''Gesten''' die Meldung '''Gestenmanager zuweisen''' angezeigt wird]]
##: Damit wird dem Projekt eine GestureManager-Komponente hinzugefügt und mit einem Standardnamen wie '''GestureManager1''' benannt.
## Wenn Sie den Standardnamen der GestureManager-Komponente ändern möchten, geben Sie im '''Objektinspektor''' einen Namen in das Feld '''Name''' für die GestureManager-Komponente ein. Der Standardname lautet in der Regel GestureManager<n>.
## Sie müssen jeder Komponente, die Gesten verarbeiten soll, '''einen Gestenmanager zuweisen''':
### Wählen Sie (entweder im Formular-Designer oder in der Dropdown-Liste mit Komponenten im Objektinspektor) die GestureManager-Komponente aus.
###: [[Image:AssignGM1.png|thumb|right|300px|Wenn die Meldung '''Gestenmanager zuweisen''' angezeigt wird, klicken Sie auf @@wikiImage@@Image:ProjectOptionsDownArrow2.jpg]] im Feld "GestureManager", um die vorhandenen Gestenmanager anzuzeigen]]
### Klicken Sie im '''[[Objektinspektor|Objektinspektor]]''' im Eingabefeld für die Eigenschaft '''GestureManager''' (unter dem Knoten '''Touch''') auf den Abwärtspfeil [[Image:ProjectOptionsDownArrow2.jpg]]. Daraufhin wird im Feld '''GestureManager''' eine Liste der verfügbaren Gestenmanager angezeigt.
### Wählen Sie einen Gestenmanager in der Liste verfügbarer Gestenmanager aus:
###: [[Image:GMList.png]]
## Wählen Sie im '''Formular-Designer''' die Komponente aus, die den Gestenmanager enthält, und öffnen Sie im '''Objektinspektor''' den Knoten '''Touch'''. Überprüfen Sie, ob im Feld '''GestureManager''' der Name anzeigt wird, den Sie dem GestureManager für diese Komponente zugewiesen haben.
# Für Desktop- und mobile Plattformen:
## Wählen Sie im Objektinspektor im Feld '''Touch | Gesten''' des Steuerelements die Geste(n), die Sie aktivieren möchten.
## Implementieren Sie die Ereignisbehandlungsroutine '''OnGesture''' (Prozedur) für jede Geste, die Sie für das Steuerelement aktivieren möchten, und behandeln Sie die entsprechende '''[[lib_de:FMX.Types.TCustomGestureCollectionItem.GestureID|EventInfo.GestureId]]'''.
##: Ein Beispiel einer Ereignisbehandlungsroutine finden Sie unter '''Implementieren der OnGesture-Ereignisbehandlungsroutine''' in [[Gesten in FireMonkey|Gesten in FireMonkey]].

==Siehe auch==

* [[Überblick zu Gesten|Überblick zu Gesten]]
* [[Erstellen von benutzerdefinierten Gesten|Erstellen von benutzerdefinierten Gesten]]
* [[Aufzählung der Standardgesten|Aufzählung der Standardgesten]]
* [[Behandeln von VCL-Aktionen mit einer Aktionsliste|Aktionslisten verwenden]]
* [[Gesten in FireMonkey|Gesten in FireMonkey]]

===Plattformspezifische Informationen===

* [http://msdn.microsoft.com/en-us/library/dd371585(v=VS.85).aspx Windows Touch-Gesten]
* [http://support.apple.com/kb/HT4721 Multi-Touch Gestures for OS X (Mehrfingerbewegungen für OS X) (EN)]
* [https://developer.apple.com/library/ios/documentation/userexperience/conceptual/MobileHIG/index.html iOS Human Interface Guidelines: Platform Characteristics (iOS-Benutzeroberflächenrichtlinien: Plattformmerkmale) (EN)]
* [http://developer.android.com/design/patterns/gestures.html Gestures on Android (Gesten in Android) (EN)]

===Codebeispiele===

* [[Samp:OnGesture (Delphi)|OnGesture ({{Delphi}})]]
* [[Samp:OnGesture (C++)|OnGesture (C++)]]
* [[samp_en:FMX.InteractiveGestures Sample|FMX.InteractiveGestures (Beispiel)]]

===Beispiele===

* [[samp_en:FMX.ImageZoom Sample|ImageZoom]] (Beispiel)
* [[samp_en:FMX.ImageRotation Sample|ImageRotation]] (Beispiel)
* [[samp_en:FMX.TapAndHold Sample|TapAndHold]] (Beispiel)

[[Category:Mit Delphi für Windows arbeiten]]
[[Category:Delphi]]

[[en:Using Gesturing in Your Applications]]
[[fr:Utilisation de la gestion des mouvements dans vos applications]]
[[ja:アプリケーションでジェスチャを使用する]]

Verwenden von Box2D in Delphi-Anwendungen

2016-06-24T10:52:14Z

Esabatell: Updated. LOC-22885

{{Parent|Box2D}}

In diesem Thema wird die Verwendung von Box2D in {{Delphi}}-Anwendungen beschrieben.

==Konfigurieren Ihrer Anwendung für die Verwendung von Box2D==

{{Product}} enthält keine vorerzeugten {{Path|.dcu}}-Dateien für Box2D-{{Delphi}}-Units. Zum Erzeugen eines {{Delphi}}-Projekts, das Box2D-Units in der <source lang="delphi" enclose="none">uses</source>-Klausel enthält, müssen Sie den Suchpfad Ihres Projekts so konfigurieren, dass {{Product}} die Box2D-Units finden kann.

So konfigurieren Sie den Suchpfad Ihres {{Delphi}}-Projekts so, dass {{Product}} die Box2D-Units finden kann:

# Wählen Sie {{Menu|Projekt > Optionen > [[Delphi-Compiler|{{Delphi}}-Compiler]]}}.
# Fügen Sie dem Feld '''Suchpfad''' den Eintrag {{Path|$(BDS)\source\FlatBox2D}} hinzu.

Sie können nun Ihrem Code [[Hinzufügen einer Unit-Referenz|Referenzen auf diese Units hinzufügen]], damit Sie [[#Verwenden von Box2D|Box2D verwenden]] können.

==Verwenden von Box2D==

Die {{Delphi}}-Bindungen für Box2D basieren auf der [http://www.learn-cocos2d.com/api-ref/1.0/Box2D/html/index.html C++-API (EN)]; es gibt jedoch einige wichtige Unterschiede.

: '''Hinweis:''' Für die Verwendung der {{Delphi}}-Bindungen für Box2D sollten Sie mit [[Zeiger und Zeigertypen (Delphi)|Zeigern]] und [[Grundlegende syntaktische Elemente (Delphi)#Erweiterte Bezeichner|erweiterten Bezeichnern]] vertraut sein.

==={{Delphi}}-Zuordnung von Box2D-Klassen===

Die {{Delphi}}-Bindungen für Box2D stellen Box2D-Klassen auf eine der folgenden Arten bereit:

* Als Record mit dem Originalnamen der Box2D-Klasse. Siehe [[#Verwenden von Box2D-Records|Verwenden von Box2D-Records]].
* Als Record mit dem Originalnamen der Box2D-Klasse und dem Suffix {{Code|Wrapper}}. Beispielsweise wäre der Wrapper von {{Code|b2World}} {{Code|b2WorldWrapper}}. Siehe [[#Verwenden von Box2D-Wrapper-Records|Verwenden von Box2D-Wrapper-Records]].

In beiden Fällen ist im Gegensatz zu regulären {{Delphi}}-Records die Deklaration dieser Box2D-Records nicht ausreichend, um sie zu erstellen. Sie müssen deren {{Code|Create}}-Prozedur aufrufen, um sicherzustellen, dass deren Member die richtigen Standardwerte erhalten. Wenn Sie einen Record deklarieren und {{Code|Create}} nicht aufrufen, könnten die Standardwerte der Member nicht mit denjenigen übereinstimmen, die Box2D definiert.

<source lang="delphi">
groundBodyDef := b2BodyDef.Create;
</source>

====Verwenden von Box2D-Records====

Die {{Delphi}}-Bindungen für Box2D stellen die meisten Box2D-Klassen als Records bereit. Die einzigen Ausnahmen bilden [[#Verwenden von Box2D-Wrapper-Records|als Wrapper-Records bereitgestellte Klassen]] und [[#Definieren von Box2D-Listenern|Listener-Klassen]].

====Verwenden von Box2D-Wrapper-Records====

Die {{Delphi}}-Bindungen für Box2D stellen die folgenden Wrapper-Records bereit:

* {{Code|b2BlockAllocatorWrapper}}
* {{Code|b2BodyWrapper}}
* {{Code|b2BroadPhaseWrapper}}
* {{Code|b2ChainAndCircleContactWrapper}}
* {{Code|b2ChainAndPolygonContactWrapper}}
* {{Code|b2ChainShapeWrapper}}
* {{Code|b2CircleContactWrapper}}
* {{Code|b2CircleShapeWrapper}}
* {{Code|b2ContactWrapper}}
* {{Code|b2ContactManagerWrapper}}
* {{Code|b2ContactSolverWrapper}}
* {{Code|b2DistanceJointWrapper}}
* {{Code|b2DrawWrapper}}
* {{Code|b2DynamicTreeWrapper}}
* {{Code|b2EdgeAndCircleContactWrapper}}
* {{Code|b2EdgeAndPolygonContactWrapper}}
* {{Code|b2EdgeShapeWrapper}}
* {{Code|b2FrictionJointWrapper}}
* {{Code|b2GearJointWrapper}}
* {{Code|b2IslandWrapper}}
* {{Code|b2JointWrapper}}
* {{Code|b2MotorJointWrapper}}
* {{Code|b2MouseJointWrapper}}
* {{Code|b2PolygonAndCircleContactWrapper}}
* {{Code|b2PolygonContactWrapper}}
* {{Code|b2PolygonShapeWrapper}}
* {{Code|b2PrismaticJointWrapper}}
* {{Code|b2PulleyJointWrapper}}
* {{Code|b2RevoluteJointWrapper}}
* {{Code|b2RopeWrapper}}
* {{Code|b2RopeJointWrapper}}
* {{Code|b2ShapeWrapper}}
* {{Code|b2StackAllocatorWrapper}}
* {{Code|b2WeldJointWrapper}}
* {{Code|b2WheelJointWrapper}}
* {{Code|b2WorldWrapper}}

====Freigabe von Box2D-Records und -Record-Wrappern====

Die einzigen Box2D-Records oder -Record-Wrapper, die Sie freigeben müssen, sind Instanzen von {{Code|b2WorldWrapper}}. Der Destruktor von {{Code|b2WorldWrapper}} gibt den durch Körper, Inventarstücke oder Verbindungen im {{Code|b2WorldWrapper}}-Objekt zugewiesenen Speicher frei.

Ausnahmen von dieser Regel:

* ShapeWrapper
* Andere Wrapper, die Sie explizit erstellen und die in C++ freigegeben werden

<source lang="delphi">
world.Destroy;
</source>

[[#Definieren von Box2D-Listenern|Box2D-Listener]] gehören ebenfalls zu den Ausnahmen von dieser Regel.

===Definieren von Box2D-Listenern===

Box2D definierte einige Listener-Klassen. Wenn Sie [[Verwenden von Box2D in C++Builder-Anwendungen|C++ verwenden]], können Sie Unterklassen eines Listeners anlegen, eine Instanz Ihrer Unterklasse erstellen und Ihr Listener-Objekt in einem Box2D-Objekt registrieren, wie z. B. "Welt" ({{Code|b2World}}).

Um ein Box2D-Listener-Objekt eines bestimmten Typs in {{Delphi}} zu erstellen, müssen Sie eine benutzerdefinierte Klasse definieren, die das Interface der Ziel-Box2D-Listener-Klasse implementiert. Das Interface einer Box2D-Listener-Klasse wird wie die Box2D-Listener-Klasse, aber mit dem Präfix {{Code|I}} benannt. {{Code|Ib2ContactListener}} ist beispielsweise das Interface der {{Code|b2ContactListener}}-Box2D-Listener-Klasse.

<source lang="delphi">
TMyContactListener = class (TInterfacedObject, Ib2ContactListener)
public
procedure BeginContact(contact: NativeUInt); cdecl;
procedure EndContact(contact: NativeUInt); cdecl;
procedure PostSolve(contact: NativeUInt; impulse: Pb2ContactImpulse); cdecl;
procedure PreSolve(contact: NativeUInt; oldManifold: Pb2Manifold); cdecl;
end;
</source>

Wenn Sie eine Klasse angelegt haben, die das Ziel-Listener-Interface implementiert, müssen Sie eine Instanz dieser Klasse erstellen.

<source lang="delphi">
myContactListener := TMyContactListener.Create;
</source>

Listener-Setter-Methoden können Ihr Listener-Objekt nicht direkt behandeln, sondern Sie müssen einen Delegaten (mit dem Typ <source lang="delphi" enclose="none">NativeUInt</source>) für Ihr Listener-Objekt abrufen und diesen Delegaten an die Listener-Setter-Methode übergeben. Verwenden Sie {{Code|Create_{{placeholder|Listener-Klasse}}_delegate}}, um einen Delegaten Ihres Listener-Objekts zu erstellen.

<source lang="delphi">
myContactListenerHandle := Create_b2ContactListener_delegate(myContactListener);
world.SetContactListener(myContactListenerHandle);
</source>

Nach der Freigabe der Box2D-Welt können Sie das Listener-Objekt freigeben, indem Sie sein Handle an {{Code|Destroy_{{placeholder|Listener-Klasse}}_delegate}} übergeben.

<source lang="delphi">
world.Destroy;
Destroy_b2ContactListener_delegate(myContactListenerHandle);
</source>

==Bereitstellen Ihrer Anwendung==

Auf Desktop-Plattformen müssen Sie die dynamische {{Product}}-Box2D-Bibliothek zusammen mit Ihrer Anwendung weitergeben.

Die dynamische {{Product}}-Box2D-Bibliotheksdatei befindet sich in:

* '''32-Bit-Windows:''' {{Path|{{InstallPath}}\bin\FlatBox2DDyn.dll}}
* '''64-Bit-Windows:''' {{Path|{{InstallPath}}\bin64\FlatBox2DDyn.dll}}
* '''OS X:''' {{Path|{{InstallPath}}\binosx32\libFlatBox2DDyn.dylib}}

[[Bereitstellungs-Manager - Hinzufügen von Dateien|Fügen Sie dem Bereitstellungs-Manager diese Bibliotheksdatei]] für jede Zielplattform hinzu, die Ihre Anwendung unterstützt, damit sich bei der [[Anwendungen weitergeben - Index|Bereitstellung Ihrer Anwendung]] für eine beliebige Desktop-Plattform die dynamische {{Product}}-Box2D-Bibliotheksdatei unter den bereitgestellten Dateien Ihrer Anwendung befindet.

==Siehe auch==

* [[Verwenden von Box2D in C++Builder-Anwendungen|Verwenden von Box2D in {{CBuilder}}-Anwendungen]]
* [http://box2d.org/manual.pdf C++ Manual (EN)]
* [http://www.learn-cocos2d.com/api-ref/1.0/Box2D/html/index.html C++ API documentation (EN)]

===Beispiele===

* [[Samp:Box2D Hello World (Delphi)|Box2D Hello World ({{Delphi}})]]
* [[samp_en:Box2D.Box2DHello|Box2D Hello]] (Beispiel)
* [[samp_en:Box2D.TestBed|Box2D TestBed]] (Beispiel)
* [[samp_en:FMX.SimplePhysics Sample|FMX SimplePhysics]] (Beispiel)

[[Category:Delphi]]
[[Category:AMMigrate]]

[[en:Using Box2D in Delphi Applications]]
[[fr:Utilisation de Box2D dans les applications Delphi]]
[[ja:Delphi アプリケーションでの Box2D の使用]]

Verwenden von Bluetooth Low Energy

2016-06-24T10:52:06Z

Esabatell: Updated. LOC-22885

{{Parent|Verwenden von Bluetooth}}

Weil die Bluetooth Core Specification seit der Version 4.0 unterschiedliche Typen von "Bluetooth"-Protokollen, wie Bluetooth Low Energy, definiert, wird das ursprüngliche Bluetooth-Protokoll "[[Verwenden von Classic Bluetooth|Classic Bluetooth]]" genannt.

Bluetooth Low Energy oder Smart Bluetooth stellt eine neue Umgebung für Geräte mit einer geringen Datenübertragungsmenge und niedrigerem Energieverbrauch bereit.

So implementieren Sie die BluetoothLE-Unterstützung für Standarddienste in Ihren Anwendungen:

* [[#Einfügen einer TBluetoothLE-Komponente| Einfügen einer TBluetoothLE-Komponente in Ihr Projekt]]
* [[#Ermitteln von Geräten| Ermitteln von Bluetooth LE-Geräten]]
* [[#Ermitteln und Abrufen von Diensten| Ermitteln und Abrufen von Diensten für das Gerät]]
* [[#Ermitteln und Abrufen von Merkmalen| Ermitteln und Abrufen der Merkmale für das Gerät]]
* [[#Lesen, Schreiben oder Abonnieren eines Merkmals| Lesen, Schreiben oder Abonnieren eines Merkmals]]
* [[#Verarbeiten der empfangenen Daten| Ermitteln der Informationen aus den Rohdaten]]

==Plattformunterstützung==

{| class="wikitable" style="text-align: center;"
|-
! rowspan="2" | Plattform
! colspan="2" | Bluetooth Low Energy
|- valign="top"
! Client
! Server
|- valign="top"
|
Windows(<nowiki>*</nowiki>)
|
8+
|
10+ (<nowiki>**</nowiki>)
|- valign="top"
|
OS X
|
10.7+
|
10,9+
|- valign="top"
|
iOS
|
5+
|
6+
|- valign="top"
|
Android
|
4.3+
|
5+
|}

'''<nowiki>(*) Hinweis</nowiki>''': Windows-Server unterstützt Bluetooth nicht (siehe: [https://msdn.microsoft.com/en-us/library/windows/hardware/dn133849%28v=vs.85%29.aspx General Bluetooth Support in Windows (EN)]).

'''<nowiki>(**) Hinweis</nowiki>''': Die WinRT Bluetooth-API unterstützt die BLE-Bekanntgabedaten durch das Feld [[lib_de:System.Bluetooth.TBluetoothLEAdvertiseData.ManufacturerSpecificData|herstellerspezifische Daten]], trotzdem implementiert sie die GATT-Server-Funktionalitäten nicht vollständig.

==GATT-Profile (GENERIC ATTRIBUTE)==

Profile sind allgemeine Definitionen, die festlegen, wie die Standarddienste in Ihren Anwendungen verwendet werden. Beispielsweise gibt es ein Herzfrequenzprofil, das in Fitness- oder Gesundheitsanwendungen eingesetzt wird. Das Servergerät mit einem Herzfrequenzsensor stellt den Standard-Herzfrequenzdienst bereit, sodass der BluetoothLE-Client den Dienst findet und mit dem Sammeln von Daten, z. B. Schläge pro Minute, beginnt.

Das GATT-Profil ist die Kombination von Dienst und Merkmalen.

Die offizielle Seite mit den GATT-Profilen ist [http://developer.bluetooth.org/gatt/profiles/Pages/ProfilesHome.aspx GATT Specifications for Standard Profiles (EN)].

==Einfügen einer TBluetoothLE-Komponente==

Implementieren Sie mit der neuen [[lib_de:System.Bluetooth.Components.TBluetoothLE|TBluetoothLE]]-Komponente das RTL-BluetoothLE-Feature für Server- und Clientanwendungen.

TBluetoothLE fügt die Unit [[lib_de:System.Bluetooth|System.Bluetooth]] in Ihre Anwendung ein und ruft intern [[lib_de:System.Bluetooth.TBluetoothLEManager.Current|TBluetoothLEManager.Current]] auf, um eine Instanz von [[lib_de:System.Bluetooth.TBluetoothLEManager|TBluetoothLEManager]] abzurufen. {{Code|TBluetoothLEManager}} ist die Hauptklasse für die Bluetooth Low Energy-Kommunikation.

: '''Hinweis:''' {{Code|TBluetoothLEManager.Current}} gibt immer dieselbe Instanz von {{Code|TBluetoothLEManager}} zurück. Sie benötigen nur eine Instanz von {{Code|TBluetoothLEManager}}.

==Ermitteln von Geräten==

'''BluetoothLE''' arbeitet nicht wie '''Classic Bluetooth''', Sie müssen die Geräte nicht koppeln. BluetoothLE-Clients müssen BluetoothLE-Server ermitteln.

'''Hinweise:'''

* Bei Anwendungen, die auf Windows-Plattformen unter Windows 10 ausgeführt werden, müssen die Geräte vor der Ermittlung der BluetoothLE-Server zuerst gekoppelt werden. Weitere Informationen finden Sie unter [https://msdn.microsoft.com/en-us/library/windows/hardware/dn133844(v=vs.85).aspx Windows Bluetooth FAQ (EN)].
* Auf [[Neuerungen in Berlin#Bluetooth LE- und Beacon-Unterstützung in Windows 10|WinRT API für Windows 10+]]-Plattformen können Geräte ohne Koppelung ermittelt werden.

Mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.DiscoverDevices|DiscoverDevices]] ermitteln Sie BluetoothLE-Server.

<source lang="Delphi">
procedure DoScan;
const
HeartRateService: TBluetoothUUID = '{0000180D-0000-1000-8000-00805F9B34FB}';
begin
BluetoothLE1.DiscoverDevices(2500) // The parameter is the timeout in milliseconds.
BluetoothLE1.DiscoverDevices(2500, [HRService]) // It only exposes devices with the Heart Rate service to the BluetoothLE client.
end;
</source>

Nach dieser Zeitspanne wird das Ereignis [[lib_de:System.Bluetooth.Components.TBluetoothLE.OnEndDiscoverDevices|OnEndDiscoverDevices]] ausgelöst. Wenn das Gerät ermittelt wurde, können Sie mit dem Abrufen der Dienste und Merkmale aus dem Standardprofil, wie im Folgenden beschrieben, beginnen.

===Verwenden von Suchfiltern===

Die RTL stellt eine BLE-Suchfilterimplementierung bereit, die die neuen BLE-Chips mit geringem Energieverbrauch nutzt.

Sie können mit angepassten, unabhängigen Suchfiltern nach bestimmten BLE-Geräten suchen:

*Erstellen Sie Ihren Filter als [[lib_de:System.Bluetooth.TBluetoothLEScanFilter|TBluetoothLEScanFilter]].
*Geben Sie die [[lib_de:System.Bluetooth.TBluetoothLEScanFilter Properties|Felder]] an, anhand derer Sie die Geräte filtern möchten.
**Optional können Sie für Geräte, die [[lib_de:System.Bluetooth.TBluetoothLEAdvertiseData.ManufacturerSpecificData|ManufacturerSpecificData]] verwenden, wie [[Verwenden von Beacons#Beacon-Typen|AltBeacons und iBeacons]], mit der Hilfsklasse [[lib_de:System.Beacon.TBeaconManufacturerDataHelper|TBeaconManufacturerDataHelper]] nach diesen Daten filtern. Übergeben Sie dazu den [[lib_de:System.Beacon.TBeaconManufacturerDataHelper|TBeaconManufacturerDataHelper]]-Inhalt an den Filter.

*Fügen Sie dann der [[lib_de:System.Bluetooth.TBluetoothLEScanFilterList|Filterliste]] den Filter hinzu, und beginnen Sie die Ermittlung von Geräten mit der neuen Implementierung von [[lib_de:System.Bluetooth.TBluetoothLEManager.StartDiscovery|StartDiscovery]].

<source lang="Delphi">
procedure DoScanWithFilter;
const
HeartRateService: TGUID = '{0000180D-0000-1000-8000-00805F9B34FB}';
var
ABLEAdvertisedDataFilter: TBluetoothLEScanFilter;
ABLEAdvertisedDataFilterList: TBluetoothLEScanFilterList;
begin
ABLEAdvertisedDataFilter:= TBluetoothLEScanFilter.Create;
ABLEAdvertisedDataFilterList:= TBluetoothLEScanFilterList.Create;
ABLEAdvertisedDataFilter.ServiceUUID:= HeartRateService;
ABLEAdvertisedDataFilterList.Add(ABLEAdvertisedDataFilter);

BluetoothLE1.CurrentManager.StartDiscovery(2500,ABLEAdvertisedDataFilterList);
end;
</source>

==Dienste und Merkmale==

===Ermitteln und Abrufen von Diensten===

Dienste sind Sammlungen von Merkmalen und Beziehungen zu anderen Diensten, die das Verhalten eines Geräteteils kapseln.

Ein GATT-Profil enthält einen oder mehrere Standarddienste, die über eine Zahl bezeichnet werden. Beispielsweise ist dem Herzfrequenzdienst offiziell die Zahl "0x180D" zugeordnet.

Die offizielle Seite mit den Standarddienstinformationen ist [https://developer.bluetooth.org/gatt/services/Pages/ServicesHome.aspx Standard BluetoothLE Services (EN)].

Um einen Dienst abzurufen, müssen Sie die vollständige UUID verwenden. Die UUID setzt sich aus der dem Standarddienst zugeordneten Zahl und dem Basis-Bluetooth-Code zusammen. Der vollständige Code für den Herzfrequenzdienst lautet beispielsweise <code>0000180D-0000-1000-8000-00805F9B34FB</code>.

Mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.DiscoverServices|DiscoverServices]] ermitteln Sie Dienste für ein bestimmtes Gerät. Nach der Ermittlung der Dienste wird das Ereignis [[lib_de:System.Bluetooth.Components.TBluetoothLE.OnServicesDiscovered|OnServicesDiscovered]] ausgelöst.

Sie müssen ermittelte Dienste abrufen. Mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.GetServices|GetServices]] können Sie eine Liste mit Diensten und mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.GetService|GetService]] einen bestimmten Dienst von einem Gerät abrufen.

===Ermitteln und Abrufen von Merkmalen===

Ein Dienst kann mehrere Merkmale enthalten, die Informationen für diesen Dienst bereitstellen. Jedes Merkmal ist mit einer offiziellen Nummer gekennzeichnet. Der Herzfrequenzdienst hat beispielsweise ein Merkmal zum Messen des Herzschlags, die Herzschlagmessung (Heart Rate Measurement) mit der UUID <code> 00002A37-0000-1000-8000-00805F9B34FB</code>, und ein weiteres Merkmal zum Messen der Position des Sensors, Position des Körpersensors (Body Sensor Location) mit der UUID <code> 00002A38-0000-1000-8000-00805F9B34FB</code>.

Mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.GetCharacteristics|GetCharacteristics]] rufen Sie eine Liste der Merkmale für einen bestimmten Dienst ab, mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.GetCharacteristic|GetCharacteristic]] ermitteln Sie Informationen über ein bestimmtes Merkmal.

===Lesen, Schreiben oder Abonnieren eines Merkmals===

Wenn Sie das Merkmal mit [[lib_de:System.Bluetooth.Components.TBluetoothLE.GetCharacteristic|GetCharacteristic]] abgerufen haben, können Sie die enthaltenen Informationen lesen oder schreiben (sofern verfügbar). Die Ereignisbehandlungsroutine [[lib_de:System.Bluetooth.Components.TBluetoothLE.OnCharacteristicRead|OnCharacteristicRead]] wird nach dem Lesen des Merkmals ausgelöst.

Mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.ReadCharacteristic|ReadCharacteristic]] können Sie den aktuellen Wert eines Merkmals abrufen. Verwenden Sie [[lib_de:System.Bluetooth.Components.TBluetoothLE.WriteCharacteristic|WriteCharacteristic]] zum Schreiben, sofern diese Option auf dem Server verfügbar ist.

Sie können ein Merkmal auch abonnieren, um die Informationen bei jeder Änderung abzurufen. Um beispielsweise die Überwachung des Herzfrequenzsensors zu beginnen, können Sie den aktuellen Wert mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.GetCharacteristic|GetCharacteristic]] lesen und dann mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.SubscribeToCharacteristic|SubscribeToCharacteristic]] die Informationen abrufen, sobald sie sich ändern. Verwenden Sie die Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.UnSubscribeToCharacteristic|UnSubscribeToCharacteristic]], um die Überwachung zu beenden.

===Verarbeiten der empfangenen Daten===

Das Clientgerät empfängt ein Array mit Daten vom Server. Befolgen Sie die Spezifikationen im GATT-Profil, um die Daten in lesbare Informationen umzuwandeln. Die Datenpaketdetails für das Merkmal Herzschlagmessung (Heart Rate Measurement) finden Sie beispielsweise auf der offiziellen Seite: [https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.heart_rate_measurement.xml Heart Rate Measurement Data Package Structure (EN)].

Bei dem Merkmal Herzschlagmessung (Heart Rate Measurement) enthält das erste Byte z. B. Flags mit Informationen über die im Bluetooth LE-Paket übertragenen Daten. Das Bit <code>0</code> im Feld "Flags" legt das Format des Herzschlagwertes fest: UINT8 oder UINT16. Je nach Format müssen Sie das zweite Byte des Datenpakets oder das zweite und das dritte Byte extrahieren, um die Schläge pro Minute zu erhalten.

==BluetoothLE-Server==

So erstellen Sie einen Server, der Standarddienste bereitstellt oder veröffentlicht:

# Fügen Sie die Komponente [[lib_de:System.Bluetooth.Components.TBluetoothLE|TBluetoothLE]] in Ihr Projekt ein.
# Veröffentlichen Sie mit der Methode [[lib_de:System.Bluetooth.Components.TBluetoothLE.GetGattServer|GetGattServer]] die Bluetooth Low Energy-Dienste.
# Erstellen Sie mit der Methode [[lib_de:System.Bluetooth.TBluetoothGattServer.CreateService|CreateService]] aus der Klasse [[lib_de:System.Bluetooth.TBluetoothGattServer|TBluetoothGattServer]] den Dienst mit der Standard-UUID.
# Erstellen Sie mit der Methode [[lib_de:System.Bluetooth.TBluetoothGattServer.CreateCharacteristic|CreateCharacteristic]] aus der Klasse [[lib_de:System.Bluetooth.TBluetoothGattServer|TBluetoothGattServer]] das Merkmal für den Dienst mit der Standard-UUID.
# Fügen Sie mit der Methode [[lib_de:System.Bluetooth.TBluetoothGattServer.AddService|AddService]] dem GATT-Server den Dienst hinzu.
# Die Ereignisbehandlungsroutine [[lib_de:System.Bluetooth.Components.TBluetoothLE.OnCharacteristicReadRequest|OnCharacteristicReadRequest]] wird ausgelöst, wenn der Server eine Leseanforderung vom Clientgerät erhält.
# Die Ereignisbehandlungsroutine [[lib_de:System.Bluetooth.Components.TBluetoothLE.OnCharacteristicReadRequest|OnCharacteristicWriteRequest]] wird ausgelöst, wenn der Server eine Schreibanforderung vom Clientgerät erhält.

==Nicht-Standardprofile==

Sie können Server- und Clientanwendungen mit der BluetoothLE-Technologie ohne GATT-Profile erstellen, das heißt, dass Sie eigene Dienste und Merkmale für die private Kommunikation zwischen Server und Clientgeräten erstellen können.

Für Nicht-Standardprofile muss eine 128-Bit-UUID verwendet werden, die zufällig generiert werden muss.

Jedes Bluetooth LE-Gerät, das als GATT-Server fungiert, muss den offiziellen Dienst für den allgemeinen Zugriff (Generic Access) mit den Merkmalen Gerätename und -darstellung (Device Name and Appearance) implementieren. Weitere Informationen finden Sie auf der offiziellen Website: [https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.generic_access.xml Generic Access service (EN)].

==Hinzufügen von Unterstützung für die Hintergrundausführung unter iOS==

Wenn für Ihre iOS-Anwendung die weitere Ausführung bestimmter Dienste im Hintergrund erforderlich ist, sollten Sie die Werte des Schlüssels [https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/plist/info/UIBackgroundModes {{Code|UIBackgroundModesProject}}] auf der Seite '''[[Versionsinformationen|Versionsinformationen]]''' angeben, bevor Sie [[Bereitstellen von iOS-Anwendungen für die Übermittlung an den App Store|Ihre fertige Anwendung weitergeben]].

:'''Hinweis''': Wenn Sie Ihre Anwendung beim Auftreten eines Bluetooth-Ereignisses "aufwecken" müssen, fügen Sie dem Schlüssel {{Code|UIBackgroundModesProject}} die folgenden Stringwerte hinzu:
:* {{Code|bluetooth-central}}: Wenn Ihre Anwendung die zentrale Rolle übernimmt.
:* {{Code|bluetooth-peripherical}}: Wenn Ihre Anwendung eine periphere Rolle übernimmt.

Weitere Informationen finden Sie unter [https://developer.apple.com/library/ios/documentation/NetworkingInternetWeb/Conceptual/CoreBluetooth_concepts/CoreBluetoothBackgroundProcessingForIOSApps/PerformingTasksWhileYourAppIsInTheBackground.html#//apple_ref/doc/uid/TP40013257-CH7-SW1 Core Bluetooth Background Processing for iOS Apps (EN)].

==Siehe auch==

* [[Verwenden von Bluetooth|Verwenden von Bluetooth]]
* [[Verwenden von Classic Bluetooth|Verwenden von Classic Bluetooth]]
* [[Verwenden von Beacons|Verwenden von Beacons]]
* [[samp_en:FMX.Heart Rate Monitor Sample|FMX.Heart Rate Monitor (Beispiel)]]
* [[lib_de:System.Bluetooth|System.Bluetooth]]
* [http://developer.bluetooth.org/gatt/profiles/Pages/ProfilesHome.aspx GATT Specifications for Standard Profiles (EN)]
* [https://developer.apple.com/library/ios/documentation/NetworkingInternetWeb/Conceptual/CoreBluetooth_concepts/CoreBluetoothBackgroundProcessingForIOSApps/PerformingTasksWhileYourAppIsInTheBackground.html#//apple_ref/doc/uid/TP40013257-CH7-SW1 Core Bluetooth Background Processing for iOS Apps (EN)]

[[Category:XE7]]
[[Category:AMMigrate]]

[[en:Using Bluetooth Low Energy]]
[[fr:Utilisation du Bluetooth Low Energy]]
[[ja:Bluetooth LE の使用]]

Verwenden von Beacons

2016-06-24T10:51:56Z

Esabatell: Updated. LOC-22885

{{parent|Verwenden von Bluetooth}}

Ein Beacon ist ein [[Verwenden von Bluetooth Low Energy|Bluetooth Low Energy]]-Gerät, das Information in seinen Bekanntgabedaten enthält, insbesondere in den '''Manufacturer Specific Data''' (Herstellerspezifische Daten), die in "Bluetooth Specification Version 4.1, Seite 2023" [https://www.bluetooth.org/en-us https://www.bluetooth.org/en-us (EN)] beschrieben sind. Diese Informationen ermöglichen Bluetooth Low Energy-Geräten in der Umgebung, das Gerät zu identifizieren und die Entfernung dazu zu berechnen, ohne dass eine Koppelung oder die Einrichtung einer Verbindung erfolgen muss.

==Übersicht über Beacons==

===Plattformunterstützung===

{| class="wikitable" style="text-align: center;"
|-
! Plattform
! Unterstützt
|- valign="top"
|
Windows(<nowiki>*</nowiki>)
|
10+
|- valign="top"
|
OS X
|
10.7+
|- valign="top"
|
iOS
|
5+
|- valign="top"
|
Android
|
4.3+
|}

'''<nowiki>(*) Hinweis</nowiki>''': Die [[Verwenden der RTL (Laufzeitbibliothek)|RTL-]] [[lib_de:System.Beacon|API für Beacons]] ist nur für Windows 10+-Plattformen verfügbar. Die zwei verfügbaren Formate sind [https://developer.apple.com/ibeacon/ iBeacon] und [http://altbeacon.org/ AltBeacon]. Frühere Windows-Versionen unterstützen keine BLE-Bekanntgabedaten.

===Beacon-Typen===

Es sind drei Beacon-Typen verfügbar: '''iBeacon''', '''AltBeacon''' und '''Eddystone'''. Die [[Verwenden der RTL (Laufzeitbibliothek)|RTL-]] [[lib_de:System.Beacon|API für Beacons]] unterscheidet diese mithilfe der Typen [[lib_de:System.Beacon.TBeaconScanMode|TBeaconScanMode]] und [[lib_de:System.Beacon.TKindofBeacon|TKindofBeacon]].

Sie müssen das Format kennen, das der Beacon verwendet, den Sie überwachen möchten.

{| border="1" frame="hsides" rules="rows"
|-
! '''Beacon-Format'''
! '''Beschreibung'''
! '''[[lib_de:System.Beacon.TBeaconScanMode|Modus]]'''
|-
|
'''iBeacon'''
|
Das von Apple definierte Format. Die vollständige Spezifikation finden Sie [https://developer.apple.com/ibeacon/ hier (EN)].
|
Standard
|-
|
'''AltBeacon'''
|
Offenes Format. Die vollständige Spezifikation finden Sie [http://altbeacon.org hier (EN)].
|
Alternative
|-
|
'''Eddystone'''
|
Von Google definiertes, offenes Format. Die vollständige Spezifikation finden Sie [https://github.com/google/eddystone/blob/master/protocol-specification.md hier (EN)].
|
Eddystone
|}

===Herstellerinformationen===

Bluetooth Low Energy-Geräte im Bekanntgabemodus senden wiederholt die Bekanntgabedaten in verschiedenen Strukturen vom Typ AD. Einer der AD-Typen in den Bekanntgabedaten sind die [[lib_de:System.Bluetooth.TBluetoothLEAdvertiseData.ManufacturerSpecificData|herstellerspezifischen Daten]], die mit Beacons verwendet werden. Abhängig vom [[#Beacon-Typen|Beacon-Format]] sind die in den herstellerspezifischen Daten beinhalteten Daten unterschiedlich.

Die folgende Tabelle enthält die Datenfelder, die jedes Beacon-Format bekanntgeben kann:

{| border="1" frame="hsides" rules="rows"
|-
! '''Bekanntgegebene Daten'''
! '''Beschreibung'''
! '''iBeacon'''
! '''AltBeacon'''
! '''Eddystone'''
|-
|
[[lib_de:System.TGUID|UUID]]
|
Ein eindeutiger Bezeichner, der eine Gruppe von Beacons kennzeichnet, z. B. die Beacons für eine bestimmte Firma.
|
{{V}}
|
{{V}}
|
{{V}}
|-
|
[[lib_de:System.Beacon.IBeacon.Major|Major]]
|
Die Major-ID bezeichnet einen Unterbereich in einem größeren durch die UUID festgelegten Bereich.
|
{{V}}
|
{{V}}
|
|-
|
[[lib_de:System.Beacon.IBeacon.Minor|Minor]]
|
Die Minor-ID gibt einen weiteren Unterbereich in einer Major-ID an.
|
{{V}}
|
{{V}}
|
|-
|
[[lib_de:System.Beacon.TBeaconInfo.TxPower|TxPower]]
|
Die TxPower ist die gemessene Leistung in 1 Meter Entfernung. Mit TxPower und dem Indikator für die Stärke des empfangenen Signals (Received Signal Strength Indicator, [[lib_de:System.Beacon.IBeacon.Rssi|RSSI]]) wird die ungefähre Entfernung zu einem Beacon berechnet.
|
{{V}}
|
{{V}}
|
{{V}}
|-
|
|}

====Eddystone-Frame====

Der Eddystone-Frame enthält eine Service-UUID, die als [[lib_de:System.Bluetooth.TBluetoothLEServiceData|ServiceData]] mit der ID {{code|0xFEAA}} bezeichnet wird.

Der Frame akzeptiert drei Unterformat:

* [[lib_de:System.Beacon.TEddystoneUID|EddystoneUID]]: Der Beacon sendet einen Bezeichner, der aus einem [[lib_de:System.Beacon.TEddystoneUID.Namespace|Namespace]] und einer [[lib_de:System.Beacon.TEddystoneUID.Instance|Instance]] besteht.
* [[lib_de:System.Beacon.TEddystoneURL|EddystoneURL]]: Der Beacon sendet einen [[lib_de:System.Beacon.TEddystoneURL.URL|URL]] in einem komprimierten Format.
* [[lib_de:System.Beacon.TEddystoneTLM|EddystoneTLM]]: Der Beacon sendet [[lib_de:System.Beacon.TEddystoneTLM Fields|Telemetrieinformationen]] in Bezug auf den Beacon-Status.

Weitere Informationen finden Sie unter [https://github.com/google/eddystone/blob/master/protocol-specification.md Eddystone specifications (EN)].

==Verwenden von Beacons==

Mit der [[Verwenden der RTL (Laufzeitbibliothek)|RTL]]-API für Beacons können Sie den [[lib_de:System.Beacon.IBeacon.Distance|Abstand]] zwischen dem Gerät, auf dem Ihre Anwendung ausgeführt wird, und den Beacons in der Umgebung ermitteln. Die [[Verwenden der RTL (Laufzeitbibliothek)|RTL]]-API für Beacons stellt nur Informationen für die Beacons in einem bestimmten Bereich bereit. '''Bereich''' ist eine Gruppe von Beacons. Sie können einen '''Bereich''' mit [[lib_de:System.Beacon.IBeacon.GUID|UUID]], [[lib_de:System.Beacon.IBeacon.Major|MajorID]], [[lib_de:System.Beacon.IBeacon.Minor|MinorID]] (für '''iBeacons''' und '''AltBeacons''') oder [[lib_de:System.Beacon.TEddystoneUID.Namespace|Namespace]] und [[lib_de:System.Beacon.TEddystoneUID.Instance|Instance]] (für '''Eddystone''').

===Abrufen einer Instanz von TBeaconManager===

Für die Verwendung der [[Verwenden der RTL (Laufzeitbibliothek)|RTL]]-API für Beacons müssen Sie die Unit [[lib_de:System.Beacon|System.Beacon]] in Ihre Anwendung einbeziehen und [[lib_de:System.Beacon.TBeaconManager.GetBeaconManager|TBeaconManager.GetBeaconManager]] für den gewünschten [[lib_de:System.Beacon.TBeaconScanMode|TBeaconScanMode]] aufrufen, um eine Instanz von [[lib_de:System.Beacon.TBeaconManager|TBeaconManager]] abzurufen.

Für '''iBeacons''':

<source lang="delphi">
BeaconManager := TBeaconManager.GetBeaconManager(TBeaconScanMode.Standard);
</source>

Für '''AltBeacons''':

<source lang="delphi">
BeaconManager := TBeaconManager.GetBeaconManager(TBeaconScanMode.Alternative);
</source>

Für '''Eddystone''':

<source lang="delphi">
BeaconManager := TBeaconManager.GetBeaconManager(TBeaconScanMode.Eddystone);
</source>

Für '''Extended''':

<source lang="delphi">
BeaconManager := TBeaconManager.GetBeaconManager(TBeaconScanMode.Extended);
</source>

Der [[lib_de:System.Beacon.TBeaconManager.ScanMode|ScanMode]] bezeichnet den Typ des Beacon, nach dem das System suchen soll: Standardmodus, alternativer Modus, Eddystone-Modus oder Extended-Modus. Mit dem Extended-Modus können Sie nach [[lib_de:System.Beacon.TKindofBeacon|Beacon-Arten]] gleichzeitig suchen. [[lib_de:System.Beacon.TBeaconManager|TBeaconManager]] ist die Hauptklasse der Beacon-Implementierung der RTL-API für Beacons. [[lib_de:System.Beacon.TBeaconManager|TBeaconManager]] ist für die Registrierung von Bereichen zuständig und verwaltet die Ereignisse zum Abrufen von Informationen von den Beacons. Die [[lib_de:System.Beacon.TBeaconManager|TBeaconManager]]-Instanz muss entweder für den Standardmodus, den alternativen Modus oder den Eddystone-Modus erstellt werden.

===Registrieren der zu überwachenden Bereiche===

Mit der [[lib_de:System.Beacon.TBeaconManager.RegisterBeacons|TBeaconManager.RegisterBeacons]]-Methode können Sie die Bereiche der Beacons registrieren, die Sie überwachen möchten. Sie müssen einen Parameter mit einem [[lib_de:System.Beacon.TBeaconsRegion|TBeaconsRegion]]-Typ überreichen, um die Informationen zum Beacon und dem Bereich anzugeben.
<source lang="delphi">
BeaconManager.RegisterBeacons(ABeaconRegion);
</source>

Für '''iBeacons''' und '''AltBeacons''':

* Der [[lib_de:System.Beacon.TBeaconsRegion|TBeaconsRegion]]-Typparameter ist auf [[lib_de:System.Beacon.TiBAltBeaconRegion|TiBAltBeaconRegion]] gesetzt.
* Bereiche sind mit den Parametern [[lib_de:System.Beacon.IBeacon.GUID|UUID]], [[lib_de:System.Beacon.IBeacon.Major|MajorID]] und [[lib_de:System.Beacon.IBeacon.Minor|MinorID]] angegeben. Zum Registrieren einer Region wird nur der Parameter [[lib_de:System.Beacon.IBeacon.GUID|UUID]] benötigt. Falls Sie den Bereich, den Sie registrieren möchten, genauer angeben möchten, können Sie auch [[lib_de:System.Beacon.IBeacon.Major|MajorID]], [[lib_de:System.Beacon.IBeacon.Minor|MinorID]] oder beide verwenden.

Für '''Eddystone''':

* Der [[lib_de:System.Beacon.TBeaconsRegion|TBeaconsRegion]]-Typparameter ist auf [[lib_de:System.Beacon.TEddysUIDRegion|TEddysUIDRegion]] gesetzt.
* Bereiche werden für das [[lib_de:System.Beacon.IEddystoneBeacon.EddystoneUID|EddystoneUID]]-Format mit einem [[lib_de:System.Beacon.TEddystoneUID.Namespace|Namespace]] und einer [[lib_de:System.Beacon.TEddystoneUID.Instance|Instance]] angegeben. Zum Registrieren eines Bereichs ist nur der Parameter [[lib_de:System.Beacon.TEddystoneUID.Namespace|Namespace]] erforderlich. Wenn Sie den zu registrierenden Bereich detaillierter angeben möchten, können Sie sowohl einen [[lib_de:System.Beacon.TEddystoneUID.Namespace|Namespace]] als auch eine [[lib_de:System.Beacon.TEddystoneUID.Instance|Instance]] verwenden.

===Suchen von Beacons===

Für '''registrierte''' Beacons:
Das frühere Framework setzte Folgendes voraus:

#[[#Registrieren der zu überwachenden Bereiche|Registrieren]] der zu überwachenden Beacons.
# [[lib_de:System.Beacon.TBeaconManager.StartScan|Beginnen]] der Überwachung der registrierten Beacons.
# [[lib_de:System.Beacon.TBeaconManager.StopScan|Beenden]] der Überwachung der registrierten Beacons.

Für '''nicht registrierte''' Beacons:
Die Neuerungen des Suchvorgangs ermöglichen es, gleichzeitig nach verschiedenen nicht registrierten Beacon-Arten zu suchen:

# Legen Sie den Modus [[lib_de:System.Beacon.TBeaconScanMode|Extended]] fest.
# Wählen Sie die zu überwachenden Formate mit dem Typ [[lib_de:System.Beacon.TKindofBeacon|TKindofBeacon]] aus.
# Setzen Sie die zu überwachenden Beacons auf die Eigenschaft [[lib_de:System.Beacon.Components.TCustomBeacon.ModeExtended|ModeExtended]].
# [[lib_de:System.Beacon.TBeaconManager.StartScan|Beginnen]] Sie die Überwachung nicht registrierter Beacons.
# [[lib_de:System.Beacon.TBeaconManager.StopScan|Beenden]] Sie die Überwachung nicht registrierter Beacons.

'''Hinweis:''' Falls Sie zuvor Beacons registriert haben, rufen die letzten Schritte nur registrierte Beacons und [[lib_de:System.Beacon.TEddystoneURL|EddystoneURL]]-Beacons ab, die als einzige nicht registriert sind.

===Abrufen von Informationen von eingehenden Beacons===

Für weitere Informationen fragen Sie den Hauptbeacon-Schnittstelle ([[lib_de:System.Beacon.IBeacon|IBeacon]]) zur [[lib_de:System.Beacon.IBeacon.KindofBeacon|Art des Beacons]], der überwacht wird. Dann können Sie die bestimmte Beacon-Schnittstelle verwenden: [[lib_de:System.Beacon.IiBeacon|IiBeacon]] für '''iBeacon''', [[lib_de:System.Beacon.IAltBeacon|IAltBeacon]] für '''AltBeacon''' oder [[lib_de:System.Beacon.IEddystoneBeacon|IEddystoneBeacon]] für '''Eddystone'''.

Mit den Ereignissen, die mit [[lib_de:System.Beacon.TBeaconManager|TBeaconManager]] assoziiert sind, erhalten Sie weitere Informationen über die überwachten Beacons. Jedes [[#Beacon-Typen|Beaconformat]] stellt eine Gruppe von Ereignissen bereit:

#Für '''iBeacons''' und '''AltBeacons''':
#*[[lib_de:System.Beacon.TBeaconManager.OnCalcDistance|OnCalcDistance]]: Wir sofort ausgelöst, bevor die Entfernung ([[lib_de:System.Beacon.IBeacon.Distance|Distance]]) errechnet wird.
#*[[lib_de:System.Beacon.TBeaconManager.OnEnterRegion|OnEnterRegion]]: Wird ausgelöst, wenn ein Beacon zum ersten Mal aus einem registrierten Bereich erreichbar ist.
#*[[lib_de:System.Beacon.TBeaconManager.OnExitRegion|OnExitRegion]]: Wird ausgelöst, wenn alle registrierten Beacons in einem Bereich unerreichbar sind.
#:Nach Auslösen des Ereignisses können Sie die von dem Ereignis bereitgestellten Informationen verwenden.
#::'''Hinweis''': Wenn Sie mehrere [[lib_de:System.Beacon.Components.TBeaconRegionItem|Bereichseinträge]] mit derselben [[lib_de:System.Beacon.Components.TBeaconRegionItem.UUID|UUID]] [[lib_de:System.Beacon.TBeaconManager.RegisterBeacon|registrieren]] und Sie diese überwachen möchten, können Sie aufgrund von plattformübergreifenden Anforderungen nur Ereignisse des letzten Bereichseintrags, den Sie in der [[lib_de:System.Beacon.Components.TBeaconRegionCollection|TBeaconRegionCollection]] registriert haben, abrufen. Wenn Sie verschiedene Bereiche überwachen möchten, können Sie abhängig von Ihrem Szenario eine der beiden folgenden Vorgehensweisen anwenden:
#::*Registrieren Sie einen Bereich mit dessen '''UUID''', '''MajorID'''=-1 und '''MinorID'''=-1, um Ereignisse zu erhalten, die allen Beacons mit derselben '''UUID''' zugeordnet sind.
#::*Registrieren Sie einen Bereich mit dessen '''UUID''', und entwickeln Sie Ihre App so, dass '''MajorID''' und '''MinorID''' Ihren benutzerdefinierten Werten und App-Anforderungen entsprechend gefiltert werden.
# Für '''Eddystone''':
#*[[lib_de:System.Beacon.TBeaconManager.OnNewEddystoneURL|OnNewEddystoneURL]]: Wird jedes Mal ausgelöst, wenn ein neuer [[lib_de:System.Beacon.TEddystoneURL|EddystoneURL]]-Beacon gefunden wurde.
#*[[lib_de:System.Beacon.TBeaconManager.OnNewEddystoneTLM|OnNewEddystoneTLM]]: Wird jedes Mal ausgelöst, wenn ein neuer [[lib_de:System.Beacon.TEddystoneTLM|EddystoneTLM]]-Beacon gefunden wurde.
#Für '''jedes''' Beacon-Format:
#*[[lib_de:System.Beacon.TBeaconManager.OnCalculateDistances|OnCalculateDistances]]: Wird kurz vor der Berechnung der Distanz zu einem Beacon ausgelöst.
#*[[lib_de:System.Beacon.TBeaconManager.OnBeaconEnter|OnBeaconEnter]]: Wird jedes Mal ausgelöst, wenn eine neuer Beacon erreichbar ist.
#*[[lib_de:System.Beacon.TBeaconManager.OnBeaconsEnterRegion|OnBeaconsEnterRegion]]: Wird jedes Mal ausgelöst, wenn ein neuer Beacon in einem Bereich erkannt wird. Die Beacon- und Bereichsinformationen werden beide mit dem [[lib_de:System.Beacon.TBeaconsRegion|TBeaconsRegion]]-Typ angegeben.
#*[[lib_de:System.Beacon.TBeaconManager.OnBeaconExit|OnBeaconExit]]: Wird jedes Mal ausgelöst, wenn ein Beacon unerreichbar wird.
#*[[lib_de:System.Beacon.TBeaconManager.OnBeaconsExitRegion|OnBeaconsExitRegion]]: Wird jedes Mal ausgelöst, wenn ein registrierter Beacon in einem Bereich nicht mehr vorhanden ist. Beacon- und Bereichsinformationen werden mit dem [[lib_de:System.Beacon.TBeaconsRegion|TBeaconsRegion]]-Typ angegeben.
#*[[lib_de:System.Beacon.TBeaconManager.OnBeaconProximity|OnBeaconProximity]]: Wird jedes Mal ausgelöst, wenn sich der [[lib_de:System.Beacon.IBeacon.Proximity|Proximity]]-Wert ändert.

====Beispiel====

Das folgende Codefragment zeigt, wie ein [[lib_de:System.Beacon.TBeaconManager.OnBeaconEnter|OnBeaconEnter]]-Ereignis verwendet wird. Um die benötigten Beaconinformationen von diesem Ereignis zu erhalten, folgen Sie den folgenden Schritten:

# Fragen Sie die [[lib_de:System.Beacon.IBeacon|Beacon-Schnittstelle]] zur Art des überwachten Beacons. Verwenden Sie aus diesem Grund die [[lib_de:System.Beacon.IBeacon.KindofBeacon|KindofBeacon]]-Eigenschaft.
# Fragen Sie nach der bestimmten Schnittstelle:
#* [[lib_de:System.Beacon.IiBeacon|IiBeacon]] für '''iBeacon'''.
#* [[lib_de:System.Beacon.IAltBeacon|IAltBeacon]] für '''AltBeacon'''.
#* [[lib_de:System.Beacon.IEddystoneBeacon|IEddystoneBeacon]] für '''Eddystone'''.
# Code für dieses Ereignis.

<source lang="delphi">
procedure TForm1.Beacon1BeaconEnter(const Sender: TObject;
const ABeacon: IBeacon; const CurrentBeaconList: TBeaconList);
var
LEddyHandler: IEddystoneBeacon;
LiBeacon: IiBeacon;
LAltBeacon: IAltBeacon;
ST: string;
begin
case ABeacon.KindofBeacon of
TKindofBeacon.iBeacons:
if (Supports(ABeacon, IiBeacon, LiBeacon)) then
ST := ' GUID: ' + LiBeacon.GUID.ToString;
// code
TKindofBeacon.AltBeacons:
if (Supports(ABeacon, IAltBeacon, LAltBeacon)) then
ST := ' GUID: ' + LAltBeacon.GUID.ToString;
// code
TKindofBeacon.Eddystones:
if (Supports(ABeacon, IEddystoneBeacon, LEddyHandler)) then
ST := LEddyHandler.EddystoneUID.NamespaceToString;
// code
end;
</source>

==Hinzufügen von Positionsdiensten==

Positionsdienste ermöglichen, positionsbasierten Apps anhand von Informationen von Mobiltelefonen, WiFi, GPS und Beacons Ihren ungefähren Standort zu ermitteln. Zur Ermittlung von Beacons müssen Sie die Positionsdienste aktivieren.

Für Android müssen Sie die Bluetooth-Optionen in '''Projekt > Optionen > Verwendet Berechtigungen''' aktivieren.

Für die iOS-Plattform im alternativen Modus müssen die Positionsdienste nicht aktiviert werden. Im Standardmodus (iBeacons) muss die Anforderung der Positionsaktivierung beim ersten Aufruf der App akzeptiert werden.

Für iOS 8.0 im Standardmodus sind bestimmte Schlüssel erforderlich, damit die Anwendung für die Verwendung der für die Beacon-Ermittlung benötigten Positionsdienste aktiviert wird. Die IDE bezieht bereits {{Code|NSLocationAlwaysUsageDescription}} und {{Code|NSLocationWhenInUseUsageDescription}} ein.

Der folgende Schlüssel muss manuell hinzugefügt werden:

*{{Code|NSLocationUsageDescription}}

Für die Werte ist nur eine Textmeldung wie z. B. "Diese App muss auf Positionsdienste zugreifen, um Beacons zu überwachen" erforderlich. Das System zeigt die Textmeldung beim Zugriff auf die App-Konfiguration an.

Der Schlüssel kann in der IDE hinzugefügt werden: Wählen Sie '''Projekt > Optionen > Versionsinformationen''', klicken Sie dann mit der rechten Maustaste auf die Tabelle, und wählen Sie '''Schlüssel hinzufügen'''.

[[File:BeaconKeysFig1.png|800px]]

==Einschränkungen in Räumen==

Das Funksignal, das Beacons senden, ist hochempfindlich gegenüber Rauscheffekten, wie Diffraktion, Absorption, Mehrwegreflexionen oder Störungen, die von anderen Geräten herrühren, die in demselben Funkfrequenzband senden. Insbesondere wirken sich diese schädlichen Einflüsse negativ auf das Signal des Beacon in Innenräumen aus. Als Ergebnis sind die aus Leistungsmessungen extrahierten Schätzwerte, wie [[lib_de:System.Beacon.IBeacon.Rssi|Rssi]] (Stärke des empfangenen Signals), [[lib_de:System.Beacon.IBeacon.Distance|Distance]] (Entfernung) oder [[lib_de:System.Beacon.IBeacon.Proximity|Proximity]] (Näherungsstufe), erheblich instabil und unterliegen starken Schwankungen. Demgemäß nimmt die Genauigkeit dieser Schätzwerte ab.

===Signalverarbeitung===

Die RTL stellt zwei verschiedene Algorithmen bereit, um das Signal eines Beacon und die aus diesem Signal extrahierten Schätzwerte zu stabilisieren:

* [[lib_de:System.Bluetooth.TBluetoothLEManager.RssiToDistance|RssiToDistance]] führt ein Modell ein, mit dem der aus den '''Rssi'''-Messungen abgeleitete '''Entfernungsschätzwert''' ermittelt werden kann. Die Robustheit dieses Algorithmus wird durch einen kalibrierten Leistungsparameter, {{Arg|ATxPower}}, erhöht.
* [[lib_de:System.Beacon.TBeaconManager|TBeaconManager]] implementiert einen optionalen '''Differentialfilter'''-Algorithmus. Dieser Algorithmus stabilisiert die '''Rssi'''- und '''Entfernungs'''-Messungen. Wählen Sie bei der Eigenschaft [[lib_de:System.Beacon.TBeaconManager.CalcMode|CalcMode]] den Berechnungsmodus '''Stabilized''' aus, um diesen Algorithmus zu aktivieren. Dieser Modus ist insbesondere für die Näheschätzung und die Bewegungserkennung geeignet.

===Integrieren von Algorithmen===

Sie können auch weitere Algorithmen für die Signalverarbeitung integrieren, wobei es sich um allgemeine oder von Ihnen selbst entwickelte Algorithmen handeln kann. Die folgende Liste enthält einige Beispielfilter, die Sie zur Reduzierung von Rauscheffekten implementieren können:

* Bewegungsmittelungsfilter
* Gewichtete Durchschnittsfilter
* Kurvenanpassungsfilter

==Siehe auch==

*[[Verwenden von Bluetooth Low Energy|Verwenden von Bluetooth Low Energy]]
*[[lib_de:System.Beacon|System.Beacon]]
*[[lib_de:System.Beacon.TBeaconManager|TBeaconManager]]

[[Category:XE8]]
[[Category:AMMigrate]]

[[en:Using Beacons]]
[[fr:Utilisation des beacons]]
[[ja:ビーコンの使用]]

Verwenden von App-Tethering

2016-06-24T10:48:07Z

Esabatell: Updated. LOC-22885

{{Parent|Verwenden der RTL in geräteübergreifenden Anwendungen}}

Die [[Verwenden der RTL (Laufzeitbibliothek)|RTL]] enthält '''App-Tethering'''-Komponenten, über die Ihre Anwendungen mit anderen Anwendungen auf demselben oder einem Remote-Gerät interagieren können.

Mit App-Tethering können Anwendungen sehr einfach:

* [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering|Andere Anwendungen ermitteln, die das App-Tethering verwenden]]und auf demselben Gerät wie Ihre Anwendung oder auf anderen angeschlossenen Geräten ausgeführt werden.
* [[Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering|Aktionen remote ausführen]]. Eine Anwendung kann mit App-Tethering Aktionen veröffentlichen. Andere Anwendungen können dann diese Aktionen in der ersten Anwendung remote aufrufen.
* [[Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering|Daten zwischen Anwendungen teilen]]. App-Tethering ermöglicht das Teilen von Standarddatentypen und Streams.

Die App-Tethering-Funktion ist nicht von einem speziellen Transport oder Protokoll abhängig, und neue Protokolle können mit der [[lib_de:System.Tether|App-Tethering-API]] implementiert werden. Die RTL bietet integrierte Unterstützung für IP- und [[Verwenden von Classic Bluetooth|Classic Bluetooth]]-Verbindungen, einschließlich der Verbindung zwischen Anwendungen, die auf demselben Gerät ausgeführt werden.

==Plattformunterstützung==

{| class="wikitable"
|-
! Plattform
! IP-Verbindungen
! Classic Bluetooth-Verbindungen
|- valign="top"
|
Windows
|
{{V}}
|
{{V}}
|- valign="top"
|
OS X
|
{{V}}
|
{{V}}
|- valign="top"
|
iOS
|
{{V}}
|
|- valign="top"
|
Android
|
{{V}}
|
{{V}}
|}

==Themen==

* [[Hinzufügen von App-Tethering zu Anwendungen|Hinzufügen von App-Tethering zu Anwendungen]]
* [[Verbinden zu Remote-Anwendungen mithilfe von App-Tethering|Verbinden zu Remote-Anwendungen mithilfe von App-Tethering]]
* [[Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering|Teilen und Ausführen von Aktionen für Remote-Anwendungen mithilfe von App-Tethering]]
* [[Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering|Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering]]

==Siehe auch==

* [https://www.youtube.com/watch?v=oeyGzuC_QqU&index=6&list=PLwUPJvR9mZHikVu-FgmXg2ajAagF8OPgh YouTube: App Tethering with Bluetooth ({{Delphi}}) (EN)]

* [[lib_de:System.Tether|System.Tether]]

* [[samp_en:RTL.BDShoppingList Sample|BDShoppingList]] Beispiel
* [[samp_en:RTL.DesktopCast Sample|DesktopCast]] Beispiel
* [[samp_en:RTL.MediaPlayer Sample|MediaPlayer]] Beispiel
* [[samp_en:RTL.PhotoWall Sample|PhotoWall]] Beispiel

* [[Verwenden von Bluetooth|Verwenden von Bluetooth]]
* [[Verwenden eines HTTP-Clients|Verwenden eines HTTP-Clients]]

[[Category:XE6]]
[[Category:AMMigrate]]

[[en:Using App Tethering]]
[[fr:Utilisation du tethering d'app]]
[[ja:アプリケーションテザリングの使用]]

UnixODBC (FireDAC)

2016-06-24T10:47:54Z

Esabatell: Updated. LOC-22885

{{Parent|Geräteübergreifende Entwicklung (FireDAC)}}

==Allgemeine Informationen==

FireDAC {{f|linux|unter Linux und }}OS X verwendet [http://www.unixodbc.org/ UnixODBC (EN)] für den Zugriff auf:

* [[Herstellen einer Verbindung zu IBM DB2 Server (FireDAC)|IBM DB2]]
* [[Herstellen einer Verbindung zu Informix (FireDAC)|Informix]]
* [[Herstellen einer Verbindung zu Microsoft SQL Server (FireDAC)|SQL Server]]
* [[Herstellen einer Verbindung zu Sybase SQL Anywhere (FireDAC)|SQL Anywhere]]
* [[Herstellen einer Verbindung zu Teradata Database (FireDAC)|Teradata]]
* Andere [[Herstellen einer Verbindung zu ODBC-Datenquellen (FireDAC)|ODBC]]-basierte Datenquellen.

FireDAC verwendet '''libodbc.so''' oder die gemeinsame '''.dylib'''-Bibliothek, um auf die ODBC-API zuzugreifen. Normalerweise befindet sich diese im Ordner '''/usr/local/lib'''.

==Installation==

Häufig ist das mit dem Betriebssystem installierte UnixODBC:

* veraltet{{f|linux| auf den meisten Linux-Distributionen;}}
* nicht korrekt konfiguriert{{f|linux| auf den meisten Linux-Distributionen;}}
* oder nicht installiert, wie unter OS X.

Wenn UnixODBC installiert ist, sollten Sie es daher optional erneut installieren.

Sie müssen entscheiden, welche UnixODBC-Version verwendet werden soll und wie sie installiert werden soll:
{{f|linux|* Linux:

*
** Wählen Sie die [https://msdn.microsoft.com/en-us/library/hh568449%28v=sql.110%29.aspx spezielle Installation (EN)], wenn Sie den '''Microsoft SQL Server ODBC'''-Treiber für Linux unter '''Red Hat Enterprise Linux''' oder '''SUSE Linux Enterprise''' verwenden möchten.
** Verwenden Sie die Standard-UnixODBC-Version und -Installation, wenn Sie mit Linux keine Erfahrung haben.
** Verwenden Sie das neueste UnixODBC v 2.3.4, wenn Sie mit Linux Erfahrung haben.}}
* OS X:
** Verwenden Sie UnixODBC v 2.3.0, wenn Sie mit OS X keine Erfahrung haben.
** Verwenden Sie das neueste UnixODBC v 2.3.4, wenn Sie mit OS X Erfahrung haben.

{{f|linux|

===Installation unter Linux===

Verwenden Sie für die Installation von UnixODBC unter Linux die folgenden Befehle:

<source lang="delphi">
sudo apt-get remove libodbc1 unixodbc unixodbc-dev
wget ftp://ftp.unixodbc.org/pub/unixODBC/unixODBC-2.3.4.tar.gz
tar -zxvf unixODBC-2.3.4.tar.gz
cd unixODBC-2.3.4
./configure --enable-gui=no --enable-drivers=no --enable-stats=no --enable-iconv --with-iconv-char-enc=UTF8 --with-iconv-ucode-enc=UTF16LE
make
sudo make install
cd ..
</source>
}}

===Installation unter OS X===

Verwenden Sie die folgenden Befehle, um UnixODBC auf OS X zu installieren:

<source lang="delphi">
export CFLAGS=-m32
wget ftp://ftp.unixodbc.org/pub/unixODBC/unixODBC-2.3.4.tar.gz
tar -zxvf unixODBC-2.3.4.tar.gz
cd unixODBC-2.3.4
./configure --enable-gui=no --enable-drivers=no --enable-stats=no --enable-iconv --with-iconv-char-enc=UTF8 --with-iconv-ucode-enc=UTF16LE
make
sudo make install
cd ..
</source>
{{f|linux|

===Weitere Installationsschritte===

UnixODBC v 2.3.4 erstellt symbolische ".2"-Verknüpfungen, aber für viele ODBC-Treiber sind symbolische ".1"-Verknüpfungen erforderlich. Erstellen Sie dafür manuell symbolische ".1"-Verknüpfungen. Führen Sie beispielsweise für Ubuntu Linux die folgenden Befehle aus:
<source lang="delphi">
sudo ln -s /usr/local/lib/libodbc.so.2.0.0 /usr/lib/x86_64-linux-gnu/libodbc.so.1
sudo ln -s /usr/local/lib/libodbccr.so.2.0.0 /usr/lib/x86_64-linux-gnu/libodbccr.so.1
sudo ln -s /usr/local/lib/libodbcinst.so.2.0.0 /usr/lib/x86_64-linux-gnu/libodbcinst.so.1
</source>
}}

[[Category:FireDAC]]
[[Category:AMMigrate]]

[[en:UnixODBC (FireDAC)]]
[[fr:UnixODBC (FireDAC)]]
[[ja:UnixODBC（FireDAC）]]

Unit-Gültigkeitsbereichsnamen

2016-06-24T10:47:32Z

Esabatell: Updated. LOC-22885

{{Parent|Einführung in RAD Studio}}

'''Unit-Gültigkeitsbereichsnamen''' sind Präfixe, die Unit-Namen in den {{Product}}-Bibliotheken ({{f|vcl|VCL/}}FMX/RTL) vorangestellt werden.
Das heißt, Namen von Units, Funktionen, Klassen und Membern enthalten einen Unit-Gültigkeitsbereichsnamen vor dem Unit-Namen:

===Syntax und Beschreibung===

Der Unit-Gültigkeitsbereichsname steht vor dem Unit-Namen:

<unitscope>.<unitname>. ...

Beispielsweise ist die Unit '''SysUtils''' {{f|radstudio|jetzt}} Teil des Unit-Gültigkeitsbereichs '''System''':

System.SysUtils

und die Unit '''Controls''' ist Teil des Unit-Gültigkeitsbereichs {{f|vcl|'''Vcl''' oder }} '''FMX''': {{f|vcl|

Vcl.Controls }}
FMX.Controls

__TOC__
'''Unit-Gültigkeitsbereichsnamen:'''

* Ordnen Units in Basisgruppen, wie {{f|vcl|Vcl,}} System, FMX usw., ein (Unit-Gültigkeitsbereiche sind in [[#Unit-Gültigkeitsbereiche|Unit-Gültigkeitsbereiche]] klassifiziert).
* Stellen die Kompatibilität des in der IDE geschriebenen Codes sicher.
* Differenzieren Member, deren Namen mehrdeutig sind (d. h. stellen eine korrekte Namensauflösung sicher, wenn der Name eines Member mit dem Namen eines Member einer anderen Unit übereinstimmt).
* Beginnen normalerweise mit einem einzelnen Großbuchstaben gefolgt von Kleinbuchstaben (wie '''Data''').
* Bestehen normalerweise aus einem Element {{f|datasnap| (wie z. B. '''DataSnap''')}}, es sind aber auch zwei Elemente möglich (wie '''System.Generics''').

'''Komponentenentwickler''' können Unit-Gültigkeitsbereichsnamen hinzufügen (siehe [[Hinzufügen von Unit-Gültigkeitsbereichsnamen für eigene Komponenten|Hinzufügen von Unit-Gültigkeitsbereichsnamen für eigene Komponenten]]).

==Voll qualifizierte Namen müssen den Unit-Gültigkeitsbereichsnamen enthalten==

{{f|radstudio|
Mit einer besonderen Ausnahme sollte alter Code weiterhin ohne Änderungen funktionsfähig sein. Diese Ausnahme bezieht sich auf '''bereichsabhängige oder qualifizierte Bezeichner''' im Code selbst. Für voll qualifizierte Bezeichnernamen sind jetzt Unit-Gültigkeitsbereiche erforderlich. Das bedeutet, dass Änderungen für die Compilierung bei Verwendung von qualifizierten Bezeichnern in Ihrem vorhandenen Code (der nicht von Unit-Gültigkeitsbereichen abhängig war) erforderlich sind. Sie müssen dem Unit-Namen den Unit-Gültigkeitsbereichsnamen hinzufügen. }}

Beispielsweise lautet {{f|radstudio|der voll qualifizierte Bezeichner}}{{f|appmethod|ein teilweise qualifizierter Bezeichner}} der Klasse [[lib_de:System.Classes.TStream|TStream]]{{f|radstudio|, den Sie in früheren Produkt-Releases angegeben hätten,}} folgendermaßen:

<blockquote><code>Classes.TStream</code></blockquote>

Der Name '''Classes.TStream''' gilt nun nicht mehr als voll qualifizierter Klassenname, weil voll qualifizierte Klassennamen jetzt einen '''Unit-Gültigkeitsbereich''' enthalten müssen, das heißt, der Unit-Gültigkeitsbereichsname muss angegeben sein. In diesem Fall muss dem Unit-Namen '''Classes''' der Unit-Gültigkeitsbereichsname '''System''' hinzugefügt werden, um einen Unit-gültigkeitsbereichsabhängigen oder voll qualifizierten Namen zu erhalten und zwar folgendermaßen:

*'''In {{Delphi}}''' lautet der voll qualifizierte Bezeichnername für '''TStream''':
*:<code>System.Classes.TStream </code>
*'''In C++''' verwenden Unit-Gültigkeitsbereichsnamen den C++-Gültigkeitsbereichsoperator (<code>::</code>). Der voll qualifizierte Name für die Klasse '''TStream''' lautet in C++-Code:
*:<code>System::Classes::TStream </code>

{{f|radstudio|
'''Mögliche Codeänderungen:''' Wenn in Ihrem vorhandenen Code qualifizierte Bezeichner (wie <code>'''Classes.TStream.Seek'''</code>) enthalten sind, müssen Sie den Namen die Unit-Gültigkeitsbereiche hinzufügen, damit sie voll qualifiziert sind (wie '''<code>System.Classes.TStream.Seek</code>'''). }}

===Angeben von Unit-Gültigkeitsbereichsnamen für Units im Quellcode===

Beim Entwickeln neuer Anwendungen müssen Sie den Unit-Gültigkeitsbereich für Units angeben. Dazu stehen Ihnen verschiedene Möglichkeiten zur Verfügung:

*'''Überall:'''
*: Qualifizieren Sie alle Namen aller Member in Ihrem gesamten Code vollständig. Die Verwendung einer vollständigen Qualifizierung, einschließlich von Unit-Gültigkeitsbereichsnamen, in Ihrer gesamten Anwendung gewährleistet die schnellste Compilierung.
*'''Uses-Klausel oder #includes:'''
*: Qualifizieren Sie Unit-Namen (mit dem Unit-Gültigkeitsbereich und den Unit-Namen) in der <code>uses</code>-Klausel oder der <code>#include</code>-Anweisung vollständig. In Ihrem Code können Sie dann die Namen von Membern derjenigen Units teilweise qualifizieren, für die Sie in der <code>uses</code>-Klausel oder der <code>#include</code>-Anweisung voll qualifizierte Unit-Namen (mit dem Unit-Gültigkeitsbereich) verwendet haben.
*'''In Projektoptionen:'''
*: Fügen Sie auf der Seite [[Delphi-Compiler|{{Delphi}}-Compiler]] des Dialogfeldes "Projektoptionen" der Option '''Unit-Gültigkeitsbereichsnamen''' die Unit-Gültigkeitsbereichsnamen hinzu.

<blockquote>'''[[Image:YellowBang.png]]Achtung:''' Die Verwendung von '''teilweise qualifizierten Namen''' kann die Compilierung signifikant verlangsamen, weil die Compiler alle teilweise qualifizierten Namen während der Compilierung auflösen müssen. </blockquote>

==={{Variables|Product}} verwendet Unit-Gültigkeitsbereiche und in der Hilfe werden ebenfalls Unit-Gültigkeitsbereichsnamen verwendet===

In den Experten und Vorlagen in {{Variables|Product}} werden jetzt korrekte Unit-Gültigkeitsbereichsnamen verwendet und einbezogen. In der Hilfe werden bei einigen Vorkommen von Unit-, Klassen- und Member-Namen keine Unit-Gültigkeitsbereichsnamen verwendet. In den Seitentiteln der [[lib_de:Main Page|Bibliotheksdokumentation]] sind jedoch die vollständigen Unit-Gültigkeitsbereichsnamen enthalten.

====Beispiel====

Wenn Ihr Code Folgendes enthält:

<source lang="Delphi">
uses
System.SysUtils, System.Types, System.Classes, FMX.Controls;
</source>
oder:
<source lang="Cpp">
#include <System.SysUtils.hpp>
#include <System.Types.hpp>
#include <System.Classes.hpp>
#include <FMX.Controls.hpp>
</source>

können Sie in Ihrem Code unqualifizierte Member-Namen wie folgt angeben:

GetPackageInfo // referring to System.SysUtils.GetPackageInfo
TRect // referring to System.Types.TRect
TNotifyEvent // referring to System.Classes.TNotifyEvent
TTrackBar // referring to FMX.Controls.TTrackBar

==Unit-Gültigkeitsbereiche==

Es gibt eine Vielzahl von Unit-Gültigkeitsbereichen, aber die meisten können in ein paar wenige allgemeine Kategorien gruppiert werden. Die folgende Tabelle führt die allgemeinen Kategorien und die Unit-Gültigkeitsbereichsnamen in jeder Kategorie auf:

{|
|-
! '''Allgemeine Kategorie'''
! '''Unit-Gültigkeitsbereichsnamen in dieser Kategorie'''
|- valign="top"
|
Datenbankbezogen
|
{{f|bde|[[lib_de:Bde|Bde]], }}[[lib_de:Data|Data]], [[lib_de:Data.Bind|Data.Bind]], [[lib_de:Data.Cloud|Data.Cloud]], {{f|datasnap|[[lib_de:Datasnap|Datasnap]], [[lib_de:Datasnap.Win|Datasnap.Win]], }}IB (auch [[lib_de:System.Bindings|System.Bindings]])
|- valign="top"
|
{{FM}}
|
[[lib_de:FMX|FMX]], [[lib_de:FMX.ASE|FMX.ASE]], [[lib_de:FMX.Bind|FMX.Bind]], [[lib_de:FMX.Canvas|FMX.Canvas]], [[lib_de:FMX.DAE|FMX.DAE]], [[lib_de:FMX.Filter|FMX.Filter]], [[lib_de:FMX.Platform|FMX.Platform]], [[lib_de:FMX.Printer|FMX.Printer]]
|- valign="top"
|
iOS
|
iOSapi (RTL)
|- valign="top"
|
OS X
|
Macapi, Posix, System.Mac (RTL)
|- valign="top"
|
Systembezogen (Laufzeitbibliothek)
|
[[lib_de:System|System]], [[lib_de:System.Bindings|System.Bindings]], [[lib_de:System.Generics|System.Generics]], [[lib_de:System.Math|System.Math]], [[lib_de:System.Sensors|System.Sensors]], [[lib_de:System.Tether|System.Tether]]{{f|radstudio|, [[lib_de:System.Win|System.Win]]}}
|- valign="top" {{fr|vcl}}
|
VCL (Visuelle Komponentenbibliothek)
|
[[lib_de:Vcl|Vcl]], [[lib_de:Vcl.Imaging|Vcl.Imaging]], [[lib_de:Vcl.Samples|Vcl.Samples]], Vcl.Shell, [[lib_de:Vcl.Touch|Vcl.Touch]]
|- valign="top"
|
SOAP, COM
|
[[lib_de:Soap|Soap]]
|- valign="top" {{fr|radstudio}}
|
Webbezogen
|
[[lib_de:Web|Web]], [[lib_de:Web.Win|Web.Win]]
|- valign="top"
|
Windows-API
|
[[lib_de:Winapi|Winapi]] (RTL)
|- valign="top"
|
XML-Verarbeitung
|
[[lib_de:Xml|Xml]], Xml.Internal, Xml.Win
|}

* Zehn Unit-Gültigkeitsbereiche beziehen sich auf {{FM}} (FMX, FMX.ASE, FMX.Bind, FMX.Canvas, FMX.DAE, FMX.DateTimeControls, FMX.EmbeddedControls, FMX.Filter, FMX.ListView, FMX.MediaLibrary).
* Der Unit-Gültigkeitsbereich [[lib_de:Soap|Soap]] enthält COM-bezogene Units.
* Der Unit-Gültigkeitsbereich [[lib_de:System|System]] hat mehrere Unit-Gültigkeitsbereiche, einschließlich System.Bindings, System.Generics, System.Math, System.Sensors, System.Tether. {{f|vcl|
* Vier Unit-Gültigkeitsbereiche beziehen sich auf die VCL (Vcl, Vcl.Imaging, Vcl.Samples, Vcl.Touch). }}
* Der Unit-Gültigkeitsbereich [[lib_de:Xml|Xml]] enthält die vier Units, die sich auf die XML-Verarbeitung beziehen, wie z. B. [[lib_de:Xml.Win.msxmldom|Xml.Win.msxmldom]].

==Unit-Gültigkeitsbereiche und die Units im jeweiligen Unit-Gültigkeitsbereich==

Die nachstehende Tabelle enthält folgende Informationen:

* Für Units, die in der Hilfe dokumentiert sind, ist ein Link auf den Unit-Gültigkeitsbereich angegeben, in dem die zu diesem Unit-Gültigkeitsbereich gehörenden Units aufgeführt sind.
* Für externe Units, die nicht in der Hilfe dokumentiert sind, sind die zu diesem Unit-Gültigkeitsbereich gehörenden Units aufgeführt.

{|
|-
! '''Unit-Gültigkeitsbereichsname'''
! '''Units'''
|- valign="top"
|
Androidapi (RTL)
|
AppGlue, AssetManager, AssetManagaerIni, Bitmap, Configuration, Consts, Egl, Eglext, EglPlatform
Gles, Gles2, Gles2ext, Glesext, Input, IOUtils, JNI.Analytics, JNI.ApkExpansion, JNI.App, JNI.Dalvik, JNI.{{Company}}, JNI.GraphicsContentViewText, JNI.Hardware, JNI.InputMethodService, JNI.JavaTypes, JNI.Licensing, JNI.Location, JNI.Media, JNI.Net, JNI.OpenGL, JNI.Os, Jni, JNI.PlayServices, JNI.Provider, JNI.Support, JNI.Telephony, JNI.Util, JNI.VideoView, JNI.WebKit, JNI.Widget, JNIBridge, JNIMarshal, Keycodes, KhrPlatform, Log, Looper, NativeActivity, NativeWindow, NativeWindowJni, Obb, OpenSles, Rect, Sensor, StorageManager
|- valign="top"
|
'''[[lib_de:Data|Data]]'''
|
Siehe [[lib_de:Data|Data]]
|- valign="top"
|
'''[[lib_de:Data.Bind|Data.Bind]]'''
|
Siehe [[lib_de:Data.Bind|Data.Bind]]
|- valign="top"
|
'''[[lib_de:Data.Cloud|Data.Cloud]]'''
|
Siehe [[lib_de:Data.Cloud|Data.Cloud]]
|- valign="top" {{fr|datasnap}}
|
'''[[lib_de:Datasnap|Datasnap]]'''
|
Siehe [[lib_de:Datasnap|Datasnap]]
|- valign="top"
|
'''[[lib_de:FMX|FMX]] '''
([[FireMonkey|FireMonkey-Anwendungsplattform]])
|
Siehe [[lib_de:FMX|FMX]]
|- valign="top" {{fr|radstudio}}
|
'''[[lib_de:IBX|IBX]]'''
|
Siehe [[lib_de:IBX|IBX]]
|- valign="top"
|
iOSapi (RTL)
|
AssetsLibrary, AVFoundation, CocoaTypes, CoreAudio, CoreData, CoreGraphics, CoreImage, CoreLocation, CoreMedia, CoreMotion, CoreTelephony, CoreText, CoreVideo, Foundation, GLKit, MediaPlayer, OpenGLES, QuartzCore, UIKit
|- valign="top"
|
Macapi (RTL) (Mac Objective-C Frameworks)
|
AppKit, CocoaTypes, CoreFoundation, CoreServices, Foundation, Mach, ObjCRuntime, ObjectiveC, OCMarshal, OpenGL, QuartzCore, Security, SystemConfiguration, VarObjC
|- valign="top"
|
Posix (OS X) (RTL)
|
ArpaInet, Base, Dirent, Dlfcn, Errno, Fcntl, Fnmatch, Grp, Iconv, Langinfo, Limits, Locale, NetDB, NetIf, NetinetIcmp6, NetinetIn, NetinetIp6, Posix, Pthread, Pwd, Sched, Semaphore, Signal, StdDef, Stdio, Stdlib, String_, StrOpts, SysMman, SysSelect, SysSocket, SysStat, SysStatvfs, SysSysctl, SysTime, SysTimes, Systypes, SysUio, SysWait, Termios, Time, Unistd, Utime, Wchar, Wctype, Wordexp
|- valign="top"
|
'''[[lib_de:Soap|Soap]]'''
|
Siehe [[lib_de:Soap|Soap]]
|- valign="top"
|
'''[[lib_de:SysInit|SysInit]]'''
|
Siehe [[lib_de:SysInit|SysInit]]
|- valign="top"
|
'''[[lib_de:System|System]]'''
|
Siehe [[lib_de:System|System]]
|- valign="top" {{fr|radstudio}}
|
'''[[lib_de:System.Win|System.Win]]'''
|
Siehe [[lib_de:System.Win|System.Win]]
|- valign="top" {{fr|vcl}}
|
'''[[lib_de:Vcl|Vcl]] '''

([[Einführung in die VCL (Visual Component Library)|Visuelle Komponentenbibliothek]])
|
Siehe [[lib_de:Vcl|Vcl]]
|- valign="top" {{fr|radstudio}}
|
'''[[lib_de:Web|Web]] featurerow="radstudio"'''
|
Siehe [[lib_de:Web|Web]]
|- valign="top" {{fr|radstudio}}
|
'''[[lib_de:Winapi|Winapi]]'''
|
Siehe [[lib_de:Winapi|Winapi]]
|- valign="top"
|
'''[[lib_de:Xml|Xml]]'''
|
Siehe [[lib_de:Xml|Xml]]
|}

==Themen==

* [[Hinzufügen von Unit-Gültigkeitsbereichsnamen für eigene Komponenten|Hinzufügen von Unit-Gültigkeitsbereichsnamen für eigene Komponenten]]

==Siehe auch==

* [[Namespaces in Delphi|Namespaces in {{Delphi}}]]
* [[C++-Namespaces - Index|C++-Namespaces]]
* [[lib_de:Unit List|Unit-Liste (Bibliotheksreferenz)]]

{{DEFAULTSORT:Unit-Gultigkeitsbereichsnamen}}
[[Category:XE2]]
[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]

[[en:Unit Scope Names]]
[[fr:Noms de portées d'unités]]
[[ja:ユニットスコープ名]]

Geräteübergreifende Anwendungstypen, die erstellt werden können

2016-06-24T10:47:13Z

Esabatell: Updated. LOC-22885

{{Parent|Geräteübergreifende Anwendungen - Index}}
__TOC__

In der folgenden Tabelle sind einige wichtige geräteübergreifende Anwendungen beschrieben, die Sie in der IDE erstellen können:

{| cellspacing="1" cellpadding="1" border="1" style="width: 100%"
|-
!Anwendungstyp
!Schritte zum Erstellen dieser Anwendung
!Beschreibung und Links
|- valign="top"
|'''Geräteübergreifende Anwendungen'''

'''Zielcomputer:'''
* Windows-PC mit:
** Dem Betriebssystem 32-Bit-Windows
** Dem Betriebssystem 64-Bit-Windows
* Mac mit dem Betriebssystem OS X
* iOS-Geräte:
** iPhone
** iPad
*iOS-Simulator auf dem Mac (nur für {{Delphi}})
* Android-Geräte
|
# Wählen Sie im Experten '''[[Geräteübergreifende Anwendung|Geräteübergreifende Anwendung]]''' eine der folgenden Optionen:
#*''' [[Geräteübergreifende HD-Anwendung|Leere Anwendung]]'''.
#* '''[[Geräteübergreifende 3D-Anwendung|3D-Anwendung]]'''.
#* '''Eine [[Vorlagen für geräteübergreifende Anwendungen|Anwendungsvorlage]]''', wie z. B. Registerkartenanwendung.
# Vorbereiten der Entwicklungsumgebung:
#* Installieren Sie für '''Remote-64-Bit-Windows''' den [[PAServer: Die Platform Assistant Server-Anwendung|Platform Assistant-Server]] auf der Zielplattform, und [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|erstellen Sie ein Verbindungsprofil]] in {{Product}}.
#* Installieren Sie für '''OS X''' den "Platform Assistant"-Server auf der Zielplattform, und erstellen Sie ein Verbindungsprofil in {{Product}}. Für OS X-Anwendungen fügen Sie {{Product}} auch [[Hinzufügen von SDKs für OS X oder iOS|ein OS X-SDK]] hinzu.
#* Installieren Sie für '''32-Bit- und 64-Bit-iOS-Geräte''' den "Platform Assistant"-Server auf dem Mac (der als Zwischenzielplattform für das iOS-Gerät dient), erstellen Sie ein Verbindungsprofil in {{Product}}, und [[Hinzufügen von SDKs für OS X oder iOS|fügen Sie RAD Studio ein iOS-SDK]] hinzu.
#* Installieren Sie für den '''iOS-Simulator''' (nur für {{Delphi}}) den "Platform Assistant"-Server auf dem Mac (der als Zwischenzielplattform für den iOS-Simulator dient), erstellen Sie ein Verbindungsprofil in {{Product}}, und [[Hinzufügen von SDKs für OS X oder iOS|fügen Sie RAD Studio ein iOS-SDK]] hinzu.
# Aktivieren Sie in der '''Projektverwaltung''' im Knoten '''Zielplattformen''' die gewünschte [[Unterstützte Zielplattformen|Zielplattform]].
|
Mit dem Experten '''[[Geräteübergreifende Anwendung|Geräteübergreifende Anwendungen]]''' erstellte Anwendungen verwenden automatisch die geräteübergreifenden Versionen der Komponenten und der [[Verwenden der RTL (Laufzeitbibliothek)|Laufzeitbibliothek]]. Sie können eine geräteübergreifende {{Delphi}}- oder C++-Anwendung erstellen, die auf allen [[Unterstützte Zielplattformen|unterstützten Zielplattformen]] mit Ausnahmen des iOS-Simulators, der nur von {{Delphi}}-Anwendungen unterstützt wird, ausgeführt werden kann.
: '''Hinweis:''' Wenn es sich bei Ihrem Entwicklungs-PC um ein 64-Bit-System handelt, ist für die Entwicklung von Anwendungen für 64-Bit-Windows weder der Platform Assistant-Server noch ein Verbindungsprofil erforderlich.

Weitere Informationen finden Sie unter '''[[Geräteübergreifende Anwendungen entwickeln|Geräteübergreifende Anwendungen entwickeln]]'''.
|- valign="top"
|
'''64-Bit-Windows-Anwendungen für {{Delphi}} und {{CBuilder}}'''

'''Zielcomputer:'''

PC, auf dem das Betriebssystem 64-Bit-Windows ausgeführt wird, entweder ein lokaler PC (das Entwicklungssystem) oder ein Remote-PC
|
So erstellen Sie eine '''64-Bit-Windows'''-Anwendung in der IDE:
# Erstellen Sie eine der folgenden Anwendungen:
#* '''[[Geräteübergreifende Anwendung|Geräteübergreifende Anwendung]]{{f|vcl|'''
#* '''[[VCL-Formularanwendung|VCL-Formularanwendung]]''' }}
#* '''[[Konsolenanwendungen|Konsolenanwendung]]'''
# Fügen Sie in der '''Projektverwaltung''' dem Knoten '''Zielplattformen''' die Zielplattform '''64-Bit-Windows''' hinzu, falls sie noch nicht hinzugefügt wurde.
# Aktivieren Sie in der [[Projektverwaltung|Projektverwaltung]] als '''Zielplattform''' '''64-Bit-Windows'''.
|
Die {{Product}}-IDE kann auf jeder Windows-Plattform (natives Win32 oder Win64) ausgeführt werden:
*Wenn Sie {{Product}} auf einem Win32-Entwicklungssystem ausführen, müssen Sie den "Platform Assistant" und ein Verbindungsprofil mit einer Live-Verbindung zu einem Win64-System verwenden, um plattformübergreifende Win64-Anwendungen auszuführen und zu debuggen. Ausführen und Debuggen stellen zwei wesentliche Schritte in der Anwendungsentwicklung dar.
* Wenn Sie {{Product}} auf einem Win64-Entwicklungssystem ausführen, ist die Verwendung des "Platform Assistant" und eines Verbindungsprofils optional, aber diese Komponenten erleichtern das Debuggen und ermöglichen die Verwendung des [[Bereitstellungs-Manager|Bereitstellungs-Managers]] zur Bereitstellung von Anwendungen.

Weitere Informationen finden Sie unter [[64-Bit-Windows-Anwendungsentwicklung|64-Bit-Windows-Anwendungsentwicklung]].
|- valign="top"
|
'''Konsolenanwendungen '''
(OS X, iOS oder 64-Bit-Windows)

'''Zielcomputer:'''
* Mac, auf dem das Betriebssystem OS X ausgeführt wird (für {{Delphi}}- und {{CBuilder}}-Anwendungen)
* iOS-Simulator oder iOS-Gerät
* PC, auf dem das Betriebssystem 64-Bit-Windows ausgeführt wird (nur für {{Delphi}}-Anwendungen)
|
#Erstellen Sie in {{Delphi}} oder {{CBuilder}} eine Konsolenanwendung:
#* [[Neue Konsolenanwendung (C++)|Neue Konsolenanwendung]]
# Fügen Sie in der '''Projektverwaltung''' dem Knoten '''Zielplattformen''' die Zielplattform ('''OS X''', entweder '''iOS-Simulator''', '''iOS-Gerät - 32 Bit''', '''iOS-Gerät - 64 Bit''', oder '''64-Bit-Windows''') hinzu.
# Aktivieren Sie die Zielplattform in der '''Projektverwaltung''':
#* '''OS X'''
#* '''iOS-Simulator''', '''iOS-Gerät - 32 Bit''' oder '''iOS-Gerät - 64 Bit'''
#* '''64-Bit-Windows'''
|
Zum Ausführen, Debuggen und Bereitstellen einer OS X- oder iOS-Anwendung müssen Sie [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|ein Verbindungsprofil erstellen]] und den "Platform Assistant", den Remote-Anwendungsserver, auf einem aktiv verbundenen Mac [[Installieren des Platform Assistant auf dem Mac|installieren]] und [[Ausführen des Platform Assistant auf dem Mac|ausführen]]. Außerdem müssen Sie ein [[SDK-Manager|SDK]] hinzufügen.

''' Ausgabe von Konsolenanwendungen auf dem iOS-Simulator und -Gerät '''

{{Product}} unterstützt iOS-Konsolenanwendungen in Verbindung mit Xcode. Wenn die Konsolenausgabe verwendet wird (z. B., wenn die Konsolenanwendung [[lib_de:System.Writeln|Writeln]] verwendet), wird die Ausgabe weder im iOS-Simulator- noch im iOS-Gerätefenster angezeigt. Die Ausgabe wird stattdessen an das Konsolenprotokoll gesendet, das Sie in der App '''OS X Console log viewer''' (für den iOS-Simulator) oder im Bereich '''Xcode Organizer device Console''' (für das iOS-Gerät) anzeigen können.

Weitere Informationen finden Sie unter:
* [[Schritte bei der Entwicklung von geräteübergreifenden Anwendungen|Schritte bei der Entwicklung von geräteübergreifenden Anwendungen]]
* [[Erstellen einer OS X-Konsolenanwendung Hello World|Erstellen einer geräteübergreifenden OS X-Konsolenanwendung "Hello World"]]{{f|cmd|
* [[Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile|Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile]]}}
|- valign="top" {{fr|datasnap}}
|
'''DataSnap-Anwendungen '''

'''Zielcomputer:'''
*DataSnap-Clients werden auf allen [[Unterstützte Zielplattformen|unterstützten Zielplattformen]] unterstützt.
*DataSnap-Server werden nur auf 64-Bit-Windows unterstützt.
|
#Wählen Sie eine der folgenden Anwendungen aus:
#* [[DataSnap-Server-Experte|DataSnap-Server]]
#* [[Experte für DataSnap-Client-Module|Experte für DataSnap-Client-Module]] oder [[Experte für DataSnap-REST-Client-Module|Experte für DataSnap-REST-Client-Modul]]
# Fügen Sie in der '''Projektverwaltung''' dem Knoten '''Zielplattformen''' die Zielplattform (entweder '''OS X''' (nur für DataSnap-Clients) oder '''64-Bit-Windows''') hinzu.
# Aktivieren Sie in der '''Projektverwaltung''' die Zielplattform (entweder '''OS X''' (nur für DataSnap-Clients) oder '''64-Bit-Windows''').
|
Zum Ausführen, Debuggen und Bereitstellen einer DataSnap-Anwendung auf einem OS X- oder Remote-Win64-Ziel müssen Sie [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|ein Verbindungsprofil erstellen]] und [[PAServer: Die Platform Assistant Server-Anwendung|den "Platform Assistant"-Server]], den Remote-Anwendungsserver, auf einem aktiv verbundenen Computer, auf dem die Zielplattform ausgeführt wird, installieren und ausführen. Für OS X-Anwendungen müssen Sie auch ein [[SDK-Manager|SDK]] hinzufügen.

Weitere Informationen finden Sie unter:
* [[Schritte bei der Entwicklung von geräteübergreifenden Anwendungen|Schritte bei der Entwicklung von geräteübergreifenden Anwendungen]]
* [[Erstellen einer OS X-Konsolenanwendung Hello World|Erstellen einer geräteübergreifenden OS X-Konsolenanwendung "Hello World"]]
* [[Geräteübergreifende Datenbankanwendungen|Geräteübergreifende Datenbankanwendungen]]
|}

{{f|radstudio|

==Andere Anwendungstypen, die geräteübergreifend sein können==

Folgende Anwendungen können geräteübergreifend sein:{{f|datasnap|

* [[DataSnap-Server-Experte|DataSnap-Server]] (Win64)}}{{f|radstudio|
* [[Experte für DataSnap-Client-Module|DataSnap-Client]] (Win64, OS X)}} {{f|appmethod|
* [[Experte für DataSnap-REST-Client-Module|Experte für DataSnap-Client-Module]] (Win64, OS X)}}{{f|webbroker|
* [[Experte für DataSnap WebBroker-Anwendungen|Experte für DataSnap WebBroker-Anwendungen]] (Win64)
* [[Neue Webserver-Anwendung|Webserver-Anwendung]] (Win64, OS X)}}{{f|activex|
* [[ActiveX-Steuerelemente|ActiveX]] (Win64)}}{{f|soap|
* [[Neue SOAP-Server-Anwendung|SOAP-Server-Anwendung]] (Win64)}}

}}

==Themen==

*'''Windows-Anwendungsentwicklung'''
**'''Vorbereiten von Windows-Anwendungen für die Bereitstellung'''
*** [[Anpassen der Windows-Anwendungsmanifestdatei|Anpassen der Windows-Anwendungsmanifestdatei]]
**'''[[64-Bit-Windows-Anwendungsentwicklung|64-Bit-Windows-Anwendungsentwicklung]]'''
*** [[Verbinden Ihres 32-Bit-PC mit einem Win64-PC|Verbinden Ihres 32-Bit-PC mit einem Win64-PC]]
*** [[64-Bit-Windows-Anwendung Hello World (Delphi und C++)|64-Bit-Windows-Anwendung "Hello World" ({{Delphi}} und C++)]]
*** [[64-Bit-Windows-Datentypen im Vergleich zu 32-Bit-Windows-Datentypen|64-Bit-Windows-Datentypen im Vergleich zu 32-Bit-Windows-Datentypen]]
*** [[Konvertieren von 32-Bit-Delphi-Anwendungen in 64-Bit-Windows|Konvertieren von 32-Bit-{{Delphi}}-Anwendungen in 64-Bit-Windows]]
* [[FireMonkey-Anwendungsplattform - geräteübergreifend|{{FM}}-Anwendungsplattform - geräteübergreifend]]
*''' [[OS X-Anwendungsentwicklung|OS X-Anwendungsentwicklung]]'''
** [[Arbeiten mit einem Mac und einem PC|Arbeiten mit einem Mac und einem PC]]
** [[Erstellen einer OS X-Konsolenanwendung Hello World|Geräteübergreifende OS X-Konsolenanwendung "Hello World"]]{{f|cmd|
** [[Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile|Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile]]}}
** [[PC-zugeordnete Erweiterungen|PC-zugeordnete Erweiterungen]]
*''' [[Mobile iOS-Anwendungsentwicklung|Mobile iOS-Anwendungsentwicklung]]'''
* '''[[Mobile Android-Anwendungsentwicklung|Mobile Android-Anwendungsentwicklung]]'''
* '''[[Mobile-Tutorials: Mobile Anwendungsentwicklung (iOS und Android)|Mobile-Tutorials: Mobile Anwendungsentwicklung (iOS und Android)]]'''
* [[Geräteübergreifende Datenbankanwendungen|Geräteübergreifende Datenbankanwendungen]]{{f|datasnap|
* [[DataSnap-Konnektoren für mobile Geräte|DataSnap-Konnektoren für mobile Geräte]]}}
* [[Experten zum Erstellen von geräteübergreifenden FireMonkey-Anwendungen und -Komponenten|Experten zum Erstellen von geräteübergreifenden {{FM}}-Anwendungen und -Komponenten]]{{f|cmd|
* [[Toolkette|Toolkette]]}}

{{DEFAULTSORT:Gerateubergreifende Anwendungstypen, die erstellt werden konnen}}
[[Category:Geräteübergreifend]]
[[Category:XE4]]
[[Category:AMMigrate]]

[[en:Types of Multi-Device Applications You Can Create]]
[[fr:Types d'applications multi-périphériques que vous pouvez créer]]
[[ja:作成できるマルチデバイスアプリケーションの種類]]

Tutorial: Verwenden von FireDAC aus einer geräteübergreifenden Anwendung auf Desktop-Plattformen

2016-06-24T10:46:29Z

Esabatell: Updated. LOC-22885

{{Parent|Tutorials zu Datenbanken und LiveBindings}}
__TOC__

In diesem Tutorial werden die grundlegenden Schritte zum Durchsuchen der von '''InterBase ToGo''' verwalteten Daten mithilfe des '''FireDAC'''-Frameworks unter Windows und auf dem Mac beschrieben.

<blockquote>'''Tipp:''' Für die Bearbeitung dieses Tutorials ist eine '''Lizenz''' für '''IBToGo''' erforderlich. Wenn Sie eine Testversion verwenden und InterBase auf dem Mac testen möchten, können Sie während der Testphase auf eine IBToGo-Bereitstellungslizenz für die Testversion zugreifen. Klicken Sie auf den folgenden Link, um Ihre Bereitstellungslizenz für die Testversion zu aktivieren: [https://reg.codegear.com/srs6/login.jsp?redirect=%2Fsrs6%2Factivation.do%3Fx%3D3%26serialNumber%3DD2AK-82Q7PS-VAN9NA-32VC%26key%3D74739 InterBase ToGo Deployment (EN)].</blockquote>

==Herstellen einer Verbindung zu der Datenbank mit FireDAC==

FireDAC ist ein einzigartiger Satz von '''[[Komponenten (FireDAC)|Komponenten]]''' für den universellen Datenzugriff zur Entwicklung von plattformübergreifenden Datenbankanwendungen für {{Delphi}}, {{CBuilder}} und FreePascal. Durch seine leistungsstarke allgemeine Architektur ermöglicht FireDAC von {{Delphi}} aus einen nativen, extrem schnellen, direkten Zugriff auf InterBase, SQLite, MySQL, SQL Server, Oracle, PostgreSQL, IBM DB2, SQL Anywhere, Access, Firebird, Informix und weitere.

Der [[Herstellen einer Verbindung zu InterBase (FireDAC)|native FireDAC-Treiber für InterBase]] unterstützt {{Company}} InterBase Server, Desktop, Developer, [http://edn.embarcadero.com/article/42319 ToGo (EN)] und IBLite Version 6 und höher.

* Zum Durchsuchen der von '''Interbase ToGo''' verwalteten Daten unter Windows muss für FireDAC die folgende x86- oder x64-Clientsoftware auf dem Arbeitsplatzrechner installiert sein:
** Die Bibliothek '''IBTOGO.DLL''' unterstützt die Arbeit mit Datenbanken mit eingebettetem InterBase ToGo oder IBLite von x86-Anwendungen aus.
** Die Bibliothek '''IBTOGO64.DLL''' unterstützt die Arbeit mit Datenbanken mit eingebettetem InterBase ToGo oder IBLite von x64-Anwendungen aus.
* Um von '''InterBase ToGo''' verwaltete Daten unter OS X durchsuchen zu können, benötigt FireDAC die eingebettete InterBase-x86-Datei '''libibtogo.dylib'''.

==Entwerfen und Einrichten der Benutzeroberfläche==

Erstellen Sie ein neues Projekt. Wählen Sie eine '''[[Geräteübergreifende HD-Anwendung|Geräteübergreifende HD-Anwendung]]'''.

# Legen Sie eine [[lib_de:FireDAC.Comp.Client.TFDConnection|TFDConnection]]-Komponente auf dem Formular ab.
# Klicken Sie mit der rechten Maustaste auf die [[lib_de:FireDAC.Comp.Client.TFDConnection|TFDConnection]]-Komponente, und wählen Sie '''Verbindungseditor'''.
# Legen Sie im FireDAC-Verbindungseditor die folgenden Parameter der [[lib_de:FireDAC.Comp.Client.TFDConnection|TFDConnection]]-Komponente fest:
## Legen Sie die Eigenschaft [[lib_de:FireDAC.Comp.Client.TFDCustomConnection.DriverName|Treiber-ID]] auf '''IB''' fest.
## Legen Sie den Parameter '''Database''' auf {{Path|{{DataSamplesPath}}\EMPLOYEE.GDB}} (Speicherort der Datenbank) fest.
## Legen Sie den Parameter '''User_name''' auf '''sysdba''' fest.
## Legen Sie den Parameter '''Password''' auf '''masterkey''' fest.
##: [[File:ConnectionEditor2.png|600px]] 
## Klicken Sie auf die Schaltfläche '''Testen''', um die Verbindung zu testen.
##: [[File:TestConnectionSuccess.png]] 
## Klicken Sie auf '''OK''', um den Verbindungseditor zu schließen.
# Legen Sie im [[Objektinspektor|Objektinspektor]] die folgenden Eigenschaften der '''TFDConnection'''-Komponente fest:
## Setzen Sie die Eigenschaft '''[[lib_de:Data.DB.TCustomConnection.LoginPrompt|LoginPrompt]]''' auf '''False''', damit der Benutzer nicht zur Eingabe von Anmeldedaten aufgefordert wird.
## Setzen Sie die Eigenschaft '''[[lib_de:Data.DB.TCustomConnection.Connected|Connected]]''' auf '''True'''.

==Verwenden des LiveBindings-Experten==

Verwenden Sie den '''LiveBindings-Experten''', um die LiveBindings-Komponenten ([[lib_de:Data.Bind.DBScope.TBindSourceDB|TBindSourceDB]], [[lib_de:Fmx.Bind.Navigator.TBindNavigator|TBindNavigator]]), [[lib_de:FireDAC.Comp.Client.TFDQuery|TFDQuery]] und [[lib_de:FMX.Grid.TStringGrid|Grid]] hinzuzufügen.

===Hinzufügen der LiveBinding-Komponenten===

# Wählen Sie '''Ansicht > LiveBindings-Designer'''. Der [[LiveBindings-Designer|LiveBindings-Designer]] wird geöffnet.
# Wählen Sie '''[[LiveBindings-Experte|LiveBindings-Experte]]''' ([[Image:LBDLiveBindingsWizard.png]]).
#: [[File:SelectLiveBindWizard.png]] 
# Wählen Sie auf der Seite '''Bindungsaufgabe''' die Option '''Datenquelle erstellen''', und klicken Sie auf '''Weiter'''.
# Wählen Sie auf der Seite '''Datenquelle''' die Option '''FireDAC''', und klicken Sie auf '''Weiter'''.
# Ändern Sie den '''Befehlstyp''' in '''Abfrage'''.
# Legen Sie die Eigenschaft '''Befehlstext''' auf <code>select * from employee</code> fest.
#: [[File:LiveBindingWizard.png]] 
# Klicken Sie auf die Schaltfläche '''Befehl testen'''.
# Klicken Sie auf die Schaltfläche '''Weiter'''.
# Wählen Sie '''Datenquellennavigator hinzufügen'''.
# Klicken Sie auf die Schaltfläche '''Fertig stellen'''.

Damit wurden die Komponenten [[lib_de:Data.Bind.DBScope.TBindSourceDB|TBindSourceDB]], [[lib_de:Fmx.Bind.Navigator.TBindNavigator|TBindNavigator]] und [[lib_de:FireDAC.Comp.Client.TFDQuery|TFDQuery]] Ihrem Formular hinzugefügt.

===Hinzufügen der Gitter-Komponente===

# Öffnen Sie erneut den [[LiveBindings-Experte|LiveBindings-Experten]].
# Wählen Sie die Bindungsaufgabe '''Gitter mit einer Datenquelle verknüpfen''' aus.
#: [[File:LinkGrid.png]] 
# Klicken Sie auf die Schaltfläche '''Weiter'''.
# Wählen Sie [[lib_de:FMX.Grid.TStringGrid|TSringGrid]] aus.
# Klicken Sie auf die Schaltfläche '''Weiter'''.
# Wählen Sie '''BindSourceDB1''' aus.
# Klicken Sie auf die Schaltfläche '''Fertig stellen''', um den Experten zu schließen. 

Das Bindungsdiagramm sollte wie in der folgenden Abbildung dargestellt aussehen: 
[[File:Diagram.png]] 

==Vorbereiten der Anwendung für die Ausführung==

FireDAC verfügt über eine lose verbundene [[Allgemeine Informationen (FireDAC)|mehrschichtige Architektur]], in der Dienste von Schichten bereitgestellt werden. Eine Dienst-API ist als COM-Interface definiert, das von anderen Schichten über den Interface-Generator angefordert werden kann.

Für die [[Vorbereiten einer FireDAC-Anwendung für die Ausführung|ordnungsgemäße Ausführung von FireDAC]] müssen Sie die Implementierung der Interfaces '''IFDGUIxWaitCursor''' und '''IFDPhysDriver''' in Ihre Anwendung einbinden.

# Wählen Sie die Komponente '''NavigatorBindSourceDB1''' aus, und setzen Sie die Eigenschaft [[lib_de:Fmx.Bind.Navigator.TBindNavigator.Align|Align]] auf '''Top'''.
# Wählen Sie die Komponente '''StringGridBindSourceDB1''' aus, und legen Sie die Eigenschaft [[lib_de:FMX.Grid.TStringGrid.Align|Align]] auf '''Client''' fest.
# Ziehen Sie die Komponenten [[lib_de:FireDAC.Comp.UI.TFDGUIxWaitCursor|TFDGUIxWaitCursor]] und [[lib_de:FireDAC.Phys.IB.TFDPhysIBDriverLink|TFDPhysIBDriverLink]] auf das Formular.
#: [[File:FormComponentsAdded.png|700px]] 

==Bereitstellen Ihrer Anwendung unter OS X==

Bis jetzt haben Sie InterBase auf dem Desktop verwendet. Das bedeutet, dass sich die eigentliche Datenbank auf Ihrer lokalen Festplatte (z. B. {{Path|{{DataSamplesPath}}\EMPLOYEES.GDB}}) befindet. Zum Bereitstellen der Anwendung unter OS X müssen Sie die Datenbankdatei in das Mac OS-Dateisystem kopieren (z. B. '''/Users/<user>/EMPLOYEE.GDB'''). Außerdem müssen die '''InterBase ToGo'''-Dateien für OS X bereitgestellt werden.

===Bereitstellen von InterBase ToGo für OS X===

# Öffnen Sie den [[Bereitstellungs-Manager|Bereitstellungs-Manager]] durch Auswahl von '''Projekt > Bereitstellung'''.
# Wählen Sie in der Dropdown-Liste der Zielplattformen oben im Bereitstellungs-Manager den Eintrag '''Alle Konfigurationen - OS X-Plattform''' aus.
# Wählen Sie [[Bereitstellungs-Manager - Weitere Dateien hinzufügen|Weitere Dateien hinzufügen]] ([[Image:DMgrAddFeatFiles.png]]):
#: [[File:AddingFeaturedFiles.png]] 
# Wählen Sie das InterBase ToGo-Datenbankmodul aus, und klicken Sie dann auf '''OK''', um das Dialogfeld '''Weitere Dateien''' zu schließen:
#: [[File:FeaturedFilesOSX.png]] 
#: Möglicherweise haben Sie von {{Company}} eine Lizenzdatei für ToGo mit dem Muster '''reg_nnnnnnn.txt''' ('''reg_nnnnnnn.txt''' ist eine generierte Zahl) erhalten:
#:* Wenn Sie die Datei unter dem Namen '''reg_ibtogo.txt''' (im Verzeichnis {{Path|{{PublicInterBasePath}}}}) gespeichert haben, können Sie einfach die gewünschte Lizenz auswählen.
#:* Wenn Sie die Datei unter ihrem Originalnamen gespeichert haben, dann wählen Sie '''Dateien hinzufügen''' und nehmen die Lizenzdatei in die Liste der für die Bereitstellung der Anwendung erforderlichen Dateien auf.

===Ändern des Codes für die Verbindung zu einer lokalen Datenbankdatei unter OS X===

Wie im vorigen Schritt beschrieben, wird die [[lib_de:FireDAC.Comp.Client.TFDConnection|TFDConnection]]-Komponente mit einer Datenbank unter Windows verbunden. Deshalb müssen Sie den Speicherort der Datei vor dem Herstellen einer Verbindung zu der Datenbank wie folgt ändern:

# Wählen Sie im Formular-Designer die '''FDConnection1'''-Komponente aus.
# Doppelklicken Sie im Objektinspektor auf das Feld '''Wert''' des '''BeforeConnect'''-Ereignisses.
# Fügen Sie den folgenden Code für diese Ereignisbehandlungsroutine hinzu:

<source lang="Delphi">
procedure TForm9.FDConnection1BeforeConnect(Sender: TObject);
begin
{$IFDEF MACOS}
FDConnection1.Params.Values['Database']:= '$(DOC)/EMPLOYEE.GDB';
{$ENDIF}
end;
</source>
Beachten Sie, dass '''$(DOC)''' eine [[Pfadvariablen (FireDAC)|Pfadvariable]] ist, mit der Sie die Eingabe von Pfadausdrücken vereinfachen können. Unter OS X zeigt die Variable $(DOC) auf das Stammverzeichnis des Benutzers (/Users/<user>).

==Ausführen der Anwendung unter Windows und OS X==

Ihre Anwendung kann nun ausgeführt werden. Sie sollten genau wie in der IDE die Daten durchsuchen können. Sie können mit der [[lib_de:Fmx.Bind.Navigator.TBindNavigator|TBindNavigator]]-Komponente auch Datensätze der Datenbank ändern.

'''So führen Sie die Anwendung aus:'''

# Wählen Sie in der [[Projektverwaltung|Projektverwaltung]] die Zielplattform aus. [[File:ProjectManagerSelectTarget.png]]
# Wählen Sie einen der folgenden Befehle aus:
#* '''Start > Start'''
#* '''Start > Ohne Debugger ausführen'''

[[File:RunTimeMac.png|700px]]

==Siehe auch==

* [[Herstellen einer Verbindung zu InterBase (FireDAC)|Herstellen einer Verbindung zu InterBase]]
* [[Bereitstellungslizenz für IBLite und IBToGo-Testversion|Bereitstellungslizenz für IBLite und IBToGo-Testversion in {{Product}} XE5]]
* [[Vorbereiten einer FireDAC-Anwendung für die Ausführung|Vorbereiten einer FireDAC-Anwendung für die Ausführung]]
* [[LiveBindings in RAD Studio|LiveBindings in RAD Studio]]
* [[Mobile-Tutorial: Verwenden von FireDAC in mobilen Anwendungen (iOS und Android)|Mobile-Tutorial: Verwenden von FireDAC in mobilen Anwendungen (iOS und Android)]]

{{DEFAULTSORT:Tutorial: Verwenden von FireDAC aus einer gerateubergreifenden Anwendung auf Desktop-Plattformen}}
[[Category:FMX]]
[[Category:FireDAC]]
[[Category:Delphi]]
[[Category:XE4]]
[[Category:AMMigrate]]

[[en:Tutorial: Using FireDAC from a Multi-Device Application on Desktop Platforms]]
[[fr:Tutoriel : Utilisation de FireDAC depuis une application multi-périphérique sur les plates-formes de bureau]]
[[ja:チュートリアル：デスクトッププラットフォーム上のマルチデバイスアプリケーションから FireDAC を使用する]]

Tutorial: Verbinden mit einer SQLite-Datenbank aus einer geräteübergreifenden Anwendung auf Desktop-Plattformen

2016-06-24T10:45:32Z

Esabatell: Updated. LOC-22885

{{Parent|Tutorials zu Datenbanken und LiveBindings}}

In diesem Tutorial wird anhand einer einfachen '''geräteübergreifenden Anwendung''' gezeigt, wie eine Verbindung mit einer SQLite-Datenbank hergestellt und eine einfache Abfrage ausgeführt wird.

In diesem Tutorial wird eine von Embarcadero bereitgestellte Datenbank verwendet, Sie können aber jede SQLite-Datenbank einsetzen, die für Sie verfügbar ist. Die in diesem Tutorial verwendete Datenbank befindet sich hier:

* '''Windows''': {{Path|{{DataSamplesPath}}\Employees.s3db}}.
* '''OS X''': Sie können die von {{Company}} bereitgestellte Datenbank auf Ihren Mac kopieren. Denken Sie vor der Bereitstellung Ihrer Anwendung daran, [[Aktivieren und Konfigurieren der Zielplattform#Aktivieren einer Zielplattform|'''OS X''' als Zielplattform auszuwählen]], und Ihr '''[[Verbindungsprofil-Manager|Verbindungsprofil]]''' zu überprüfen.

: '''Hinweis:''' Das SQLite-Programm ist in '''OS X''' ab Version 10.4 enthalten und befindet sich im Verzeichnis {{Path|/usr/bin}}. Wählen Sie zum Erstellen einer Datenbank einfach {{ menu | Programme > Dienstprogramme > Terminal}} aus. Öffnen Sie ein Terminalfenster, und geben Sie <code>sqlite3<Datenbankname></code> ein.

Die Datenbank enthält eine Tabelle namens '''Employee''' und mehrere Tupel mit Feldern. Im Folgenden wird eine Verbindung zu der Datenbank hergestellt, und alle Tupel in der Tabelle '''Employee''' werden angezeigt.

==Schritte==

<ol><li> Erstellen Sie eine geräteübergreifende Anwendung für {{Delphi}} oder C++:
* {{menu | Datei > Neu > Geräteübergreifende Anwendung - {{Delphi}} > Leere Anwendung}}
* {{menu | Datei > Neu > Geräteübergreifende Anwendung - {{CBuilderUI}} > Leere Anwendung}}
</li>
<li>[[Aktivieren und Konfigurieren der Zielplattform#Aktivieren einer Zielplattform|Aktivieren Sie eine Zielplattform]] in der '''[[Projektverwaltung|Projektverwaltung]]'''. Geräteübergreifende Anwendungen unterstützen die folgenden Plattformen:
* '''32-Bit-Windows'''
* '''64-Bit-Windows'''
* '''OS X'''
:'''Hinweis: ''' Wenn die gewünschte Zielplattform nicht in der '''Projektverwaltung''' angezeigt wird, klicken Sie mit der rechten Maustaste auf den Knoten '''[[Übersicht über Zielplattformen|Zielplattform]]''', um Ihrem Projekt diese Zielplattform hinzuzufügen. Weitere Informationen finden Sie unter [[Aktivieren und Konfigurieren der Zielplattform|Aktivieren und Konfigurieren der Zielplattform]].
</li>
<li>Doppelklicken Sie im [[Objektinspektor|Objektinspektor]] auf das Ereignis [[lib_de:FMX.Forms.TForm.OnCreate|onCreate]] des Formulars, und fügen Sie den folgenden Code hinzu:
<l s="delphi" />
* '''{{Delphi}}:'''
<source lang="Delphi">
procedure TDemonstration.FormCreate(Sender: TObject);
begin
Self.Caption := 'Demonstration';
end;
</source><l e="delphi" /><l s="cpp" />
* '''C++:'''
<source lang="cpp">
void __fastcall TDemonstration::FormCreate(TObject *Sender) {
this->Caption = "Demonstration";
}
</source><l e="cpp" /></li>
<li>Fügen Sie Ihrem Formular die folgenden Komponenten hinzu:
* Zwei [[lib_de:FMX.StdCtrls.TButton|TButton]]-Steuerelemente; setzen Sie im '''[[Objektinspektor|Objektinspektor]]''' die Eigenschaft [[lib_de:System.Classes.TComponent.Name|Name]] der beiden Schaltflächen auf <code>executeButton</code> bzw. <code>connectButton</code> und die Eigenschaft [[lib_de:FMX.Controls.TTextControl.Text|Text]] auf <code>Execute</code> bzw. <code>Connect</code>.
* Ein [[lib_de:Data.SqlExpr.TSQLConnection|TSQLConnection]]-Steuerelement; setzen Sie im '''Objektinspektor''' die Eigenschaft [[lib_de:Data.SqlExpr.TSQLConnection.DriverName|Driver]] auf <code>Sqlite</code>.
* Ein [[lib_de:FMX.Memo.TMemo|TMemo]]-Steuerelement; setzen Sie im '''Objektinspektor''' die Eigenschaft [[lib_de:System.Classes.TComponent.Name|Name]] auf <code>outputMemo</code>.
* Ein [[lib_de:Data.SqlExpr.TSQLQuery|TSQLQuery]]-Steuerelement; setzen Sie im '''Objektinspektor''' die Eigenschaft [[lib_de:Data.SqlExpr.TCustomSQLDataSet.SQLConnection|SQLConnection]] auf <code>SQLConnection1</code>.
:
::Jetzt sollte Ihr Formular etwa folgendermaßen aussehen:
:[[File:FMXSQLiteTutorialForm.png|350px]]
</li>
<li>Erstellen Sie in Ihrer Unit eine neue '''setParamsToConnect'''-Prozedur, und fügen Sie den folgenden Code hinzu:
:'''Hinweis:''' Ersetzen Sie "full_path_to_your_database_file" durch den absoluten Pfad zu Ihrer Datenbankdatei.
<l s="delphi" />
* '''{{Delphi}}:'''
<source lang="Delphi">
procedure TDemonstration.setParamsToConnect();
begin
// If Database param does not exist, it adds it. Otherwise, the existing value is overwritten.
if SQLConnection1.Params.IndexOf ('Database=') = -1 then
SQLConnection1.Params.Add('Database=full_path_to_your_database_file');
else
SQLConnection1.Params.Values ['Database'] := 'full_path_to_your_database_file';
end;
</source>
:
::
:::'''Hinweis:''' Vergessen Sie nicht die Deklaration von
<source lang="delphi" enclose="none"> procedure setParamsToConnect();</source> im <source lang="delphi" enclose="none">interface</source>-Abschnitt Ihrer Quelldatei.
<l e="delphi" /><l s="cpp" />
* '''C++:'''
<source lang="cpp">
void __fastcall TDemonstration::setParamsToConnect() {
// Use double backslash in Windows paths, as the backslash character (\) must be escaped with another backslash to be treated literally.
if (SQLConnection1->Params->IndexOf("Database") == -1) {
SQLConnection1->Params->Add("Database=full_path_to_your_database_file" );
}
else {
SQLConnection1->Params->Values["Database"] = "full_path_to_your_database_file";
}

}
</source>
:
::
:::'''Hinweis:''' Vergessen Sie nicht die Deklaration von
<source lang="delphi" enclose="none"> void __fastcall TDemonstration::setParamsToConnect(); </source> in der Datei {{Path|Unit.h}} Ihres Projekts.
<l e="cpp" /></li>
<li>Doppelklicken Sie im [[Objektinspektor|Objektinspektor]] auf das Ereignis [[lib_de:Data.SqlExpr.TSQLConnection.BeforeConnect|BeforeConnect]] der [[lib_de:Data.SqlExpr.TSQLConnection|TSQLConnection]]-Komponente.</li>
<li>Fügen Sie den folgenden Code für diese Ereignisbehandlungsroutine hinzu:
<l s="delphi" />
* '''{{Delphi}}:'''
<source lang="Delphi">
procedure TDemonstration.SQLConnection1BeforeConnect(Sender: TObject);
begin
SetParamsToConnect;
end;
</source><l e="delphi" /><l s="cpp" />
* '''C++:'''
<source lang="cpp">
void __fastcall TDemonstration::SQLConnection1BeforeConnect(TObject *Sender) {
setParamsToConnect();
}
</source><l e="cpp" /></li>
<li>Fügen Sie der [[lib_de:FMX.Controls.TControl.OnClick|OnClick]]-Ereignisbehandlungsroutine von <code>connectButton</code> den folgenden Code hinzu.
<l s="delphi" />
* '''{{Delphi}}:'''
<source lang="Delphi">
procedure TDemonstration.connectButtonClick(Sender: TObject);
begin
try
// Establish the connection.
outputMemo.Lines.Clear;
SQLConnection1.Connected := true;
executeButton.Enabled := true;
outputMemo.Text := 'Connection established!';
except
on E: EDatabaseError do
ShowMessage('Exception raised with message' + E.Message);
end;
end;
</source><l e="delphi" /><l s="cpp" />
* '''C++:'''
<source lang="cpp">

void __fastcall TDemonstration::connectButtonClick(TObject *Sender) {
outputMemo->Lines->Clear();
try {
SQLConnection1->Connected = true;
executeButton->Enabled = true;
outputMemo->Text = "Connection established!";
}
catch (EDatabaseError& E) {
ShowMessage("Exception raised with message" + E.Message);
}
}
</source><l e="cpp" /></li>
<li> Fügen Sie der [[lib_de:FMX.Controls.TControl.OnClick|OnClick]]-Ereignisbehandlungsroutine von <code>executeButton</code> den folgenden Code hinzu.
<l s="delphi" />
* '''{{Delphi}}:'''
<source lang="Delphi">
procedure TDemonstration.executeButtonClick(Sender: TObject);
var
query: String;
begin
outputMemo.Lines.Clear;
// A random query
query := 'SELECT * FROM Employee;';
try
// Assign the query to the object SQLQuery1.
SQLQuery1.SQL.Text := query;
SQLQuery1.Active := true;
except
on E: Exception do
outputMemo.Text := 'Exception raised with message: ' + E.Message;
end;
// Show the results of the query in a TMemo control.
ShowSelectResults();
end;
</source><l e="delphi" /><l s="cpp" />
* '''C++:'''
<source lang="cpp">
void __fastcall TDemonstration::executeButtonClick(TObject *Sender) {
String query;

outputMemo->Lines->Clear();
// A random query
query = "SELECT * FROM Employee;";
try {
// Assign the query to the object SQLQuery1.
SQLQuery1->SQL->Text = query;
SQLQuery1->Active = true;
}
catch (Exception& E) {
outputMemo->Text = "Exception raised with message" + E.Message;
}
// Show the results of the query in a TMemo control.
ShowSelectResults();
}
</source><l e="cpp" /></li>
<li>Fügen Sie den folgenden Code für die Prozedur <code>ShowSelectResults</code> hinzu:
<l s="delphi" />
* '''{{Delphi}}:'''
<source lang="Delphi">
procedure TDemonstration.ShowSelectResults();
var
names: TStringList;
i: Integer;
currentField: TField;
currentLine: string;
begin
if not SQLQuery1.IsEmpty then
begin
SQLQuery1.First;
names := TStringList.Create;
SQLQuery1.GetFieldNames(names);
while not SQLQuery1.Eof do
begin
currentLine := '';
for i := 0 to names.Count - 1 do
begin
currentField := SQLQuery1.FieldByName(names[i]);
currentLine := currentLine + ' ' + currentField.AsString;
end;
outputMemo.Lines.Add(currentLine);
SQLQuery1.Next;
end;
end;
end;
</source>
:
::
:::'''Hinweis:''' Vergessen Sie nicht die Deklaration von
<source lang="delphi" enclose="none"> procedure ShowSelectResults();</source> im <source lang="delphi" enclose="none">interface</source>-Abschnitt Ihrer Quelldatei.
<l e="delphi" /><l s="cpp" />
* '''C++:'''
<source lang="cpp">
void __fastcall TDemonstration::ShowSelectResults()
{
TStringList* names;
TField* currentField;
String currentLine;

if (!SQLQuery1->IsEmpty()) {
SQLQuery1->First();
names = new TStringList;
SQLQuery1->GetFieldNames(names);
while (!SQLQuery1->Eof)
{
currentLine = "";
for (int i = 0; i < names->Count; ++i)
{
currentField = SQLQuery1->FieldByName(names->Strings[i]);
currentLine = currentLine + " " + currentField->AsString;
}
outputMemo->Lines->Add(currentLine);
SQLQuery1->Next();
}

}

}
</source>
:
::
:::'''Hinweis:''' Vergessen Sie nicht die Deklaration von
<source lang="delphi" enclose="none"> void __fastcall TDemonstration::ShowSelectResults(); </source> in der Datei {{Path|Unit.h}} Ihres Projekts.
<l e="cpp" /></li>
<li>

Nach dem Ausführen Ihrer Anwendung und dem Klicken auf die Schaltfläche '''Connect''' und dann auf die Schaltfläche '''Execute''' sollte Ihre Anwendung wie folgt aussehen:

:[[File:FMXSQLiteTutorialApp.png|350px]]
</li>
</ol>

'''Hinweis:''' Um unter Windows eine Verbindung mit einer SQLite-Datenbank herzustellen, müssen Sie die Bibliothek '''sqlite3.dll''' Ihrem Systempfad hinzufügen und sicherstellen, dass '''sqlite3.dll''' von Ihrer Anwendung gefunden werden kann.

* 32-Bit-Windows: C:\Windows\System32
* 64-Bit-Windows: C:\Windows\SysWOW64

==Verwendete Komponenten und Ereignisse==

* [[lib_de:Data.DB.TDataSet|Data.DB.TDataSet]]
* [[lib_de:Data.DB.TField|Data.DB.TField]]
* [[lib_de:System.Classes.TStringList|System.Classes.TStringList]]
* [[lib_de:Data.SqlExpr.TSQLConnection|Data.SqlExpr.TSQLConnection]]
* [[lib_de:Data.SqlExpr.TSQLConnection.BeforeConnect|Data.SqlExpr.TSQLConnection.BeforeConnect]]
* [[lib_de:FMX.StdCtrls.TButton|FMX.StdCtrls.TButton]]
* [[lib_de:FMX.Memo.TMemo|FMX.Memo.TMemo]]
* [[lib_de:FMX.Controls.TControl.OnClick|FMX.Controls.TControl.OnClick]]

==Siehe auch==

* [[Unterstützung von SQLite in RAD Studio|Unterstützung von SQLite in RAD Studio]]
* [[Tutorial: TSQLMonitor-Unterstützung für SQLite-Datenbanken|Tutorial: TSQLMonitor-Unterstützung für SQLite-Datenbanken
]]
* [[TSQLConnection einrichten|TSQLConnection einrichten]]
* [[Objektinspektor|Objektinspektor]]
* [[lib_de:System.Classes.TComponent.Name|System.Classes.TComponent.Name]]
* [[lib_de:FMX.Forms.TForm.Caption|FMX.Forms.TForm.Caption]]

{{DEFAULTSORT:Tutorial: Verbinden mit einer SQLite-Datenbank aus einer gerateubergreifenden Anwendung auf Desktop-Plattformen}}
[[Category:Delphi]]
[[Category:C++]]
[[Category:XE6]]
[[Category:AMMigrate]]

[[en:Tutorial: Connecting to a SQLite Database from a Multi-Device Application on Desktop Platforms]]
[[fr:Tutoriel : Connexion à une base de données SQLite depuis une application multi-périphérique sur les plates-formes de bureau]]
[[ja:チュートリアル：デスクトッププラットフォーム上のマルチデバイスアプリケーションから SQLite データベースに接続する]]

Fehlerbehebung: Kann nicht auf dem iOS-Gerät bereitgestellt werden

2016-06-24T10:45:13Z

Esabatell: Updated. LOC-22885

{{Parent|Mobile iOS-Anwendungsentwicklung}}

Suchen Sie in den folgenden Bereichen nach einer Lösung für dieses Problem:

# Nur {{Delphi}}: Wenn Sie die iOS-App nicht auf dem iOS-Simulator ausführen, überprüfen Sie, ob die im folgenden Thema beschriebenen Anforderungen erfüllt sind:
#*[[RunIOSSimulatorFailedHelpPage|Fehlerbehebung: Kann nicht auf dem iOS-Simulator bereitgestellt werden]]
# [[Ausführen von iOS-Anwendungen auf einem iOS-Gerät|Überprüfen Sie, ob Ihr iOS-Gerät über ein USB-Kabel an Ihren Mac angeschlossen ist]].
# [[Ausführen von iOS-Anwendungen auf einem iOS-Gerät|Geben Sie eine iOS-Geräteplattform als Zielplattform in der Projektverwaltung an]].
#[[Ausfüllen der Bereitstellungsseite|Füllen Sie die Bereitstellungsseite aus]]. (Für die Codesignierung ist Ihr Entwicklerzertifikat erforderlich.)
#* [[Bereitstellungsseite#Entwicklerzertifikat|Stellen Sie sicher, dass ein gültiges Zertifikat auf Ihrem Mac installiert ist.]]
#* [[Bereitstellen von iOS-Anwendungen#Erstellen und Installieren von Bereitstellungsprofilen|Überprüfen Sie, ob ein gültiges Bereitstellungsprofil auf Ihrem iOS-Gerät installiert ist]].
# Legen Sie die erforderlichen '''Projektoptionen''' für Ihre iOS-App fest:
#* [[Anwendungsoptionen|Legen Sie Ihre Programmsymbole fest - Anwendungsoptionen]].
#* [[Versionsinformationen|Legen Sie info.plist-Schlüssel, wie z. B. UIDeviceFamily, fest - Versionsinformationen]].
# Stellen Sie sicher, dass die [[Installieren der Xcode-Befehlszeilen-Tools auf einem Mac|Xcode-Befehlszeilentools auf dem Mac installiert sind]]. (Erforderlich für die Codesignierung Ihrer iOS-App.)
# [[Ausführen von iOS-Anwendungen auf einem iOS-Gerät#'Mit Info für angeschlossenes Gerät übereinstimmendes DeviceSupport-Verzeichnis nicht gefunden'|Aktualisieren Sie Xcode, wenn eine neuere Version verfügbar ist]]. (Nach der Aktualisierung Ihres iOS-Geräts erforderlich)
# Wenn ein Dialogfeld mit der Fehlermeldung "Package kann nicht installiert werden" und einem Fehlercode angezeigt wird, führen Sie die unten für den jeweiligen Fehlercode beschriebenen Schritte aus:
#* '''e800000e:''' Die auf Ihrem Mac installierte Version von Xcode unterstützt die iOS-Version Ihres Gerätes nicht. Installieren Sie eine Version von Xcode auf Ihrem Mac, die die iOS-Version Ihres Gerätes unterstützt. Trennen Sie nach der Aktualisierung Ihr iOS-Gerät von Ihrem Mac und schließen Sie es wieder an.
#* '''e800001c:''' Wenn der iOS-Simulator auf Ihrem Mac ausgeführt wird, schließen Sie den Simulator, und versuchen Sie dann erneut, die Anwendung auf Ihrem iOS-Gerät auszuführen.
#*'''e800002d:''' Das auf Ihrem Mac gefundene Debug-Symbol stimmt nicht mit dem auf Ihrem iOS-Gerät überein.
#** Wenn Sie ein neues '''Xcode''' installieren oder das Gerät mit einer neuen iOS-Version aktualisieren, müssen Sie Ihr iOS-Gerät mit dem neuen auf Ihrem Mac installierten '''Xcode''' synchronisieren. Weitere Informationen finden Sie unter [[#Synchronisieren von Xcode mit Ihrem iOS-Gerät|Synchronisieren von Xcode mit Ihrem iOS-Gerät]].
#*'''e800003a:''' Sie versuchen, eine Anwendung mit demselben Namen wie eine früher installierte Anwendung auf dem Zielgerät zu installieren, aber Sie signieren die Anwendung mit einem anderen [[Bereitstellungsseite#Entwicklerzertifikat|Entwicklerzertifikat]]. {{Product}} versucht, die vorhandene Anwendung mit einem anderen Entwicklerzertifikat zu aktualisieren.
#** Deinstallieren Sie die vorhandene Anwendung auf dem Zielgerät, und versuchen Sie, Ihre Anwendung erneut auszuführen.
#** Wählen Sie unter {{Menu|Projekt > Optionen > Bereitstellung}} dasselbe [[Bereitstellungsseite#Entwicklerzertifikat|Entwicklerzertifikat]] für die Signierung Ihrer Anwendung aus.
#*'''e800007e:''' Ihre iOS-Geräteversion entspricht nicht den Mindestanforderungen.
#*: Wählen Sie {{Menu|Projekt > Optionen > {{Delphi}}-Compiler > [[Linken|Linken]]}} und ändern Sie '''Niedrigste unterstützte iOS-Version''' in die Version Ihres iOS-Gerätes. Zum Beispiel: {{Code|7.0}}. (Wenn das Problem dadurch nicht behoben wird, müssen Sie u. U. ein neueres iOS-Gerät kaufen.)
#*'''e8000080:''' Sie versuchen, Ihre iOS-Anwendung auf einem iOS-Gerät auszuführen, das nicht den für Ihr Projekt definierten [[Einstellungen für Standards in RAD Studio|iOS-Standards]] (UIDeviceFamily) entspricht. Beispielsweise versuchen Sie möglicherweise, Ihre iOS-Anwendung auf einem iPad auszuführen, aber Ihre Anwendung ist nur für die Ausführung auf einem iPhone konfiguriert.
#*: Wählen Sie {{Menu|Projekt > Optionen > [[Versionsinformationen#OS X- und iOS-Versionsinformationen|Versionsinformationen]]}}, und wählen Sie einen {{Code|UIDeviceFamily}}-Wert aus, der zu Ihrem iOS-Gerät passt. Wählen Sie z. B. '''iPhone & iPad''' aus, um Ihre Anwendung auf einem beliebigen iOS-Gerät auszuführen.
#*'''e8000087:''' Ihr iOS-Gerät unterstützt die ausgewählte Zielplattformarchitektur nicht. Dies kommt vor, wenn Sie versuchen, eine 64-Bit-iOS-Anwendung auf einem 32-Bit-iOS-Gerät auszuführen. Damit Ihre Anwendung auf einem Gerät ausgeführt wird, müssen Sie die folgenden Schritte ausführen:
#** Ändern Sie das Zielgerät in ein 64-Bit-iOS-Gerät.
#** Wählen Sie in der [[Projektverwaltung|Projektverwaltung]] als [[Unterstützte Zielplattformen|Zielplattform]] '''iOS-Gerät - 32 Bit''' aus, um Ihre Anwendung auf einem beliebigen 32-Bit-iOS-Gerät auszuführen.
#** Aktivieren Sie die Option '''Universelle iOS-Binärdatei generieren (armv7 + arm64)''', um Ihre Anwendung so zu erzeugen, dass sie 32-Bit- und 64-Bit-iOS-Geräte unterstützt. Sie finden diese Option in:
#*** {{Menu|Projekt > Optionen > {{Delphi}}-Compiler > Compilieren > [[Compilieren#Weitere Optionen|Weitere Optionen]]}} ({{Delphi}})
#*** {{Menu|Project > Options > C++-Compiler > Erweitert > [[C++-Compiler Erweitert#Weitere Optionen|Weitere Optionen]]}} (C++)
#*'''e8000097:''' Sie haben auf dem Ziel-iOS-Gerät Beschränkungen aktiviert, die die Installation neuer Anwendungen auf dem Gerät verhindern. Weitere Informationen finden Sie unter [https://support.apple.com/en-us/HT201304 About Restrictions (parental controls) (EN)].
#*: Deaktivieren Sie die Beschränkungen auf dem Zielgerät, und versuchen Sie, Ihre Anwendung erneut auszuführen.
#*'''e8008015:''' Das iOS-Zielgerät wurde nicht mit dem Bereitstellungsprofil bereitgestellt, das Sie in {{Variables|Product}} konfiguriert haben.
#*: Sie können entweder [[Bereitstellen von iOS-Anwendungen|das Zielgerät mit dem konfigurierten Bereitstellungsprofil bereitstellen]], oder Sie ändern das Bereitstellungsprofil in der Projektkonfiguration von {{Variables|Product}}. Siehe [[Ausfüllen der Bereitstellungsseite|Ausfüllen der Bereitstellungsseite]].
#*: Stellen Sie sicher, dass Ihre Bereitstellungsdaten in '''{{Variables|Product}}''' mit Ihrem iOS-Entwicklerkonto übereinstimmen und nicht mit Ihrem Mac-Entwicklerkonto. Gehen Sie bei der Angabe des [[Bereitstellungsseite#Entwicklerzertifikat|Namens Ihres iOS-Entwicklerzertifikats]] besonders sorgfältig vor.
#*'''e8008016:''' Mögliche Ursachen:
#** Sie haben [[Berechtigungsliste#Berechtigungsliste für iOS|Berechtigungsoptionen für iOS]] festgelegt, die vom auf dem Zielgerät installierten [[Bereitstellen von iOS-Anwendungen|Bereitstellungsprofil]] nicht zugelassen werden.
#**: Wenn Sie in Ihrer Anwendung '''[[Mobile-Tutorial: Verwenden von Remote-Mitteilungen (iOS und Android)|Remote-Mitteilungen]]''' verwenden, müssen Sie sicherstellen, dass Sie die korrekten [[Einrichten des Messaging-Dienstes#Registrieren bei Apple|Anwendungsdienste]] für das auf dem Zielgerät installierte Bereitstellungsprofil festgelegt haben.
#** Wenn Sie zum Signieren Ihrer Anwendung in den [[Bereitstellungsseite#Bereitstellungsoptionen|Bereitstellungsoptionen]] "Auto" verwenden, müssen Sie überprüfen, ob die [[Bereitstellungsseite|Signaturdaten]] für Ihr Zielgerät gültig sind. Möglicherweise müssen Sie einen bestimmten [[Bereitstellungsseite#Entwicklerzertifikat|Namen des Entwicklerzertifikats]] und ein [[Bereitstellungsseite#Bereitstellungsprofil|Bereitstellungsprofil]] auswählen.
#** Legen Sie auf der Seite '''[[Bereitstellungsseite|Bereitstellung]]''' den richtigen Wert für die {{Code|CFBundleIdentifier}}-Felder für Ihre Ziel-iOS-Plattform fest. Siehe [[Bereitstellen von iOS-Anwendungen#Erstellen von App-IDs für Anwendungen|Erstellen von App-IDs für Anwendungen]].
#* '''e8008018:''' Ihr Zertifikat ist veraltet. [[Bereitstellen von iOS-Anwendungen#Erstellen und Installieren von Bereitstellungsprofilen|Laden Sie eine neue Version Ihres Zertifikats herunter]].
#* '''e8008019:''' Dieser Fehler tritt auf, wenn Sie versuchen, eine für die Plattformkonfiguration '''Anwendungs-Store''' erstellte Anwendung auf einem iOS-Gerät auszuführen. Um eine Anwendung auf einem iOS-Gerät auszuführen, müssen Sie die Plattformkonfiguration '''Debug''' oder '''Ad hoc''' verwenden. Um Ihr Anwendungspaket für die Übermittlung an den App Store zu generieren, müssen Sie [[Bereitstellen von iOS-Anwendungen für die Übermittlung an den App Store|Ihre Anwendung bereitstellen]].
# Wenn ein Dialogfeld mit der Fehlermeldung "Mit Info für angeschlossenes Gerät übereinstimmendes DeviceSupport-Verzeichnis nicht gefunden" angezeigt wird, führen Sie folgende Schritte aus:
#* Überprüfen Sie, ob die '''Xcode'''-Version die SDK-Version auf Ihrem Gerät unterstützt. Wenn das Gerät nicht unterstützt wird, müssen Sie '''Xcode''' auf eine höhere Version aktualisieren. Siehe [[Ausführen von iOS-Anwendungen auf einem iOS-Gerät#"Mit Info für angeschlossenes Gerät übereinstimmendes DeviceSupport-Verzeichnis nicht gefunden"|Ausführen von iOS-Anwendungen auf einem iOS-Gerät]].
#* Wenn die SDK-Versionen kompatibel sind, finden Sie weitere Informationen unter [[#Synchronisieren von Xcode mit Ihrem iOS-Gerät|Synchronisieren von Xcode mit Ihrem iOS-Gerät]].
# Wenn ein Dialogfeld mit der Fehlermeldung "Application bundle should have Info.plist inside" (Anwendungspaket muss Info.plist enthalten) angezeigt wird, wählen Sie {{Menu|Projekt > Erzeugen > ProjektName}} um die [[Apple-Anwendungsinformationsdatei (*.info.plist)|Datei info.plist]] erneut zu generieren.
# Wenn ein Dialogfeld mit der Fehlermeldung "The program being debugged is not being run" (Das Programm, das gedebuggt werden soll, wird nicht ausgeführt) angezeigt wird, starten Sie Ihr iOS-Gerät und Ihren Mac neu.

Wenn am unteren Rand der {{Variables|Product}}-Benutzeroberfläche im Tool-Fenster '''Meldungen''' ein Fehlereintrag mit einem Fehlercode angezeigt wird, wählen Sie diesen Eintrag aus, und drücken Sie '''F1''', um die Hilfe für diesen Fehler zu öffnen.

==Synchronisieren von Xcode mit einem iOS-Gerät==

Sie müssen sicherstellen, dass das auf dem Mac installierte Xcode die iOS-Version auf dem iOS-Gerät unterstützt und dass beide miteinander synchronisiert sind. Frühen Sie dazu die folgenden Schritte aus:

# Trennen Sie die Verbindung Ihres iOS-Geräts mit dem Mac.
# Öffnen Sie '''Xcode''' auf Ihrem Mac.
# Wählen Sie im Hauptmenü '''Fenster''', '''Geräte''' aus.
# Schließen Sie Ihr iOS-Gerät wieder an den Mac an.
# Wählen Sie im Fenster '''Geräte''' auf der linken Seite des Fensters Ihr iOS-Gerät aus.
# Warten Sie, bis der Ladecursor [[Image:OSX Loader Wheel.png|25px]] ausgeblendet wird. Danach können Sie '''Xcode''' schließen und versuchen, die Anwendung erneut auszuführen oder zu debuggen.

===Weitere Informationen finden Sie in den folgenden Hilfethemen===

* [[Ausführen von iOS-Anwendungen auf einem iOS-Gerät|Ausführen von iOS-Anwendungen auf einem iOS-Gerät]]
* [[Vorbereiten von iOS-Anwendungen für die Bereitstellung|Vorbereiten von iOS-Anwendungen für die Bereitstellung]]
* [[Plattformvoraussetzungen für FireMonkey|Plattformvoraussetzungen für FireMonkey]]

{{DEFAULTSORT:Fehlerbehebung: Kann nicht auf dem iOS-Gerat bereitgestellt werden}}
[[Category:AMMigrate]]

[[en:Troubleshooting: Cannot Deploy to the iOS Device]]
[[fr:Dépannage : Impossible de déployer sur le périphérique iOS]]
[[ja:トラブルシューティング：iOS デバイスに配置できない]]

Software-Add-ins von Fremdherstellern

2016-06-24T10:44:48Z

Esabatell: Updated. LOC-22885

__NOTOC__
{{Parent|Einführung in RAD Studio}}

{{Product}} enthält Software von Fremdherstellern.

Diese Seite führt einige der wichtigsten Software-Programme von Fremdherstellern auf, die mit {{Product}} ausgeliefert werden. Mit dem '''[[GetIt-Package-Manager|GetIt-Package-Manager]]''' können Sie weitere Software von Fremdherstellern suchen und in {{Product}} installieren.

==Bibliotheken von Fremdherstellern==

{| class="wikitable"
|-
! rowspan="2" | Bibliothek
! colspan="2" | Unterstützte Sprachen
! colspan="6" | Unterstützte Plattformen
|- valign="top"
! {{Delphi}}
! C++
! 32-Bit-Windows
! 64-Bit-Windows
! OS X
! 32-Bit-iOS
! 64-Bit-iOS
! Android
|- valign="top"
|
[[Boost|Boost]]
|
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
|
|
{{V}}
|- valign="top"
|
[[Box2D|Box2D]]
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|- valign="top"
|
[[Dinkumware Standard-C++-Bibliothek|Dinkumware STL]]
|
|
{{V}}
|
{{V}}
|
{{V}}
|
|
|
|
|- valign="top" {{fr|fastreport}}
|
[[FastReport|FastReport]]
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
|
|
|
|- valign="top"
|
[[Indy|Indy]]
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|- valign="top" {{fr|intraweb}}
|
[[Verwendung von IntraWeb (VCL für das Web) - Index|IntraWeb]]
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
|
|
|
|- valign="top" {{fr|ipworks}}
|
[[IP*Works!|IP*Works!]]
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
|
|
|
|- valign="top" {{fr|teechart}}
|
[[TeeChart|TeeChart]]
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|
{{V}}
|}

==IDE-Erweiterungen und Tools von Fremdherstellern==

{| class="wikitable"
|-
! rowspan="2" | Bibliothek
! colspan="6" | Unterstützte Plattformen
|- valign="top"
! 32-Bit-Windows
! 64-Bit-Windows
! OS X
! 32-Bit-iOS
! 64-Bit-iOS
! Android
|- valign="top"
|
[[Beyond Compare|Beyond Compare]]
|
{{V}}
|
|
|
|
|
|- valign="top" {{fr|codesite}}
|
[[CodeSite|CodeSite]]
|
{{V}}
|
{{V}}
|
|
|
|
|}

==Siehe auch==

* [[GetIt-Package-Manager|GetIt-Package-Manager]] {{f|vcl|
* [[Migrieren von VCL-Anwendungen nach FireMonkey#Migrieren von VCL-Anwendungen nach {{FM}} mit der IDE-Erweiterung Mida Converter|Konvertieren einer VCL-Anwendung nach {{FM}} mit dem Mida Converter]] }}

[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]

[[en:Third Party Software Add-Ins]]
[[fr:Add-ins logiciels tiers]]
[[ja:サードパーティ製ソフトウェアアドイン]]

TeeChart

2016-06-24T10:44:31Z

Esabatell: Updated. LOC-22885

{{Parent|Software-Add-ins von Fremdherstellern}}

{{f|vcl|'''TeeChart''' ist eine von der VCL und {{FM}} in {{Product}} unterstützte Komponente für die Diagrammerstellung von Steema Software.|'''TeeChart''' ist eine Komponente für die Diagrammerstellung von Steema Software, die in {{Product}} von {{FM}} unterstützt wird.}} TeeChart enthält schnell und einfach zu verwendende Komponenten zur Diagrammerstellung für Geschäfts-, Echtzeit-, Finanz- und wissenschaftliche Anwendungen.

'''TeeChart''' ist in allen Versionen von {{Product}}, außer in der Starter-Version, enthalten; siehe das SKU-Diagramm (Feature-Matrix) unter [http://www.embarcadero.com/products/rad-studio/rad-studio-feature-matrix.pdf {{Product}} {{Version}} Feature-Matrix].

In der '''[[Tool-Palette|Tool-Palette]]''' wird ein '''TeeChart-Experte''' installiert, und durch Ausführen des Experten können Sie Folgendes erstellen:

* Datenbank-Diagramm
* Diagramm ohne Datenbank
* Diagramm aus Vorlage ({{Path|.tee}}-Datei)

Die Version '''TeeChart Lite''' für {{FM}}:

* Enthält sechs Datenvisualisierungstypen, die im 2D- oder 3D-Format angezeigt werden können: Linien-, Balken-, Flächen, Torten-, Punkt- und horizontales Balkendiagramm.
* Kann zum Erstellen von Anwendungen für Windows x32/x64-Plattformen und OS X verwendet werden.

Zur Unterstützung von '''Apple iOS''' ist der in der '''TeeChart Pro'''-Version von '''Steema Software''' enthaltene TeeChart-Quellcode erforderlich. Weitere Einzelheiten finden Sie in der [http://www.steema.com/featurematrix/vcl TeeChart Feature-Matrix] auf der Steema-Website.

==Siehe auch==

* [http://www.steema.com/teechart/vcl Homepage für TeeChart-Komponenten]
* [http://www.steema.com Steema Software]

[[Category:TeeChart]]

[[en:TeeChart]]
[[fr:TeeChart]]
[[ja:TeeChart]]

Übersicht über Zielplattformen

2016-06-24T10:44:20Z

Esabatell: Updated. LOC-22885

{{Parent|Geräteübergreifende Anwendungen entwickeln}}
{{Parent|Compilieren, Build erstellen und Anwendungen ausführen - Index}}
__TOC__

Mit dem Knoten '''[[Projektverwaltung#Kontextmenü für Zielplattformen|Zielplattformen]]''' in der [[Projektverwaltung|Projektverwaltung]] wird die [[Unterstützte Zielplattformen|Zielplattform]] für ein Projekt festgelegt.

[[File:AllTargetPlatforms.png|400px|thumb|right]]

Der Knoten '''Zielplattformen''' wird nur für Projekttypen angezeigt, die mehr als eine Plattform unterstützen, z. B.:

* [[Geräteübergreifende Anwendung|Geräteübergreifende Anwendungen]] (die alle [[Unterstützte Zielplattformen|verfügbaren Zielplattformen]] unterstützen){{f|vcl|
* VCL-Anwendungen (die Win32 und Win64 unterstützen)}}
* Konsolenanwendungen (die alle verfügbaren Zielplattformen unterstützen)

==Mit Zielplattformen auszuführende grundlegende Aufgaben==

* '''Hinzufügen einer Zielplattform''' zum aktuellen Projekt: Öffnen Sie die [[Projektverwaltung|Projektverwaltung]], klicken Sie mit der rechten Maustaste auf den Knoten '''Zielplattformen''', und wählen Sie dann im Kontextmenü den Befehl '''Plattform hinzufügen''' aus.
* '''Aktivieren einer Zielplattform''' für das aktuelle Projekt: Doppelklicken Sie auf die Zielplattform (oder klicken Sie mit der rechten Maustaste, und wählen Sie im Kontextmenü den Befehl '''Aktivieren''' aus).
* '''Zuweisen eines Verbindungsprofils und eines SDK''': Klicken Sie mit der rechten Maustaste auf eine Plattform, und wählen Sie im Kontextmenü '''Eigenschaften''' aus. Führen Sie dann im Dialogfeld '''[[Plattformeigenschaften|Plattformeigenschaften]]''' einen der beiden folgenden Schritte aus:
** Wählen Sie das Verbindungsprofil aus, oder wählen Sie im Kombinationsfeld '''Neue hinzufügen''', um ein neues Profil zu erstellen.
**:'''Hinweis:''' Ein Verbindungsprofil wird nur benötigt, wenn die Zielplattform eine der folgenden ist:
**:* OS X
**:* iOS
**:* 64-Bit-Windows und ein 32-Bit-Windows-Entwicklungssystem
** Wählen Sie das SDK aus, oder wählen Sie im Kombinationsfeld '''Neue hinzufügen''', um ein neues SDK zu installieren.
**:'''Hinweis:''' Ein SDK wird nur für mobile Projekte und für C++-Projekte für OS X benötigt.
* Anzeigen der [[Projektverwaltung#Kontextmenü für Zielplattformen|Kontextmenübefehle für eine Zielplattform]]: Klicken Sie im Knoten '''Zielplattformen''' mit der rechten Maustaste auf den Namen eines bestimmten geräteübergreifenden Ziels (wie '''64-Bit-Windows''').

Nach Zuweisung eines Verbindungsprofils zu der aktiven Plattform wird der Name des Verbindungsprofils und des zugewiesenen SDK in der '''Projektverwaltung''' neben der aktiven Plattform angezeigt. Zum Beispiel:

:[[Image:activatedprofilexe7.png]]

Unter '''[[Aktivieren und Konfigurieren der Zielplattform|Aktivieren und Konfigurieren der Zielplattform]]''' finden Sie eine Beschreibung der zur Konfiguration eines Projekts, das mehrere Plattformen unterstützt, in {{Product}} auszuführenden Schritte.

==Verwenden der Ziel- und Konfigurationsknoten==

Knoten der Zielplattformen können keinen, einen oder zwei der folgenden untergeordneten Knoten bereitstellen:

* '''[[#Verwenden des Zielknotens|Ziel]]'''. Führt die verfügbaren Geräte und Simulatoren auf, die auf der Zielplattform ausgeführt werden.
* '''[[#Verwenden des Konfigurationsknotens|Konfiguration]]'''. Führt die für die Zielplattform spezifischen Build-Konfigurationen auf.

Um '''eine Zielplattform oder Konfiguration zu aktivieren''', doppelklicken Sie auf den Knoten für die betreffende Zielplattform oder Konfiguration (oder klicken Sie mit der rechten Maustaste, und wählen Sie im Kontextmenü den Befehl '''Aktivieren''').

===Verwenden des Zielknotens===

Im Knoten '''Ziel''' eines Zielplattformknotens wird eine Liste der verfügbaren Zielgeräte und Simulatoren (iOS) angezeigt.

Die in dieser Liste angezeigten Namen hängen von der Zielplattform und dem Typ des Zielgeräts oder Simulators ab:

* Für die Zielplattformen '''iOS-Gerät - 32 Bit''' und '''iOS-Gerät - 64 Bit''' werden die Geräte nach Gerätenamen aufgeführt. Zum Beispiel: "Jane's iPhone".
* Für die Zielplattform '''iOS-Simulator''' werden Simulatoren nach dem Gerätemodell und der iOS-Version aufgeführt. Zum Beispiel: "iPhone 5s (iOS 8.1)".
* Für die Zielplattform '''Android''' werden die Geräte nach dem Gerätemodel aufgeführt. Zum Beispiel: "GT-I9505".

In Knoten '''Ziel''' des Zielplattformknotens '''Android''' werden die an Ihr Entwicklungsgerät angeschlossenen Android-Geräte angezeigt. Wenn Sie Android-Geräte an Ihr Entwicklungssystem anschließen oder davon trennen, erkennt {{Variables|Product}} dies automatisch und aktualisiert die Einträge in der Projektverwaltung entsprechend.
 Der Knoten '''Ziel''' der Zielplattformknoten '''iOS-Gerät - 32 Bit''' und '''iOS-Gerät - 64 Bit''' zeigt die an Ihren Mac angeschlossenen iOS-Geräte an. 

: '''Hinweis:''' Die '''[[Projektverwaltung|Projektverwaltung]]''' filtert diese Geräte nicht nach unterstützten Architekturen. Im Knoten '''Ziel''' des Zielplattformknotens '''iOS-Gerät - 64 Bit''' können 32-Bit-iOS-Geräte angezeigt werden, die keine 64-Bit-iOS-Anwendungen unterstützen.

Der Knoten '''Ziel''' des Zielplattformknotens '''iOS-Simulator''' führt die in Xcode installierten iOS-Simulatoren auf Ihrem Mac auf.

Um die '''Liste verfügbarer Ziele''' für eine Zielplattform manuell zu aktualisieren, klicken Sie mit der rechten Maustaste auf den Knoten '''Ziel''' und wählen '''Aktualisieren''' aus. Wenn im Knoten '''Ziel''' nach der Aktualisierung der Liste nicht die erwarteten Einträge angezeigt werden, gehen Sie wie folgt vor: [[Fehlerbehebung: In der Projektverwaltung werden keine Android-Ziele aufgeführt|Fehlerbehebung: In der Projektverwaltung werden keine Android-Ziele aufgeführt]].

Wenn das aktive Zielgerät oder der Zielsimulator nicht mehr in der Liste der Ziele angezeigt wird, wählt {{Variables|Product}} automatisch das erste verfügbare Zielgerät oder den ersten verfügbaren Zielsimulator aus. Wenn keine Zielgeräte oder Simulatoren für die aktive Zielplattform verfügbar sind, können Sie die Anwendung nicht auf der Zielplattform ausführen.

===Verwenden des Konfigurationsknotens===

Im Knoten '''Konfiguration''' wird eine Liste der plattformspezifischen Build-Konfigurationen angezeigt, die Sie zum Erstellen der Anwendung verwenden können.

Dieser Knoten ist nur für die Zielplattformen '''OS X''', '''iOS-Gerät - 32 Bit''', '''iOS-Gerät - 64 Bit''' und '''Android''' verfügbar:

*'''Android'''
** '''Entwicklung'''. Für Entwicklungszyklen.
** '''Anwendungs-Store'''. Für das letzte Build vor der Übermittlung der App an den Anwendungs-Store.

*'''iOS-Gerät - 32 Bit'''
** '''Entwicklung'''. Für Entwicklungszyklen.
** '''Ad-hoc'''. Für die private interne Distribution; weitere Informationen finden Sie unter [https://developer.apple.com/programs/ios/enterprise/ https://developer.apple.com/programs/ios/enterprise/ (EN)].

*'''iOS-Gerät - 64 Bit'''
** '''Entwicklung'''. Für Entwicklungszyklen.
** '''Ad-hoc'''. Für die private interne Distribution; weitere Informationen finden Sie unter [https://developer.apple.com/programs/ios/enterprise/ https://developer.apple.com/programs/ios/enterprise/ (EN)].
** '''Anwendungs-Store'''. Für das letzte Build vor der Übermittlung der App an den App Store.

*'''OS X'''
** '''Normal'''. Für Entwicklungszyklen.
** '''Anwendungs-Store'''. Für das letzte Build vor der Übermittlung der App an den Mac App Store.

==Verwenden des Android-Knotens "Bibliotheken"==

: [[Image:ProjectManagerAndroidLibrariesExample.png]]

Der Knoten der '''Android'''-Plattform enthält einen weiteren Knoten, '''Bibliotheken''', mit dem Sie Folgendes ausführen können:

* [[Verwenden der in RAD Studio integrierten Java-Bibliotheken für Android#Deaktivieren nicht benötigter in {{Product}} integrierter Java-Bibliotheken, um die Größe Ihrer Anwendung zu reduzieren|Deaktivieren von in {{Product}} integrierten Java-Bibliotheken]], die für Ihre Anwendung nicht erforderlich sind.
* [[Hinzufügen von Java-Bibliotheken zu Ihren Anwendungen in der Projektverwaltung|Hinzufügen benutzerdefinierter Java-Bibliotheken zu Ihrer Anwendung]].

==Siehe auch==

* [[Projektverwaltung#Kontextmenü für Zielplattformen|Kontextmenü für Zielplattformen]]
* [[Symbolleiste zur Auswahl des Plattformgeräts|Symbolleiste zur Auswahl des Plattformgeräts]]
* [[Unterstützte Zielplattformen|Unterstützte Zielplattformen]]
* [[Überblick zu Build-Konfigurationen|Überblick zu Build-Konfigurationen]]
* [[Schritte bei der Entwicklung von geräteübergreifenden Anwendungen|Schritte bei der Entwicklung von geräteübergreifenden Anwendungen]]
* [[Verbindungsprofil erstellen|Verbindungsprofil erstellen (Experte)]]
* [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC]]
* [[Hinzufügen von SDKs für OS X oder iOS|Hinzufügen von SDKs für OS X oder iOS]]
* [[Hinzufügen von Android-SDKs|Hinzufügen von Android-SDKs]]
* [[Aktivieren einer Konfiguration und einer Zielplattform für eine Projektgruppe|Aktivieren einer Konfiguration und einer Zielplattform für eine Projektgruppe]]
* [[PAServer: Die Platform Assistant Server-Anwendung|PAServer: Die Platform Assistant Server-Anwendung]]
* [[Geräteübergreifende Anwendung|Geräteübergreifende Anwendung]]
* [[Mobile-Tutorials: Mobile Anwendungsentwicklung (iOS und Android)|Mobile-Tutorials: Mobile Anwendungsentwicklung (iOS und Android)]]

{{DEFAULTSORT:Ubersicht uber Zielplattformen}}
[[Category:XE5]]
[[Category:AMMigrate]]

[[en:Target Platforms Overview]]
[[fr:Présentation des plates-formes cible]]
[[ja:［ターゲットプラットフォーム］の概要]]

Schritt 2 - Entwerfen des Schaltflächenbereichs (Delphi)

2016-06-23T08:20:08Z

Esabatell: Updated. LOC-22885

{{Parent|Erstellen einer FireMonkey-Komponente (Delphi)}}

Nach den aktuellen Windows- und OS X-Entwurfsrichtlinien werden Dialogfeldschaltflächen in der rechten unteren Ecke platziert. Die Reihenfolge der Schaltflächen ist bei den beiden Plattformen unterschiedlich:

* Windows: Ausführen, Nicht ausführen, Abbrechen
* Mac, iOS, Android: Nicht ausführen, Abbrechen, Ausführen

Das Design für '''DialogButtonPanel''' kann auf zweierlei Arten erstellt werden:

* Mit dem [[FireMonkey-Stil-Designer|FireMonkey-Stil-Designer]].
* Durch Erstellen eines neues Projekts, Entwerfen der neuen Komponente durch Ziehen von Komponenten auf das Formular und Erstellen des endgültigen Stils von '''DialogButtonPanel''' unter Verwendung der <code>.fmx</code>-Datei.

==Verwenden des [[FireMonkey-Stil-Designer|FireMonkey-Stil-Designers]]==

# Wechseln Sie zum '''PanelDesign'''-Formular, und fügen Sie eine [[lib_de:FMX.Controls.TStyleBook|TStyleBook]]-Komponente aus der [[Tool-Palette|Tool-Palette]] hinzu.
# Doppelklicken Sie auf [[lib_de:FMX.Controls.TStyleBook|TStyleBook]], um den [[FireMonkey-Stil-Designer|FireMonkey-Stil-Designer]] zu öffnen.
# Ziehen Sie ein [[lib_de:FMX.Objects.TRectangle|TRectangle]] aus der [[Tool-Palette|Tool-Palette]] in den Objekt-Design-Bereich des '''{{FM}}-Stil-Designers'''. Setzen Sie die Eigenschaften Fill.Kind und Stroke.Kind auf '''None''', damit die TPanel-Komponente standardmäßig transparent ist.
#: Mit [[lib_de:FMX.Objects.TRectangle|TRectangle]] wird der Bereich '''DialogButtonPanel''' definiert und gerendert. (Sie können dazu auch ein anderes Steuerelement verwenden.)
# Legen Sie auf dem [[lib_de:FMX.Objects.TRectangle|TRectangle]] ein [[lib_de:FMX.Layouts.TLayout|TLayout]] ab.
#: Setzen Sie in der Objekt-Hierarchie des Stil-Designers den Fokus auf [[lib_de:FMX.Layouts.TLayout|TLayout]], und führen Sie folgende Schritte aus:
#* Setzen Sie [[lib_de:FMX.Layouts.TLayout.Align|Align]] auf '''Bottom'''.
#* Fügen Sie ein weiteres [[lib_de:FMX.Layouts.TLayout|TLayout]] mit der Ausrichtung '''Top''' hinzu.
# Fügen Sie dem zuletzt hinzugefügten [[lib_de:FMX.Layouts.TLayout|TLayout]] drei [[lib_de:FMX.StdCtrls.TButton|Schaltflächen]] hinzu: '''Ausführen''', '''Nicht ausführen''', '''Abbrechen'''.
## Für die Schaltfläche '''Ausführen''':
##* Setzen Sie [[lib_de:FMX.StdCtrls.TButton.Default|Default]] auf '''True'''.
##* Setzen Sie [[lib_de:FMX.StdCtrls.TCustomButton.ModalResult|ModalResult]] auf '''mrOk'''.
##* Setzen Sie '''StyleName''' auf '''DoButton'''.
## Für die Schaltfläche '''Nicht ausführen''':
##* Für '''Nicht ausführen''' gibt es keinen integrierten Code, aber Sie können den Negativwert von '''mrOK''' (= -1) verwenden. Setzen Sie [[lib_de:FMX.StdCtrls.TCustomButton.ModalResult|ModalResult]] auf -1.
##* Setzen Sie '''StyleName''' auf '''DontButton'''.
## Für die Schaltfläche '''Abbrechen''':
##* Setzen Sie [[lib_de:FMX.StdCtrls.TButton.Cancel|Cancel]] auf '''True'''.
##* Setzen Sie [[lib_de:FMX.StdCtrls.TCustomButton.ModalResult|ModalResult]] auf '''mrCancel'''.
##* Setzen Sie '''StyleName''' auf '''CancelButton'''.
#: Diese Schaltflächenanordnung entspricht weder Windows noch Mac, iOS oder Android. Sie können die Reihenfolge später anpassen. Setzen Sie die Ausrichtung jeder Schaltfläche auf '''Left''', damit sie an der linken Seite "gestapelt" sind und alle einen entsprechenden linken Innenabstand haben. Geben Sie ein Platzhalter-Wort für die Beschriftungen "Ausführen/Nicht ausführen/Abbrechen" an, um eine ausreichende Breite für die Schaltflächen festlegen zu können. Die Gesamtbreite der Schaltflächen, ihr horizontaler Innenabstand und zusätzlicher Platz rechts von der letzten Schaltfläche muss als Breite (Width) des rechts ausgerichteten Layouts angegeben werden. Die Höhe (Height) der anderen beiden Layouts muss die Höhe der Schaltflächen, des oberen Innenabstands und, für die äußere TPanel-Komponente, den Platz unter den Schaltflächen wiedergeben.
#: Das endgültige Stildesign sollte folgendermaßen aussehen:
#: [[File:DialogButtonPanel win.style.png]]
# Erstellen Sie für jede Plattform einen speziellen Stil, und speichern Sie sie als '''DialogButtonPanel_win.style''', '''DialogButtonPanel_mac.style''', '''DialogButtonPanel_ios.style''' und '''DialogButtonPanel_android.style'''.
# Sie können Änderungen auch direkt in den <code>.style</code>-Dateien vornehmen und die Änderungen anschließend speichern.
# Wie Sie sehen, enthält jede <code>.style</code>-Datei den Inhalt des Stilbuchs in einer '''TLayout'''-Stammkomponente:

<source lang="Delphi">

object _1: TLayout
{ All objects would appear here, instead of this comment. Comments are not allowed in .style files! }
end

</source>

: Der Wrapper "TLayout" ist zum Laden der Stile in den Stil-Designer erforderlich, aber zur eigentlichen Verwendung des Stils als Vorgabestil für eine benutzerdefinierte Komponente sollten Sie den Wrapper entfernen, damit auf das Rechteck (in diesem Fall) direkt zugegriffen werden kann. Das Endergebnis sollte aus zwei separaten plattformspezifischen Dateien bestehen:

{| border="0"
|-
! '''DialogButtonPanel_win.style'''
! '''DialogButtonPanel_mac.style'''
! '''DialogButtonPanel_ios.style'''
! '''DialogButtonPanel_android.style'''
|-
|
<source lang="Delphi">
object TRectangle
StyleName = 'DialogButtonPanelStyle'
Align = Bottom
Position.Point = '(0,264)'
Width = 600.000000000000000000
Height = 46.000000000000000000
ClipChildren = True
HitTest = False
Fill.Kind = None
Stroke.Kind = None
Sides = [Top, Left, Bottom, Right]
object TLayout
Align = Right
Position.Point = '(261,0)'
Width = 288.000000000000000000
Height = 46.000000000000000000
object TLayout
Align = Top
Position.Point = '(0,12)'
Width = 288.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(0,12,0,0)'
object TButton
StyleName = 'DoButton'
Align = Left
Position.Point = '(12,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 0
StaysPressed = False
IsPressed = False
ModalResult = 1
Text = 'Do Verb'
Default = True
end
object TButton
StyleName = 'DontButton'
Align = Left
Position.Point = '(104,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 1
StaysPressed = False
IsPressed = False
ModalResult = -1
Text = 'Don'#39't Verb'
end
object TButton
StyleName = 'CancelButton'
Align = Left
Position.Point = '(196,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 2
StaysPressed = False
IsPressed = False
ModalResult = 2
Text = 'Cancel'
Cancel = True
end
end
end
end
</source>
|
<source lang="Delphi">
object TRectangle
StyleName = 'DialogButtonPanelStyle'
Align = Bottom
Position.Point = '(0,264)'
Width = 600.000000000000000000
Height = 46.000000000000000000
ClipChildren = True
HitTest = False
Fill.Kind = None
Stroke.Kind = None
Sides = [Top, Left, Bottom, Right]
object TLayout
Align = Right
Position.Point = '(249,0)'
Width = 300.000000000000000000
Height = 46.000000000000000000
object TLayout
Align = Top
Position.Point = '(0,12)'
Width = 300.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(0,12,0,0)'
object TButton
StyleName = 'DontButton'
Align = Left
Position.Point = '(12,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,12,0)'
TabOrder = 0
StaysPressed = False
IsPressed = False
ModalResult = -1
Text = 'Don'#39't Verb'
end
object TButton
StyleName = 'CancelButton'
Align = Left
Position.Point = '(116,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 1
StaysPressed = False
IsPressed = False
ModalResult = 2
Text = 'Cancel'
Cancel = True
end
object TButton
StyleName = 'DoButton'
Align = Left
Position.Point = '(208,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 2
StaysPressed = False
IsPressed = False
ModalResult = 1
Text = 'Do Verb'
Default = True
end
end
end
end
</source>
|
<source lang="delphi">
object TRectangle
StyleName = 'DialogButtonPanelStyle'
Align = Bottom
Position.Point = '(0,28)'
Width = 332.000000000000000000
Height = 50.000000000000000000
ClipChildren = True
HitTest = False
Fill.Kind = None
Stroke.Kind = None
Sides = [Top, Left, Bottom, Right]
object TLayout
Align = Right
Position.Point = '(44,0)'
Width = 288.000000000000000000
Height = 50.000000000000000000
object TLayout
Align = Top
Width = 288.000000000000000000
Height = 22.000000000000000000
object TButton
StyleName = 'DontButton'
Align = Left
Position.Point = '(104,0)'
Width = 90.000000000000000000
Height = 30.000000000000000000
Padding.Rect = '(12,0,12,0)'
TabOrder = 0
StaysPressed = False
IsPressed = False
ModalResult = -1
Text = 'Don'#39't Verb'
end
object TButton
StyleName = 'CancelButton'
Align = Left
Position.Point = '(196,0)'
Width = 90.000000000000000000
Height = 30.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 1
StaysPressed = False
IsPressed = False
ModalResult = 2
Text = 'Cancel'
Cancel = True
end
object TButton
StyleName = 'DoButton'
Align = Left
Position.Point = '(12,0)'
Width = 90.000000000000000000
Height = 30.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 2
StaysPressed = False
IsPressed = False
ModalResult = 1
Text = 'Do Verb'
Default = True
end
end
end
end
</source>
|
<source lang="delphi">
object TRectangle
StyleName = 'DialogButtonPanelStyle'
Align = Bottom
Position.Point = '(0,28)'
Width = 332.000000000000000000
Height = 50.000000000000000000
ClipChildren = True
HitTest = False
Fill.Kind = None
Stroke.Kind = None
Sides = [Top, Left, Bottom, Right]
object TLayout
Align = Right
Position.Point = '(44,0)'
Width = 288.000000000000000000
Height = 50.000000000000000000
object TLayout
Align = Top
Width = 288.000000000000000000
Height = 22.000000000000000000
object TButton
StyleName = 'DontButton'
Align = Left
Position.Point = '(104,0)'
Width = 90.000000000000000000
Height = 30.000000000000000000
Padding.Rect = '(12,0,12,0)'
TabOrder = 0
StaysPressed = False
IsPressed = False
ModalResult = -1
Text = 'Don'#39't Verb'
end
object TButton
StyleName = 'CancelButton'
Align = Left
Position.Point = '(196,0)'
Width = 90.000000000000000000
Height = 30.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 1
StaysPressed = False
IsPressed = False
ModalResult = 2
Text = 'Cancel'
Cancel = True
end
object TButton
StyleName = 'DoButton'
Align = Left
Position.Point = '(12,0)'
Width = 90.000000000000000000
Height = 30.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 2
StaysPressed = False
IsPressed = False
ModalResult = 1
Text = 'Do Verb'
Default = True
end
end
end
end
</source>
|}

==Verwenden von FMX-Dateien==

# Entwerfen Sie im '''PanelDesign'''-Formular die neue Komponente durch Hinzufügen der gleichen Komponenten wie oben.
# Nehmen Sie für jede verwendete Komponente die gleichen Änderungen wie oben vor.
#: Das Ergebnis sollte wie folgt aussehen:
#: [[File:DialogButtonPanel in a form.png]]
# Wechseln Sie zur '''PanelDesign.fmx'''-Datei, und öffnen Sie sie.
# Extrahieren Sie den Code ab <code>object Rectangle1: TRectangle</code> bis zum zugehörigen <code>end</code>-Tag.
# Kopieren Sie die extrahierten Zeilen, und speichern Sie sie in einer <code>.style</code>-Datei.
# Führen Sie die gewünschten Änderungen aus, und speichern Sie die Datei unter '''DialogButtonPanel_win.style'''.
# Ordnen Sie die Schaltflächen gemäß der Mac-, iOS- und Android-Reihenfolge an, erstellen Sie die Datei '''DialogButtonPanel_mac.style''', '''DialogButtonPanel_ios.style''' oder '''DialogButtonPanel_android.style''' und speichern Sie sie.

Der Dateiinhalt für die Windows-Plattform sollte folgendermaßen lauten:

<source lang="Delphi">

object Rectangle1: TRectangle
Align = Bottom
Fill.Kind = None
Height = 50.000000000000000000
Position.Y = 28.000000000000000000
Stroke.Kind = None
Width = 332.000000000000000000
object Layout1: TLayout
Align = Right
Height = 50.000000000000000000
Position.X = 44.000000000000000000
Width = 288.000000000000000000
object Layout2: TLayout
Align = Top
Height = 22.000000000000000000
Width = 288.000000000000000000
object Button1: TButton
StyleName = 'DoButton'
Align = Left
Default = True
DisableFocusEffect = False
Height = 22.000000000000000000
ModalResult = 1
Padding.Left = 12.000000000000000000
Position.X = 12.000000000000000000
Text = 'Do Verb'
Width = 80.000000000000000000
end
object Button2: TButton
StyleName = 'DontButton'
Align = Left
DisableFocusEffect = False
Height = 22.000000000000000000
ModalResult = -1
Padding.Left = 12.000000000000000000
Position.X = 104.000000000000000000
Text = 'Don'#39't Verb'
Width = 80.000000000000000000
end
object Button3: TButton
StyleName = 'CancelButton'
Align = Left
Cancel = True
DisableFocusEffect = False
Height = 22.000000000000000000
ModalResult = 2
Padding.Left = 12.000000000000000000
Position.X = 196.000000000000000000
Text = 'Cancel'
Width = 80.000000000000000000
end
end
end
end

</source>

==Zurück==

* [[Schritt 1 - Erstellen der Projekte (Delphi)|Schritt 1 - Erstellen der Projekte ({{Delphi}})]]

==Weiter==

* [[Schritt 3 - Hinzufügen von Stilressourcen als RCDATA (Delphi)|Schritt 3 - Hinzufügen von Stilressourcen als RCDATA ({{Delphi}})]]

==Siehe auch==

* [[FireMonkey-Komponentendesign|FireMonkey-Komponentendesign]]
* [[Verwenden des Experten für neue Komponenten|Verwenden des Experten für neue Komponenten]]

<l s="cpp" />

* [[Erstellen einer FireMonkey-Komponente (C++)|Erstellen einer FireMonkey-Komponente (C++)]]

<l e="cpp" />

* [[Erstellen einer mit Stilen versehenen FireMonkey-Komponente durch Erweitern einer vorhandenen Komponente|Erstellen einer mit Stilen versehenen FireMonkey-Komponente durch Erweitern einer vorhandenen Komponente]]
* [[Erstellen eines grundlegenden FireMonkey-Steuerelements|Erstellen eines grundlegenden FireMonkey-Steuerelements]]

{{DEFAULTSORT:Schritt 2 - Entwerfen des Schaltflachenbereichs (Delphi)}}
[[Category:XE3]]
[[Category:FMX]]
[[Category:Delphi]]
[[Category:AMMigrate]]

[[en:Step 2 - Design the Panel (Delphi)]]
[[fr:Etape 2 - Concevoir le panneau (Delphi)]]
[[ja:ステップ 2 - パネルを設計する（Delphi）]]

Schritt 2 - Entwerfen des Schaltflächenbereichs (C++)

2016-06-23T08:19:34Z

Esabatell: Updated. LOC-22885

{{Parent|Erstellen einer FireMonkey-Komponente (C++)}}
Nach den aktuellen Windows- und OS X-Entwurfsrichtlinien werden Dialogfeldschaltflächen in der rechten unteren Ecke platziert. Die Reihenfolge der Schaltflächen ist bei den beiden Plattformen unterschiedlich:

* Windows: Ausführen, Nicht ausführen, Abbrechen
* Mac: Nicht ausführen, Abbrechen, Ausführen

Das Design für '''DialogButtonPanel''' kann auf zweierlei Arten erstellt werden:

* Mit dem [[FireMonkey-Stil-Designer|FireMonkey-Stil-Designer]]
* Durch Erstellen eines neues Projekts, Entwerfen der neuen Komponente durch Ziehen von Komponenten auf das Formular und Erstellen des endgültigen Stils von '''DialogButtonPanel''' unter Verwendung der <code>.fmx</code>-Datei.

==Verwenden des [[FireMonkey-Stil-Designer|FireMonkey-Stil-Designers]]==

# Wechseln Sie zum '''PanelDesign'''-Formular, und fügen Sie eine [[lib_de:FMX.Controls.TStyleBook|TStyleBook]]-Komponente aus der [[Tool-Palette|Tool-Palette]] hinzu.
# Doppelklicken Sie auf [[lib_de:FMX.Controls.TStyleBook|TStyleBook]], um den [[FireMonkey-Stil-Designer|FireMonkey-Stil-Designer]] zu öffnen.
# Ziehen Sie ein [[lib_de:FMX.Objects.TRectangle|TRectangle]] aus der [[Tool-Palette|Tool-Palette]] in den Objekt-Design-Bereich des '''{{FM}}-Stil-Designers'''. Setzen Sie die Eigenschaften Fill.Kind und Stroke.Kind auf '''None''', damit die TPanel-Komponente standardmäßig transparent ist.
#: Mit [[lib_de:FMX.Objects.TRectangle|TRectangle]] wird der Bereich '''DialogButtonPanel''' definiert und gerendert. (Sie können dazu auch ein anderes Steuerelement verwenden.)
# Legen Sie auf dem [[lib_de:FMX.Objects.TRectangle|TRectangle]] ein [[lib_de:FMX.Layouts.TLayout|TLayout]] ab.
#: Setzen Sie in der Objekt-Hierarchie des Stil-Designers den Fokus auf [[lib_de:FMX.Layouts.TLayout|TLayout]], und führen Sie folgende Schritte aus:
#* Setzen Sie [[lib_de:FMX.Layouts.TLayout.Align|Align]] auf '''Bottom'''.
#* Fügen Sie ein weiteres [[lib_de:FMX.Layouts.TLayout|TLayout]] mit der Ausrichtung '''Top''' hinzu.
# Fügen Sie dem zuletzt hinzugefügten [[lib_de:FMX.Layouts.TLayout|TLayout]] drei [[lib_de:FMX.StdCtrls.TButton|Schaltflächen]] hinzu: '''Ausführen''', '''Nicht ausführen''', '''Abbrechen'''.
## Für die Schaltfläche '''Ausführen''':
##* Setzen Sie [[lib_de:FMX.StdCtrls.TButton.Default|Default]] auf '''True'''.
##* Setzen Sie [[lib_de:FMX.StdCtrls.TCustomButton.ModalResult|ModalResult]] auf '''mrOk'''.
##* Setzen Sie '''StyleName''' auf '''DoButton'''.
## Für die Schaltfläche '''Nicht ausführen''':
##* Für '''Nicht ausführen''' gibt es keinen integrierten Code, aber Sie können den Negativwert von '''mrOK''' (= -1) verwenden. Setzen Sie [[lib_de:FMX.StdCtrls.TCustomButton.ModalResult|ModalResult]] auf -1.
##* Setzen Sie '''StyleName''' auf '''DontButton'''.
## Für die Schaltfläche '''Abbrechen''':
##* Setzen Sie [[lib_de:FMX.StdCtrls.TButton.Cancel|Cancel]] auf '''True'''.
##* Setzen Sie [[lib_de:FMX.StdCtrls.TCustomButton.ModalResult|ModalResult]] auf '''mrCancel'''.
##* Setzen Sie '''StyleName''' auf '''CancelButton'''.
#: Diese Schaltflächenanordnung entspricht weder Windows noch Mac. Sie können die Reihenfolge später anpassen. Setzen Sie die Ausrichtung jeder Schaltfläche auf '''Left''', damit sie an der linken Seite "gestapelt" sind und alle einen entsprechenden linken Innenabstand haben. Geben Sie ein Platzhalter-Wort für die Beschriftungen "Ausführen/Nicht ausführen/Abbrechen" an, um eine ausreichende Breite für die Schaltflächen festlegen zu können. Die Gesamtbreite der Schaltflächen, ihr horizontaler Innenabstand und zusätzlicher Platz rechts von der letzten Schaltfläche muss als Breite (Width) des rechts ausgerichteten Layouts angegeben werden. Die Höhe (Height) der anderen beiden Layouts muss die Höhe der Schaltflächen, des oberen Innenabstands und, für die äußere TPanel-Komponente, den Platz unter den Schaltflächen wiedergeben.
#: Das endgültige Stildesign sollte folgendermaßen aussehen:
#: [[File:DialogButtonPanel win.style.png]]
# Erstellen Sie für jede Plattform einen speziellen Stil, und speichern Sie sie als '''DialogButtonPanel_win.style''' und '''DialogButtonPanel_mac.style'''.
# Sie können Änderungen auch direkt in den <code>.style</code>-Dateien vornehmen und die Änderungen anschließend speichern.
# Wie Sie sehen, enthält jede <code>.style</code>-Datei den Inhalt des Stilbuchs in einer '''TLayout'''-Stammkomponente:

<source lang="Delphi">

object _1: TLayout
{ All objects would appear here, instead of this comment. Comments are not allowed in .style files! }
end

</source>

: Der Wrapper "TLayout" ist zum Laden der Stile in den Stil-Designer erforderlich, aber zur eigentlichen Verwendung des Stils als Vorgabestil für eine benutzerdefinierte Komponente sollten Sie den Wrapper entfernen, damit auf das Rechteck (in diesem Fall) direkt zugegriffen werden kann. Das Endergebnis sollte aus zwei separaten plattformspezifischen Dateien bestehen:

{| border="0"
|-
! '''DialogButtonPanel_win.style'''
! '''DialogButtonPanel_mac.style'''
|-
|
<source lang="Delphi">

object TRectangle
StyleName = 'DialogButtonPanelStyle'
Align = Bottom
Position.Point = '(0,264)'
Width = 600.000000000000000000
Height = 46.000000000000000000
ClipChildren = True
HitTest = False
Fill.Kind = None
Stroke.Kind = None
Sides = [Top, Left, Bottom, Right]
object TLayout
Align = Right
Position.Point = '(261,0)'
Width = 288.000000000000000000
Height = 46.000000000000000000
object TLayout
Align = Top
Position.Point = '(0,12)'
Width = 288.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(0,12,0,0)'
object TButton
StyleName = 'DoButton'
Align = Left
Position.Point = '(12,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 0
StaysPressed = False
IsPressed = False
ModalResult = 1
Text = 'Do Verb'
Default = True
end
object TButton
StyleName = 'DontButton'
Align = Left
Position.Point = '(104,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 1
StaysPressed = False
IsPressed = False
ModalResult = -1
Text = 'Don'#39't Verb'
end
object TButton
StyleName = 'CancelButton'
Align = Left
Position.Point = '(196,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 2
StaysPressed = False
IsPressed = False
ModalResult = 2
Text = 'Cancel'
Cancel = True
end
end
end
end

</source>
|
<source lang="Delphi">

object TRectangle
StyleName = 'DialogButtonPanelStyle'
Align = Bottom
Position.Point = '(0,264)'
Width = 600.000000000000000000
Height = 46.000000000000000000
ClipChildren = True
HitTest = False
Fill.Kind = None
Stroke.Kind = None
Sides = [Top, Left, Bottom, Right]
object TLayout
Align = Right
Position.Point = '(249,0)'
Width = 300.000000000000000000
Height = 46.000000000000000000
object TLayout
Align = Top
Position.Point = '(0,12)'
Width = 300.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(0,12,0,0)'
object TButton
StyleName = 'DontButton'
Align = Left
Position.Point = '(12,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,12,0)'
TabOrder = 0
StaysPressed = False
IsPressed = False
ModalResult = -1
Text = 'Don'#39't Verb'
end
object TButton
StyleName = 'CancelButton'
Align = Left
Position.Point = '(116,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 1
StaysPressed = False
IsPressed = False
ModalResult = 2
Text = 'Cancel'
Cancel = True
end
object TButton
StyleName = 'DoButton'
Align = Left
Position.Point = '(208,0)'
Width = 80.000000000000000000
Height = 22.000000000000000000
Padding.Rect = '(12,0,0,0)'
TabOrder = 2
StaysPressed = False
IsPressed = False
ModalResult = 1
Text = 'Do Verb'
Default = True
end
end
end
end

</source>
|}

==Verwenden von FMX-Dateien==

# Entwerfen Sie im '''PanelDesign'''-Formular die neue Komponente durch Hinzufügen der gleichen Komponenten wie oben.
# Nehmen Sie für jede verwendete Komponente die gleichen Änderungen wie oben vor.
#: Das Ergebnis sollte wie folgt aussehen:
#: [[File:DialogButtonPanel in a form.png]]
# Wechseln Sie zur '''PanelDesign.fmx'''-Datei, und öffnen Sie sie.
# Extrahieren Sie den Code ab <code>object Rectangle1: TRectangle</code> bis zum zugehörigen <code>end</code>-Tag.
# Kopieren Sie die extrahierten Zeilen, und speichern Sie sie in einer <code>.style</code>-Datei.
# Führen Sie die gewünschten Änderungen aus, und speichern Sie die Datei unter '''DialogButtonPanel_win.style'''.
# Ordnen Sie die Schaltflächen gemäß der Mac-Reihenfolge an, erstellen Sie die Datei '''DialogButtonPanel_mac.style''' und speichern Sie sie.

Der Dateiinhalt für die Windows-Plattform sollte folgendermaßen lauten:

<source lang="Delphi">

object Rectangle1: TRectangle
Align = Bottom
Fill.Kind = None
Height = 50.000000000000000000
Position.Y = 28.000000000000000000
Stroke.Kind = None
Width = 332.000000000000000000
object Layout1: TLayout
Align = Right
Height = 50.000000000000000000
Position.X = 44.000000000000000000
Width = 288.000000000000000000
object Layout2: TLayout
Align = Top
Height = 22.000000000000000000
Width = 288.000000000000000000
object Button1: TButton
StyleName = 'DoButton'
Align = Left
Default = True
DisableFocusEffect = False
Height = 22.000000000000000000
ModalResult = 1
Padding.Left = 12.000000000000000000
Position.X = 12.000000000000000000
Text = 'Do Verb'
Width = 80.000000000000000000
end
object Button2: TButton
StyleName = 'DontButton'
Align = Left
DisableFocusEffect = False
Height = 22.000000000000000000
ModalResult = -1
Padding.Left = 12.000000000000000000
Position.X = 104.000000000000000000
Text = 'Don'#39't Verb'
Width = 80.000000000000000000
end
object Button3: TButton
StyleName = 'CancelButton'
Align = Left
Cancel = True
DisableFocusEffect = False
Height = 22.000000000000000000
ModalResult = 2
Padding.Left = 12.000000000000000000
Position.X = 196.000000000000000000
Text = 'Cancel'
Width = 80.000000000000000000
end
end
end
end

</source>

==Zurück==

* [[Schritt 1 - Erstellen der Projekte (C++)|Schritt 1 - Erstellen der Projekte (C++)]]

==Weiter==

* [[Schritt 3 - Hinzufügen von Stilressourcen als RCDATA (C++)|Schritt 3 - Hinzufügen von Stilressourcen als RCDATA (C++)]]

==Siehe auch==

* [[FireMonkey-Komponentendesign|FireMonkey-Komponentendesign]]
* [[Verwenden des Experten für neue Komponenten|Verwenden des Experten für neue Komponenten]]
* [[Erstellen einer FireMonkey-Komponente (C++)|Erstellen einer FireMonkey-Komponente (C++)]]
* [[Erstellen einer mit Stilen versehenen FireMonkey-Komponente durch Erweitern einer vorhandenen Komponente|Erstellen einer mit Stilen versehenen FireMonkey-Komponente durch Erweitern einer vorhandenen Komponente]]
* [[Erstellen eines grundlegenden FireMonkey-Steuerelements|Erstellen eines grundlegenden FireMonkey-Steuerelements]]

{{DEFAULTSORT:Schritt 2 - Entwerfen des Schaltflachenbereichs (C++)}}
[[Category:XE3]]
[[Category:FMX]]
[[Category:Delphi]]
[[Category:AMMigrate]]

[[en:Step 2 - Design the Panel (C++)]]
[[fr:Etape 2 - Concevoir le panneau (C++)]]
[[ja:ステップ 2 - パネルを設計する（C++）]]

Schritte bei der Entwicklung von geräteübergreifenden Anwendungen

2016-06-23T08:19:09Z

Esabatell: Updated. LOC-22885

{{Parent|Geräteübergreifende Anwendungen entwickeln}}
__TOC__
Das Compilieren und Erzeugen geräteübergreifender Anwendungen, aber nicht das Ausführen, entspricht weitgehend den jeweiligen Operationen für das [[Arbeitsschritte bei der Projektentwicklung|Erzeugen von nativen Windows-Anwendungen]]. Die zusätzlichen Schritte sind in diesem Thema beschrieben.

Für das Ausführen und Debuggen einer geräteübergreifenden Anwendung für OS X, iOS oder in einigen Fällen für 64-Bit-Windows ist es erforderlich, dass das Entwicklungssystem mit der Zielplattform verbunden ist, auf der der '''Platform Assistant-Server''' (der Remote-Anwendungsserver) im Empfangsmodus ausgeführt wird.

==Beginnen Sie mit dem Einrichten Ihrer Entwicklungsumgebung==

===Wenn Ihre Anwendung für '''64-Bit-Windows''' vorgesehen ist===

* Für 64-Bit-Windows-Entwicklungssysteme ist keine spezielle Konfiguration erforderlich.
* Wenn Sie ein externes Win64-Zielsystem verwenden:
*# [[Verbinden Ihres 32-Bit-PC mit einem Win64-PC|Verbinden Sie Ihren Entwicklungs-PC mit dem 64-Bit-PC]].
*# [[Installieren des Platform Assistant unter Windows|Installieren]] Sie PAServer, den plattformübergreifenden Server, auf dem 64-Bit-PC, und [[Ausführen des Platform Assistant unter Windows|führen]] Sie ihn aus.
*# [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|Erstellen Sie ein Verbindungsprofil]], das die Verbindung mit dem "Platform Assistant"-Server auf dem 64-Bit-PC beschreibt.

===Wenn Ihre Anwendung für '''OS X oder iOS''' vorgesehen ist===

# [[Arbeiten mit einem Mac und einem PC|Verbinden Sie Ihren Entwicklungs-PC mit dem Mac]].
# [[Installieren des Platform Assistant auf dem Mac|Installieren]] Sie PAServer, den plattformübergreifenden Server, auf dem Mac, und [[Ausführen des Platform Assistant auf dem Mac|führen]] Sie ihn aus.
# [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|Erstellen Sie ein Verbindungsprofil]], das die Verbindung mit dem "Platform Assistant"-Server auf dem Mac beschreibt.
# [[Hinzufügen von SDKs für OS X oder iOS|Fügen Sie ein SDK]] hinzu, damit Ihre Anwendung erzeugt werden kann.
# Erwerben Sie die erforderlichen Entwickler-IDs und -Zertifikate von Apple. Einzelheiten finden Sie unter:
#* Mac: [[OS X-Anwendungsentwicklung|Mac OS X-Anwendungsentwicklung]]
#* iOS: [[Teilnehmen am Apple-Entwicklerprogramm|Beitreten zum Apple-Entwicklerprogramm]], [[Erwerben eines iOS-Entwicklerzertifikats|Erwerben eines iOS-Entwicklerzertifikats]] und [[Bereitstellen von iOS-Anwendungen|Bereitstellen von iOS-Anwendungen]].
# [[Ausfüllen der Bereitstellungsseite|Konfigurieren Sie Ihre Zertifikate und Bereitstellungsprofile in {{Product}}]].

===Wenn Ihre Anwendung für '''Android''' vorgesehen ist===

# [[Aktivieren des USB-Debugging auf Android-Geräten|Aktivieren Sie das USB-Debugging auf Ihrem Android-Gerät]].
# [[Konfigurieren des Systems für die Erkennung von Android-Geräten|Konfigurieren Sie Ihr System so, dass Ihr Android-Gerät erkannt wird]].
# [[Ausfüllen der Bereitstellungsseite|Konfigurieren Sie Ihr Signierungszertifikat in {{Product}}]].

==Erstellen und konfigurieren Sie dann in der IDE eine geräteübergreifende Anwendung==

Erstellen Sie Ihre Anwendung, indem Sie einen [[Experten zum Erstellen von geräteübergreifenden FireMonkey-Anwendungen und -Komponenten|Experten auswählen, der die ausgewählte Zielplattform unterstützt]].

: Sie können beispielsweise [[Geräteübergreifende Anwendung|Geräteübergreifend Anwendung]] auswählen, die die geräteübergreifende Anwendungsentwicklung für alle [[Unterstützte Zielplattformen|verfügbaren Zielplattformen unterstützt]].
:''' [[Konsolenanwendungen|Konsolenanwendungen]]''' können geräteübergreifend sein, wenn die Zielplattform in der Projektverwaltung entsprechend festgelegt ist. Wählen Sie einen der folgenden Befehle aus:
:* {{Delphi}}: '''Datei > Neu > Weitere > {{Delphi}}-Projekte > Konsolenanwendung'''
:* C++: '''Datei > Neu > Weitere > {{CBuilderUI}}-Projekte > Konsolenanwendung'''

===Übersicht: So konfigurieren Sie Ihre geräteübergreifende Anwendung in der {{Product}}-IDE===

[[Aktivieren und Konfigurieren der Zielplattform|Weitere Einzelheiten finden Sie unter: Geräteübergreifende Anwendung]]

#'''Hinzufügen und Aktivieren der Zielplattform (in der [[Projektverwaltung|Projektverwaltung]]):'''
## Klicken Sie zum Hinzufügen einer Plattform zu der aktuellen Anwendung in der Projektverwaltung auf den Knoten '''Zielplattformen''', wählen Sie '''Plattform hinzufügen''' und dann die Zielplattform, z. B. '''OS X''', aus.
##:(Der Knoten '''Zielplattformen''' wird nur für Anwendungen angezeigt, die geräteübergreifend sind.)
## Doppelklicken Sie auf eine Zielplattform (oder klicken Sie mit der rechten Maustaste, und wählen Sie im Kontextmenü '''Aktivieren''' aus) oder wählen Sie die Plattform in der [[Symbolleiste zur Auswahl des Plattformgeräts|Symbolleiste zur Auswahl des Plattformgeräts]], um die Zielplattform zu aktivieren.
##: Doppelklicken Sie beispielsweise auf '''OS X''', wenn die aktuelle Anwendung OS X als Zielplattform verwenden soll.
#'''Konfigurieren der Zielplattform (in der [[Projektverwaltung|Projektverwaltung]]):''' 
## Klicken Sie mit der rechten Maustaste auf die aktive Zielplattform, und wählen Sie aus dem Kontextmenü '''Eigenschaften'''. Das Dialogfeld '''[[Plattformeigenschaften|Plattformeigenschaften]]''' wird angezeigt.
## Sie müssen nur ein '''SDK (Software Development Kit)''' konfigurieren, wenn Sie eine Anwendung für '''OS X''', eine Anwendung für '''iOS (Gerät oder Simulator)''' oder eine '''Android'''-Anwendung entwickeln:
### Klicken Sie im Dialogfeld [[Plattformeigenschaften|Plattformeigenschaften]] im Kombinationsfeld '''SDK''' auf den Pfeil nach unten, und wählen Sie '''Neue hinzufügen''' aus.
### Klicken Sie im Dialogfeld '''[[Neues SDK hinzufügen|Neues SDK hinzufügen]]''' im Kombinationsfeld '''SDK-Version auswählen''' auf den Pfeil nach unten.
### Wählen Sie in der Liste verfügbarer SDKs, die daraufhin angezeigt wird, das SDK aus, das Sie für die ausgewählte Plattform verwenden möchten.
## Sie müssen das '''Verbindungsprofil''', das für die ausgewählte Plattform verwendet werden soll, nur auswählen, wenn es sich bei Ihrer Anwendung um eine '''64-Bit-Windows'''-Anwendung (und Ihr Entwicklungssystem nicht Win64 ist), um eine '''OS X'''-Anwendung oder um eine Anwendung für '''iOS (Gerät oder Simulator)''' handelt.
##: Um ein Verbindungsprofil für die ausgewählte Plattform zu erstellen, wählen Sie im Kombinationsfeld den Eintrag '''Neue hinzufügen''' aus.
## Klicken Sie zum Speichern der Änderungen auf '''OK'''.
# Für '''Datenbankanwendungen''' müssen Sie die entsprechenden Datenbanktreiber für die Bereitstellung auf der Zielplattform auswählen:
## Öffnen Sie den [[Bereitstellungs-Manager|Bereitstellungs-Manager]].
## Wählen Sie in der Symbolleiste '''[[Bereitstellungs-Manager - Weitere Dateien hinzufügen|Weitere Dateien hinzufügen]]''' aus ([[Image:DMgrAddFeatFiles.png]]).
## Wählen Sie im Dialogfeld '''Weitere Dateien hinzufügen''' die Datenbanktreiber für die Zielplattform Ihrer Anwendung aus.
#:Im Dialogfeld '''Weitere Dateien hinzufügen''' können Sie auch die Plattformunterstützung für die verschiedenen Datenbanktreiber überprüfen.
# Für alle Anwendungen können Sie Ihrer Projektbereitstellung mit dem [[Bereitstellungs-Manager|Bereitstellungs-Manager]] optional verschiedene Dateien (z. B. Bibliotheken für das dynamische Linken auf der Zielplattform) hinzufügen, wenn Sie ein Verbindungsprofil verwenden.

==Weiter==

* [[Debuggen von geräteübergreifenden Anwendungen|Debuggen von geräteübergreifenden Anwendungen]]
* [[Bereitstellung von geräteübergreifenden Anwendungen|Bereitstellen von geräteübergreifenden Anwendungen]]

==Siehe auch==

* [[Geräteübergreifende Anwendungen entwickeln|Geräteübergreifende Anwendungen entwickeln]]
* [[64-Bit-Windows-Anwendungsentwicklung|64-Bit-Windows-Anwendungsentwicklung]]
* [[OS X-Anwendungsentwicklung|OS X-Anwendungsentwicklung]]
* [[Mobile iOS-Anwendungsentwicklung|Mobile iOS-Anwendungsentwicklung]]
* [[Mobile Android-Anwendungsentwicklung|Mobile Android-Anwendungsentwicklung]]
* [[PAServer: Die Platform Assistant Server-Anwendung|PAServer: Die Platform Assistant Server-Anwendung]]
* [[Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile|Compilieren und Linken einer C++-Konsolenanwendung für OS X in der Befehlszeile]]

{{DEFAULTSORT:Schritte bei der Entwicklung von gerateubergreifenden Anwendungen}}
[[Category:Geräteübergreifend]]
[[Category:XE4]]
[[Category:AMMigrate]]

[[en:Steps in Creating Multi-Device Applications]]
[[fr:Etapes de la création d'applications multi-périphériques]]
[[ja:マルチデバイスアプリケーション作成のステップ]]

Ein Projekt starten - Überblick

2016-06-23T08:18:40Z

Esabatell: Updated. LOC-22885

{{Parent|Einführung in RAD Studio}}
{{DISPLAYTITLE:Ein Projekt starten - Überblick}}

Ein '''Projekt''' ist eine Sammlung von Dateien, aus denen eine Zielanwendung erstellt wird. Die Sammlung umfasst neben den von Ihnen hinzugefügten und bearbeiteten Dateien, wie Quelltext- und Ressourcendateien, auch Dateien, die {{Variables|Product}} zum Speichern von Projekteinstellungen verwendet (z. B. die Projektdatei <code>.dproj</code> ({{Delphi}}) oder <code>.cbproj</code> ({{CBuilder}})). Projekte werden zur Entwurfszeit erstellt und liefern bei der Compilierung die Projektzieldateien (<code>.exe, .dll, .bpl,</code> usw.).

Wenn Sie die IDE öffnen, wird eine '''Standardprojektgruppe''' als oberstes Element in der '''[[Projektverwaltung|Projektverwaltung]]''' angelegt. Anwendungen, Formulare, Units und andere Dateien, die Sie in der IDE erstellen, werden der Standardprojektgruppe hinzugefügt. Sie können der Projektgruppe Projekte hinzufügen, indem Sie in der '''Projektverwaltung''' mit der rechten Maustaste auf die Projektgruppe ([[File:ProjGroupNew.png]]) klicken und einen [[Projektverwaltung#Kontextmenü für Projektgruppen|Kontextmenübefehl]], wie "Neues Projekt hinzufügen" oder "Existierendes Projekt hinzufügen", auswählen.

Zur Unterstützung der Entwicklungsarbeit enthält die '''[[Objektablage|Objektablage]]''' viele vordefinierte Vorlagen, Formulare, Dateien und andere Elemente, auf die Sie zurückgreifen können. Sie öffnen die Objektablage mit '''Datei > Neu > Weitere''' und können dann das gewünschte Element auswählen.

*Zum Erstellen eines Projekts wählen Sie '''Datei > Neu > Weitere'''.

*Um ein vorhandenes Projekt zu öffnen, wählen Sie es auf der '''Willkommensseite''' aus den Listen "Letzte Projekte" oder "Zuletzt geöffnete Projekte" aus oder wählen '''Datei > Projekt öffnen'''.

==Projektarten==

Je nachdem, mit welcher Edition von {{Variables|Product}} Sie arbeiten, können Sie herkömmliche Windows-Anwendungen, geräteübergreifende Anwendungen, Webanwendungen, Datenbankanwendungen, Webdienstanwendungen und viele andere erstellen. {{Variables|Product}} unterstützt auch Assemblies, benutzerdefinierte Komponenten<f s="radstudio" t="span" />, Multithreading und COM.<f e="radstudio" t="span" />
<f s="appmethod" t="span" /> und Multithreading. <f e="appmethod" t="span" /> Weitere Informationen zu den verfügbaren Tools in den einzelnen Editionen finden Sie in der Funktionsmatrix auf der {{Company}} {{Delphi}}-Webseite oder der {{Company}} {{CBuilder}}-Webseite.

{{f|radstudio|

===VCL- und andere Anwendungen für Windows===

Sie können Windows-Anwendungen mit der VCL (Visual Component Library), einer umfangreichen Bibliothek mit Komponenten und Funktionen, erstellen, die Sie für Ihr Projekt oder Formular auswählen können. Neben den herkömmlichen Einsatzmöglichkeiten können Windows-Anwendungen auch mit Konstrukten des .NET Framework verwendet werden. Beispielsweise ist es möglich, eine Windows-Anwendung als Web-Serveranwendung einzusetzen.
}}

===Geräteübergreifende Anwendungen (FireMonkey)===

Sie können geräteübergreifende Anwendungen mit der [[FireMonkey|FireMonkey-Komponentenbibliothek]] erstellen, die eine umfassende Bibliothek mit geräteübergreifenden Komponenten und Funktionen enthält, die Sie für Projekte für die folgenden Zielplattformen einsetzen können:

* OS X-Systeme
* iOS-Geräte
* Android-Geräte

Beispielsweise können Sie mit der Laufzeitbibliothek '''[[Verwenden von App-Tethering|Geräte-Tethering]]''' von Anwendungen über die Bluetooth-Technologie implementieren.

Weitere Informationen finden Sie unter '''[[Geräteübergreifende Anwendungen - Index|Geräteübergreifende Anwendungen]]'''.

===Webdienstanwendungen===

Sie können Webdienstanwendungen erstellen, die Inhalte, wie HTML-Seiten oder XML-Dokumente, über das Web bereitstellen. Webdienste sind eine Internet-basierte Integrationstechnik, mit der verschiedene Anwendungen via Web verbunden und Informationen über Standard-Nachrichtenprotokolle ausgetauscht werden können.

{{Variables|Product}} vereinfacht die Erstellung von Webdiensten durch die Bereitstellung von Methoden für die Entwicklung von SOAP-Serveranwendungen. Die .dll-Dateien werden dabei automatisch erzeugt, und der Webdienst lässt sich in der IDE testen, ohne dass dafür eine Client-Anwendung erstellt werden müsste.

===Datenbank/Konnektivitätsanwendungen===

Gleichgültig, ob Ihre Anwendungen Web Forms<f s="radstudio" t="span" />, VCL-Formulare<f e="radstudio" t="span" /> oder FireMonkey-Formulare verwendet, {{Variables|Product}} verfügt über die notwendigen Tools, um eine Datenbankverbindung herzustellen, eine Datenbank zu durchsuchen und zu bearbeiten, SQL-Abfragen durchzuführen sowie die aktuellen Daten live zur Entwurfszeit anzuzeigen.

'''[[FireDAC|FireDAC]]''' ist unsere bedeutendste Datenbanklösung, die eine beispiellose Leistung und [[Datenbankkonnektivität (FireDAC)|Konnektivität]] bietet.

Des Weiteren bieten wir unter anderem die folgenden Technologien [[Überblick zu REST|REST]], [[JSON|JSON]] und [[Enterprise Mobility Services (EMS)|Enterprise Mobility Services (EMS)]].

Mit dbExpress können Sie eine Verbindung zu [[InterBase|InterBase]]-, Oracle-, MS SQL-, Informix-, DB2-, Sybase- und MySQL-Datenbanken herstellen. Durch Erweiterung der Klassen des dbExpress-Frameworks haben Sie zudem die Möglichkeit, Datenbanktreiber zu entwickeln. Mit dbExpress kann sowohl nativer als auch verwalteter Code verwendet werden.

===Modellierungsprojekte===

Mit dem Begriff ''UML-Modellierung'' wird der Prozess des objektorientierten Entwurfs von Softwaresystemen mit grafischen UML-Diagrammen bezeichnet. Ein UML-Modell für ein Softwaresystem ist ungefähr mit den Plänen vergleichbar, die ein Ingenieur für ein großes Entwicklungsprojekt anfertigt. Wie Pläne stellt ein UML-Modell ein System nicht nur im Ganzen dar, sondern bietet auch die Möglichkeit, sich auf spezielle Aspekte, wie Struktur- und Verhaltensdetails, zu konzentrieren. Unabhängig von der jeweiligen Programmiersprache (und bis zu einem gewissen Grad auch von bestimmten Technologien) können alle am Entwicklungszyklus Beteiligten mit Hilfe des UML-Modells in derselben Sprache kommunizieren.

Die UML-Modellierung stellt einen Ansatz für das Software-Engineering dar, bei dem die UML-Modellierungstools vollständig in die Entwicklungsumgebung von {{Variables|Product}} integriert sind. Die UML-Modellierung baut auf Interfaces, Klassen und benutzerdefinierten Attributen auf. Dieser Ansatz sorgt für die Kommunikation zwischen dem Quelltexten eines Softwaresystems, das in der IDE programmiert wird, und seinem UML-Modell, das gleichzeitig im Modellierungstool der IDE entworfen wird.

Die Modellierung arbeitet im Kontext eines ''Modellierungsprojekts''. Die Modellierung erweitert ein normales Projekt von {{Variables|Product}} durch Hinzufügen von Dateien, die UML-Diagramme des Modellierungsprojekts beschreiben. Die Modellierung fügt den ''Modellierungsprojektdateien'' Verweise auf diese Modellierungsdateien hinzu. Die Modellierung arbeitet mit den Modellierungsprojekttypen '''Implementierung''' und '''Design''':

* '''Implementierungsprojekt''' – Implementierungsprojekte sind sprachspezifische Projekte. Implementierungsprojekte unterstützen nur UML 1.5-Modelle. Eine Implementierungsprojektdatei legt die {{Delphi}}- oder C++-Quellcodedateien und die Dateien der in diesem Projekt erstellten UML-Diagramme fest. Sie können UML 1.5-Modelle für sprachspezifische Projekte in {{Delphi}} und C++ erstellen. Die Dateinamenserweiterungen von Implementierungsprojektdateien lauten <code>.dproj</code> (für {{Delphi}}-Projekte) und <code>.cbproj</code> (für C++-Projekte).
* '''Designprojekt''' – Designprojekte sind sprachneutral und mit den UML 1.5- oder UML 2.0-Spezifikationen konform. Die Dateinamenserweiterung von Designprojektdateien lautet <code>.tgproj</code>.

Die IDE von {{Variables|Product}} nutzt die Modellierungsfunktionen, um für die Entwicklung des UML-Modells der Anwendung eine integrierte Oberfläche bereitzustellen. Zu den Modellierungsfunktionen gehören:

* [[Ein Projekt erstellen (Modellierung)|Erstellen von Projekten, die die UML-Modellierung unterstützen]] und [[UML-Modellierungsunterstützung für Projekte aktivieren|Aktivieren der UML-Modellierungsunterstützung für vorhandene Projekte]].
* Erstellen der unterstützten Typen von UML-Modellierungsdiagrammen und Bearbeiten von Modellelementen (Diagramme, Packages, Klassen, Beziehungen usw.) direkt in der '''Diagrammansicht''' oder der '''Modellansicht'''.
* Direktes Hinzufügen, Entfernen und Ändern von Attributen, Operationen, Datentypen und anderer Klassen-Member in Klassendiagrammen in der '''Diagrammansicht''' oder über die entsprechenden Knoten in der '''Modellansicht'''.
* Klassendiagramme ermöglichen die wechselseitige Synchronisierung zwischen sprachspezifischem Quellcode und dem UML-Modell. Änderungen im Quellcode werden in der grafischen Abbildung sofort wiedergegeben und umgekehrt.
* Wechselseitige Navigationsmöglichkeit zwischen Modellelementen und dem Quellcode. Sie können von der grafischen Abbildung eines Modellelements in der '''Diagrammansicht''' oder der '''Modellansicht''' direkt zum Quellcode navigieren, der dieses Modellelement implementiert. Genauso können Sie auch von einer Klasse im Quellcode direkt zum entsprechenden Diagramm in der '''Diagrammansicht''' navigieren.
* Exportieren und Importieren von UML-Modellen unter Verwendung des XMI-Formats.

<blockquote>'''Hinweis:''' Einige Modellierungsfunktionen stehen in bestimmten Editionen von {{Variables|Product}} nicht zur Verfügung. Informationen zu den Modellierungsfunktionen, die in Ihrer Edition unterstützt werden, finden Sie in der Funktionsmatrix auf der {{Company}} {{Delphi}}-Webseite oder der {{Company}} {{CBuilder}}-Webseite.</blockquote>

===Assemblies===

Eine Assembly ist ein logisches Package, ähnlich einer DLL-Datei, die aus Manifesten, Modulen, portierbaren Anwendungsdateien (PE) und Ressourcen (.html, .jpeg, .gif) besteht und für die Bereitstellung und Versionierung verwendet wird. Eine Anwendung kann über eine oder mehrere Assemblies verfügen, die wiederum von einer oder mehreren Anwendungen referenziert werden können, je nachdem, ob die Assemblies sich in einem Anwendungsverzeichnis oder in dem globalen Assembly-Cache (GAC) befinden.

==Weitere Projekte==

Zusätzlich zu den oben beschriebenen Projekttypen enthält {{Variables|Product}} Vorlagen für Klassenbibliotheken, Steuerelementbibliotheken, Konsolenanwendungen, Berichte, Textdateien, HTML-Dateien und andere. Diese Vorlagen befinden sich in der '''Objektablage''' und können mit '''Datei > Neu > Weitere''' geöffnet werden.

==Siehe auch==

*[[Ein Projekt erstellen|Ein Projekt erstellen]]
*[[Hinzufügen eines Projekts zu einer Projektgruppe|Hinzufügen eines Projekts zu einer Projektgruppe]]

{{DEFAULTSORT:Ein Projekt starten - Uberblick}}
[[Category:Delphi]]
[[Category:C++]]
[[Category:AMMigrate]]
[[Category:Mit RAD Studio arbeiten]]

[[en:Starting a Project - Overview]]
[[fr:Démarrage d'un projet]]
[[ja:プロジェクトの開始]]

Festlegen von Optionen für den Platform Assistant

2016-06-23T08:18:31Z

Esabatell: Updated. LOC-22885

{{Parent|PAServer: Die Platform Assistant Server-Anwendung}}

Bei der Ausführung des '''[[PAServer: Die Platform Assistant Server-Anwendung|Platform Assistant]]''' wird standardmäßig die folgende Konfiguration verwendet:

* Die Port-Nummer <code>64211</code>.
* Kein Passwort.
* Das "scratch"-Verzeichnis befindet sich im Installationsverzeichnis des "Platform Assistant". Weitere Informationen über dieses Verzeichnis finden Sie unter [[PAServer: Die Platform Assistant Server-Anwendung#Das Scratch-Verzeichnis|Das Scratch-Verzeichnis]].

Führen Sie einen der folgenden Schritte aus, um die Optionen für den Port, das Passwort und das "scratch"-Verzeichnis bei der Ausführung des "Platform Assistant" von der Befehlszeile aus zu konfigurieren:

* [[#Konfigurieren des Platform Assistant mit Befehlszeilenoptionen|Führen Sie den Platform Assistant mit Befehlszeilenoptionen aus, um die verschiedenen Optionen zu konfigurieren]].
* [[#Konfigurieren des Platform Assistant mit einer Konfigurationsdatei|Führen Sie den Platform Assistant mit Angabe einer Konfigurationsdatei aus]].

Der Wert für eine Option wird folgendermaßen ermittelt:

# Wenn Sie den Wert für eine Option in der '''Befehlszeile''' angeben, verwendet der "Platform Assistant" diesen Wert.
# Wenn Sie den Wert für eine Option in der angegebenen '''Konfigurationsdatei''' festlegen und Sie den Wert nicht in der Befehlszeile angeben, verwendet der "Platform Assistant" den in der Konfigurationsdatei angegebenen Wert.
# Wenn Sie den Wert für eine Option weder in der Befehlszeile noch in der angegebenen Konfigurationsdatei festlegen, verwendet der "Platform Assistant" den '''Standardwert''' für diese Option.

:'''Hinweis:''' Optionen sind nur wirksam, wenn der "Platform Assistant" ausgeführt wird. Wenn Sie dieselben Optionen bei der nächsten Ausführung des "Platform Assistant" verwenden möchten, müssen Sie diese Optionen erneut in der Befehlszeile angeben. Sie können in einer [[#Konfigurieren des Platform Assistant mit einer Konfigurationsdatei|Konfigurationsdatei]] eine Gruppe von Optionen für eine einzelne Befehlszeilenoption festlegen.

Sie können auch eine [[#Erzeugen und Verwenden einer .passfile-Datei|verschlüsselte Passwortdatei]] (<code>.passfile</code>) verwenden, damit eine andere Person eine Verbindung mit dem "Platform Assistant" herstellen kann, ohne das für den "Platform Assistant" konfigurierte Passwort zu kennen.

==Konfigurieren des "Platform Assistant" mit Befehlszeilenoptionen==

===Konfigurieren der Port-Nummer in der Befehlszeile===

Verwenden Sie bei der Ausführung des "Platform Assistant" von der Befehlszeile aus <code>-port</code>, um den Port anzugeben, an dem der "Platform Assistant" eingehende Verbindungen empfängt:

*'''Windows:'''
*:<code>> paserver -port=''nnnnn''</code>
*'''OS X:'''
*:<code>$ ./paserver -port=''nnnnn''</code>

Die Port-Nummer muss eine Zahl zwischen 1 und 65.535 sein.

===Konfigurieren des Passworts in der Befehlszeile===

Der "Platform Assistant" kann mit einem Passwort konfiguriert werden. Wenn Sie ein Passwort angeben, muss beim Versuch eines Clients (z. B. {{Variables|Product}}) eine Verbindung mit dem "Platform Assistant" herzustellen, der Client das Passwort bereitstellen.

Bei der Ausführung des "Platform Assistant" werden Sie zur Eingabe eines Passworts (oder keines Passworts) aufgefordert. Sie können bei der Ausführung des "Platform Assistant" in der Befehlszeile mit der Befehlszeilenoption <code>-password</code> alternativ ein Passwort (oder kein Passwort) festlegen:

*'''Windows:'''
*:<code>> paserver -password=''B2C3d4!''</code>
*'''OS X:'''
*:<code>$ ./paserver -password=''B2C3d4!''</code>

===Konfigurieren des Scratch-Verzeichnisses in der Befehlszeile===

Der '''Platform Assistant''' speichert Projektausgabedateien in einem "scratch"-Verzeichnis, das Sie festlegen und konfigurieren können.

====Festlegen des Speicherorts des Scratch-Verzeichnisses in der Befehlszeile====

Bei der Ausführung des "Platform Assistant" von der Befehlszeile aus, können Sie mit der Option <code>-scratchdir</code> einen benutzerdefinierten Speicherort für das [[PAServer: Die Platform Assistant Server-Anwendung#Das Scratch-Verzeichnis|"scratch"-Verzeichnis]] angeben:

*'''Windows:'''
*:<code>> paserver -scratchdir=''NewScratchDirectory''</code>
*'''OS X:'''
*:<code>$ ./paserver -scratchdir=''NewScratchDirectory''</code>

Der Pfad zu dem neuen "scratch"-Verzeichnis ist standardmäßig relativ zum Installationsverzeichnis des "Platform Assistant". Unter OS X können Sie beim Start des "Platform Assistant" ein "scratch"-Verzeichnis relativ zur Ihrem Benutzerverzeichnis durch Angabe einer Tilde und eines Schrägstrichs (<code>~/</code>) vor dem Verzeichnispfad festlegen:

$ ./paserver -scratchdir=~/MyTestDir

Dieser Befehl konfiguriert das Verzeichnis '''/Users/''MyUsername''/MyTestDir''' als "scratch"-Verzeichnis auf dem Mac.

Sie können auch einen absoluten Pfad angeben, zum Beispiel:

*'''Windows:'''
*:<code>> paserver -scratchdir=''C:\PAServer\scratch-dir''</code>
*'''OS X:'''
*:<code>$ ./paserver -scratchdir=''C:\PAServer\scratch-dir''</code>

====Exceptions des Scratch-Verzeichnisses====

Wenn Sie einen Pfad als "scratch"-Verzeichnis angeben, der nicht vorhandenen ist, aber erstellt werden kann (z. B. der Pfad enthält Verzeichnisse, die nicht vorhanden sind), erstellt PAServer automatisch die fehlenden Verzeichnisse. Wenn das nicht möglich ist, wird der Fehler [[E0009 Datei "Dateipfad" kann nicht erstellt werden. "Fehlertext"#Das System kann die angegebene Datei nicht finden|Das System kann die angegebene Datei nicht finden]] ausgelöst.

Die folgenden Exceptions können im Zusammenhang mit {{Code|scratch-dir}}-Einstellungen auftreten:

* [[E0009 Datei "Dateipfad" kann nicht erstellt werden. "Fehlertext"#Zugriff verweigert|Zugriff verweigert.]]
* [[E0009 Datei "Dateipfad" kann nicht erstellt werden. "Fehlertext"#Der Prozess kann nicht auf die Datei zugreifen, weil sie von einem anderen Prozess verwendet wird|Der Prozess kann nicht auf die Datei zugreifen, weil sie von einem anderen Prozess verwendet wird.]]
* [[E0009 Datei "Dateipfad" kann nicht erstellt werden. "Fehlertext"#Das System kann die angegebene Datei nicht finden|Das System kann die angegebene Datei nicht finden.]]

====Zulassen von Dateioperationen außerhalb des "scratch-"Verzeichnisses in der Befehlszeile====

:'''Achtung:''' Die Verwendung des Modus <code>-unrestricted</code> mit dem "Platform Assistant" wird nicht empfohlen.

Standardmäßig arbeitet der "Platform Assistant" im '''eingeschränkten''' Modus. Das bedeutet, der "Platform Assistant" führt Dateioperationen (Hinzufügen und Entfernen) für Ihr [[Verbindungsprofil-Manager|Verbindungsprofil]] nur innerhalb des [[PAServer: Die Platform Assistant Server-Anwendung#Das Scratch-Verzeichnis|"scratch"-Verzeichnisses]] aus. Im Standardmodus (eingeschränkt) können {{Variables|Product}} und [[Paclient.exe: Die Client-Anwendung von Platform Assistant|paclient.exe]] Dateien nur innerhalb des "scratch"-Verzeichnisses hinzufügen oder löschen.

Wenn Sie aber beim Starten des "Platform Assistant" die Befehlszeilenoption <code>-unrestricted</code> angeben, lässt der "Platform Assistant" Dateioperationen außerhalb des "scratch"-Verzeichnisses zu.

==Konfigurieren des "Platform Assistant" mit einer Konfigurationsdatei==

Mit der Befehlszeilenoption <code>-config</code> können Sie eine benutzerdefinierte Konfigurationsdatei für den "Platform Assistant" angeben.

Die Standardkonfigurationsdatei des "Platform Assistant", <code>paserver.config</code>, befindet sich im Installationsverzeichnis des "Platform Assistant". Diese Konfigurationsdatei kann alle vom "Platform Assistant" akzeptierten Parameter, einschließlich der [[#Konfigurieren des Platform Assistant mit Befehlszeilenoptionen|oben beschriebenen]] enthalten. Rufen Sie die [[PAServer: Die Platform Assistant Server-Anwendung#Befehlszeilenhilfe des "Platform Assistant"|Befehlszeilenhilfe des Platform Assistant]] auf, um eine vollständige Liste aller verfügbaren Optionen anzuzeigen.

Standardmäßig enthält die Datei <code>paserver.config</code> nur die beiden folgenden Befehle, aber Sie können diese Befehle bearbeiten und andere "Platform Assistant"-Befehle hinzufügen (wie z. B. <code>passfile</code>, <code>password</code> und <code>unrestricted</code>):

port=64211
scratchdir=

Diese beiden Befehle definieren:

* Den Kommunikations-'''Port''' (der Standardwert lautet <code>64211</code>).
* Das '''scratch-Verzeichnis''' (wird für die "Platform Assistant"-Dateioperationen verwendet).
** Der Name des Standard-"scratch"-Verzeichnisses lautet <code>scratch-dir</code>. Es befindet sich im Installationsverzeichnis des "Platform Assistant". Für jedes Verbindungsprofil wird ein separater Ordner angelegt. Beispielsweise ist das Standard-"scratch"-Verzeichnis für das '''MyOSX'''-Verbindungsprofil: <code>Benutzername-MyOSX</code>.
** Sie können ein anderes <code>scratch-dir</code>, entweder als absoluten oder relativen Pfad (relativ zum "Platform Assistant"-Installationsverzeichnis) angeben. Beispiele finden Sie unter [[#Festlegen des Speicherorts des Scratch-Verzeichnisses in der Befehlszeile|Festlegen des Speicherorts des Scratch-Verzeichnisses in der Befehlszeile]].

==Erzeugen und Verwenden einer .passfile-Datei==

Anstatt der Bereitstellung eines Passworts für die Verbindung zu dem ausgeführten "Platform Assistant" kann der "Platform Assistant" eine verschlüsselte Passwortdatei (<code>.passfile</code>) generieren, die Sie an Ihre "Platform Assistant"-Clients (z. B. Instanzen von {{Variables|Product}}) für die Verbindung zum "Platform Assistant" weitergeben können. Wenn Sie paserver mit der Option <code>.passfile</code> starten, benötigt paserver ein Verbindungsprofil, in dem das in der <code>.passfile</code>-Datei verschlüsselte Passwort enthalten ist.

===Erzeugen einer verschlüsselten Passwortdatei===

Führen Sie den "Platform Assistant" unter [[Ausführen des Platform Assistant auf dem Mac|OS X]] oder [[Ausführen des Platform Assistant unter Windows|Windows]] aus, und geben Sie bei der Eingabeaufforderung den Befehl <code>g</code> ein, um eine verschlüsselte Passwortdatei zu erzeugen:

:<code>> g</code>

Der "Platform Assistant" generiert die verschlüsselte Passwortdatei und zeigt den Pfad zu dieser Datei an.

Wenn Sie die verschlüsselte Passwortdatei in einer ausgeführten Instanz des "Platform Assistant" generieren, startet diese Instanz automatisch mit der verschlüsselten Passwortdatei. Beim nächsten Start des "Platform Assistant" müssen Sie aber [[#Starten des "Platform Assistant" mit einer verschlüsselten Passwortdatei|die verschlüsselte Passwortdatei in der Befehlszeile angeben]].

===Starten des "Platform Assistant" mit einer verschlüsselten Passwortdatei===

Um den "Platform Assistant" mit einer bestimmten verschlüsselten Passwortdatei zu starten, müssen Sie den "Platform Assistant" in der Befehlszeile mit der Option <code>-passfile</code> und dem Pfad zu der verschlüsselten Passwortdatei als Wert starten:

*'''Windows:'''
*:<code>> paserver -passfile=''Dateiname''</code>
*'''OS X:'''
*:<code>$ ./paserver -passfile=''Dateiname''</code>

Um diese Instanz des "Platform Assistant" von {{Variables|Product}} aus zu verbinden, müssen Sie [[#Festlegen einer verschlüsselten Passwortdatei in einem Verbindungsprofil|die verschlüsselte Passwortdatei bei der Konfiguration des entsprechenden Verbindungsprofils angeben]].

===Festlegen einer verschlüsselten Passwortdatei in einem Verbindungsprofil===

Um eine Verbindung zu einem ausgeführten "Platform Assistant", der eine verschlüsselte Passwortdatei verwendet, herzustellen, müssen Sie Ihr Verbindungsprofil für die Verwendung der verschlüsselten Passwortdatei konfigurieren:

# Kopieren Sie die <code>.passfile</code>-Datei vom Mac auf Ihren PC.
# Wählen Sie in {{Variables|Product}} '''Tools > Optionen > Umgebungsoptionen > [[Verbindungsprofil-Manager|Verbindungsprofil-Manager]]''' aus.
# Wählen Sie im Dialogfeld [[Verbindungsprofil-Manager|Verbindungsprofil-Manager]] das Verbindungsprofil aus, das Sie mit der verschlüsselten Passwortdatei verwenden möchten.
# Klicken Sie im Feld '''Passwort''' auf die Ellipse '''[...]'''.
# Navigieren Sie zu der vom Mac kopierten <code>.passfile</code>-Datei, und klicken Sie auf '''OK'''.
# Klicken Sie im Dialogfeld [[Verbindungsprofil-Manager|Verbindungsprofil-Manager]] auf '''OK''', um die Änderungen zu speichern.

Jetzt können Sie mit dem bearbeiteten Verbindungsprofil eine Verbindung mit dem "Platform Assistant" herstellen.

:'''Hinweis:''' Die obigen Schritte beschreiben die Bearbeitung eines vorhandenen Profils. Sie können auch [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|ein neues Profil erstellen]] und dessen '''Passwort'''-Feld wie oben beschrieben konfigurieren.

==Siehe auch==

* [[Ausführen des Platform Assistant auf dem Mac|Ausführen des Platform Assistant auf dem Mac]]
* [[Ausführen des Platform Assistant unter Windows|Ausführen des Platform Assistant unter Windows]]

* [[Platform Assistant-Serverfehler - Index|Platform Assistant-Serverfehler - Index]]

{{DEFAULTSORT:Festlegen von Optionen fur den Platform Assistant}}
[[Category:Geräteübergreifend]]
[[Category:XE4]]

[[en:Setting Options for the Platform Assistant]]
[[fr:Définition des options de Platform Assistant]]
[[ja:プラットフォームアシスタントのオプションの設定]]

Verbindungsprofil auswählen

2016-06-23T08:17:42Z

Esabatell: Updated. LOC-22885

{{Parent|Tools-Optionen (Dialogfeld)}}

'''Tools > Optionen > Umgebungsoptionen > [[SDK-Manager|SDK-Manager]]''' | wählen Sie ein SDK für OS X, iOS-Gerät - 32 Bit, iOS-Gerät - 64 Bit oder den iOS-Simulator aus | '''Lokalen Dateizwischenspeicher aktualisieren''' 
'''Start > [[Mit Prozess verbinden|Mit Prozess verbinden]]''' | '''Externer Rechner''' | '''[...]''' 
'''Start > Prozess verbinden > [[Prozess laden: Extern|Extern]]''' | '''Externer Host''' | '''[...]'''

Dieses Dialogfeld enthält ein Kombinationsfeld mit den Namen aller vorhandenen [[Verbindungsprofil-Manager|Verbindungsprofile]] für eine bestimmte Plattform. Der Name der Zielplattform wird im Titel des Dialogfeldes angezeigt, z.B. '''Verbindungsprofil für die Plattform "32-Bit-Windows" auswählen'''.

Sie können in dem Kombinationsfeld entweder ein vorhandenes Verbindungsprofil auswählen oder '''Neue hinzufügen''' wählen, um den Experten [[Verbindungsprofil erstellen|Verbindungsprofil erstellen]] zu öffnen und ein neues Verbindungsprofil zu erstellen. Klicken Sie auf '''OK''', um das Dialogfeld zu schließen und das ausgewählte Profil zu verwenden.

{{Variables|Product}} zeigt das Dialogfeld '''Verbindungsprofil auswählen''' auch an, wenn Sie versuchen, eine Aktion durchzuführen, für die ein Verbindungsprofil erforderlich ist, wie z.B. Ausführen einer OS X-Anwendung, und der aktuellen Zielplattform kein Verbindungsprofil zugewiesen ist.

==Siehe auch==

* [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC]]
* [[Verbindungsprofil-Manager|Verbindungsprofil-Manager]] (Seite in Tools-Optionen)

{{DEFAULTSORT:Verbindungsprofil auswahlen}}
[[Category:XE4]]
[[Category:AMMigrate]]

[[en:Select Connection Profile]]
[[fr:Sélectionner un profil de connexion]]
[[ja:［接続プロファイルの選択］]]

Sichern von Indy-Netzwerkverbindungen

2016-06-23T08:17:07Z

Esabatell: Updated. LOC-22885

{{Parent|Sichern der Netzwerkverbindungen von geräteübergreifenden Apps}}

In diesem Thema wird gezeigt, wie Sie Ihren [[Indy|Indy]]-Netzwerkverbindungen die Unterstützung für TLS/SSL-Sicherheit hinzufügen.

==Voraussetzungen==

Laden Sie das neueste [[OpenSSL|OpenSSL]]-Archiv für Ihre Entwicklungsplattform von [http://indy.fulgan.com/SSL/ http://indy.fulgan.com/SSL/] herunter, um TLS/SSL mit Indy auf Ihrem Entwicklungscomputer zu verwenden:

* 32-Bit-Windows: {{Path|openssl-{{Placeholder|version}}-i386-win32.zip}}.
* 64-Bit-Windows: {{Path|openssl-{{Placeholder|version}}-x64_86-win64.zip}}.

Extrahieren Sie den Inhalt des heruntergeladenen Archivs, und suchen Sie die folgenden Bibliotheksdateien:

* {{Path|libeay32.dll}}
* {{Path|ssleay32.dll}}

Kopieren Sie diese Dateien in den Ordner, in dem {{Product}} die ausführbare Datei Ihrer Anwendung erstellt. Zum Beispiel in {{Path|{{Placeholder|Projektordner}}/Win32/Debug}} für 32-Bit-Windows.

Bevor Sie Ihre Anwendung auf einem Remote-Computer ausführen oder Ihre Anwendung an andere Benutzer verteilen können, müssen Sie für '''Windows''' die Bereitstellungskonfiguration Ihrer Anwendung ändern, um diese Bibliotheksdateien in den Pfad der ausführbaren Datei Ihrer Anwendung aufzunehmen:

# Wählen Sie {{Menu|Projekt > Bereitstellung}}.
# Öffnen Sie das Kombinationsfeld oben im '''[[Bereitstellungs-Manager|Bereitstellungs-Manager]]''', und wählen Sie unter '''Alle Konfigurationen''' die Zielplattform (32-Bit-Windows oder 64-Bit-Windows) aus.
# Klicken Sie auf [[File:DMgrAddFiles.png|Dateien hinzufügen]].
# Wählen Sie die erforderlichen, zuvor heruntergeladenen Bibliotheksdateien aus, und klicken Sie auf '''OK'''.

Bei '''OS X''' und '''Android''' muss Ihre Anwendung keine Voraussetzungen für die TLS/SSL-Unterstützung erfüllen. Die erforderliche [[OpenSSL|OpenSSL]]-Bibliothek ist standardmäßig in diesen Betriebssystemen verfügbar.

Für '''iOS''' finden Sie unter [[Erstellen von iOS-Apps#OpenSSL-Unterstützung|Erstellen von iOS-Apps, OpenSSL-Unterstützung]] Informationen zum Konfigurieren Ihrer Anwendung für die Unterstützung der TLS/SSL-Verschlüsselung.

Für '''weitere Plattformen''' siehe [[OpenSSL|OpenSSL-Bibliotheken]].

==Implementieren der TLS/SSL-Unterstützung in Ihrem Indy-Client==

Von [http://www.indyproject.org/docsite/html/frames.html?frmname=topic&frmfile=TIdTCPConnection.html TIdTCPConnection] abgeleitete Klassen, wie [http://www.indyproject.org/docsite/html/frames.html?frmname=topic&frmfile=TIdHTTP.html TIdHTTP], stellen die Eigenschaft [http://www.indyproject.org/docsite/html/frames.html?frmname=topic&frmfile=TIdTCPConnection_IOHandler.html IOHandler] bereit.

Zur Sicherung einer Indy-Netzwerkverbindung ziehen Sie eine [http://www.indyproject.org/docsite/html/frames.html?frmname=topic&frmfile=TIdSSLIOHandlerSocketOpenSSL.html TIdSSLIOHandlerSocketOpenSSL]-Komponente in den '''[[Formular-Designer|Formular-Designer]]''' und doppelklicken im '''[[Objektinspektor|Objektinspektor]]''' auf die Eigenschaft {{Code|IOHandler}} der Indy-Client-Komponente, damit Ihre neue {{Code|TIdSSLIOHandlerSocketOpenSSL}}-Komponente als Eingabe-/Ausgabe-Behandlungsroutine ausgewählt wird.

Alternativ können Sie die Netzwerkverbindungen des Indy-Clients auch über den Code sichern:
<l s="delphi" />

'''{{Delphi}}:'''
<source lang="delphi">
Client.IOHandler := TIdSSLIOHandlerSocketOpenSSL.Create;
</source><l e="delphi" /><l s="cpp" />

'''C++:'''
<source lang="cpp">
Client->IOHandler = new TIdSSLIOHandlerSocketOpenSSL();
</source><l e="cpp" />

Sie können jetzt mit Ihrem Client sichere Anforderungen an einen Server, der die TLS/SSL-Verschlüsselung unterstützt, über das HTTPS-Protokoll senden. Um beispielsweise "<nowiki>http://www.example.com</nowiki>" mit der TLS/SSL-Verschlüsselung abzurufen, erhalten Sie mit Ihrem Client "http'''s'''://www.example.com".

==Siehe auch==

* [[Indy|Indy]]
* [http://www.indyproject.org/docsite/html/ Dokumentation der Indy-Referenz]

[[Category:XE7]]
[[Category:AMMigrate]]

[[en:Securing Indy Network Connections]]
[[fr:Sécurisation des connexions réseau Indy]]
[[ja:Indy ネットワーク接続のセキュリティ保護]]

SDK-Manager

2016-06-23T08:16:58Z

Esabatell: Updated. LOC-22885

{{Parent|Umgebungsoptionen}}

{{Menu|Tools > Optionen > Umgebungsoptionen > SDK-Manager}} 
'''[[Projektverwaltung|Projektverwaltung]]''' | mit der rechten Maustaste auf eine Plattform in '''[[Projektverwaltung#Kontextmenü für Zielplattformen|Zielplattformen]]''' klicken | '''SDK bearbeiten'''

Zeigt die vorhandenen SDKs an und ermöglicht das Hinzufügen und Verwalten von SDKs für [[Hinzufügen von SDKs für OS X oder iOSOS X, iOS]] und [[Hinzufügen von Android-SDKs|Android]].

==Funktionen von SDKs==

Ein SDK (Software Development Kit) stellt die Software bereit, die zum Erzeugen von Anwendungen für eine Zielplattform benötigt wird. Die SDK-Informationen, anhand derer '''{{Variables|Product}}''' die erforderliche Software auf Ihrem System sucht, werden auf der Seite '''SDK-Manager''' bereitgestellt.

OS X- und iOS-SDKs enthalten:

* Eine Liste mit absoluten Pfaden und Ordnern auf dem Mac, die zum Erzeugen von Anwendungen für die SDK-Zielplattform erforderlich sind.
* Eine Kopie derjenigen Dateien, die von der Zielplattform oder der Zwischenplattform mithilfe eines [[Verbindungsprofil-Manager|Verbindungsprofils]] übernommen werden können.

Android-SDKs enthalten die Pfade zu der erforderlichen Software auf Ihrem System.

Auf der Seite '''SDK-Manager''' wird für jede Zielplattform, der ein SDK zugeordnet ist, ein SDK als Standard-SDK in Fettschrift angezeigt. Windows-Plattformen haben kein Standard-SDK.

==Plattformen und Anwendungstypen, die ein SDK erfordern==

SDKs sind für die folgenden Plattformen und Anwendungstypen '''erforderlich''':

* Geräteübergreifende C++-Anwendungen für die '''OS X'''-Plattform.
* Geräteübergreifende Anwendungen für die Plattform '''iOS-Gerät - 32 Bit'''.
* Geräteübergreifende Anwendungen für die Plattform '''iOS-Gerät - 64 Bit'''.
* Geräteübergreifende Anwendungen für die '''Android'''-Plattform.
*:'''Hinweis:''' Wenn Ihr Android SDK und NDK vom Installationsprogramm von {{Variables|Product}} installiert wurden, dann sind dem [[SDK-Manager|SDK-Manager]] die Installationsverzeichnisse bekannt. In diesem Fall sollten die SDK-Felder automatisch ausgefüllt worden sein, und Sie müssen kein SDK für Ihre Android-Apps hinzufügen.

==Dateinamen und Dateierweiterung für SDKs==

'''SDK-Namen''' unterliegen – außer dass sie gültige Dateinamen gemäß [[lib_de:System.IOUtils.TPath.HasValidFileNameChars|System.IOUtils.TPath.HasValidFileNameChars]] sein müssen – kaum Beschränkungen. Doppelte SDK-Namen führen zu einem Fehler (beim Hinzufügen und Importieren).

Die '''Erweiterung von SDK-Dateien''' lautet <code>.sdk</code>. Sie wird automatisch beim Speichern des SDK als Datei hinzugefügt.

Beispiele für SDK-Namen:

* MyFirstOSXSdk
* Gr8daZ!

Jedes definierte SDK wird als <code>.sdk</code>-Datei in Ihrem Ordner '''Anwendungsdaten''' (der von [[lib_de:DesignIntf.IDesigner170.GetAppDataDirectory|DesignIntf.IDesigner170.GetAppDataDirectory]] zurückgegeben wird) gespeichert, wie z. B. unter Windows 7 in folgendem Ordner:

{{Path|{{AppDataPath}}}}

Die Datei enthält die [[#Funktionen von SDKs|Informationen über das SDK]], wie die Pfade zu der Software, die zum Erzeugen von Anwendungen für die SDK-Zielplattform benötigt wird.

Die eigentlichen SDK-Dateien (der '''lokale SDK-Dateizwischenspeicher''') werden standardmäßig im Verzeichnis {{Path|{{UserDocumentsPath}}\SDKs}} gespeichert.

Zum Ändern des Speicherorts des lokalen SDK-Dateizwischenspeichers eines SDKs, befolgen Sie die nachstehenden Anweisungen:

* Für Android legen Sie im '''SDK-Manager''' die Pfade fest, damit diese zum neuen Speicherort führen.
* Für OS X oder iOS lesen Sie '''[[Ändern des lokalen Stammverzeichnisses von SDKs für OS X, iOS-Geräte oder den iOS-Simulator|Ändern des lokalen Stammverzeichnisses von SDKs für OS X, iOS-Geräte oder den iOS-Simulator]]'''.

==Bereich "SDK"==

{|
|-
! Element
! Beschreibung
|- valign="top"
|
SDK-Versionen
|
Listet die definierten SDKs zusammen mit den zugewiesenen Plattformen auf. Das Standard-SDK für eine Plattform wird in '''Fettschrift''' angezeigt.
* Führen Sie einen der folgenden Schritte aus, um das Standard-SDK für eine Plattform festzulegen:
** Klicken Sie mit der rechten Maustaste auf den SDK-Eintrag, und wählen Sie '''Als Standard'''.
** Doppelklicken Sie auf den SDK-Eintrag.
* Um ein SDK zu bearbeiten, wählen Sie es in der Liste '''SDK-Versionen''' aus, nehmen Änderungen an den '''SDK-Eigenschaften''' vor und klicken dann auf '''OK''' (wenn Sie nicht auf '''OK''' klicken, werden die Änderungen nicht gespeichert).

Durch Klicken auf ein SDK werden die Schaltflächen zur Verwaltung von SDKs ('''Löschen''' und '''Exportieren''') aktiviert.
|- valign="top"
|
SDK-Eigenschaften
|
Zeigt die aktuellen Einstellungen des ausgewählten SDK an.

Der Inhalt dieses Frames ist von der SDK-Plattform abhängig: [[#Eigenschaften für OS X- und iOS-SDKs|'''OS X''', '''iOS''']] oder '''[[#Eigenschaften von Android-SDK, -NDK und Java|Android]]'''.
|}

===Eigenschaften für OS X- und iOS-SDKs===

Diese Felder werden im Frame '''SDK-Eigenschaften''' angezeigt, wenn Sie ein '''OS X'''- oder '''iOS'''-SDK auswählen.

{|
|- valign="top"
|
Lokales Stammverzeichnis
|
Zeigt das Verzeichnis auf dem lokalen Computer an, in dem die Dateien von dem Remote-Computer zwischengespeichert werden. Der Vorgabewert lautet:

$(BDSPLATFORMSDKSDIR)\<sdk-Name>
Der Wert für die Variable $(BDSPLATFORMSDKSDIR) wird auf der Seite '''Tools > Optionen > Umgebungsoptionen > [[Umgebungsvariablen|Umgebungsvariablen]]''' festgelegt.

In C++ wird dieses Verzeichnis mit der Option <code>--sysroot</code> an den Compiler übergeben. Den Remote-Pfadangaben wird implizit das lokale Stammverzeichnis vorangestellt.

Sie können die aktuellen Werte durch Klicken auf [[File:SavePaths.png]] '''Pfade als Vorgabe für die ausgewählte Plattform speichern''' im Bereich '''Remote-Pfade''' als neue Standardwerte festlegen.
|- valign="top"
|
Remote-Pfade
|
Zeigt die Liste der Pfade auf dem Remote-Computer an, die auf den lokalen Computer übernommen werden.

Ein Remote-Pfad besteht aus:
* '''Verzeichnis'''. Gibt das Verzeichnis auf der Zielplattform oder der Zwischenplattform an.
* '''Dateifilter'''. Repräsentiert entweder den Dateinamen (für eine einzelne Datei) oder den Platzhalter * (Sternchen), was allen Dateien in dem angegebenen Verzeichnis entspricht. Beispiel: OpenGL.
* '''Unterverzeichnisse'''. Gibt an, ob Unterverzeichnisse einbezogen werden sollen.

Es gibt vier Kategorien von Remote-Pfaden. Wie die Pfade/Einträge an den C++-Compiler und -Linker übergeben werden, wird durch die jeweilige Kategorie festgelegt:
* '''Include-Pfade''' werden an den Compiler als Teil des <code>--sysinc</code>-Pfads (der Include-Dateisuchpfad des Systems mit dem vorangestellten Stammverzeichnis) übergeben.
* '''Bibliothekspfade''' werden an den Linker als Teil des <code>--syslib</code>-Pfads (der Bibliothekssuchpfad des Systems mit dem vorangestellten Stammverzeichnis) übergeben.
* '''Frameworks''' werden an den Compiler (mit der Option <code>--framework</code>) und an den Linker (mit der Option <code>--Ff</code>) übergeben.
* '''Andere Pfade''' werden nicht standardmäßig an den Compiler/Linker übergeben, aber auf den lokalen Computer übernommen.

Alle angegebenen Elemente werden auf den lokalen Computer übernommen. Siehe [[Paclient.exe: Die Client-Anwendung von Platform Assistant|PAClient]].

Alle Pfade müssen das für den Ziel-Host-Computer geeignete Format aufweisen. Verwenden Sie beispielsweise Schrägstriche (/) als Trennzeichen für Mac-Hosts. Bestimmte Zeichen, wie z. B. die Tilde (~), werden für Mac erkannt.

Folgende Schaltflächen sind im Feld '''Remote-Pfade''' vorhanden:
{|
|-
! Schaltfläche
! Beschreibung
|- valign="top"
|
[[File:New.png]] Neuen Pfadeintrag hinzufügen
|
Zeigt das Dialogfeld '''[[Remote-Pfadeintrag hinzufügen oder Remote-Pfadeintrag bearbeiten|Remote-Pfadeintrag hinzufügen]]''' an. Sie können ein neues SDK auch durch Drücken der Taste '''EINFG''' in der Liste '''Remote-Pfade''' einfügen.
|- valign="top"
|
[[File:EditPathItem.png]] Ausgewählten Pfadeintrag bearbeiten
|
Zeigt das Dialogfeld '''[[Remote-Pfadeintrag hinzufügen oder Remote-Pfadeintrag bearbeiten|Remote-Pfadeintrag bearbeiten]]''' an.
|- valign="top"
|
[[File:DeletePathItem.png]] Ausgewählten Pfadeintrag löschen
|
Zeigt ein Bestätigungsdialogfeld an und löscht nach einer Bestätigung den ausgewählten Pfadeintrag. Sie können einen Pfad auch durch Drücken der Taste '''ENTF''' bei ausgewähltem Pfadeintrag in der Liste '''Remote-Pfade''' löschen.
|- valign="top"
|
[[File:ResetPaths.png]] Pfade auf Vorgabe für die ausgewählte Plattform zurücksetzen
|
Zeigt ein Bestätigungsdialogfeld an und überschreibt nach der Bestätigung alle Pfadeinträge mit den Standardwerten des SDK für die ausgewählte Plattform. Bezieht das '''Lokale Stammverzeichnis''' nur mit ein, wenn es leer ist.

Die wiederhergestellten Werte werden folgendermaßen ermittelt:
* Wenn Sie die Vorgaben nicht zurückgesetzt haben, sind die Werte die Standardwerte von {{Variables|Product}}.
* Nach dem Zurücksetzen auf die Standardwerte werden die neuen Werte zu den Standardwerten und werden in der Datei {{Path|<Plattform>.defaultsdkpaths}} in Ihrem {{Path|{{AppDataPath}}}}-Verzeichnis gespeichert. Daher werden durch Klicken auf [[File:ResetPaths.png]] die neuen Standardwerte wiederhergestellt.
* Löschen Sie zum Wiederherstellen der ursprünglichen Standardwerte die Datei {{Path|.defaultsdkpaths}} für die Zielplattform. Die ursprünglichen Standardpfade erscheinen jetzt in Ihren neuen SDKs.
|- valign="top"
|
[[File:SavePaths.png]] Pfade als Standard für die ausgewählte Plattform speichern
|
Überschreibt die Standardpfadangaben mit den angegebenen SDK-Werten für Pfadeinträge für die ausgewählte Plattform. Nach dem Speichern der Pfade als Standardwerte werden die hier eingegebenen neuen Werte wiederhergestellt, wenn Sie auf [[File:ResetPaths.png]] ('''Pfade auf Vorgabe zurücksetzen''') klicken.

Beim Speichern von Standardpfaden wird für die Vorgaben eine Datei erstellt. Der Dateiname ist der Plattformname mit der Erweiterung <code>.defaultsdkpaths</code>.

Zum Beispiel:
{|
|-
|
Macintosh OS X
|
<code>OSX32.defaultsdkpaths</code>
|-
|
Win32
|
<code>Win32.defaultsdkpaths</code>
|-
|
Win64
|
<code>Win64.defaultsdkpaths</code>
|}

Um Ihre Einstellungen zu verwerfen und die ursprünglichen Standardwerte wiederherzustellen, löschen Sie zuerst die Datei <code>.defaultsdkpaths</code> aus dem Verzeichnis, zu dem <code>%APPDATA%</code> erweitert wird ({{Path|{{AppDataPath}}}}) und klicken dann auf [[File:ResetPaths.png]] ('''Pfade auf Vorgabe zurücksetzen''').

|- valign="top"
|
[[File:UpArrow.png]] Schaltfläche "Nach oben"
|
Verschiebt den ausgewählten Pfadeintrag in der Pfadgruppe nach oben. Sie können den Eintrag auch durch Drücken der Tastenkombination <code>STRG+AUF</code> in der Liste '''Remote-Pfade''' nach oben verschieben.
|- valign="top"
|
[[File:DownArrow.png]] Schaltfläche "Nach unten"
|
Verschiebt den ausgewählten Pfadeintrag in der Pfadgruppe nach unten. Sie können den Eintrag auch durch Drücken der Tastenkombination <code>STRG+AB</code> in der Liste '''Remote-Pfade''' nach unten verschieben.
|}
|- valign="top"
|
Lokalen Dateizwischenspeicher aktualisieren
|
[[Verbindungsprofil auswählen|Fordert Sie zur Angabe eines Verbindungsprofils]] auf und übernimmt alle in dem aktuellen Verbindungsprofil angegebenen Dateien vom lokalen (Entwicklungs-)Computer auf den Remote-Zielcomputer. Nur Dateien mit unterschiedlichen Größen oder Zeitstempeln als diejenigen, die sich bereits im lokalen SDK-Dateizwischenspeicher befinden, werden übernommen. Ein Fortschrittsdialogfeld wird während der Übernahme angezeigt, in dem Sie den Vorgang abbrechen können. Zudem wird vor dem Überschreiben von lokalen Dateien eine Bestätigungsmeldung angezeigt.

Sie sollten auf diese Schaltfläche klicken, nachdem Sie Änderungen an den Pfaden im Dialogfeld '''SDK-Manager''' vorgenommen haben.
|- valign="top"
|
Hinzufügen
|
Öffnet das Dialogfeld '''[[Neues SDK hinzufügen|Neues SDK hinzufügen]]''', in dem Sie ein SDK als Verbindungsprofil für die Zielplattform auswählen können. Durch Drücken der Taste <code>EINFG</code> in der Liste '''SDKs''' wird dieses Dialogfeld ebenfalls geöffnet.
|- valign="top"
|
Löschen
|
Zeigt ein Bestätigungsdialogfeld an und löscht nach einer Bestätigung das aktuell ausgewählte SDK. Sie können ein SDK auch durch Drücken der Taste <code>ENTF</code> löschen, wenn ein SDK in der Liste '''SDKs''' den Fokus hat.
|- valign="top"
|
Exportieren
|
Zeigt ein Dialogfeld zur Eingabe eines Dateinamens an und speichert die SDK-Einstellungen an dieser Position (der Standarddateiname lautet "<sdk-Name>.sdk").
|- valign="top"
|
Importieren
|
Zeigt ein Dialogfeld zur Eingabe eines SDK-Dateinamens an und importiert die enthaltenen SDK-Einstellungen in die IDE.
|}

===Eigenschaften von Android-SDK, -NDK und Java===

Diese Felder werden im Fenster '''Eigenschaften''' angezeigt, wenn Sie ein '''Android'''-SDK auswählen. Das Fenster "Eigenschaften" enthält drei Registerkarten: '''SDK''', '''NDK''' und '''Java'''.

====Registerkarte "SDK"====

{| border="1" frame="hsides" rules="rows"
|-
! '''Element'''
! '''Beschreibung'''
|- valign="top"
|
SDK-Basispfad
|
Der Speicherort des Ordners für das Android-SDK.

Damit '''{{Variables|Product}}''' Ihren Android-SDK-Ordner als gültigen Ordner erkennen kann, muss dieser Ordner einen Unterordner namens <code>tools</code> mit der Datei <code>source.properties</code> enthalten. In der Datei <code>source.properties</code> ist die Version (<code>Pkg.Revision</code>) Ihres Android-SDK angegeben.
|- valign="top"
|
ZipAlign-Speicherort
|
Der Speicherort des SDK-Tools "ZipAlign.exe".

Zum Beispiel:
* {{Path|{{Placeholder|Android SDK base path}}\tools\ZipAlign.exe}}
* {{Path|{{Placeholder|Android SDK base path}}\build-tools\{{Placeholder|version}}\zipalign.exe}}
|- valign="top"
|
Android-Speicherort
|
Der Speicherort des SDK-Tools "Android.bat".
|- valign="top"
|
Adb-Speicherort
|
Der Speicherort des SDK-Plattformtools "Adb.exe".
|- valign="top"
|
Aapt-Speicherort
|
Der Speicherort des SDK-Erzeugungstools "aapt.exe".
|- valign="top"
|
SDK-API-Level-Speicherort
|
Der Speicherort des zu verwendenden SDK-API-Level-Ordners. Jede Version ist geeignet (z. B. <code><SDK-Ordner>\platforms\android-17</code>).

Damit '''{{Variables|Product}}''' Ihren SDK-API-Level-Ordner als gültigen Ordner erkennen kann, muss dieser Ordner die Datei <code>android.jar</code> enthalten.
|}

====Registerkarte "NDK"====

{| border="1" frame="hsides" rules="rows"
|-
! '''Element'''
! '''Beschreibung'''
|- valign="top"
|
NDK-Basispfad
|
Der Speicherort des Ordners für das Android-NDK.
|- valign="top"
|
Speicherort von arm-linux-androideabi-ld.exe
|
Der Speicherort des Linkers arm-linux-androideabi-ld.exe (beispielsweise <code><NDK-Ordner>\toolchains\arm-linux-androideabi-4.6\prebuilt\windows\bin</code>).
|- valign="top"
|
Speicherort von arm-linux-androideabi-strip.exe
|
Der Speicherort des Linkers arm-linux-androideabi-ld.exe (beispielsweise <code><NDK-Ordner>\toolchains\arm-linux-androideabi-4.6\prebuilt\windows\bin</code>).

'''{{Variables|Product}}''' verringert mithilfe dieser ausführbaren Datei die Größe Ihrer Android-Anwendungspakete.
|- valign="top"
|
gdbserver-Speicherort
|
Der Speicherort des GDB-Servers im Android-NDK-Ordner (z. B. <code><NDK-Ordner>\prebuilt\android-arm\gdbserver</code>).
|- valign="top"
|
NDK-API-Speicherort
|
Der Speicherort des API-Ordners im Android-NDK-Ordner (z. B. <code><NDK-Ordner>\platforms\android-14</code>).

Damit '''{{Variables|Product}}''' Ihren NDK-API-Ordner als gültigen Ordner erkennen kann, muss dieser Ordner eine Datei mit dem Pfad <code>arch-arm\usr\lib\libandroid.so</code> enthalten.
|- valign="top"
|
Bibliothekspfad für {{CBuilder}}-NDK
|
Der Speicherort der C++-Bibliothek im Android-NDK-Ordner (z. B. <code><NDK-Ordner>\platforms\android-14\arch-arm\usr\lib</code>).

Klicken Sie auf die Ellipse ([[Image:ProjectOptionsEllipsis.jpg]]), um das Dialogfeld [[Listen Dialogfeld|'''Verzeichnisse''']] zu öffnen, wenn Sie Bibliothekspfade hinzufügen, ersetzen oder löschen möchten.
|- valign="top"
|
Bibliothekspfad für das Delphi-NDK
|
Der Speicherort des Delphi-Bibliotheksordners im Android-NDK-Ordner (z. B. <code><NDK-Ordner>\sources\cxx-stl\stlport\libs\armeabi-v7a</code>).

Klicken Sie auf die Ellipse ([[Image:ProjectOptionsEllipsis.jpg]]), um das Dialogfeld [[Listen Dialogfeld|'''Verzeichnisse''']] zu öffnen, wenn Sie Bibliothekspfade hinzufügen, ersetzen oder löschen möchten.
|}

====Registerkarte "Java"====

{| border="1" frame="hsides" rules="rows"
|-
! '''Element'''
! '''Beschreibung'''
|- valign="top"
|
KeyTool-Speicherort
|
Der Speicherort des JDK-Tools "KeyTool.exe".
|- valign="top"
|
JarSigner-Speicherort
|
Der Speicherort des JDK-Tools "JarSigner.exe".
|}

:'''Hinweis:''' In den Android-SDK-Eigenschaften können Sie keine Netzwerkadressen als Speicherorte verwenden, die mit einem doppelten Backslash beginnen. Beispielsweise ist <code>\\mycompany.com\android\sdk</code> hier kein gültiger Wert. Verwenden Sie stattdessen ein [http://windows.microsoft.com/en-us/windows7/create-a-shortcut-to-map-a-network-drive Netzwerklaufwerk].

==Fehlerbehebung (OS X und iOS)==

===Behandlung mehrerer Xcode-Installationen===

Bei mehreren Installationen von Xcode müssen Sie sicherstellen, dass das Befehlszeilentool <code>xcode-select</code> auf den Xcode-Hauptinstallationsordner zeigt. Geben Sie <code>xcode-select -p</code> ein, um den Pfad zum aktuell ausgewählten Entwicklerverzeichnis anzuzeigen:

MacOS yourname $ xcode-select -p
/Applications/Xcode.app/Contents/Developer

Wenn das Befehlszeilentool auf einen Ordner zeigt, der nicht Ihr Xcode-Hauptinstallationsordner ist, geben Sie <code>xcode-select -s <Pfad></code> ein, um das Entwicklerverzeichnis festzulegen, zum Beispiel:

MacOS yourname $ sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

Weitere Informationen finden Sie in der [https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html Apple-Dokumentation für xcode-select (EN)].

===Fehlende SDK-Versionen aufgrund eines falschen Xcode-Verzeichnisses===

Nach der Auswahl eines Verbindungsprofils im Dialogfeld '''[[Neues SDK hinzufügen|Neues SDK hinzufügen]]''' wird die Dropdown-Liste '''SDK-Version auswählen''' mit den vom [[PAServer: Die Platform Assistant Server-Anwendung|Platform Assistant]] auf dem Remote-Computer ermittelten SDK-Versionen gefüllt.

Wenn die Dropdown-Liste '''SDK-Version auswählen''' leer ist, eine erwartete SDK-Version nicht aufgeführt ist oder der folgende Fehler angezeigt wird:

No SDKs could be found for the iOS Device/Simulator platform. Did you install the Command Line Tools on your Xcode?

Überprüfen Sie die Xcode-Installation auf Ihrem Mac, und stellen Sie sicher, dass das Befehlszeilentool <code>xcode-select</code> auf Ihren Xcode-Installationsordner zeigt. Siehe [[#Behandlung mehrerer Xcode-Installationen|Behandlung mehrerer Xcode-Installationen]].

Wenn der Pfad, auf den von <code>xcode-select</code> gezeigt wird, korrekt ist, überprüfen Sie den Inhalt des folgenden Verzeichnisses:

:<code><Xcode-Entwicklerverzeichnis>/Platforms/<Plattform>.platform/Developer/SDKs/</code>
: Wie z. B.: <code>/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/</code>

''Plattform'' ist hierbei:

* <code>OSX</code> für die OS X-Plattform
* <code>iPhoneOS</code> für die Plattformen "iOS-Gerät - 32 Bit" und "iOS-Gerät - 64 Bit"
* <code>iPhoneSimulator</code> für die Plattform "iOS-Simulator"

Der "Platform Assistant" liest die SDK-Versionen aus diesem Verzeichnis, und die Dropdown-Liste '''SDK-Version auswählen''' enthält nur diese SDK-Versionen.

:'''Hinweis:''' Der "Platform Assistant" stellt ein zusätzliches SDK, '''Befehlszeilentools''' (Command Line Tools), bereit, das Sie nur für die OS X-Plattform installieren müssen.

===Fehler "Unbekannter Compiler" nach Aktualisierung von XCode===

Nach der Aktualisierung von XCode auf OS X könnte der Fehler <code>[bccosx Schwerer Fehler]... unbekannter Compiler </code> auftreten.

Führen Sie die folgenden Schritte aus, um dieses Problem zu beheben:

* Löschen Sie das SDK aus dem [[SDK-Manager|SDK-Manager]].
** Öffnen Sie {{Menu|Tools > Optionen > [[Umgebungsoptionen|Umgebungsoptionen]] > SDK-Manager}}. 
**: '''Hinweis:''' Sie können den [[SDK-Manager|SDK-Manager]] auch mit '''[[Projektverwaltung|Projektverwaltung]]''' | mit der rechten Maustaste auf die OS X-Plattform in '''[[Projektverwaltung#Kontextmenü für Zielplattformen|Zielplattformen]]''' klicken | '''SDK bearbeiten''' öffnen.
** Wählen Sie im Abschnitt '''OS X''' die SDK-Version aus, und klicken Sie auf '''Löschen'''.
* Entfernen Sie den gesamten Inhalt aus dem SDK-Ordner auf dem Computer, auf dem {{product}} installiert ist.
** Der SDK-Ordner befindet sich unter {{path | Dokumente\Embarcadero\Studio\SDKs\}}.
* Entfernen Sie den Ordner "scratch-dir" aus dem PAServer-Verzeichnis auf OS X.

Rufen Sie anschließend die Anwendung erneut auf, um ein neues SDK hinzuzufügen.

==Themen==

* [[Neues SDK hinzufügen|Neues SDK hinzufügen]]
* [[Remote-Pfadeintrag hinzufügen oder Remote-Pfadeintrag bearbeiten|Remote-Pfadeintrag hinzufügen oder Remote-Pfadeintrag bearbeiten]]
* [[Neues Android SDK erstellen|Neues Android SDK erstellen]]

==Siehe auch==

* [[Plattformvoraussetzungen für FireMonkey|Plattformvoraussetzungen für FireMonkey]]
* [[Geräteübergreifende Anwendungen - Index|Geräteübergreifende Anwendungen]]
* [[Hinzufügen von SDKs für OS X oder iOS|Hinzufügen von SDKs für OS X oder iOS]]
* [[Hinzufügen von Android-SDKs|Hinzufügen von Android-SDKs]]
* [[Ändern des lokalen Stammverzeichnisses von SDKs für OS X, iOS-Geräte oder den iOS-Simulator|Ändern des lokalen Stammverzeichnisses von SDKs für OS X, iOS-Geräte oder den iOS-Simulator]]
* [[Verbindungsprofil auswählen|Verbindungsprofil auswählen]]
* [[Verbindungsprofil-Manager|Verbindungsprofil-Manager]]

[[Category:XE4]]
[[Category:Geräteübergreifend]]
[[Category:AMMigrate]]

[[en:SDK Manager]]
[[fr:Gestionnaire de SDK]]
[[ja:［SDK マネージャ］]]

Manuelles Sandboxing der macOS-Anwendung

2016-06-23T08:15:36Z

Esabatell: Updated. LOC-22885

Sandboxing der macOS-Anwendung

2016-06-23T08:15:10Z

Esabatell: Updated. LOC-22885

{{Parent|OS X-Anwendungsentwicklung}}

Per '''Sandboxing''' wird der Zugriff einer Anwendung auf Systemressourcen beschränkt, und Apple kann damit verhindern, dass Apps unsicher sind oder Malware enthalten. Sie müssen für Ihre OS X-Anwendungen ein Sandboxing durchführen, wenn Sie sie [[Übermittlung der App an den Mac App Store|an den Mac App Store übermitteln möchten]].

In diesem Thema wird beschrieben, wie Sie ein Sandboxing für Ihre OS X-Anwendungen mit der {{Product}}-IDE durchführen. Wenn Sie die IDE nicht für den Sandboxing-Prozess verwenden können, lässt sich alternativ [[Manuelles Sandboxing der OS X-Anwendung|für Ihre Anwendung manuell ein Sandboxing durchführen]].

==Voraussetzungen==

Vor dem Sandboxing Ihrer OS X-Anwendung müssen Sie Folgendes ausführen:

* [[Vorbereiten einer OS X-Anwendung für die Bereitstellung|Bereiten Sie Ihre Anwendung für die Bereitstellung vor]].
* [[Bereitstellen von OS X-Anwendungen|Stellen Sie Ihre Anwendung bereit]].

==Generieren eines Sandbox-Anwendungspakets==

[[Image:MacOSXApplicationStoreDeploymentProjectManager.png|thumb|300px|Für das Generieren eines Sandbox-Pakets vorbereitetes Projekt]]

So generieren Sie eine Sandbox-Anwendungspaketdatei für Ihre OS X-Anwendung:

# [[Ausführen des Platform Assistant auf dem Mac|Führen Sie den Platform Assistant auf dem Mac aus]].
# Führen Sie in der '''[[Projektverwaltung|Projektverwaltung]]''' folgende Schritte aus:
## Erweitern Sie den Knoten '''Build-Konfigurationen''', und doppelklicken Sie auf die '''Release'''-Konfiguration bzw. eine andere plattformunabhängige Konfiguration, die Sie zum Erstellen des Sandbox-Anwendungspakets verwenden möchten.
## Erweitern Sie den Knoten '''Zielplattformen''', und doppelklicken Sie auf die Zielplattform '''OS X''', um diese Plattform auszuwählen. Die ausgewählte Zielplattform wird in Fettschrift angezeigt.
## Erweitern Sie den Knoten '''OS X''', erweitern Sie darin den Knoten '''Konfiguration''', und doppelklicken Sie auf den Plattformkonfigurationsknoten '''Anwendungs-Store''', um diese Plattformkonfiguration auszuwählen. Die ausgewählte Plattformkonfiguration wird in Fettschrift angezeigt.
# [[Projekt erzeugen|Erzeugen]] Sie das Projekt in {{Product}}.
# Wählen Sie {{Menu|Projekt > [[Bereitstellungs-Manager|Bereitstellung]]}}, und klicken Sie auf die Schaltfläche '''Bereitstellen''' [[Image:DMgrDeploy.png]], um die Anwendung bereitzustellen.

{{Product}} erzeugt Ihre Anwendung mit dem [[SDK-Manager|SDK]], das Sie zuvor in der IDE hinzugefügt haben, stellt eine Verbindung zu Ihrem Mac mit dem [[Verbindungsprofil-Manager|Verbindungsprofil]] her, das Sie für die Plattform '''OS X''' konfiguriert haben, und der auf dem Mac ausgeführte '''[[PAServer: Die Platform Assistant Server-Anwendung|Platform Assistant]]''' generiert eine Sandbox-Anwendungspaketdatei für Ihre Anwendung.

Sie können [[Übermittlung der App an den Mac App Store|dieses Paket an den Mac App Store übermitteln]].

==Siehe auch==

* [[Manuelles Sandboxing der OS X-Anwendung|Manuelles Sandboxing der OS X-Anwendung]]
* [[Konfigurieren eines Anwendungseintrags in iTunes Connect für das Hochladen|Konfigurieren eines Anwendungseintrags in iTunes Connect für das Hochladen]]
* [[Vorbereiten einer OS X-Anwendung für die Bereitstellung|Vorbereiten einer OS X-Anwendung für die Bereitstellung]]
* [[Übermittlung der App an den Mac App Store|Übermittlung der App an den Mac App Store]]
* [https://developer.apple.com/devcenter/mac/app-sandbox/ App Sandboxing]
* [https://developer.apple.com/library/mac/#documentation/Security/Conceptual/AppSandboxDesignGuide/AboutAppSandbox/AboutAppSandbox.html#//apple_ref/doc/uid/TP40011183 App Sandbox Design Guide]
* [https://developer.apple.com/library/mac/#documentation/Security/Conceptual/AppSandboxDesignGuide/AppSandboxQuickStart/AppSandboxQuickStart.html#//apple_ref/doc/uid/TP40011183-CH2-SW3 App Sandbox Quick Start]
* [[Bereitstellen von iOS-Anwendungen für die Übermittlung an den App Store|Bereitstellen von iOS-Anwendungen für die Übermittlung an den App Store]]

[[Category:OS X]]
[[Category:AMMigrate]]

[[en:Sandboxing Your OS X Application]]
[[fr:Sandboxing de votre application Mac OS X]]
[[ja:Mac OS X アプリケーションのサンドボックス化]]

Ausführen des Platform Assistant auf dem Mac

2016-06-23T08:14:36Z

Esabatell: Updated. LOC-22885

{{Parent|PAServer: Die Platform Assistant Server-Anwendung}}
__TOC__
Den "Platform Assistant" können Sie auf dem Mac auf eine der beiden folgenden Weisen starten:

* Doppelklicken Sie [[#Ausführen von "Platform Assistant" im Finder|im '''Finder''']] auf '''{{PAServerOSXAppFile}}''' (grafisch).
* Führen Sie die ausführbare Datei '''paserver''' im [[#Ausführen von paserver in einem Terminal-Fenster|'''Terminal'''-Fenster (Befehlszeile) aus.]]

:'''Hinweis:'''
:*Im Finder können Sie Optionen in einer .config-Datei festlegen.
:*Im Terminal-Fenster können Sie den "Platform Assistant" mit angepassten Optionen starten.
: Unter [[Festlegen von Optionen für den Platform Assistant|Festlegen von Optionen für den Platform Assistant]] finden Sie Informationen zum Festlegen von Optionen für PAServer.

==Ausführen von "Platform Assistant" im Finder==

Aktivieren Sie auf dem Mac im Finder die .app-Datei ({{PAServerOSXAppFile}}) wie folgt:

# Navigieren Sie zum obersten '''Applications'''-Ordner.
#:'''Tipps:'''
#:*Wenn Sie ein anderes Installationsziel verwendet haben, wählen Sie den entsprechenden Datenträger aus, bevor Sie zum obersten Applications-Ordner wechseln.
#:* Ein Beispiel finden Sie unter [[#Beispiel: Navigieren zum Installationsverzeichnis von paserver (MacOS-Ordner)|Beispiel: Navigieren zum Installationsverzeichnis von paserver (MacOS-Ordner)]]
# Doppelklicken Sie auf '''{{PAServerOSXAppFile}}''', um den "Platform Assistant" zu starten.
#:[[Image:SelectNewRADPAServer.png]] 
#::'''Hinweis:''' Informationen zu '''PAServer Manager''' finden Sie unter [[Ausführen von PAServer Manager auf dem Mac|Ausführen von PAServer Manager auf dem Mac]].
#:Das Terminal-Fenster wird mit dem "Platform Assistant"-Banner und der Passworteingabeaufforderung angezeigt: 
#::<code>Verbindungsprofil-Passwort <Eingabetaste für kein Passwort>:</code>
#*Die Reaktion auf die Eingabeaufforderung ist unter [[Ausführen des Platform Assistant auf dem Mac#Anmelden beim Platform Assistant|Anmelden beim Platform Assistant]] beschrieben.
#* Als Nächstes werden Sie nach Ihrem Passwort gefragt, um das Debuggen von Apps auf dem Mac zuzulassen. Nachdem Sie die [[Übernahme der Berechtigung zur Debugging-Unterstützung auf einem Mac|Berechtigung zum Debugging auf dem Mac erworben haben]], sollte das Terminal-Fenster wie folgt aussehen:

MyMac:~ myname$ /Applications/PAServer-16.0.app/Contents/MacOS/paserver ; exit;
Platform Assistant Server Version 7.0.1.40
Copyright (c) 2009-2015 Embarcadero Technologies, Inc.

Connection Profile password <press Enter for no password>:

Acquiring permission to support debugging...succeeded

Starting Platform Assistant Server on port 64211

Type ? for available commands
>

:'''Tipp:''' Um die ausführbare Datei '''paserver''' im Finder anzuzeigen, klicken Sie mit der rechten Maustaste auf die Datei '''PAServer {{VersionNumber}}.app''', und wählen '''Paketinhalt anzeigen'''. Dadurch werden die Verzeichnisse '''Contents''' und '''MacOS''' im Finder angezeigt. Im Terminal-Fenster werden diese Verzeichnisse immer angezeigt. Die ausführbare Datei '''paserver''' befindet sich im Verzeichnis "MacOS":
::<code> Applications/{{PAServerOSXAppFile}}/Contents/MacOS/paserver </code>

==Ausführen von paserver in einem Terminal-Fenster==

Die Datei '''paserver''' ist die ausführbare Befehlszeilendatei für den "Platform Assistant", und der Pfad zu paserver lautet:

Applications yourname $ /Applications/{{PAServerOSXAppFile}}/Contents/MacOS/paserver

Das heißt, dass sich die ausführbare Datei '''paserver''' '''im''' Paket '''{{PAServerOSXAppFile}}''' im Ordner '''Contents/MacOS''' befindet. Sie können die ausführbare paserver-Datei direkt im Terminal-Fenster ausführen.

Die folgende Anleitung zeigt zwei grundlegende Möglichkeiten zum Starten von paserver von der Befehlszeile aus: Durch Eingabe einer einzigen Befehlszeile im Ordner "Applications" oder durch Navigieren zum Ordner "MacOS". Bei dieser Methode haben Sie die Möglichkeit, die Dateieigenschaften im Verzeichnis '''{{PAServerOSXAppFile}}/Contents/MacOS''', einschließlich von '''paserver''', zu überprüfen.

===Beispiel: Eingeben einer einzelnen Befehlszeile im Ordner "Applications"===

Im Mac-Terminal-Fenster können Sie mit einem einzigen Befehl den Inhalt der Datei '''{{PAServerOSXAppFile}}''' durchsuchen und paserver starten:

# Öffnen Sie auf dem Mac ein Terminal-Fenster, und wechseln Sie mit <code>cd</code> zum obersten "Applications"-Ordner.
#: Geben Sie beispielsweise den oder die Anfangsbuchstaben des "Applications"-Ordners ein, und drücken Sie dann die Taste '''TAB'''. Wenn ein Verzeichnis und nur ein Verzeichnis vorhanden ist, dessen Name mit den eingegebenen Buchstaben beginnt, wird der Verzeichnisname angezeigt:
#:<code>IhrName $ '''cd /A'''</code> <TAB>
#:<code>IhrName $ '''cd /Applications'''</code> <EINGABE>
#:<code>Applications IhrName $ </code>
#*Geben Sie einen "cd"-Befehl mit den Anfangsbuchstaben der aufeinanderfolgenden Teile des Pfades ein, und drücken Sie nach jeder Eingabe die Taste '''TAB''', um den Teil zu vervollständigen.
#: Die komplette Befehlszeile für den Pfad sollte ungefähr wie folgt aussehen:
#: <code>Applications IhrName $ /Applications/PAServer\ &{{VersionNumber}}.app/Contents/MacOS/paserver</code>
# Drücken Sie die '''EINGABE'''-Taste.

===Beispiel: Navigieren zum Installationsverzeichnis von paserver (MacOS-Ordner)===

Sie müssen zu folgendem PAServer-Verzeichnis navigieren:

mymac:~ myname$ '''cd Applications'''
mymac:Applications myname$ '''cd PAServer 16.0'''
mymac:PAServer 16.0 myname$

Im Mac-Terminal-Fenster können Sie mit einer Reihe von <code>cd</code>-Befehlen den Inhalt der Datei '''{{PAServerOSXAppFile}}''' durchsuchen und '''paserver''' starten:

# Verwenden Sie <code>cd</code>-Befehle und die '''TAB'''-Taste. Um beispielsweise den Ordner "Applications" (vom Benutzerverzeichnis auf dem Mac aus) zu starten, geben Sie Folgendes ein:
#:<code>IhrName $ '''cd /A'''</code> <TAB> <EINGABE>
# Zeigen Sie den Inhalt des "Applications"-Ordners durch folgende Eingabe an:
#: <code> Applications IhrName $ '''ls''' </code>
#: Im "Applications"-Verzeichnis sollte '''{{PAServerOSXAppFile}}''' angezeigt werden.
# Navigieren Sie durch das '''PAServer {{VersionNumber}}'''-Paket, indem Sie die Anfangsbuchstaben jedes Ordners eingeben und die Taste '''TAB''' drücken:
#:<code>Applications IhrName $ '''cd PAS'''</code> <TAB>
#::
#:::'''<code>Con</code>''' <TAB>
#::::'''<code>Mac</code>''' <TAB>
#::::: '''<code>pas</code> <TAB>'''
#:Nun sollte die folgende Befehlszeile angezeigt werden:
#:<code> Applications IhrName $ /Applications/PAServer\ <Version>.app/Contents/MacOS/paserver</code>
# Drücken Sie die '''EINGABE'''-Taste, um den Befehl auszuführen.
# Im MacOS-Verzeichnis wird "paserver" angezeigt. Geben Sie folgenden Befehl ein:
#: <code>MacOS IhrName $ '''./paserver'''</code>.
#:'''Hinweis:''' Auf dem Mac müssen Sie jedem Ausführen-Befehl die Zeichen '''<code>./</code>''' voranstellen.
# Drücken Sie die '''EINGABE'''-Taste.

===Beispiel: Festlegen der Port-Nummer beim Starten von PAServer von der Befehlszeile===

Sie können mehrere Instanzen von PAServer ausführen, solange jeder Server eine eindeutige Port-Nummer verwendet.

Fügen Sie die Befehlszeilenoption <code>-port</code> hinzu, wenn Sie PAServer ausführen:

: <code>MacOS IhrName $ '''./paserver -port=64444'''</code>

Weitere Informationen finden Sie unter [[Festlegen von Optionen für den Platform Assistant|Festlegen von Optionen für den Platform Assistant]].

==Anmelden beim Platform Assistant==

Nach dem Start von paserver zeigt der "Platform Assistant" ein Banner und dann die Passworteingabeaufforderung an:

Connection Profile password <press Enter for no password>:

# Bei der Passworteingabeaufforderung haben Sie folgende Möglichkeiten:
#* Geben Sie ein Passwort Ihrer Wahl ein, und drücken Sie die '''EINGABE'''-Taste. Für die Verbindung zu diesem "Platform Assistant" ist dann dieses Passwort erforderlich.
#* Wenn Sie kein Passwort für die Verbindung zu diesem "Platform Assistant" festlegen möchten, drücken Sie die '''EINGABE'''-Taste.
# Wird der "Platform Assistant" während einer Sitzung auf dem Mac zum ersten Mal gestartet, wird das Dialogfeld '''Developer Tools Access''' angezeigt:
#:[[Image:TakeControl.png|400px]]
#* Geben Sie das Passwort für den Mac ein, und klicken Sie auf '''Take Control''' (Steuerung übernehmen), um das Debuggen mit dem "Platform Assistant" zuzulassen. Dieses Passwort ist dasselbe, das Sie eingeben, wenn Sie sich beim System anmelden; Administratorzugriff ist erforderlich.
#*:Sie können die Anmeldung entweder mit dem in diesem Dialogfeld angezeigten Benutzernamen fortsetzen oder einen anderen Benutzernamen eingeben.
#*'''Erneuter Versuch:''' Wenn Sie nicht das richtige Passwort eingeben oder den Vorgang abbrechen, startet der "Platform Assistant" normal, aber beim nächsten Versuch, eine Anwendung von {{Variables|Product}} aus mit dem "Platform Assistant" zu debuggen, werden Sie wieder zur Eingabe des Administratorpassworts aufgefordert.
#*: Siehe [[Übernahme der Berechtigung zur Debugging-Unterstützung auf einem Mac|Übernahme der Berechtigung zur Debugging-Unterstützung auf einem Mac]].

Nach Ausführung dieser Schritte werden im Terminal-Fenster die beiden folgenden Zeilen angezeigt:

Starting Platform Assistant Server on port 64211
>

Die Eingabeaufforderung <code>></code> gibt an, dass sich der '''Platform Assistant''' im Empfangsmodus für den angegebenen Port (standardmäßig Port <code>64211</code>) befindet. Geben Sie den Befehl <code>h</code> ein (geben Sie "h" ein, und drücken Sie die '''EINGABE'''-Taste), um die Liste der verfügbaren Befehle zusammen mit einer Beschreibung anzuzeigen. Geben Sie den Befehl <code>q</code> ein, um den "Platform Assistant" zu beenden.

==Verbindungsprobleme==

===Ausführen von PAServer bei aktivierter Mac-Firewall===

Wenn auf dem Mac die Firewall aktiviert ist, wird beim Start von PAServer auf dem Mac nach "Berechtigung zur Debugging-Unterstützung wird übernommen" folgende Meldung angezeigt:

Do you want the application "paserver" to accept incoming network connections?"

Auch wenn Sie hier auf "Allow" (Zulassen) klicken, kann PAServer keine Verbindung von Ihrem Entwicklungssystem zu dem Mac herstellen.
Sie müssen PAServer ausdrücklich die Verwendung einer der folgenden Lösungen einräumen:

'''Lösung 1:''' Deaktivieren der Firewall auf dem Mac. Gehen Sie dazu folgendermaßen vor:

# Öffnen Sie auf dem Mac im Apple-Menü '''Systemeinstellungen'''.
# Wählen Sie '''Sicherheit''' und dann die Registerkarte '''Firewall'''.
# Klicken Sie auf das '''Schloss'''-Symbol in der linken unteren Ecke.
# Klicken Sie auf die Schaltfläche '''Stopp'''.
# Klicken Sie auf das '''Schloss'''-Symbol, und schließen Sie das Fenster '''Sicherheit'''.

'''Lösung 2:''' Zulassen, dass PAServer durch die Firewall auf den Mac zugreift. Gehen Sie dazu folgendermaßen vor:

# Öffnen Sie auf dem Mac im Apple-Menü '''Systemeinstellungen'''.
# Wählen Sie '''Sicherheit''' und dann die Registerkarte '''Firewall'''.
# Klicken Sie auf '''Firewall'''. (Wenn diese Schaltfläche deaktiviert ist, klicken Sie auf das '''Schloss'''-Symbol in der linken, unteren Ecke.)
# Klicken Sie auf das Plus-Zeichen (+), und navigieren Sie zum '''Applications'''-Ordner.
# Wählen Sie '''{{PAServerOSXAppFile}}''', und klicken Sie dann auf '''Hinzufügen'''. Dadurch wird '''PAServer <Version>.app''' den in den '''FireWall-Optionen''' aufgeführten Apps hinzugefügt.
# So fügen Sie die binäre paserver-Datei hinzu:
## Klicken Sie auf das Pluszeichen (+).
## Drücken Sie die Tasten <code>BEFEHL-UMSCHALT-G</code>.
## Geben Sie in '''Gehe zum Ordner:''' den vollständigen Pfad zu '''paserver''' ein. Zum Beispiel:
##:<code> /Applications/PAServer <Version>.app/Contents/MacOS </code>
## Der Inhalt des MacOS-Verzeichnisses wird angezeigt. Suchen Sie '''paserver''', und doppelklicken Sie darauf. Damit wird die binäre paserver-Datei den Apps in den '''FireWall-Optionen''' hinzugefügt.
# Klicken Sie auf das '''Schloss'''-Symbol, und schließen Sie das Fenster '''Sicherheit'''.

Siehe auch [[Ausführen des Platform Assistant auf dem Mac|Ausführen des Platform Assistant auf dem Mac]].

===Herstellen einer Verbindung zu einem PAServer, wenn der Port verwendet wird===

Möglicherweise wird der folgende Fehler angezeigt, wenn Sie versuchen, PAServer auf dem Mac auszuführen und der Socket verwendet wird (vielleicht von einer Instanz von PAServer, die bereits ausgeführt wird oder auf die nicht mehr zugegriffen werden kann):

Message: Could not bind socket. Address and port are already in use.

Führen Sie zur Lösung dieses Problems einen der folgenden Schritte aus:

* Verwenden der vorhandenen Instanz von PAServer.
* Anhalten der vorhandenen Instanz von PAServer.
* Beenden der vorhandenen Instanz von PAServer wie folgt:
*# Geben Sie im Terminalfenster <code>ps -a</code> ein.
*# Suchen Sie die Instanz von PAServer und deren PID-Nummer.
*# Geben Sie folgenden Befehl ein: <code>kill <pid></code>.

==Siehe auch==

* [[Mobile-Tutorial: Konfigurieren der Entwicklungsumgebung auf dem Mac (iOS)|Mobile-Tutorial: Konfigurieren der Entwicklungsumgebung auf dem Mac (iOS)]]
* [[Installieren des Platform Assistant auf dem Mac|Installieren des Platform Assistant auf dem Mac]]
* [[Ausführen des Platform Assistant unter Windows|Ausführen des Platform Assistant unter Windows]]
* [[Ausführen von iOS-Anwendungen auf einem iOS-Gerät|Ausführen von iOS-Anwendungen auf einem iOS-Gerät]]
* [[Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC|Erstellen und Testen eines Verbindungsprofils auf dem Entwicklungs-PC]]
* [[Ausführen von PAServer Manager auf dem Mac|Ausführen von PAServer Manager auf dem Mac]]

{{DEFAULTSORT:Ausfuhren des Platform Assistant auf dem Mac}}
[[Category:IOS]]
[[Category:OS X]]
[[Category:XE4]]
[[Category:AMMigrate]]

[[en:Running the Platform Assistant on a Mac]]
[[fr:Exécution de Platform Assistant sur un Mac]]
[[ja:Mac でのプラットフォームアシスタントの実行]]