設計メモ

[表示][ツリーをたたむ]メニューを選んだ時の動作は、
現在選択中のセクションは表示したまま、他の開いている
ノードは全て閉じるというものである。

これを実現するために、現在は、

１．選択中のセクションを記録
２．すべてのノードを閉じる
３．記録したセクションを、選択し直す

という処理を行なっている。現在選択中のセクションが子セクションの
場合、２の処理で一旦隠れるが、３の処理で必要最小限のノードのみ
開いて元の選択中のセクションが表示される仕組みである。

ただ、問題は現在、ツリーの開閉状態に変更があるか無いかのチェックを
２の処理の中でのみ行なっており、３の処理でキャンセルされても、
ツリーの開閉状態に変更があったと認識される点である。
まあ、実用上なんの問題も無いとは思うのだが。

これを以下の考えで解決する。
トップレベルのセクションをレベル１、その子セクションをレベル２と
すると、すべてのノードが閉じられている状態からレベルｎのノードを
表示するためには、(n-1)個のノードを開けば、必要充分である。
したがって、「２．すべてのノードを閉じる」処理で閉じたノードの数と
選択中のセクションのレベルを比較する事で、ツリーの開閉状態に
変更があったかどうかを判定する。

ExpandとSelect(2000/01/12)

すでに１回以上開かれているノードに対し、
Expand()を実行しても、
CStviView::OnSelchanged()は呼ばれないのに、
Select()を実行して、ノードを開くと
CStviView::OnSelchanged()が呼ばれるのはなぜ？

まあ、理由はともあれ、Select()１行のきれいなコードにはならない。

内部構造の見直し（2000/01/06）

一応、Version1.00を公開できて、一段落着いたんで、
内部のいもくさい処理をなんとかしたいと思っています。

作業途中で、わかったこと、思い出したことなど、いくつか
あったのですが、とりあえず、Version1.00公開を最優先に
してしまいました。
以下に、重点項目を列挙します。

（１）セクションオブジェクトの汎用化

・第２ツリービューの導入
・印刷ツールとの共用
を視野に入れて、現在のアプリケーション依存部分を排除する

（２）ビュー、ドキュメントのカプセル化

ビューの更新は、ドキュメントクラスのUpdateAllViews()から
呼び出される各ビューのOnUpdate()メンバー関数で行なう。

・基本的にドキュメントは、ビューが何を表示しているか
知らないものとする。

・ビューは、他にどんなビューがあるか知らないものとする。

・本アプリケーションに依存した機構として、
テキストビューが、現在表示中のセクションと、キャレット位置に
関する情報をドキュメントにフィードバックすることとする。

（１）セクションオブジェクトの汎用化(2000/01/09)

基本的な構造は、現在のままとする。
すなわち、

ツリー構造のための情報は、CTreeCtrlアイテムに管理させる。
初期化、移動処理用にサブ的なツリー構造のための情報は持つ
（この情報をもつ変数を、今後リンクメンバ変数と呼ぶ）

今回の、追加変更仕様として、
今までのセクションオブジェクトは、
ツリーのノード情報であるHTREEITEMの値のみを保持していたが、
ツリー自体を保持するCTreeCtrlオブジェクトの値も保持する。

そして、変更のための指針として
・CTreeCtrlの木構造に対する操作は許可する
・CtreeViewやドキュメントオブジェクトに対する操作は許可しない
・アプリケーションObject、ビューObject、ドキュメントObjectに関しては、
MFCライブラリレベルまでのアクセスは必要に応じて許可するが、
アプリケーション依存の派生クラスのヘッダは、インクルードしない。

まず、次の関数群を修正する。（細かい事は無視して下さい。
現状では整理されていない事を示しているだけです。）
void CMyNode::AddNewNode(CTreeCtrl *pTree, CMyNode *obj, int mode) ;
int CMyNode::MapSubTree(CTreeCtrl *pTree);
int CMyNode::CrearTreeItem(void);
int CMyNode::GetOrder(void) { return iNodeOrder; }
static int CMyNode::SetOrder(CTreeCtrl *pTree);

static HTREEITEM CMainFarme::CopySubTree(CTreeCtrl *pTree,

	CMyNode *pSrc, HTREEITEM hDst=NULL, UINT mode=MST_NEXT) ;

HTREEITEM CMainFarme::MoveSubTree(CTreeCtrl *pTree,

	HTREEITEM hSrc, HTREEITEM hDst, UINT mode,
	BOOL bChangeOder = TRUE);

int CMainFarme::SlideNode(int mode) ;
int CMainFarme::AddNewNode(int mode);

int CStviView::AddNewNode(int mode)

木構造の変更自体は、すべて、セクションオブジェクト(CMyNode)で処理する
ドキュメントへの変更通知、ビューへのアップデート通知は、これらの関数を
呼び出した側で行なうものとする。以下に新しい設計の詳細を示す

・定数(2000/01/10)

// セクション追加処理に関する定数
enum {

ANN_CHILD,  // 長子
ANN_PARENT, // 親
ANN_PREV,   // 兄
ANN_NEXT,   // 弟

} ; /* AddNewNode */

// セクション移動（コピー）処理に関する定数
enum {

MST_FIRST_CHILD, // 長子
MST_LAST_CHILD,  // 末子
MST_PREV,        // 兄
MST_NEXT,        // 弟
MST_REPLACE,     // 置換

} ; /* MoveSubTree */

