Classe CWinAppEx

CWinAppEx gestisce lo stato dell'applicazione, salva lo stato nel Registro di sistema, carica lo stato dal Registro di sistema, inizializza le gestioni applicazioni e fornisce collegamenti a tali gestori applicazioni.

Per altri dettagli, vedere il codice sorgente che si trova nella mfc cartella dell'installazione di Visual Studio. Ad esempio: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintassi

class CWinAppEx : public CWinApp

Membri

Costruttori pubblici

Nome	Descrizione
CWinAppEx::CWinAppEx	Costruisce un oggetto CWinAppEx.

Metodi pubblici

Nome	Descrizione
CWinAppEx::CleanState	Rimuove le informazioni sull'applicazione dal Registro di sistema di Windows.
CWinAppEx::EnableLoadWindowPlacement	Specifica se l'applicazione caricherà le dimensioni iniziali e la posizione della finestra cornice principale dal Registro di sistema.
CWinAppEx::EnableTearOffMenus	Abilita i menu di disinstallazione per l'applicazione.
CWinAppEx::EnableUserTools	Consente all'utente di creare comandi di menu personalizzati nell'applicazione.
CWinAppEx::ExitInstance	Chiamato dal framework dall'interno della Run funzione membro per uscire da questa istanza dell'applicazione. Esegue l'override di CWinApp::ExitInstance.
CWinAppEx::GetBinary	Legge i dati binari associati al valore del Registro di sistema specificato.
CWinAppEx::GetContextMenuManager	Restituisce un puntatore all'oggetto globale CContextMenuManager .
CWinAppEx::GetDataVersion
CWinAppEx::GetDataVersionMajor	Restituisce la versione principale dell'applicazione salvata nel Registro di sistema di Windows.
CWinAppEx::GetDataVersionMinor	Restituisce la versione secondaria dell'applicazione salvata nel Registro di sistema di Windows.
CWinAppEx::GetInt	Legge i dati numerici associati al valore specificato dal Registro di sistema.
CWinAppEx::GetKeyboardManager	Restituisce un puntatore all'oggetto globale CKeyboardManager .
CWinAppEx::GetMouseManager	Restituisce un puntatore all'oggetto globale CMouseManager .
CWinAppEx::GetObject	Legge i CObjectdati derivati da associati al valore specificato dal Registro di sistema.
CWinAppEx::GetRegSectionPath	Restituisce una stringa che rappresenta il percorso di una chiave del Registro di sistema. Questo percorso concatena il percorso relativo fornito con il percorso dell'applicazione.
CWinAppEx::GetRegistryBase	Restituisce il percorso del Registro di sistema per l'applicazione.
CWinAppEx::GetSectionBinary	Legge i dati binari associati alla chiave e al valore specificati dal Registro di sistema.
CWinAppEx::GetSectionInt	Legge i dati numerici dal Registro di sistema associato alla chiave e al valore specificati.
CWinAppEx::GetSectionObject	Legge i CObject dati associati alla chiave e al valore specificati dal Registro di sistema.
CWinAppEx::GetSectionString	Legge i dati stringa associati alla chiave e al valore specificati dal Registro di sistema.
CWinAppEx::GetShellManager	Restituisce un puntatore all'oggetto globale CShellManager .
CWinAppEx::GetString	Legge i dati stringa associati al valore specificato dal Registro di sistema.
CWinAppEx::GetTooltipManager	Restituisce un puntatore all'oggetto globale CTooltipManager .
CWinAppEx::GetUserToolsManager	Restituisce un puntatore all'oggetto globale CUserToolsManager .
CWinAppEx::InitContextMenuManager	Inizializza l'oggetto CContextMenuManager.
CWinAppEx::InitKeyboardManager	Inizializza l'oggetto CKeyboardManager.
CWinAppEx::InitMouseManager	Inizializza l'oggetto CMouseManager.
CWinAppEx::InitShellManager	Inizializza la CShellManager classe
CWinAppEx::InitTooltipManager	Inizializza la CTooltipManager classe .
CWinAppEx::IsResourceSmartUpdate
CWinAppEx::IsStateExists	Indica se la chiave specificata si trova nel Registro di sistema.
CWinAppEx::LoadState	Carica lo stato dell'applicazione dal Registro di sistema.
CWinAppEx::OnAppContextHelp	Chiamato dal framework quando l'utente richiede la Guida al contesto per la finestra di dialogo Personalizzazione .
CWinAppEx::OnViewDoubleClick	Chiama il comando definito dall'utente quando l'utente fa doppio clic in qualsiasi punto dell'applicazione.
CWinAppEx::OnWorkspaceIdle
CWinAppEx::SaveState	Scrive lo stato del framework dell'applicazione nel Registro di sistema di Windows.
CWinAppEx::SetRegistryBase	Imposta il percorso della chiave del Registro di sistema predefinita. Questa chiave fungerà da radice per tutte le chiamate del Registro di sistema successive.
CWinAppEx::ShowPopupMenu	Visualizza un menu popup.
CWinAppEx::WriteBinary	Scrive i dati binari nel valore del Registro di sistema specificato.
CWinAppEx::WriteInt	Scrive i dati numerici nel valore del Registro di sistema specificato.
CWinAppEx::WriteObject	Scrive i dati derivati dalla CObject classe nel valore del Registro di sistema specificato.
CWinAppEx::WriteSectionBinary	Scrive i dati binari in un valore della chiave del Registro di sistema specificata.
CWinAppEx::WriteSectionInt	Scrive i dati numerici in un valore della chiave del Registro di sistema specificata.
CWinAppEx::WriteSectionObject	Scrive i dati derivati dalla CObject classe in un valore della chiave del Registro di sistema specificata.
CWinAppEx::WriteSectionString	Scrive i dati stringa in un valore della chiave del Registro di sistema specificata.
CWinAppEx::WriteString	Scrive i dati stringa nel valore del Registro di sistema specificato.

