Git_Mirror/Terminal.Gui
1
0
Fork 0
mirror of https://github.com/gui-cs/Terminal.Gui.git synced 2025-12-31 02:08:03 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add documentation on ISupportInitialize/ISupportInitializeNotification (#286)

Browse Source
This commit is contained in:
Daniel Cazzulino
2019-11-02 23:19:40 -03:00
committed by BDisp
parent c95c905495
commit d6de83679a
1 changed files with 13 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
Terminal.Gui/Core.cs
View File

@@ -1283,6 +1283,19 @@ namespace Terminal.Gui {
/// toplevel and then invoke <see cref="M:Terminal.Gui.Application.Run"/> with the
/// new toplevel.
/// </para>
/// <para>
/// TopLevels can also opt-in to more sophisticated initialization
/// by implementing <see cref="ISupportInitialize"/>. When they do
/// so, the <see cref="ISupportInitialize.BeginInit"/> and
/// <see cref="ISupportInitialize.EndInit"/> methods will be called
/// before running the view.
/// If first-run-only initialization is preferred, the <see cref="ISupportInitializeNotification"/>
/// can be implemented too, in which case the <see cref="ISupportInitialize"/>
/// methods will only be called if <see cref="ISupportInitializeNotification.IsInitialized"/>
/// is <see langword="false"/>. This allows proper View inheritance hierarchies
/// to override base class layout code optimally by doing so only on first run,
/// instead of on every run.
/// </para>
/// </remarks>
public class Toplevel : View {
/// <summary>