IMAPITable::ExpandRow
Hace referencia a: Outlook 2013 | Outlook 2016
Expande una categoría de tabla contraída, agregando las filas de encabezado hoja o de nivel inferior que pertenecen a la categoría a la vista de tabla.
HRESULT ExpandRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulRowCount,
ULONG ulFlags,
LPSRowSet FAR * lppRows,
ULONG FAR * lpulMoreRows
);
Parameters
cbInstanceKey
[in] Recuento de bytes en la propiedad PR_INSTANCE_KEY a la que apunta el parámetro pbInstanceKey .
pbInstanceKey
[in] Puntero a la propiedad PR_INSTANCE_KEY (PidTagInstanceKey) que identifica la fila de encabezado de la categoría.
ulRowCount
[in] Número máximo de filas que se devolverán en el parámetro lppRows .
ulFlags
Reservados; debe ser cero.
lppRows
[out] Puntero a una estructura SRowSet que recibe las primeras filas (hasta ulRowCount) que se han insertado en la vista de tabla como resultado de la expansión. Estas filas se insertan después de la fila de encabezado identificada por el parámetro pbInstanceKey . El parámetro lppRows puede ser NULL si el parámetro ulRowCount es cero.
lpulMoreRows
[out] Puntero al número total de filas que se agregaron a la vista de tabla.
Valor devuelto
S_OK
La categoría se expandió correctamente.
MAPI_E_NOT_FOUND
La fila identificada por el parámetro pbInstanceKey no existe.
Comentarios
El método IMAPITable::ExpandRow expande una categoría de tabla contraída, agregando las filas de encabezado hoja o de nivel inferior que pertenecen a la categoría a la vista de tabla. Se puede especificar un límite para el número de filas que se devolverán en el parámetro lppRows en el parámetro ulRowCount . Cuando ulRowCount se establece en un valor mayor que cero y se devuelven una o varias filas en el conjunto de filas al que apunta lppRows, la posición del marcador BOOKMARK_CURRENT se mueve a la fila inmediatamente después de la última fila del conjunto de filas.
Cuando ulRowCount se establece en cero, solicitando que se agreguen cero filas de encabezado hoja o de nivel inferior a la categoría, o se devuelvan cero filas porque no hay filas de encabezado hoja o de nivel inferior en la categoría, la posición de BOOKMARK_CURRENT se establece en la fila que sigue a la fila identificada por pbInstanceKey.
Notas a los implementadores
No genere notificaciones en las filas que se agregan a una vista de tabla debido a la expansión de categorías.
Notas para los llamadores
Es posible que el número de filas del conjunto de filas al que apunta el parámetro lppRows no sea igual al número de filas que se agregaron realmente a la tabla, todo el conjunto de filas de encabezado hoja o de nivel inferior de la categoría. Pueden producirse errores, como memoria insuficiente o el número de filas de la categoría que superan el número especificado en el parámetro ulRowCount . En cualquier caso, BOOKMARK_CURRENT se colocará en la última fila devuelta. Para recuperar inmediatamente el resto de las filas de la categoría, llame a IMAPITable::QueryRows.
No espere recibir una notificación de tabla cuando una categoría cambie su estado. Puede mantener una caché local de filas que se puede actualizar con cada llamada a ExpandRow o CollapseRow .
Para obtener más información sobre las tablas categorizadas, vea Ordenar y categorizar.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oExpandCollapse |
MFCMAPI usa el método IMAPITable::ExpandRow para expandir una categoría de tabla contraída. |