StringFormat::Metode GetHotkeyPrefix (gdiplusstringformat.h)

Metode StringFormat::GetHotkeyPrefix mendapatkan elemen enumerasi HotkeyPrefix yang menunjukkan jenis pemrosesan yang dilakukan pada string ketika awalan kunci panas, ampersand (&), ditemui.

Sintaks

HotkeyPrefix GetHotkeyPrefix();

Mengembalikan nilai

Jenis: HotkeyPrefix

Metode ini mengembalikan elemen enumerasi HotkeyPrefix yang menunjukkan jenis pemrosesan awalan kunci panas yang dilakukan pada string.

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 hot key 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 , mengatur jenis pemrosesan awalan kunci panas yang akan dilakukan pada string, lalu mendapatkan jenis pemrosesan dan menyimpannya dalam variabel. Kode kemudian membuat objek StringFormat kedua dan menggunakan nilai tersimpan untuk mengatur jenis pemrosesan awalan kunci panas untuk objek StringFormat kedua. Kode menggunakan objek StringFormat kedua untuk menggambar string yang berisi karakter awalan kunci panas. Kode ini juga menggambar persegi tata letak string.

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

   SolidBrush  solidBrush(Color(255, 255, 0, 0)); 
   FontFamily  fontFamily(L"Times New Roman");
   Font        font(&fontFamily, 24, FontStyleRegular, UnitPixel);
   
   // Create a StringFormat object, and set its hot key prefix.
   StringFormat stringFormat;
   stringFormat.SetHotkeyPrefix(HotkeyPrefixShow);

   // Get the hot key prefix from the StringFormat object.
   HotkeyPrefix hotkeyPrefix = stringFormat.GetHotkeyPrefix();

   // Create a second StringFormat object with the same hot key prefix.
   StringFormat stringFormat2;
   stringFormat2.SetHotkeyPrefix(hotkeyPrefix);

   // Use the second StringFormat object in a call to DrawString.
  graphics.DrawString(
      L"This &text has some &underlined characters.", 
      43,  // string length
      &font, 
      RectF(30, 30, 160, 200), 
      &stringFormat2, 
      &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