Робота зі стандартними ресурсами

1. Методи класу CButton

HBITMAP GetBitmap () const;

Повертає дескриптор растрового зображення, зіставлених кнопці. Якщо такого не існує, то повертається NULL.

HBITMAP SetBitmap (HBITMAP hBitmap);

Порівнює кнопці растрове зображення. Значним параметра повинен бути дескриптор растрового зображення. Правила розміщення растрового зображення такі ж, як і у значка.

HCURSOR GetCursor ();

Повертає дескриптор курсору, зіставлена кнопці методом SetCursor. Якщо у кнопки немає зіставлених курсору, то повертається NULL.

HCURSOR SetCursor (HCURSOR hCursot);

Порівнює кнопці курсор, зображення якого буде поміщено на поверхню кнопки аналогічно значку і растровому зображенню.

UINT GetState () const;

Повертає опис набору поточних станів кнопки. Щоб виділити з цього опису значення конкретних типів стану, можна використовувати маски:

0х0003 - виділяє власний стан кнопки. Застосовується лише до прапорці або перемикача. Якщо результат побітового множення дає 0, значить кнопка перебуває у невибраної стані, 1 - в вибраному, 2 - в невизначеному.

0х0004 - виділяє стан першого типу. Ненульовий варіант означає, що кнопка "натиснута", нульовий - кнопка вільна.

0х0008 - виділяє положення фокусу. Ненульовий варіант - Кнопка у фокусі клавіатури.

int GetCheck () const;

Повертає власний стан прапорця або перемикача. Повертає значення може приймати одне із значень: 0 -- кнопка не вибрана; 1 - кнопка вибрана; 2 - кнопка в невизначеному стані. Якщо кнопка не є ні перемикачем, ні прапорцем, повертається 0.

void SetCheck (int nCheck);

Встановлює власний стан прапорця або перемикача. Значення задаються з набору: 0 - вибрана, 1 - вибране; 2 -- невизначений. Значення 2 застосовується лише до прапорці з властивістю 3State.

UINT GetButtonStyle () const;

Повертає стиль кнопки.

void SetButtonStyle (UINT nStyle, BOOL bRedraw = TRUE);

Встановлює стиль кнопки. Якщо параметр bRedraw дорівнює TRUE, кнопка перемальовує.

HICON GetIcon () const;

Повертає дескриптор піктограми, зіставлень кнопці. Якщо у кнопки немає співставлений піктограми, повертає NULL.

HICON SetIcon (HICON hIcon);

Порівнює кнопці піктограму. Значення параметра при виклику повинен бути дескриптор піктограми.

Піктограма автоматично збожеволіє на поверхню кнопки і зсувається в її центр. Якщо поверхню кнопки менше піктограми, вона обрізається з усіх боків до розмірів кнопки. Положення піктограми може бути вирівняний і не по центру. Для цього потрібно, щоб кнопка мала одну з таких властивостей: BS_LEFT, BS_RIGHT, BS_CENTER, BS_TOP, BS_BOTTOM, BS_VCENTER

Даний метод встановлює для кнопки тільки одну піктограму, яка буде нарівні з текстом бути присутнім при будь-якому її стані. Не треба плутати її з растровим зображенням у растрової кнопки.

2. Методи класу CEdit

Вікна редагування можуть працювати в режимах короткого і багато-редакторів. Наведемо спочатку методи, загальні для обох режимів, а потім методи для багато-редактора.

Загальні методи:

DWORD GetSel () const;

void GetSel (int & nStartChar, int & nEndChar) const;

Отримує першу і останню позиції виділеного тексту. Для значення типу DWORD молодше слово містить позицію перше, старше - Останнього символу.

void SetSel (DWORD dwSelection, BOOL bNoScroll = FALSE);

void SetSel (int nStartChar, int nEndChar, BOOL bNoScroll = FALSE);

Встановлює нове виділення тексту, задаючи першого і останній виділений символ. Значення FALSE параметра bNoScroll повинно відключати переміщення курсору в область видимості.

void ReplaceSel (LPCTSTR lpszNewText);

Замінює виділений текст на рядок, що передається в параметрі lpszNewText.

void Clear ();

Видаляє виділений текст.

void Copy ();

Копіює виділений текст у буфер.

void Cut ();

Переносить (копіює і видаляє) виділений текст у буфер обміну.

