DTBLCHECKBOX

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

表示テーブルから作成されたダイアログ ボックスで使用されるチェック ボックスに関する情報が含まれます。

プロパティ 値
ヘッダー ファイル:
 Mapidefs.h
関連するマクロ:
 SizedDtblCheckBox 
typedef struct _DTBLCHECKBOX
{
  ULONG ulbLpszLabel;
  ULONG ulFlags;
  ULONG ulPRPropertyName;
} DTBLCHECKBOX, FAR *LPDTBLCHECKBOX;

メンバー

ulbLpszLabel

[チェック] ボックスに表示される文字列のメモリ内の位置。

ulFlags

チェック ボックス ラベルの形式を指定するために使用されるフラグのビットマスク。 次のフラグを設定できます。

MAPI_UNICODE

ラベルは Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、ラベルは ANSI 形式です。

ulPRPropertyName

PT_BOOLEAN型のプロパティのプロパティ タグ。 このプロパティの値は、チェック ボックスの状態の影響を受けます。

注釈

DTBLCHECKBOX 構造体は、2 つの状態のいずれかを反映するコントロールをチェック ボックスについて説明します。有効 (チェック ボックス) または無効 (空のボックス)。

ulPRPropertyName メンバーは、チェック ボックスの状態を変更することで値が操作されるブール型 (Boolean) プロパティについて説明します。 チェック ボックスが最初に表示されると、MAPI は、表示テーブルに関連付けられている IMAPIProp 実装の GetProps メソッドを呼び出して、既定のプロパティのセットを取得します。 いずれかのプロパティが DTBLCHECKBOX 構造体のプロパティ タグにマップされている場合、そのプロパティの値は チェック ボックスの初期値として表示されます。

チェック ボックス コントロールは変更可能です。 これにより、ユーザーは状態を変更できます。 変更可能なチェック ボックスは、DTCTL 構造体の ulCtlFlags メンバーと、そのPR_CONTROL_FLAGS (PidTagControlFlags) プロパティでDT_EDITABLE フラグを設定します。 チェック ボックスの状態が変更されると、MAPI は IMAPIProp::SetProps を呼び出して、DTBLCHECKBOX 構造体のプロパティ タグ メンバーで識別されるプロパティを新しい状態に設定します。

たとえば、アドレス帳プロバイダーの構成ダイアログ ボックスに変更可能なチェック ボックス コントロールを含めて、受信者のPR_SEND_RICH_INFO (PidTagSendRichInfo) プロパティの設定を調整できます。 ユーザーが [チェック] ボックスを選択すると、MAPI によってこのプロパティが TRUE に設定されます。 チェック ボックスがオフの場合、 プロパティは FALSE に設定されます。

表示テーブルの概要については、「テーブルの 表示」を参照してください。 表示テーブルを実装する方法については、「表示テーブルの 実装」を参照してください。 プロパティの種類の詳細については、「 MAPI プロパティの種類の概要」を参照してください。

関連項目

DTCTL

PidTagControlType 標準プロパティ

MAPI の構造