Retrieves the width the pile would have with a given number of cards.

Syntax:

HRESULT WidthWith(
   long lNumCards
   long *plWidth
);

Parameters:

lNumCards

The number of cards to test with.

plWidth

Address of a long integer variable that receives the width, in pixels.

Return Value:

Returns S_OK if successful, or an error value otherwise.

Remarks:

Use this method to retrieve dimensions to layout piles based on their size when filled to capacity.

The dimensions of a pile are dependant on the type of pile and how many cards it contains.