DTBLLBX
適用対象: Outlook 2013 | Outlook 2016
表示テーブルから作成されるダイアログ ボックスで使用される一覧について説明します。
プロパティ | 値 |
---|---|
ヘッダー ファイル: |
Mapidefs.h |
typedef struct _DTBLLBX
{
ULONG ulFlags;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLLBX, FAR *LPDTBLLBX
メンバー
ulFlags
リストから水平方向または垂直方向のスクロール バーを排除するために使用されるフラグのビットマスク。 次のフラグを設定できます。
MAPI_NO_HBAR
リストに水平スクロール バーは表示されません。
MAPI_NO_VBAR
リストに垂直スクロール バーは表示されません。
ulPRSetProperty
任意の型のプロパティのプロパティ タグ。 このプロパティは、 ulPRTableTable メンバーによって識別されるテーブル内の列の 1 つです。
ulPRTableName
OpenProperty 呼び出しを使用して開くことができるPT_OBJECT型のテーブル プロパティのプロパティ タグ。 テーブルに必要な列の数は、リストが 1 つの選択リストか複数の選択リストかによって異なります。 ulPRSetProperty メンバーが PR_NULL (PidTagNull) に設定されている場合、リストでは複数の選択が許可されます。
注釈
DTBLLBX 構造体は、複数の項目を表示し、ユーザーが 1 つ以上の項目を選択できるようにするために使用されるコントロールの一覧を記述します。
ulPRSetProperty メンバーと ulPRTableName メンバーは連携します。テーブルから 1 つの値を選択すると、ダイアログ ボックスが閉じられたときに ulPRSetProperty に書き戻されます。
flags 値は、水平スクロール バーと垂直スクロール バーのどちらを一覧と共に表示するかを示します。 既定では、必要に応じてスクロール バーの種類が表示されます。 サービス プロバイダーは、水平スクロール バーを抑制するようにMAPI_NO_HBARを設定し、垂直スクロール バーを抑制するためにMAPI_NO_VBARできます。
2 つのプロパティ タグ メンバーが連携して、リスト内の値を表示し、リスト内の項目が選択されたときに対応するプロパティを設定します。 MAPI は、最初に一覧を表示するときに、 IMAPIProp 実装の OpenProperty メソッドを呼び出して 、ulPRTableName メンバーで識別されたテーブルを取得します。 テーブル内の列の数は、 ulPRSetProperty メンバーの値によって異なります。 ulPRSetProperty が PR_NULL に設定されている場合、リストは、アドレス帳コンテナー、メッセージの受信者テーブル、配布リストの内容テーブルなど、受信者を含むオブジェクトに基づく複数の選択リストです。
複数選択リストのテーブルには、次の列を含める必要があります。
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ENTRYID (PidTagEntryId)
PR_INSTANCE_KEY (PidTagInstanceKey)
PR_DISPLAY_TYPE (PidTagDisplayType) と最大 5 つの他の複数値文字列プロパティを、必要な 3 つの列と共に表示することもできます。
ulPRSetProperty メンバーが PR_NULL に設定されていない場合、リストは単一の選択リストになります。 ulPRSetProperty の初期値によって、最初に選択された行が決まります。 ユーザーがいずれかの行を選択すると、 ulPRSetProperty メンバーが選択した値に設定され、この値は IMAPIProp::SetProps の呼び出しでプロパティ インターフェイスの実装に書き戻されます。
表示テーブルの概要については、「テーブルの 表示」を参照してください。 表示テーブルを実装する方法については、「表示テーブルの 実装」を参照してください。