Metodo StringFormat::GetHotkeyPrefix (gdiplusstringformat.h)

Il metodo StringFormat::GetHotkeyPrefix ottiene un elemento dell'enumerazione HotkeyPrefix che indica il tipo di elaborazione eseguita su una stringa quando viene rilevato un prefisso di tasto di scelta rapida, un'e commerciale (&).

Sintassi

HotkeyPrefix GetHotkeyPrefix();

Valore restituito

Tipo: HotkeyPrefix

Questo metodo restituisce un elemento dell'enumerazione HotkeyPrefix che indica il tipo di elaborazione del prefisso della chiave attiva eseguita su una stringa.

Commenti

I tasti di scelta rapida, detti anche tasti di scelta, sono tasti programmati per fornire a un utente finale tasti di scelta rapida per la funzionalità e attivati premendo ALT. Le chiavi sono dipendenti dall'applicazione e sono identificate da una lettera con caratteri di sottolineatura, in genere in un nome di menu o una voce di menu; Ad esempio, quando si preme ALT, la lettera F del menu File viene evidenziata. Il tasto F è un collegamento per visualizzare il menu File .

Un programmatore client designa un tasto di scelta rapida in un'applicazione usando il prefisso del tasto di scelta rapida, una e commerciale (&), in una stringa che in genere viene visualizzata come nome di un menu o di una voce in un menu e usando il metodo StringFormat::SetHotkeyPrefix per impostare il tipo di elaborazione appropriato. Quando un carattere in una stringa è preceduto da una e commerciale, la chiave corrispondente al carattere diventa un tasto di scelta rapida durante l'elaborazione che si verifica quando la stringa viene disegnata nel dispositivo di visualizzazione. L'e commerciale viene chiamato prefisso tasto di scelta rapida perché precede il carattere da attivare. Se HotkeyPrefixNone viene passato a StringFormat::SetHotkeyPrefix, non viene eseguita alcuna elaborazione dei prefissi dei tasti di scelta rapida.

Esempio

Nell'esempio seguente viene creato un oggetto StringFormat , viene impostato il tipo di elaborazione del prefisso della chiave di scelta rapida da eseguire sulla stringa e quindi viene ottenuto il tipo di elaborazione e archiviato in una variabile. Il codice crea quindi un secondo oggetto StringFormat e usa il valore archiviato per impostare il tipo di elaborazione del prefisso della chiave di scelta rapida per il secondo oggetto StringFormat . Il codice usa il secondo oggetto StringFormat per disegnare una stringa contenente il carattere di prefisso del tasto di scelta rapida. Il codice disegna anche il rettangolo di layout della stringa.

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

Requisiti

Vedi anche

HotkeyPrefix

StringFormat