ITextHost::TxGetAcceleratorPos メソッド (textserv.h)

下線付きアクセラレータ文字に使用する特殊文字を要求します。

構文

HRESULT TxGetAcceleratorPos(
  LONG *pcp
);

pcp

型: LONG*

下線を引く文字の文字位置。この変数は、テキストホストによって設定されます。文字の位置が –1 (つまり負の位置) の場合は、下線を引く文字がないことを示します。

型: HRESULT

戻り値は S_OK。

アクセラレータを使用すると、さまざまな UI 要素 (ボタンなど) に対するキーボードショートカットまたはアクセラレータキーを使用できます。通常、ショートカット文字には下線が付きます。

このメソッドは、アクセラレータである文字をテキストサービスオブジェクトに指示するため、下線を引く必要があります。テキストサービスオブジェクトはアクセラレータを処理 しないこと に注意してください。これはホストの責任です。

通常、このメソッドは、テキストサービスオブジェクトでTXTBIT_SHOWACCELERATOR ビットが設定されている場合にのみ呼び出されます。「OnTxPropertyBitsChange」を参照してください。

メモテキストサービスオブジェクト内のテキストを変更すると、アクセラレータの下線が無効になります。この場合、適切な文字位置を再計算し、新しいアクセラレータが使用可能であることをテキストサービスオブジェクトに通知するのはホストの責任です。