RAD Studio API Documentation - Benutzerbeiträge [de]

REST.HttpClient.EHTTPProtocolException.ErrorMessage

2024-04-25T02:58:12Z

Fabiola.Arias: RS-115639

{{#lst:API:REST.HttpClient.EHTTPProtocolException.ErrorMessage|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} |REST.HttpClient.EHTTPProtocolException.ErrorMessage| |{{InheritsFrom|REST.HttpClient.EHTTPProtocolException.ErrorMessage}}}}

<section begin="short" />Die HTTP-Fehlermeldung.<section end="short" />

===Siehe auch===

* [[REST.HttpClient.EHTTPProtocolException.ErrorCode|REST.HttpClient.EHTTPProtocolException.ErrorCode]]

[[Category:XE8]]
[[Category:API-Dokumentation]]

REST.HttpClient.EHTTPProtocolException

2024-02-20T03:36:46Z

Fabiola.Arias: RS-115639

{{#lst:API:REST.HttpClient.EHTTPProtocolException|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} |REST.HttpClient.EHTTPProtocolException| |{{InheritsFrom|REST.HttpClient.EHTTPProtocolException}}}}

<section begin="short" />Exception mit HTTP-Fehlerinformationen.<section end="short" />

===Siehe auch===

* [[REST.HttpClient.TRESTHTTP|REST.HttpClient.TRESTHTTP]]

[[Category:XE8]]
[[Category:API-Dokumentation]]

MediaWiki:Common.css

2023-03-02T13:24:50Z

Fabiola.Arias: Color testing for Updates - Nicky

@import url('https://fonts.googleapis.com/css?family=Roboto|Open+Sans');

/*HEADER*/
#p-logo a {
display: block;
height: 88px;
vertical-align: middle;
background-repeat: no-repeat;
background-position: center center;
text-decoration: none;
}

#mw-head {
position: absolute;
top: 0;
right: 0;
width: 100%;
height: 82px;
background-color: #fdda76;
}

#p-personal li a.new {
color: #fff;
}

#p-personal li {
line-height: 1.125em;
float: left;
margin-left: 3em;
margin-top: 0.5em;
font-size: 0.75em;
white-space: nowrap;
}

div.duobook2Tabs li.selected a, div.duobook2Tabs li.selected a:visited {
color: #444;
text-decoration: none;
background: white;
font-size: 0.9em;
text-transform: uppercase;
text-align: center;
padding: 1em;
line-height: 1em;
}

div.duobook2Tabs li a {
color: #444;
text-decoration: none;
background: whitesmoke;
font-size: 0.9em;
text-transform: uppercase !important;
text-align: center;
padding: 1em 1em 0 1em;
line-height: 1em;
}

div.duobook2Tabs li a:hover {
z-index: 3;
text-decoration: none;
background-color: #00adf2;
color: #fff;
font-weight: normal;
}

div.duobook2Tabs {
float: left;
height: 2.5em;
background-image: none;
padding-left: 1px;
}

div#mw-head div.duobook2Menu h3 {
float: left;
background-image: none;
font-size: 1em;
height: 2.5em;
padding-right: 0.5em;
margin-right: -1px;
}

div.duobook2Tabs li.new a, div.duobook2Tabs li.new a:visited {
color: #d9d9d9;
}

/*BODY*/

.mw-body .firstHeading {
overflow: visible;
margin-top: 2em;
}

html, body {
font-family: 'Open Sans',sans-serif;
}

a {
text-decoration: none;
color: #1562A3;
background: none;
}

.mw-body {
margin-left: 17em;
padding: 1.5em 9em 1.5em 9em;
}

body {
background-color: #E7EFF5 !important;
background-image: none !important;
}

h1, h2, h3, h4, h5, h6 {
font-family: 'Roboto',sans-serif !important;
color: #444;
background: none;
font-weight: normal;
margin: 0;
overflow: hidden;
padding-top: 0.5em;
padding-bottom: 0.17em;
border-bottom: none;
}

.mw-body-content h3, .mw-body-content h4 {
font-weight: normal;
}

.mw-body-content h3 {
font-size: 140%;
}

pre, .mw-code {
padding: 1em;
font-size: 1.1em;
border: 1px solid #efefef;
color: black;
background-color: #f9f9f9;
line-height: 1.3em;
word-wrap: break-word;
white-space: pre-wrap;
}

.mw-body {
margin-left: 16em;
border: none;
margin-top: 0px;
}

.mw-body-content h2 {
font-size: 180%;
padding-bottom: .25em;
}

.catlinks {
border: none;
background-color: #e7eff5;
padding: 5px 5px 5px 10px;
margin-top: 3em;
clear: both;
font-size: .9em;
}

code {
color: #000;
background-color: transparent !important;
border: none;
padding: 1px 4px;
font-size: 1.15em;
}

#toc, .toc, .mw-warning {
border: 1px solid #efefef;
background-color: #f9f9f9;
padding: 20px;
margin-top: 10px;
margin-left: 10px;
margin-bottom: 10px;
font-size: 90%;
float: right;
}

/*SIDEBAR*/

div.duobook2Menu h3 span {
position: relative;
display: block;
font-size: 0.8em;
padding-left: 1em;
padding-top: 1em;
padding-right: 18px;
font-weight: normal;
color: #fff;
}

#mw-panel .portal h3 {
color: #1562a3;
background: transparent;
padding: 0.5em 1em 0 0;
display: inline;
height: 1.5em;
text-transform: capitalize;
font-size: 0.9em;
font-weight: bold;
white-space: nowrap;
font-variant: none;
}

#mw-panel .portal .body li a {
color: #575757 !important;
}

#mw-panel .portal .body li {
line-height: 1.125em;
margin: 0;
padding: 0.4em 0;
font-size: 0.9em;
word-wrap: break-word;
}

#mw-panel .portal .body {
margin-left: 0.5em;
padding-top: 0;
background-image: none;
}

#mw-panel #p-logo + .portal h3 {
display: initial;
}

/*FOOTER*/

#footer {
background-color: #1562a3;
margin-left: 16em;
padding: 2em;
/*text-align: center;*/
color: #00ADF2;
/*width: 100% !important;
position: fixed !important;*/
}

#footer ul li {
color: #00ADF2;
margin: 0;
padding: 0;
padding-top: 0px;
padding-bottom: 0px;
padding-top: 0.5em;
padding-bottom: 0.5em;
font-size: 0.8em;
}

#mw-panel .portal .body ul {
list-style: none none;
margin: 0;
padding: 0.3em 0 0 1em;
}

/*TABLES*/

table.wikitable > tr > th,table.wikitable > * > tr > th {
background-color:#00adf2;
color:#fff;
text-align:center
}

table th {
padding:0.5em 1em;
background-color: #00adf2;
color: #fff;
}

table td {
padding:.2em .5em;
background-color:#f5f5f5;
border-left:1px solid #f3f3f3;
border-right:1px solid #e3e3e3;
border-top:1px solid #f3f3f3;
border-bottom:1px solid #ccc;
color:#000;
}

table tr:nth-child(odd) td {
background: #fff
}

table.wikitable > * > tr > td {
border: 1px solid #d4d4d4;
padding: 0.2em 0.4em;
}

fieldset table {
background:none
}

FireDAC.Comp.BatchMove.TFDBatchMove.WriteCount

2023-01-31T19:55:28Z

Fabiola.Arias: RS-116336