void Paste ();

Вставляє текст з буфера обміну, починаючи з позиції, в якій знаходиться курсор.

BOOL Undo ();

Скасування останньої операції, виконаної редактором. Якщо редактор однорядковий, повертається завжди невід'ємне значення, інакше невід'ємне значення повертається лише у разі успішної заміни.

BOOL CanUndo () const;

Визначає, чи можна скасувати останню операцію редактора.

void EmptyUndoBuffer ();

Скидає прапор undo, що сигналізує про можливість скасування останньої операції редактора, і тим самим робить неможливим скасування. Цей прапор скидається автоматично при виконанні методів SetWindowText і SetHandle.

BOOL GetModify () const;

Повертає невід'ємне значення, якщо вміст вікна редагування не модифіковану. Інформація про модифікацію підтримується в спеціальному прапорі, обнуляється при створенні вікна редагування і при виклику методу:

void SetModify (BOOL bModified = TRUE);

Встановлює або скидає прапор модифікації (див. попередній метод). Прапор скидається при виклику методу з параметром FALSE і встановлюється при модифікації вмісту вікна редагування або при виклику SetModify з параметром TRUE.

BOOL SetReadOnly (BOOL bReadOnly = TRUE);

Встановлює режим перегляду (bReadOnly = TRUE) або редагування (bReadOnly = FALSE).

TCHAR GetPasswordChar () const;

Повертає символ, який при виведенні пароля буде з'являтися на екрані замість символів, що набирають користувачем. Якщо такий символ не визначений, повертається 0. Встановлюється цей символ методом (по замовчуванням використовується "*"):

void SetPasswordChar (TCHAR ch);

void LimitText (int nChars = 0);

Встановлює максимальну довжину в байтах тексту, який може ввести користувач. Якщо значення параметра дорівнює 0, довжина тексту встановлюється рівною UINT_MAX.

Методи роботи з багаторядкових редактором:

void LineScroll (int nLines, int nChars = 0);

Прокручує текст у області редагування. Параметр nLimes задає кількість рядків для вертикальної прокрутки. Вікно редагування НЕ прокручує текст далі останнього рядка. При позитивному значенні параметра область редагування зсувається уздовж тексту до останньому рядку, при негативній - до першої.

Параметр nChars задає кількість символів для горизонтального прокручування. Вікно редагування прокручує текст вправо, навіть якщо рядки закінчилися. У цьому випадку в області редагування з'являються пробіли. При позитивному значенні параметра область редагування зсувається уздовж до кінця рядка, при негативному - до початку.

int GetFirstVisibleLine () const;

Повертає номер першої видимої рядка.

int GetLineCount () const;

Повертає кількість рядків тексту, що знаходиться в буфері редагування. Якщо текст не вводився, повертає 1.

int GetLine (int nIndex, LPTSTR lpszBuffer) const;

int GetLine (int nIndex, LPTSTR lpszBuffer, int nMaxLength) const;

Копіює рядок з номером, рівним значенню параметра nIndex, в буфер, заданий параметром lpszBuffer. Перше слово в буфері повинно задавати його розмір. Коли Ви робите другого варіанту методу значення параметра nMaxLength копіюється в першому слово буфера.

Метод повертає число в дійсності скопійованих байтів. Якщо номер рядка більше або дорівнює числу рядків в буфері вікна редагування, повертає 0. Текст копіюється без будь-яких змін, нуль-символ не додається.

int LineIndex (int nLine =- 1) const;

Повертає номер першого символу в рядку. Невід'ємне значення параметра приймається як номера рядка. Значення -1 задає поточний рядок. Якщо номер рядка більше або дорівнює числу рядків в буфері вікна редагування (рядки нумеруються з 0), повертається 0.

3. Методи класу CListBox

void ResetContent ();

Очищає вміст списку, роблячи його порожнім.

int AddString (LPCSTR lpszItem);

Додає рядок lpszItem до списку і сортує його, якщо при створенні включено властивість Sort. В іншому випадку елемент додається в кінець списку.

int DeleteString (UINT nIndex);

Видаляє зі списку елемент з індексом nIndex. Індексація елементів починається з 0.

int GetCurSel () const;

Отримує індекс елемента, вибраного користувачем.

int SetCurSel (int nSelect);