Metodi protetti

Nome	Descrizione
CWinAppEx::LoadCustomState	Chiamato dal framework quando lo stato dell'applicazione è stato caricato.
CWinAppEx::LoadWindowPlacement	Chiamato dal framework quando carica le dimensioni e la posizione dell'applicazione dal Registro di sistema. I dati caricati includono le dimensioni e la posizione del fotogramma principale al momento dell'ultima chiusura dell'applicazione.
CWinAppEx::OnClosingMainFrame	Chiamato dal framework quando una finestra cornice principale elabora WM_CLOSE.
CWinAppEx::PreLoadState	Chiamato dal framework immediatamente prima del caricamento dello stato dell'applicazione.
CWinAppEx::PreSaveState	Chiamato dal framework immediatamente prima del salvataggio dello stato dell'applicazione.
CWinAppEx::ReloadWindowPlacement	Ricarica le dimensioni e il percorso della finestra fornita dal Registro di sistema
CWinAppEx::SaveCustomState	Chiamato dal framework dopo che scrive lo stato dell'applicazione nel Registro di sistema.
CWinAppEx::StoreWindowPlacement	Chiamato dal framework per scrivere le dimensioni e la posizione del frame principale nel Registro di sistema.

Membri dei dati

Nome	Descrizione
CWinAppEx::m_bForceImageReset	Specifica se il framework reimposta tutte le immagini della barra degli strumenti quando viene caricata la finestra cornice che contiene la barra degli strumenti.

Osservazioni:

Gran parte delle funzionalità fornite dal framework MFC dipende CWinAppEx dalla classe . È possibile incorporare la CWinAppEx classe nell'applicazione in uno dei due modi seguenti:

• Costruire una CWinAppEx classe nel thread principale.

• Derivare la classe dell'applicazione principale da CWinAppEx.

Dopo aver incorporato CWinAppEx nell'applicazione, è possibile inizializzare uno qualsiasi dei gestori applicazioni. Prima di usare un gestore applicazioni, è necessario inizializzarlo chiamando il metodo di inizializzazione appropriato. Per ottenere un puntatore a un gestore specifico, chiamare il metodo get associato. La CWinAppEx classe gestisce le gestioni applicazioni seguenti:CMouseManager Classe,CContextMenuManager Classe,CKeyboardManager Classe,CUserToolsManager Classe e CMenuTearOffManager Classe.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWinThread

CWinApp

CWinAppEx

Requisiti

Intestazione: afxwinappex.h

CWinAppEx::CleanState

Rimuove tutte le informazioni sull'applicazione dal Registro di sistema di Windows.

virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);

Parametri

lpszSectionName
[in] Stringa contenente un percorso di una chiave del Registro di sistema.

Valore restituito

Diverso da zero se il metodo ha avuto esito positivo; in caso contrario, 0.

Osservazioni:

Questo metodo cancella i dati dell'applicazione da una sezione specifica del Registro di sistema. È possibile specificare la sezione da cancellare usando il parametro lpszSectionName. Se lpszSectionName è NULL, questo metodo userà il percorso predefinito del Registro di sistema archiviato nell'oggetto CWinAppEx . Per ottenere il percorso predefinito del Registro di sistema, usare CWinAppEx::GetRegistryBase.

CWinAppEx::CWinAppEx

Costruisce un oggetto CWinAppEx.

CWinAppEx(BOOL bResourceSmartUpdate = FALSE);

Parametri

bResourceSmartUpdate
[in] Parametro booleano che specifica se l'oggetto area di lavoro deve rilevare e gestire gli aggiornamenti delle risorse.

Osservazioni:

La CWinAppEx classe dispone di metodi di inizializzazione, fornisce funzionalità per il salvataggio e il caricamento delle informazioni dell'applicazione nel Registro di sistema e controlla le impostazioni globali dell'applicazione. Consente anche di usare gestori globali, ad esempio classe CKeyboardManager e classe.CUserToolsManager Ogni applicazione può avere una sola istanza della CWinAppEx classe .

CWinAppEx::EnableLoadWindowPlacement

Specifica se l'applicazione caricherà le dimensioni iniziali e la posizione della finestra cornice principale dal Registro di sistema.

void EnableLoadWindowPlacement(BOOL bEnable = TRUE);

Parametri

bEnable
[in] Specifica se l'applicazione carica le dimensioni iniziali e la posizione della finestra cornice principale dal Registro di sistema.

Osservazioni:

Per impostazione predefinita, le dimensioni e la posizione del frame principale vengono caricate dal Registro di sistema insieme ad altre impostazioni dell'applicazione. Ciò si verifica durante CWinAppEx::LoadState. Se non si vuole caricare il posizionamento iniziale della finestra dal Registro di sistema, chiamare questo metodo con bEnable impostato su FALSE.

CWinAppEx::EnableTearOffMenus

Crea e inizializza un CMenuTearOffManager oggetto .

BOOL EnableTearOffMenus(
    LPCTSTR lpszRegEntry,
    const UINT uiCmdFirst,
    const UINT uiCmdLast);

Parametri

lpszRegEntry
[in] Stringa che contiene il percorso di una chiave del Registro di sistema. L'applicazione usa questa chiave del Registro di sistema per archiviare le informazioni per i menu di disinstallazione.