// セクションのスライドに関する定数
enum {

SN_UP,          // 上へ(スライドアップ)
SN_DOWN,        // 下へ(スライドダウン)
SN_CHILDRENUP,  // 子セクションを上へ(子セクションのスライドアップ)

} ; /* SlideNode */

CMyNode::AddNewNode 新規セクションの追加/挿入(2000/01/09)

// 新規セクションの追加
static void AddNewNode(CTreeCtrl *pTree, CMyNode *obj, int mode) ;

指定されたツリーpTreeの選択されたノードに対して、
指定された空セクションobjを、指定されたmodeの位置に追加する。

MoveSubTree 部分木の移動(2000/01/10)

// 部分木の移動
static int MoveSubTree(

	CMyNode *pSrc,
	CTreeCtrl *pTree,
	CMyNode *pDst,
	UINT mode, BOOL bChangeOrder) ;

指定されたセクションpSrcをルートセクションとする部分木を
指定されたツリーpTreeの指定されたノードpDstの
指定された関係modeの位置に移動する。
置換モード（mode=MST_REPLACE）が指定された場合には、pDstをpSrcで置き換える。
bChangeOrderがTRUEの場合には、移動処理の後にセクション順序の更新を行なう。

CopySubTree 木構造のコピー

// 木構造のコピー
static int CopySubTree(CMyNode *pSrc, CTreeCtrl *pTree,

	CMyNode *pDst=NULL, UINT mode=0, BOOL bChangeOrder = FALSE) ;

リンクメンバ変数により、構成された木構造pSrcを、
指定されたツリーpTreeの指定されたノードpDstの
指定された関係modeの位置に移動する。
置換モード（mode=MST_REPLACE）が指定された場合には、pDstをpSrcで置き換える。
bChangeOrderがTRUEの場合には、移動処理の後にセクション順序の更新を行なう。

木構造pSrcは、必ずしも部分木とは限らない。

・補足（ブックマーク）(2000/01/09)

本アプリケーションではブックマーク検索の効率を上げるため、
ブックマークは別オブジェクトで管理している。
そして、ブックマーク検索／登録の効率を良くするために、
セクション順序を、セクションオブジェクト自身に保持させている。
セクション順序とは、テキストファイルの中でセクションに最初から
順に０から始まる番号を振っていったものである。
セクション順序は、挿入・削除・分割・移動といった処理により
更新される。

ブックマークを別オブジェクトで管理するか、セクションオブジェクトを
スキャンして管理するかは、アプリケーションに依存する問題なので
そのセクション内のブックマークをブックマーク管理オブジェクトに
登録する処理は、セクションオブジェクトの処理から除外する。

セクション順序の更新を内部的に行なうか、挿入・削除・分割・移動といった
処理を呼び出した側で行なうかは、悩むところだが、セクション順序保持の
ためのメンバ変数をこのまま維持することとし、メンバ変数の保守は
内部的に行なうのが筋と判断する。

セクションオブジェクトクラスヘッダファイル

// MyNode.h: CMyNode クラスのインターフェイス

//
//////////////////////////////////////////////////////////////////////

#if !defined(AFX_MYNODE_H)
#define AFX_MYNODE_H

#if _MSC_VER >= 1000
#pragma once
#endif // _MSC_VER >= 1000

class CMyLine ;
class CMyLineMng ;

