Partilhar via

CMFCRibbonCheckBox Classe

A CMFCRibbonCheckBox classe implementa uma caixa de seleção que você pode adicionar a um painel da faixa de opções, Barra de Ferramentas de Acesso Rápido ou menu pop-up.

Sintaxe

class CMFCRibbonCheckBox : public CMFCRibbonButton

Membros

Construtores Públicos

Nome Descrição
CMFCRibbonCheckBox::CMFCRibbonCheckBox O construtor.

Métodos Públicos

Nome Descrição
CMFCRibbonCheckBox::GetCompactSize (Substitui CMFCRibbonButton::GetCompactSize.)
CMFCRibbonCheckBox::GetIntermediateSize (Substitui CMFCRibbonButton::GetIntermediateSize.)
CMFCRibbonCheckBox::GetRegularSize (Substitui CMFCRibbonButton::GetRegularSize.)
CMFCRibbonCheckBox::IsDrawTooltipImage (Substitui CMFCRibbonButton::IsDrawTooltipImage.)
CMFCRibbonCheckBox::OnDraw (Substitui CMFCRibbonButton::OnDraw.)
CMFCRibbonCheckBox::OnDrawMenuImage (Substitui CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonCheckBox::OnDrawOnList (Substitui CMFCRibbonButton::OnDrawOnList.)
CMFCRibbonCheckBox::SetACCData (Substitui CMFCRibbonButton::SetACCData.)

Observações

Para usar um CMFCRibbonCheckBox em seu aplicativo, adicione o seguinte construtor ao seu código:

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

onde nID é o ID do comando da caixa de seleção e lpszText é o rótulo de texto da caixa de seleção.

Você pode adicionar uma caixa de seleção a um painel da faixa de opções usando CMFCRibbonPanel::Add.

Hierarquia de herança

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

Requerimentos

Cabeçalho: afxribboncheckbox.h

CMFCRibbonCheckBox::CMFCRibbonCheckBox

Construtor de um objeto de caixa de seleção da faixa de opções

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

Parâmetros

nID
[em] Especifica a ID do comando.

lpszText
[em] Especifica o rótulo do texto.

Valor de retorno

Constrói um objeto de caixa de seleção da faixa de opções.

Exemplo

O exemplo a seguir demonstra como construir um objeto da CMFCRibbonCheckBox classe.

strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);

CMFCRibbonCheckBox::GetCompactSize

Quando substituído, obtém o tamanho compacto da caixa de seleção.

virtual CSize GetCompactSize(CDC* pDC);

Parâmetros

pDC
[em] Ponteiro para o CDC associado à caixa de seleção.

Valor de retorno

Retorna um CSize objeto que contém o tamanho compacto da caixa de seleção.

Observações

Se não for substituído, retorna o tamanho intermediário da caixa de seleção.

CMFCRibbonCheckBox::GetIntermediateSize

Obtém o tamanho intermediário da caixa de seleção.

virtual CSize GetIntermediateSize(CDC* pDC);

Parâmetros

pDC
[em] Ponteiro para o CDC associado a esta caixa de seleção.

Valor de retorno

Um CSize objeto que contém o tamanho intermediário da caixa de seleção.

Observações

Se não for substituído, calcula o tamanho intermediário como o tamanho padrão da caixa de seleção (AFX_CHECK_BOX_DEFAULT_SIZE) mais o tamanho do texto, mais margens.

CMFCRibbonCheckBox::GetRegularSize

Obtém o tamanho normal da caixa de seleção.

virtual CSize GetRegularSize(CDC* pDC);

Parâmetros

pDC
[em] Ponteiro para o objeto CDC associado a esta caixa de seleção.

Valor de retorno

Retorna um CSize objeto que contém o tamanho regular da caixa de seleção.

Observações

Se não for substituído, retorna o tamanho intermediário da caixa de seleção.

CMFCRibbonCheckBox::IsDrawTooltipImage

Indica se há uma imagem de dica de ferramenta associada à caixa de seleção.

virtual BOOL IsDrawTooltipImage() const;

Valor de retorno

Retorna TRUE se houver uma imagem de dica de ferramenta associada à caixa de seleção, ou FALSE se não.

Observações

CMFCRibbonCheckBox::OnDraw

Chamado pela estrutura para desenhar a caixa de seleção usando um contexto de dispositivo especificado.

virtual void OnDraw(CDC* pDC);

Parâmetros

pDC
[em] Ponteiro para o CDC no qual desenhar a caixa de seleção.

Observações

CMFCRibbonCheckBox::OnDrawMenuImage

Chamado pela estrutura para desenhar uma imagem de menu para a caixa de seleção.

virtual BOOL OnDrawMenuImage(CDC*, CRect);

Parâmetros

[em] CDC*
Ponteiro para o CDC associado à caixa de seleção.

CRect
[em] Um CRect objeto que especifica o retângulo no qual desenhar a imagem do menu.

Valor de retorno

Retorna TRUE se a imagem foi desenhada, ou FALSE se não.

Observações

Se não for substituído, retorna FALSE.

CMFCRibbonCheckBox::OnDrawOnList

Chamado pela estrutura para desenhar a caixa de seleção em uma caixa de listagem de comandos.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parâmetros

pDC
[em] Ponteiro para o contexto do dispositivo no qual desenhar a caixa de seleção.

strTexto
[em] O texto de exibição.

nTextOffset
[em] A distância, em pixels, do lado esquerdo da caixa de listagem até o texto de exibição.

retângulo
[em] O retângulo de exibição para a caixa de seleção.

bIsSelected
[em] TRUE se a caixa de seleção estiver marcada, ou FALSE se não.

bDestaque
[em] TRUE se a caixa de seleção estiver realçada ou FALSE se não.

Observações

CMFCRibbonCheckBox::SetACCData

Define os dados de acessibilidade para a caixa de seleção.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parâmetros

pPai
A janela pai da caixa de seleção.

Dados
Os dados de acessibilidade para a caixa de seleção.

Valor de retorno

Sempre retorna TRUE.

Observações

Por padrão, esse método define os dados de acessibilidade para a caixa de seleção e sempre retorna TRUE. Substitua esse método para definir os dados de acessibilidade e retornar um valor que indique sucesso ou falha.

Ver também

Gráfico de Hierarquia
Aulas
CMFCRibbonPanel Classe

  • Last updated on