Metode IOleInPlaceActiveObject::TranslateAccelerator (oleidl.h)

Artikel
03/01/2024

Memproses pesan akselerator-kunci menu dari antrean pesan kontainer. Metode ini hanya boleh digunakan untuk objek yang dibuat oleh aplikasi objek DLL.

Sintaks

HRESULT TranslateAccelerator(
  [in] LPMSG lpmsg
);

Parameter

[in] lpmsg

Penunjuk ke struktur MSG untuk pesan yang mungkin perlu diterjemahkan.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_FALSE	Pesan tidak diterjemahkan.
E_INVALIDARG	Nilai parameter yang ditentukan tidak valid.
E_OUTOFMEMORY	IThere tidak cukup memori yang tersedia untuk operasi.
E_UNEXPECTED	Terjadi kesalahan tidak terduga.

Keterangan

Catatan untuk Penelepon

Objek aktif di tempat harus selalu diberi kesempatan pertama untuk menerjemahkan penekanan tombol akselerator. Anda dapat memberikan kesempatan ini dengan memanggil IOleInPlaceActiveObject::TranslateAccelerator dari perulangan pesan kontainer Anda sebelum melakukan terjemahan lainnya. Anda harus menerapkan terjemahan Anda sendiri hanya ketika metode ini mengembalikan S_FALSE.

Jika Anda memanggil IOleInPlaceActiveObject::TranslateAccelerator untuk objek yang tidak dibuat oleh aplikasi objek DLL, handler objek default mengembalikan S_FALSE.

Catatan untuk Pelaksana

Objek yang dibuat oleh aplikasi objek EXE mendapatkan penekanan tombol dari pompa pesannya sendiri, sehingga kontainer tidak mendapatkan pesan tersebut.

Jika Anda perlu menerapkan metode ini, Anda dapat melakukannya hanya dengan membungkus panggilan ke fungsi TranslateAccelerator .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h