標準プロパティ
OLE では、コントロール、アンビエント、および拡張の 3 種類のプロパティすべてに対して標準の DISPID のセットを定義します。 次の表に、コントロール プロパティ、アンビエント プロパティ、および拡張プロパティの標準を示します。
| Control プロパティ | 種類 | 形容 |
|---|---|---|
| BackColor、ForeColor、FillColor、BorderColor |
OLE_COLOR |
コントロールの配色 |
| BackStyle、FillStyle、BorderStyle、BorderWidth、BorderVisible、DrawStyle、DrawWidth |
短い または長い |
コントロールの視覚的な動作を定義するビット (ソリッドまたは透明、太い罫線や細い罫線、線のスタイルなど)。 |
| フォント |
IDispatch * |
コントロールで使用されるフォント。これは、標準のフォント オブジェクトへのポインター IDispatch です。 詳細については、「標準フォント オブジェクトの」を参照してください。 |
| Caption、Text |
BSTR の |
コントロールのラベル (キャプション) またはそのテキスト コンテンツ (テキスト) を含む文字列。 キャプションは、コンテナー内のコントロールに必ずしも名前を付けできるとは限らないことに注意してください。 次の表の拡張 Name プロパティを参照してください。 |
| 有効 |
BOOL |
コントロールが有効か無効かを決定します。 無効にした場合、コントロールはグレー表示される可能性があります。 |
| 窓 |
HWND を する |
コントロールのウィンドウ ハンドル (存在する場合)。 |
| TabStop |
BOOL |
このコントロールがタブ 位置であるかどうかを判断します。 |
| Ambient プロパティ | 種類 | 形容 |
|---|---|---|
| BackColor、ForeColor |
OLE_COLOR |
既定の背景色と前景色をコントロールに提供します。 コントロールによる使用は省略可能です。 |
| フォント |
IDispatch * |
フォームの既定のフォントを定義する標準フォント オブジェクトへのポインター。 コントロールによる使用は省略可能です。 詳細については、「標準フォント オブジェクトの」を参照してください。 |
| LocaleID |
LCID を する |
コンテナーで使用される言語。 コントロールで使用することをお勧めします。 |
| UserMode |
BOOL |
コンテナーがデザイン モード (FALSE) または実行モード (TRUE) のいずれにあるかを説明します。これは、コントロールが必要に応じて使用可能な機能を変更するために使用する必要があります。 |
| UIDead |
BOOL |
コンテナーが、コントロールがユーザー入力を無視する必要があるモードにあるかどうかを説明します。 これは、UserMode に関係なく適用されます。 コンテナーは、常に UIDead をデザイン モードで TRUE 設定し、実行モード中にブレークポイントにヒットした場合などに TRUE を に設定できます。 コントロールは、このプロパティに注意する必要があります。 |
| MessageReflect |
BOOL |
コンテナーが、WM_CTLCOLOR、WM_DRAWITEM、WM_PARENTNOTIFYなどの Windows メッセージをイベントとして受信するかどうかを指定します。 |
| SupportsMnemonics |
BOOL |
コンテナーがニーモニックを処理するかどうかを記述します。 コントロールは、通常ニーモニックとして使用される文字に下線を引かないなど、この情報で必要な操作を実行できます。 |
| ShowGrabHandles、ShowHatching |
BOOL |
コントロールがインプレースアクティブの場合に、ハッチング境界またはハンドル (ハッチング境界内) を表示する必要があるかどうかを説明します。 コントロールはこれらのプロパティに従う必要があります。これにより、ユーザー インターフェイスのこれらのビットを実際に描画するユーザーを最終的に制御できます。 コントロール コンテナーは、各コントロールに依存するのではなく、独自の描画を行う場合があります。その場合、これらのアンビエントは常に FALSE されます。 |
| DisplayAsDefault |
BOOL |
コンテナーは、ボタン コントロールがより太い既定のフレームで描画する必要がある場合に、既定のボタンとしてマークされているものが含まれているサイトを通じて、このプロパティの TRUE を公開します。 |
| 拡張プロパティ | 種類 | 形容 |
|---|---|---|
| 名前 |
BSTR の |
コントロールのコンテナーの名前。 |
| 目に見える |
BOOL |
コントロールの可視性。 |
| 親 |
IDispatch * |
コントロールを含むフォームのディスパッチインターフェイス。 |
| 既定値、キャンセル |
BOOL |
このコントロールが既定またはキャンセル ボタンであるかどうかを示します。 |
これらの標準プロパティはすべて、標準の状態を示す負の DISPID 値を持ちます。
これらの DISPID のプログラムシンボルの競合を回避するために、すべてのアンビエント プロパティには、DISPID_AMBIENT_FORECOLORのようにDISPID_AMBIENT_プロパティのシンボルが指定されます。 その他のすべてのシンボルでは、通常どおりプロパティDISPID_使用されます。
一部のアンビエント プロパティとコントロール プロパティには、色が含まれます。 前の表で説明した OLE_COLOR 型は、標準 COLORREF 型、パレットへのインデックス、パレット相対インデックス、または GetSysColor 関数で使用されるシステム カラー インデックスを参照できます。 OleTranslateColor 関数は、パレットに指定された OLE_COLOR 型を COLORREF 型に変換します。