Compartilhar via


CWinApp::m_pszAppName

Especifica o nome do aplicativo.

LPCTSTR m_pszAppName;

Comentários

O nome do aplicativo pode vir do parâmetro passado para o construtor de CWinApp , ou, se não for especificado, a cadeia de caracteres de recurso com a identificação de AFX_IDS_APP_TITLE. Se o nome do aplicativo não for encontrado no recurso, vem de nome de arquivo .EXE do programa.

Retornado pela função AfxGetAppNameglobal. m_pszAppName é uma variável pública do tipo const char*.

Dica

Se você atribui um valor a m_pszAppName, deve ser atribuído dinamicamente no heap.O destrutor de CWinApp chama free( ) com esse ponteiro.Muitos você deseja usar a função da biblioteca em tempo de execução de _tcsdup( ) para fazer alocar.Além de isso, liberar memória associado com o ponteiro atual antes de atribuir um novo valor.Por exemplo:

//First free the string allocated by MFC at CWinApp startup. 
//The string is allocated before InitInstance is called.
free((void*)m_pszAppName);
//Change the name of the application file. 
//The CWinApp destructor will free the memory.
m_pszAppName = _tcsdup(_T("c:\\somedir\\myapp.exe"));

Exemplo

CWnd* pWnd = AfxGetMainWnd();
// Set pWnd to some CWnd object whose window has already 
// been created. 

// The following call to CWnd::MessageBox uses the application 
// title as the message box caption.
pWnd->MessageBox(_T("Some message"), AfxGetApp()->m_pszAppName);

// A more direct way to get the application title is to  
// call AfxGetAppName:
pWnd->MessageBox(_T("Some message"), AfxGetAppName());

// An easier way to display a message box using the application 
// title as the message box caption is to call AfxMessageBox:
AfxMessageBox(_T("Some message"));

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CWinApp

Gráfico da hierarquia