DTBLDDLBXDTBLDDLBX

適用されます: OutlookApplies to: Outlook

ダイアログ ボックスが表示テーブルの構築に使用するドロップダウン リスト コントロールについて説明します。Describes a drop-down list control that will be used in a dialog box built from a display table.

ヘッダー ファイル:Header file:
Mapidefs.hMapidefs.h
typedef struct _DTBLDDLBX
{
  ULONG ulFlags;
  ULONG ulPRDisplayProperty;
  ULONG ulPRSetProperty;
  ULONG ulPRTableName;
} DTBLDDLBX, FAR *LPDTBLDDLBX;

メンバーMembers

ulFlagsulFlags

予約済み、0 でなければなりません。Reserved, must be zero.

ulPRDisplayPropertyulPRDisplayProperty

型 PT_TSTRING のプロパティのプロパティ タグです。Property tag for a property of type PT_TSTRING. このプロパティは、 ulPRTableNameのメンバーで識別されるテーブル内の列のいずれかです。This property is one of the columns in the table identified by the ulPRTableName member. このプロパティの値は、一覧に表示されます。The values for this property are displayed in the list.

ulPRSetPropertyulPRSetProperty

任意の型のプロパティのプロパティ タグです。Property tag for a property of any type. このプロパティは、 ulPRTableNameのメンバーで識別されるテーブル内の列のいずれかです。This property is one of the columns in the table identified by the ulPRTableName member. UlPRTableNameメンバーで識別されるテーブルの行からulPRDisplayPropertyのメンバーのリストのユーザーがプロパティの値を選択すると、対応するulPRSetPropertyのメンバーが設定されます。When the user of the list selects a property value for the ulPRDisplayProperty member from the rows of the table identified by the ulPRTableName member, the corresponding ulPRSetProperty member is set.

ulPRTableNameulPRTableName

PT_OBJECT、 OpenPropertyを使用して開くことができる種類のテーブルのプロパティのプロパティ タグを呼び出します。Property tag for a table property of type PT_OBJECT that can be opened by using an OpenProperty call. テーブルが 2 つの列を持つ必要があります: ulPRDisplayPropertyulPRSetPropertyThe table should have two columns: ulPRDisplayProperty and ulPRSetProperty. テーブルの行は、リスト内の項目に対応します。The rows of the table should correspond to items in the list.

備考Remarks

DTBLDDLBX構造体では、展開するまでに、1 つの項目として表示されているドロップダウン リスト コントロールについて説明します。A DTBLDDLBX structure describes a drop-down list control that is displayed as a single item until the user elects to expand it.

プロパティ タグで識別される 3 つのプロパティが連携する情報が一覧に表示し、関連するプロパティを設定します。The three properties identified by the property tags work together to display the information in the list and set a related property. UlPRTableNameメンバーは、 IMAPIProp::OpenPropertyを呼び出すことによってアクセスされているテーブル オブジェクトです。The ulPRTableName member is a table object that is accessed through a call to IMAPIProp::OpenProperty. テーブルには 2 つの列: ulPRDisplayPropertyメンバーとulPRSetPropertyのメンバーによって識別されるプロパティによって識別されるプロパティの 1 つの列です。The table has two columns: one column for the property identified by the ulPRDisplayProperty member and the other for the property identified by the ulPRSetProperty member.

UlPRDisplayPropertyプロパティは、リストの表示をドライブします。The ulPRDisplayProperty property drives the list display. ユーザーは、表示値のいずれかを選択すると、MAPI は、 ulPRSetPropertyのメンバーで識別される、対応するプロパティを設定するのにはIMAPIProp::SetPropsを呼び出します。When a user selects one of the values from the display, MAPI calls IMAPIProp::SetProps to set the corresponding property as identified by the ulPRSetProperty member. つまり、選択した表示のプロパティとして同じ行のプロパティです。This means that the property in the same row as the selected display property. UlPRSetPropertyメンバーは、 PR_NULL (PidTagNull) に設定できません。The ulPRSetProperty member cannot be set to PR_NULL (PidTagNull).

初期値は、MAPI がIMAPIProp::GetPropsを呼び出すことによってulPRSetPropertyのメンバーによって表されるプロパティを取得し、 ulPRSetPropertyメンバーの値を持つテーブルの行を配置する場合、一覧に表示されます。An initial value is displayed in the list if MAPI has retrieved the property represented by the ulPRSetProperty member through a call to IMAPIProp::GetProps and located a row in the table with the value for the ulPRSetProperty member. 最初に表示される値は、 ulPRDisplayPropertyulPRDisplayProperty構造体のメンバーのプロパティに一致する行をその列の内容です。The initial displayed value is the contents of the ulPRDisplayProperty column from that row that matches the property in the ulPRDisplayProperty member of the structure. リストが最初に表示されるときに表示される初期値をGetProps ulPRDisplayPropertyメンバーで識別されるプロパティの戻り値になります。The value returned by GetProps for the property identified by the ulPRDisplayProperty member becomes the initial value that is shown when the list is first displayed.

テーブルの表示の概要については、テーブルの表示を参照してください。For an overview of display tables, see Display Tables. 表示テーブルを実装する方法の詳細については、表示テーブルを実装するを参照してください。For information about how to implement a display table, see Implementing a Display Table. プロパティの型については、 MAPI プロパティの種類の概要を参照してください。For information about property types, see MAPI Property Type Overview.

関連項目See also

DTCTLDTCTL

IMAPIProp::OpenPropertyIMAPIProp::OpenProperty

IMAPIProp::SetPropsIMAPIProp::SetProps

IMAPIProp::GetPropsIMAPIProp::GetProps

MAPI の構造MAPI Structures

表示テーブルの実装Display Table Implementation

テーブルを表示します。Display Tables

MAPI プロパティの型の概要MAPI Property Type Overview