sgcGrid 機能マトリクス
sgcGrid のすべての機能を、用途別にまとめ、各機能のヘルプトピックへのリンクを付けています。VCL、FireMonkey、WinForms、WPF、Avalonia のグリッドは、同じモデルで動作します。
sgcGrid のすべての機能を、用途別にまとめ、各機能のヘルプトピックへのリンクを付けています。VCL、FireMonkey、WinForms、WPF、Avalonia のグリッドは、同じモデルで動作します。
3 個の機能
15 個の機能
4 個の機能
12 個の機能
5 個の機能
2 個の機能
8 個の NuGet パッケージ
オンラインヘルプと PDF マニュアル
登録版 は、登録版と体験版に含まれ、無料の Community 版には含まれない機能を示します。~ は、Community 版が一部のみ備える機能を示し、違いは下に記載しています。
すべての行は、対応するヘルプのトピックにリンクしています。Community 列は、無料の .NET Community 版に含まれる機能を示します。すべての機能は登録版と体験版に含まれます。
列フィルター、フィルター行、検索パネル、列チューザー、列の移動、最適幅、レイアウト、複数選択、バンド、セルタイプ、DataSet 編集、貼り付け、元に戻す操作、sgcEditors のセルエディターは、Delphi と C++ Builder 向けの VCL および FireMonkey グリッドにあり、.NET 向けの WinForms、WPF、Avalonia グリッドにもあります。Community と登録版の内訳は同じで、エディションで説明しています。.NET では、DataSet 編集は DataTable に書き戻され、AddLookup がルックアップ列を追加し、SyncCursor は Delphi のみです。
| 機能 | 詳細 | Community | ヘルプ |
|---|---|---|---|
| 任意のスレッドからのリアルタイム更新 | Data.AppendRow と Data.UpdateRow はスレッドセーフです。キー指定で 1 つまたは複数のフィールドを更新でき、BeginUpdate と EndUpdate で連続した更新を 1 回の再描画にまとめ、MaxFPS で描画頻度を調整できます。 | ヘルプ | |
| 変更時の点滅 | 値が上がったセルは緑、下がったセルは赤に点滅し、その後フェードアウトします。テールモードでは、ログやフィードの最新行が常に表示されます。 | ヘルプ | |
| 仮想モード | 行を保持しません。VirtualRowCount で行数を設定し、OnGetValue が描画される各値を返すため、100 万行でも 50 行と同じ程度の負荷で済みます。 | ヘルプ |
| 機能 | 詳細 | Community | ヘルプ |
|---|---|---|---|
| 並べ替え | SortOrder と SortIndex で複数の列を基準に並べ替えられ、Ctrl を押しながらクリックすると列を追加できます。並べ替えは安定しています。 | ヘルプ | |
| フィルタ | FilterText は、表示中のいずれかの列にテキストを含む行を残し、OnFilterRow でカスタムルールを追加できます。 | ヘルプ | |
| 選択とキーボード | SelectionMode による行またはセルの選択、キーボード操作に対応し、Ctrl+C でタブ区切りのテキストとしてコピーできます。選択状態はキーに追従します。 | ヘルプ | |
| 列のサイズ変更 | ユーザーはヘッダーの端をドラッグして列の幅を変更できますが、MinWidth を下回ることはなく、OnColumnResized で通知されます。 | ヘルプ | |
| 列の固定 | FrozenColumns は、残りの列がスクロールしても先頭の表示列をその位置に保ち、ヘッダー、フッター、グループ集計もそれに追従します。 | ヘルプ | |
| 条件付き書式 | 書式ルールにより、値が条件に一致したときにセルまたは行全体に色を付けられます。半透明の色を使うため、背景の上にセルがうっすらと色づきます。 | ヘルプ | |
| 右から左 (アラビア語とヘブライ語) | 列は右から並び、固定列は右端に置かれます。スクロールバー、ツリーとグループのインデント、シェブロン、ヘッダーアイコン、フッター、インプレースエディターはミラー化されます。数字と日付は左から右の文字列のままです。SaveToXLSX (Registered) は、TsgcGridXLSXWriter.RightToLeft 経由でも右から左のシートを書き出します。 | ヘルプ | |
| 列フィルター | 各ヘッダーのファネル（ShowFilterButtons）は、その列の重複しない値とその件数、検索ボックス、And または Or で結んだ型付きの条件を最大 2 つ備えたポップアップを開きます。 | ヘルプ | |
| フィルター行 | ShowFilterRow はヘッダーの下に、入力しながら各列をフィルターする行を追加し、列ごとの演算子は FilterRowOperator で指定します。 | ヘルプ | |
| 検索パネル | Ctrl+F または ShowFindPanel で、すべてのセルのテキストを強調表示します。F3 と Shift+F3 で一致箇所の間を移動し、FindOnlyMatches はそれ以外の行を隠します。 | ヘルプ | |
| 列チューザーとヘッダーメニュー | ヘッダーを右クリックすると、並べ替え、グループ化、幅の調整、フィルター、列チューザーの表示ができます。列チューザーは、列ごとにチェックボックスを持つポップアップです。ShowColumnChooser でコードから開けます。 | ヘルプ | |
| 列の並べ替え | ユーザーはヘッダーをドラッグして列を移動します。列は固定列の同じ側とバンド内にとどまり、OnColumnMoved が移動を通知します。 | ヘルプ | |
| 最適幅 | ヘッダーの境界のダブルクリック、または BestFitColumn と BestFitColumns で、見出しと最大 1,000 行のサンプルに合わせて幅を調整します。 | ヘルプ | |
| レイアウトの保存 | SaveLayoutToString、SaveLayoutToStream、SaveLayoutToFile は、列の順序、幅、表示状態、並べ替え、グループ化、列フィルター、バンドをバージョン付きの JSON として保存し、Load メソッドがそれを復元します。 | ヘルプ | |
| 複数選択 | gsmMultiRow は任意の行の集合を、gsmCellRange はセル範囲を、Ctrl、Shift、Ctrl+A で選択します。選択は行キーで保持され、Ctrl+C でタブ区切りのテキストとしてコピーされます。 | ヘルプ |
| 機能 | 詳細 | Community | ヘルプ |
|---|---|---|---|
| グループ化 | GroupBy で、またはヘッダーをグループパネルにドラッグして、1 つ以上の列でグループ化できます。グループ行は入れ子にでき、折りたたみにも対応します。 | ヘルプ | |
| 集計 | SummaryType で合計、件数、平均、最小、最大を、すべてのグループ行とフッターに表示でき、SummaryFormat で書式を指定できます。 | ヘルプ | |
| ツリー行 | キー列と親列（Tree.KeyField、Tree.ParentField）から階層を作成し、展開状態はキーごとに保持されます。 | 登録版 | ヘルプ |
| マスター詳細 | 展開した各親行の下に、関連する行の詳細バンドを表示します。データは TsgcGridDataStore、グリッド、または OnGetDetailData から取得します。 | 登録版 | ヘルプ |
| 機能 | 詳細 | Community | ヘルプ |
|---|---|---|---|
| その場での編集 | テキストエディターまたは選択リスト付きコンボボックスでセルを編集でき、OnValidate、OnEditError、OnEdited イベントを利用できます。 | 登録版 | ヘルプ |
| DataSet のバインド | TsgcGridSource_DataSet は、任意の TDataSet からグリッドを作成し、AutoColumns で列を生成し、LiveUpdates を使うと、Append、Edit、Delete のすべてに追従します。.NET では、同じソースが DataTable を読み取ります。 | ヘルプ | |
| ItemsSource と MVVM のバインド (.NET) | TsgcWpfGrid と TsgcAvaloniaGrid は、任意の IEnumerable である ItemsSource の項目を表示し、AutoGenerateColumns、KeyMember、双方向の SelectedItem を備えています。WPF では ICollectionView の並べ替え、フィルター、グループ化が適用され、IsSynchronizedWithCurrentItem はそのカレント項目に追従します。TsgcWinFormsGrid は DataGridView と同じように DataSource と DataMember をバインドします。ItemsWriteBack を使うと、編集、挿入、削除が項目に書き戻されます。 | ~Community 版はバインドされた項目を表示し、追従します。ItemsWriteBack は登録版です。 | ヘルプ |
| XAML とデザイナーでの列 (.NET) | グリッド内の TsgcWpfGridColumn 要素と TsgcAvaloniaGridColumn 要素が列を宣言し、FieldName (Customer.Country のようなドット区切りのパス)、Caption、DataType、DisplayFormat を指定できます。WinForms では、.NET Framework と .NET 8 以降の Visual Studio デザイナーで、スマートタグとコレクションエディターを使って Columns を編集でき、空のグリッドはデザイナーと WPF、Avalonia のプレビューアーにサンプル行を表示します。 | ヘルプ | |
| JSON と CSV | sgcGrid_IO は、文字列、ストリーム、ファイルから、行を JSON または CSV（RFC 4180）として読み込み、保存します。Linux64 でも利用できます。 | ヘルプ | |
| Excel エクスポート | SaveToXLSX は、列幅、数値書式、ウィンドウ枠の固定、グループまたはツリーのアウトライン、SUBTOTAL 数式を含む Excel ブックを書き出します。 | 登録版 | ヘルプ |
| Excel モード | ExcelMode を使うと、グリッドは軽量な表計算ソフトのように動作します。Ctrl+C でコピーできる範囲選択、連続データを延長して数式の参照をずらすフィルハンドル、A1 参照と SUM、AVERAGE、MIN、MAX、COUNT、IF、ROUND、ABS を使える数式に対応します。LoadFromXLSX は、外部ライブラリなしで Excel ブックのシートを開きます。 | 登録版 | ヘルプ |
| DataSet 編集 | WriteBack をオンにすると、TsgcGridSource_DataSet はグリッドでの変更を各レコードにポストし、SyncCursor は現在のレコードとアクティブな行を連動させ、AllowInsert と AllowDelete はレコードを追加、削除します。ルックアップフィールドは選択リストとして編集されます。 | 登録版 | ヘルプ |
| クリップボードからの貼り付け | Ctrl+V は、Excel からのタブ区切りのテキストをセル範囲に貼り付けます。すべての値は、何かを書き込む前に変換と検証が行われ、貼り付け全体が 1 回の元に戻す操作になります。 | 登録版 | ヘルプ |
| 元に戻す / やり直し | Ctrl+Z と Ctrl+Y は、セルの編集と貼り付けを行キー単位で、最大 UndoLimit ステップまで元に戻し、やり直します。 | 登録版 | ヘルプ |
| セルエディター | EditorKind は、日付、時刻、日付と時刻のピッカー、矢印付きの数値ボックス、色ピッカー、sgcEditors のトークンエディターから選び、OnCreateEditor は好きなコントロールをセルに置きます。 | 登録版 | ヘルプ |
| 印刷と印刷プレビュー | Print と ShowPrintPreview は、フィルタ、並べ替え、グループ化を適用したグリッドの表示どおりに全行を印刷し、すべてのページにバンドと列ヘッダーを繰り返し、1 ページには完全な行だけを載せます。PrintSettings は、用紙、向き、余白、拡大縮小、ヘッダーとフッターを一度設定すれば、プリンター、プレビュー、PDF のすべてに使われます。すべてのエディションで、VCL、FireMonkey、WinForms、WPF、Avalonia に対応します (FireMonkey の印刷は Windows と macOS で動作します)。 | ヘルプ | |
| アクセシブルな PDF エクスポート、PDF/UA と PDF/A (sgcPDF 使用) | ExportToPDF は、埋め込みフォントと検索可能なテキストを持つベクターページを書き出し、各ページはヘッダーセルを持つ本物の表なのでスクリーンリーダーで読み上げられます。ファイルは既定でタグ付きの PDF/UA ドキュメントで、PDFALevel で PDF/A-2a または PDF/A-3a を追加できます。sgcUIPDF ブリッジと、ライセンスされた sgcPDF が必要です (.NET では esegece.sgcUICore.sgcPDF)。 | 登録版 | ヘルプ |
| 機能 | 詳細 | Community | ヘルプ |
|---|---|---|---|
| テーマ | すべての sgcUI 製品で共通のライトテーマとダークテーマを利用できます。Theme、AccentColor、行の高さと密度の設定があります。 | ヘルプ | |
| ヘッドレスレンダリング | SaveToPNG と SaveToSVG は現在のビューを書き出し、TsgcGridRenderer は単独の TsgcGridData を PNG または SVG として描画します。Linux64 でも利用できます。 | ヘルプ | |
| グリッドからのチャート | sgcCharts の TsgcChartDataSource_Table は、グリッドの行をプロットし、間にコードを挟まずに並べ替えとフィルターに追従します。 | ヘルプ | |
| バンド | 列のグループの上に置く見出しで、段数は自由です。Bands が見出しを保持し、Column.Band が列をいずれかのバンドの下に置きます。 | ヘルプ | |
| セルタイプ | CellKind は、セルをイメージリストの画像、進捗バー、折れ線、エリア、棒のスパークラインとして描画しますが、セルは元の値を保持します。 | ヘルプ | |
| アクセシビリティ | 列ヘッダー、行、セルを持つ表として UI Automation に公開され、フォーカスされたセル、選択、並べ替え、フィルタ、グループ化、ツリー行も公開されます。これはスクリーンリーダーの Narrator や NVDA などが使う API です。フィルタ、グループ化、列の移動にはキーボードの代替手段があり (列幅の変更にはマウスが必要です)、フォーカスリングは常に表示され、Windows のハイコントラストに従います。VCL (Delphi 7 から 13)、Windows の FireMonkey、WinForms、WPF、Avalonia で既定で有効です。 | ヘルプ |
| 機能 | 詳細 | Community | ヘルプ |
|---|---|---|---|
| グリッドに質問 | TsgcGridAI は、自然言語の質問を、フィルター、並べ替え、行のハイライトに変換します。プロバイダーがなければ、ローカルのルールベースのパーサーが、ネットワークも API キーも使わずに回答します。プロバイダーがあれば任意の LLM が回答し、呼び出しが失敗した場合や回答の検証に通らない場合は、ルールベースのパーサーが引き継ぎます。 | ヘルプ | |
| AI クエリバー（VCL と FireMonkey） | TsgcVCLAIQueryBar と TsgcFMXAIQueryBar、FireMonkey は Windows、macOS、iOS、Android 対応です。質問を入力して Enter を押すと、適用された内容を確認でき、実行中の質問のキャンセルや直前の回答の元に戻す操作もできます。最近の質問と候補も表示されます。キーボード、スクリーンリーダー、ハイコントラスト、右から左のレイアウトに対応します。 | ヘルプ | |
| AI クエリバー（WinForms、WPF、Avalonia） | TsgcWinFormsAIQueryBar、TsgcWpfAIQueryBar、TsgcAvaloniaAIQueryBar は、.NET で同じ操作を提供し、ホストのライトテーマまたはダークテーマに従います。 | ヘルプ | |
| 任意の LLM | TsgcUIAIEventProvider は、OnRequest イベントで各リクエストを独自のコードに渡すため、どの AI サービス、モデル、オンプレミスのサーバーでも回答できます。.NET では RequestAsync が非同期ハンドラーを受け取ります。 | ヘルプ | |
| sgcWebSockets AI プロバイダー | sgcUICoreWS ブリッジの TsgcUIAIChatProvider は、sgcWebSockets の TsgcAIChat コンポーネントをすべてのプラットフォームで使います。.NET では esegece.sgcUICore.sgcWebSockets パッケージです。登録済みの sgcWebSockets が必要です。 | 登録版 | ヘルプ |
| プライバシー | 送信されるのは質問とフィールドカタログだけです。名前、キャプション、型、既定では列ごとに最大 3 つのサンプル値（MaxSampleValues、SendSampleValues）で、行は送信されません。OnBeforeAsk で各リクエストを編集または取り消せます。 | ヘルプ |
| 機能 | sgcGrid | 標準の Delphi コントロール |
|---|---|---|
| Synchronize なしで、ワーカースレッドからキー指定で行を更新 | — | |
| 変更されたセルが点滅してフェードアウト | — | |
| セルまたは行全体への書式ルール | — | |
| グループパネル、グループ集計とフッター集計によるグループ化 | — | |
| ツリー行とマスター詳細バンド | — | |
| アウトラインと数式を含む Excel ブックのエクスポート | — | |
| ヘッドレスの PNG と SVG のレンダリング（Linux64 でも利用可能） | — | |
| Excel 風の列フィルターポップアップ、フィルター行、検索パネル | — | |
| 列チューザー、ヘッダーメニュー、JSON として保存するレイアウト | — | |
| 列のグループの上のバンド見出し | — | |
| 独自の描画コードなしで使える進捗バー、スパークライン、画像のセル | — | |
| Excel からのセル範囲の貼り付けと、元に戻す、やり直し | — |
ヘルプに記載された機能のみを比較しています。性能に関する主張は含みません。
.NET 版のグリッドは、同じクラス名を持つ C# 版で、WinForms、WPF、Avalonia に対応します。まず無料の Community パッケージで始め、すべての機能が必要になったら登録版パッケージに移行してください。
| パッケージ | エディション | 内容 |
|---|---|---|
esegece.sgcGrid.Community | Community（無料） | コアライブラリ |
esegece.sgcGrid | 登録版 | コアライブラリ |
esegece.sgcGrid.WinForms | 登録版 | Windows Forms コントロール |
esegece.sgcGrid.Wpf | 登録版 | WPF コントロール |
esegece.sgcGrid.Avalonia | 登録版 | Avalonia コントロール |
esegece.sgcGrid.Rendering | 登録版 | ヘッドレスレンダリング |
esegece.sgcGrid.sgcWebSockets | 登録版のみ | sgcWebSockets ブリッジ |
esegece.sgcUICore.sgcWebSockets | 登録版のみ | sgcWebSockets AI プロバイダー（TsgcUIAIChatProvider） |
esegece.sgcGrid.sgcHTML | 登録版のみ | sgcHTML ブリッジ |
sgcGrid のすべての機能は sgcUI ヘルプで解説されており、開発環境ごとに 1 つのビルドを用意しています。
sgcUI ヘルプ全体を PDF ファイルにまとめたもので、オフラインでの閲覧や印刷に便利です。
Delphi (PDF) →