69284

Клас CDocument

Лекция

Информатика, кибернетика и программирование

Клас CDocument забезпечує стандартну поведінка об’єктів документа додатку MFC. Клас CDocument дозволяє створювати нові документи, зберігати дані документа на диску (сериализация), забезпечувати стандартну взаємодію між об’єктом документа і вікном уявлення...

Украинкский

2014-10-02

49 KB

0 чел.

Лекція № 4

Тема: Клас CDocument

План

  1.  Клас CDocument
  2.  Оголошення класу документа
  3.  Функції-члени класу CDocument

Клас CDocument

Клас CDocument забезпечує стандартну поведінка об'єктів документа додатку MFC. Клас CDocument дозволяє створювати нові документи, зберігати дані документа на диску (сериализация), забезпечувати стандартну взаємодію між об'єктом документа і вікном уявлення, а також виконувати ряд Інших маніпуляцій. Серед класів MFC існує також ряд інших класів, похідних від CDocument, які реалізують спеціалізовані функціональні можливості деяких типів додатків. Наприклад, такі класи MFC, як CRecordset і CDAORecordset, дозволяють істотно спростити створення уявлень в додатках баз даних. Відносини між документом і уявленнями проілюстровані на мал.

Мал. Відносини "один до багатьом" між

документом і його уявленнями

Оголошення класу документа

Якщо для створення додатку використовується майстер AppWizard, то, часто, про оголошення базового класу документа можна не турбуватися — майстер AppWizard зробить це сам. Проте, розуміння поведінки класу CDocument може стати в нагоді, оскільки складнішим застосуванням може знадобитися декілька різних класів документа, похідних від базового класу CDocument. Крім того, розуміючи поведінку класу CDocument, легко модифікувати заготівку додатку, створену за допомогою майстра AppWizard.

Незалежно від того, чи створюється додаток однодокументного інтерфейсу або багатодокументного, майстер AppWizard створює лише один клас документа, похідний від базового класу MFC CDocument.

При створенні простого додатку MFC модифікації класу документа, наданого майстром AppWizard, часто вельми незначні. Іноді досить додати в клас декілька змінних-членів і функцій, що забезпечують доступ до цих змінних з інших частин програми.

Наприклад, об'єкт документа для простого додатку зв'язку (такого як емулятор терміналу) міг би містити змінні-члени для зберігання параметрів модему. В цьому випадку в змінних-членах могла б зберігатися така інформація, як номер телефону, швидкість передачі, парність, кількість битий в кожному сегменті передачі і так далі Таким чином, в класі документа, похідному від класу CDocument, параметри установки зв'язку можна легко представити у вигляді набору простих змінних-членів, як показано в наступному фрагменті коди:

class CSimpleTermDoc : public CDocument