{{#lst:API:FireDAC.Comp.BatchMove.TFDBatchMove.WriteCount|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} |FireDAC.Comp.BatchMove.TFDBatchMove.WriteCount | |{{InheritsFrom|FireDAC.Comp.BatchMove.TFDBatchMove.WriteCount}}}}

<section begin="short" />Mit der Eigenschaft [[FireDAC.Comp.BatchMove.TFDBatchMove.WriteCount|WriteCount]] ermitteln Sie die Anzahl der erfolgreich im Ziel eingefügten, aktualisierten oder gelöschten Datensätze.<section end="short" />

Der Wert der Eigenschaft wird nach jedem erfolgreich bewegten Datensatz inkrementiert. Die Eigenschaft [[FireDAC.Comp.BatchMove.TFDBatchMove.WriteCount|WriteCount]] kann für statistische Zwecke oder für Rückmeldungen bei der Datenbewegung eingesetzt werden.

Wenn [[FireDAC.Comp.BatchMove.TFDBatchMove|TFDBatchMove]] die Methode [[FireDAC.Comp.BatchMove.TFDBatchMove.Execute|Execute]] aufruft, werden alle Zähler auf null gesetzt.

===Siehe auch===

* [[samp_en:FireDAC.TFDBatchMove Sample|TFDBatchMove (Beispiel)]]
* [[FireDAC.Comp.BatchMove.TFDBatchMove|FireDAC.Comp.BatchMove.TFDBatchMove]]
* [[FireDAC.Comp.BatchMove.TFDBatchMove.InsertCount|FireDAC.Comp.BatchMove.TFDBatchMove.InsertCount]]
* [[FireDAC.Comp.BatchMove.TFDBatchMove.UpdateCount|FireDAC.Comp.BatchMove.TFDBatchMove.UpdateCount]]
* [[FireDAC.Comp.BatchMove.TFDBatchMove.DeleteCount|FireDAC.Comp.BatchMove.TFDBatchMove.DeleteCount]]
* [[FireDAC.Comp.BatchMove.TFDBatchMove.ReadCount|FireDAC.Comp.BatchMove.TFDBatchMove.ReadCount]]

[[Category:API-Dokumentation]]
[[Category:XE7]]

System.Diagnostics.TStopwatch.Elapsed

2022-12-02T13:44:51Z

Fabiola.Arias: RS-103098

{{#lst:API:System.Diagnostics.TStopwatch.Elapsed|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Diagnostics.TStopwatch.Elapsed | |{{InheritsFrom|System.Diagnostics.TStopwatch.Elapsed}}}}

<section begin=short />Legt die verstrichene Zeit fest.<section end=short />

Verwenden Sie [[System.Diagnostics.TStopwatch.Elapsed|Elapsed]], um die gesamte verstrichene Zeit, die von der Stoppuhr gezählt wurde, zu erhalten. [[System.Diagnostics.TStopwatch.Elapsed|Elapsed]] gibt einen [[System.TimeSpan.TTimeSpan|TTimeSpan]]-Wert zurück, der verwendet werden kann, um die Zeitspanne in der gewünschten Form zu erhalten.

===Siehe auch===

* [[System.Diagnostics.TStopwatch.Frequency|Frequency]]

* [[System.Diagnostics.TStopwatch.ElapsedMilliseconds|ElapsedMilliseconds]]

* [[System.Diagnostics.TStopwatch.ElapsedTicks|ElapsedTicks]]

[[Category:API-Dokumentation]]

System.Diagnostics.TStopwatch.ElapsedMilliseconds

2022-12-02T13:43:47Z

Fabiola.Arias: RS-103098

{{#lst:API:System.Diagnostics.TStopwatch.ElapsedMilliseconds|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Diagnostics.TStopwatch.ElapsedMilliseconds | |{{InheritsFrom|System.Diagnostics.TStopwatch.ElapsedMilliseconds}}}}

<section begin=short />Legt die verstrichene Zeit in Millisekunden fest.<section end=short />

Verwenden Sie [[System.Diagnostics.TStopwatch.ElapsedMilliseconds|ElapsedMilliseconds]], um die gesamte verstrichene Zeit, die von der Stoppuhr gezählt wurde, zu erhalten. [[System.Diagnostics.TStopwatch.ElapsedMilliseconds|ElapsedMilliseconds]] gibt einen 64-Bit-Integer zurück, der die Anzahl der verstrichenen ticks enthält.

===Siehe auch===

* [[System.Diagnostics.TStopwatch.Frequency|Frequency]]

* [[System.Diagnostics.TStopwatch.Elapsed|Elapsed]]

* [[System.Diagnostics.TStopwatch.ElapsedTicks|ElapsedTicks]]

[[Category:API-Dokumentation]]

System.Diagnostics.TStopwatch.ElapsedTicks

2022-12-02T13:43:24Z

Fabiola.Arias: RS-103098

{{#lst:API:System.Diagnostics.TStopwatch.ElapsedTicks|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Diagnostics.TStopwatch.ElapsedTicks | |{{InheritsFrom|System.Diagnostics.TStopwatch.ElapsedTicks}}}}

<section begin=short />Legt die verstrichene Zeit in ticks fest.<section end=short />

Verwenden Sie [[System.Diagnostics.TStopwatch.ElapsedTicks|ElapsedTicks]], um die gesamte verstrichene Zeit, die von der Stoppuhr gezählt wurde, zu erhalten. [[System.Diagnostics.TStopwatch.ElapsedTicks|ElapsedTicks]] gibt einen 64-Bit-Integer zurück, der die Anzahl der verstrichenen Millisekunden enthält.

===Siehe auch===

* [[System.Diagnostics.TStopwatch.Frequency|Frequency]]

* [[System.Diagnostics.TStopwatch.Elapsed|Elapsed]]

* [[System.Diagnostics.TStopwatch.ElapsedMilliseconds|ElapsedMilliseconds]]

[[Category:API-Dokumentation]]

System.TModuleUnloadProcLW

2022-10-10T21:01:15Z

Fabiola.Arias: RS-108486

{{#lst:API:System.TModuleUnloadProcLW|api}}

==Beschreibung==
<section begin=short />[[System.TModuleUnloadProcLW|TModuleUnloadProcLW]] definiert eine Prozedur, die während des Entladens von Packages aufgerufen werden kann.<section end=short />

Vor dem Entladen eines Packages, das von Ihrer Anwendung verwendet wurde, kann Delphi optional Ihre [[System.TModuleUnloadProcLW|TModuleUnloadProcLW]]-Routine aufrufen. Im Wesentlichen fügt [[System.AddModuleUnloadProc|AddModuleUnloadProc]] Ihre Callback-Routine an den Anfang der Liste der internen Routinen hinzu, die Delphi aufruft, um das Entladen durchzuführen.

'''HInstance''' ist das Handle auf die DLL-Package-Instanz, die entladen wird.

Der LW-Anteil des Namens verweist auf den Typ Long Word des Package-Handles. Dies ist mit Windows-Handles und dem Typ [[System.THandle|THandle]] konform.

===Siehe auch===

* [[System.AddModuleUnloadProc|AddModuleUnloadProc]]

* [[System.TModuleUnloadProc|TModuleUnloadProc]]

[[Category:API-Dokumentation]]

System.TModuleUnloadProc

2022-10-10T20:39:11Z

Fabiola.Arias: RS-108486

{{#lst:API:System.TModuleUnloadProc|api}}

==Beschreibung==
<section begin=short />[[System.TModuleUnloadProc|TModuleUnloadProc]] definiert eine Prozedur, die während des Entladens von Packages aufgerufen werden kann.<section end=short />

Vor dem Entladen eines Packages, das von Ihrer Anwendung verwendet wurde, kann Delphi optional Ihre [[System.TModuleUnloadProc|TModuleUnloadProc]]-Routine aufrufen. Im Wesentlichen fügt [[System.AddModuleUnloadProc|AddModuleUnloadProc]] Ihre Callback-Routine an den Anfang der Liste der internen Routinen hinzu, die Delphi aufruft, um das Entladen durchzuführen.

'''HInstance''' ist das Handle auf die DLL-Package-Instanz, die entladen wird.

===Siehe auch===

* [[System.AddModuleUnloadProc|AddModuleUnloadProc]]

* [[System.TModuleUnloadProcLW|TModuleUnloadProcLW]]

[[Category:API-Dokumentation]]

System.SysUtils.WrapText

2022-02-01T13:12:35Z

Fabiola.Arias: RS-93449

{{#lst:API:System.SysUtils.WrapText|api}}
==Beschreibung==
<section begin="short" />Fügt einen '''Zeilenumbruch''' in einen String ein, wenn dessen Länge sich einer bestimmten Größe nähert.<section end="short" />

[[System.SysUtils.WrapText|WrapText]] fügt keinen Zeilenumbruch in in Anführungszeichen gesetzte Strings (sowohl in einfache als auch in doppelte Anführungszeichen) ein.

Im Allgemeinen sucht die Routine [[System.SysUtils.WrapText|WrapText]] nach Leerzeichen, Bindestrichen oder Tabulatorzeichen, bei denen ein Zeilenumbruch erfolgen kann, und fügt unter '''Windows''' ein Wagenrücklauf/Zeilenvorschub-Paar oder unter '''MacOS''' einen Zeilenvorschub ein, bevor die <code>MaxCol</code>-Zeichen gezählt werden (erste Überladung).

Bei der zweiten Überladung wird eine neue String-Folge (angegeben im Parameter <code>BreakStr</code>) bei dem letzten Vorkommen eines im Mengenparameter <code>BreakChars</code> angegebenen Umbruchzeichens eingefügt, bevor die <code>MaxCol</code>-Zeichen gezählt werden.

Beispielsweise liefert der folgende Code

<source lang=delphi>
WrapText('The rain in Spain falls mainly on the plain.', #13#10, ['.',' ',#9,'-'], 15);
</source>

<source lang=cpp>
TSysCharSet bChars;
bChars << '.' << ' ' << '/t' << '-';
WrapText("The rain in Spain falls mainly on the plain.", "/n", bChars, 15);
</source>

dieses Ergebnis:

The rain in Spain
falls mainly on the
plain.

===Siehe auch===
* [[System.SysUtils.TSysCharSet]]

[[Category:API-Dokumentation]]

System.Classes.TDataModule.OnCreate

2021-09-28T14:12:38Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.Classes.TDataModule.OnCreate|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Classes.TDataModule.OnCreate | |{{InheritsFrom|System.Classes.TDataModule.OnCreate}}}}

<section begin=short />Wird ausgelöst, sobald ein Datenmodul in einer Anwendung instantiiert wird.<section end=short />

Mit einer Ereignisbehandlungsroutine für [[System.Classes.TDataModule.OnCreate|OnCreate]] können spezielle Aktionen durchgeführt werden, wenn ein Datenmodul in einer Anwendung instantiiert wird. Enthält ein Datenmodul beispielsweise Datenbank- und Datenmengenkomponenten, kann eine Anwendung sofort eine Datenbankverbindung einrichten. Enthält das Modul einen Timer, kann dieser von der Anwendung initialisiert werden.

{{Note| Das Ereignis [[System.Classes.TDataModule.OnCreate|OnCreate]] sollte in C++ nicht verwendet werden, da Probleme mit dem Konstruktor des Datenmoduls auftreten können (siehe [[System.Classes.TDataModule.OldCreateOrder|OldCreateOrder]]). Es ist daher ratsam, den Konstruktor zu überschreiben.}}

OnCreate ist eine Ereignisbehandlungsroutine des Typs [[System.Classes.TNotifyEvent]].

===Siehe auch===

* [[System.Classes.TNotifyEvent]]

* [[System.Classes.TDataModule.OnDestroy|OnDestroy]]

* [[System.Classes.TDataModule.OldCreateOrder|OldCreateOrder]]

[[Category:API-Dokumentation]]

System.TObject.Destroy

2021-09-27T21:02:15Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.TObject.Destroy|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.TObject.Destroy | |{{InheritsFrom|System.TObject.Destroy}}}}

<section begin=short />Gibt eine Objektinstanz frei.<section end=short />

Rufen Sie [[System.TObject.Destroy|Destroy]] nicht direkt auf. Verwenden Sie stattdessen [[System.TObject.Free|Free]]. Die Methode Free überprüft, ob die Objekt-Referenz nicht bereits nil ist und ruft [[System.TObject.Destroy|Destroy]] nur bei Bedarf auf.

Die in [[System.TObject.Create|TObject]] definierte Version von [[System.TObject.Destroy|Destroy]] gibt den Speicher frei. Abgeleitete Objekte definieren normalerweise einen eigenen Destruktor.

Wenn Sie eine [[System.TObject.Destroy|Destroy]]-Methode in einem abgeleiteten Objekt deklarieren, beachten Sie Folgendes: Fügen Sie in die Deklaration immer die Direktive override ein, und rufen Sie als letzte Anweisung in der überschriebenen Methode die geerbte Version von [[System.TObject.Destroy|Destroy]] auf. Da [[System.TObject.Destroy|Destroy]] eine virtuelle Methode ist, stellen Sie durch Überschreiben der Methode sicher, dass das gewünschte Verhalten auftritt.

{{Note| Wenn ein Konstruktor eine Exception nicht behandelt, wird der Destruktor aufgerufen, der die unvollständig initialisierte Objektinstanz wieder freigibt. Deshalb sollten Destruktoren vor der Freigabe überprüfen, ob die zugewiesenen Ressourcen, wie z.B. Handles, tatsächlich zugewiesen wurden (deren Wert könnte Null sein).}}

Die Methode [[System.TObject.Destroy|Destroy]] sollte so implementiert werden, dass sie [[System.TObject.Free|Free]] für Unterobjekte aufruft, die durch den Objektkonstruktor erzeugt (zugewiesen) wurden. Im Gegensatz zu [[System.TObject.Destroy|Destroy]] besitzt [[System.TObject.Free|Free]] einen Sicherheitsmechanismus für die Freigabe von Objekten, die nil sind.

===Siehe auch===

* [[System.TObject.Free]]

[[Category:API-Dokumentation]]

System.TObject.Free

2021-08-27T21:20:45Z

Fabiola.Arias: Added the {{warning|}} and {{note|}} templates

{{#lst:API:System.TObject.Free|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.TObject.Free | |{{InheritsFrom|System.TObject.Free}}}}

<section begin=short />Löst die Instanz eines Objekts auf und gibt nötigenfalls den zugehörigen Speicher frei.<section end=short />

Mit [[System.TObject.Free|Free]] wird ein Objekt freigegeben. Wenn die Objektreferenz nicht nil ist, ruft [[System.TObject.Free|Free]] automatisch den Destruktor auf. Alle zur Laufzeit instantiierten Objekte, die keinen Eigentümer besitzen, sollten mit [[System.TObject.Free|Free]] aufgelöst werden, damit sowohl das Objekt als auch der zugehörige Speicher korrekt freigegeben wird. Im Gegensatz zu [[System.TObject.Destroy|Destroy]] funktioniert [[System.TObject.Free|Free]] auch dann, wenn das Objekt nil ist. Es ist also kein Fehler, die Methode [[System.TObject.Free|Free]] für ein Objekt aufzurufen, das niemals initialisiert wurde.

Wenn Sie [[System.TObject.Free|Free]] für eine Komponente aufrufen, werden alle untergeordneten Objekte (die Einträge in ihrer Komponentenliste) automatisch freigegeben. Da ein Formular der Eigentümer aller Steuerelemente und anderer Komponenten ist, die Sie im Entwurfsmodus hinzugefügt haben, werden diese Komponenten automatisch mit dem Formular freigegeben. Alle Formulare gehören standardmäßig zum Anwendungsobjekt (TApplication) und werden daher zusammen mit diesem aus dem Speicher entfernt. Bei Objekten, die keine Komponenten sind, oder bei mit dem Eigentümer nil erstellten Komponenten muss [[System.TObject.Free|Free]] explizit aufgerufen werden, wenn das betreffende Objekt nicht mehr benötigt wird. Der zugewiesene Speicher kann sonst erst nach dem Beenden der Anwendung wieder verwendet werden.

{{Warning| Sie dürfen eine Komponente nie in einer ihrer eigenen Ereignisbehandlungsroutinen oder in einer Ereignisbehandlungsroutine eines untergeordneten Objekts freigeben. Geben Sie beispielsweise auf keinen Fall eine Schaltfläche oder ihr übergeordnetes Formular in der OnClick-Ereignisbehandlungsroutine der Schaltfläche frei.}}

Um ein Formular freizugeben, ruften Sie seine Methode [[Vcl.Forms.TCustomForm.Release|Release]] auf. Dadurch wird sichergestellt, dass das Formular erst aus dem Speicher entfernt wird, wenn die Ausführung seiner eigenen und der Ereignisbehandlungsroutinen seiner Komponenten beendet ist.

{{Note| Geben Sie in C++ keine Objekte mit [[System.TObject.Free|Free]] frei. Verwenden Sie stattdessen das Schlüsselwort '''delete'''.}}

===Siehe auch===

* [[System.TObject.Destroy|Destroy]]

* [[Vcl.Forms.TCustomForm.Release|Release]]

* [[System.Classes.TComponent.Owner|Owner]]

* [[System.SysUtils.FreeAndNil|FreeAndNil]]

[[Category:API-Dokumentation]]


=== Codebeispiele ===
*[[samp_en:TMenuItems (Delphi)|TMenuItems (Delphi)]]

System.Classes.RegisterComponents

2021-07-13T03:44:37Z

Fabiola.Arias: Added the {{Note|}} template

__TOC__
{{#lst:API:System.Classes.RegisterComponents|api}}

==Beschreibung==

<section begin="short" />Registriert die {{Arg|ComponentClasses}}-Komponenten so, dass sie alle auf derselben Seite ({{Arg|Page}}) der '''Tool-Palette''' erscheinen.<section end="short" />

Rufen Sie [[System.Classes.RegisterComponents|RegisterComponents]] auf, um eine Menge von Komponenten zu registrieren, die in einem [[rad_de:Packages (Optionen)|in der IDE installierten Package]] deklariert sind. Sobald eine Komponente registriert ist, wird sie in der '''Tool-Palette''' angezeigt. Dort kann sie dann ausgewählt und in Formulare oder Datenmodule eingefügt werden. Registrierte Komponenten können mit dem '''Objektinspektor''' kommunizieren, um dem Benutzer Lese- und Schreibzugriff auf Eigenschaften und Ereignisse zu ermöglichen.

Geben Sie im Parameter <code>Page</code> den Namen der Registerkarte (Kategorie) der '''Tool-Palette''' an, in der die Komponenten angezeigt werden sollen. Falls die angegebene Kategorie (<code>Page</code>) bereits vorhanden ist, werden die Komponenten in diese Kategorie eingefügt. Ist die Kategorie {{Arg|Page}} nicht vorhanden, wird eine neue Seite in der '''Tool-Palette''' mit dem angegebenen Namen erstellt.

Die zu registrierenden Komponenten werden im Parameter <code>ComponentClasses</code> übergeben.

{{Note| In C++ enthält der Parameter <code>ComponentClasses_High</code> den Index der letzten Klasse im Array <code>ComponentClasses</code> (dieser ist um 1 kleiner als die Anzahl der Klassen).}}

Rufen Sie [[System.Classes.RegisterComponents|RegisterComponents]] in der [[rad_de:Die Register-Prozedur implementieren|Implementierung der Prozedur '''Register''']] in einer der Units auf, in der die benutzerdefinierten Komponenten definiert sind. Die Units, in denen die Komponenten definiert sind, müssen anschließend in ein [[rad_de:Entwurfszeit-Packages|Package]] compiliert werden. Dieses [[rad_de:Komponenten-Packages installieren|Package muss in der IDE installiert werden]], bevor die Komponenten der '''Tool-Palette''' hinzugefügt werden.

Mit '''[[DesignIntf.ForceDemandLoadState|ForceDemandLoadState]]''' [[rad_de:Die Prozedur RegisterComponents aufrufen#Festlegen des Ladestatus für in einem Package registrierte Komponenten|legen Sie fest, ob die IDE das intelligente Laden von registrierten Komponenten verwenden soll]].

{{Note| Eine Komponente kann nach ihrer Registrierung in eine andere Registerkarte der '''Tool Palette''' verschoben werden. Danach erscheint die Komponente immer auf der neuen Seite. Ein erneuter Aufruf von [[System.Classes.RegisterComponents|RegisterComponents]] wirkt sich nicht auf die Seite aus, auf der die Komponente angezeigt wird.}}

===Siehe auch===

* [[DesignIntf.ForceDemandLoadState|DesignIntf.ForceDemandLoadState]]
* [[rad_de:Packages (Optionen)|Packages]]
* [[rad_de:Komponenten-Packages installieren|Komponenten-Packages installieren]]
* [[rad_de:Entwurfszeit-Packages|Entwurfszeit-Packages]]
* [[rad_de:Komponenten registrieren|Komponenten registrieren]]
* [[rad_de:Die Register-Prozedur deklarieren|Die '''Register'''-Prozedur deklarieren]]
* [[rad_de:Die Register-Prozedur implementieren|Die '''Register'''-Prozedur implementieren]]
* [[rad_de:Die Prozedur RegisterComponents aufrufen|Die Prozedur '''RegisterComponents''' aufrufen]]
* [[rad_de:Verwenden von Stilen, die von Komponenten aus in der IDE installierten Entwurfszeit-Packages definiert wurden|Verwenden von Stilen, die von Komponenten aus in der IDE installierten Entwurfszeit-Packages definiert wurden]]
* [[System.Classes.UnRegisterClasses|System.Classes.UnRegisterClasses]]

===Codebeispiele===

* [[Samp_en:RegisterComponents (Delphi)|RegisterComponents (Delphi)]]
* [[Samp_en:RegisterComponents (C++)|RegisterComponents (C++)]]
* [[Samp_en:VCL.Controls Sample|Controls (Beispiel)]]

[[Category:API-Dokumentation]]

System.Classes.TComponent.ComponentIndex

2021-07-12T16:53:17Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.Classes.TComponent.ComponentIndex|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Classes.TComponent.ComponentIndex | |{{InheritsFrom|System.Classes.TComponent.ComponentIndex}}}}

<section begin=short />Gibt die Position der Komponente in dem Array [[System.Classes.TComponent.Components|Components]] ihres Eigentümers an.<section end=short />

Mit [[System.Classes.TComponent.ComponentIndex|ComponentIndex]] können Sie die Komponentenliste des Eigentümers der Komponente durchlaufen, um Aktionen an untergeordneten Komponenten durchzuführen. Die Eigenschaft kann in Verbindung mit [[System.Classes.TComponent.ComponentCount|ComponentCount]] verwendet werden. [[System.Classes.TComponent.ComponentIndex|ComponentIndex]] wird intern für iterative Zuweisungsprozeduren verwendet.

{{Note| Die erste Komponenten in der Liste hat den [[System.Classes.TComponent.ComponentIndex|ComponentIndex]]-Wert 0, die zweite hat den Wert 1 und so weiter. Beachten Sie also bei der Verwendung von [[System.Classes.TComponent.ComponentIndex|ComponentIndex]] und ComponentCount, dass [[System.Classes.TComponent.ComponentCount|ComponentCount]] immer um 1 größer ist als der höchste Komponentenindex.}}

===Siehe auch===

* [[System.Classes.TComponent.ComponentCount|ComponentCount]]

* [[System.Classes.TComponent.Components|Components]]

[[Category:API-Dokumentation]]

System.Classes.TComponent.Create

2021-07-12T16:38:12Z

Fabiola.Arias: Added the {{Tip|}} and the {{Note|}} templates

{{#lst:API:System.Classes.TComponent.Create|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Classes.TComponent.Create | |{{InheritsFrom|System.Classes.TComponent.Create}}}}

<section begin=short />Erzeugt eine mit Standardwerten initialisierte Instanz einer Komponente und weist ihr Speicher zu.<section end=short />

Alle Objekte verfügen über eine Methode [[System.Classes.TComponent.Create|Create]], die das Objekt erzeugt. [[System.Classes.TComponent|TComponent]] definiert [[System.Classes.TComponent.Create|Create]] neu, sodass die Methode [[System.Classes.TComponent.Create|Create]] für Komponenten auch folgende Funktionen ausführt:

* Sie richtet die Beziehung zwischen der Komponente und ihrem Eigentümer ([[System.Classes.TComponent.Owner|Owner]]) ein, der im Parameter <code>AOwner</code> übergeben wird.

* Sie setzt die Eigenschaft [[System.Classes.TComponent.ComponentStyle|ComponentStyle]] auf [[System.Classes.TComponentStyle|<code>csInheritable</code>]], sodass die Komponente von einem abgeleiteten Formulartyp geerbt werden kann.

Komponenten, die im '''Formular-Designer''' hinzugefügt werden, müssen nicht explizit erzeugt werden. Diese Komponenten werden beim Start der Anwendung automatisch erzeugt und bei deren Beendigung freigegeben.

Für per Programm (also nicht im '''Formular-Designer''') erzeugte Komponenten rufen Sie [[System.Classes.TComponent.Create|Create]] auf und übergeben die übergeordnete Komponente im Parameter <code>AOwner</code>. Der Eigentümer entfernt die Komponente bei seiner Freigabe automatisch aus dem Speicher. Wenn die Komponente keinen Eigentümer hat, verwenden Sie Free, um sie freizugeben.

{{Tip| Wenn Sie <code>Self</code> in [[System.Classes.TComponent.Owner|Owner]] übergeben, müssen Sie beachten, auf welche Komponente die Referenz verweist. Wenn eine Komponente in einer ihrer Methoden eine andere Komponente erzeugt, bezieht sich <code>Self</code> auf die erste Komponente und nicht auf die erzeugte Komponente, die der ersten Komponente untergeordnet ist.}}

{{Note| Der Konstruktor von [[System.Classes.TComponent|TComponent]] ist virtuell, um polymorphe Instantiierungen von Klassenreferenzen zu erlauben. Diese Möglichkeit ist für das Streaming-System und für den '''Formular-Designer''' von Bedeutung. Vergessen Sie nicht, die Direktive override zu verwenden, wenn Sie den Konstruktor [[System.Classes.TComponent.Create|Create]] einer neuen Komponente deklarieren.}}

===Siehe auch===

* [[System.Classes.TComponent.Components]]

* [[System.Classes.TComponent.ComponentStyle]]

* [[System.TObject.Create]]

* [[System.Classes.TComponent.Destroy]]

* [[System.TObject.Free]]

* [[System.Classes.TComponent.Owner]]

[[Category:API-Dokumentation]]

System.Classes.TComponent.Loaded

2021-07-07T02:31:27Z

Fabiola.Arias: Added the {{warning|}} and {{note|}} templates

{{#lst:API:System.Classes.TComponent.Loaded|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Classes.TComponent.Loaded | |{{InheritsFrom|System.Classes.TComponent.Loaded}}}}

<section begin=short />Initialisiert die Komponente, nachdem die Formulardatei in den Speicher geladen wurde.<section end=short />

Rufen Sie die als protected deklarierte Methode [[System.Classes.TComponent.Loaded|Loaded]] nicht auf. Loaded wird vom Streaming-System aufgerufen, nachdem das übergeordnete Formular aus einem Stream gelesen wurde.

Loaded ermöglicht einer Komponente, sich selbst zu initialisieren, nachdem alle ihre Teile aus einem Stream geladen wurden. Wenn das Streaming-System ein Formular oder Datenmodul aus der entsprechenden Formulardatei lädt, erstellt es zuerst mit Hilfe des zugehörigen Konstruktors die Formularkomponente und initialisiert dann deren Eigenschaften mit den ausgelesenen Werten. Nachdem alle Eigenschaftswerte aller Komponenten gelesen wurden, ruft das Streaming-System [[System.Classes.TComponent.Loaded|Loaded]] für jede Komponente in der Reihenfolge auf, in der die Steuerelemente erzeugt wurden. Dadurch haben die Komponenten die Möglichkeit, alle Daten zu initialisieren, die von Werten anderer Komponenten abhängig sind.

{{Note| Alle Referenzen auf gleichrangige Komponenten werden vor dem Aufruf von [[System.Classes.TComponent.Loaded|Loaded]] aufgelöst. Zeiger auf gleichrangige Komponenten, die aus einem Stream gelesen wurden, können frühestens in diesem Aufruf von [[System.Classes.TComponent.Loaded|Loaded]] verwendet werden.}}

Die Implementierung von [[System.Classes.TComponent.Loaded|Loaded]] in der Klasse [[System.Classes.TComponent|TComponent]] löscht das Flag <code>csLoading</code> in der Eigenschaft [[System.Classes.TComponent.ComponentState|ComponentState]] und gibt dadurch an, dass die Komponente nicht mehr geladen wird.

{{Warning| Die Methode [[System.Classes.TComponent.Loaded|Loaded]] kann für geerbte Formulare mehrere Male aufgerufen werden. Sie wird jedes Mal aufgerufen, wenn eine Vererbungsebene eingelesen wird. Weisen Sie in einer überschriebenen [[System.Classes.TComponent.Loaded|Loaded]]-Methode keinen Speicher zu, ohne vorher zu überprüfen, ob der Speicher nicht bereits bei einem früheren Aufruf zugewiesen wurde.}}

===Siehe auch===

* [[System.Classes.TComponent.ComponentState]]

* [[System.Classes.TComponent.Create]]

* [[System.Classes.TReader]]

[[Category:API-Dokumentation]]

System.Bindings.CustomScope.TCustomScope

2021-07-07T01:04:39Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.Bindings.CustomScope.TCustomScope|api}}
==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Bindings.CustomScope.TCustomScope | |{{InheritsFrom|System.Bindings.CustomScope.TCustomScope}}}}

<section begin="short" />Basisklasse für alle Nachkommen eines benutzerdefinierten Gültigkeitsbereichs.<section end="short" />

[[System.Bindings.CustomScope.TCustomScope|TCustomScope]] ist eine abstrakte Klasse, die die Basisklasse für alle Nachkommen eines benutzerdefinierten Gültigkeitsbereichs repräsentiert. Ein benutzerdefinierter Gültigkeitsbereich ermöglicht das Einfügen neuer Member (Eigenschaften und/oder Methoden), die in einem bereits vorhandenen Objekt nicht vorhanden werden. Dadurch können diese neuen Member in einem Ausdruck verwendet werden.

{{Tip| Alle Nachkommen der Klasse [[System.Bindings.CustomScope.TCustomScope|TCustomScope]] '''müssen''' die Methode [[System.Bindings.CustomScope.TCustomScope.DoLookup|DoLookup]] implementieren.}}

===Siehe auch===

* [[System.Bindings.CustomScope.TScopeClass]]
* [[System.Bindings.CustomScope.TCustomScope.DoLookup]]
* [[Data.Bind.DBScope.TBindDataSetScope]]
[[Category:API-Dokumentation]]
[[Category:XE2]]

System.AcquireExceptionObject

2021-07-06T23:46:03Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.AcquireExceptionObject|api}}

==Beschreibung==
<section begin=short />Behält den Zugriff auf ein Exception-Objekt bei.<section end=short />

[[System.AcquireExceptionObject|AcquireExceptionObject]] gibt einen '''TObject''' auf das aktuelle Exception-Objekt zurück und verhindert, dass es aus dem Speicher freigegeben wird, wenn die aktuelle Exception-Behandlungsroutine beendet ist.

{{Note| [[System.AcquireExceptionObject|AcquireExceptionObject]] inkrementiert den Referenzzähler des Exception-Objekts. Stellen Sie sicher, dass der Referenzzähler dekrementiert wird, wenn das Exception-Objekt nicht mehr gebraucht wird. Dies geschieht automatisch, wenn Sie mit dem Exception-Objekt die Exception erneut auslösen In allen anderen Fällen muss für jeden Aufruf von [[System.AcquireExceptionObject|AcquireExceptionObject]] ein zugehöriger Aufruf von [[System.ReleaseExceptionObject|ReleaseExceptionObject]] vorhanden sein. [[System.AcquireExceptionObject|AcquireExceptionObject]]/ReleaseExceptionObject-Aufrufe können auch verschachtelt werden.}}

===Siehe auch===

* [[System.ReleaseExceptionObject|ReleaseExceptionObject]]

* [[System.ExceptObject|ExceptObject]]

[[Category:API-Dokumentation]]


=== Codebeispiele ===
*[[samp_en:ExceptionHandling (Delphi)|ExceptionHandling (Delphi)]]

System.SysUtils.TByteHelper.ToHexString

2021-06-24T23:44:59Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.SysUtils.TByteHelper.ToHexString|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | System.SysUtils.TByteHelper.ToHexString | |{{InheritsFrom|System.SysUtils.TByteHelper.ToHexString}}}}

<section begin="short" />Konvertiert [[System.Byte|Byte]] in einen hexadezimalen String.<section end="short" />

Diese Methode ist überladen:

* Die erste überladene Methode [[System.SysUtils.TByteHelper.ToHexString|ToHexString]] konvertiert diese [[System.Byte|Byte]]-Zahl in eine hexadezimale String-Repräsentation mit 2 hexadezimalen Ziffern.
* Die zweite überladene Methode [[System.SysUtils.TByteHelper.ToHexString|ToHexString]] konvertiert diese [[System.Byte|Byte]]-Zahl in einen hexadezimalen String mit mindestens der Anzahl von hexadezimalen Ziffern, die im Parameter <code>MinDigits</code> angegeben sind.

{{Note| Einzelheiten zur Verarbeitung der Konvertierung finden Sie bei der Beschreibung von [[System.SysUtils.IntToHex|IntToHex]]. }}

===Siehe auch===

* [[System.Byte|System.Byte]]
* [[System.SysUtils.IntToHex|System.SysUtils.IntToHex]]

[[Category:API-Dokumentation]]
[[Category:XE4]]

FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter

2021-06-09T15:10:58Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter | |{{InheritsFrom|FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter}}}}

<section begin="short" />Mit [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|TFDBatchMoveSQLWriter]] wird eine direkte Verbindung zu einem DBMS über eine [[FireDAC.Comp.Client.TFDConnection|TFDConnection]]-Komponente hergestellt.<section end="short" />

Mit [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|TFDBatchMoveSQLWriter]] stellen Sie eine Verbindung zu dem DBMS her, in das die Daten mit [[FireDAC.Comp.BatchMove.TFDBatchMove|TFDBatchMove]] kopiert werden sollen.

Der Hauptunterschied zwischen [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|TFDBatchMoveSQLWriter]] und [[FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetWriter|TFDBatchMoveDataSetWriter]] ist, dass der [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|TFDBatchMoveSQLWriter]] das FireDAC-ArrayDML-Feature verwendet und die maximal mögliche Geschwindigkeit beim Schreiben von Daten bietet.

Legen Sie den Namen einer Zieltabelle in der Eigenschaft [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.TableName|TableName]] fest. Statt [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.TableName|TableName]] können Sie eine SQL-Abfrage festlegen und dabei die Zieldatenstruktur in der Eigenschaft [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.ReadSQL|ReadSQL]] und die SQL-Schreibabfrage in der Eigenschaft [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter.WriteSQL|WriteSQL]] angeben. Optional können Sie [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter.GeneratorName|GeneratorName]] festlegen, um einen Datenbankgenerator/Sequenznamen zum Füllen der Auto-Inkrementierungsfelder vorzusehen.

