IMAPITable::SeekRowApprox
Gilt für: Outlook 2013 | Outlook 2016
Verschiebt den Cursor an eine ungefähre Bruchposition in der Tabelle.
HRESULT SeekRowApprox(
ULONG ulNumerator,
ULONG ulDenominator
);
Parameter
ulNumerator
[in] Zeiger auf den Zähler des Bruchs, der die Tabellenposition darstellt. Wenn der ulNumerator-Parameter null ist, wird der Cursor unabhängig vom Nennerwert am Anfang der Tabelle positioniert. Wenn ulNumerator gleich dem ulDenominator-Parameter ist, wird der Cursor nach der letzten Tabellenzeile positioniert.
ulDenominator
[in] Zeiger auf den Nenner des Bruchs, der die Tabellenposition darstellt. Der ulDenominator-Parameter darf nicht 0 (null) sein.
Rückgabewert
S_OK
Der Suchvorgang war erfolgreich.
MAPI_E_BUSY
Ein weiterer Vorgang wird ausgeführt, der verhindert, dass der Zeilensuchevorgang gestartet wird. Entweder sollte der laufende Vorgang abgeschlossen oder beendet werden.
Hinweise
Die Cursorposition in einer Tabelle nach einem Aufruf der IMAPITable::SeekRowApprox-Methode entspricht heuristisch dem Bruch und ist möglicherweise nicht exakt. Beispielsweise können bestimmte Anbieter eine Tabelle über einer binären Struktur implementieren, wobei der Halbzeitpunkt der Tabelle aus Leistungsgründen als oberster Teil der Struktur behandelt wird. Wenn die Struktur nicht ausgeglichen ist, liegt der verwendete Halbzeitpunkt möglicherweise nicht genau in der Mitte der Tabelle.
Hinweise für Aufrufer
Rufen Sie SeekRowApprox auf, um die Daten für eine Scrollleistenimplementierung bereitzustellen. Wenn der Benutzer beispielsweise das Bildlauffeld 2/3 nach unten auf der Bildlaufleiste positioniert, können Sie diese Aktion modellieren, indem Sie SeekRowApprox aufrufen und einen entsprechenden Bruchwert mit ulNumerator und ulDenominator übergeben. Die SeekRowApprox-Suche ist immer vom Anfang der Tabelle aus absolut. Um an das Ende der Tabelle zu wechseln, müssen die Werte in ulNumerator und ulDenominator identisch sein.
Verwenden Sie ein beliebiges Zahlenschema. Das heißt, um eine Position in der Mitte der Tabelle zu suchen, können Sie 1/2, 10/20 oder 50/100 angeben.