StringFormat::GetHotkeyPrefix-Methode (gdiplusstringformat.h)

Die StringFormat::GetHotkeyPrefix-Methode ruft ein Element der HotkeyPrefix-Enumeration ab, das den Verarbeitungstyp angibt, der für eine Zeichenfolge ausgeführt wird, wenn ein Hot Key-Präfix, ein ampersand (&), gefunden wird.

Syntax

HotkeyPrefix GetHotkeyPrefix();

Rückgabewert

Typ: HotkeyPrefix

Diese Methode gibt ein Element der HotkeyPrefix-Enumeration zurück, das den Typ der Heißschlüsselpräfixverarbeitung angibt, die für eine Zeichenfolge ausgeführt wird.

Hinweise

Tastenkombinationen, auch Zugriffstasten genannt, sind Tasten, die so programmiert sind, dass sie einem Endbenutzer Tastenkombinationen für die Funktionalität bereitstellen und durch Drücken der ALT-Taste aktiviert werden. Die Schlüssel sind anwendungsabhängig und werden durch einen unterstrichenen Buchstaben identifiziert, in der Regel in einem Menünamen oder Menüelement. Wenn Sie z. B. ALT drücken, wird der Buchstabe F des Menüs Datei unterstrichen. Die F-Taste ist eine Verknüpfung zum Anzeigen des Menüs Datei .

Ein Clientprogrammierer bestimmt einen Hot Key in einer Anwendung mithilfe des Präfixes ampersand (&) in einer Zeichenfolge, die normalerweise als Name eines Menüs oder Elements in einem Menü angezeigt wird, und indem er die StringFormat::SetHotkeyPrefix-Methode verwendet, um den entsprechenden Verarbeitungstyp festzulegen. Wenn einem Zeichen in einer Zeichenfolge ein Ampersand vorangestellt wird, wird der Schlüssel, der dem Zeichen entspricht, während der Verarbeitung eine Hot-Taste, die auftritt, wenn die Zeichenfolge auf dem Anzeigegerät gezeichnet wird. Das Ampersand wird als Hot Key-Präfix bezeichnet, da es dem zu aktivierenden Zeichen vorangestellt ist. Wenn HotkeyPrefixNone an StringFormat::SetHotkeyPrefix übergeben wird, erfolgt keine Verarbeitung von Hotkeypräfix.

Hinweis Der Begriff Hot Key wird hier synonym mit dem Begriff Zugriffsschlüssel verwendet. Der Begriff Hot Key kann in anderen Windows-APIs eine andere Bedeutung haben.

 

Beispiele

Im folgenden Beispiel wird ein StringFormat-Objekt erstellt, der Typ der Heißschlüsselpräfixverarbeitung festgelegt, die für die Zeichenfolge ausgeführt werden soll, und ruft dann den Verarbeitungstyp ab und speichert es in einer Variablen. Der Code erstellt dann ein zweites StringFormat-Objekt und verwendet den gespeicherten Wert, um den Typ der Heißschlüsselpräfixverarbeitung für das zweite StringFormat-Objekt festzulegen. Der Code verwendet das zweite StringFormat-Objekt , um eine Zeichenfolge zu zeichnen, die das Präfixzeichen für den Heißschlüssel enthält. Der Code zeichnet auch das Layoutrechteck der Zeichenfolge.

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);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusstringformat.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

Hotkeyprefix

StringFormat