{{Note| Die Eigenschaften [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.TableName|TableName]] und [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.ReadSQL|ReadSQL]] können nicht gleichzeitig verwendet werden.}}

Legen Sie [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|TFDBatchMoveSQLWriter]] als [[FireDAC.Comp.BatchMove.TFDBatchMove.Writer|Writer]] von [[FireDAC.Comp.BatchMove.TFDBatchMove|TFDBatchMove]] fest.

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

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

In den Modi '''dmAppend''', '''dmUpdate''', '''dmAppendUpdate''' und '''dmDelete''' muss die Zieltabelle einen Primärschlüssel enthalten.

===Siehe auch===

* [[Samp_en:FireDAC.TFDBatchMove Sample|FireDAC.TFDBatchMove (Beispiel)]]
* [[FireDAC.Comp.BatchMove.TFDBatchMove|FireDAC.Comp.BatchMove.TFDBatchMove]]
* [[FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextReader|FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextReader]]
* [[FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextWriter|FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextWriter]]
* [[FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetReader|FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetReader]]
* [[FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetWriter|FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetWriter]]
* [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader|FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader]]

[[Category:API-Dokumentation]]
[[Category:XE7]]

FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader

2021-06-09T13:38:34Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader | |{{InheritsFrom|FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader}}}}

