IMAPITable::CollapseRow
Hace referencia a: Outlook 2013 | Outlook 2016
Contrae una categoría de tabla expandida, quitando los encabezados de nivel inferior y las filas hoja que pertenecen a la categoría de la vista de tabla.
HRESULT CollapseRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulFlags,
ULONG FAR * lpulRowCount
);
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.
ulFlags
Reservados; debe ser cero.
lpulRowCount
[out] Puntero al número total de filas que se quitan de la vista de tabla.
Valor devuelto
S_OK
La operación de contracción se ha realizado correctamente.
MAPI_E_NOT_FOUND
La fila identificada por el parámetro pbInstanceKey no existe.
MAPI_E_INVALID_ENTRYID
La fila identificada por el parámetro pbInstanceKey no existe. Este error es una alternativa a MAPI_E_NOT_FOUND; los proveedores de servicios pueden devolver cualquiera de ellos.
Comentarios
El método IMAPITable::CollapseRow contrae una categoría de tabla y la quita de la vista de tabla. Las filas se contraen a partir de la fila identificada por la propiedad PR_INSTANCE_KEY a la que apunta el parámetro pbInstanceKey . El número de filas que se quitan de la vista se devuelve en el contenido del parámetro lpulRowCount .
Las notificaciones nunca se generan para las filas de tabla que se quitan de una vista como resultado de una operación de contracción.
Cuando una fila definida por un marcador se contrae fuera de la vista, el marcador se mueve para que apunte a la siguiente fila visible.
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::CollapseRow para contraer una categoría de tabla. |