IComponentChangeService.OnComponentChanged Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Ogłasza usługę zmiany składnika, która uległa zmianie określonego składnika.
public:
void OnComponentChanged(System::Object ^ component, System::ComponentModel::MemberDescriptor ^ member, System::Object ^ oldValue, System::Object ^ newValue);
public void OnComponentChanged(object component, System.ComponentModel.MemberDescriptor member, object oldValue, object newValue);
abstract member OnComponentChanged : obj * System.ComponentModel.MemberDescriptor * obj * obj -> unit
Public Sub OnComponentChanged (component As Object, member As MemberDescriptor, oldValue As Object, newValue As Object)
Parametry
- component
- Object
Składnik, który uległ zmianie.
- member
- MemberDescriptor
Element członkowski, który uległ zmianie. Dzieje się tak null , jeśli ta zmiana nie jest powiązana z jednym elementem członkowskim.
- oldValue
- Object
Stara wartość elementu członkowskiego. Jest to prawidłowe tylko wtedy, gdy element członkowski nie nulljest .
- newValue
- Object
Nowa wartość elementu członkowskiego. Jest to prawidłowe tylko wtedy, gdy element członkowski nie nulljest .
Uwagi
Ta metoda zgłasza ComponentChanged zdarzenie.
Większość projektantów, którzy wysyłają zestaw SDK Windows, a także środowisko Visual Studio czasu projektowania, zwykle zgłasza to zdarzenie, gdy składnik w projekcie zostanie zmieniony, więc przez większość czasu nie trzeba jawnie wywoływać tej metody. Odpowiednie IComponentChangeService zdarzenia są automatycznie zgłaszane, gdy element PropertyDescriptor jest używany do zmiany wartości właściwości lub składników są dodawane lub usuwane z kontenera IDesignerHost .
Przed wywołaniem OnComponentChangedmetody najpierw wywołaj metodę OnComponentChanging , aby wskazać, że składnik ma ulec zmianie i wprowadzić zmianę. Następnie wywołaj metodę OnComponentChangedComponentChanged , aby zgłosić zdarzenie.
Notatki dotyczące implementowania
To zdarzenie umożliwia implementatorowi wykonywanie wszelkich czynności przetwarzania końcowego, które jest wymagane po zmianie właściwości. Na przykład projektant zwykle aktualizuje kod źródłowy, który ustawia właściwość przy użyciu nowej wartości.