PidTagControlFlags 標準プロパティ
適用対象: Outlook 2013 | Outlook 2016
表示テーブルから構築されたダイアログ ボックスで使用されるコントロールの動作を制御するフラグのビットマスクが含まれます。
| プロパティ | 値 |
|---|---|
| 関連するプロパティ: |
PR_CONTROL_FLAGS |
| 識別子: |
0x3F00 |
| データの種類 : |
PT_LONG |
| エリア: |
MAPI 表示テーブル |
注釈
このプロパティには、次の 1 つ以上のフラグを設定できます。
DT_ACCEPT_DBCS
コントロールには、Double-Byte 文字セット (DBCS) 文字を含めることができます。 このフラグは、編集コントロールで使用されます。 これにより、複数バイト文字セットを使用できます。
DT_EDITABLE
コントロールは編集できます。コントロールに関連付けられている値を変更できます。 このフラグが設定されていない場合、コントロールは読み取り専用です。 この値は、ラベル、グループ ボックス、標準のプッシュ ボタン、複数値のドロップダウン リスト ボックス、およびリスト ボックス コントロールでは無視されます。
DT_MULTILINE
編集コントロールには複数の行を含めることができます。 つまり、コントロール内で戻り文字を入力できます。 このフラグは、編集コントロールに対してのみ有効です。
DT_PASSWORD_EDIT
編集コントロールに適用されます。 編集コントロールはパスワードのように扱われます。 値は、入力された実際の文字をエコーする代わりにアスタリスクを使用して表示されます。
DT_REQUIRED
コントロールが変更を許可する場合 (DT_EDITABLE)、 IMAPIProp::SaveChanges が呼び出される前に値が必要です。
DT_SET_IMMEDIATE
値の即時設定を有効にします。コントロールの値が変更されるとすぐに、MAPI は、そのコントロールに関連付けられているプロパティの SetProps メソッドを呼び出します。 このフラグが設定されていない場合、ダイアログ ボックスが閉じられたときに値が設定されます。
DT_SET_SELECTION
リスト ボックス内で選択を行うと、そのリスト ボックスのインデックス列がプロパティとして設定されます。 常にDT_SET_IMMEDIATEで使用されます。
このプロパティは、コントロールの DTCTL 構造体の ulCtlFlags メンバーに格納されます。 ほとんどのコントロール フラグは、ユーザー入力を許可するすべてのコントロールに適用されます。いくつかは編集コントロールにのみ適用されます。 ボタンやラベルなど、ユーザー入力を許可しないコントロールは、コントロール フラグに 0 を設定します。
フラグ値の多くは自明です。 たとえば、コントロールにDT_REQUIREDが設定されている場合、ダイアログ ボックスを閉じる前に値を含める必要があります。 サービス プロバイダーは、 IMAPIProp 実装を通じて値を指定するか、ユーザーが値を入力できます。 DT_EDITABLEは、コントロールの値を変更できることを示します。 DT_MULTILINEでは、編集コントロールの値を複数行にまたがることができます。
一部のコントロール フラグは、その意味でそれほど明白ではありません。 コントロールが DT_SET_IMMEDIATE フラグを設定すると、ユーザーが新しいコントロールに移動するとすぐに、その値に対する変更が影響を受けます。 MAPI は、コントロールのプロパティのプロパティ インターフェイスの IMAPIProp::SetProps メソッドを 1 回呼び出します。 これは既定の動作とは異なります。これは、ユーザーが [OK] ボタンを選択するか、ダイアログ ボックスを閉じるまで、コントロール値の変更を延期することです。 DT_SET_IMMEDIATE フラグは、多くの場合、表示テーブル通知と組み合わせて使用されます。
次の表に、コントロールの種類と、各型に設定できるすべてのフラグ値を示します。
| Control | このプロパティの有効な値 |
|---|---|
| ボタン |
0 にする必要があります |
| チェック ボックス |
DT_EDITABLE、DT_SET_IMMEDIATE |
| コンボ ボックス |
DT_EDITABLE、DT_REQUIRED、DT_SET_IMMEDIATE |
| ドロップダウン リスト ボックス |
DT_EDITABLE、DT_SET_IMMEDIATE |
| 編集 |
DT_ACCEPT_DBCS、DT_MULTILINE、DT_EDITABLE、DT_PASSWORD_EDIT、DT_REQUIRED、DT_SET_IMMEDIATE |
| グループ ボックス |
0 にする必要があります |
| Label |
0 にする必要があります |
| リスト ボックス |
0 にする必要があります |
| [複数値] ドロップダウン リスト ボックス |
0 にする必要があります |
| 複数値リスト ボックス |
0 にする必要があります |
| タブ付きページ |
0 にする必要があります |
| ラジオボタン |
0 にする必要があります |
関連リソース
ヘッダー ファイル
Mapidefs.h
データ型の定義を提供します。
Mapitags.h
代替名として一覧表示されるプロパティの定義が含まれます。