<section begin="short" />Mit [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader|TFDBatchMoveSQLReader]] wird eine direkte Verbindung zu einem DBMS über eine [[FireDAC.Comp.Client.TFDConnection|TFDConnection]]-Komponente hergestellt.<section end="short" />

Mit [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader|TFDBatchMoveSQLReader]] stellen Sie eine Verbindung zu dem DBMS her, das die Daten enthält, die mit [[FireDAC.Comp.BatchMove.TFDBatchMove|TFDBatchMove]] kopiert werden sollen.

Legen Sie den Namen der Quelltabelle in der Eigenschaft [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.TableName|TableName]] fest, oder legen Sie in der Eigenschaft [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.ReadSQL|ReadSQL]] eine SQL-Abfrage fest, die die Quelldaten zurückgibt.

{{Note| [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.TableName|TableName]] und [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLDriver.ReadSQL|ReadSQL]] können nicht gleichzeitig verwendet werden. }}

Legen Sie [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLReader|TFDBatchMoveSQLReader]] als [[FireDAC.Comp.BatchMove.TFDBatchMove.Reader|Reader]]-Eigenschaft von [[FireDAC.Comp.BatchMove.TFDBatchMove|TFDBatchMove]] fest.

===Siehe auch===

* [[samp_en:FireDAC.TFDBatchMove Sample|TFDBatchMove (Beispiel)]]
* [[FireDAC.Comp.BatchMove.TFDBatchMove|FireDAC.Comp.BatchMove.TFDBatchMove]]
* [[FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextReader|FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextReader]]
* [[FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextWriter|FireDAC.Comp.BatchMove.Text.TFDBatchMoveTextWriter]]
* [[FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetReader|FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetReader]]
* [[FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetWriter|FireDAC.Comp.BatchMove.DataSet.TFDBatchMoveDataSetWriter]]
* [[FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter|FireDAC.Comp.BatchMove.SQL.TFDBatchMoveSQLWriter]]

[[Category:API-Dokumentation]]
[[Category:XE7]]

FMX.Controls.TControl.OnPainting

2021-05-10T19:44:20Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnPainting|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnPainting | |{{InheritsFrom|FMX.Controls.TControl.OnPainting}}}}

<section begin="short" />Wird beim Zeichnen des Steuerelements ausgelöst. <section end="short" />

[[FMX.Controls.TControl.OnPainting|OnPainting]] wird auch beim Aufrufen von [[FMX.Controls.TControl.Painting|Painting]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnPainting|OnPainting]] ändern Sie die Art, in der das Steuerelement gezeichnet wird.

