다음을 통해 공유


StringFormat::SetHotkeyPrefix 메서드(gdiplusstringformat.h)

StringFormat::SetHotkeyPrefix 메서드는 핫 키 접두사인 앰퍼샌드(&)가 발생할 때 문자열에서 수행되는 처리 유형을 설정합니다. 앰퍼샌드는 핫 키 접두사라고 하며 특정 키를 핫 키로 지정하는 데 사용할 수 있습니다.

구문

Status SetHotkeyPrefix(
  [in] HotkeyPrefix hotkeyPrefix
);

매개 변수

[in] hotkeyPrefix

형식: HotkeyPrefix

핫 키 접두사를 처리하는 방법을 지정하는 HotkeyPrefix 열거형의 요소입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

액세스 키라고도 하는 핫 키는 최종 사용자에게 기능에 대한 바로 가기 키를 제공하도록 프로그래밍되고 ALT 키를 눌러 활성화되는 키입니다. 키는 애플리케이션에 따라 다르며 일반적으로 메뉴 이름 또는 메뉴 항목에서 밑줄 문자로 식별됩니다. 예를 들어 Alt 키를 누르면 파일 메뉴의 문자 F가 밑줄로 표시됩니다. F 키는 파일 메뉴를 표시하는 바로 가기 키입니다.

클라이언트 프로그래머는 일반적으로 메뉴 또는 메뉴의 항목 이름으로 표시되는 문자열에서 핫 키 접두사인 앰퍼샌드(&)를 사용하고 StringFormat::SetHotkeyPrefix 메서드를 사용하여 적절한 처리 유형을 설정하여 애플리케이션에서 핫 키를 지정합니다. 문자열의 문자 앞에 앰퍼샌드가 있으면 표시 디바이스에서 문자열을 그릴 때 발생하는 처리 중에 문자에 해당하는 키가 핫 키가 됩니다. 앰퍼샌드는 활성화할 문자 앞에 있기 때문에 핫 키 접두사라고 합니다. HotkeyPrefixNone이 StringFormat::SetHotkeyPrefix에 전달되면 핫 키 접두사를 처리하지 않습니다.

참고핫 키 라는 용어는 여기에서 액세스 키라는 용어와 동의어로 사용됩니다. 핫 키라는 용어는 다른 Windows API에서 다른 의미를 가질 수 있습니다.
 

예제

다음 예제에서는 StringFormat 개체를 만들고 문자열에서 수행할 핫 키 접두사 처리 형식을 설정합니다. 그런 다음, 코드는 StringFormat 개체를 사용하여 핫 키 접두사 문자가 포함된 문자열을 그립니다. 또한 이 코드는 문자열의 레이아웃 사각형을 그립니다.

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

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 gdiplusstringformat.h(Gdiplus.h 포함)
라이브러리 Gdiplus.lib
DLL Gdiplus.dll

추가 정보

HotkeyPrefix

StringFormat

StringFormat::GetHotkeyPrefix