IAddrBook::Details
適用対象: Outlook 2013 | Outlook 2016
特定のアドレス帳エントリに関する詳細を表示するダイアログ ボックスを表示します。
HRESULT Details(
ULONG_PTR FAR * lpulUIParam,
LPFNDISMISS lpfnDismiss,
LPVOID lpvDismissContext,
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPFNBUTTON lpfButtonCallback,
LPVOID lpvButtonContext,
LPSTR lpszButtonText,
ULONG ulFlags
);
パラメーター
lpulUIParam
[in]ダイアログ ボックスの親ウィンドウのハンドルへのポインター。
lpfnDismiss
[in] DISMISSMODELESS プロトタイプ (NULL) に基づく関数へのポインター。 このメンバーは、設定されているDIALOG_SDI フラグによって示されるように、ダイアログ ボックスのモードレス バージョンにのみ適用されます。 MAPI は、ユーザーがモードレス アドレス ダイアログ ボックスを閉じると 、DISMISSMODELESS 関数を呼び出し、ダイアログ ボックスがアクティブでなくなったことを 詳細 を呼び出しているクライアントに通知します。
lpvDismissContext
[in]lpfnDismiss パラメーターによって指される DISMISSMODELESS 関数に渡すコンテキスト情報へのポインター。 このパラメーターは、 ulFlags パラメーターに DIALOG_SDI フラグを含めることで、ダイアログ ボックスのモードレス バージョンにのみ適用されます。
cbEntryID
[in] lpEntryID パラメーターによって指されるエントリ識別子のバイト数。
lpEntryID
[in]詳細が表示されるエントリのエントリ識別子へのポインター。
lpfButtonCallback
[in] LPFNBUTTON 関数プロトタイプに基づく関数へのポインター。 LPFNBUTTON 関数は、詳細ダイアログ ボックスにボタンを追加します。
lpvButtonContext
[in] lpfButtonCallback パラメーターで指定された関数のパラメーターとして使用されたデータへのポインター。
lpszButtonText
[in]追加されたボタンに適用するテキストを含む文字列へのポインター (そのボタンが拡張可能な場合)。 拡張ボタンが必要ない場合は、 lpszButtonText パラメーターを NULL にする必要があります。
ulFlags
[in] lpszButtonText パラメーターのテキストの型を制御するフラグのビットマスク。 次のフラグを設定できます。
AB_TELL_DETAILS_CHANGE
アドレスに実際に変更が加えられた場合、 Details からS_OKが返されることを示します。それ以外の場合、 Details はS_FALSEを返します。
DIALOG_MODAL
Outlook 以外のクライアントで常に表示される共通アドレス ダイアログ ボックスのモーダル バージョンを表示します。 このフラグは、DIALOG_SDIと相互に排他的です。
DIALOG_SDI
共通アドレス ダイアログ ボックスのモードレス バージョンを表示します。 このフラグは、Outlook 以外のクライアントでは無視されます。
MAPI_UNICODE
渡された文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。
戻り値
S_OK
アドレス帳エントリの詳細ダイアログ ボックスが正常に表示されました。
注釈
クライアント アプリケーションは Details メソッドを呼び出して、アドレス帳内の特定のエントリに関する詳細を示すダイアログ ボックスを表示します。 lpfButtonCallback、lpvButtonContext、lpszButtonText パラメーターを使用して、クライアント定義のボタンをダイアログ ボックスに追加できます。 ボタンをクリックすると、MAPI は、ボタンのエントリ識別子と lpvButtonContext 内のデータの両方を渡して、lpfButtonCallback が指すコールバック関数を呼び出します。 拡張可能なボタンが必要ない場合は、 lpszButtonText を NULL にする必要があります。
詳細 では、Unicode 文字列がサポートされています。Unicode 文字列は、詳細ダイアログ ボックスに表示される前に、マルチバイト文字列 (MBCS) 形式に変換されます。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| BaseDialog.cpp |
CBaseDialog::OnOpenEntryID |
MFCMAPI では 、Details メソッドを使用して、アドレス帳エントリの詳細を示すダイアログ ボックスを表示します。 |