===Siehe auch===
* [[FMX.Controls.TOnPaintEvent]]
*[[FMX.Controls.TControl.Painting|FMX.Controls.TControl.Painting]]
*[[FMX.Controls.TControl.OnPaint|FMX.Controls.TControl.OnPaint]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnPaint

2021-05-10T18:28:16Z

Fabiola.Arias: Added the {{Tip|}} template

{{#lst:API:FMX.Controls.TControl.OnPaint|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnPaint | |{{InheritsFrom|FMX.Controls.TControl.OnPaint}}}}

<section begin="short" />Wird beim Neuzeichnen des Steuerelements ausgelöst. <section end="short" />

[[FMX.Controls.TControl.OnPaint|OnPaint]] wird auch ausgelöst, wenn [[FMX.Controls.TControl.DoPaint|DoPaint]] auf gerufen wird.

Mit der Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnPaint|OnPaint]] kann die Art und Weise geändert werden, in der das Steuerelement gerendert wird.

{{Tip| Beachten Sie bitte, dass der Aufruf von [[FMX.Graphics.TCanvas.BeginScene|BeginScene]] in der Ereignisbehandlungsroutine [[FMX.Forms.TCustomForm.OnPaint|OnPaint]] wirkungslos ist, weil [[FMX.Graphics.TCanvas.BeginScene|BeginScene]] vor der Ausführung der Ereignisbehandlungsroutine [[FMX.Forms.TCustomForm.OnPaint|OnPaint]] aufgerufen wird. Damit wird sichergestellt, dass das Zeichnen immer in [[FMX.Forms.TCustomForm.OnPaint|OnPaint]] ausgeführt wird, ohne dass zusätzlicher und möglicherweise unerwarteter Code zum Zeichnen verwendet werden muss.}}

===Siehe auch===

* [[FMX.Controls.TOnPaintEvent|FMX.Controls.TOnPaintEvent]]
* [[FMX.Controls.TControl.DoPaint|FMX.Controls.TControl.DoPaint]]
* [[FMX.Controls.TControl.OnPainting|FMX.Controls.TControl.OnPainting]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnPaint

2021-05-10T18:27:57Z

Fabiola.Arias: Added the {{Tip|}} template

{{#lst:API:FMX.Controls.TControl.OnPaint|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnPaint | |{{InheritsFrom|FMX.Controls.TControl.OnPaint}}}}

<section begin="short" />Wird beim Neuzeichnen des Steuerelements ausgelöst. <section end="short" />

[[FMX.Controls.TControl.OnPaint|OnPaint]] wird auch ausgelöst, wenn [[FMX.Controls.TControl.DoPaint|DoPaint]] auf gerufen wird.

Mit der Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnPaint|OnPaint]] kann die Art und Weise geändert werden, in der das Steuerelement gerendert wird.

{{Note| Beachten Sie bitte, dass der Aufruf von [[FMX.Graphics.TCanvas.BeginScene|BeginScene]] in der Ereignisbehandlungsroutine [[FMX.Forms.TCustomForm.OnPaint|OnPaint]] wirkungslos ist, weil [[FMX.Graphics.TCanvas.BeginScene|BeginScene]] vor der Ausführung der Ereignisbehandlungsroutine [[FMX.Forms.TCustomForm.OnPaint|OnPaint]] aufgerufen wird. Damit wird sichergestellt, dass das Zeichnen immer in [[FMX.Forms.TCustomForm.OnPaint|OnPaint]] ausgeführt wird, ohne dass zusätzlicher und möglicherweise unerwarteter Code zum Zeichnen verwendet werden muss.}}

===Siehe auch===

* [[FMX.Controls.TOnPaintEvent|FMX.Controls.TOnPaintEvent]]
* [[FMX.Controls.TControl.DoPaint|FMX.Controls.TControl.DoPaint]]
* [[FMX.Controls.TControl.OnPainting|FMX.Controls.TControl.OnPainting]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnMouseWheel

2021-05-10T18:07:39Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnMouseWheel|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnMouseWheel | |{{InheritsFrom|FMX.Controls.TControl.OnMouseWheel}}}}

<section begin="short" />Wird ausgelöst, wenn das Mausrad bewegt wird, während das Steuerelement den Fokus besitzt.<section end="short" />

[[FMX.Controls.TControl.OnMouseWheel|OnMouseWheel]] wird auch beim Aufrufen von [[FMX.Controls.TControl.MouseWheel|MouseWheel]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnMouseWheel|OnMouseWheel]] geben Sie an, was passiert, wenn das Mausrad bewegt wird, während das Steuerelement den Fokus besitzt.

===Siehe auch===
* [[FMX.Types.TMouseWheelEvent]]
*[[FMX.Controls.TControl.MouseWheel|FMX.Controls.TControl.MouseWheel]]
*[[FMX.Controls.TControl.OnMouseLeave|FMX.Controls.TControl.OnMouseLeave]]
*[[FMX.Controls.TControl.OnMouseUp|FMX.Controls.TControl.OnMouseUp]]
*[[FMX.Controls.TControl.OnMouseEnter|FMX.Controls.TControl.OnMouseEnter]]
*[[FMX.Controls.TControl.OnMouseDown|FMX.Controls.TControl.OnMouseDown]]
*[[FMX.Controls.TControl.OnMouseMove|FMX.Controls.TControl.OnMouseMove]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnMouseUp

2021-05-10T16:36:44Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnMouseUp|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnMouseUp | |{{InheritsFrom|FMX.Controls.TControl.OnMouseUp}}}}

<section begin="short" />Wird ausgelöst, wenn die Maustaste, die auf dem Steuerelement gedrückt wurde, losgelassen wird. <section end="short" />

[[FMX.Controls.TControl.OnMouseUp|OnMouseUp]] wird auch beim Aufrufen von [[FMX.Controls.TControl.MouseUp|MouseUp]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnMouseUp|OnMouseUp]] geben Sie an, was passiert, wenn die Maustaste, die auf dem Steuerelement gedrückt wurde, losgelassen wird.

===Siehe auch===
* [[FMX.Types.TMouseEvent]]
*[[FMX.Controls.TControl.MouseUp|FMX.Controls.TControl.MouseUp]]
*[[FMX.Controls.TControl.OnMouseLeave|FMX.Controls.TControl.OnMouseLeave]]
*[[FMX.Controls.TControl.OnMouseEnter|FMX.Controls.TControl.OnMouseEnter]]
*[[FMX.Controls.TControl.OnMouseMove|FMX.Controls.TControl.OnMouseMove]]
*[[FMX.Controls.TControl.OnMouseDown|FMX.Controls.TControl.OnMouseDown]]
*[[FMX.Controls.TControl.OnMouseWheel|FMX.Controls.TControl.OnMouseWheel]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnMouseMove

2021-05-10T16:20:30Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnMouseMove|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnMouseMove | |{{InheritsFrom|FMX.Controls.TControl.OnMouseMove}}}}

<section begin="short" />Wird ausgelöst, wenn der Mauszeiger auf dem Bereich des Steuerelements bewegt wird.<section end="short" />

[[FMX.Controls.TControl.OnMouseMove|OnMouseMove]] wird auch beim Aufrufen von [[FMX.Controls.TControl.MouseMove|MouseMove]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnMouseMove|OnMouseMove]] geben Sie an, was passiert, wenn der Mauszeiger auf dem Bereich des Steuerelements bewegt wird.

===Siehe auch===
* [[FMX.Types.TMouseMoveEvent]]
*[[FMX.Controls.TControl.MouseMove|FMX.Controls.TControl.MouseMove]]
*[[FMX.Controls.TControl.OnMouseLeave|FMX.Controls.TControl.OnMouseLeave]]
*[[FMX.Controls.TControl.OnMouseUp|FMX.Controls.TControl.OnMouseUp]]
*[[FMX.Controls.TControl.OnMouseEnter|FMX.Controls.TControl.OnMouseEnter]]
*[[FMX.Controls.TControl.OnMouseDown|FMX.Controls.TControl.OnMouseDown]]
*[[FMX.Controls.TControl.OnMouseWheel|FMX.Controls.TControl.OnMouseWheel]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnMouseDown

2021-05-10T16:12:14Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnMouseDown|api}}
==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnMouseDown | |{{InheritsFrom|FMX.Controls.TControl.OnMouseDown}}}}

<section begin=short />Wird ausgelöst, wenn eine Maustaste auf einem Steuerelement gedrückt wird. <section end=short />

[[FMX.Controls.TControl.OnMouseDown|OnMouseDown]] wird auch beim Aufruf von [[FMX.Controls.TControl.MouseDown|MouseDown]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnMouseDown|OnMouseDown]] können Sie angeben, welche Aktionen durchgeführt werden sollen, wenn eine Maustaste auf einem Steuerelement gedrückt wird.

===Siehe auch===
* [[FMX.Types.TMouseEvent]]
* [[FMX.Controls.TControl.MouseDown]]
* [[FMX.Controls.TControl.OnMouseLeave]]
* [[FMX.Controls.TControl.OnMouseEnter]]
* [[FMX.Controls.TControl.OnMouseMove]]
* [[FMX.Controls.TControl.OnMouseUp]]
* [[FMX.Controls.TControl.OnMouseWheel]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnKeyUp

2021-05-10T16:04:52Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnKeyUp|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnKeyUp | |{{InheritsFrom|FMX.Controls.TControl.OnKeyUp}}}}

<section begin=short />Wird ausgelöst, wenn eine Taste losgelassen wird, während das Steuerelement den Fokus hat.<section end=short />

[[FMX.Controls.TControl.OnKeyUp|OnKeyUp]] wird auch beim Aufruf von [[FMX.Controls.TControl.KeyUp|KeyUp]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnKeyUp|OnKeyUp]] können Sie angeben, welche Aktionen durchgeführt werden sollen, wenn das Steuerelement den Fokus hat und eine Taste losgelassen wird.

===Siehe auch===
* [[FMX.Types.TKeyEvent]]
* [[FMX.Controls.TControl.KeyUp]]
* [[FMX.Controls.TControl.OnKeyDown]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnDragEnter

2021-05-10T15:53:15Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnDragEnter|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnDragEnter | |{{InheritsFrom|FMX.Controls.TControl.OnDragEnter}}}}

<section begin=short />Wird ausgelöst, wenn ein Objekt im Bereich des aktuellen Steuerelements gezogen wird.<section end=short />

[[FMX.Controls.TControl.OnDragEnter|OnDragEnter]] wird auch beim Aufruf von [[FMX.Controls.TControl.DragEnter|DragEnter]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnDragEnter|OnDragEnter]] können Sie angeben, welche Auswirkungen das Ziehen eines Objekts im Bereich des aktuellen Steuerelements hat.

===Siehe auch===
* [[FMX.Types.TDragEnterEvent]]
* [[FMX.Controls.TControl.DragEnter]]
* [[FMX.Controls.TControl.OnDragDrop]]
* [[FMX.Controls.TControl.OnDragEnd]]
* [[FMX.Controls.TControl.OnDragLeave]]
* [[FMX.Controls.TControl.OnDragOver]]
* [[FMX.Types.TDragObject]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnDragDrop

2021-05-10T15:35:17Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnDragDrop|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnDragDrop | |{{InheritsFrom|FMX.Controls.TControl.OnDragDrop}}}}

<section begin=short />Wird beim Ablegen eines gezogenen Steuerelements ausgelöst.<section end=short />

[[FMX.Controls.TControl.OnDragDrop|OnDragDrop]] wird auch beim Aufruf von [[FMX.Controls.TControl.DragDrop|DragDrop]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnDragDrop|OnDragDrop]] können Sie angeben, welche Auswirkungen das Ablegen eines gezogenen Steuerelements hat.

