Metodo StringFormat::SetHotkeyPrefix (gdiplusstringformat.h)

Il metodo StringFormat::SetHotkeyPrefix imposta il tipo di elaborazione eseguito su una stringa quando viene rilevato il prefisso della chiave di scelta rapida, un amperand (&), viene rilevato. L'amperando viene chiamato prefisso chiave di scelta rapida e può essere usato per designare determinate chiavi come tasti di scelta rapida.

Sintassi

Status SetHotkeyPrefix(
  [in] HotkeyPrefix hotkeyPrefix
);

Parametri

[in] hotkeyPrefix

Tipo: HotkeyPrefix

Elemento dell'enumerazione HotkeyPrefix che specifica come elaborare il prefisso della chiave di scelta rapida.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

I tasti di scelta rapida, detti anche tasti di accesso, sono tasti programmati per fornire a un utente finale tasti di scelta rapida per la funzionalità e vengono attivati premendo il tasto ALT. Le chiavi sono dipendenti dall'applicazione e sono identificate da una lettera con 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 sottolineata. Il tasto F è un collegamento per visualizzare il menu File .

Un programmatore client designa una chiave di scelta rapida in un'applicazione usando il prefisso della chiave di scelta rapida, un amperand (&), 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 appropriato di elaborazione. Quando un carattere in una stringa è preceduto da un amperatore, la chiave corrispondente al carattere diventa una chiave di scelta rapida durante l'elaborazione che si verifica quando la stringa viene disegnata sul dispositivo di visualizzazione. L'amperande viene chiamato prefisso chiave di scelta rapida perché precede l'attivazione del carattere. Se HotkeyPrefixNone viene passato a StringFormat::SetHotkeyPrefix, non si verifica alcuna elaborazione del prefisso della chiave di scelta rapida.

Esempio

Nell'esempio seguente viene creato un oggetto StringFormat e viene impostato il tipo di elaborazione del prefisso della chiave di scelta rapida da eseguire sulla stringa. Il codice usa quindi l'oggetto StringFormat per disegnare una stringa contenente il carattere di prefisso della chiave di scelta rapida. Il codice disegna anche il rettangolo di layout della stringa.

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

Requisiti

Vedi anche

HotkeyPrefix

StringFormat

StringFormat::GetHotkeyPrefix