CWinApp::WriteProfileInt

BOOL WriteProfileInt( LPCTSTR lpszSection, LPCTSTR lpszEntry, int nValue );

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

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

Аргументы

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

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

2. nValue — сохраняемая величина.

Примечание

Данная функция вызывается для сохранения целочисленной величины в указанной секции реестра приложения или в файле с расширением .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::WriteProfileString

BOOL WriteProfileString( LPCTSTR lpszSection, LPCTSTR lpszEntry, LPCTSTR lpszValue );

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

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

Аргументы

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

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

2. lpszValue — указатель на строку, которую необходимо сохранить. Если этот параметр имеет значение NULL, то идентификатор, указанный в аргументе lpszEntry, удаляется из записи.

Примечание

Данная функция вызывается для сохранения указанной строки в указанной секции реестра приложения или в файле с расширением .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);

CWnd

Класс CWnd обеспечивает основные функциональные возможности всех классов окон в библиотеке MFC. Объект класса CWnd не является окном Windows, но тесно с ним связаны. Если объект класса CWnd является полноценным объектом класса, создаётся своим конструктором и уничтожается своим деструктором, то окно Windows является внутренний структурой данных Windows, создаваемой функцией CWnd::Create и уничтожаемой виртуальным деструктором класса CWnd. Функция CWnd::DestroyWindow уничтожает окно Windows, не уничтожая объект класса CWnd.

Класс CWnd и механизм карты сообщения скрывают от пользователя функцию WndProc. Поступающие в объект данного класса сообщения Windows автоматически направлены через карту сообщения к соответствующим функциям обработки сообщений класса CWnd. Чтобы обработать в пользовательском классе, сообщение, поступающее от некоторого элемента управления, пользователю необходимо включить в свой класс функцию обработки данного сообщения.

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

Дочернее окно создаётся в два этапа. Сначала вызывается конструктор класса CWnd, создающий объект данного класса, а затем вызывается функция Create, создающая дочернее окно и присоединяющая его к объекту класса CWnd.

Когда пользователь закрывает дочернее окно, происходит уничтожение объекта класса CWnd или вызывается функция DestroyWindow, уничтожающая окно и связанные с ним структуры данных.

В библиотеке MFC собрано множество классов, производных от CWnd. Многие из этих классов, включая CFrameWnd, CMDIFrameWnd, CMDIChildWnd, CView и CDialog, сами используются в качестве базовых классов для различных пользовательских классов.

Классы элементов управления, являющиеся производными от класса CWnd, такие, как класс CButton, могут использоваться непосредственно или могут использоваться в качестве базовых для пользовательских классов.

Описание данного класса содержится в файле заголовка afxwin.h.