===Siehe auch===
* [[FMX.Types.TDragDropEvent]]
* [[FMX.Controls.TControl.DragDrop]]
* [[FMX.Controls.TControl.OnDragEnd]]
* [[FMX.Controls.TControl.OnDragEnter]]
* [[FMX.Controls.TControl.OnDragLeave]]
* [[FMX.Controls.TControl.OnDragOver]]
* [[FMX.Types.TDragObject]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnCanFocus

2021-05-10T15:21:34Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnCanFocus|api}}
==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnCanFocus | |{{InheritsFrom|FMX.Controls.TControl.OnCanFocus}}}}

<section begin=short />Wird ausgelöst, wenn ein Steuerelement den Fokus erhalten kann.<section end=short />

[[FMX.Controls.TControl.SetFocus|SetFocus]] ist eine Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnCanFocus|OnCanFocus]].

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnCanFocus|OnCanFocus]] können Sie das Verhalten anpassen, wenn das Steuerelement Fokus erhielt.

===Siehe auch===
* [[FMX.Types.TCanFocusEvent]]
*[[FMX.Controls.TControl.SetFocus]]

[[Category: API-Dokumentation]]
[[Category:XE2]]

FMX.Controls.TControl.OnMouseLeave

2021-05-10T14:33:20Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnMouseLeave|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnMouseLeave | |{{InheritsFrom|FMX.Controls.TControl.OnMouseLeave}}}}

<section begin="short" />Wird ausgelöst, wenn der Mauszeiger aus dem Bereich des Steuerelements gezogen wird.<section end="short" />

[[FMX.Controls.TControl.OnMouseLeave|OnMouseLeave]] wird auch beim Aufrufen von [[FMX.Controls.TControl.DoMouseLeave|DoMouseLeave]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnMouseLeave|OnMouseLeave]] geben Sie an, was passiert, wenn der Mauszeiger aus dem Bereich des Steuerelements gezogen wird.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
*[[FMX.Controls.TControl.DoMouseLeave|FMX.Controls.TControl.DoMouseLeave]]
*[[FMX.Controls.TControl.OnMouseEnter|FMX.Controls.TControl.OnMouseEnter]]
*[[FMX.Controls.TControl.OnMouseUp|FMX.Controls.TControl.OnMouseUp]]
*[[FMX.Controls.TControl.OnMouseMove|FMX.Controls.TControl.OnMouseMove]]
*[[FMX.Controls.TControl.OnMouseDown|FMX.Controls.TControl.OnMouseDown]]
*[[FMX.Controls.TControl.OnMouseWheel|FMX.Controls.TControl.OnMouseWheel]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnMouseEnter

2021-05-10T14:23:23Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnMouseEnter|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnMouseEnter | |{{InheritsFrom|FMX.Controls.TControl.OnMouseEnter}}}}

<section begin=short />Wird ausgelöst, wenn der Mauszeiger über den Bereich des Steuerelements bewegt wird.<section end=short />

[[FMX.Controls.TControl.OnMouseEnter|OnMouseEnter]] wird auch beim Aufruf von [[FMX.Controls.TControl.DoMouseEnter|DoMouseEnter]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnMouseEnter|OnMouseEnter]] können Sie angeben, welche Aktionen durchgeführt werden sollen, wenn der Mauszeiger über den Bereich des Steuerelements bewegt wird.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
* [[FMX.Controls.TControl.DoMouseEnter]]
* [[FMX.Controls.TControl.OnMouseLeave]]
* [[FMX.Controls.TControl.OnMouseUp]]
* [[FMX.Controls.TControl.OnMouseMove]]
* [[FMX.Controls.TControl.OnMouseDown]]
* [[FMX.Controls.TControl.OnMouseWheel]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnExit

2021-05-10T13:53:23Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:FMX.Controls.TControl.OnExit|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnExit | |{{InheritsFrom|FMX.Controls.TControl.OnExit}}}}

<section begin="short" />Wird ausgelöst, wenn das Steuerelement den Eingabefokus verliert.<section end="short" />

[[FMX.Controls.TControl.OnExit|OnExit]] wird auch ausgelöst, wenn [[FMX.Controls.TControl.DoExit|DoExit]] auf gerufen wird.

In einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnExit|OnExit]] können Sie die Aktionen angeben, die ausgeführt werden sollen, wenn das Steuerelement den Eingabefokus verliert.

{{Note| Beispielsweise können Sie in einem [[FMX.Edit.TEdit|TEdit]]-Steuerelement festlegen, dass der Benutzer das Steuerelement erst verlassen kann, wenn ein bestimmter Wert eingegeben wurde. Der Code dafür sieht folgendermaßen aus:

<blockquote><source lang<nowiki> = </nowiki>"delphi">
procedure TForm1.Edit1Exit(Sender: TObject);
begin
if Edit1.Text <> 'Hello' then
Edit1.Abort;
end;
</source></blockquote>

Beachten Sie, dass Code wie {{Code|Edit1.SetFocus;}} nicht den erwarteten Effekt hat.}}

===Siehe auch===

* [[System.Classes.TNotifyEvent|System.Classes.TNotifyEvent]]
* [[FMX.Controls.TControl.DoExit|FMX.Controls.TControl.DoExit]]
* [[FMX.Controls.TControl.OnEnter|FMX.Controls.TControl.OnEnter]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnEnter

2021-05-10T12:32:27Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnEnter|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnEnter | |{{InheritsFrom|FMX.Controls.TControl.OnEnter}}}}

<section begin=short />Wird ausgelöst, wenn das Steuerelement den Eingabefokus erhält.<section end=short />

[[FMX.Controls.TControl.OnEnter|OnEnter]] wird auch beim Aufruf von [[FMX.Controls.TControl.DoEnter|DoEnter]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnEnter|OnEnter]] können Sie angeben, welche Aktionen durchgeführt werden, wenn das Steuerelement den Eingabefokus erhält.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
* [[FMX.Controls.TControl.DoEnter]]
* [[FMX.Controls.TControl.OnExit]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnDragLeave

2021-05-08T05:07:04Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnDragLeave|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnDragLeave | |{{InheritsFrom|FMX.Controls.TControl.OnDragLeave}}}}

<section begin=short />Wird ausgelöst, wenn ein Objekt aus dem Bereich des aktuellen Steuerelements gezogen wird.<section end=short />

[[FMX.Controls.TControl.OnDragLeave|OnDragLeave]] wird auch beim Aufruf von [[FMX.Controls.TControl.DragLeave|DragLeave]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnDragLeave|OnDragLeave]] können Sie angeben, welche Aktionen durchgeführt werden, wenn ein Objekt aus dem Bereich des aktuellen Steuerelements gezogen wird.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
*[[FMX.Controls.TControl.DragLeave]]
*[[FMX.Controls.TControl.OnDragDrop]]
*[[FMX.Controls.TControl.OnDragEnd]]
*[[FMX.Controls.TControl.OnDragEnter]]
*[[FMX.Controls.TControl.OnDragOver]]
*[[FMX.Types.TDragObject]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnDragEnd

2021-05-08T05:00:00Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnDragEnd|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnDragEnd | |{{InheritsFrom|FMX.Controls.TControl.OnDragEnd}}}}

<section begin=short />Wird ausgelöst, wenn das Ziehen eines Steuerelements beendet wird.<section end=short />

Das Ziehen kann entweder beim Ablegen des Steuerelements oder beim Abbrechen des Ablegens beendet werden.

[[FMX.Controls.TControl.OnDragEnd|OnDragEnd]] wird auch beim Aufrufen von [[FMX.Controls.TControl.DragEnd|DragEnd]] ausgelöst.

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnDragEnd|OnDragEnd]] können Sie angeben, welche Aktion beim Beenden des Ziehens ausgeführt wird.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
* [[FMX.Controls.TControl.DragEnd]]
* [[FMX.Controls.TControl.OnDragDrop]]
* [[FMX.Controls.TControl.OnDragEnter]]
* [[FMX.Controls.TControl.OnDragLeave]]
* [[FMX.Controls.TControl.OnDragOver]]
* [[FMX.Types.TDragObject]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnDeactivate

2021-05-08T04:52:50Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnDeactivate|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnDeactivate | |{{InheritsFrom|FMX.Controls.TControl.OnDeactivate}}}}

<section begin="short" />Wird ausgelöst, wenn das Fenster, in dem sich das Steuerelement befindet, keinen Fokus hat, während dieses Steuerelement oder einer seiner Nachkommen [[FMX.Controls.TControl.IsFocused|den Fokus hat]].<section end="short" /> Ein Nachkomme kann ein [[FMX.Controls.TControl.Controls|untergeordnetes Objekt]], ein Enkel usw. sein.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
*[[FMX.Controls.TControl.OnActivate|FMX.Controls.TControl.OnActivate]]

*[[FMX.Controls.TControl.IsFocused|FMX.Controls.TControl.IsFocused]]
*[[FMX.Controls.TControl.Controls|FMX.Controls.TControl.Controls]]

[[Category:API-Dokumentation]]
[[Category:FMX]]
[[Category:XE5]]

FMX.Controls.TControl.OnDblClick

2021-05-08T04:45:18Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnDblClick|api}}
==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnDblClick | |{{InheritsFrom|FMX.Controls.TControl.OnDblClick}}}}

<section begin="short" />Wird beim Doppelklicken auf die linke Maustaste ausgelöst, während sich der Mauszeiger über das Steuerelement befindet. <section end="short" />

[[FMX.Controls.TControl.OnDblClick|OnDblClick]] wird auch beim Aufruf von [[FMX.Controls.TControl.DblClick|DblClick]] ausgelöst.

Für Steuerelemente (wie z.B. [[FMX.StdCtrls.TLabel|TLabel]] und [[FMX.StdCtrls.TPathLabel|TPathLabel]]), deren Eigenschaft [[FMX.Controls.TControl.HitTest|HitTest]] standardmäßig auf '''False''' gesetzt ist, werden die Mausereignisse [[FMX.Controls.TControl.OnClick|OnClick]] und [[FMX.Controls.TControl.OnDblClick|OnDblClick]] an das Steuerelement hinter dem aktuellen übergeben.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
* [[FMX.Controls.TControl.DblClick]]
* [[FMX.Controls.TControl.OnClick]]
* [[FMX.Controls.TControl.HitTest]]

[[Category:XE2]]
[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnClick

2021-05-08T04:38:18Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnClick|api}}
==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnClick | |{{InheritsFrom|FMX.Controls.TControl.OnClick}}}}

<section begin="short" />Wird beim Klicken auf das Steuerelement ausgelöst.<section end="short" />

Für Steuerelemente (wie z.B. [[FMX.StdCtrls.TLabel|TLabel]] und [[FMX.StdCtrls.TPathLabel|TPathLabel]]), deren Eigenschaft [[FMX.Controls.TControl.HitTest|HitTest]] standardmäßig auf '''False''' gesetzt ist, werden die Mausereignisse [[FMX.Controls.TControl.OnClick|OnClick]] und [[FMX.Controls.TControl.OnDblClick|OnDblClick]] an das Steuerelement hinter dem aktuellen übergeben.

Das Ereignis [[FMX.Controls.TControl.OnClick|OnClick]] wird normalerweise beim Drücken und Loslassen der linken Maustaste ausgelöst, wenn sich der Mauszeiger auf dem Steuerelement befindet oder wenn [[FMX.Controls.TControl.Click|Click]] aufgerufen wird.

Für Schaltflächensteuerelemente wird das Ereignis [[FMX.Controls.TControl.OnClick|OnClick]] auch ausgelöst, wenn das Steuerelement den Fokus hat und die Leer- oder die Eingabetaste gedrückt werden.