class CMyNode
{
// コンストラクタ、デストラクタ
public:

CMyNode() ;
virtual ~CMyNode() {};

// 初期化処理
public:

// セクションのテキストの開始ポインタ、
// そのセクションの開始行の行オブジェクトインデックス
// 行数を設定する。
// タイトル行を調べ、設定する
int SetTextData(char *pTOSect, int iIndex, int nLineNum);

public:

// セクションテキストの取得
const char * GetText(void) ;

public:

// トータルライン数
int GetLineNumber(void) { return nLineNumber; }/*9*/
// 現在行
CMyLine *GetCurrentLine(int iCharOffset) ;
// 最初の行
CMyLine *GetFirstLine() ;
// 指定行
CMyLine *GetLineObject(int offset) ;
// 行番号から文字オフセットを求める
int GetCharIndex(CMyLine *pLine, BOOL fStart = TRUE) ;

public:

// 現在のカーソル行をタイトルに設定
void SetTitleLine(CMyLine *pLine) ;
// タイトル文字列の取得
const char * GetTitle(void);
// Emptyセクションのタイトルが定義されているかどうか？
BOOL DefTitle(void) ;
// Emptyセクションのタイトルのセット
void SetEmptyTitle(void);
// 不要なタイトル行（文末SP）を削除する。
int ClearTitleLine(int iOffset);
// タイトル行の取得
CMyLine * GetTitleLine(void);

// キャレット位置の保存
void SetCharRange(CHARRANGE &cr) { crPos = cr ; }
// キャレット位置の復帰
CHARRANGE &GetCharRange(void) { return crPos ; }

// TreeCtrl関連
public:

// ツリービュー管理用メソッド
void SetTreeItem(HTREEITEM hTreeItem, CTreeCtrl *pTree) ;

HTREEITEM GetTreeItem(void) { return m_hTreeViewNode ; }

CTreeCtrl *GetTreeCtrl(void) { return m_pTree ; }
// 部分木からTreeCtrl関連の値をクリアする
int CrearTreeItem(void);

public:

// ツリービューのノード取得メソッド
static CMyNode * GetFirst(CTreeCtrl *pTree) ;
static CMyNode * GetCurrent(CTreeCtrl *pTree) ;

public:

// ツリービューのノード取得メソッド
CMyNode * GetNext (void) ;
CMyNode * GetPrev (void)  ;
CMyNode * GetParent(void) ;
int GetLevel(void) ;
BOOL IsEmptyNode(void) ;

// TreeCtrlのツリー構造のコピー
int MapSubTree(void);

// ツリービュー状態取得メソッド
BOOL IsSelected(void) ;
BOOL IsExpanded(void) ;

// ツリー構造操作

// 新規セクションの追加
static void AddNewNode(CTreeCtrl *pDstTree, CMyNode *obj, int mode) ;
// 木構造のコピー
static int CopySubTree(CMyNode *pSrc, CTreeCtrl *pDstTree,
	CMyNode *pDst=NULL, UINT mode=0, BOOL bChangeOrder = FALSE) ;
// 部分木の移動
static int MoveSubTree(CMyNode *pSrc, CTreeCtrl *pDstTree,
	CMyNode *pDst, UINT mode, BOOL bChangeOrder) ;
// セクション分割
void Divide(CMyNode * obj, long lCharOffset, UINT mode = TVGN_NEXT) ;
BOOL CanDivide(int iCharIndex) ;

// TreeCtrlのアイコンイメージ関連

int GetImageID(void) ;

static void SetImageList(CTreeCtrl *pTree) ;

// 改行コード関連
public:

// 改行コードの設定
void SetPageFeed(BOOL fPageFeed) ;
// 改行コード設定状況
BOOL IsPageFeed(void) { return m_fPageFeed ; }

// セクション順序関連
public:

// セクション順序の取得
int GetOrder(void) { return iNodeOrder; }
// セクション順序の設定
static int SetOrder(CTreeCtrl *pTree);

public:

// テキストのクリップボードへのコピー
void CopyToClipboard(void);
// セクション内テキストのファイルへの書き込み
CMyNode * Write(CFile *pFile) ;

protected:

void WriteFocus(CFile *pFile) ;
void WriteExpanded(CFile *pFile) ;
void WritePageFeed(CFile *pFile) ;
// 空セクションのタイトルの書き込み
void WriteOnlyTitle(CFile *pFile) ;

// 行管理オブジェクト
public:

// ドキュメントオブジェクトの初期化処理で設定される
static void SetLineMng(CMyLineMng *obj) { m_pLineMng = obj ; }

protected:

static CMyLineMng * GetLineMng(void) { return m_pLineMng ; }

// リンクメンバ関数
public:

// ファイルデータのセクション関係のアクセス
CMyNode * GetNextNode(void);
CMyNode * GetParentNode(void) { return pParent; };

// 切り離し
void ClearLink(void) ;
// 弟の追加
void AddBrother(CMyNode *new_node) ;
// 長男の追加
void AddChild(CMyNode *new_node) ;

private:

CMyNode * GetNextIndepentNode(void);

public:

// ノードの開閉状態
void SetNodeState(BOOL bClose) { bNodeClose = bClose; };
BOOL GetNodeState(void) { return bNodeClose ; };

public:

static int InitResource(void) ;
// TreeCtrl Title
static LPCSTR GetStrEmpty(void) { return strEmpty; }
static LPCSTR GetStrBranch(void)  { return strBranch ; }
static LPCSTR GetStrNULL(void) { return strNULL; }
static LPCSTR GetStrUntitled(void) { return strUntitled; }

protected:

char * pTOSection ;     //  セクションテキストＰＴＲ
int nTitleLineNumber;   //  タイトル行番号
int nLineNumber ;       //  行数
int iStartLineIndex ;   //  行オブジェクトインデックス
CHARRANGE crPos ;       //  キャレット位置（選択位置の保存）
BOOL m_fPageFeed ;      //  改ページコード
int iNodeOrder ;        //  セクション順序

protected:

CTreeCtrl *m_pTree ;        //TreeCtrlへのポインタ
HTREEITEM m_hTreeViewNode ; //TreeCtrlのノードへのハンドル（HTREEITEM）

// リンクメンバ変数
protected:

CMyNode * pParent;  //　　親セクション
CMyNode * pHead;    //　　長子セクション
CMyNode * pNext;    //　　弟セクション

BOOL bNodeClose ;   //  ノード状態（[+/-])

protected:

static CMyLineMng *m_pLineMng ; // 行管理オブジェクト

// シーケンスライン作成用パラメータ
protected:

static int nNextSectionType ;   // 次のセクションとの関係
static int nUpStep ;    // 完結セクション数

protected:

static  CImageList ilEmpty ;    // TreeCtrl用イメージリスト

protected:

static CString strEmpty ;       // empty title
static CString strBranch ;      // branch title
static CString strNULL ;        // NULL str
static CString strUntitled ;    // Untitled title

// セクション間の関係

enum {
	eChildSection,      // 子セクション
	eBrotherSection,    // 弟セクション
	eParentBrotherSection,  // 親（祖先）の弟セクション
	eTerminate,         // 次のセクションはない
} ;

};

// セクション追加処理に関する定数
enum {

ANN_CHILD,  // 長子
ANN_PARENT, // 親
ANN_PREV,   // 兄
ANN_NEXT,   // 弟

} ; /* AddNewNode */

