|
Страница 14 из 40
void SeekToBegin(); throw(CFileException); Описание Устанавливает текущую позицию на начало файла. Функция SeekToBegin() эквивалентна функции Seek(0L, CFile::begin). virtual void Write(const void* lpBuf, UINT nCount);
throw(CFileException);
Аргументы "sectiontableheader"lpBuf - указатель на созданный пользователем буфер, содержащий данные, которые будут записаны в файл.
"sectiontableheader"nCount - количество байт, которые нужно записать в файл. Для текстовых файлов пара управляющих символов возврат каретки/перевод строки считается за один символ.
Описание Записывает данные из буфера в файл, связанный с объектом класса CFile. В некоторых случаях, включая переполнение диска, функция Write вызывает исключение. Объект класса CFont используется для работы со шрифтами, созданными интерфейсом графических устройств Windows (GDI). Прежде, чем использовать объект класса CFont его необходимо создать и связать с ним шрифт Windows с использованием функций CreateFont, CreateFontIndirect, CreatePointFont или CreatePointFontIndirect. После этого можно вызывать функции-члены данного класса для работы со шрифтом. Использование функций CreatePointFont или CreatePointFontIndirect во многих случаях проще, чем использование функций CreateFont или CreateFontIndirect, поскольку они осуществляют автоматический перевод высоты шрифта, измеренной в пиках, в высоту шрифта, измеренную в логических единицах. Описание данного класса содержится в файле заголовка afxwin.h. BOOL CreateFontIndirect(const LOGFONT* lpLogFont); Возвращаемое значение Ненулевое, в случае успешного завершения функции, и нулевое в противном случае. Аргументы "sectiontableheader"lpLogFont - указатель на объект структуры LOGFONT, содержащий параметры логического шрифта.
Описание Инициализирует объект класса CFont с использованием переменных объекта структуры LOGFONT, на который указывает аргумент lpLogFont. После этого объект данного класса может выбираться в качестве текущего шрифта в контекст устройства. Этот шрифт имеет характеристики, заданные структурой LOGFONT. Для выбора шрифта в контекст устройства используется функция CDC::SelectObject. При этом программа масштабирования шрифтов графического интерфейса пытается найти среди имеющихся физических шрифтов такой шрифт, который бы максимально соответствовал указанному логическому шрифту. Если не удается достичь полного соответствия, то используется ближайший по параметрам шрифт. После завершения работы с объектом класса CFont, созданным функцией CreateFontIndirect его необходимо сначала удалить из контекста устройства, а затем уничтожить объект данного класса. int AddString(LPCTSTR lpszItem); Возвращаемое значение Индекс строки в окне списка, причем первая строка имеет нулевой индекс. Если в процессе работы функции возникла ошибка, то возвращается величина LB_ERR, если эта ошибка была связана с нехваткой памяти для хранения новой строки, то возвращается величина LB_ERRSPACE. Аргументы "sectiontableheader"lpszItem - указатель на строку символов, заканчивающуюся нулем, которую необходимо добавить в список.
Описание Данная функция вызывается для добавления строки в окно списка. Если данное окно списка не имеет стиля LBS_SORT, то строка добавляется в конец списка. В противном случае, строка добавляется в список и после этого список сортируется. Если данное окно списка имеет стиль LBS_SORT, но не имеет стиля LBS_HASSTRINGS, приложение сортирует список, используя вызовы функции CompareItem. Чтобы добавить строку в определенное место в списке, используйте функцию InsertString. int DeleteString(UINT nIndex); Возвращаемое значение Число строк, оставшихся в списке. Если величина аргумента nIndex превышает число строк в окне списка, то возвращается величина LB_ERR. Аргументы "sectiontableheader"nIndex - определяет индекс уничтожаемой строки. Индекс первой строки равен нулю.
Описание Уничтожает элемент в окне списка. int GetCurSel() const; Возвращаемое значение Индекс выделенной в окне списка строки или LB_ERR, если в данном окне списка нет выделенной строки или данное окно списка допускает одновременное выделение нескольких элементов. Первая в окне списка строка имеет нулевой индекс. Описание Позволяет получить индекс выделенной в окне списка строки, если таковая имеется. Функция GetCurSel не должна использоваться в окнах списка, допускающих одновременное выделение нескольких элементов. int GetText(int nIndex, LPTSTR lpszBuffer) const;
void GetText(int nIndex, CString& rString) const;
Возвращаемое значение Длина (в байтах) строки, исключая завершающий ее нулевой символ. Если аргумент nIndex имеет недопустимое значение, возвращается значение LB_ERR. Аргументы "sectiontableheader"nIndex - определяет индекс строки, которую необходимо получить. Индекс первой строки равен нулю.
"sectiontableheader"lpszBuffer - указатель на текстовый буфер, в который будет записана полученная строка. Буфер должен иметь достаточный размер для размещения самой строки и завершающего ее нулевого символа. Размер строки может быть определен заранее с помощью вызова функции GetTextLen.
"sectiontableheader"rString - ссылка на объект класса CString.
Описание Позволяет получить указанную строку из окна списка. Второй вариант данной функции использует для хранения полученной строки объект класса CString. int SetSel(int nIndex, BOOL bSelect = TRUE); Возвращаемое значение LB_ERR, если при выполнении функции возникла ошибка, и ноль в противном случае. Аргументы "sectiontableheader"nIndex - индекс выделяемой строки, причем первая строка имеет нулевой индекс. Если этот аргумент равен -1, то, в зависимости от значения аргумента bSelect, выделяются все строки или снимается выделение со всех строк.
"sectiontableheader"bSelect - определяет режим выделения. Если данный аргумент имеет значение TRUE, то строка выделяется, если - FALSE, то со строки снимается выделение. По умолчанию строка выделяется.
Описание Выделяет строку в окне списка, допускающем выделение нескольких элементов. Эта функция может использоваться только в окнах списков, допускающих выделение нескольких элементов. template< class KEY, class ARG_KEY, class VALUE, class ARG_VALUE >class CMap : public CObject Аргументы "sectiontableheader"KEY - класс объектов, используемых в качестве ключей в данной карте отображений.
"sectiontableheader"ARG_KEY - тип данных, используемых в качестве аргументов KEY. Обычно это ссылка на KEY.
"sectiontableheader"VALUE - класс объектов, хранящихся в данной карте отображений.
"sectiontableheader"ARG_VALUE - тип данных, используемых в качестве аргументов VALUE. Обычно это ссылка на VALUE.
Описание Класс CMap представляет собой класс словарей, в котором для доступа к данным используются уникальные ключи. После того, как в карту отображений будет добавлена пара, состоящая из ключа и элемента, для доступа к ней может быть использовано значение ключа. Кроме того, имеется возможность последовательного просмотра всего содержимого карты отображений. Для этого используется переменная типа POSITION. Эта переменная позволяет "запомнить" текущую позицию в карте и просмотр всей карты. Последовательность просмотра карты отображений никак не связана с последовательностью ключей. Класс CMap включает в себя макрос IMPLEMENT_SERIAL, позволяющий работать с архивом и выводить диагностические сообщения. Независимо от того используется ли для записи в архив перегруженный оператор << или функция Serialize, в архиве сохраняется каждый элемент карты отображений. При необходимости вывести диагностическую информацию об отдельном элементе карты отображений, необходимо указать глубину объекта CDumpContext равной 1 или большей величине. При уничтожении объекта класса CMap или при удалении из него элементов уничтожаются как ключи, так и связанные с ними объекты. Описание данного класса содержится в файле заголовка afxtempl.h. |