Classe CMFCRibbonCheckBox
A classe CMFCRibbonCheckBox implementa uma caixa de seleção que você pode adicionar a um painel de faixa de opções, à Barra de Ferramentas de Acesso Rápido ou a um 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 | (Overrides CMFCRibbonButton::GetCompactSize.) |
| CMFCRibbonCheckBox::GetIntermediateSize | (Substitui CMFCRibbonButton::GetIntermediateSize.) |
| CMFCRibbonCheckBox::GetRegularSize | (Substitui CMFCRibbonButton::GetRegularSize.) |
| CMFCRibbonCheckBox::IsDrawTooltipImage | (Substitui CMFCRibbonButton::IsDrawTooltipImage.) |
| CMFCRibbonCheckBox::OnDraw | (Substitui CMFCRibbonButton::OnDraw.) |
| CMFCRibbonCheckBox::OnDrawMenuImage | (Overrides CMFCRibbonBaseElement::OnDrawMenuImage.) |
| CMFCRibbonCheckBox::OnDrawOnList | (Substitui CMFCRibbonButton::OnDrawOnList.) |
| CMFCRibbonCheckBox::SetACCData | (Substitui CMFCRibbonButton::SetACCData.) |
Comentários
Para usar uma CMFCRibbonCheckBox no seu aplicativo, adicione o seguinte construtor ao código:
CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)
em que nID é a ID de 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 de faixa de opções usando CMFCRibbonPanel::Add.
Hierarquia de herança
Requisitos
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
[in] Especifica a ID de comando.
lpszTexto
[in] Especifica o rótulo de 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 classe CMFCRibbonCheckBox.
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
[in] Ponteiro para a CDC associada à caixa de seleção.
Valor de retorno
Retorna um objeto CSize que contém o tamanho compacto da caixa de seleção.
Comentários
Se não for substituído, retornará 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
[in] Ponteiro para a CDC associada a esta caixa de seleção.
Valor de retorno
Um objeto CSize que contém o tamanho intermediário da caixa de seleção.
Comentários
Se não for substituído, calculará o tamanho intermediário como o tamanho da caixa de seleção padrão ( AFX_CHECK_BOX_DEFAULT_SIZE) mais o tamanho do texto, além das margens.
CMFCRibbonCheckBox::GetRegularSize
Obtém o tamanho normal da caixa de seleção.
virtual CSize GetRegularSize(CDC* pDC);
Parâmetros
pDC
[in] Ponteiro para o objeto de CDC associado a esta caixa de seleção.
Valor de retorno
Retorna um objeto CSize que contém o tamanho normal da caixa de seleção.
Comentários
Se não for substituído, retornará 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 houver.
Comentários
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
[in] Ponteiro para a CDC no qual desenhar a caixa de seleção.
Comentários
CMFCRibbonCheckBox::OnDrawMenuImage
Chamado pela estrutura para desenhar uma imagem de menu para a caixa de seleção.
virtual BOOL OnDrawMenuImage(CDC*, CRect);
Parâmetros
[in] CDC*
Ponteiro para a CDC associada à caixa de seleção.
CRect
[in] Um objeto CRect 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.
Comentários
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
[in] Ponteiro para o contexto do dispositivo no qual desenhar a caixa de seleção.
strText
[in] O texto de exibição.
nTextOffset
[in] A distância, em pixels, do lado esquerdo da caixa de listagem até o texto de exibição.
rect
[in] O retângulo de exibição para a caixa de seleção.
bIsSelected
[in] TRUE se a caixa de seleção estiver marcada, ou FALSE se não estiver.
bHighlighted
[in] TRUE se a caixa de seleção estiver realçada; caso contrário, FALSE.
Comentários
CMFCRibbonCheckBox::SetACCData
Define os dados de acessibilidade da caixa de seleção.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parâmetros
pParent
A janela pai da caixa de seleção.
data
Os dados de acessibilidade da caixa de seleção.
Valor de retorno
Sempre retorna TRUE.
Comentários
Por padrão, esse método define os dados de acessibilidade da caixa de seleção e sempre retorna TRUE. Substitua esse método para definir os dados de acessibilidade e retornar um valor que indique êxito ou falha.