// セクション移動（コピー）処理に関する定数
enum {

MST_FIRST_CHILD, // 長子
MST_LAST_CHILD,  // 末子
MST_PREV,        // 兄
MST_NEXT,        // 弟
MST_REPLACE,     // 置換

} ; /* MoveSubTree */

// セクションのスライドに関する定数
enum {

SN_UP,          // 上へ(スライドアップ)
SN_DOWN,        // 下へ(スライドダウン)
SN_CHILDRENUP,  // 子セクションを上へ(子セクションのスライドアップ)

} ; /* SlideNode */

inline
LPCSTR StrEmpty(void) {

return  CMyNode::GetStrEmpty() ;}

inline
LPCSTR StrBranch(void) {

return  CMyNode::GetStrBranch() ;}

inline
LPCSTR StrNULL(void) {

return  CMyNode::GetStrNULL() ;}

inline
LPCSTR StrUntitled(void) {

return  CMyNode::GetStrUntitled() ;}

// ツリービュー管理用メソッド
inline
void CMyNode::SetTreeItem(HTREEITEM hTreeItem, CTreeCtrl *pTree) {

	m_hTreeViewNode = hTreeItem ;
	m_pTree = pTree ;

}

// 切り離し

inline
void CMyNode::ClearLink(void) {

	pHead = NULL ;
	pNext = NULL ;
	pParent = NULL ;
};

// 弟の追加

inline
void CMyNode::AddBrother(CMyNode *new_node) {

	pNext = new_node ;
	new_node->pParent = pParent ;
};

// 長男の追加

inline
void CMyNode::AddChild(CMyNode *new_node) {

	pHead = new_node ;
	new_node->pParent = this ;
};

inline
void CMyNode::SetImageList(CTreeCtrl *pTree) {

pTree->SetImageList( &ilEmpty, TVSIL_NORMAL); }

#endif // !defined(AFX_MYNODE_H)

検索処理の見直し(2000/01/01)

検索処理の見直しを行なうこととする。

はじめに、STEDの検索動作を調査する。

+---STED検索動作
| 現在のキャレット位置からテキストの最後まで検索する
|+---検索に成功した場合
|| エディットペインに検索部分を選択状態にし表示する
|+---検索に失敗した場合
||テキストの最初からキャレット位置まで検索する
||+---検索に成功した場合
||| サウンドＡを鳴らす
||| エディットペインに検索部分を選択状態にし表示する
||+---検索に失敗した場合
||| サウンドＢを鳴らす
||+---
|+---
+---

このようにSTEDでは、テキストの最後までいったら、再び先頭に戻り
繰り返し検索動作を行なっている。
一方、メモ帳の検索動作を調べてみると

+---メモ帳の検索動作
| 現在のキャレット位置からテキストの最後まで検索する
|+---検索に成功した場合
|| エディットペインに検索部分を選択状態にし表示する
|+---検索に失敗した場合
|| サウンドＡを鳴らす
|| 見つかりませんダイアログを表示する
|+---
+---

ここで大決心。Simple is BEST!!!
Stviの検索動作は、次のようにしよう。

+---Stviの検索動作
| 現在のキャレット位置からテキストの最後まで検索する
|+---検索に成功した場合
|| エディットペインに検索部分を選択状態にし表示する
|+---検索に失敗した場合
|| サウンドＡを鳴らす
|+---
+---

さて、ここで簡単に利用できるCRichEditViewの便利な関数として
以下のものがある。
CRichEditView::FindText

指定されたテキストを検索し、現在の選択になるように設定する。

CRichEditView::OnFindNext

[編集][検索]メニューにより、検索ダイアログが表示され、
ダイアログの[次を検索]ボタンを押すとこの関数が呼ばれる。

CRichEditView::OnTextNotFound

検索に失敗したとき呼び出される関数でサウンドＡを鳴らす。

これらを組み合わせて、セクション間にまたがる
・指定した文字列の検索
・上方向に検索
・下方向に検索
を実現する。

ここで既知の以下の問題点がある。

（１） CRichEditView::OnFindNext には、検索方向を指示するパラメータが
あるが、これがうまく動作せず常に下方向に検索される。
（２）FindText，OnFindNextともに、検索は現在のキャレット位置から最後まで
行い、ここで見つからない場合、すぐにはOnTextNotFoundが呼びだされず、
次に先頭から現在のキャレット位置までの検索が行われる。このように現在、
表示中のテキスト全てを検索した後でないと、OnTextNotFoundが呼びだされない。

そこで仕方なく、次のCRichEditCtrlのメンバ関数も使用することとする。

CRichEditCtrl::FindText

指定した検索範囲内で指定されたテキストを検索する。

また、本当は基本クラスで保持しているはずの情報だけど、
「上方向に検索」を実現するために、

・検索する文字列
・「単語単位で探す」フラグ
・「大文字と小文字を区別する」フラグ

は、ローカルクラスCMyEditViewでも保持していた方がよさそうである。
この情報のことを以下の説明では「単語検索情報」と呼ぶこととする。

さて、ここから以降がいよいよ本当の設計。

本プログラムでは、次の３つの仮想関数をオーバーライドする。
void FindText(LPCTSTR lpszFind, BOOL bCase, BOOL bWord) ;
void OnFindNext(LPCTSTR lpszFind, BOOL bNext, BOOL bCase, BOOL bWord) ;
void OnTextNotFound(LPCTSTR lpszFind) ;
これにより、
・指定した文字列の検索
・上方向に検索
を実現する。また、
・下方向に検索
の処理がよばれた時のハンドラとして、
afx_msg void OnSectionFindprev();
を用意する。

