LastRequiredSlotHeight

Document parts, variable data, document editing

Description

Reports the slot height the most recent retry of a TPDFlibDynamicComponentSession composition requires before the deferred fragment can commit

Syntax

Property TPDFlibDynamicComponentSession.LastRequiredSlotHeight: Double;

Value

The known required height of the deferred trial, or zero when no retry information is recorded

Remarks

A minimum-slot retry reports the configured MinimumSlotHeight

A keep-together or require-complete retry of content that exceeds the slot reports the used height of the trial

A following-height retry reports the resolved final fragment height plus MinimumFollowingHeight

The value is cleared to zero at the start of every ComposeNextLayout call and is set only on a PDF_DYNAMIC_COMPONENT_RETRY result, so a successful commit leaves it at zero

Reset and AttachComponent also clear the value

Example

Status := Session.ComposeNextLayout(
  PageNumber, 36, 72, 540, 240, Options, Placement);

if Status = PDF_DYNAMIC_COMPONENT_RETRY then
  NeededHeight := Session.LastRequiredSlotHeight;

See also

LastRetryReason, KeepTogetherRetryPending, ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession