IMAPITable::QueryPosition Method

Retrieves the current table row position of the cursor, if possible, and its fractional position.

Syntax

HRESULT QueryPosition(
    ULONG *lpulRow,
    ULONG *lpulNumerator,
    ULONG *lpulDenominator
);

Parameters

• lpulRow
  ULONG Pointer to a variable of type ULONG that receives the current row number. The row number is zero-based; the first row in the table is row zero.
• lpulNumerator
  ULONG Pointer to a variable of type ULONG that receives the numerator for the fraction identifying the table position.
• lpulDenominator
  ULONG Pointer to a variable of type ULONG that receives the denominator for the fraction identifying the table position.

Return Value

HRESULT

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Use IMAPITable::QueryPosition to position a scroll box in a table view's scroll bar. For example, if IMAPITable::QueryPosition retrieves a value of 75 in the lpulNumerator parameter and 100 in the lpulDenominator parameter, use this fraction to properly position the scroll box at three-fourths of the way down the scroll bar.

Requirements

See Also

IMAPITable

Send comments about this topic to Microsoft

Build date: 6/30/2010