まず、はじめにOnTextNotFoundの処理を示す。

+--- CMyEditView::OnTextNotFound
| （NotFoundフラグ）をセットする。
+---

次に、OnFindNextの処理内容を示す。

+--- CMyEditView::OnFindNext
| 「単語検索情報」を保存する
| 現在のセクションIDおよびキャレット位置を保存
| （NotFoundフラグ）をクリア
|
| CRichEditView::OnFindNext を Call
|
|+---（NotFoundフラグ）がクリアのままの時
|| キャレット位置を調べる
||+---キャレット位置が下方向に移動している時(検索成功)
||| return
||+---
|+---
|
| /* 現在表示中のセクションで検索に失敗した時の処理 */
|+=== 順方向セクション間検索処理
||次のセクションを求める
||+---次のセクションが存在する時
||| 新しいテキストをCRichEditCtrlに登録
||| NotFoundフラグをクリア
||| CRichEditView::OnFindNext を Call
|||
|||+---NotFoundフラグがクリアのままの時(検索成功)
||||マークアップ処理
||||return
|||+---NotFoundフラグがセットされている時(検索失敗)
||||continue
|||+---
||+---次のセクションが存在しない時(検索失敗)
||| 保存していたセクションのテキストおよびキャレット位置を復帰
||| マークアップ処理
||| CRichEditView::OnTextNotFound を Call
||| break
||+---
|+---
+---

ここで「マークアップ処理」とは次の内容を指す。

+---「マークアップ処理」
| 現在の選択範囲（キャレット位置）を保存する。
| ツリービューの選択アイテムを変更
| タイトル行のフォントを変更
| ブックマーク行のフォントを変更
| 選択範囲（キャレット位置）を復帰する。
+---

FindTextの処理内容は、OnFindNextの処理の中で

CRichEditView::OnFindNext を Callするところを
CRichEditView::FindText を Callするように変更すれば

OnFindNextの処理と同様である。
さて、最後にOnSectionFindprevの処理を示す

+--- CMyEditView::OnSectionFindprev
| 現在のセクションIDおよびキャレット位置を保存
|
| 「単語検索情報」を取得する
| 検索範囲を0からキャレット位置までに設定する
| CRichEditCtrl::OnFindNext を Call
|
|+---検索に成功した時
|| 検索範囲の中で最も後方の単語の範囲を求める
|| 単語の範囲を選択状態にする
|| return
|+---
|
| /* 現在表示中のセクションで検索に失敗した時の処理 */
|+=== 逆方向セクション間検索処理
||前のセクションを求める
||+---前のセクションが存在する時
||| 新しいテキストをCRichEditCtrlに登録
||| 検索範囲を0からテキストの最後の位置までに設定する
||| CRichEditCtrl::FindText を Call
|||
|||+---検索に成功した時
|||| 検索範囲の中で最も後方の単語の範囲を求める
|||| 単語の範囲を選択状態にする
|||| マークアップ処理
|||| return
|||+---検索に失敗した時
||||continue
|||+---
||+---前のセクションが存在しない時(検索失敗)
||| 保存していたセクションのテキストおよびキャレット位置を復帰
||| マークアップ処理
||| CRichEditView::OnTextNotFound を Call
||| break
||+---
|+---
+---

さて、ここで「検索範囲の中で最も後方の単語の範囲を求める」処理は
次の内容となる。

+---「検索範囲の中で最も後方の単語の範囲を求める」
|+===
||現在の「単語の範囲」を保存する。
||検索範囲の開始を「単語の範囲」の最後に変更する
||CRichEditCtrl::OnFindNext を Call
||+---検索に成功した場合
||| contine
||+---検索に失敗した場合
||| break
||+---
|+---
|
|「単語の範囲」を復帰する。
+---

以上。

ＰＳ：こんだけまとめるのに、ほぼ朝から晩までかかってしまった。
「stviでは検索処理はサポートしない」と決断した方が良かったかしら？

追加（2000/01/03）

[編集]メニューの[次を検索]を選べば、中で
FindTextが呼ばれていると思ったのだが
あてが外れてしまった。
[編集]メニューの[次を検索]について別にハンドラを用意する必要があった。

あと、ステータスバーの更新処理が抜けていた。

修正(2000/01/03)

どうも、
CRichEditView::OnFindNext
CRichEditView::FindText
の検索動作がおかしい？
・検索すべき単語をみつけられない。
・無指定で見つからない単語が

「単語単位で探す」フラグ
「大文字と小文字を区別する」フラグ

を設定すると見つかる場合がある。

とりあえず、
CRichEditCtrl::FindText
は、期待通りの動きをするので、これで置き換えることとする。

結局
void FindText(LPCTSTR lpszFind, BOOL bCase, BOOL bWord) ;
void OnTextNotFound(LPCTSTR lpszFind) ;
のオーバーライトは止めにする。

INIファイルの使用(1999/12/17)

本当はレジストリを使う形式のまま、行きたかったのですが、
「インストールとアンインストール」のREADMEを作成しようとすると、
（かつアンインストーラは作成しないとすると）、説明が非常に
煩雑になるので、INIファイルを使用するようプログラムを
変更します。

単語を選択(Ctrl+W)(1999/11/23)

この機能に関しては、ダブルクリック動作と同じなので
デバッガでダブルクリック時動作を確認し、
そのコードに(Ctrl+W)を割り当てることとする。