uiCmdFirst
[in] Il primo ID del menu di disinstallazione.

uiCmdLast
[in] ULTIMO ID menu di disinstallazione.

Valore restituito

TRUE se l'oggetto CMenuTearOffManager viene creato e inizializzato correttamente; FALSE se si verifica un errore o se l'oggetto CMenuTearOffManager esiste già.

Osservazioni:

Usare questa funzione per abilitare i menu di disinstallazione nell'applicazione. È necessario chiamare questa funzione da InitInstance.

CWinAppEx::EnableUserTools

Consente all'utente di creare comandi di menu personalizzati che riducono le sequenze di tasti nell'applicazione. Questo metodo crea un CUserToolsManager oggetto .

BOOL EnableUserTools(
    const UINT uiCmdToolsDummy,
    const UINT uiCmdFirst,
    const UINT uiCmdLast,
    CRuntimeClass* pToolRTC = RUNTIME_CLASS(CUserTool),
    UINT uArgMenuID = 0,
    UINT uInitDirMenuID = 0);

Parametri

uiCmdToolsDummy
[in] Intero senza segno utilizzato dal framework come segnaposto per l'ID comando del menu degli strumenti utente.

uiCmdFirst
[in] ID comando per il primo comando dello strumento utente.

uiCmdLast
[in] ID comando per l'ultimo comando dello strumento utente.

pToolRTC
[in] Classe utilizzata dall'oggetto CUserToolsManager per creare nuovi strumenti utente.

uArgMenuID
[in] ID del menu dell'argomento.

uInitDirMenuID
[in] ID del menu per la directory iniziale dello strumento.

Valore restituito

TRUE se il metodo crea e inizializza un CUserToolsManager oggetto; FALSE se il metodo ha esito negativo o se esiste già un CUserToolsManager oggetto.

Osservazioni:

Quando si abilitano gli strumenti definiti dall'utente, il framework supporta automaticamente un menu dinamico che può essere esteso durante la personalizzazione. Il framework associa ogni nuovo elemento a un comando esterno. Il framework richiama questi comandi quando l'utente seleziona la voce appropriata dal menu Strumenti .

Ogni volta che l'utente aggiunge un nuovo elemento, il framework crea un nuovo oggetto. Il tipo di classe per il nuovo oggetto è definito da pToolRTC. Il pToolRTC tipo di classe deve essere derivato dalla CUserTool classe .

Per altre informazioni sugli strumenti utente e su come incorporarli nell'applicazione, vedere Strumenti definiti dall'utente.

CWinAppEx::ExitInstance

virtual int ExitInstance();

Valore restituito

Osservazioni:

CWinAppEx::GetBinary

Legge i dati binari da una chiave del Registro di sistema specificata.

