Classe CWinApp

Articolo
06/10/2015

La classe base da cui deriva un oggetto di un'applicazione Windows.

class CWinApp : public CWinThread

Membri

Costruttori pubblici

Nome	Descrizione
CWinApp::CWinApp	Costruisce un oggetto CWinApp.

Metodi pubblici

Nome	Descrizione
CWinApp::AddDocTemplate	Aggiunge un modello di documento all'elenco dell'applicazione dei modelli di documento disponibili.
CWinApp::AddToRecentFileList	Aggiunge un nome file all'elenco dei file aperti più di recente (MRU).
CWinApp::ApplicationRecoveryCallback	Chiamato dal framework quando la chiusura dell'applicazione in modo imprevisto.
CWinApp::CloseAllDocuments	Chiude tutti i documenti aperti.
CWinApp::CreatePrinterDC	Crea un contesto di dispositivo della stampante.
CWinApp::DelRegTree	Elimina una chiave specificata e tutte le relative sottochiavi.
CWinApp::DoMessageBox	Implementa AfxMessageBox per l'applicazione.
CWinApp::DoWaitCursor	Disattiva il cursore di attesa e chiuderlo.
CWinApp::EnableD2DSupport	Abilita il supporto D2D di applicazione. Chiamare questo metodo prima che venga inizializzata la finestra principale.
CWinApp::EnableHtmlHelp	Implementa HTMLHelp per l'applicazione, anziché WinHelp.
CWinApp::EnableTaskbarInteraction	Abilita l'interazione della barra delle applicazioni.
CWinApp::ExitInstance	Override da liberare quando l'applicazione viene chiusa.
CWinApp::GetApplicationRecoveryParameter	Recupera il parametro di input per il metodo di recupero dell'applicazione.
CWinApp::GetApplicationRecoveryPingInterval	Restituisce la durata di Gestione riavvio della funzione di callback di recupero da restituire.
CWinApp::GetApplicationRestartFlags	Restituisce i flag per Gestione riavvio.
CWinApp::GetAppRegistryKey	Chiave per RETURN" \ RegistryKey ProfileName \ software \ "HKEY_CURRENT_USER.
CWinApp::GetDataRecoveryHandler	Ottiene il gestore di ripristinare i dati per questa istanza dell'applicazione.
CWinApp::GetFirstDocTemplatePosition	Recupera la posizione del primo modello di documento.
CWinApp::GetHelpMode	Recupera il tipo della guida utilizzato dall'applicazione.
CWinApp::GetNextDocTemplate	Recupera il percorso di un modello di documento. Può essere utilizzato in modo ricorsivo.
CWinApp::GetPrinterDeviceDefaults	Recupera le impostazioni predefinite del dispositivo della stampante.
CWinApp::GetProfileBinary	Recupera i dati binari da una voce nel file di .INI dell'applicazione.
CWinApp::GetProfileInt	Recupera un numero intero da una voce nel file di .INI dell'applicazione.
CWinApp::GetProfileString	Recupera una stringa da una voce nel file di .INI dell'applicazione.
CWinApp::GetSectionKey	Restituisce la chiave per HKEY_CURRENT_USER\"Software"\RegistryKey\AppName\lpszSection.
CWinApp::HideApplication	Nasconde l'applicazione prima di chiudere tutti i documenti.
CWinApp::HtmlHelp	Chiama la funzione Windows HTMLHelp.
CWinApp::InitInstance	Un override per eseguire l'inizializzazione dell'istanza di Windows, ad esempio creare la finestra oggetto.
CWinApp::IsTaskbarInteractionEnabled	Indica se l'interazione della barra delle applicazioni di Windows 7 è abilitata.
CWinApp::LoadCursor	Carica una risorsa cursore.
CWinApp::LoadIcon	Carica una risorsa icona.
CWinApp::LoadOEMCursor	Carica un cursore predefinito OEM di Windows che le costanti OCR_ specificano in WINDOWS.H.
CWinApp::LoadOEMIcon	Carica l'icona predefinita OEM di Windows che le costanti OIC_ specificano in WINDOWS.H.
CWinApp::LoadStandardCursor	Carica un cursore predefinito Windows che le costanti IDC_ specificano in WINDOWS.H.
CWinApp::LoadStandardIcon	Carica l'icona predefinita Windows che le costanti IDI_ specificano in WINDOWS.H.
CWinApp::OnDDECommand	Chiamato dal framework in risposta a un comando di esecuzione (DDE) di scambio dinamico dati.
CWinApp::OnIdle	Override per eseguire l'elaborazione specifica dell'applicazione di tempo di inattività.
CWinApp::OpenDocumentFile	Chiamato dal framework per aprire un documento da un file.
CWinApp::ParseCommandLine	Analizza i singoli parametri e i flag nella riga di comando.
CWinApp::PreTranslateMessage	Filtri dei messaggi prima che vengano inviati alle funzioni Windows TranslateMessage e DispatchMessage.
CWinApp::ProcessMessageFilter	Alcuni messaggi di interruzione prima che raggiungano l'applicazione.
CWinApp::ProcessShellCommand	Gestisce gli argomenti della riga di comando e i flag.
CWinApp::ProcessWndProcException	Intercetti tutte le eccezioni non gestite generate dal messaggio e i gestori comandi dell'applicazione.
CWinApp::Register	Performs ha personalizzato la registrazione.
CWinApp::RegisterWithRestartManager	Registra l'applicazione con Gestione riavvio.
CWinApp::ReopenPreviousFilesAtRestart	Determina se Gestione riavvio riaprire i file non aperti quando l'applicazione viene rilasciato in modo imprevisto.
CWinApp::RestartInstance	Gestisce il riavvio di un'applicazione avviata da Gestione riavvio.
CWinApp::RestoreAutosavedFilesAtRestart	Determina se Gestione riavvio ripristina i file autosaved quando si riavvia l'applicazione.
CWinApp::Run	Esegue il ciclo di messaggi predefinito. Override per personalizzare il ciclo di messaggi.
CWinApp::RunAutomated	Verifica la riga di comando dell'applicazione per l'opzione /Automation. Obsoleta. Al contrario, utilizzare il valore in CCommandLineInfo::m_bRunAutomated dopo aver chiamato ParseCommandLine.
CWinApp::RunEmbedded	Verifica la riga di comando dell'applicazione per l'opzione /Embedding. Obsoleta. Al contrario, utilizzare il valore in CCommandLineInfo::m_bRunEmbedded dopo aver chiamato ParseCommandLine.
CWinApp::SaveAllModified	Richiede all'utente di salvare tutti i documenti modificati.
CWinApp::SelectPrinter	Selezionare una stampante precedentemente indicata da un utente tramite una finestra di dialogo stampa.
CWinApp::SetHelpMode	Set e inizializza il tipo della guida utilizzato dall'applicazione.
CWinApp::SupportsApplicationRecovery	Determina se Gestione riavvio recupera un'applicazione che viene rilasciato in modo imprevisto.
CWinApp::SupportsAutosaveAtInterval	Determina se Gestione riavvio autosaves i documenti aperti a intervalli regolari.
CWinApp::SupportsAutosaveAtRestart	Determina se Gestione riavvio autosaves tutti i documenti aperti quando l'applicazione viene riavviata.
CWinApp::SupportsRestartManager	Determina se l'applicazione supporta Gestione riavvio.
CWinApp::Unregister	Annulla la registrazione tutto conosciuto per essere registrato dall'oggetto CWinApp.
CWinApp::WinHelp	Chiama la funzione Windows WinHelp.
CWinApp::WriteProfileBinary	Scrive i dati binari in una voce nel file di .INI dell'applicazione.
CWinApp::WriteProfileInt	Scrive un Integer a una voce nel file di .INI dell'applicazione.
CWinApp::WriteProfileString	Scrive una stringa a una voce nel file di .INI dell'applicazione.

