/// <summary>
/// Initialize this as an IxCoreColleague
/// </summary>
/// <remarks> subclasses must call this from their Init.
/// This was done, rather than providing an Init() here in the normal way,
/// to drive home the point that the subclass must set m_fullyInitialized
/// to true when it is fully initialized.</remarks>
/// <param name="mediator"></param>
/// <param name="configurationParameters"></param>
protected void InitBase(Mediator mediator, XmlNode configurationParameters)
{
Debug.Assert(m_fullyInitialized == false, "No way we are fully initialized yet!");
m_mediator = mediator;
m_configurationParameters = configurationParameters;
ReadParameters();
RecordClerk clerk = ExistingClerk;
if (clerk == null)
{
// NOTE: new clerks do not typically complete ReloadList()
// until Clerk.ActivateUI() is set (eg. here in SetupDataContext()).
// however, we should further delay loading the list
// if the subclass is initializing sorters/filters.
// so we use ListUpdateHelper below to delay reloading the list.
clerk = Clerk;
Debug.Assert(clerk != null);
}
// suspend any loading of the Clerk's list items until after a
// subclass (possibly) initializes sorters/filters
// in SetupDataContext()
using (RecordClerk.ListUpdateHelper luh = new RecordClerk.ListUpdateHelper(clerk))
{
luh.ClearBrowseListUntilReload = true;
clerk.UpdateOwningObjectIfNeeded();
SetTreebarAvailability();
AddPaneBar();
// NB: It is critical that we get added *after* our RecordClerk,
// so that it will get messages, for example about a change of cache, before we do.
mediator.AddColleague(this);
SetupDataContext();
}
// In case it hasn't yet been loaded, load it! See LT-10185.
if (!Clerk.ListLoadingSuppressed && Clerk.RequestedLoadWhileSuppressed)
{
Clerk.UpdateList(true, true);
}
ShowRecord();
}
/// <summary>
/// Initialize this as an IxCoreColleague
/// </summary>
/// <remarks> subclasses must call this from their Init.
/// This was done, rather than providing an Init() here in the normal way,
/// to drive home the point that the subclass must set m_fullyInitialized
/// to true when it is fully initialized.</remarks>
/// <param name="mediator"></param>
/// <param name="propertyTable"></param>
/// <param name="configurationParameters"></param>
protected void InitBase(Mediator mediator, PropertyTable propertyTable, XmlNode configurationParameters)
{
Debug.Assert(m_fullyInitialized == false, "No way we are fully initialized yet!");
m_mediator = mediator;
m_propertyTable = propertyTable;
m_configurationParameters = configurationParameters;
ReadParameters();
RecordClerk clerk = ExistingClerk;
bool fClerkAlreadySuppressed = false;
bool fClerkWasCreated = false;
if (clerk == null)
{
// We do NOT want to load the list as part of creating the clerk.
// At earliest, we want to do so only when the ListUpdateHelper is disposed,
// after the clerk and list are sufficiently initialized (e.g., with saved sorting and filtering
// information) to sort correctly. This is part of a fairly convoluted attempt to prevent
// sorting the list repeatedly during startup, even though startup involves many events
// that normally require it to be resorted.
// In this case the clerk will be created with its list already in the ListLoadingSuppressed state,
// and already set to indicate that loading is necessary when suppression ends;
// we want to pass FALSE to the ListUpdateHelper constructor, however, to pretend that the
// list was NOT suppressed when the helper was created, so it will duly be sorted when
// the helper is disposed.
fClerkWasCreated = true;
clerk = CreateClerk(false);
Debug.Assert(clerk != null);
}
else
{
fClerkAlreadySuppressed = clerk.ListLoadingSuppressed; // If we didn't create the clerk, someone else might have suppressed it.
}
// suspend any loading of the Clerk's list items until after a
// subclass (possibly) initializes sorters/filters
// in SetupDataContext()
bool didRestoreFromPersistence = false;
using (var luh = new RecordClerk.ListUpdateHelper(clerk, fClerkAlreadySuppressed))
{
luh.ClearBrowseListUntilReload = true;
clerk.UpdateOwningObjectIfNeeded();
SetTreebarAvailability();
AddPaneBar();
//Historical comments here indicated that the Clerk should be processed by the mediator before the
//view. This is handled by Priority now, RecordView is by default just after RecordClerk in the processing.
mediator.AddColleague(this);
SetupDataContext();
// Only if it was just now created should we try to restore from what we persisted.
// Otherwise (e.g., FWR-1128) we may miss changes made to the list in other tools.
if (fClerkWasCreated)
{
didRestoreFromPersistence = RestoreSortSequence();
}
if (didRestoreFromPersistence)
{
luh.ListWasRestored();
}
}
// In case it hasn't yet been loaded, load it! See LT-10185.
if (!didRestoreFromPersistence && !Clerk.ListLoadingSuppressed && Clerk.RequestedLoadWhileSuppressed)
{
Clerk.UpdateList(true, true); // sluggishness culprit for LT-12844 was in here
}
Clerk.SetCurrentFromRelatedClerk(); // See if some other clerk wants to influence our current object.
ShowRecord();
}