BOOL GetBinary(
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parametri

lpszEntry
[in] Stringa contenente il nome di una chiave del Registro di sistema.

ppData
[out] Puntatore al buffer riempito dal metodo con i dati binari.

pBytes
[out] Puntatore a un intero senza segno utilizzato dal metodo per scrivere il numero di byte letti.

Valore restituito

TRUE se ha esito positivo; FALSE altrimenti.

Osservazioni:

Questo metodo legge i dati binari scritti nel Registro di sistema. Per scrivere dati nel Registro di sistema, usare i metodi CWinAppEx::WriteBinary e CWinAppEx::WriteSectionBinary.

Il lpszEntry parametro è il nome di una voce del Registro di sistema che si trova nella chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetContextMenuManager

Restituisce un puntatore all'oggetto globale CContextMenuManager .

CContextMenuManager* GetContextMenuManager();

Valore restituito

Puntatore all'oggetto globale CContextMenuManager .

Osservazioni:

Se l'oggetto CContextMenuManager non viene inizializzato, questa funzione chiama CWinAppEx::InitContextMenuManager prima di restituire un puntatore.

CWinAppEx::GetDataVersion

int GetDataVersion() const;

Valore restituito

Osservazioni:

CWinAppEx::GetDataVersionMajor

Restituisce la versione principale dell'applicazione salvata nel Registro di sistema di Windows quando si chiama CWinAppEx::SaveState.

int GetDataVersionMajor() const;

Valore restituito

Valore intero che contiene il numero di versione principale.

CWinAppEx::GetDataVersionMinor

Restituisce la versione secondaria dell'applicazione salvata nel Registro di sistema di Windows quando si chiama CWinAppEx::SaveState.

int GetDataVersionMinor() const;

Valore restituito

Valore intero che contiene il numero di versione secondario.

CWinAppEx::GetInt

Legge i dati integer da una chiave del Registro di sistema specificata.

int GetInt(
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parametri

lpszEntry
[in] Stringa contenente il nome di una voce del Registro di sistema.

nDefault
[in] Valore predefinito restituito dal metodo se la voce del Registro di sistema specificata non esiste.

Valore restituito

Dati del Registro di sistema se il metodo ha avuto esito positivo; in caso contrario nDefault, .

Osservazioni:

Questo metodo legge i dati integer dal Registro di sistema. Se non sono presenti dati integer associati alla chiave del Registro di sistema indicata da lpszEntry, questo metodo restituisce nDefault. Per scrivere dati nel Registro di sistema, usare i metodi CWinAppEx::WriteSectionInt e CWinAppEx::WriteInt.

Il lpszEntry parametro è il nome di una voce del Registro di sistema che si trova nella chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetKeyboardManager

Restituisce un puntatore all'oggetto globale CKeyboardManager .

CKeyboardManager* GetKeyboardManager();

Valore restituito

Puntatore all'oggetto globale CKeyboardManager .

Osservazioni:

Se il gestore della tastiera non è inizializzato, questa funzione chiama CWinAppEx::InitKeyboardManager prima di restituire un puntatore.

CWinAppEx::GetMouseManager

Restituisce un puntatore all'oggetto globale CMouseManager .

CMouseManager* GetMouseManager();

Valore restituito

Puntatore all'oggetto globale CMouseManager .

Osservazioni:

Se il gestore del mouse non viene inizializzato, questa funzione chiama CWinAppEx::InitMouseManager prima di restituire un puntatore.

CWinAppEx::GetObject

Legge i CObjectdati derviati dal Registro di sistema.

BOOL GetObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parametri

lpszEntry
[in] Stringa contenente il percorso relativo di una voce del Registro di sistema.

obj
[out] Riferimento a un oggetto CObject. Il metodo usa questo riferimento per archiviare i dati del Registro di sistema.

Valore restituito

Diverso da zero se il metodo ha avuto esito positivo; in caso contrario, 0.

Osservazioni:

Questo metodo legge i dati dal Registro di sistema derivato da CObject. Per scrivere CObject dati nel Registro di sistema, usare CWinAppEx::WriteObject o CWinAppEx::WriteSectionObject.

Il lpszEntry parametro è il nome di una voce del Registro di sistema che si trova sotto la chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetRegistryBase

Recupera il percorso predefinito del Registro di sistema per l'applicazione.

LPCTSTR GetRegistryBase();

Valore restituito

Stringa contenente il percorso del Registro di sistema predefinito.

Osservazioni:

Tutti i metodi della CWinAppEx classe che accedono al Registro di sistema iniziano in un percorso predefinito. Utilizzare questo metodo per recuperare un percorso del registro predefinito. Usare CWinAppEx::SetRegistryBase per modificare il percorso predefinito del Registro di sistema.

CWinAppEx::GetRegSectionPath

Crea e restituisce il percorso assoluto di una chiave del Registro di sistema.

CString GetRegSectionPath(LPCTSTR szSectionAdd = _T(""));

Parametri

szSectionAdd
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

Valore restituito

Oggetto CString contenente il percorso assoluto di una chiave del Registro di sistema.

Osservazioni:

Questo metodo definisce il percorso assoluto della chiave del Registro di sistema aggiungendo il percorso relativo in szSectionAdd al percorso predefinito del Registro di sistema per l'applicazione. Per ottenere la chiave del Registro di sistema predefinita, usare il metodo CWinAppEx::GetRegistryBase.

CWinAppEx::GetSectionBinary

Legge i dati binari dal Registro di sistema.

BOOL GetSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parametri

lpszSubSection
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

lpszEntry
[in] Stringa contenente il valore da leggere.

ppData
[out] Puntatore al buffer in cui il metodo archivia i dati.

pBytes
[out] Puntatore a un intero senza segno. Il metodo scrive le dimensioni di ppData in questo parametro.

Valore restituito

TRUE se l'esito è positivo; in caso contrario, FALSE.

Osservazioni:

Questo metodo legge i dati binari scritti nel Registro di sistema usando i metodi CWinAppEx::WriteBinary e CWinAppEx::WriteSectionBinary.

Il lpszSubSection parametro non è un percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetSectionInt

Legge i dati integer dal Registro di sistema.

int GetSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parametri

lpszSubSection
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

lpszEntry
[in] Stringa contenente il valore da leggere.

nDefault
[in] Valore predefinito da restituire se il valore specificato non esiste.

Valore restituito

Dati integer archiviati nel valore del Registro di sistema specificato; nDefault se i dati non esistono.

Osservazioni:

Utilizzare i metodi CWinAppEx::WriteInt e CWinAppEx::WriteSectionInt per scrivere dati integer nel Registro di sistema.

Il lpszSubSection parametro non è un percorso assoluto di una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetSectionObject

Legge i CObject dati del Registro di sistema dal Registro di sistema.

BOOL GetSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parametri

lpszSubSection
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

lpszEntry
[in] Stringa contenente il valore da leggere.

obj
[out] Riferimento a un oggetto CObject. Il metodo usa questa CObject opzione per archiviare i dati del Registro di sistema.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questo metodo legge i dati dal Registro di sistema. I dati letti sono CObject dati o dati per una classe derivata da CObject. Per scrivere CObject dati nel Registro di sistema, usare CWinAppEx::WriteObject o CWinAppEx::WriteSectionObject.

Il lpszSubSection parametro non è un percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetSectionString

Legge i dati stringa dal Registro di sistema.

CString GetSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszDefault = _T(""));

Parametri

lpszSubSection
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

lpszEntry
[in] Stringa contenente il valore da leggere.

lpszDefault
[in] Valore predefinito da restituire se il valore specificato non esiste.

Valore restituito

Dati stringa archiviati nel valore del Registro di sistema specificato se i dati esistono; in caso contrario lpszDefault, .

Osservazioni:

Questo metodo legge i dati stringa scritti nel Registro di sistema. Usare CWinAppEx::WriteString e CWinAppEx::WriteSectionString per scrivere dati stringa nel Registro di sistema.

Il lpszSubSection parametro non è un percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetShellManager

Restituisce un puntatore all'oggetto globale CShellManager .

CShellManager* GetShellManager();

Valore restituito

Puntatore all'oggetto globale CShellManager .

Osservazioni:

Se l'oggetto CShellManager non viene inizializzato, questa funzione chiama CWinAppEx::InitShellManager prima di restituire un puntatore.

CWinAppEx::GetString

Legge i dati stringa da una chiave del Registro di sistema specificata.

CString GetString(
    LPCTSTR lpszEntry,
    LPCTSTR lpzDefault= _T(""));

Parametri

lpszEntry
[in] Stringa contenente il nome di una chiave del Registro di sistema

lpzDefault
[in] Valore predefinito restituito dal metodo se la voce del Registro di sistema specificata non esiste.

Valore restituito

I dati stringa archiviati nel Registro di sistema se hanno esito positivo; lpszDefault altrimenti.

Osservazioni:

Questo metodo legge i dati stringa scritti nel Registro di sistema. Per scrivere dati nel Registro di sistema, usare i metodi CWinAppEx::WriteString o CWinAppEx::WriteSectionString.

Il lpszEntry parametro è il nome di una voce del Registro di sistema che si trova nella chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::GetTooltipManager

Restituisce un puntatore all'oggetto globale CTooltipManager .

CTooltipManager* GetTooltipManager();

Valore restituito

Puntatore all'oggetto globale CTooltipManager .

Osservazioni:

Se l'oggetto CTooltipManager non viene inizializzato, questa funzione chiama CWinAppEx::InitTooltipManager prima di restituire un puntatore.

CWinAppEx::GetUserToolsManager

Restituisce un puntatore all'oggetto globale CUserToolsManager .

CUserToolsManager* GetUserToolsManager();

Valore restituito

Puntatore all'oggetto globale CUserToolsManager ; NULL se la gestione degli strumenti utente non è abilitata per l'applicazione.

Osservazioni:

Prima di recuperare un puntatore all'oggetto CUserToolsManager , è necessario inizializzare il gestore chiamando CWinAppEx::EnableUserTools.

CWinAppEx::InitContextMenuManager

Inizializza l'oggetto CContextMenuManager.

BOOL InitContextMenuManager();

Valore restituito

Diverso da zero se il metodo crea l'oggetto CContextMenuManager ; 0 se l'oggetto CContextMenuManager esiste già.

Osservazioni:

Se si chiama CWinAppEx::GetContextMenuManager, l'implementazione predefinita di tale metodo chiama InitContextMenuManager.

Se l'applicazione dispone già di un gestore menu di scelta rapida e si chiama InitContextMenuManager, l'applicazione avrà un ASSERT errore. Pertanto, non è consigliabile chiamare InitContextMenuManager se si crea direttamente un CContextMenuManager oggetto. Se non si usa un oggetto personalizzato CContextMenuManager, è consigliabile usare GetContextMenuManager per creare un CContextMenuManager oggetto .

CWinAppEx::InitKeyboardManager

Inizializza l'oggetto CKeyboardManager.

BOOL InitKeyboardManager();

Valore restituito

Diverso da zero se il metodo crea l'oggetto CKeyboardManager ; 0 se l'oggetto CKeyboardManager esiste già.

Osservazioni:

Se si chiama CWinAppEx::GetKeyboardManager, l'implementazione predefinita di tale metodo chiama InitKeyboardManager.

Se l'applicazione dispone già di un gestore della tastiera e si chiama InitKeyboardManager, l'applicazione avrà un ASSERT errore. Pertanto, non è consigliabile chiamare InitKeyboardManager se si crea direttamente un CKeyboardManager oggetto. Se non si usa un oggetto personalizzato CKeyboardManager, è consigliabile usare GetKeyboardManager per creare un CKeyboardManager oggetto .

CWinAppEx::InitMouseManager

Inizializza l'oggetto CMouseManager.

BOOL InitMouseManager();

Valore restituito

Diverso da zero se il metodo crea l'oggetto CMouseManager ; 0 se l'oggetto CMouseManager esiste già.

Osservazioni:

Se si chiama CWinAppEx::GetMouseManager, l'implementazione predefinita di tale metodo chiama InitMouseManager.

Se l'applicazione dispone già di un gestore del mouse e si chiama InitMouseManager, l'applicazione avrà un ASSERT errore. Pertanto, non è consigliabile chiamare InitMouseManager se si crea direttamente un CMouseManager oggetto. Se non si usa un oggetto personalizzato CMouseManager, è consigliabile usare GetMouseManager per creare un CMouseManager oggetto .

CWinAppEx::InitShellManager

Inizializza l'oggetto CShellManager.

BOOL InitShellManager();

Valore restituito

Diverso da zero se il metodo crea l'oggetto CShellManager ; 0 se l'oggetto CShellManager esiste già.

Osservazioni:

Se si chiama CWinAppEx::GetShellManager, l'implementazione predefinita di tale metodo chiama InitShellManager.

Se l'applicazione dispone già di un gestore shell e si chiama InitShellManager, l'applicazione genera un ASSERT errore. Pertanto, non chiamare InitShellManager se si crea direttamente un CShellManager oggetto. Se non si usa un oggetto personalizzato CShellManager, usare GetShellManager per creare un CShellManager oggetto .

CWinAppEx::InitTooltipManager

Inizializza l'oggetto CTooltipManager.

BOOL InitTooltipManager();

Valore restituito

Diverso da zero se il metodo crea l'oggetto CTooltipManager ; 0 se l'oggetto CTooltipManager esiste già.

Osservazioni:

Se si chiama CWinAppEx::GetTooltipManager, l'implementazione predefinita di tale metodo chiama InitTooltipManager.

Se l'applicazione dispone già di un gestore descrizioni comandi e si chiama InitTooltipManager, l'applicazione avrà un ASSERT errore. Pertanto, non è consigliabile chiamare InitTooltipManager se si crea direttamente un CTooltipManager oggetto. Se non si usa un oggetto personalizzato CTooltipManager, è consigliabile usare GetTooltipManager per creare un CTooltipManager oggetto .

CWinAppEx::IsResourceSmartUpdate

BOOL IsResourceSmartUpdate() const;

Valore restituito

Osservazioni:

CWinAppEx::IsStateExists

Indica se la chiave specificata si trova nel Registro di sistema.

BOOL IsStateExists(LPCTSTR lpszSectionName);

Parametri

lpszSectionName
[in] Stringa contenente un percorso di una chiave del Registro di sistema.

Valore restituito

Diverso da zero se la chiave si trova nel Registro di sistema; in caso contrario, 0.

CWinAppEx::LoadCustomState

Il framework chiama questo metodo dopo il caricamento dello stato dell'applicazione dal Registro di sistema.

virtual void LoadCustomState();

Osservazioni:

Eseguire l'override di questo metodo se si desidera eseguire qualsiasi elaborazione dopo che l'applicazione carica lo stato dal Registro di sistema. Per impostazione predefinita, questo metodo non effettua alcuna operazione.

Per caricare informazioni sullo stato personalizzate dal Registro di sistema, è necessario prima salvare le informazioni usando CWinAppEx::SaveCustomState.

CWinAppEx::LoadState

Legge lo stato dell'applicazione dal Registro di sistema di Windows.

BOOL LoadState(
    CMDIFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL LoadState(
    CFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL LoadState(
    COleIPFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

virtual BOOL LoadState(
    LPCTSTR lpszSectionName = NULL,
    CFrameImpl* pFrameImpl = NULL);

Parametri

pFrame
[in] Puntatore a un oggetto finestra cornice. Il metodo applica le informazioni sullo stato nel Registro di sistema a questa finestra cornice.

lpszSectionName
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

pFrameImpl
[in] Puntatore a un CFrameImpl oggetto . Il metodo applica le informazioni sullo stato nel Registro di sistema a questa finestra cornice.

Valore restituito

Valore diverso da zero in caso di esito positivo, 0 in caso contrario.

Osservazioni:

Questo metodo carica lo stato dell'applicazione e le informazioni sullo stato per una finestra cornice. Le informazioni caricate per la finestra cornice vengono applicate alla finestra cornice fornita. Se non si specifica una finestra cornice, vengono caricate solo le informazioni sullo stato dell'applicazione. Le informazioni sull'applicazione includono lo stato della classe,CContextMenuManager dellaCMouseManager classe, CKeyboardManager della classe e della CUserToolsManager classe .

L'implementazione predefinita di CFrameImpl::OnLoadFrame chiama LoadState.

Il lpszSectionName parametro non è il percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::LoadWindowPlacement

Chiamato dal framework quando carica le dimensioni e la posizione della finestra cornice principale dal Registro di sistema.

virtual BOOL LoadWindowPlacement(
    CRect& rectNormalPosition,
    int& nFlags,
    int& nShowCmd);

Parametri

rectNormalPosition
[out] Rettangolo che contiene le coordinate della finestra cornice principale quando si trova nella posizione ripristinata.

nFlags
[out] Flag che controllano la posizione della finestra ridotta a icona e il modo in cui il sistema operativo passa da una finestra ridotta a icona a una finestra ripristinata.

nShowCmd
[out] Intero che specifica lo stato di visualizzazione della finestra. Per altre informazioni sui valori possibili, vedere CWnd::ShowWindow.

Valore restituito

Valore diverso da zero in caso di esito positivo, 0 in caso contrario.

Osservazioni:

Per impostazione predefinita, MFC carica automaticamente la posizione precedente e lo stato della finestra cornice principale all'avvio dell'applicazione. Per altre informazioni sulla modalità di archiviazione di queste informazioni nel Registro di sistema, vedere CWinAppEx::StoreWindowPlacement.

Eseguire l'override di questo metodo se si desidera caricare informazioni aggiuntive sulla finestra cornice principale.

CWinAppEx::m_bForceImageReset

Specifica se il framework reimposta tutte le immagini della barra degli strumenti quando ricarica la finestra cornice che contiene la barra degli strumenti.

BOOL m_bForceImageReset;

Osservazioni:

Il m_bForceImageReset membro dati è una variabile protetta.

CWinAppEx::OnAppContextHelp

Il framework chiama questo metodo quando l'utente richiede la Guida al contesto per la finestra di dialogo Personalizzazione .

virtual void OnAppContextHelp(
    CWnd* pWndControl,
    const DWORD dwHelpIDArray[]);

Parametri

pWndControl
[in] Puntatore a un oggetto finestra per il quale l'utente ha richiamato la Guida del contesto.

dwHelpIDArray[]
[in] Valore riservato.

Osservazioni:

Questo metodo è attualmente riservato per uso futuro. L'implementazione predefinita non esegue alcuna operazione e non viene attualmente chiamata dal framework.

CWinAppEx::OnClosingMainFrame

Il framework chiama questo metodo quando una finestra cornice elabora WM_CLOSE.

virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);

Parametri

pFrameImpl
[in] Puntatore a un CFrameImpl oggetto .

Osservazioni:

L'implementazione predefinita di questo metodo salva lo stato di pFrameImpl.

CWinAppEx::OnViewDoubleClick

Chiama il comando definito dall'utente associato a una visualizzazione quando l'utente fa doppio clic in un punto qualsiasi all'interno di tale visualizzazione.

virtual BOOL OnViewDoubleClick(
    CWnd* pWnd,
    int iViewId);

Parametri

pWnd
[in] Puntatore a un oggetto derivato dalla CView classe .

iViewId
[in] ID visualizzazione.

Valore restituito

TRUE se il framework trova un comando; in caso contrario FALSE, .

Osservazioni:

Per supportare il comportamento personalizzato del mouse, è necessario chiamare questa funzione quando si elabora il WM_LBUTTONDBLCLK messaggio. Questo metodo eseguirà il comando associato all'ID visualizzazione fornito da iViewId. Per altre informazioni sul comportamento personalizzato del mouse, vedere Personalizzazione della tastiera e del mouse.

CWinAppEx::OnWorkspaceIdle

virtual BOOL OnWorkspaceIdle(CWnd*);

Parametri

[in] CWnd*\

Valore restituito

Osservazioni:

CWinAppEx::PreLoadState

Il framework chiama questo metodo immediatamente prima di caricare lo stato dell'applicazione dal Registro di sistema.

virtual void PreLoadState();

Osservazioni:

Eseguire l'override di questo metodo se si desidera eseguire qualsiasi elaborazione immediatamente prima che il framework carichi lo stato dell'applicazione.

CWinAppEx::PreSaveState

Il framework chiama questo metodo immediatamente prima di salvare lo stato dell'applicazione.

virtual void PreSaveState();

Osservazioni:

Eseguire l'override di questo metodo se si vuole eseguire qualsiasi elaborazione immediatamente prima che il framework salvi lo stato dell'applicazione.

CWinAppEx::ReloadWindowPlacement

Ricarica le dimensioni e la posizione di una finestra dal Registro di sistema.

virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);

Parametri

pFrame
[in] Puntatore a una finestra cornice.

Valore restituito

Diverso da zero se il metodo ha avuto esito positivo; 0 se il caricamento non è riuscito o non sono presenti dati da caricare.

Osservazioni:

Usare la funzione CWinAppEx::StoreWindowPlacement per scrivere le dimensioni e la posizione di una finestra nel Registro di sistema.

CWinAppEx::SaveCustomState

Il framework chiama questo metodo dopo che salva lo stato dell'applicazione nel Registro di sistema.

virtual void SaveCustomState();

Osservazioni:

Eseguire l'override di questo metodo se si desidera eseguire qualsiasi elaborazione dopo che l'applicazione salva lo stato nel Registro di sistema. Per impostazione predefinita, questo metodo non effettua alcuna operazione.

CWinAppEx::SaveState

Scrive lo stato dell'applicazione nel Registro di sistema di Windows.

virtual BOOL SaveState(
    LPCTSTR lpszSectionName = NULL,
    CFrameImpl* pFrameImpl = NULL);

BOOL SaveState(
    CMDIFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL SaveState(
    CFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL SaveState(
    COleIPFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

Parametri

lpszSectionName
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

pFrameImpl
[in] Puntatore a un CFrameImpl oggetto . Questo frame viene salvato nel Registro di sistema di Windows.

pFrame
[in] Puntatore a un oggetto finestra cornice. Questo frame viene salvato nel Registro di sistema di Windows.

Valore restituito

TRUE se ha esito positivo; FALSE altrimenti.

Osservazioni:

Questo metodo salva lo stato dell'applicazione e le informazioni sullo stato per la finestra cornice fornita. Se non si specifica una finestra cornice, il metodo salva solo lo stato dell'applicazione. Le informazioni sull'applicazione includono lo stato della classe,CContextMenuManager dellaCMouseManager classe, CKeyboardManager della classe e della CUserToolsManager classe .

Il lpszSectionName parametro non è il percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

CWinAppEx::SetRegistryBase

Imposta il percorso predefinito del Registro di sistema per l'applicazione.

LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);

Parametri

lpszSectionName
[in] Stringa che contiene il percorso di una chiave del Registro di sistema.

Valore restituito

Stringa contenente il percorso del Registro di sistema predefinito.

Osservazioni:

Tutti i metodi della CWinAppEx classe che accedono al Registro di sistema iniziano in un percorso predefinito. Utilizzare questo metodo per modificare il percorso predefinito del Registro di sistema. Usare CWinAppEx::GetRegistryBase per recuperare il percorso predefinito del Registro di sistema.

CWinAppEx::ShowPopupMenu

Visualizza un menu popup.

virtual BOOL ShowPopupMenu(
    UINT uiMenuResId,
    const CPoint& point,
    CWnd* pWnd);

Parametri

uiMenuResId
[in] ID risorsa del menu.

point
[in] Oggetto CPoint che specifica la posizione del menu nelle coordinate dello schermo.

pWnd
[in] Puntatore alla finestra proprietaria del menu popup.

Valore restituito

Diverso da zero se il menu popup viene visualizzato correttamente; 0 in caso contrario.

Osservazioni:

Questo metodo visualizza il menu associato a uiMenuResId.

Per supportare i menu popup, è necessario disporre di un CContextMenuManager oggetto . Se l'oggetto CContextMenuManager non è stato inizializzato, ShowPopupMenu avrà esito negativo.

CWinAppEx::StoreWindowPlacement

Chiamato dal framework per scrivere le dimensioni e la posizione della finestra cornice principale nel Registro di sistema.

virtual BOOL StoreWindowPlacement(
    const CRect& rectNormalPosition,
    int nFlags,
    int nShowCmd);

Parametri

nFlags
[in] Flag che controllano la posizione della finestra ridotta a icona e il modo in cui il sistema operativo passa da una finestra ridotta a icona a una finestra ripristinata.

nShowCmd
[in] Intero che specifica lo stato di visualizzazione della finestra. Per altre informazioni sui valori possibili, vedere CWnd::ShowWindow.

rectNormalPosition
[in] Rettangolo che contiene le coordinate della finestra cornice principale quando si trova nello stato ripristinato.

Valore restituito

Valore diverso da zero in caso di esito positivo, 0 in caso contrario.

Osservazioni:

Per impostazione predefinita, MFC salva automaticamente la posizione e lo stato della finestra cornice principale prima dell'uscita dall'applicazione. Queste informazioni vengono archiviate nel Registro di sistema di Windows nella chiave WindowPlacement nel percorso predefinito del Registro di sistema per l'applicazione. Per altre informazioni sul percorso predefinito del Registro di sistema dell'applicazione, vedere CWinAppEx::GetRegistryBase.

Eseguire l'override di questo metodo se si desidera archiviare informazioni aggiuntive sulla finestra cornice principale.

CWinAppEx::WriteBinary

Scrive i dati binari nel Registro di sistema.

BOOL WriteBinary(
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parametri

lpszEntry
[in] Stringa contenente il nome di una chiave del Registro di sistema.

pData
[in] Dati da archiviare.

nBytes
[in] Dimensione di pData in byte.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Il lpszEntry parametro è il nome di una voce del Registro di sistema che si trova sotto la chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

Se la chiave specificata da lpszEntry non esiste, questo metodo lo creerà.

CWinAppEx::WriteInt

Scrive dati numerici nel Registro di sistema.

BOOL WriteInt(
    LPCTSTR lpszEntry,
    int nValue);

Parametri

lpszEntry
[in] Stringa contenente il nome di una chiave del Registro di sistema.

nValue
[in] Dati da archiviare.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Il lpszEntry parametro è il nome di una voce del Registro di sistema che si trova nella chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

Se la chiave specificata da lpszEntry non esiste, questo metodo lo creerà.

CWinAppEx::WriteObject

Scrive i dati derivati dalla CObject classe nel Registro di sistema.

BOOL WriteObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parametri

lpszEntry
[in] Stringa contenente il valore da impostare.

obj
[in] Riferimento ai CObject dati archiviati dal metodo.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Questo metodo scrive i obj dati nel valore specificato nella chiave del Registro di sistema predefinita. Usare CWinAppEx::GetRegistryBase per determinare la chiave del Registro di sistema corrente.

CWinAppEx::WriteSectionBinary

Scrive dati binari in un valore nel Registro di sistema.

BOOL WriteSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parametri

lpszSubSection
[in] Stringa contenente il nome di una chiave del Registro di sistema

lpszEntry
[in] Stringa contenente il valore da impostare.

pData
[in] Dati da scrivere nel Registro di sistema.

nBytes
[in] Dimensione di pData in byte.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Il lpszSubSection parametro non è il percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

Se la chiave specificata da lpszEntry non esiste, questo metodo lo creerà.

CWinAppEx::WriteSectionInt

Scrive dati numerici nel Registro di sistema.

BOOL WriteSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nValue);

Parametri

lpszSubSection
[in] Stringa contenente il percorso relativo di una chiave del Registro di sistema.

lpszEntry
[in] Stringa contenente il valore da impostare.

nValue
[in] Dati da scrivere nel Registro di sistema.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Il lpszSubSection parametro non è un percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

Se la chiave specificata da lpszEntry non esiste, questo metodo lo creerà.

CWinAppEx::WriteSectionObject

Scrive i dati derivati dalla CObject classe in un valore del Registro di sistema specifico.

BOOL WriteSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parametri

lpszSubSection
[in] Stringa contenente il nome di una chiave del Registro di sistema.

lpszEntry
[in] Stringa contenente il nome del valore da impostare.

obj
[in] Dati da archiviare.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Il lpszSubSection parametro non è un percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare rispettivamente i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase.

Se il valore specificato da lpszEntry non esiste nella chiave del Registro di sistema specificata da lpszSubSection, questo metodo creerà tale valore.

CWinAppEx::WriteSectionString

Scrive i dati stringa in un valore nel Registro di sistema.

BOOL WriteSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parametri

lpszSubSection
[in] Stringa contenente il nome di una chiave del Registro di sistema.

lpszEntry
[in] Stringa contenente il valore da impostare.

lpszValue
[in] Dati stringa da scrivere nel Registro di sistema.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Il lpszSubSection parametro non è un percorso assoluto per una voce del Registro di sistema. Si tratta di un percorso relativo aggiunto alla fine della chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare rispettivamente i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase.

Se il valore specificato da lpszEntry non esiste in lpszSubSection, questo metodo lo creerà.

CWinAppEx::WriteString

Scrive i dati stringa nel Registro di sistema.

BOOL WriteString(
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parametri

lpszEntry
[in] Stringa contenente il nome di una chiave del Registro di sistema.

lpszValue
[in] Dati da archiviare.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Il lpszEntry parametro è il nome di una voce del Registro di sistema che si trova nella chiave del Registro di sistema predefinita per l'applicazione. Per ottenere o impostare la chiave del Registro di sistema predefinita, usare i metodi CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase rispettivamente.

Se la chiave specificata da lspzEntry non esiste, questo metodo lo creerà.

Vedi anche

Grafico della gerarchia
Classi
CWinApp Classe
CMouseManager Classe
CContextMenuManager Classe
CKeyboardManager Classe
CUserToolsManager Classe