Classe CMFCRibbonEdit

Implementa um controlo de edição localizado numa barra de fita.

Sintaxe

class CMFCRibbonEdit : public CMFCRibbonButton

Membros

Construtores Públicos

Métodos Públicos

Observações

Example

O exemplo seguinte demonstra como construir um CMFCRibbonEdit objeto, mostrar botões de giro ao lado do controlo de edição e definir o texto do controlo de edição. Este excerto de código faz parte do exemplo de demonstração do MS Office 2007.

CMFCRibbonEdit *pEditIndentLeft = new CMFCRibbonEdit(ID_PAGELAYOUT_INDENT_LEFT, 72, _T("Left:\nil"), 13);
// specify the min and max value of the spin button control
pEditIndentLeft->EnableSpinButtons(0, 1000);
// set the text of the edit control
pEditIndentLeft->SetEditText(_T("0"));

Requerimentos

Cabeçalho: afxRibbonEdit.h

CMFCRibbonEdit::PodeSer Esticado

Indica se a altura do controlo CMFCRibbonEdit pode aumentar verticalmente até à altura de uma fila de fita.

virtual BOOL CanBeStretched();

Valor de retorno

Sempre devolve FALSE.

Observações

CMFCRibbonEdit::CMFCRibbonEdit

Constrói um objeto CMFCRibbonEdit .

CMFCRibbonEdit(
    UINT nID,
    int nWidth,
    LPCTSTR lpszLabel = NULL,
    int nImage = -1);

CMFCRibbonEdit();

Parâmetros

nID
[dentro] ID de comando para o CMFCRibbonEdit controlo.

nLargura
[dentro] A largura, em pixels, da caixa de texto do CMFCRibbonEdit controlo.

lpszLabel
[dentro] O rótulo para o CMFCRibbonEdit controlo.

nImagem
[dentro] Índice da imagem pequena para usar no CMFCRibbonEdit controlo. A coleção de pequenas imagens é mantida pela categoria de fita principal.

Observações

O CMFCRibbonEdit controlo não utiliza uma imagem grande.

CMFCRibbonEdit::CopyFrom

Copia o estado do objeto CMFCRibbonEdit especificado para o objeto CMFCRibbonEdit atual.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parâmetros

src
[dentro] O objeto de origem CMFCRibbonEdit .

Observações

O parâmetro src deve ser do tipo CMFCRibbonEdit.

CMFCRibbonEdit::CreateEdit

Cria uma nova caixa de texto para o objeto CMFCRibbonEdit .

virtual CMFCRibbonRichEditCtrl* CreateEdit(
    CWnd* pWndParent,
    DWORD dwEditStyle);

Parâmetros

pWndParent
[dentro] Um apontador para a janela mãe do CMFCRibbonEdit objeto.

dwEditStyle
[dentro] Especifica o estilo da caixa de texto. Pode combinar os estilos de janela listados na secção Observações com os estilos de controlo de edição que são descritos no SDK do Windows.

Valor de retorno

Um apontador para a nova caixa de texto se o método tivesse sido bem-sucedido; caso contrário, NULL.

Observações

Substitua este método numa classe derivada para criar uma caixa de texto personalizada.

Pode aplicar os seguintes Estilos de Janela a uma caixa de texto:

• WS_CHILD

• WS_VISIBLE

• WS_DISABLED

• WS_GROUP

• WS_TABSTOP

CMFCRibbonEdit::D estroyCtrl

Destrói o objeto CMFCRibbonEdit .

virtual void DestroyCtrl();

Observações

CMFCRibbonEdit::D ropDownList

Abre uma caixa de lista.

virtual void DropDownList();

Observações

Por defeito, este método não faz nada. Anule este método para colocar uma caixa de lista.

CMFCRibbonEdit::EnableSpinButtons

Ativa e define o alcance do botão de giro para a caixa de texto.

void EnableSpinButtons(
    int nMin,
    int nMax);

Parâmetros

nMin
[dentro] O valor mínimo do botão de rodar.

nMax
[dentro] O valor máximo do botão de giro.

Observações

Os botões de giro exibem uma seta para cima e para baixo e permitem aos utilizadores mover-se por um conjunto fixo de valores.

CMFCRibbonEdit::GetCompactSize

Recupera o tamanho compacto do objeto CMFCRibbonEdit .

virtual CSize GetCompactSize(CDC* pDC);

Parâmetros

pDC
[dentro] Apontar para um contexto de dispositivo para o CMFCRibbonEdit objeto.

Valor de retorno

O tamanho compacto do CMFCRibbonEdit objeto.

Observações

CMFCRibbonEdit::GetEditText

Recupera o texto na caixa de texto.

CString GetEditText() const;

Valor de retorno

