TextGridCtrlライブラリ
公式ガイドブック
(C)2000-2026 kuzu

はじめに

TextGridCtrlライブラリは、MFC(Microsoft Foudation Class)拡張ライブラリであり、CWndから派生した、プレーンテキストのグリッドコントロールのクラスである。このライブラリは、Excelのようにグリッド上にテキストを入力できる他、グリッド数の設定や、選択部の切り取り・コピー・貼り付け機能を有する。

TextGridCtrlライブラリはC++言語で書かれており、ソースコードのほか、ダイナミックリンクライブラリ(*.dll)の形で提供される。ライセンスはオープンソースで、LGPL又はMPLのデュアルライセンスである。

▲デフォルトの見え方

▲選択して右クリックをし、「コピー」しようとしているところ。

▲切り取り・コピー・貼り付けは、Excelなどの表計算ソフトと互換している。

第1章：概略

1-1.TextGridCtrlについて

CTextGridCtrlは、MFCの拡張クラスであり、CWndより派生する。

CObject
└CWnd
　└CTextGridCtrl

1-2.構築方法

主にダイアログボックス内にコンボボックス同様に配置して使う。ただし、リソーススクリプト上では配置できないので、CDialog::OnCreateで手動で作成し、CDialog::OnInitDialogで手動で位置合わせする。ここではリソーススクリプト上でダミーのStaticを配置し、そこに手動でCTextGridCtrlを重ねる方法を示す。

class CTextGridCtrl143TestDlg : public CDialog {
	...
	CTextGridCtrl m_theTextGridCtrl;
	...
};

int CTextGridCtrl143TestDlg::OnCreate (LPCREATESTRUCT lpCreateStruct) {
	if (CDialog::OnCreate(lpCreateStruct) == -1) {
		return -1;
	}
	// カラーコンボボックスの作成
	m_theTextGridCtrl.Create (
		WS_BORDER | WS_VISIBLE | WS_CHILD | WS_TABSTOP | WS_VSCROLL, 
		CRect (10, 10, 300, 300), this, IDC_COLOR_COMBO_BOX);
	return 0;
}

BOOL CTextGridCtrl143TestDlg::OnInitDialog () {
	CDialog::OnInitDialog();
	...
	// テキストグリッドコントロールの位置とサイズ調整
	CRect rcStaticDummy;
	CWnd* pStaticDummy = GetDlgItem (IDC_STATIC_DUMMY);
	pStaticDummy->GetWindowRect (&rcStaticDummy);
	this->ScreenToClient (&rcStaticDummy);
	m_theTextGridCtrl.MoveWindow (&rcStaticDummy);
	pStaticDummy->DestroyWindow ();
	return TRUE;
}

1-3.行数・列数・行幅・列幅・タイトル行文字列・タイトル列文字列・セル文字列の取得・設定方法

関数リファレンスを参照してください。

1-4.破棄方法

上記の場合、m_theTextGridCtrlは親ウィンドウの破棄と同時に自動で行われるので、何もしなくてよい。

1-5.プロジェクト設定事項

ソースコードで、Windows及びMFC関係のものを#includeしてから、#include "TextGridCtrl.h"をすること。ファイル名だけでなくヘッダーファイルのパスを通してくこと。

プロジェクトの設定-詳細で、「共有DLLでMFCを使う」「Unicode文字セットを使用する」を選択すること。

プロジェクトの設定-C/C++-プリプロセッサ-プリプロセッサの定義で、_UNICODE, UNICODEを有効にすること。

プロジェクトの設定-リンカ-入力-追加の依存ファイルで、"TextGridCtrl(d).lib"を追加すること。ファイル名だけでなく、パスを通しておくこと。

Visual Stuido 2015以降では、MFCはデフォルトのC/C++デスクトップ開発に付属しておりません。MFCをインストールしていない場合は、Visual Studio Intallerで、MFCのオプションを追加インストールする必要があります。

このライブラリを使った最小限のCTextGridCtrl143Testも別途配布しておりますので参考にしてください。

第2章：CTextGridCtrlリファレンス

2-1.概要

2-2.アトリビュート

ドキュメントデータ(protected)

非ドキュメントデータ(protected)

一時的な状況保存用データ(protected)

描画オブジェクトなど(protected)

2-3.オペレーション

行数と列数の取得と設定

行高さと列幅の取得と設定

各種文字列の取得と設定

行列の挿入と削除(サポートしません)

選択範囲の取得と設定

カレントセルの取得と設定

親ウィンドウへの通知時の状態取得(2025/09廃止)→後述のTextGridNotify構造体に移行

オートスクロール処理(内部隠蔽)

ウィンドウスタイル・各セル属性の取得と設定

編集処理(元に戻す(U)・やり直し(R)・切り取り(T)・コピー(C)・貼り付け(P)・削除(D))

2-4.通知メッセージ

このコントロールは、ダイアログの子コントロールである場合、所定のイベントが発生すると次のメッセージを親ウィンドウに送る。

メッセージは常にpParent->SendMessage (WM_NOTIFY, (WPARAM)GetDlgCtrlID (), (LPARAM)(&theTextGridNotify));で送られる。親ウィンドウの受信側で、theTextGridNotifyを解析することにより送られてきた送られてきたメッセージの種類(下記参照)、ウィンドウのハンドル、送られてきたコントロールのID、さらに特定のセルに関わるものは、メッセージが送られたときのセル行、セル列、範囲上、範囲下、範囲左、範囲右を取得することができる。

TextGridNotify構造体

通知メッセージとその値とその意味

ヴァージョン情報