Metode StringFormat::SetHotkeyPrefix (gdiplusstringformat.h)

Metode StringFormat::SetHotkeyPrefix mengatur jenis pemrosesan yang dilakukan pada string saat awalan kunci panas, ampersand (&), ditemui. Ampersand disebut awalan hot key dan dapat digunakan untuk menunjuk kunci tertentu sebagai hot key.

Sintaks

Status SetHotkeyPrefix(
  [in] HotkeyPrefix hotkeyPrefix
);

Parameter

[in] hotkeyPrefix

Jenis: HotkeyPrefix

Elemen enumerasi HotkeyPrefix yang menentukan cara memproses awalan kunci panas.

Nilai kembali

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Tombol panas, juga disebut tombol akses, adalah kunci yang diprogram untuk menyediakan pintasan keyboard kepada pengguna akhir ke fungsionalitas dan diaktifkan dengan menekan tombol ALT. Kunci tergantung pada aplikasi dan diidentifikasi dengan huruf yang digaris bawahi, biasanya dalam nama menu atau item menu; misalnya, saat Anda menekan ALT, huruf F dari menu File digaris bawahi. Tombol F adalah pintasan untuk menampilkan menu File .

Programmer klien menunjuk hot key dalam aplikasi dengan menggunakan awalan hot key, ampersand (&), dalam string yang biasanya ditampilkan sebagai nama menu atau item di menu dan dengan menggunakan metode StringFormat::SetHotkeyPrefix untuk mengatur jenis pemrosesan yang sesuai. Ketika karakter dalam string didahului dengan ampersand, kunci yang sesuai dengan karakter menjadi hot key selama pemrosesan yang terjadi saat string digambar pada perangkat tampilan. Ampersand disebut awalan kunci panas karena mendahului karakter yang akan diaktifkan. Jika HotkeyPrefixNone diteruskan ke StringFormat::SetHotkeyPrefix, tidak ada pemrosesan awalan kunci panas yang terjadi.

Catatan Istilah hot key digunakan secara sinonim di sini dengan istilah kunci akses. Istilah hot key mungkin memiliki arti yang berbeda di API Windows lainnya.

 

Contoh

Contoh berikut membuat objek StringFormat dan mengatur jenis pemrosesan awalan kunci panas yang akan dilakukan pada string. Kode kemudian menggunakan objek StringFormat untuk menggambar string yang berisi karakter awalan kunci panas. Kode ini juga menggambar persegi tata letak string.

VOID Example_SetHotkeyPrefix(HDC hdc)
{
   Graphics graphics(hdc);

   SolidBrush  solidBrush(Color(255, 255, 0, 0)); 
   FontFamily  fontFamily(L"Times New Roman");
   Font        font(&fontFamily, 24, FontStyleRegular, UnitPixel);
   
   StringFormat stringFormat;
   stringFormat.SetHotkeyPrefix(HotkeyPrefixShow);

   graphics.DrawString(
      L"This &text has some &underlined characters.", 
      43,  // string length
      &font, 
      RectF(30, 30, 160, 200), 
      &stringFormat, 
      &solidBrush);

   // Draw the rectangle that encloses the text.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawRectangle(&pen, 30, 30, 160, 200);
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusstringformat.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll

Lihat juga

HotkeyPrefix

StringFormat

StringFormat::GetHotkeyPrefix