Die Methode write

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Zugriffsmethoden (Eigenschaften)


Die Methode write einer Eigenschaft ist eine Prozedur mit einem einzigen Parameter (mit einer noch im Folgenden erläuterten Ausnahme), der denselben Typ wie die Eigenschaft hat. Der Parameter kann als Referenz oder als Wert übergeben werden und einen beliebigen Namen erhalten. Per Konvention wird der Name der Methode write aus dem Wort Set und dem Namen der Eigenschaft gebildet. So würde beispielsweise die Methode write für eine Eigenschaft namens Count SetCount lauten. Der im Parameter übergebene Wert wird zum neuen Wert der Eigenschaft. Die Methode write muss die Bearbeitungen durchführen, die für das Einbringen der entsprechenden Daten in den internen Speicher der Eigenschaft erforderlich sind.

Die einzige Ausnahme zu der oben erwähnten Parameter-Regel bilden die Array-Eigenschaften und diejenigen Eigenschaften, die Index-Spezifizierer verwenden. Diese beiden Eigenschaftstypen übergeben ihre Indexwerte als zweiten Parameter. (Verwenden Sie Index-Spezifizierer zur Erstellung einer Schreibmethode, die von mehreren Eigenschaften gemeinsam genutzt wird. Informationen über Index-Spezifizierer finden Sie in der Delphi Sprachreferenz.)

Wenn Sie keine write-Methode deklarieren, hat die Eigenschaft das Attribut Nur Lesen.

write-Methoden überprüfen normalerweise vor der Änderung der Eigenschaft, ob sich ein neuer Wert vom aktuellen Wert unterscheidet. Im folgenden sehen Sie eine einfache Schreibmethode für eine Integer-Eigenschaft namens Count, die ihren aktuellen Wert in einem Feld namens FCount speichert.

procedure TMyComponent.SetCount(Value: Integer);
begin
  if Value <> FCount then
  begin
    FCount := Value;
    Update;
  end;
end;
void __fastcall TMyComponent::SetCount( int Value )
{
  if ( Value != FCount )
  {
    FCount = Value;
    Update();
  }
}