CWinApp::GetProfileString

CString GetProfileString( LPCTSTR lpszSection, LPCTSTR lpszEntry, LPCTSTR lpszDefault = NULL );

Возвращаемое значение

Строка, хранящаяся в файле приложения с расширением .ini, или строка, передаваемая в аргументе lpszDefault, если указанная строка не содержится в файле с расширением .ini. Максимальная длина строки, которая может быть получена подобным образом, равна величине _MAX_PATH. Если величина lpszDefault равна нулю, то возвращается пустая строка.

Аргументы

0. lpszSection — указатель на символьную строку, заканчивающуюся нулём, определяющую секцию, содержащую требуемую строку.

1. lpszEntry — указатель на символьную строку, заканчивающуюся нулём, определяющую идентификатор строки в записи. Этот аргумент не может принимать нулевое значение.

2. lpszDefault — указатель на символьную строку, заканчивающуюся нулём, содержащую строку, которая будет возвращаться функцией, если в соответствующем файле не будет найдена указанная строка.

Примечание

Данная функция возвращает строку, связанную с идентификатором, содержащимся в указанной секции раздела системного реестра, отведённого данному приложению, или в файле с расширением .ini.

Пример

CString strSection = "My Section";

CString strStringItem = "My String Item";

CString strIntItem = "My Int Item";

CWinApp* pApp = AfxGetApp();

pApp->WriteProfileString(strSection, strStringItem, "test");

CString strValue;

strValue = pApp->GetProfileString(strSection, strStringItem);

ASSERT(strValue == "test");

pApp->WriteProfileInt(strSection, strIntItem, 1234);

int nValue;

nValue = pApp->GetProfileInt(strSection, strIntItem, 0);

ASSERT(nValue == 1234);

CWinApp::InitInstance

virtual BOOL InitInstance( );

Возвращаемое значение

Ненулевое, если инициализация прошла успешно, в противном случае — ноль.

Примечание

Операционная система Windows допускает одновременную работу нескольких копий одного приложения. Процесс создания приложения концептуально подразделяется на два этапа: предварительное создания приложения, которое осуществляется при первом запуске программы на исполнение, и инициализация экземпляра приложения, которая происходит при запуске на исполнение любой копии программы, включая и первую. Данная функция вызывается функцией WinMain, принадлежащей классу главного окна.

Обычно, в процессе выполнения перегруженной пользователем функции InitInstance производится создание объекта главного окна программы и устанавливается значение члена класса CWinThread::m_pMainWnd, содержащего указатель на это окно.

CWinApp::LoadIcon

HICON LoadIcon( LPCTSTR lpszResourceName ) const;

HICON LoadIcon( UINT nIDResource ) const;

Возвращаемое значение

Дескриптор значка, если функция завершилась успешно. В противном случае — ноль.

Аргументы

0. lpszResourceName — указатель на текстовую строку, заканчивающуюся нулём, содержащую имя ресурса значка. В качестве данного аргумента может использоваться объект класса CString.

1. nIDResource — численное значение идентификатора ресурса значка.

Примечание

Данная функция позволяет загрузить ресурс значка, определяемый аргументом lpszResourceName или аргументом nIDResource из исполняемого файла. Функция LoadIcon производит загрузку значка только в том случае, если он ещё не был загружен. В противном случае она возвращает дескриптор существующего ресурса.

Для доступа к предопределённым значкам Windows могут быть использованы функции LoadStandardIcon и LoadOEMIcon.