IMAPITable::ExpandRowIMAPITable::ExpandRow

適用されます: OutlookApplies to: Outlook

リーフまたは表形式ビューをカテゴリに属している下位レベルの見出しの行を追加する、折りたたまれているテーブルのカテゴリを展開します。Expands a collapsed table category, adding the leaf or lower-level heading rows belonging to the category to the table view.

HRESULT ExpandRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulRowCount,
ULONG ulFlags,
LPSRowSet FAR * lppRows,
ULONG FAR * lpulMoreRows
);

ParametersParameters

cbInstanceKeycbInstanceKey

[in]_PbInstanceKey_パラメーターが指す、PR_INSTANCE_KEY プロパティ内のバイト数です。[in] The count of bytes in the PR_INSTANCE_KEY property pointed to by the pbInstanceKey parameter.

pbInstanceKeypbInstanceKey

[in]カテゴリの見出しの行を識別するPR_INSTANCE_KEY (PidTagInstanceKey) のプロパティへのポインター。[in] A pointer to the PR_INSTANCE_KEY (PidTagInstanceKey) property that identifies the heading row for the category.

ulRowCountulRowCount

[in]_LppRows_パラメーターに返す行の最大数です。[in] The maximum number of rows to return in the lppRows parameter.

ulFlagsulFlags

予約されています。0 にする必要があります。Reserved; must be zero.

lppRowslppRows

[out]拡張の結果としてテーブルのビューに挿入されている ( ulRowCount) までの最初のローを受信するSRowSet構造体へのポインター。[out] A pointer to an SRowSet structure receiving the first (up to ulRowCount) rows that have been inserted into the table view as a result of the expansion. _PbInstanceKey_パラメーターで指定された見出しの行の後は、これらの行が挿入されます。These rows are inserted after the heading row identified by the pbInstanceKey parameter. _LppRows_パラメーターは、 _ulRowCount_パラメーターが 0 の場合、NULL にすることができます。The lppRows parameter can be NULL if the ulRowCount parameter is zero.

lpulMoreRowslpulMoreRows

[out]テーブル ビューに追加された行の総数へのポインター。[out] A pointer to the total number of rows that were added to the table view.

�߂�lReturn value

S_OKS_OK

カテゴリは正常に展開されています。The category was expanded successfully.

MAPI_E_NOT_FOUNDMAPI_E_NOT_FOUND

_PbInstanceKey_パラメーターで指定された行が存在しません。The row identified by the pbInstanceKey parameter does not exist.

備考Remarks

IMAPITable::ExpandRowメソッドでは、リーフやテーブル ・ ビューをカテゴリに属している下位レベルの見出しの行を追加する、折りたたまれているテーブルのカテゴリを展開します。The IMAPITable::ExpandRow method expands a collapsed table category, adding the leaf or lower-level heading rows that belong to the category to the table view. _LppRows_パラメーターで返される行の数に制限は、 _ulRowCount_パラメーターで指定できます。A limit to the number of rows to be returned in the lppRows parameter can be specified in the ulRowCount parameter. _UlRowCount_が 0 より大きい値に設定すると、 _lppRows_で指定された行セットの 1 つまたは複数の行が返されます、BOOKMARK_CURRENT は、行の最後の行の直後の行に移動するブックマークの位置を設定します。When ulRowCount is set to a value greater than zero and one or more rows are returned in the row set pointed to by lppRows, the position of the bookmark BOOKMARK_CURRENT is moved to the row immediately following the last row in the row set.

行に BOOKMARK_CURRENT の位置を設定するカテゴリに追加する_ulRowCount_を 0 に設定すると、リーフは 0、または下位の見出し行を要求するか、リーフまたはカテゴリ内の下位レベルの見出しの行がないために、0 個の行が返されます、次の_pbInstanceKey_で識別される行です。When ulRowCount is set to zero, requesting that zero leaf or lower-level heading rows be added to the category, or zero rows are returned because there are no leaf or lower-level heading rows in the category, the position of BOOKMARK_CURRENT is set to the row following the row identified by pbInstanceKey.

実装者へのメモNotes to implementers

カテゴリの拡張のためのテーブル ビューに追加される行に通知を生成しません。Do not generate notifications on rows that are added to a table view due to category expansion.

呼び出し側への注意Notes to callers

_LppRows_パラメーターで指定された行セット内の行の数ではテーブルに実際に追加された行の数が等しくない場合がありますが、全体のリーフの設定または下位の見出し行のカテゴリ。The number of rows in the row set pointed to by the lppRows parameter might not equal the number of rows that were actually added to the table, the entire set of leaf or lower-level heading rows for the category. メモリ不足、または_ulRowCount_パラメーターで指定された数を超えるカテゴリ内の行の数などは、エラーが発生することができます。Errors can occur, such as insufficient memory, or the number of rows in the category exceeding the number specified in ulRowCount parameter. BOOKMARK_CURRENT は、いずれの場合も、返された最後の行に配置されます。In either case, BOOKMARK_CURRENT will be positioned at the last row returned. カテゴリ内の行の残りの部分をすぐに取得するには、 IMAPITable::QueryRowsを呼び出します。To immediately retrieve the rest of the rows in the category, call IMAPITable::QueryRows.

カテゴリの状態を変更するとテーブルの通知が受信されないようにします。Do not expect to receive a table notification when a category changes its state. ExpandRowまたはCollapseRow呼び出しのたびに更新される行のローカル キャッシュを保持することができます。You can maintain a local cache of rows that can be updated with every ExpandRow or CollapseRow call.

分類されたテーブルの詳細については、並べ替えや分類を参照してください。For more information about categorized tables, see Sorting and Categorization.

MFCMAPI 参照MFCMAPI reference

MFCMAPI �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
ContentsTableListCtrl.cppContentsTableListCtrl.cpp
CContentsTableListCtrl::DoExpandCollapseCContentsTableListCtrl::DoExpandCollapse
MFCMAPI では、 IMAPITable::ExpandRowメソッドを使用して、折りたたまれているテーブルのカテゴリを展開します。MFCMAPI uses the IMAPITable::ExpandRow method to expand a collapsed table category.

関連項目See also

IMAPITable::CollapseRowIMAPITable::CollapseRow

IMAPITable: IUnknownIMAPITable : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample