DTBLDDLBX
適用対象: Outlook 2013 | Outlook 2016
表示テーブルから作成されたダイアログ ボックスで使用されるドロップダウン リスト コントロールについて説明します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapidefs.h |
typedef struct _DTBLDDLBX
{
ULONG ulFlags;
ULONG ulPRDisplayProperty;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLDDLBX, FAR *LPDTBLDDLBX;
メンバー
ulFlags
予約済み。0 にする必要があります。
ulPRDisplayProperty
PT_TSTRING型のプロパティのプロパティ タグ。 このプロパティは、 ulPRTableName メンバーによって識別されるテーブル内の列の 1 つです。 このプロパティの値が一覧に表示されます。
ulPRSetProperty
任意の型のプロパティのプロパティ タグ。 このプロパティは、 ulPRTableName メンバーによって識別されるテーブル内の列の 1 つです。 一覧のユーザーが ulPRTableName メンバーによって識別されるテーブルの行から ulPRDisplayProperty メンバーのプロパティ値を選択すると、対応する ulPRSetProperty メンバーが設定されます。
ulPRTableName
OpenProperty 呼び出しを使用して開くことができるPT_OBJECT型のテーブル プロパティのプロパティ タグ。 テーブルには、 ulPRDisplayProperty と ulPRSetProperty の 2 つの列 が必要です。 テーブルの行は、リスト内の項目に対応している必要があります。
注釈
DTBLDDLBX 構造体は、ユーザーが展開を選択するまで 1 つの項目として表示されるドロップダウン リスト コントロールを表します。
プロパティ タグによって識別される 3 つのプロパティは連携して、一覧に情報を表示し、関連するプロパティを設定します。 ulPRTableName メンバーは、IMAPIProp::OpenProperty の呼び出しを通じてアクセスされるテーブル オブジェクトです。 テーブルには、 ulPRDisplayProperty メンバーによって識別されるプロパティの 1 つの列と、 ulPRSetProperty メンバーによって識別されるプロパティの 2 つの列があります。
ulPRDisplayProperty プロパティは、リスト表示を駆動します。 ユーザーがディスプレイからいずれかの値を選択すると、MAPI は IMAPIProp::SetProps を呼び出して、 ulPRSetProperty メンバーによって識別される対応するプロパティを設定します。 つまり、選択した表示プロパティと同じ行の プロパティです。 ulPRSetProperty メンバーを PR_NULL (PidTagNull) に設定することはできません。
MAPI が IMAPIProp::GetProps の呼び出しを通じて ulPRSetProperty メンバーによって表されるプロパティを取得し、ulPRSetProperty メンバーの値を持つテーブル内の行を見つけた場合、初期値が一覧に表示されます。 最初に表示される値は、構造体の ulPRDisplayProperty メンバーのプロパティと一致する、その行の ulPRDisplayProperty 列の内容です。 ulPRDisplayProperty メンバーによって識別されるプロパティの GetProps によって返される値は、リストが最初に表示されるときに表示される初期値になります。
表示テーブルの概要については、「テーブルの 表示」を参照してください。 表示テーブルを実装する方法については、「表示テーブルの 実装」を参照してください。 プロパティの種類の詳細については、「 MAPI プロパティの種類の概要」を参照してください。