Зазначає елемент з індексом nSelect як обраний елемент списку. Якщо значення параметра дорівнює -1, список не буде містити зазначених елементів.

int GetText (int nIndex, LPSTR lpszBuffer) const;

void GetText (int nIndex, CString & rString) const;

Копіює елемент з індексом nIndex в буфер.

int SetTopIndex (int nIndex);

Організовує прокручування списку у вікні так, щоб елемент з індексом nIndex був видимим.

int FindString (int nStartAfter, LPCSTR lpszItem) const;

Організовує пошук в списку і повертає в якості результату індекс елементу списку, префікс якого збігається з рядком lpszItem. Результат не залежить від регістра, в якому набиралися символи порівнюваних рядків. Параметр nStartAfter задає початок пошуку, але пошук іде по всьому списку. Він починається від елемента, наступного за nStartAfter, до кінця списку, а потім продовжується від початку списку до елементу з індексом nStartAfter. Як результат видається перший знайдений елемент, що задовольняє умовам пошуку. Якщо такого немає, результат отримує значення LB_ERR.

int FindStringExact (int nIndexStart, LPCSTR lpszFind) const;

Цей метод відрізняється від попереднього тим, що тепер НЕ префікс елемент повинен співпадати з рядком lpszFind, а сам елемент. Пошук як і раніше не чутливий до регістру, в якому набираються символи.

4. Методи класу CComboBox

int GetCurSel () const;

Повертає цілочисельний покажчик вибраної строчки.

int SetCurSel (int nSelect );;

Ставить покажчик на рядок з номером nSelect.

int GetLBText (int nIndex, LPTSTR lpszText) const;

void GetLBText (int nIndex, CString & rString) const;

Записує вміст рядки з індексом nIndex в змінні LPTSTR lpszText або CString & rString.

int GetLBTextLen (int nIndex) const;

Повертає довжину рядка з індексом nIndex.

int AddString (LPCTSTR lpszString);

Додає рядок у списку.

int DeleteString (UINT nIndex);

Видалення рядки з індексом nIndex.

int InsertString (int nIndex, LPCTSTR lpszString);

Замінює рядок з індексом nIndex вмістом змінної LPCTSTR lpszString.

5. Методи класу CProgressCtrl

void SetRange (short nLower, short nUpper);

void SetRange32 (int nLower, int nUpper);

Встановлює мінімальне (nLower) і максимальна значення (nUpper).

void GetRange (int & nLower, int & nUpper);

Записує у змінні nLower і nUpper мінімальне і максимальне значення.

int GetPos ();

Повертає поточне значення.

int SetPos (int nPos);

Встановлює поточне значення в nPos.

int SetStep (int nStep);

Встановлює крок (nStep) виводу.

6. Методи класу CSliderCtrl

int GetRangeMax () const;

int GetRangeMin () const;

void GetRange (int & nMin, int & nMax) const;

Перші дві функції повертають максимальне і мінімальне знаненіе, а третій - записує ці значення в nMax і nMin відповідно.

void SetRangeMin (int nMin, BOOL bRedraw = FALSE);

void SetRangeMax (int nMax, BOOL bRedraw = FALSE);

void SetRange (int nMin, int nMax, BOOL bRedraw = FALSE);

Перші дві функції встановлюють максимальне і мінімальне знаненіе, а третій - встановлює ці значення з змінних nMax і nMin відповідно. Аргумент bRedraw відповідає за перемальовування слайдера.

int GetPos () const;

Повертає поточну позицію.

void SetPos (int nPos);

Встановлює поточну позицію в nPos.

BOOL SetTic (int nTic);

Встановлює крок (nTic).

void SetTicFreq (int nFreq);

Встановлює частоту зарубок (nFreq).

7. Методи класу CSpinButtonCtrl

int SetPos (int nPos);

Встановлює поточну позицію в nPos.

int GetPos () const;;

Повертає поточну позицію.

void SetRange (int nLower, int nUpper);

void SetRange32 (int nLower, int nUpper);

Встановлює максимальне і мінімальне знаненіе з змінних nMax і nMin відповідно.

void GetRange (int & lower, int & upper) const;

void GetRange32 (int & lower, int & upper) const;;

Ці дві функції записують максимальне і мінімальне знаненіе в upper і lower відповідно.

Список літератури

Для підготовки даної роботи були використані матеріали з сайту http://www.realcoding.net/