Método StringFormat::GetHotkeyPrefix (gdiplusstringformat.h)

O método StringFormat::GetHotkeyPrefix obtém um elemento da enumeração HotkeyPrefix que indica o tipo de processamento executado em uma cadeia de caracteres quando um prefixo de tecla frequente, um e comercial (&), é encontrado.

Sintaxe

HotkeyPrefix GetHotkeyPrefix();

Retornar valor

Tipo: HotkeyPrefix

Esse método retorna um elemento da enumeração HotkeyPrefix que indica o tipo de processamento de prefixo de tecla frequente executado em uma cadeia de caracteres.

Comentários

Teclas de acesso, também chamadas de teclas de acesso, são teclas programadas para fornecer a um usuário final atalhos de teclado para a funcionalidade e são ativadas pressionando a tecla ALT. As chaves são dependentes do aplicativo e são identificadas por uma letra sublinhada, normalmente em um nome de menu ou item de menu; por exemplo, quando você pressiona ALT, a letra F do menu Arquivo é sublinhada. A tecla F é um atalho para exibir o menu Arquivo .

Um programador cliente designa uma tecla de acesso em um aplicativo usando o prefixo de tecla frequente, um e comercial (&), em uma cadeia de caracteres que normalmente é exibida como o nome de um menu ou um item em um menu e usando o método StringFormat::SetHotkeyPrefix para definir o tipo apropriado de processamento. Quando um caractere em uma cadeia de caracteres é precedido por um e comercial, a chave que corresponde ao caractere se torna uma tecla dinâmica durante o processamento que ocorre quando a cadeia de caracteres é desenhada no dispositivo de exibição. O e comercial é chamado de prefixo de tecla de acesso frequente porque precede o caractere a ser ativado. Se HotkeyPrefixNone for passado para StringFormat::SetHotkeyPrefix, nenhum processamento de prefixos de teclas frequentes ocorrerá.

Nota O termo hot key é usado como sinônimo aqui com o termo chave de acesso. O termo hot key pode ter um significado diferente em outras APIs do Windows.

 

Exemplos

O exemplo a seguir cria um objeto StringFormat , define o tipo de processamento de prefixo de chave quente a ser executado na cadeia de caracteres e, em seguida, obtém o tipo de processamento e o armazena em uma variável. Em seguida, o código cria um segundo objeto StringFormat e usa o valor armazenado para definir o tipo de processamento de prefixo de chave quente para o segundo objeto StringFormat . O código usa o segundo objeto StringFormat para desenhar uma cadeia de caracteres que contém o caractere de prefixo de tecla frequente. O código também desenha o retângulo de layout da cadeia de caracteres.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusstringformat.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Hotkeyprefix

StringFormat