O texto na caixa de texto.

Observações

CMFCRibbonEdit::GetIntermediateSize

Recupera o tamanho intermédio do objeto CMFCRibbonEdit .

virtual CSize GetIntermediateSize(CDC* pDC);

Parâmetros

pDC
[dentro] Apontar para um contexto de dispositivo para o CMFCRibbonEdit objeto.

Valor de retorno

O tamanho intermédio do CMFCRibbonEdit objeto.

Observações

CMFCRibbonEdit::GetTextAlign

Recupera o alinhamento do texto na caixa de texto.

int GetTextAlign() const;

Valor de retorno

Um valor enumerado de alinhamento de texto. Consulte a secção de Observações para possíveis valores.

Observações

O valor devolvido é um dos seguintes estilos de controlo de edição:

• ES_LEFT para alinhamento à esquerda

• ES_CENTER para o alinhamento central

• ES_RIGHT para alinhamento à direita

Para mais informações sobre estes estilos, veja Editar Estilos de Controlo.

CMFCRibbonEdit::GetWidth

Recupera a largura, em pixels, do controlo CMFCRibbonEdit .

int GetWidth(BOOL bInFloatyMode = FALSE) const;

Parâmetros

bInFloatyMode
[dentro] TRUE se o CMFCRibbonEdit controlo estiver em modo flutuante; caso contrário, FALSE.

Valor de retorno

A largura, em pixels, do CMFCRibbonEdit controlo.

Observações

CMFCRibbonEdit::HasCompactMode

Indica se o tamanho do ecrã do controlo CMFCRibbonEdit pode ser compacto.

virtual BOOL HasCompactMode() const;

Valor de retorno

Retorna sempre VERDADEIRO.

Observações

Por defeito, este método devolve sempre TRUE. Substitua este método para indicar se o tamanho do ecrã pode ser compacto.

CMFCRibbonEdit::HasFocus

Indica se o controlo CMFCRibbonEdit tem o foco.

virtual BOOL HasFocus() const;

Valor de retorno

VERDADEIRO se o controlo CMFCRibbonEdit tiver o foco; caso contrário FALSO.

Observações

CMFCRibbonEdit::HasLargeMode

Indica se o tamanho do ecrã para o controlo CMFCRibbonEdit pode ser grande.

virtual BOOL HasLargeMode() const;

Valor de retorno

Sempre devolve FALSE.

Observações

Por defeito, este método devolve sempre FALSE. Substitua este método para indicar se o tamanho do ecrã pode ser grande.

CMFCRibbonEdit::HasSpinButtons

Indica se a caixa de texto tem um botão de rodar.

virtual BOOL HasSpinButtons() const;

Valor de retorno

TRUE se a caixa de texto tiver um botão de rodar; caso contrário, FALSO.

Observações

CMFCRibbonEdit::ÉDestacado

Indica se o controlo CMFCRibbonEdit está destacado.

virtual BOOL IsHighlighted() const;

Valor de retorno

VERDADEIRO se o CMFCRibbonEdit controlo estiver destacado; caso contrário FALSO.

Observações

CMFCRibbonEdit::OnAfterChangeRect

Chamado pelo framework quando as dimensões do retângulo do ecrã para o controlo CMFCRibbonEdit mudam.

virtual void OnAfterChangeRect(CDC* pDC);

Parâmetros

pDC
[dentro] Aponta para o contexto do dispositivo para o CMFCRibbonEdit controlo.

Observações

CMFCRibbonEdit::OnDraw

Chamado pelo framework para desenhar o controlo CMFCRibbonEdit .

virtual void OnDraw(CDC* pDC);

Parâmetros

pDC
[dentro] Aponta para o contexto do dispositivo para o CMFCRibbonEdit controlo.

Observações

CMFCRibbonEdit::OnDrawLabelAndImage

Chamado pelo framework para desenhar o rótulo e a imagem para o controlo CMFCRibbonEdit .

virtual void OnDrawLabelAndImage(CDC* pDC);

Parâmetros

pDC
[dentro] Aponta para o contexto do dispositivo para o CMFCRibbonEdit controlo.

Observações

CMFCRibbonEdit::OnDrawOnList

Chamado pela framework para desenhar o controlo CMFCRibbonEdit numa caixa de lista de comandos.

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

Parâmetros

pDC
[dentro] Aponta para o contexto do dispositivo para o CMFCRibbonEdit controlo.

strText
[dentro] O texto do ecrã.

nTextOffset
[dentro] Distância, em pixels, do lado esquerdo da caixa de lista até ao texto de visualização.

retângulo
[dentro] O retângulo do ecrã para o CMFCRibbonEdit controlo.

bIsSelected
[dentro] Este parâmetro não é utilizado.

