ドキュメントレベルの統合

www.altova.com このトピックを印刷 前のページ 1つ上のレベル 次のページ

ホーム >  プログラマーの レファレンス > ActiveX Integration >

ドキュメントレベルの統合

アプリケーションレベルの統合に比べ、 ドキュメントレベルの統合複雑ですが、 ActiveX コントロール。を使用することによりアプリケーションに StyleVision 機能を柔軟的に埋め込むことができます。 このアプローチにより、コードは StyleVision ユーザーインターフェイスの次のパーツに部分的にアクセスすることができます:

 

ドキュメントの編集ウィンドウ
プロジェクトウィンドウ
デザイン 概要ウィンドウ
スキーマ ツリー ウィンドウ
デザイン ツリー ウィンドウ
スタイル ウィンドウ
スタイルレポジトリ ウィンドウ
プロパティ ウィンドウ
メッセージウィンドウ

 

アプリケーションレベルの統合 で説明されているとおり、ActiveX アプリケーションレベルの統合のためには、 StyleVisionControl のみが必要とされる唯一のコントロールです。しかしながら、 ActiveX ドキュメントレベルの統合の場合は、 機能 StyleVision が次の ActiveX コントロールにより与えられます:

 

1.StyleVisionControl
2.StyleVisionControl ドキュメント
3.StyleVisionControl プレースホルダ

 

これらのコントロールは StyleVision のアプリケーション インストール フォルダーで使用することのできる StyleVisionControl.ocx ファイルにより与えられます。 Visual Studio を使用して ActiveX 統合を開発すると、これらのコントロールを Visual Studio ツールボックスに追加する必要があります (次を参照してください: ActiveX コントロールをツールボックスに追加する)。

 

ドキュメントレベルでの ActiveX コントロールのアプリケーションへの統合の基本のステップは、以下のとおりです:

 

1.最初に、アプリケーション内で StyleVisionControl をインスタンス化します。 StyleVisionControl ドキュメント」 StyleVisionControl プレースホルダ」 コントロールへのサポートが有効化されるために、このコントロールの統合は必須です。IntegrationLevel プロパティを I「CActiveXIntegrationOnDocumentLevel」 (または 「1」)に設定することは重要です。ユーザーに対してコントロールを非表示にするには、「Visible」プロパティを「False」に設定します。

 

メモ:ドキュメントレベルで統合する場合、未知の結果が生成される可能性があるため、 StyleVisionControl「開く」 メソッドを使用しないでください。StyleVisionControl ドキュメントStyleVisionControl プレースホルダ の対応するメソッドを代わりに使用して開いてください。

 

2. StyleVisionControl ドキュメント のインスタンスを少なくとも1つアプリケーション内に作成します。このコントロールは、アプリケーションに StyleVision のドキュメントの編集ウィンドウを与え、必要であれば、複数回インスタンス化することができます。

 

既存のファイルを開くために、メソッド 「開く」を使用します。 ドキュメントに関連した機能にアクセスするには、メソッドとプロパティ 「ドキュメント」を介してアクセスすることのできる 「パス」「保存」 を使用します。

 

メモ:コントロールは、読み取り専用モードをサポートしません。 プロパティ 「読み取り専用」 の値は無視されます。

 

3.任意で、 アプリケーションに、アプリケーションで使用することのできる(ドキュメント ウィンドウ以外の)各追加ウィンドウのために StyleVisionControl プレースホルダ コントロールを追加することができます。

 

StyleVisionControl プレースホルダ のインスタンスによりアプリケーションウィンドウに選択して StyleVision の追加ウィンドウを埋め込むことができます。 ウィンドウの種類 (例えば、 プロジェクトウィンドウ) は プロパティ 「PlaceholderWindowID」 により定義することができます。有効なウィンドウの識別子のためには、次を参照してください: StyleVisionControlPlaceholderWindow.

 

メモ:各ウィンドウ識別子のために StyleVisionControl プレースホルダ」のみを使用してください。

 

StyleVision プロジェクトウィンドウを選択するプレースホルダーコントロールのために、 追加メソッドを使用することができます。「OpenProject」 を使用して、StyleVision プロジェクトをロードすることができます。StyleVision 自動化インターフェイスからプロパティプロジェクトとメソッドを使用して、他のプロジェクトに関連したオペレーションを操作します。

 

