Classe CDataRecoveryHandler
I CDataRecoveryHandler
documenti vengono salvati automaticamente e ripristinati se un'applicazione viene chiusa in modo imprevisto.
Sintassi
class CDataRecoveryHandler : public CObject
Membri
Costruttori
Nome | Descrizione |
---|---|
CDataRecoveryHandler::CDataRecoveryHandler | Costruisce un oggetto CDataRecoveryHandler . |
Metodi
Nome | Descrizione |
---|---|
CDataRecoveryHandler::AutosaveAllDocumentInfo | Consente di archiviare automaticamente ogni file registrato con la CDataRecoveryHandler classe . |
CDataRecoveryHandler::AutosaveDocumentInfo | Elimina automaticamente il documento specificato. |
CDataRecoveryHandler::CreateDocumentInfo | Aggiunge un documento all'elenco di documenti aperti. |
CDataRecoveryHandler::D eleteAllAutosavedFiles | Elimina tutti i file salvati automaticamente correnti. |
CDataRecoveryHandler::D eleteAutosavedFile | Elimina il file salvato automaticamente specificato. |
CDataRecoveryHandler::GenerateAutosaveFileName | Genera il nome di un file di salvataggio automatico associato al nome del file di documento specificato. |
CDataRecoveryHandler::GetAutosaveInterval | Restituisce l'intervallo tra tentativi di salvataggio automatico. |
CDataRecoveryHandler::GetAutosavePath | Restituisce il percorso dei file salvati automaticamente. |
CDataRecoveryHandler::GetDocumentListName | Recupera il nome del documento da un CDocument oggetto . |
CDataRecoveryHandler::GetNormalDocumentTitle | Recupera il titolo normale per il documento specificato. |
CDataRecoveryHandler::GetRecoveredDocumentTitle | Crea e restituisce il titolo per il documento recuperato. |
CDataRecoveryHandler::GetRestartIdentifier | Recupera l'identificatore di riavvio univoco per l'applicazione. |
CDataRecoveryHandler::GetSaveDocumentInfoOnIdle | Indica se CDataRecoveryHandler esegue un salvataggio automatico nel ciclo di inattività corrente. |
CDataRecoveryHandler::GetShutdownByRestartManager | Indica se il gestore di riavvio ha causato la chiusura dell'applicazione. |
CDataRecoveryHandler::Initialize | Inizializza CDataRecoveryHandler . |
CDataRecoveryHandler::QueryRestoreAutosavedDocuments | Visualizza una finestra di dialogo all'utente per ogni documento CDataRecoveryHandler salvato automaticamente. La finestra di dialogo determina se l'utente desidera ripristinare il documento salvato automaticamente. |
CDataRecoveryHandler::ReadOpenDocumentList | Carica l'elenco di documenti aperti dal Registro di sistema. |
CDataRecoveryHandler::RemoveDocumentInfo | Rimuove il documento fornito dall'elenco di documenti aperti. |
CDataRecoveryHandler::ReopenPreviousDocuments | Apre i documenti aperti in precedenza. |
CDataRecoveryHandler::RestoreAutosavedDocuments | Ripristina i documenti salvati automaticamente in base all'input dell'utente. |
CDataRecoveryHandler::SaveOpenDocumentList | Salva l'elenco corrente di documenti aperti nel Registro di sistema di Windows. |
CDataRecoveryHandler::SetAutosaveInterval | Imposta il tempo tra cicli di salvataggio automatico in millisecondi. |
CDataRecoveryHandler::SetAutosavePath | Imposta la directory in cui vengono archiviati i file salvati automaticamente. |
CDataRecoveryHandler::SetRestartIdentifier | Imposta l'identificatore di riavvio univoco per questa istanza di CDataRecoveryHandler . |
CDataRecoveryHandler::SetSaveDocumentInfoOnIdle | Imposta un valore che indica se CDataRecoveryHandler salva le informazioni del documento aperto nel Registro di sistema di Windows durante il ciclo di inattività corrente. |
CDataRecoveryHandler::SetShutdownByRestartManager | Imposta un valore che indica se l'uscita precedente dell'applicazione è stata causata dal gestore di riavvio. |
CDataRecoveryHandler::UpdateDocumentInfo | Aggiorna le informazioni per un documento perché l'utente l'ha salvata. |
Membri dei dati
Nome | Descrizione |
---|---|
m_bRestoringPreviousOpenDocs | Indica se il gestore di recupero dati riapre i documenti aperti in precedenza. |
m_bSaveDocumentInfoOnIdle | Indica se il gestore di recupero dati esegue automaticamente l'intercettazione automatica dei documenti nel ciclo di inattività successivo. |
m_bShutdownByRestartManager | Indica se il gestore di riavvio causa l'uscita dell'applicazione. |
m_dwRestartManagerSupportFlags | Flag che indicano il supporto fornito dal gestore di riavvio per l'applicazione. |
m_lstAutosavesToDelete | Elenco di file salvati automaticamente che non sono stati eliminati quando i documenti originali sono stati chiusi. Quando l'applicazione viene chiusa, il gestore di riavvio ritenta l'eliminazione dei file. |
m_mapDocNameToAutosaveName | Mappa dei nomi dei documenti ai nomi di file salvati automaticamente. |
m_mapDocNameToDocumentPtr | Mappa dei nomi dei documenti ai puntatori CDocument . |
m_mapDocNameToRestoreBool | Mappa dei nomi dei documenti a un parametro booleano che indica se ripristinare il documento salvato automaticamente. |
m_mapDocumentPtrToDocName | Mappa dei CDocument puntatori ai nomi dei documenti. |
m_mapDocumentPtrToDocTitle | Mappa dei CDocument puntatori ai titoli dei documenti. Questi titoli vengono usati per salvare i file. |
m_nAutosaveInterval | Tempo in millisecondi tra le operazioni di intercettazione automatica.Time in milliseconds between autosaves. |
m_nTimerID | Identificatore del timer di salvataggio automatico. |
m_strAutosavePath | Percorso in cui vengono archiviati i documenti salvati automaticamente. |
m_strRestartIdentifier | Rappresentazione di stringa di un GUID per il gestore di riavvio. |
Osservazioni:
Il gestore di riavvio usa la CDataRecoveryHandler
classe per tenere traccia di tutti i documenti aperti e di salvarli automaticamente in base alle esigenze. Per abilitare il salvataggio automatico, usare il metodo CDataRecoveryHandler::SetSaveDocumentInfoOnIdle . Questo metodo indica all'oggetto CDataRecoveryHandler
di eseguire un salvataggio automatico nel ciclo inattivo successivo. Il gestore di riavvio chiama SetSaveDocumentInfoOnIdle
quando CDataRecoveryHandler
deve eseguire un salvataggio automatico.
Tutti i metodi della CDataRecoveryHandler
classe sono virtuali. Eseguire l'override dei metodi in questa classe per creare un gestore di recupero dati personalizzato. A meno che non si crei un gestore di recupero dati o un gestore di riavvio, non creare un'istanza di CDataRecoveryHandler. La classe CWinApp crea un CDataRecoveryHandler
oggetto in base alle esigenze.
Prima di poter usare un CDataRecoveryHandler
oggetto, è necessario chiamare CDataRecoveryHandler::Initialize.
Poiché la CDataRecoveryHandler
classe è strettamente connessa al gestore di riavvio, CDataRecoveryHandler
dipende dal parametro m_dwRestartManagerSupportFlags
globale . Questo parametro determina quali autorizzazioni ha il gestore di riavvio e come interagisce con l'applicazione. Per incorporare il gestore di riavvio in un'applicazione esistente, è necessario assegnare m_dwRestartManagerSupportFlags
il valore appropriato nel costruttore dell'applicazione principale. Per altre informazioni su come usare il gestore di riavvio, vedere Procedura: Aggiungere il supporto di Gestione riavvio.
Requisiti
Intestazione: afxdatarecovery.h
CDataRecoveryHandler::AutosaveAllDocumentInfo
Consente di archiviare automaticamente ogni file registrato con la CDataRecoveryHandler
classe .
virtual BOOL AutosaveAllDocumentInfo();
Valore restituito
TRUE se tutti CDataRecoveryHandler
i documenti sono stati salvati; FALSE se un documento non è stato salvato.
Osservazioni:
Questo metodo restituisce TRUE se non sono presenti documenti che devono essere salvati. Restituisce anche TRUE senza salvare documenti se il recupero di CWinApp
o CDocManager
per l'applicazione genera un errore.
Per usare questo metodo, è necessario impostare AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART o AFX_RESTART_MANAGER_AUTOSAVE_AT_INTERVAL in m_dwRestartManagerSupportFlags
. Per altre informazioni, vedere Procedura: Aggiungere il supporto di Restart Manager.
CDataRecoveryHandler::AutosaveDocumentInfo
Elimina automaticamente il documento specificato.
virtual BOOL AutosaveDocumentInfo(
CDocument* pDocument,
BOOL bResetModifiedFlag = TRUE);
Parametri
pDocument
[in] Puntatore all'oggetto CDocument
da salvare.
bResetModifiedFlag
[in] TRUE indica che considera CDataRecoveryHandler
pDocument da modificare; FALSE indica che il framework considera pDocument non modificato. Per altre informazioni sull'effetto di questo flag, vedere la sezione Osservazioni.
Valore restituito
TRUE se i flag appropriati sono impostati e pDocument è un oggetto valido CDocument
.
Osservazioni:
Ogni CDocument
oggetto ha un flag che indica se è stato modificato dall'ultimo salvataggio. Usare CDocument::IsModified per determinare lo stato di questo flag. Se un oggetto CDocument
non è stato modificato dopo l'ultimo salvataggio, AutosaveDocumentInfo
elimina tutti i file salvati automaticamente per tale documento. Se un documento è stato modificato dopo l'ultimo salvataggio, la chiusura richiede all'utente di salvare il documento prima della chiusura.
Nota
L'uso di bResetModifiedFlag per modificare lo stato del documento in modo non modificato può causare la perdita di dati non salvati da parte dell'utente. Se il framework considera un documento non modificato, la chiusura non richiede all'utente di salvare.
Questo metodo genera un'eccezione con la macro ASSERT se pDocument non è un oggetto valido CDocument
.
Per utilizzare questo metodo, è necessario impostare AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART o AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL in m_dwRestartManagerSupportFlags.
CDataRecoveryHandler::CDataRecoveryHandler
Costruisce un oggetto CDataRecoveryHandler
.
CDataRecoveryHandler(
DWORD dwRestartManagerSupportFlags,
int nAutosaveInterval);
Parametri
dwRestartManagerSupportFlags
[in] Indica le opzioni supportate dal gestore di riavvio.
nAutosaveInterval
[in] Tempo tra le autosaves. Questo parametro è espresso in millisecondi.
Osservazioni:
Il framework MFC crea automaticamente un CDataRecoveryHandler
oggetto per l'applicazione quando si usa la procedura guidata Nuovo progetto . A meno che non si stia personalizzando il comportamento di ripristino dei dati o il gestore di riavvio, non è consigliabile creare un CDataRecoveryHandler
oggetto .
CDataRecoveryHandler::CreateDocumentInfo
Aggiunge un documento all'elenco di documenti aperti.
virtual BOOL CreateDocumentInfo(CDocument* pDocument);
Parametri
pDocument
[in] Puntatore a un oggetto CDocument
. Questo metodo crea le informazioni sul documento per questo CDocument
oggetto .
Valore restituito
L'implementazione predefinita restituisce TRUE.
Osservazioni:
Questo metodo controlla se pDocument è già presente nell'elenco dei documenti prima di aggiungere il documento. Se pDocument è già presente nell'elenco, questo metodo elimina il file salvato automaticamente associato a pDocument.
Per utilizzare questo metodo, è necessario impostare AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART o AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL in m_dwRestartManagerSupportFlags.
CDataRecoveryHandler::D eleteAllAutosavedFiles
Elimina tutti i file salvati automaticamente correnti.
virtual BOOL DeleteAllAutosavedFiles();
Valore restituito
L'implementazione predefinita restituisce sempre TRUE.
CDataRecoveryHandler::D eleteAutosavedFile
Elimina il file salvato automaticamente specificato.
virtual BOOL DeleteAutosavedFile(const CString& strAutosavedFile);
Parametri
strAutosavedFile
[in] Stringa contenente il nome file salvato automaticamente.
Valore restituito
L'implementazione predefinita restituisce sempre TRUE.
Osservazioni:
Se questo metodo non può eliminare il file salvato automaticamente, salva il nome del file in un elenco. Distruttore per l'oggetto CDataRecoveryHandler
tenta di eliminare ogni file salvato automaticamente specificato nell'elenco.
CDataRecoveryHandler::GenerateAutosaveFileName
Genera il nome di un file di salvataggio automatico associato al nome del file di documento specificato.
virtual CString GenerateAutosaveFileName(const CString& strDocumentName) const;
Parametri
strDocumentName
[in] Stringa contenente il nome del documento. GenerateAutosaveFileName
utilizza questo nome di documento per generare un nome file di salvataggio automatico corrispondente.
Valore restituito
Nome file di salvataggio automatico generato da strDocumentName.
Osservazioni:
Ogni nome di documento ha un mapping uno-a-uno con un nome file di salvataggio automatico.
CDataRecoveryHandler::GetAutosaveInterval
Restituisce l'intervallo tra tentativi di salvataggio automatico.
virtual int GetAutosaveInterval() const;
Valore restituito
Numero di millisecondi tra tentativi di salvataggio automatico.
CDataRecoveryHandler::GetAutosavePath
Restituisce il percorso dei file salvati automaticamente.
virtual CString GetAutosavePath() const;
Valore restituito
Percorso in cui vengono archiviati i documenti salvati automaticamente.
CDataRecoveryHandler::GetDocumentListName
Recupera il nome del documento da un CDocument
oggetto .
virtual CString GetDocumentListName(CDocument* pDocument) const;
Parametri
pDocument
[in] Puntatore a un oggetto CDocument
. GetDocumentListName
recupera il nome del documento da questo CDocument
oggetto .
Valore restituito
Nome del documento da pDocument.
Osservazioni:
CDataRecoveryHandler
usa il nome del documento come chiave in m_mapDocNameToAutosaveName, m_mapDocNameToDocumentPtr e m_mapDocNameToRestoreBool. Questi parametri consentono di monitorare CDocument
gli CDataRecoveryHandler
oggetti, il nome del file di salvataggio automatico e le impostazioni di salvataggio automatico.
CDataRecoveryHandler::GetNormalDocumentTitle
Recupera il titolo normale per il documento specificato.
virtual CString GetNormalDocumentTitle(CDocument* pDocument);
Parametri
pDocument
[in] Puntatore a un oggetto CDocument
.
Valore restituito
Titolo normale per il documento specificato.
Osservazioni:
Il titolo normale di un documento è in genere il nome file del documento senza il percorso. Si tratta del titolo nel campo Nome file della finestra di dialogo Salva con nome.
CDataRecoveryHandler::GetRecoveredDocumentTitle
Crea e restituisce il titolo per il documento recuperato.
virtual CString GetRecoveredDocumentTitle(const CString& strDocumentTitle) const;
Parametri
strDocumentTitle
[in] Titolo normale per il documento.
Valore restituito
Titolo del documento recuperato.
Osservazioni:
Per impostazione predefinita, il titolo recuperato di un documento è il titolo normale con [ripristinato] aggiunto. Il titolo recuperato viene visualizzato all'utente quando esegue una CDataRecoveryHandler
query sull'utente per ripristinare i documenti salvati automaticamente.
CDataRecoveryHandler::GetRestartIdentifier
Recupera l'identificatore di riavvio univoco per l'applicazione.
virtual CString GetRestartIdentifier() const;
Valore restituito
Identificatore di riavvio univoco.
Osservazioni:
L'identificatore di riavvio è univoco per ogni esecuzione dell'applicazione.
Archivia CDataRecoveryHandler
le informazioni nel Registro di sistema sui documenti attualmente aperti. Quando il gestore di riavvio esce da un'applicazione e lo riavvia, fornisce l'identificatore di CDataRecoveryHandler
riavvio a . CDataRecoveryHandler
Usa l'identificatore di riavvio per recuperare l'elenco dei documenti aperti in precedenza. In questo modo è possibile CDataRecoveryHandler
provare a trovare e ripristinare i file salvati automaticamente.
CDataRecoveryHandler::GetSaveDocumentInfoOnIdle
Indica se CDataRecoveryHandler
esegue un salvataggio automatico nel ciclo di inattività corrente.
virtual BOOL GetSaveDocumentInfoOnIdle() const;
Valore restituito
TRUE indica i CDataRecoveryHandler
processi automatici nel ciclo di inattività corrente; FALSE indica che non lo fa.
CDataRecoveryHandler::GetShutdownByRestartManager
Indica se il gestore di riavvio ha causato la chiusura dell'applicazione.
virtual BOOL GetShutdownByRestartManager() const;
Valore restituito
TRUE indica che il gestore di riavvio ha causato la chiusura dell'applicazione; FALSE indica che non è stato eseguito.
CDataRecoveryHandler::Initialize
Inizializza CDataRecoveryHandler
.
virtual BOOL Initialize();
Valore restituito
TRUE se l'inizializzazione ha esito positivo; in caso contrario FALSE.
Osservazioni:
Il processo di inizializzazione carica il percorso per archiviare i file di salvataggio automatico dal Registro di sistema. Se il metodo non riesce a Initialize
trovare questa directory o se il percorso è NULL, Initialize
ha esito negativo e restituisce FALSE
.
Usare CDataRecoveryHandler::SetAutosavePath per modificare il percorso di salvataggio automatico dopo che l'applicazione inizializza .CDataRecoveryHandler
Il Initialize
metodo avvia anche un timer da monitorare quando si verifica il successivo salvataggio automatico. Usare CDataRecoveryHandler::SetAutosaveInterval per modificare l'intervallo di salvataggio automatico dopo che l'applicazione inizializza .CDataRecoveryHandler
CDataRecoveryHandler::QueryRestoreAutosavedDocuments
Visualizza una finestra di dialogo all'utente per ogni documento CDataRecoveryHandler
salvato automaticamente. La finestra di dialogo determina se l'utente desidera ripristinare il documento salvato automaticamente.
virtual void QueryRestoreAutosavedDocuments();
Osservazioni:
Se l'applicazione è Unicode, questo metodo visualizza un CTaskDialog all'utente. In caso contrario, il framework usa AfxMessageBox per eseguire query sull'utente.
Dopo QueryRestoreAutosavedDocuments
aver raccolto tutte le risposte dall'utente, archivia le informazioni nella variabile membro m_mapDocNameToRestoreBool. Questo metodo non ripristina i documenti salvati automaticamente.
CDataRecoveryHandler::ReadOpenDocumentList
Carica l'elenco di documenti aperti dal Registro di sistema.
virtual BOOL ReadOpenDocumentList();
Valore restituito
TRUE indica che ReadOpenDocumentList
le informazioni caricate per almeno un documento dal Registro di sistema; FALSE indica che non sono state caricate informazioni sul documento.
Osservazioni:
Questa funzione carica le informazioni del documento aperto dal Registro di sistema e le archivia nella variabile membro m_mapDocNameToAutosaveName.
Dopo ReadOpenDocumentList
aver caricato tutti i dati, elimina le informazioni del documento dal Registro di sistema.
CDataRecoveryHandler::RemoveDocumentInfo
Rimuove il documento fornito dall'elenco di documenti aperti.
virtual BOOL RemoveDocumentInfo(CDocument* pDocument);
Parametri
pDocument
[in] Puntatore al documento da rimuovere.
Valore restituito
TRUE se pDocument è stato rimosso dall'elenco; FALSE se si è verificato un errore.
Osservazioni:
Quando l'utente chiude un documento, il framework usa questo metodo per rimuoverlo dall'elenco di documenti aperti.
Se RemoveDocumentInfo
non è possibile trovare pDocument nell'elenco dei documenti aperti, non esegue alcuna operazione e restituisce TRUE.
Per utilizzare questo metodo, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES deve essere impostato in m_dwRestartManagerSupportFlags.
CDataRecoveryHandler::ReopenPreviousDocuments
Apre i documenti aperti in precedenza.
virtual BOOL ReopenPreviousDocuments();
Valore restituito
TRUE se è stato aperto almeno un documento; in caso contrario FALSE.
Osservazioni:
Questo metodo apre il salvataggio più recente dei documenti aperti in precedenza. Se un documento non è stato salvato o salvato automaticamente, ReopenPreviousDocuments
apre un documento vuoto basato sul modello per tale tipo di file.
Per utilizzare questo metodo, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES deve essere impostato in m_dwRestartManagerSupportFlags. Se questo parametro non è impostato, ReopenPreviousDocuments
non esegue alcuna operazione e restituisce FALSE.
Se non sono presenti documenti archiviati nell'elenco di documenti aperti in precedenza, ReopenPreviousDocuments
non esegue alcuna operazione e restituisce FALSE.
CDataRecoveryHandler::RestoreAutosavedDocuments
Ripristina i documenti salvati automaticamente in base all'input dell'utente.
virtual BOOL RestoreAutosavedDocuments();
Valore restituito
TRUE se il metodo ripristina correttamente i documenti.
Osservazioni:
Questo metodo chiama CDataRecoveryHandler::QueryRestoreAutosavedDocuments per determinare quali documenti l'utente vuole ripristinare. Se un utente decide di non ripristinare un documento salvato automaticamente, RestoreAutosavedDocuments
elimina il file di salvataggio automatico. In caso contrario, RestoreAutosavedDocuments
sostituisce il documento aperto con la versione salvata automaticamente.
Per usare questo metodo, è necessario impostare AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES o AFX_RESTART_MANAGER_RESTORE_AUTOSAVED_FILES in m_dwRestartManagerSupportFlags
.
CDataRecoveryHandler::SaveOpenDocumentList
Salva l'elenco corrente di documenti aperti nel Registro di sistema di Windows.
virtual BOOL SaveOpenDocumentList();
Valore restituito
TRUE se non sono presenti documenti aperti da salvare o se sono stati salvati correttamente. FALSE se sono presenti documenti da salvare nel Registro di sistema, ma non sono stati salvati perché si è verificato un errore.
Osservazioni:
Il gestore di riavvio chiama SaveOpenDocumentList
quando l'applicazione viene chiusa in modo imprevisto o quando termina per un aggiornamento. Quando l'applicazione viene riavviata, usa CDataRecoveryHandler::ReadOpenDocumentList per recuperare l'elenco di documenti aperti.
Questo metodo salva solo l'elenco di documenti aperti. Il metodo CDataRecoveryHandler::AutosaveDocumentInfo è responsabile del salvataggio dei documenti stessi.
CDataRecoveryHandler::SetAutosaveInterval
Imposta il tempo tra cicli di salvataggio automatico in millisecondi.
Virtual void SetAutosaveInterval(int nAutosaveInterval);
Parametri
nAutosaveInterval
[in] Nuovo intervallo di salvataggio automatico in millisecondi.
CDataRecoveryHandler::SetAutosavePath
Imposta la directory in cui vengono archiviati i file salvati automaticamente.
virtual void SetAutosavePath(const CString& strAutosavePath);
Parametri
strAutosavePath
[in] Percorso in cui vengono archiviati i file di salvataggio automatico.
Osservazioni:
La modifica della directory di salvataggio automatico non sposta i file attualmente salvati automaticamente.
CDataRecoveryHandler::SetRestartIdentifier
Imposta l'identificatore di riavvio univoco per questa istanza di CDataRecoveryHandler
.
virtual void SetRestartIdentifier(const CString& strRestartIdentifier);
Parametri
strRestartIdentifier
[in] Identificatore univoco per il gestore di riavvio.
Osservazioni:
Il gestore di riavvio registra informazioni sui documenti aperti nel Registro di sistema. Queste informazioni vengono archiviate con l'identificatore di riavvio univoco come chiave. Poiché l'identificatore di riavvio è univoco per ogni istanza di un'applicazione, più istanze di un'applicazione possono uscire in modo imprevisto e il gestore di riavvio può recuperarli ognuno di essi.
CDataRecoveryHandler::SetSaveDocumentInfoOnIdle
Imposta un valore che indica se CDataRecoveryHandler
salva le informazioni del documento aperto nel Registro di sistema di Windows durante il ciclo di inattività corrente.
virtual void SetSaveDocumentInfoOnIdle(BOOL bSaveOnIdle);
Parametri
bSaveOnIdle
[in] TRUE per salvare le informazioni del documento durante il ciclo di inattività corrente; FALSE per non eseguire un salvataggio.
CDataRecoveryHandler::SetShutdownByRestartManager
Imposta un valore che indica se l'uscita precedente dell'applicazione è stata causata dal gestore di riavvio.
virtual void SetShutdownByRestartManager(BOOL bShutdownByRestartManager);
Parametri
bShutdownByRestartManager
[in] TRUE per indicare che il gestore di riavvio ha causato la chiusura dell'applicazione; FALSE per indicare che l'applicazione è stata chiusa per un altro motivo.
Osservazioni:
Il framework si comporta in modo diverso in base al fatto che l'uscita precedente sia stata imprevista o se è stata avviata dal gestore di riavvio.
CDataRecoveryHandler::UpdateDocumentInfo
Aggiorna le informazioni per un documento perché l'utente l'ha salvata.
virtual BOOL UpdateDocumentInfo(CDocument* pDocument);
Parametri
pDocument
[in] Puntatore al documento salvato.
Valore restituito
TRUE se questo metodo ha eliminato il documento salvato automaticamente e aggiornato le informazioni del documento; FALSE se si è verificato un errore.
Osservazioni:
Quando un utente salva un documento, l'applicazione rimuove il file salvato automaticamente perché non è più necessario. UpdateDocumentInfo
elimina il file salvato automaticamente chiamando CDataRecoveryHandler::RemoveDocumentInfo. UpdateDocumentInfo
aggiunge quindi le informazioni da pDocument all'elenco dei documenti attualmente aperti perché RemoveDocumentInfo
elimina tali informazioni, ma il documento salvato è ancora aperto.
Per utilizzare questo metodo, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES deve essere impostato in m_dwRestartManagerSupportFlags.
Vedi anche
Classi
Grafico della gerarchia
Classe CObject
Procedura: Aggiungere il supporto di Gestione riavvio