{

protected:

CSimpleTermDoc();

DECLAREJ3YNCREATE(CSimpleTermDoc)

public:

CString m_sPhoneNum;

DWORD m_dwTransSpeed;

WORD m_nTransParity;

WORD m_nTransBits;

DWORD m_dwConnectTime;

Оголосивши змінні-члени, необхідно упевнитися, що програма ініціалізувала змінні деякими початковими значеннями. Для цього використовується функція-член OnNewDocument класу CSimpleTermDoc. Крім того, у функцію Serialize необхідно додати додатковий код, для правильного збереження значень змінних. Код функцій-членів OnNewDocument і Serialize такого застосування міг би виглядати так, як приведено нижче. У цьому фрагменті коди змінні-члени ініціалізувалися.

// Стандартний код для функцій-членів

// OnNewDocument () і Serialize()

BOOL CSimpleTerraDoc::OnNewDocument 

{

if {!CDocument::OnNewDocument()) return FALSE;

m_sPhoneNum = _T ("555-1212");

m_dwTransSpeed = 28800;

m_nTransParity = 0;

m_nTransBits = 8;

m_dwConnectTime = 0;

return TRUE;

}

Як можна відмітити в наступному фрагменті коди, в процесі збереження (сериа-лизации serialization) використовується клас CArchive. Цей клас дозволяє легко записувати на диск і прочитувати з нього складні типи даних, використовуючи операторів C++ << (extraction — витягання) і >> (insertion — вставка). При виклику код функції CArchive: :IsStoring спочатку перевіряє, чи є поточний процес операцією читання або запису. На підставі повертаного значення (true при записі, false при читанні) ухвалюється рішення про застосування операторів витягання або збереження даних.

void CSimpleTermDoc::Serialize(CArchive &ar)

{

if (ar.IsStoring())

{

ar << m_sPhoneNum;

ar « m_dwTransSpeed;

ar « m__nTransParity;

ar << m_nTransBits;

ar << m_dwConnectTime;

} else {

ar » m_sPhoneNum;

ar » m_dwTransSpeed;

ar » m_nTransParity;

ar » m_nTransBits;

ar >> m dwConnectTime;

}

}

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

Функції-члени класу CDocument

Окрім функцій ініціалізації і збереження клас CDocument володіє ще декількома функціями-членами, якими в додатках доводиться користуватися достатньо часто. Один набір функцій-членів забезпечує доступ до пов'язаних з документом об'єктів уявлення. Кожен об'єкт документа, який використовується в додатку, має список пов'язаних з ним об'єктів уявлення. Щоб отримати ітератор (iterator) для цього списку, необхідно викликати функцию-член GetFirstViewPosition об'єкту даного документа'. Отриманий ітератор матиме тип POSITION.

З цієї точки зору клас CDocument є класом колекції, що містить інформацію про колекцію уявлень, пов'язаних з ним через об'єкт POSITION. Значення типу даних POSITION застосовуються в бібліотеці MFC перш за все для класів колекцій. Коли в додатку необхідно перебрати список або колекцію, спочатку запрошують ітератор, вказуючий на перший елемент в списку класу колекції, а потім використовують функцію ітератора, яка дозволяє дістати доступ до самих елементів списку. Доступ здійснюється послідовно, один елемент за іншим. Отже, отримавши за допомогою функції-члена GetFirstViewPosition ітератор на перший об'єкт уявлення в класі, можна, послідовно викликаючи функцию-член GetNextView, дістати доступ до решти всіх уявлень в колекції.

Іншими словами, для доступу до всіх уявлень, зв'язаних в додатку з даним об'єктом документа, використовується код, який виглядає таким чином:

POSITION posView = GetFirstViewPosition{);

while {posView != NULL)

{

CView *pView = GetNextView(posView);

// Що-небудь зробити із застосуванням покажчика на уявлення

}

Проте, існує і більш простій спосіб зробити це. Наприклад, якщо код додатку повинен повідомляти всі уявлення документа про зміну інформації, що міститься в нім, то модифікувати уявлення можна і без застосування ітератора з відповідним циклом — досить викликати функцию-член об'єкту документа UpdateAllViews. Крім того, можна навіть вказати специфічні для цього додатку дані, при зміні яких необхідно модифікувати лише частину вікон уявлення при виклику функції UpdateAllViews. Докладніша інформація про вибіркове оновлення вікон приводиться далі в цьому розділі при обговоренні застосування функції-члена CView: :OnUpdate.

Решта функцій-членів, пов'язаних з представленням об'єкту документа (такі як AddView і RemoveView), використовується значно рідше. Як і виходить з їх імен (додати уявлення, видалити уявлення), функції дозволяють програмно додавати і видаляти уявлення із списку уявлень документа. Ці функції застосовуються дуже рідко, оскільки більшість розробників використовують стандартну реалізацію f MFC з невеликими змінами (або навіть без всяких змін).

При кожній зміні даних документа (внесених користувачем або внутрішніми h процесами додатку) програма повинна викликати функцию-член SetModif iedFlag. Своєчасне застосування функції SetModif iedFlag гарантує, що додаток MFC ' повідомить користувача про можливість втрати внесених змін, якщо він спробує закрити додаток, не зберігши документ. Якщо таку стандартну поведінку необхідно змінити і створити власну функцію збереження, то значення прапора стану можна набути за допомогою функції-члена IsModif ied.

Функція-член SetTitle дозволяє встановити заголовок об'єкту документа. Додаток, у свою чергу, відобразить встановлений заголовок в заголовку фреймового вікна (основного в додатку SDI або дочерних в додатку MDI).