単語を選択(その２)(1999/11/25)

デバッガで追ってみても、よう解らないので、
Ctrl+Wが押されたら、ダブルクリックメッセージが
ポストされるようにコーディングを行なう。
CRichEditViewにポストしてもだめで、CRichEditCtrl
にポストすると単語選択の動作を行なう。

これでいいこととしよう。

カーソル位置のインジケータ表示(1999/11/21)

インジケータにエディットペイン内のカーソル位置を表示する機能が
現在の構造化エディタにはある。

エディットペイン内のカーソル位置は、
行列ともに０からはじまる。

これと似た機能として折り返しが無効の時使用できる
［カーソル位置の取得]機能がある。ヘルプには、
「Ctrl + Ｐで、ファイル全体の中でのカーソルの位置が
分かります。」と記述されている。

これは、行列ともに１からはじまる。

本ツールにおいては、
「エディットペイン内のカーソル位置」
「ファイル全体の中でのカーソルの行番号」
をステータスバーに表示することとする。

現在のクラス構成（1999/11/06）

さて、削除したセクションを、次のテキストファイルを読み込む度に
破棄して良いのなら、話は簡単なのだが、破棄しないとなると
若干のデータ構造の修正が必要になってくる。

修正する前に、現状をまとめて、頭をすっきりさせるのが
この文書化の目的です。

CStviApp アプリケーションクラス
CStviDoc ドキュメントクラス
CStviCntrItem OLEクライアントアイテムに関連したクラス

（AppWizardが勝手に作成した。
よくわからないのでいじっていない。)

ウインドウ
+---CMainFrame メインウインドウ
| CMyEditView エディットビュー
| CStviView ツリービュー
+------------

ダイアログおよび（呼び出しクラス）
CAboutDlg (CStviApp) バージョン情報
CBMList (CStviDoc) ブックマーク一覧／タイトル一覧
CHVSelect (CMainFrame) 分割方向
CMyFontSelect (CMainFrame) フォント
CSaveOpt (CStviApp) オプション

CMyBMMng ブックマーク管理オブジェクト
CMyBookMark ブックマークオブジェクト
CMyFileMng ファイル管理オブジェクト
CMyLine 行オブジェクト
CMyLineAry 行管理オブジェクト
CMyNode セクションオブジェクト
CMyNodeMng セクション管理オブジェクト

VC++のClass Viewに表示されているクラスは以上の通り。

各管理オブジェクトは全てドキュメントに組込まれている。

+---CStviDoc
| CMyBMMng ブックマーク管理オブジェクト
| CMyFileMng ファイル管理オブジェクト
| CMyLineAry 行管理オブジェクト
| CMyNodeMng セクション管理オブジェクト
+------------

現在のデータ構造の問題点（1999/11/06）

CMyNodeオブジェクトがクラス変数（メンバ変数ではない）で、
CMyLineAryへのポインタを保持し、これにアクセスしている。

このため、下記クラスを

CMyBMMng    ブックマーク管理オブジェクト
CMyFileMng  ファイル管理オブジェクト
CMyLineAry  行管理オブジェクト
CMyNodeMng  セクション管理オブジェクト

もう一組用意しても正常動作しない。

実現手段(1999/11/07)

削除されたノードのもつデータは、
CFileMngとは別のオブジェクトで保持する。

CLineAry, CNodeMngは、新規および削除されたもの、両方の
オブジェクトを保持する。

ブックマーク操作は、メインウインドウのツリービューに表示されて
いるセクションについてのみ行う。

したがって、「ファイルを開く」のメニューが選択された後は、

（１）削除ノードのデータをsted formatでメモリーファイルに書き込む

この時にセクション数、行数を確認
（これで、ファイル管理オブジェクトデータを解放しても大丈夫になる）

（２）選択されたファイルを従来の方法で読み込む。

ただし、セクション管理オブジェクト、行管理オブジェクトは
削除ノードのデータを格納するための領域を余分に確保

（３）メモリーファイルの内容を、各オブジェクトに設定する

セクション・レベル編集（1999/10/30）

セクション単位の追加、削除機能を実現する。
ツリービューをもうひとつ用意し、削除したセクションを一時保管する。
追加セクションは、空もしくはタイトル行のみとする。

セクション分割機能を実現する。
カーソル行より上と、カーソル行以下を別セクションに分割する。
テキストファイルの"sted format"化のための支援機能である。
（セクションマージおよび分割のundoは、取敢えずパス。）

次の文章を開く、直前に、削除したセクション群は保存することとする。
こうすることにより、実質的にある文書から別の文書への
Drug&Dropによるセクション（ツリー）コピーを実現する。
（[全セクション削除]、[第２ビューを空にする]メニューを追加する。
第２ビューの内容はアプリケーション終了時に破棄するものとする。）

セクション分割（1999/10/31）

セクション分割の実現のためには

・セクションオブジェクトの供給機構
・テキストバッファへNULL文字の代入。最後の改行記号に上書き。
・元のセクションオブジェクトを前半のセクションとし、
追加セクションオブジェクトを後半のセクションとする。
・フォーカスは後半のセクションに設定
・1行目および最終行では分割できないようにする。
（空セクション追加という手段も代替案としてある）
・タイトル行の調整
・ブックマークの調整

削除セクション（1999/11/05）

セクションの削除が可能になった
そうなると、当然、削除セクションの復活機能が欲しくなる。