Für Steuerelemente mit Status, wie z.B. [[FMX.StdCtrls.TRadioButton|TRadioButton]] und [[FMX.StdCtrls.TCheckBox|TCheckBox]], wird den Status von [[FMX.Controls.TControl.OnClick|OnClick]] nicht geändert (die Eigenschaft '''IsChecked''' wird nicht geändert).

[[FMX.Controls.TControl.OnClick|OnClick]] kann nicht für Formulare verwendet werden.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
* [[FMX.Controls.TControl.Click]]
* [[FMX.Controls.TControl.OnDblClick]]
* [[FMX.Controls.TControl.HitTest]]

[[Category:API-Dokumentation]]

FMX.Controls.TControl.OnApplyStyleLookup

2021-05-08T01:56:01Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnApplyStyleLookup|api}}

==Beschreibung==

{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnApplyStyleLookup | |{{InheritsFrom|FMX.Controls.TControl.OnApplyStyleLookup}}}}

<section begin=short />Wird ausgelöst, wenn ein Stil auf das Steuerelement angewendet wird.<section end=short />

Mit einer Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnApplyStyleLookup|OnApplyStyleLookup]] können Sie das Anwenden eines Stils anpassen.

[[FMX.Controls.TStyledControl.ApplyStyleLookup|ApplyStyleLookup]] ist eine Ereignisbehandlungsroutine für [[FMX.Controls.TControl.OnApplyStyleLookup|OnApplyStyleLookup]]. Überschreiben Sie diese Methode, um das Anwenden eines Stils anzupassen.

[[FMX.Controls.TControl.OnApplyStyleLookup|OnApplyStyleLookup]] wird für [[FMX.Controls.TStyledControl|mit Stilen ausgestattete Steuerelemente]] verwendet.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
*[[FMX.Controls.TStyledControl]]
*[[FMX.Controls.TStyledControl.ApplyStyleLookup]]

[[Category: API-Dokumentation]]
[[Category: XE2]]

FMX.Controls.TControl.OnActivate

2021-05-07T16:46:40Z

Fabiola.Arias: RS-78348

{{#lst:API:FMX.Controls.TControl.OnActivate|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | FMX.Controls.TControl.OnActivate | |{{InheritsFrom|FMX.Controls.TControl.OnActivate}}}}

<section begin="short" />Wird ausgelöst, wenn das Fenster, in dem sich das Steuerelement befindet, den Fokus erhält und das Steuerelement des Fensters [[FMX.Controls.TControl.IsFocused|mit dem Fokus]], entweder das Steuerelement selbst oder einer seiner Nachkommen ist.<section end="short" /> Ein Nachkomme kann ein [[FMX.Controls.TControl.Controls|untergeordnetes Objekt]], ein Enkel usw. sein.

===Siehe auch===
* [[System.Classes.TNotifyEvent]]
*[[FMX.Controls.TControl.OnDeactivate|FMX.Controls.TControl.OnDeactivate]]

*[[FMX.Controls.TControl.IsFocused|FMX.Controls.TControl.IsFocused]]
*[[FMX.Controls.TControl.Controls|FMX.Controls.TControl.Controls]]

[[Category:API-Dokumentation]]
[[Category:FMX]]
[[Category:XE5]]

System.Classes.TFiler

2021-02-26T14:52:51Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.Classes.TFiler|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Classes.TFiler | |{{InheritsFrom|System.Classes.TFiler}}}}

<section begin=short />[[System.Classes.TFiler|TFiler]] ist die abstrakte Basisklasse für Reader- und Writer-Objekte, die für das Laden und Speichern von Komponenten und deren Eigenschaften verwendet werden.<section end=short />

[[System.Classes.TFiler|TFiler]] arbeitet mit Stream- und Komponenten-Objekten. Es verwaltet die internen Mechanismen des Streaming-Systems, das zum Lesen und Schreiben von Komponenten und der damit verknüpften Daten verwendet wird. Das Streaming-System ist der Mechanismus, mit dem die IDE Komponenten auf der Festplatte speichert oder Komponenten aus Formulardateien liest sowie Bilder der Komponenten temporär im Arbeitsspeicher speichert und wiederherstellt.

[[System.Classes.TFiler|TFiler]] hat zwei Nachkommen, [[System.Classes.TReader|TReader]] und [[System.Classes.TWriter|TWriter]], die die im Filer-Objekt definierten Methoden implementieren. Der Filer-Typ wird als Parameter für Komponentenmethoden verwendet, die für Stream-Operationen ein Reader- oder Writer-Objekt benötigen. Jedes Filer-Objekt verfügt über einen verbundenen Stream, der als Parameter an seinen Konstruktor übergeben wird. Dieses verbundene Stream-Objekt ist üblicherweise für die Erstellung von Filer-Objekten verantwortlich.

Mit den Eigenschaften können Stream-Operationen für [[System.Classes.TFiler|TFiler]] untergeordnete Komponenten verwaltet werden. Mit Hilfe von Filer-Objekten werden Eigenschaften von Komponenten aus einem Stream gelesen bzw. in diesen geschrieben. Filer-Objekte puffern zur Beschleunigung der Lese- und Schreiboperationen Daten.

[[System.Classes.TFiler|TFiler]] besitzt abstrakte Methoden, die in den untergeordneten Reader- und Writer-Objekten angepasst werden. Dazu gehören Methoden, mit denen verborgene oder komplexe Daten wie die Eigenschaften eines Objekts geladen und gespeichert werden können.

{{Note| Die meisten Eigenschaften und Methoden von TFiler sind im Streaming-System aus Gründen des Komforts als public deklariert. Die Mehrheit der Eigenschaften und Methoden wird niemals direkt in einer Anwendung aufgerufen.}}

===Siehe auch===

* [[System.Classes.TComponent|TComponent]]

* [[System.Classes.TReader|TReader]]

* [[System.Classes.TStream|TStream]]

* [[System.Classes.TWriter|TWriter]]

* [[rad_de:Mit Streams Daten lesen und schreiben|Mit Streams Daten lesen und schreiben]]

[[Category:API-Dokumentation]]

System.Classes.TComponent

2021-02-24T01:53:47Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:System.Classes.TComponent|api}}
==Beschreibung==
{{#ifeq: {{PAGENAME}} | System.Classes.TComponent | |{{InheritsFrom|System.Classes.TComponent}}}}

<section begin="short" />
[[System.Classes.TComponent|TComponent]] ist der gemeinsame Vorfahre aller Komponentenklassen.<section end="short" />

[[System.Classes.TComponent|TComponent]] ist die Basisklasse für alle Komponenten. Komponenten sind persistente Objekte, die folgende Möglichkeiten bieten:
* IDE-Integration. Sie können in einer IDE-Palette angezeigt und in einem '''Formular-Designer''' bearbeitet werden.
* Eigentümerschaft. Sie können andere Komponenten verwalten. Ist die Komponente <code>A</code> der Eigentümer der Komponente <code>B</code>, dann ist die Komponente <code>A</code> bei ihrer Freigabe für die Freigabe von <code>B</code> verantwortlich.
* Streaming und Dateiverarbeitung. Erweiterungen der von [[System.Classes.TPersistent|TPersistent]] geerbten Persistenzfunktionen.
* COM-Unterstützung. Komponenten können mit den Experten (Assistenten) von Windows-Produkten in ActiveX-Steuerelemente oder in andere COM-Objekte konvertiert werden. Komponenten können als Container für COM-Objekte dienen.

{{Note| Alle Implementierungen von [[System.Classes.TComponent|TComponent]], einschließlich jener, die der Kompatibilität mit OS X dienen, verfügen über COM-Funktionen. COM-Funktionen sind aber '''Nur Windows''' und können in geräteübergreifenden (plattformübergreifenden) Anwendungen nicht verwendet werden.
}}

[[System.Classes.TComponent|TComponent]] stellt keine Benutzeroberfläche oder Anzeigefunktionen zur Verfügung. Diese Funktionalität wird von zwei direkt von [[System.Classes.TComponent|TComponent]] abgeleiteten Klassen bereitgestellt:
* '''TControl''' in der Unit [[FMX.Types]] ist die Basisklasse für '''visuelle Komponenten''' in Anwendungen, die mit dem FireMonkey-(FMX-)Framework erstellt werden.
* '''TControl''' in der Unit [[Vcl.Controls]] ist die Basisklasse für '''visuelle Komponenten''' in VCL-Anwendungen (nur Windows).

{{Note|In OS X Anwendungen können nur die Unit [[FMX.Types]] und andere FireMonkey-spezifische Units verwendet werden. Dies bedeutet, dass Sie in geräteübergreifenden Anwendungen keine VCL-Units verwenden können.}}

Komponenten, die zur Laufzeit sichtbar sein können, werden '''visuelle Komponenten''' genannt. Andere Komponenten, die nicht zur Laufzeit sichtbar sind, werden '''nicht-visuelle Komponenten''' genannt. Meist werden '''visuelle Komponenten''' jedoch als '''Steuerelemente''' und '''nicht-visuelle Komponenten''' einfach als '''Komponenten''' bezeichnet.

Erstellen Sie keine Instanzen von [[System.Classes.TComponent|TComponent]]. Verwenden Sie beim Deklarieren von nicht-visuellen Komponenten, die in der Komponentenpalette angezeigt und im '''Formular-Designer''' bearbeitet werden sollen, die Klasse [[System.Classes.TComponent|TComponent]] als Basisklasse. Die Eigenschaften und Methoden von [[System.Classes.TComponent|TComponent]] stellen das grundlegende Verhalten bereit, das abgeleitete Klassen erben, sowie Verhalten, das von Komponenten zur Anpassung ihres Verhaltens überschrieben werden kann.

===Siehe auch===

* [[Vcl.Controls.TControl]]
* [[FMX.Controls.TControl]]
* [[System.Classes.TFiler]]
* [[System.Classes.RegisterComponents]]
* [[System.Classes.RegisterNonActiveX]]
* [[rad_de:Mit Streams Daten lesen und schreiben|Mit Streams Daten lesen und schreiben]]
* [[rad_de:TComponent-Zweig|TComponent-Zweig]]
* [[rad_de:Überblick zu VCL|Überblick zu VCL]]
* [[rad_de:FireMonkey|FireMonkey]]

[[Category:API-Dokumentation]]

Data.DBXCommon.TDBXReader

2021-02-05T01:21:17Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:Data.DBXCommon.TDBXReader|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | Data.DBXCommon.TDBXReader | |{{InheritsFrom|Data.DBXCommon.TDBXReader}}}}

<section begin=short />[[Data.DBXCommon.TDBXReader|TDBXReader]] stellt einen unidirektionalen Reader für eine Kollektion von Datenbankzeilen bereit.<section end=short />

[[Data.DBXCommon.TDBXReader|TDBXReader]] stellt einen Reader, der ausschließlich vorwärts liest, für eine Kollektion von Datenbankzeilen bereit.

[[Data.DBXCommon.TDBXReader|TDBXReader]] wird von [[Data.DBXCommon.TDBXCommand|TDBXCommand]].[[Data.DBXCommon.TDBXCommand.ExecuteQuery|ExecuteQuery]] zurückgegeben. Rufen Sie [[Data.DBXCommon.TDBXReader|TDBXReader]].[[Data.DBXCommon.TDBXReader.Next|Next]] auf, um auf die erste und die folgenden Zeilen in der Kollektion zuzugreifen. Auf Zeilenwerte kann mit der Array-Eigenschaft [[Data.DBXCommon.TDBXReader.Value|Value]] zugegriffen werden. [[Data.DBXCommon.TDBXReader.Value|Value]] ist überladen, daher kann es entweder mit einer Ordinalposition oder einem Spaltennamen indiziert werden.