Metodi protetti

Nome	Descrizione
CWinApp::EnableShellOpen	Consente all'utente nei file di dati aperti dal File Manager di Windows.
CWinApp::LoadStdProfileSettings	Le impostazioni del file standard .INI carichi e abilita la funzionalità dell'elenco file utilizzati di recente.
CWinApp::OnContextHelp	Guida di handle MAIUSC+F1 interno dell'applicazione.
CWinApp::OnFileNew	Implementa il comando ID_FILE_NEW.
CWinApp::OnFileOpen	Implementa il comando ID_FILE_OPEN.
CWinApp::OnFilePrintSetup	Implementa il comando ID_FILE_PRINT_SETUP.
CWinApp::OnHelp	Guida di handle nell'applicazione utilizzando il contesto corrente).
CWinApp::OnHelpFinder	Gestisce i controlli ID_DEFAULT_HELP e ID_HELP_FINDER.
CWinApp::OnHelpIndex	Gestisce il comando ID_HELP_INDEX e fornisce un argomento della Guida predefinito.
CWinApp::OnHelpUsing	Gestisce il comando ID_HELP_USING.
CWinApp::RegisterShellFileTypes	Registra i tipi di documento di qualsiasi applicazione con il File Manager di Windows.
CWinApp::SetAppID	Impostato in modo esplicito l'id modello dell'applicazione per l'applicazione. Questo metodo deve essere chiamato prima che qualsiasi interfaccia utente è identico all'utente (la posizione migliore dal costruttore di applicazione).
CWinApp::SetRegistryKey	Le impostazioni dell'applicazione causato da archiviare nel Registro di sistema anziché file di .INI.
CWinApp::UnregisterShellFileTypes	Annulla la registrazione dei tipi di documento di qualsiasi applicazione con il File Manager di Windows.