本当は、第2ツリービューを用意して、対応したいのだが、
私に手のあまる状況なので、とりあえずは、
ダイアログボックスに削除セクションの一覧を表示し、
ここで選択したものを、復活するということで
お茶を濁したい。

α版残作業(H11.10.24)

現在の0.8x台をα版と位置付け、
次の作業をクリアした段階で0.90βとする。

・ツリーペインのコピー処理
・上向き検索

そして、β版に対して次の作業をクリアした段階で1.00とする。

・ショートカットキーに関して、STEDとの整合性をとる。
・（印刷関係のメニュー、ボタンの削除）
・不正な"sted format"ファイルをテキストファイルとして読み込む

改ページコード(H11.10.17)

シェアウェア「秀丸」の印刷機能においては、[ctrl]+[L]が、
改ページコードとして認識されることが判明した。

すなわち、「セクション毎に改ページして印刷してくれる」状態に
"sted format"の文書を編集できることが判明した。

「印刷ツール」を実現するにしても、

・指定レベルのセクション間で改ページ動作を行う。

といった、セマンティックな処理をツールに実行させるよりは、
(セマンティックってこんな使い方で良かったっけ？）

・改ページコードがあれば改ページ動作を行う。

とした方が簡単で使いやすいと考えた。

このための修正は、

・セクションオブジェクトに改ページコードフラグを用意する。
・セクション先頭の改ページコードは、エディットビューに表示しない。

といったところかな？

ブックマーク（３）

複数のブックマーク間を移動する場合、
メニューで「次のブックマークへ」を選ぶのは
かなりかったるい。
これは、ツールバーで実現した方がよさそうだ。

また、ブックマーク行のフォントを変えて表示するというのも
面白そうだ。

ブックマーク（２）

キャレットの移動

キャレットの移動に次のメンバ関数を使用しようとしたが
CWnd::SetCaretPos
なぜか思ったような動作をしない。

仕方がないので、ブックマーク行の一字目をセレクトした後、
選択を解除することでカーソルを移動を行うことにした。

メニュー

ブックマークの移動に関するメニューを
[表示][ブックマーク]の下に列挙する予定だったが、
各メニュー項目の（有効／無効）の判断処理が
［ブックマーク］サブメニューを選択した時ではなく、
[表示]メニューを選んだ段階で呼ばれることがわかったので、
ブックマーク関連に関しては、別にトップメニューとして
作ることにする。

現在カーソルの有る行が、ブックマーク行か否かの判断

現在カーソルの有る行が、ブックマーク行か否かの判断は、
現在のカーソル位置が、ブックマーク行リストのデータと
一致するかどうか順次比較することにより行うものとする。

カーソル行から行オブジェクトを求め、行オブジェクトに
問い合わせるという方法も考えられるが、
行オブジェクト特定するまでの比較回数と、
ブックマークの数では、ブックマーク数の方が少ないだろう
という判断である。

ブックマーク

まず、キャレットを文章中の任意の場所に移動する方法を
みつけなければ。
CRichEditCtrlのメンバ関数にあるのでは無いかと期待したのだが、
ようわからん。試行錯誤するしかないか。

MFCにおけるキャレットの取扱いを勉強せねば。

アルゴリズム

・ブックマーク行の行オブジェクトおよび
セクションオブジェクトを求める。
・そのセクションのテキストをRichEditCtrlに登録する。
・文字Indexを得る。
・文字Indexから行番号を得る。
・その行が先頭になるようにスクロールする。
・キャレットをそこに移動する

結局、最終的に使用するメンバ関数は

CRichEditCtrl::LineIndex
CRichEditCtrl::LineFromChar
CRichEditCtrl::LineScroll
CRichEditCtrl::GetCharPos
CWnd::SetCaretPos

になるのかな？

ブックマークオブジェクトおよびブックマーク管理オブジェクト

ブックマークオブジェクトは次のメンバ変数を持つ
・セクションオブジェクト
・行オブジェクト

ブックマーク管理オブジェクトはCPtrArrayを用いて実現する。
これは、ブックマーク行の数に制限を付けたくないが、
行数分だけ用意するのは非常に無駄な気がするからである。

ブックマーク管理オブジェクトは
ブックマークオブジェクトの生成、消滅を行い、
必要に応じソートし、次の条件に対応した
ブックマークオブジェクトを返すメンバ関数を持つ。

・最初のブックマークオブジェクト
・最後のブックマークオブジェクト
・指定行の次のブックマークオブジェクト
・指定行の前のブックマークオブジェクト

ブックマーク行のソート

ブックマーク行が複数ある場合のソートに関し、
ブックマーク行の大小判断は次のように考える。

セクションが違う場合、早いセクションのブックマーク行が小さい
セクションが同じ場合、行番号の小さいブックマーク行が小さい

セクション間のノード判断のために次のメンバ変数を
セクションオブジェクトに追加する。

int iNodeOrder

RichEditViewへの変更

現在のCEditViewをCRichEditViewに変更した方が良いのでは
無いかと思案中。

理由1：CEditViewだと、64Kの壁に制約を受ける。

理由2：HTMLで保存等の機能を実現する際に、WYSIWYGを
実現しやすい。

で、変更するとすれば、なるべく早い方が（機能の少ない
内にやった方が）良いのかなと思っています。

RichEditViewの使用に関して（１）

とりあえず、CRichEditViewを使用したアプリケーションを
AppWizardで作成してみる。
どうやら、CRichEditViewを使用するためには、
OLEコンテナサポートが必要なようだ。
ＯＫを選択すると、コンテナアイテムのクラスが
作成されていた。

今までは、CTreeViewで、アプリの骨格を作り、これに、
CEditViewを追加してきたが、今回は、CTreeViewを後から追加した
方がよさそうである。

あと、CEditViewをCRichEditViewに変更するかどうかの
判断材料は、私的には、
・実行速度
・プレーンテキストの扱いやすさ
・タブの指定
となりますが、CRichEditViewを使用して作られているといわれる
ワードパッドアプリケーションにテキストファイルを読み込ませて
みても、問題はなさそうですし、タブの設定に関するメニューも
あるので、思いきって移行してみます。

ビューへのアクセス

現在(9/4)、アプリケーションオブジェクトにツリーコントロールと
エディトボックスを管理させているが、メインウインドウにツリービューと
エディットビューを管理させた方がよいのではないかと思っている。
また、実際にツリーコントロールおよびエディトボックスが
ウインドウとして存在する段階で登録しようと考え、OnInitialUpdateを
登録のタイミングとして選んだが、それぞれのコンストラクタで登録して
問題無いのではないだろうか？
また、void CStviApp::UpdateViewCtrl(CMyNode *obj)に関しても、
メインウインドウ(CMainFrame クラス)に移した方が美しい気がする。

ビューへのアクセス Ⅱ（2000/01/12）

ドキュメントオブジェクトがビューを変更したい場合には
UpdateAllViewsメソッドを使用するのが、
ドキュメント／ビューモデルらしいコーディングの仕方である。

ビューが、他のビューを変更したい場合は、
GetDocument()->UpdateAllViews(this, lHint, pHint) ;
とするのが、正当な更新の仕方のようだ。

どうしても、特定のビューにアクセスしたい場合には、
CMainFrame(アプリケーション固有のフレームウインドウ)に
特定のビューを返すメソッド(ex. GetSpecialView())を用意し、
CView *pvWant = ((CMainFrame *)AfxGetMainWnd())->GetSpecialView() ;
とすれば、アクセスできる。

たとえば、本アプリケーションでツリービューを返すメソッドは、
次のようになる。

CStviView *GetTreeView(void) {
	return (CStviView *)m_wndSplitter.GetPane(0,0) ;}

但し、
CStviView ：ツリービューのクラス名
m_wndSplitter ：次のように定義されたCmainFrameのメンバ変数
CSplitterWnd m_wndSplitter ;

セクションオブジェクト

現在(9/4)、セクションオブジェクト(CMyNode オブジェクト)の中には、
初期化処理にしか使用しない属性およびメソッドが含まれている。
これらを完全に分離した方が、プログラムは見やすくなるのでは
ないだろうか？

リンクメンバ（2000/01/12）

これらのメンバ変数、メンバ関数は、
リンクメンバ変数
リンクメンバ関数
として、セクションツリーの移動やコピーの際に、
大活躍することになりました。

設計メモ

目次

ExpandとSelect(2000/01/12)

（１）セクションオブジェクトの汎用化(2000/01/09)

・定数(2000/01/10)

CMyNode::AddNewNode 新規セクションの追加/挿入(2000/01/09)

MoveSubTree 部分木の移動(2000/01/10)

CopySubTree 木構造のコピー

・補足（ブックマーク）(2000/01/09)

セクションオブジェクトクラスヘッダファイル

// MyNode.h: CMyNode クラスのインターフェイス

追加（2000/01/03）

修正(2000/01/03)

単語を選択(その２)(1999/11/25)

現在のデータ構造の問題点（1999/11/06）

実現手段(1999/11/07)

セクション分割（1999/10/31）

削除セクション（1999/11/05）

キャレットの移動

メニュー

現在カーソルの有る行が、ブックマーク行か否かの判断

関連するメンバ関数

GetLineCount

GetFirstVisibleLine

LineIndex

LineLength

アルゴリズム

ブックマークオブジェクトおよびブックマーク管理オブジェクト

ブックマーク行のソート

RichEditViewの使用に関して（１）

ビューへのアクセス Ⅱ（2000/01/12）

リンクメンバ（2000/01/12）

設計メモ

目次

ExpandとSelect(2000/01/12)

（１）セクションオブジェクトの汎用化(2000/01/09)

・定数(2000/01/10)

CMyNode::AddNewNode 新規セクションの追加/挿入(2000/01/09)

MoveSubTree 部分木の移動(2000/01/10)

CopySubTree 木構造のコピー

・補足（ブックマーク）(2000/01/09)

セクションオブジェクトクラス ヘッダファイル

// MyNode.h: CMyNode クラスのインターフェイス

追加（2000/01/03）

修正(2000/01/03)

単語を選択(その２)(1999/11/25)

現在のデータ構造の問題点（1999/11/06）

実現手段(1999/11/07)

セクション分割（1999/10/31）

削除セクション（1999/11/05）

キャレットの移動

メニュー

現在カーソルの有る行が、ブックマーク行か否かの判断

関連するメンバ関数

GetLineCount

GetFirstVisibleLine

LineIndex

LineLength

アルゴリズム

ブックマークオブジェクトおよびブックマーク管理オブジェクト

ブックマーク行のソート

RichEditViewの使用に関して（１）

ビューへのアクセス Ⅱ（2000/01/12）

リンクメンバ（2000/01/12）

セクションオブジェクトクラスヘッダファイル