AxHost クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ActiveX コントロールをラップし、それらを完全に機能するWindows フォーム コントロールとして公開します。
public ref class AxHost abstract : System::Windows::Forms::Control, System::ComponentModel::ICustomTypeDescriptor, System::ComponentModel::ISupportInitializepublic abstract class AxHost : System.Windows.Forms.Control, System.ComponentModel.ICustomTypeDescriptor, System.ComponentModel.ISupportInitialize[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class AxHost : System.Windows.Forms.Control, System.ComponentModel.ICustomTypeDescriptor, System.ComponentModel.ISupportInitializetype AxHost = class
inherit Control
interface ISupportInitialize
interface ICustomTypeDescriptor[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type AxHost = class
inherit Control
interface ISupportInitialize
interface ICustomTypeDescriptorPublic MustInherit Class AxHost
Inherits Control
Implements ICustomTypeDescriptor, ISupportInitialize- 継承
- 属性
- 実装
例
次のコード例では、Microsoft Masked Edit ActiveX コントロールをラップする SetAboutBoxDelegate 派生クラスのコンストラクターと AttachInterfaces メソッドと AxHost メソッドをオーバーライドします。 このコードでは、 スイッチを使用して /source ファイルで AxImp.exe ツールを実行して、ソース コードを生成している必要があります。 このコードは、AxImp.exe ツールによる唯一の言語出力であるため、C# 構文でのみ表示されます。
public AxMaskEdBox()
:
base("c932ba85-4374-101b-a56c-00aa003668dc") // The ActiveX control's class identifier.
{
// Make the AboutBox method the about box delegate.
this.SetAboutBoxDelegate(new AboutBoxDelegate(AboutBox));
}
public virtual void AboutBox()
{
// If the instance of the ActiveX control is null when the AboutBox method
// is called, raise an InvalidActiveXStateException exception.
if ((this.ocx == null))
{
throw new System.Windows.Forms.AxHost.InvalidActiveXStateException(
"AboutBox", System.Windows.Forms.AxHost.ActiveXInvokeKind.MethodInvoke);
}
// Show the about box if the ActiveX control has one.
if (this.HasAboutBox)
{
this.ocx.AboutBox();
}
}
protected override void AttachInterfaces()
{
try
{
// Attach the IMSMask interface to the ActiveX control.
this.ocx = ((MSMask.IMSMask)(this.GetOcx()));
}
catch (System.Exception ex)
{
System.Console.WriteLine(ex.Message);
}
}
注釈
通常、 AxHost クラスは直接使用しません。 Aximp.exe (Windows フォーム ActiveX Control Importer) を使用して、AxHost を拡張するラッパーを生成できます。
ActiveX コントロール インポーターは、 AxHost クラスから派生したクラスを生成し、アプリケーションへの参照として追加できるライブラリ ファイル (DLL) にコンパイルします。 または、ActiveX コントロール インポーターで /source スイッチを使用し、 AxHost 派生クラスに対して C# ファイルを生成することもできます。 その後、コードを変更し、ライブラリ ファイルに再コンパイルできます。
Note
ActiveX コントロールのメンバーの名前が .NET Framework で定義されている名前と一致する場合、ActiveX コントロール インポーターは、AxHost 派生クラスを作成するときにメンバー名の前に "Ctl" を付けます。 たとえば、ActiveX コントロールに "Layout" という名前のメンバーがある場合、AxHost イベントが .NET Framework 内で定義されているため、Layout 派生クラスでは "CtlLayout" という名前に変更されます。
AxHost クラスの一般的なプロパティのほとんどは有効であり、基になる ActiveX コントロールがこれらのプロパティを公開する場合にのみ使用されます。 一般的なプロパティの例としては、 BackColor、 Cursor、 Font、 Textがあります。
Note
Visual StudioをWindows フォーム設計環境として使用している場合は、ActiveX コントロールをツールボックスに追加することで、ActiveX コントロールをアプリケーションで使用できるようにします。 これを行うには、 ツールボックスを右クリックし、[ ツールボックスのカスタマイズ] を選択し、ActiveX コントロールの .ocx ファイルを参照します。 詳細については、「
コンストラクター
| 名前 | 説明 |
|---|---|
| AxHost(String, Int32) |
AxHost クラスの新しいインスタンスを初期化し、指定した CLSID で示される ActiveX コントロールをラップし、指定した |
| AxHost(String) |
指定した CLSID で示される ActiveX コントロールをラップして、 AxHost クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AccessibilityObject |
コントロールに割り当てられた AccessibleObject を取得します。 (継承元 Control) |
| AccessibleDefaultActionDescription |
アクセシビリティ クライアント アプリケーションで使用するコントロールの既定のアクションの説明を取得または設定します。 (継承元 Control) |
| AccessibleDescription |
アクセシビリティ クライアント アプリケーションで使用されるコントロールの説明を取得または設定します。 (継承元 Control) |
| AccessibleName |
アクセシビリティ クライアント アプリケーションで使用されるコントロールの名前を取得または設定します。 (継承元 Control) |
| AccessibleRole |
コントロールのアクセス可能なロールを取得または設定します。 (継承元 Control) |
| AllowDrop |
ユーザーがドラッグしたデータをコントロールが受け入れられるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Anchor |
コントロールがバインドされるコンテナーの端を取得または設定し、コントロールのサイズを親と共に変更する方法を決定します。 (継承元 Control) |
| AutoScrollOffset |
ScrollControlIntoView(Control)でこのコントロールをスクロールする場所を取得または設定します。 (継承元 Control) |
| AutoSize |
このプロパティは、このクラスには関係ありません。 (継承元 Control) |
| BackColor |
このメンバーは、このコントロールにとって意味がありません。 |
| BackgroundImage |
このプロパティは、このクラスには関係ありません。 |
| BackgroundImageLayout |
このプロパティは、このクラスには関係ありません。 |
| BindingContext |
コントロールの BindingContext を取得または設定します。 (継承元 Control) |
| Bottom |
コントロールの下端とコンテナーのクライアント領域の上端との間の距離をピクセル単位で取得します。 (継承元 Control) |
| Bounds |
親コントロールに対する非クライアント要素を含むコントロールのサイズと位置をピクセル単位で取得または設定します。 (継承元 Control) |
| CanEnableIme |
IME サポートを有効にするために、 ImeMode プロパティをアクティブな値に設定できるかどうかを示す値を取得します。 (継承元 Control) |
| CanFocus |
コントロールがフォーカスを受け取ることができるかどうかを示す値を取得します。 (継承元 Control) |
| CanRaiseEvents |
コントロールでイベントを発生できるかどうかを判断します。 (継承元 Control) |
| CanSelect |
コントロールを選択できるかどうかを示す値を取得します。 (継承元 Control) |
| Capture |
コントロールがマウスをキャプチャしたかどうかを示す値を取得または設定します。 (継承元 Control) |
| CausesValidation |
コントロールがフォーカスを受け取ったときに検証を必要とするコントロールに対して検証を実行するかどうかを示す値を取得または設定します。 (継承元 Control) |
| ClientRectangle |
コントロールのクライアント領域を表す四角形を取得します。 (継承元 Control) |
| ClientSize |
コントロールのクライアント領域の高さと幅を取得または設定します。 (継承元 Control) |
| CompanyName |
コントロールを含むアプリケーションの会社または作成者の名前を取得します。 (継承元 Control) |
| Container |
IContainerを含むComponentを取得します。 (継承元 Component) |
| ContainingControl |
ActiveX コントロールを含むコントロールを取得または設定します。 |
| ContainsFocus |
コントロールまたはその子コントロールの 1 つが現在入力フォーカスを持っているかどうかを示す値を取得します。 (継承元 Control) |
| ContextMenu |
このプロパティは、このクラスには関係ありません。 |
| ContextMenu |
古い.
コントロールに関連付けられているショートカット メニューを取得または設定します。 (継承元 Control) |
| ContextMenuStrip |
このコントロールに関連付けられている ContextMenuStrip を取得または設定します。 (継承元 Control) |
| Controls |
コントロール内に含まれるコントロールのコレクションを取得します。 (継承元 Control) |
| Created |
コントロールが作成されたかどうかを示す値を取得します。 (継承元 Control) |
| CreateParams |
コントロール ハンドルの作成時に必要な作成パラメーターを取得します。 |
| Cursor |
このプロパティは、このクラスには関係ありません。 |
| DataBindings |
コントロールのデータ バインディングを取得します。 (継承元 Control) |
| DataContext |
データ バインディングの目的でデータ コンテキストを取得または設定します。 これはアンビエント プロパティです。 (継承元 Control) |
| DefaultCursor |
コントロールの既定のカーソルを取得または設定します。 (継承元 Control) |
| DefaultImeMode |
コントロールでサポートされている既定の入力メソッド エディター (IME) モードを取得します。 (継承元 Control) |
| DefaultMargin |
コントロール間で既定で指定されているスペースをピクセル単位で取得します。 (継承元 Control) |
| DefaultMaximumSize |
コントロールの既定の最大サイズとして指定されている長さと高さをピクセル単位で取得します。 (継承元 Control) |
| DefaultMinimumSize |
コントロールの既定の最小サイズとして指定されている長さと高さをピクセル単位で取得します。 (継承元 Control) |
| DefaultPadding |
コントロールの内容の既定の内部間隔 (ピクセル単位) を取得します。 (継承元 Control) |
| DefaultSize |
コントロールの既定のサイズを取得します。 |
| DesignMode |
Componentが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component) |
| DeviceDpi |
コントロールが現在表示されているディスプレイ デバイスの DPI 値を取得します。 (継承元 Control) |
| DisplayRectangle |
コントロールの表示領域を表す四角形を取得します。 (継承元 Control) |
| Disposing |
基底 Control クラスが破棄中かどうかを示す値を取得します。 (継承元 Control) |
| Dock |
親コントロールにドッキングされるコントロールの境界線を取得または設定し、コントロールのサイズを親コントロールと共に変更する方法を決定します。 (継承元 Control) |
| DoubleBuffered |
ちらつきを減らすか防止するために、このコントロールがセカンダリ バッファーを使用してそのサーフェスを再描画する必要があるかどうかを示す値を取得または設定します。 (継承元 Control) |
| EditMode |
ホストされているコントロールが編集モードであるかどうかを示す値を返します。 |
| Enabled |
このプロパティは、このクラスには関係ありません。 |
| Events |
この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component) |
| Focused |
コントロールに入力フォーカスがあるかどうかを示す値を取得します。 (継承元 Control) |
| Font |
このプロパティは、このクラスには関係ありません。 |
| FontHeight |
コントロールのフォントの高さを取得または設定します。 (継承元 Control) |
| ForeColor |
このプロパティは、このクラスには関係ありません。 |
| Handle |
コントロールがバインドされているウィンドウ ハンドルを取得します。 (継承元 Control) |
| HasAboutBox |
ActiveX コントロールに [バージョン情報 ] ダイアログ ボックスがあるかどうかを示す値を取得します。 |
| HasChildren |
コントロールに 1 つ以上の子コントロールが含まれているかどうかを示す値を取得します。 (継承元 Control) |
| Height |
コントロールの高さを取得または設定します。 (継承元 Control) |
| ImeMode |
このプロパティは、このクラスには関係ありません。 |
| ImeMode |
コントロールの入力メソッド エディター (IME) モードを取得または設定します。 (継承元 Control) |
| ImeModeBase |
コントロールの IME モードを取得または設定します。 (継承元 Control) |
| InvokeRequired |
呼び出し元がコントロールを作成したスレッドとは異なるスレッド上にあるため、呼び出し元がコントロールへのメソッド呼び出しを行うときに呼び出し元が呼び出しメソッドを呼び出す必要があるかどうかを示す値を取得します。 (継承元 Control) |
| IsAccessible |
コントロールがアクセシビリティ アプリケーションに表示されるかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsAncestorSiteInDesignMode |
このコントロールのいずれかの先祖がサイトに存在し、そのサイトが DesignMode 内にあるかどうかを示します。 このプロパティは読み取り専用です。 (継承元 Control) |
| IsDisposed |
コントロールが破棄されたかどうかを示す値を取得します。 (継承元 Control) |
| IsHandleCreated |
コントロールにハンドルが関連付けられているかどうかを示す値を取得します。 (継承元 Control) |
| IsMirrored |
コントロールがミラー化されているかどうかを示す値を取得します。 (継承元 Control) |
| LayoutEngine |
コントロールのレイアウト エンジンのキャッシュされたインスタンスを取得します。 (継承元 Control) |
| Left |
コントロールの左端からコンテナーのクライアント領域の左端までの距離をピクセル単位で取得または設定します。 (継承元 Control) |
| Location |
コンテナーの左上隅を基準としたコントロールの左上隅の座標を取得または設定します。 (継承元 Control) |
| Margin |
コントロール間のスペースを取得または設定します。 (継承元 Control) |
| MaximumSize |
GetPreferredSize(Size)が指定できる上限であるサイズを取得または設定します。 (継承元 Control) |
| MinimumSize |
GetPreferredSize(Size)が指定できる下限のサイズを取得または設定します。 (継承元 Control) |
| Name |
コントロールの名前を取得または設定します。 (継承元 Control) |
| OcxState |
ActiveX コントロールの永続化された状態を取得または設定します。 |
| Padding |
コントロール内のパディングを取得または設定します。 (継承元 Control) |
| Parent |
コントロールの親コンテナーを取得または設定します。 (継承元 Control) |
| PreferredSize |
コントロールが収まる四角形領域のサイズを取得します。 (継承元 Control) |
| ProductName |
コントロールを含むアセンブリの製品名を取得します。 (継承元 Control) |
| ProductVersion |
コントロールを含むアセンブリのバージョンを取得します。 (継承元 Control) |
| RecreatingHandle |
コントロールがハンドルを現在再作成しているかどうかを示す値を取得します。 (継承元 Control) |
| Region |
コントロールに関連付けられているウィンドウ領域を取得または設定します。 (継承元 Control) |
| RenderRightToLeft |
古い.
古い.
このプロパティは廃止されました。 (継承元 Control) |
| ResizeRedraw |
サイズ変更時にコントロール自体を再描画するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Right |
コントロールの右端とコンテナーのクライアント領域の左端との間の距離 (ピクセル単位) を取得します。 (継承元 Control) |
| RightToLeft |
このプロパティは、このクラスには関係ありません。 |
| ScaleChildren |
子コントロールのスケーリングを決定する値を取得します。 (継承元 Control) |
| ShowFocusCues |
コントロールにフォーカスの四角形を表示するかどうかを示す値を取得します。 (継承元 Control) |
| ShowKeyboardCues |
キーボード アクセラレータの表示と非表示を切り替えるために、ユーザー インターフェイスが適切な状態であるかどうかを示す値を取得します。 (継承元 Control) |
| Site |
コントロールのサイトを取得または設定します。 |
| Size |
コントロールの高さと幅を取得または設定します。 (継承元 Control) |
| TabIndex |
コンテナー内のコントロールのタブ オーダーを取得または設定します。 (継承元 Control) |
| TabStop |
Tab キーを使用してユーザーがこのコントロールにフォーカスを与えることができるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Tag |
コントロールに関するデータを含むオブジェクトを取得または設定します。 (継承元 Control) |
| Text |
このプロパティは、このクラスには関係ありません。 |
| Top |
コントロールの上端とそのコンテナーのクライアント領域の上端との間の距離をピクセル単位で取得または設定します。 (継承元 Control) |
| TopLevelControl |
別のWindows フォーム コントロールによって親にされていない親コントロールを取得します。 通常、これはコントロールが含まれている最も外側の Form です。 (継承元 Control) |
| UseWaitCursor |
現在のコントロールとすべての子コントロールに対して待機カーソルを使用するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Visible |
コントロールとそのすべての子コントロールを表示するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Width |
コントロールの幅を取得または設定します。 (継承元 Control) |
| WindowTarget |
このプロパティは、このクラスには関係ありません。 (継承元 Control) |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| AutoSizeChanged |
このイベントは、このクラスには関係ありません。 (継承元 Control) |
| BackColorChanged |
BackColorChanged イベントは、AxHost クラスではサポートされていません。 |
| BackgroundImageChanged |
BackgroundImageChanged イベントは、AxHost クラスではサポートされていません。 |
| BackgroundImageLayoutChanged |
このイベントは、このクラスには関係ありません。 |
| BindingContextChanged |
BindingContextChanged イベントは、AxHost クラスではサポートされていません。 |
| CausesValidationChanged |
CausesValidation プロパティの値が変化したときに発生します。 (継承元 Control) |
| ChangeUICues |
ChangeUICues イベントは、AxHost クラスではサポートされていません。 |
| Click | |
| ClientSizeChanged |
ClientSize プロパティの値が変化したときに発生します。 (継承元 Control) |
| ContextMenuChanged |
ContextMenuChanged イベントは、AxHost クラスではサポートされていません。 |
| ContextMenuChanged |
古い.
ContextMenu プロパティの値が変化したときに発生します。 (継承元 Control) |
| ContextMenuStripChanged |
ContextMenuStrip プロパティの値が変化したときに発生します。 (継承元 Control) |
| ControlAdded |
新しいコントロールが Control.ControlCollectionに追加されたときに発生します。 (継承元 Control) |
| ControlRemoved |
コントロールが Control.ControlCollectionから削除されたときに発生します。 (継承元 Control) |
| CursorChanged |
CursorChanged イベントは、AxHost クラスではサポートされていません。 |
| DataContextChanged |
DataContext プロパティの値が変化したときに発生します。 (継承元 Control) |
| Disposed |
コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component) |
| DockChanged |
Dock プロパティの値が変化したときに発生します。 (継承元 Control) |
| DoubleClick |
DoubleClick イベントは、AxHost クラスではサポートされていません。 |
| DpiChangedAfterParent |
親コントロールまたはフォームの DPI が変更された後に、コントロールの DPI 設定がプログラムによって変更されたときに発生します。 (継承元 Control) |
| DpiChangedBeforeParent |
親コントロールまたはフォームの DPI 変更イベントが発生する前に、コントロールの DPI 設定がプログラムによって変更されたときに発生します。 (継承元 Control) |
| DragDrop | |
| DragEnter | |
| DragLeave | |
| DragOver | |
| EnabledChanged |
EnabledChanged イベントは、AxHost クラスではサポートされていません。 |
| Enter |
コントロールが入力されたときに発生します。 (継承元 Control) |
| FontChanged |
FontChanged イベントは、AxHost クラスではサポートされていません。 |
| ForeColorChanged |
ForeColorChanged イベントは、AxHost クラスではサポートされていません。 |
| GiveFeedback |
GiveFeedback イベントは、AxHost クラスではサポートされていません。 |
| GotFocus |
コントロールがフォーカスを受け取ったときに発生します。 (継承元 Control) |
| HandleCreated |
コントロールのハンドルが作成されたときに発生します。 (継承元 Control) |
| HandleDestroyed |
コントロールのハンドルが破棄処理中に発生します。 (継承元 Control) |
| HelpRequested |
HelpRequested イベントは、AxHost クラスではサポートされていません。 |
| ImeModeChanged |
ImeModeChanged イベントは、AxHost クラスではサポートされていません。 |
| Invalidated |
コントロールの表示に再描画が必要な場合に発生します。 (継承元 Control) |
| KeyDown | |
| KeyPress | |
| KeyUp | |
| Layout | |
| Leave |
入力フォーカスがコントロールから離れると発生します。 (継承元 Control) |
| LocationChanged |
Location プロパティ値が変更されたときに発生します。 (継承元 Control) |
| LostFocus |
コントロールがフォーカスを失ったときに発生します。 (継承元 Control) |
| MarginChanged |
コントロールの余白が変更されたときに発生します。 (継承元 Control) |
| MouseCaptureChanged |
コントロールがマウス キャプチャを失ったときに発生します。 (継承元 Control) |
| MouseClick |
このイベントは、このクラスには関係ありません。 |
| MouseDoubleClick |
このイベントは、このクラスには関係ありません。 |
| MouseDown | |
| MouseEnter |
MouseEnter イベントは、AxHost クラスではサポートされていません。 |
| MouseHover |
MouseHover イベントは、AxHost クラスではサポートされていません。 |
| MouseLeave |
MouseLeave イベントは、AxHost クラスではサポートされていません。 |
| MouseMove | |
| MouseUp | |
| MouseWheel |
MouseWheel イベントは、AxHost クラスではサポートされていません。 |
| Move |
コントロールが移動されたときに発生します。 (継承元 Control) |
| PaddingChanged |
コントロールのパディングが変更されたときに発生します。 (継承元 Control) |
| Paint | |
| ParentChanged |
Parent プロパティ値が変更されたときに発生します。 (継承元 Control) |
| PreviewKeyDown |
フォーカスがこのコントロールにある間にキーが押されたときに、 KeyDown イベントの前に発生します。 (継承元 Control) |
| QueryAccessibilityHelp |
QueryAccessibilityHelp イベントは、AxHost クラスではサポートされていません。 |
| QueryContinueDrag |
QueryContinueDrag イベントは、AxHost クラスではサポートされていません。 |
| RegionChanged |
Region プロパティの値が変化したときに発生します。 (継承元 Control) |
| Resize |
コントロールのサイズが変更されたときに発生します。 (継承元 Control) |
| RightToLeftChanged |
RightToLeftChanged イベントは、AxHost クラスではサポートされていません。 |
| SizeChanged |
Size プロパティ値が変更されたときに発生します。 (継承元 Control) |
| StyleChanged |
StyleChanged イベントは、AxHost クラスではサポートされていません。 |
| SystemColorsChanged |
システムの色が変更されたときに発生します。 (継承元 Control) |
| TabIndexChanged |
TabIndex プロパティの値が変化したときに発生します。 |
| TabIndexChanged |
TabIndex プロパティ値が変更されたときに発生します。 (継承元 Control) |
| TabStopChanged |
TabStop プロパティの値が変化したときに発生します。 |
| TabStopChanged |
TabStop プロパティ値が変更されたときに発生します。 (継承元 Control) |
| TextChanged |
TextChanged イベントは、AxHost クラスではサポートされていません。 |
| Validated |
コントロールの検証が完了したときに発生します。 (継承元 Control) |
| Validating |
コントロールが検証中に発生します。 (継承元 Control) |
| VisibleChanged |
Visible プロパティ値が変更されたときに発生します。 (継承元 Control) |