 Функція SetPathName дозволяє встановити повний шлях до файлу документа, а функція GetPathName — отримати його. І нарешті, отримати шаблон документа, використовуваний додатком при створенні даного документа, можна за допомогою функції GetDocTemplate.


 

А также другие работы, которые могут Вас заинтересовать

17939. ЛЕКСИЧНІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 119 KB
  2. ЛЕКСИЧНІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 2.1. Лексичне значення слова 2.2. Однозначні і багатозначні слова 2.3. Пряме і переносне значення слова 2.4. Омонімія синонімія антонімія паронімія 2.5. Стилістична диференціація слова 2.6. Фразео
17940. СЛОВОТВОРЧІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 54 KB
  3. СЛОВОТВОРЧІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 3.1. Морфемна структура слова 3.2. Способи словотвору 3.3. Запитання і завдання для самоперевірки 3.1. Морфемна структура слова Кожна одиниця мови має свою структуру. Структура слова є системою взаємопов'язаних і співвідносн
17941. МОРФОЛОГІЧНІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 440 KB
  4. МОРФОЛОГІЧНІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 4.1. Частини мови принципи їх виділення 4.2. Іменник 4.3. Прикметник 4.4. Числівник 4.5. Займенник 4.6. Дієслово 4.7. Прислівник 4.8. Службові частини мови 4.9. Вигук 4.10. Запитання і завдання для самоперевірки 4.1. Частини мови прин...
17942. СИНТАКСИЧНІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 187 KB
  5. СИНТАКСИЧНІ ЗАСОБИ ДІЛОВОГО МОВЛЕННЯ 5.1. Словосполучення сполучення слів 5.2. Поняття про речення5.3. Просте речення5.4. Складне речення5.5. Складносурядне речення5.6. Складнопідрядне речення5.7. Безсполучникове речення5.8. Складні синтаксичні конструкції5.9. Синтаксичні особ
17943. ОСОБЛИВОСТІ ПИСЕМНОГО І УСНОГО ДІЛОВОГО МОВЛЕННЯ 42 KB
  6. ОСОБЛИВОСТІ ПИСЕМНОГО І УСНОГО ДІЛОВОГО МОВЛЕННЯ 6.1. Соціальна функція писемного і усного ділового мовлення6.2. Монологічне і діалогічне ділове мовлення6.3. Особливості писемного ділового мовлення6.4. Особливості усного ділового мовлення6.5. Запитання і завдання для само
17944. ДОКУМЕНТ. КЛАСИФІКАЦІЯ ДОКУМЕНТІВ ЗА РІЗНИМИ ОЗНАКАМИ 49 KB
  7. ДОКУМЕНТ. КЛАСИФІКАЦІЯ ДОКУМЕНТІВ ЗА РІЗНИМИ ОЗНАКАМИ 7.1. Справочинство і його складові частини7.2. Визначення документу. Роль документу у діловій сфері7.3. Класифікація документів за різними ознаками7.4. Запитання і завдання для самоперевірки 7.1. Справочинство і його ск...
17945. ВИМОГИ ДО УТВОРЕННЯ І МОВИ ДОКУМЕНТІВ 64 KB
  8. ВИМОГИ ДО УТВОРЕННЯ І МОВИ ДОКУМЕНТІВ 8.1. Сучасні вимоги до мови документів8.2. Документи з низьким і високим рівнем стандартизації8.3. Реквізити управлінських документів8.4. Вимоги до мови документів8.5. Запитання і завдання для самоперевірки 8.1. Сучасні вимоги до докуме...
17946. ДОКУМЕНТУВАННЯ В УПРАВЛІНСЬКІЙ ДІЯЛЬНОСТІ 85 KB
  ДОКУМЕНТУВАННЯ В УПРАВЛІНСЬКІЙ ДІЯЛЬНОСТІ. Організаційно-розпорядчі документи. Довідковоінформаційні документи. Документування з кадрових питань. Особисті офіційні документи. Запитання і завдання для самоперевірки. Організаційно-розпорядчі документ
17947. СПЕЦІАЛІЗОВАНЕ ДОКУМЕНТУВАННЯ 85 KB
  10. СПЕЦІАЛІЗОВАНЕ ДОКУМЕНТУВАННЯ 10.1. Документи з господарської діяльності10.2. Документи з господарськопретензійної діяльності10.3. Система обліковофінансової документації10.4. Документи в банківській діяльності10.5. Документація в рекламній та видавничої діяльності10.6. З