XMLNode コントロール
更新 : 2007 年 11 月
対象 |
|---|
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。 プロジェクトの種類
Microsoft Office のバージョン
詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。 |
XMLNode コントロールは、イベントを公開する、割り当てられた XML ノード オブジェクトであり、データに結合できます。XMLNode コントロールは、非繰り返しスキーマ要素が Microsoft Office Word 文書にマップされたときにのみ作成されます。Visual Studio Tools for Office が XML ノードを作成すると、Word オブジェクト モデルを走査しなくてもプログラムで XML ノードを直接使用できます。
XMLNode コントロールは、Word 内の要素のマッピングを削除することによってのみ削除できます。
コントロールへのデータの連結
XMLNode コントロールは、単純データ バインディングをサポートしています。XML ノードをデータ ソースにバインドするには、DataBindings プロパティを使用する必要があります。バインドされたデータセット内のデータが更新された場合は、その変更が XMLNode コントロールに反映されます。
書式設定
Microsoft.Office.Interop.Word.XMLNode オブジェクトに適用できる書式設定を Microsoft.Office.Tools.Word.XMLNode コントロールに適用できます。フォント、下線のスタイル、文字スタイルなどを設定できます。
イベント
次のイベントは XMLNode コントロールで使用できます。
イベントの比較
特定の XMLNode コントロールのコンテキスト内でユーザーがポインタを移動したときに、イベントをキャプチャすることができます。たとえば、次のように Customer という名前の XMLNode コントロールに Company という名前の子 XMLNode コントロールがあり、Company には CompanyName および CompanyRegion という名前の 2 つの子 XMLNode コントロールがあるとします。
<Customer>
<Company>
<CompanyName>
<CompanyRegion>
ポインタが Company ノードの内部に移動したときに操作ウィンドウにコントロールを表示する場合、ポインタが CompanyName と CompanyRegion のどちらの中にあっても違いはありません。両方とも Company のコンテキスト内にあるからです。この場合、Company の ContextEnter イベントにコードを書くことができます。
ほとんどの場合、ポインタが XMLNode コントロールの内部に移動すると、Select イベントと ContextEnter イベントの両方が発生します。これらのイベントの相違点を次の表に示します。
Select イベント |
ContextEnter イベント |
|---|---|
ポインタが XMLNode の内部に配置されたときに発生します。 |
ポインタが XMLNode またはその子孫ノードの内部に、ノードのコンテキスト外から配置されたときに発生します。つまり、コンテキストが変わったときにのみ発生します。 |
たとえば、ポインタを Customer の外部から CompanyName に移動すると、Customer、Company、および CompanyName で ContextEnter イベントが発生します。ポインタを CompanyName から CompanyRegion に移動した場合、ポインタは Company と Customer の 両方のコンテキスト内にまだあるので、CompanyRegion の ContextEnter イベントのみが発生します。
これと同じ違いは、ContextLeave イベントと Deselect イベントにもあります。
参照
処理手順
方法 : Word 文書に XMLNode コントロールを追加する
方法 : Visual Studio 内で Word 文書にスキーマを割り当てる
チュートリアル : ユーザー コンテキストに応じた操作ウィンドウの変更
概念
ホスト項目およびホスト コントロールのプログラム上の制限事項