Classe CDockState
Classe CObject serializzata che carica, scarica o cancella lo stato di una o più barre di controllo ancorabili nella memoria persistente (un file).
Sintassi
class CDockState : public CObject
Membri
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CDockState::Clear | Cancella le informazioni sullo stato del dock. |
| CDockState::GetVersion | Recupera il numero di versione dello stato della barra archiviata. |
| CDockState::LoadState | Recupera le informazioni sullo stato dal Registro di sistema o da . File INI. |
| CDockState::SaveState | Salva le informazioni sullo stato nel registro o nel file INI. |
Membri dati pubblici
| Nome | Descrizione |
|---|---|
| CDockState::m_arrBarInfo | Matrice di puntatori alle informazioni sullo stato di ancoraggio archiviate con una voce per ogni barra di controllo. |
Osservazioni:
Lo stato dock include le dimensioni e la posizione della barra e indica se è ancorata o meno. Quando si recupera lo stato del dock archiviato, CDockState controlla la posizione della barra e, se la barra non è visibile con le impostazioni dello schermo correnti, CDockState ridimensiona la posizione della barra in modo che sia visibile. Lo scopo principale di è quello di CDockState contenere l'intero stato di una serie di barre di controllo e di consentire il salvataggio e il caricamento di tale stato nel Registro di sistema, dell'applicazione. File INI o in formato binario come parte del contenuto di un CArchive oggetto.
La barra può essere qualsiasi barra di controllo ancorabile, tra cui una barra degli strumenti, una barra di stato o una barra di dialogo. CDockState gli oggetti vengono scritti e letti da o verso un file tramite un CArchive oggetto .
CFrameWnd::GetDockState recupera le informazioni sullo stato di tutti gli oggetti della CControlBar finestra cornice e lo inserisce nell'oggetto CDockState . È quindi possibile scrivere il contenuto dell'oggetto nell'archiviazione CDockState con Serialize o CDockState::SaveState. Se in un secondo momento si vuole ripristinare lo stato delle barre di controllo nella finestra cornice, è possibile caricare lo stato con Serialize o CDockState::LoadState, quindi usare CFrameWnd::SetDockState per applicare lo stato salvato alle barre di controllo della finestra cornice.
Per altre informazioni sulle barre di controllo di ancoraggio, vedi gli articoli Barre di controllo, Barre degli strumenti: Ancoraggio e Finestre cornice.
Gerarchia di ereditarietà
CDockState
Requisiti
Intestazione: afxadv.h
CDockState::Clear
Chiamare questa funzione per cancellare tutte le informazioni di ancoraggio archiviate nell'oggetto CDockState .
void Clear();
Osservazioni:
Ciò include non solo se la barra è ancorata o meno, ma anche se la dimensione e la posizione della barra e se è visibile o meno.
CDockState::GetVersion
Chiamare questa funzione per recuperare il numero di versione dello stato della barra archiviata.
DWORD GetVersion();
Valore restituito
1 se le informazioni sulla barra archiviate sono precedenti allo stato della barra corrente; 2 se le informazioni sulla barra archiviate corrispondono allo stato della barra corrente.
Osservazioni:
Il supporto della versione consente a una barra modificata di aggiungere nuove proprietà persistenti e di poter comunque rilevare e caricare lo stato persistente creato da una versione precedente della barra.
CDockState::LoadState
Chiamare questa funzione per recuperare le informazioni sullo stato dal Registro di sistema o . File INI.
void LoadState(LPCTSTR lpszProfileName);
Parametri
lpszProfileName
Punta a una stringa con terminazione Null che specifica il nome di una sezione nel file di inizializzazione o una chiave nel Registro di sistema di Windows in cui vengono archiviate le informazioni sullo stato.
Osservazioni:
Il nome del profilo è la sezione dell'oggetto dell'applicazione. File INI o registro che contiene le informazioni sullo stato delle barre. È possibile salvare le informazioni sullo stato della barra di controllo nel Registro di sistema o in . File INI con SaveState.
CDockState::m_arrBarInfo
Oggetto CPtrArray che rappresenta una matrice di puntatori alle informazioni sulla barra di controllo archiviate per ogni barra di controllo con informazioni sullo stato salvate nell'oggetto CDockState .
CPtrArray m_arrBarInfo;
CDockState::SaveState
Chiamare questa funzione per salvare le informazioni sullo stato nel Registro di sistema o in . File INI.
void SaveState(LPCTSTR lpszProfileName);
Parametri
lpszProfileName
Punta a una stringa null-teminata che specifica il nome di una sezione nel file di inizializzazione o una chiave nel Registro di sistema di Windows in cui vengono archiviate le informazioni sullo stato.
Osservazioni:
Il nome del profilo è la sezione dell'oggetto dell'applicazione. File INI o registro che contiene le informazioni sullo stato della barra dei controlli. SaveState salva anche le dimensioni correnti dello schermo. È possibile recuperare le informazioni sulla barra di controllo dal Registro di sistema o . File INI con LoadState.