例えば、Visual Studio を使用した C# または VB.NET 内では、 StyleVision ActiveX コントロールをドキュメントレベルで統合する基本的なアプリケーションの作成ステップは、以下にリストされるものに類似しています。必要に応じて適用は複雑になる可能性があります。しかしながら、 ActiveX ドキュメントレベルの統合のための必要条件として、下の命令を理解することは重要です。

 

1.新規の空のフォームと共に新規の Visual Studio Windows Forms プロジェクトを作成します。
2.まだ行っていない場合、ActiveX コントロールを ツールボックスに追加します (次を参照してください: ActiveX コントロールをツールボックスに追加する)。
3.ツールボックスから StyleVisionControl をドラッグして新規のフォームにドラッグします。
4.StyleVisionControl「IntegrationLevel」 プロパティを 「ICActiveXIntegrationOnDocumentLevel」 に、と 「Visible」 プロパティを 「False」 に設定します。コードから、または、「プロパティ」 ウィンドウから行うことができます。
5.StyleVisionControl ドキュメント をツールボックスからフォームにドラッグします。  このコントロールは、使用中のアプリケーションに StyleVision のメインウィンドウを与え、ドキュメントのためにサイズを調整することができます。
6.代わりに、フォームに1つまたは複数の StyleVisionControl プレースホルダ コントロールを追加することができます (アプリケーションが必要とする各追加ウィンドウの型など。 例えば、「プロジェクト」 ウィンドウなど)。このような追加プレースホルダー コントロールをメインドキュメントコントロールの下、または、左右に通常配置します。 例:

ax_control_windows

7. StyleVisionControl プレースホルダ」 コントロールの PlaceholderWindowID」 プロパティを有効な ウィンドウ識別子に設定してください。 有効な値のリストに関しては、次を参照してください: StyleVisionControlPlaceholderWindow
8. アプリケーションにコマンドを以下のように追加します (少なくとも、ドキュメントを開き、保存し、閉じる必要があります)。

 

 

StyleVision コマンドをクエリする

 

ドキュメントレベルで統合する場合は、StyleVision メニュー または ツールバーをアプリケーションで使用することはできません。 代わりに、 必要とするコマンドを取得し、状態を確認し、プログラム的に実行することができます:

 

使用することのできるすべてのコマンドを取得するには、StyleVisionControlCommandsList プロパティを使用します。
メニュー構造により整理されているコマンドを取得するには、 メイン Menu プロパティを使用します。
表示される順番に整理されているコマンドを取得するには、 Toolbars プロパティを使用します。
StyleVision にコマンドを送信するには、 Exec メソッドを使用します。
コマンドが現在有効化されているか、または、無効化されているかクエリするために、QueryStatus メソッドを使用します。

 

これにより StyleVision コマンドをアプリケーションの メニューとツールバーに柔軟的に統合することができます。

 

StyleVision のインストールは、 StyleVision 内で使用されているコマンドラベルを与えます。GIF 書式内のアイコンのために StyleVision インストールのフォルダー 「<ApplicationFolder>\Examples\ActiveX\Images」 を参照してください。 fコマンド名に対応する ファイル名は、コマンド参照 セクション内にリストされています。

 

 

一般的な注意点

 

StyleVision の振る舞いを自動化するには、 StyleVisionControlStyleVisionControl ドキュメントStyleVisionControl プレースホルダ内で説明されている プロパティ、メソッド、 とイベントを使用してください。

 

StyleVision 機能への高度なアクセスに関しては、 次の プロパティを考慮してください:

 

StyleVisionControl.Application
StyleVisionControlDocument.Document
StyleVisionControlPlaceHolder.Project

 

これらのプロパティは StyleVision 自動化インターフェイス (StyleVisionAPI)へのアクセスを提供します

 

メモ:ドキュメントを開くには、適切な ドキュメントコントロールの StyleVisionControlDocument.Open または StyleVisionControlDocument.New を使用してください。  プロジェクトを開くには、 StyleVision プロジェクトウィンドウを埋め込むプレースホルダ コントロール上のStyleVisionControlPlaceHolder.OpenProject を常に使用してください。

 

異なるプログラミング環境内で必要なコントロールをインスタント化しアクセスする方法を説明するサンプルに関しては、次を参照してください: ActiveX 統合のサンプル


(C) 2019 Altova GmbH