Partilhar via


CMFCAcceleratorKey Class

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Uma classe auxiliar que implementa mapeamento e formatação de teclas virtuais.

Sintaxe

class CMFCAcceleratorKey : public CObject

Membros

Construtores Públicos

Nome Description
CMFCAcceleratorKey::CMFCAcceleratorKey Constrói um CMFCAcceleratorKey objeto.

Métodos Públicos

Nome Description
CMFCAcceleratorKey::Format Traduz a estrutura ACCEL para a sua representação visual.
CMFCAcceleratorKey::SetAccelerator Define a tecla de atalho para o CMFCAcceleratorKey objeto.

Observações

As teclas aceleradoras também são conhecidas como teclas de atalho. Se quiser mostrar atalhos de teclado que o utilizador insere, a classe CMFCAcceleratorKeyAssignCtrl mapeia atalhos de teclado, como Alt+Shift+S, para um formato de texto personalizado, como "Alt + Shift + S". Cada CMFCAcceleratorKey objeto mapeia uma única tecla de atalho para um formato de texto.

Para mais informações sobre como usar teclas de atalho e tabelas de aceleração, consulte CKeyboardManager Class.

Example

O exemplo seguinte demonstra como construir um CMFCAcceleratorKey objeto e como usar o seu Format método.

CString strKey;
ACCEL accel;
accel.fVirt = FVIRTKEY | FCONTROL;
accel.key = VK_DOWN;

CMFCAcceleratorKey helper(&accel);
helper.Format(strKey);

Hierarquia de herança

CObject

CMFCAcceleratorKey

Requerimentos

Cabeçalho: afxacceleratorkey.h

CMFCAcceleratorKey::CMFCAcceleratorKey

Constrói um objeto CMFCAcceleratorKey .

CMFCAcceleratorKey();
CMFCAcceleratorKey(LPACCEL lpAccel);

Parâmetros

lpAccel
[dentro] Um apontador para uma tecla de atalho.

Observações

Se não fornecer uma tecla de atalho ao criar um CMFCAccleratorKey, use o método CMFCAcceleratorKey::SetAccelerator para associar uma tecla de atalho ao seu CMFCAcceleratorKey objeto.

CMFCAcceleratorKey::Format

Traduz a estrutura ACCEL para o seu valor de cadeia associado.

void Format(CString& str) const;

Parâmetros

STR
[fora] Uma referência a um CString objeto onde o método escreve a tecla de atalho traduzida.

Observações

Este método recupera o formato de string da tecla de atalho associada. Pode definir o formato de string de um objeto CMFCAcceleratorKey usando o construtor ou o método CMFCAcceleratorKey::SetAccelerator.

CMFCAcceleratorKey::SetAccelerator

Define a tecla de atalho para o objeto CMFCAcceleratorKey .

void SetAccelerator(LPACCEL lpAccel);

Parâmetros

lpAccel
[dentro] Um apontador para uma tecla de atalho.

Observações

Use este método para definir a tecla de atalho para um CMFCAcceleratorKey caso não tenha fornecido uma tecla de atalho quando criou o CMFCAcceleratorKey.

Consulte também

Gráfico de Hierarquia
Classes
Classe CKeyboard Manager