Moves the cards in the fragment to the specified pile.

Syntax:

HRESULT MoveToPile(
   ISolpackPile *pDest,
   VARIANT_BOOL bAnimate,
   VARIANT_BOOL bToggleFace
);

Parameters:

pDest

A pointer to the ISolpackPile interface of the pile to add the fragment's cards to.

bAnimate

A VARIANT_BOOL variable that specifies whether to animate the cards from their current position to their destination position.

bToggleFace

A VARIANT_BOOL variable that specifies whether to toggle the card's FaceUp property at the end of the transfer.

Return Value:

Returns S_OK if successful, or an error value otherwise.

Remarks:

The cards are added to the destination pile in the same order in which they exist in the fragment. Change the ISolpackCard::Index property of the cards after this method completes to rearrange the cards if necessary.

The bToggleFace parameter is useful when dealing cards. For instance, setting bToggleFace and bAnimate to VARIANT_TRUE when dealing out a game causes the cards to be animated face down, and then automatically turned face up when the animation completes.