CanOfferPurgingSuggestions

SearchForSuggestions SuggestionSearchStatus

Attributes

Class CanOfferPurgingSuggestions defines no new attributes.

Fields

Define Class CanOfferPurgingSuggestions;
    mixes in with Object;
    
    operation SearchForSuggestions(suggestionDisplayer: CanShowPurgingSuggestions; containerDevice: ContainerDevice; recommendedOnly: Boolean), noMethod;
        // called by system to add objects to the list displayed in the out-of-memory window or suggestions-for-discarding scene
        // only objects from this containerDevice should be added (add all if containerDevice is nilObject);
        // <recommendedOnly> is true when only most likely discardable objects should be offered;
        // subclasses must implement
        // implementation must call AddSuggestion on <suggestionDisplayer> for each suggestion;
        // AddSuggestion should be called at least once every two seconds to allow response to user touches in "stop" button
        // if searching takes longer, implementation should call AddSuggestion with nilObject periodically
        
    operation SuggestionSearchStatus(recommendedOnly: Boolean): Text;
        // called by system to obtain ephemeral text that is displayed while searching for suggestions to discard
        // <recommendedOnly> is passed here when it was passed to SearchForSuggestions, so status message can be specific
        // returns nilObject
        // usually override
end class;