{{Note| Wenn eine Anwendung eine [[Data.DBXCommon.TDBXReader|TDBXReader]]-Instanz nicht mehr benötigt, sollte [[Data.DBXCommon.TDBXReader|TDBXReader]].<span class<nowiki> = </nowiki>"codeInline">Free</span> aufgerufen werden. Dadurch wird sichergestellt, dass alle der [[Data.DBXCommon.TDBXReader|TDBXReader]]-Instanz zugeordnete Ressourcen freigegeben werden.}}

===Siehe auch===

* [[rad_de:Herstellen einer Verbindung zu einer Datenbank mit dem dbExpress Treiber-Framework|Herstellen einer Verbindung zu einer Datenbank mit dem dbExpress Treiber-Framework]]

* [[Data.DBXCommon.TDBXCommand|TDBXCommand]]

* [[Data.DBXCommon.TDBXReader.Value|Value]]

* [[Data.DBXCommon.TDBXCommand.ExecuteQuery|ExecuteQuery]]

* [[Data.DBXCommon.TDBXReader.Next|Next]]

[[Category:API-Dokumentation]]

Vcl.Controls.TImageList

2021-01-18T16:51:25Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:Vcl.Controls.TImageList|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | Vcl.Controls.TImageList | |{{InheritsFrom|Vcl.Controls.TImageList}}}}

<section begin=short />[[Vcl.Controls.TImageList|TImageList]] repräsentiert eine Kollektion von Bildern mit identischer Größe. Jedes Bild kann über seinen Index referenziert werden.<section end=short />

Bilderlisten dienen der Verwaltung großer Mengen von Symbolen oder Bitmaps. Alle Bilder einer Liste sind in einem einzigen, großen Bitmap enthalten. Die Liste kann auch ein monochromes Bitmap enthalten, das als Maske für transparente Bilder (ähnlich Symbolen) dient.

In einer Bilderliste finden sehr viele Bilder gleicher Größe Platz, die jeweils über ihren Index (0 bis n - 1) abgerufen werden können. Bilderlisten verfügen über Methoden zum einfachen Speichern, Aufrufen und Zeichnen der enthaltenen Bilder.

Um während des Entwurfs einer Bilderliste Bilder hinzuzufügen, klicken Sie mit der rechten Maustaste und wählen [[rad_de:Bilderlisten-Editor|Bilderlisten-Editor]].

Bilder in der Liste können Bitmaps, Symbole, PNG-, GIF- und JPEG-Bilder sein: alle Bildtypen, die [[Vcl.ExtCtrls.TImage|TImage]] unterstützt. ImageLists unterstützt auch das 32-Bit-Format, damit Alpha-Farbübergänge in Bitmaps und PNG-Dateien korrekt arbeiten.

{{Note| Wenn Sie die Farbtiefe einer bereits vorhandenen Bilderliste ändern, wird deren Inhalt gelöscht.}}

{{Note| Bilderlisten benötigen Comctl32.dll. Ist nicht die aktuellste Version dieser Datei auf dem System vorhanden, werden die Bilder möglicherweise nicht angezeigt.}}

===Siehe auch===

* [[Vcl.ComCtrls.TListView|TListView]]

* [[Vcl.ExtCtrls.TImage|TImage]]

* [[rad_de:Listenkomponenten|Listenkomponenten]]

* [[rad_de:Symbole für Menüs und Symbolleisten hinzufügen|Symbole für Menüs und Symbolleisten hinzufügen]]

* [[rad_de:Win32-Steuerelemente|Win32-Steuerelemente]]

* [[rad_de:Bilderlisten-Editor|Bilderlisten-Editor]]

=== Codebeispiele ===
*[[samp_en:FileSelectBtnEdit (C++)|FileSelectBtnEdit (C++)]]
*[[samp_en:FileSelectBtnEdit (Delphi)|FileSelectBtnEdit (Delphi)]]
* [[samp_en:VCL.ImageProc Sample|ImageProc Sample]]

[[Category:API-Dokumentation]]

Xml.XMLDoc.TXMLNode

2021-01-09T04:50:09Z

Fabiola.Arias: Added the {{Note|}} template

{{#lst:API:Xml.XMLDoc.TXMLNode|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | Xml.XMLDoc.TXMLNode | |{{InheritsFrom|Xml.XMLDoc.TXMLNode}}}}

<section begin=short />[[Xml.XMLDoc.TXMLNode|TXMLNode]] wird für einen Knoten in einem XML-Dokument verwendet.<section end=short />

Der Experte für XML-Datenbindungen verwendet [[Xml.XMLDoc.TXMLNode|TXMLNode]] als Basisklasse für Knoten, die untergeordnete Knoten enthalten. Nehmen wir als Beispiel ein XML-Dokument mit folgenden Zeilen:

<source lang="xml">
<Address country="US">
<Name>
<First> John </First>
<MI> Q. </MI>
<Last> Public </Last>
</Name>
<Street> 123 Easy Street </Street>
<City> Anytown </City>
<State> CA </State>
</Address>
</source>

Der Experte generiert von [[Xml.XMLDoc.TXMLNode|TXMLNode]] abgeleitete Klassen für die Elemente Address und Name. Die untergeordneten Knoten und Knotenattribute werden als Eigenschaften des abgeleiteten Objekts implementiert.

{{Note| Der Experte für XML-Datenbindungen generiert auch Code zum Erstellen von [[Xml.XMLDoc.TXMLNode|TXMLNode]]-Objekten für Attribute und Elementknoten. Es gibt jedoch keine speziellen abgeleiteten Klassen für Attributknoten. Für jedes Attribut wird stattdessen ein [[Xml.XMLDoc.TXMLNode|TXMLNode]]-Objekt verwendet.}}

[[Xml.XMLDoc.TXMLNode|TXMLNode]] implementiert die Schnittstelle IXMLNode. In jedem [[Xml.XMLDoc.TXMLNode|TXMLNode]]-Nachkommen wird eine klassenspezifische, von IXMLNode abgeleitete Schnittstelle implementiert. Mit dieser Schnittstelle wird in Anwendungen normalerweise nicht direkt gearbeitet. Stattdessen wird IXMLNode oder die abgeleitete Schnittstelle des jeweiligen [[Xml.XMLDoc.TXMLNode|TXMLNode]]-Nachkommens verwendet.

===Siehe auch===

* [[Xml.XMLDoc.TXMLDocument|TXMLDocument]]

* [[Xml.XMLDoc.TXMLNodeCollection|TXMLNodeCollection]]

* [[Xml.XMLIntf.IXMLNode]]

* [[Xml.XMLDoc.TXMLNodeList|TXMLNodeList]]

* [[rad_de:Mit XML-Knoten arbeiten|Mit XML-Knoten arbeiten]]

[[Category:API-Dokumentation]]

Xml.XMLDoc.TXMLDocument

2021-01-06T03:52:34Z

Fabiola.Arias: Added the {{Tip|}} template

{{#lst:API:Xml.XMLDoc.TXMLDocument|api}}

==Beschreibung==
{{#ifeq: {{PAGENAME}} | Xml.XMLDoc.TXMLDocument | |{{InheritsFrom|Xml.XMLDoc.TXMLDocument}}}}

<section begin=short />[[Xml.XMLDoc.TXMLDocument|TXMLDocument]] repräsentiert für ein XML-Dokument.<section end=short />

Mit [[Xml.XMLDoc.TXMLDocument|TXMLDocument]] repräsentierten Sie ein XML-Dokument. Mit dieser Klasse können Sie XML-Dokumente aus einer Datei lesen, einem String den Inhalt eines XML-Dokuments zuweisen oder neue, leere XML-Dokumente erstellen.

Sie können direkt mit [[Xml.XMLDoc.TXMLDocument|TXMLDocument]] arbeiten, um ein XML-Dokument zu laden, es anzuzeigen und zu bearbeiten und anschließend wieder zu speichern. [[Xml.XMLDoc.TXMLDocument|TXMLDocument]] kann aber auch zum Zugriff auf die Objekte verwendet werden, die durch den Experten für XML-Datenbindungen erstellt werden.

[[Xml.XMLDoc.TXMLDocument|TXMLDocument]] verwendet einen externen DOM-Parser (Document Object Model) zur Analyse des XML-Dokuments. Dieser Parser wird normalerweise mit Hilfe der Eigenschaft [[Xml.XMLDoc.TXMLDocument.DOMVendor|DOMVendor]] zugeordnet.

Wenn Sie die Eigenschaft [[Xml.XMLDoc.TXMLDocument.Active|Active]] auf true setzen, wird das Dokument mit Hilfe des DOM-Parsers analysiert und kann anschließend angezeigt oder bearbeitet werden. Die Eigenschaft [[Xml.XMLDoc.TXMLDocument.DocumentElement|DocumentElement]] stellt ein Interface für den Stammknoten des Dokuments zur Verfügung, das den Zugriff auf die untergeordneten Knoten ermöglicht.

[[Xml.XMLDoc.TXMLDocument|TXMLDocument]] implementiert das Interface IXMLDocument. Dieses kann direkt von der Komponente oder von den Knoten im Dokument abgerufen werden kann.

Wenn eine [[Xml.XMLDoc.TXMLDocument|TXMLDocument]]-Instanz ohne Eigentümer ([[Xml.XMLDoc.TXMLNodeList.Owner|Owner]]) erstellt wird, verhält sie sich wie ein Objekt mit Interface-Unterstützung. Die Freigabe der Instanz erfolgt dann automatisch, nachdem alle Referenzen auf ihr Interface freigegeben wurden. Wird ein [[Xml.XMLDoc.TXMLDocument|TXMLDocument]]-Objekt mit Eigentümer erstellt, ist dieser wie bei jeder anderen Komponente für die Freigabe verantwortlich. Beim Einfügen aus der Komponentenpalette in ein Formular oder Datenmodul wird die [[Xml.XMLDoc.TXMLDocument|TXMLDocument]]-Komponente automatisch mit Eigentümer erstellt. Wenn die [[Xml.XMLDoc.TXMLDocument|TXMLDocument]]-Komponente durch einen Aufruf der globalen Funktion [[Xml.XMLDoc.LoadXMLDocument|LoadXMLDocument]] (oder einer Funktion, die der Experte für XML-Datenbindungen zum Zurückgeben des Stammknotens eines Dokuments generiert) erstellt wird, werden Instanzen ohne Eigentümer erzeugt.

{{Tip| Um [[Xml.XMLDoc.TXMLDocument|TXMLDocument]] in '''macOS''' oder '''mobilen'''-Anwendungen zu verwenden, setzen Sie im [[rad_de:Objektinspektor|Objektinspektor]] die Eigenschaft [[Xml.XMLDoc.TXMLDocument.DOMVendor|DOMVendor]] auf '''ADOM XML v4''', direkt nachdem diese Komponente auf dem Formular-Designer abgelegt wurde. Ansonsten ist die [[Xml.XMLDoc.TXMLDocument|TXMLDocument]]-Komponente für iOS-/Android-/macOS-Anwendungen nicht mehr verwendbar.}}

===Siehe auch===

* [[Xml.XMLIntf.IXMLNode|IXMLNode]]

* [[Xml.XMLIntf.EXMLDocError|EXMLDocError]]

* [[Xml.XMLIntf.IXMLDocument|IXMLDocument]]

* [[Xml.XMLDoc.LoadXMLDocument|LoadXMLDocument]]

* [[rad_de:TXMLDocument verwenden|TXMLDocument verwenden]]

* [[rad_de:Mit vom XML-Datenbindungsexperten generierten Quellcode arbeiten|Mit vom XML-Datenbindungsexperten generierten Quellcode arbeiten]]

* [[rad_de:Internet-Steuerelemente|Internet-Steuerelemente]]

[[Category:API-Dokumentation]]