bDestacado
[dentro] Este parâmetro não é utilizado.

Observações

A caixa da lista de comandos mostra controlos em fita para permitir que os utilizadores personalizem a barra de ferramentas de acesso rápido.

CMFCRibbonEdit::OnEnable

Chamado pelo framework para ativar ou desativar o controlo CMFCRibbonEdit .

virtual void OnEnable(BOOL bEnable);

Parâmetros

bEnable
[dentro] TRUE para permitir o controlo; FALSE para desativar o controlo.

Observações

CMFCRibbonEdit::OnHighlight

Chamado pela framework quando o ponteiro entra ou sai dos limites do controlo CMFCRibbonEdit .

virtual void OnHighlight(BOOL bHighlight);

Parâmetros

bDestaques
[dentro] TRUE se o ponteiro estiver dentro dos limites do CMFCRibbonEdit controlo; caso contrário, FALSE.

Observações

CMFCRibbonEdit::OnKey

É chamado pela framework quando o utilizador pressiona uma dica e o controlo CMFCRibbonEdit tem o foco.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parâmetros

bIsMenuKey
[dentro] TRUE se a dica da tecla mostrar um menu pop-up; caso contrário, FALSO.

Valor de retorno

TRUE se o evento foi tratado; caso contrário, FALSO.

Observações

CMFCRibbonEdit::OnLButtonDown

Chamado pela framework para atualizar o controlo CMFCRibbonEdit quando o utilizador pressiona o botão esquerdo do rato no controlo.

virtual void OnLButtonDown(CPoint point);

Parâmetros

ponto
[dentro] Este parâmetro não é utilizado.

Observações

CMFCRibbonEdit::OnLButtonUp

Chamada pela framework quando o utilizador solta o botão esquerdo do rato.

virtual void OnLButtonUp(CPoint point);

Parâmetros

ponto
[dentro] Este parâmetro não é utilizado.

Observações

CMFCRibbonEdit::OnRTLCmudado

Chamado pelo framework para atualizar o controlo CMFCRibbonEdit quando o layout muda de direção.

virtual void OnRTLChanged(BOOL bIsRTL);

Parâmetros

bIsRTL
[dentro] TRUE se o layout for da direita para a esquerda; FALSE se o layout for da esquerda para a direita.

Observações

CMFCRibbonEdit::OnShow

Chamado pelo framework para mostrar ou ocultar o controlo CMFCRibbonEdit .

virtual void OnShow(BOOL bShow);

Parâmetros

bShow
[dentro] VERDADEIRO para mostrar o controlo; FALSE para esconder o controlo.

Observações

CMFCRibbonEdit::Redesenhar

Atualiza o ecrã do controlo CMFCRibbonEdit .

virtual void Redraw();

Observações

Este método redesenha o retângulo de exibição do CMFCRibbonEdit objeto chamando indiretamente CWnd::RedrawWindow com as flags RDW_INVALIDATE, RDW_ERASE e RDW_UPDATENOW definidas.

CMFCRibbonEdit::SetACCData

Define os dados de acessibilidade para o objeto CMFCRibbonEdit .

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

Parâmetros

pParent
Apontar para a janela pai do CMFCRibbonEdit objeto.

Dados
Os dados de acessibilidade do CMFCRibbonEdit objeto.

Valor de retorno

Retorna sempre VERDADEIRO.

Observações

CMFCRibbonEdit::SetEditText

Define o texto na caixa de texto.

void SetEditText(CString strText);

Parâmetros

strText
[dentro] O texto para a caixa de texto.

CMFCRibbonEdit::SetTextAlign

Define o alinhamento do texto da caixa de texto.

void SetTextAlign(int nAlign);

Parâmetros

nAlign
[dentro] Um valor enumerado de alinhamento de texto. Consulte a secção de Observações para possíveis valores.

Observações

O parâmetro nAlign é um dos seguintes estilos de controlo de edição:

• ES_LEFT para alinhamento à esquerda

• ES_CENTER para o alinhamento central

• ES_RIGHT para alinhamento à direita

Para mais informações sobre estes estilos, veja Editar Estilos de Controlo.

CMFCRibbonEdit::SetWidth

Define a largura da caixa de texto para o controlo CMFCRibbonEdit .

void SetWidth(
    int nWidth,
    BOOL bInFloatyMode = FALSE);

Parâmetros

nLargura
[dentro] A largura, em pixels, da caixa de texto.

bInFloatyMode
TRUE para definir a largura do modo flutuante; FALSE para definir a largura para o modo normal.

Observações

O CMFCRibbonEdit controlo tem duas larguras dependendo do modo de visualização: modo flutuante e modo normal.

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCRibbonButton
Classe CMFCRibbonBar