Membri dati pubblici

Nome	Descrizione
CWinApp::m_bHelpMode	Indica se l'utente è in modalità di contesto della guida (in genere chiamato con MAIUSC+F1).
CWinApp::m_eHelpType	Specifica il tipo della guida utilizzato dall'applicazione.
CWinApp::m_hInstance	Identifica l'istanza corrente dell'applicazione.
CWinApp::m_lpCmdLine	Punta a una stringa con terminazione null che specifica la riga di comando per l'applicazione.
CWinApp::m_nCmdShow	Specifica come finestra deve essere visualizzato inizialmente.
CWinApp::m_pActiveWnd	Puntatore alla finestra principale dell'applicazione contenitore quando un server OLE è attivo sul posto.
CWinApp::m_pszAppID	Identificazione di modello l'applicazione
CWinApp::m_pszAppName	Specifica il nome dell'applicazione.
CWinApp::m_pszExeName	Il nome del modulo dell'applicazione.
CWinApp::m_pszHelpFilePath	Il percorso del file della Guida dell'applicazione.
CWinApp::m_pszProfileName	Il nome file del .INI dell'applicazione.
CWinApp::m_pszRegistryKey	Utilizzato per determinare la chiave del Registro di sistema completo per memorizzare le impostazioni di profilo di un'applicazione.

Membri di dati protetti

Nome	Descrizione
CWinApp::m_dwRestartManagerSupportFlags	Flag che determinano quali Gestione riavvio funziona.
CWinApp::m_nAutosaveInterval	La durata in millisecondi tra autosaves.
CWinApp::m_pDataRecoveryHandler	Puntatore al gestore di ripristinare i dati per l'applicazione.

Note

Un oggetto applicazione fornisce funzioni membro per inizializzare l'applicazione (e ogni istanza) ed eseguire l'applicazione.

Ogni applicazione che utilizza le classi MFC (Microsoft Foundation può contenere un solo oggetto derivato da CWinApp. Questo oggetto viene creato quando altri oggetti globali C++ vengono creati ed è già disponibile quando Windows chiama la funzione WinMain, fornita dalla libreria MFC. Dichiarare l'oggetto derivato CWinApp a livello globale.

Quando si deriva una classe di applicazione da CWinApp, eseguire l'override della funzione membro InitInstance per creare l'oggetto della finestra principale dell'applicazione.

Oltre alle funzioni membro CWinApp, la libreria MFC fornisce le seguenti funzioni globali per accedere all'oggetto CWinApp e altre informazioni globali:

AfxGetApp ottiene un puntatore all'oggetto CWinApp.
AfxGetInstanceHandle ottiene un handle all'istanza di applicazione corrente.
AfxGetResourceHandle ottiene un handle alle risorse dell'applicazione.
AfxGetAppName ottiene un puntatore a una stringa contenente il nome dell'applicazione. In alternativa, se un puntatore all'oggetto CWinApp, utilizzare m_pszExeName ottenere il nome dell'applicazione.

Vedere CWinApp: La classe di applicazione per ulteriori informazioni sulla classe CWinApp, inclusi cenni preliminari sulle seguenti:

CWinApp- derivato codice scritto dalla creazione guidata applicazione.
Il ruolo di CWinApp nella sequenza di esecuzione dell'applicazione.
Implementazioni predefinite della funzione membro di CWinApp.
i overridables principali di CWinApp.

Il membro dati m_hPrevInstance non esiste più. Per informazioni sul rilevamento un'istanza precedente CWinApp, vedere l'articolo della Knowledge Base "come identificare un'istanza precedente di un'applicazione" (KB106385) https://support.microsoft.com/default.aspx?scid=kb;en-us;106385.