ITextHost::TxGetAcceleratorPos-Methode (textserv.h)

Artikel
03/02/2024

Fordert das Sonderzeichen an, das für das unterstreichende Zugriffstastenzeichen verwendet werden soll.

Syntax

HRESULT TxGetAcceleratorPos(
  LONG *pcp
);

Parameter

pcp

Typ: LONG*

Die Zeichenposition des zu unterstreichenden Zeichens. Diese Variable wird vom Texthost festgelegt. Die Zeichenposition –1 (d. h. eine negative Position) gibt an, dass kein Zeichen unterstrichen werden darf.

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist S_OK.

Hinweise

Beschleuniger ermöglichen Tastenkombinationen oder Tastenkombinationen für verschiedene Ui-Elemente (z. B. Schaltflächen). In der Regel wird das Tastenkombinationszeichen unterstrichen.

Diese Methode teilt dem Textdienstobjekt mit, welches Zeichen die Beschleuniger ist und daher unterstrichen werden soll. Beachten Sie, dass das Textdienstobjekt keine Beschleuniger verarbeitet. dies liegt in der Verantwortung des Gastgebers.

Diese Methode wird in der Regel nur aufgerufen, wenn das TXTBIT_SHOWACCELERATOR Bit im Text services-Objekt festgelegt ist. Siehe OnTxPropertyBitsChange.

HinweisJede Änderung des Texts im Textdienstobjekt führt zur Ungültigkeit der Beschleunigerunterstreichung. In diesem Fall liegt es in der Verantwortung des Hosts, die entsprechende Zeichenposition neu zu berechnen und das Textdienstobjekt darüber zu informieren, dass eine neue Zugriffstaste verfügbar ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textserv.h
DLL	Msftedit.dll