Classe CMFCRibbonEdit
Implementa un controllo di modifica che si trova su una barra multifunzione.
Sintassi
class CMFCRibbonEdit : public CMFCRibbonButton
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonEdit::CMFCRibbonEdit | Costruisce un oggetto CMFCRibbonEdit. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonEdit::CanBeStretched | Indica se l'altezza del CMFCRibbonEdit controllo può aumentare verticalmente fino all'altezza di una riga della barra multifunzione. |
| CMFCRibbonEdit::CMFCRibbonEdit | Costruisce un oggetto CMFCRibbonEdit. |
| CMFCRibbonEdit::CopyFrom | Copia lo stato dell'oggetto specificato CMFCRibbonEdit nell'oggetto corrente CMFCRibbonEdit . |
| CMFCRibbonEdit::CreateEdit | Crea una nuova casella di testo per l'oggetto CMFCRibbonEdit . |
| CMFCRibbonEdit::D estroyCtrl | Elimina definitivamente l'oggetto CMFCRibbonEdit . |
| CMFCRibbonEdit::D ropDownList | Elimina una casella di riepilogo. |
| CMFCRibbonEdit::EnableSpinButtons | Abilita e imposta l'intervallo del pulsante di selezione per la casella di testo. |
| CMFCRibbonEdit::GetCompactSize | Recupera la dimensione compatta dell'oggetto CFMCRibbonEdit . |
| CMFCRibbonEdit::GetEditText | Recupera il testo nella casella di testo. |
| CMFCRibbonEdit::GetIntermediateSize | Recupera le dimensioni intermedie dell'oggetto CMFCRibbonEdit . |
| CMFCRibbonEdit::GetTextAlign | Recupera l'allineamento del testo nella casella di testo. |
| CMFCRibbonEdit::GetWidth | Recupera la larghezza, in pixel, del CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::HasCompactMode | Indica se le dimensioni di visualizzazione per il CMFCRibbonEdit controllo possono essere compattate. |
| CMFCRibbonEdit::HasFocus | Indica se il CMFCRIbbonEdit controllo ha lo stato attivo. |
| CMFCRibbonEdit::HasLargeMode | Indica se le dimensioni di visualizzazione per il CMFCRibbonEdit controllo possono essere grandi. |
| CMFCRibbonEdit::HasSpinButtons | Indica se la casella di testo ha un pulsante di selezione. |
| CMFCRibbonEdit::IsHighlighted | Indica se il CMFCRibbonEdit controllo è evidenziato. |
| CMFCRibbonEdit::OnAfterChangeRect | Chiamato dal framework quando cambiano le dimensioni del rettangolo di visualizzazione per il CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::OnDraw | Chiamato dal framework per disegnare il CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::OnDrawLabelAndImage | Chiamato dal framework per disegnare l'etichetta e l'immagine per il CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::OnDrawOnList | Chiamato dal framework per disegnare il CMFCRibbonEdit controllo in una casella di riepilogo comandi. |
| CMFCRibbonEdit::OnEnable | Chiamato dal framework per abilitare o disabilitare il CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::OnHighlight | Chiamato dal framework quando il puntatore entra o lascia i limiti del CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::OnKey | Chiamato dal framework quando l'utente preme un suggerimento per il tasto e il CMFCRibbonEdit controllo ha lo stato attivo. |
| CMFCRibbonEdit::OnLButtonDown | Chiamato dal framework per aggiornare il CMFCRibbonEdit controllo quando l'utente preme il pulsante sinistro del mouse sul controllo. |
| CMFCRibbonEdit::OnLButtonUp | Chiamato dal framework quando l'utente rilascia il pulsante sinistro del mouse. |
| CMFCRibbonEdit::OnRTLChanged | Chiamato dal framework per aggiornare il CMFCRibbonEdit controllo quando il layout cambia direzione. |
| CMFCRibbonEdit::OnShow | Chiamato dal framework per visualizzare o nascondere il CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::Redraw | Aggiorna la visualizzazione del CMFCRibbonEdit controllo. |
| CMFCRibbonEdit::SetACCData | Imposta i dati di accessibilità per l'oggetto CMFCRibbonEdit . |
| CMFCRibbonEdit::SetEditText | Imposta il testo nella casella di testo. |
| CMFCRibbonEdit::SetTextAlign | Imposta l'allineamento del testo della casella di testo. |
| CMFCRibbonEdit::SetWidth | Imposta la larghezza della casella di testo per il CMFCRibbonEdit controllo . |
Osservazioni:
Esempio
Nell'esempio seguente viene illustrato come costruire un CMFCRibbonEdit oggetto, visualizzare i pulsanti di selezione accanto al controllo di modifica e impostare il testo del controllo di modifica. Questo frammento di codice fa parte dell'esempio demo di 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"));
Requisiti
Intestazione: afxRibbonEdit.h
CMFCRibbonEdit::CanBeStretched
Indica se l'altezza del controllo CMFCRibbonEdit può aumentare verticalmente fino all'altezza di una riga della barra multifunzione.
virtual BOOL CanBeStretched();
Valore restituito
Restituisce sempre FALSE.
Osservazioni:
CMFCRibbonEdit::CMFCRibbonEdit
Costruisce un oggetto CMFCRibbonEdit .
CMFCRibbonEdit(
UINT nID,
int nWidth,
LPCTSTR lpszLabel = NULL,
int nImage = -1);
CMFCRibbonEdit();
Parametri
nID
[in] ID comando per il CMFCRibbonEdit controllo.
nWidth
[in] Larghezza, in pixel, della casella di testo per il CMFCRibbonEdit controllo.
lpszLabel
[in] Etichetta per il CMFCRibbonEdit controllo .
nImage
[in] Indice dell'immagine piccola da usare per il CMFCRibbonEdit controllo . La raccolta di immagini di piccole dimensioni viene gestita dalla categoria della barra multifunzione padre.
Osservazioni:
Il CMFCRibbonEdit controllo non usa un'immagine di grandi dimensioni.
CMFCRibbonEdit::CopyFrom
Copia lo stato dell'oggetto CMFCRibbonEdit specificato nell'oggetto CMFCRibbonEdit corrente.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Parametri
src
[in] Oggetto di origine CMFCRibbonEdit .
Osservazioni:
Il parametro src deve essere di tipo CMFCRibbonEdit.
CMFCRibbonEdit::CreateEdit
Crea una nuova casella di testo per l'oggetto CMFCRibbonEdit .
virtual CMFCRibbonRichEditCtrl* CreateEdit(
CWnd* pWndParent,
DWORD dwEditStyle);
Parametri
pWndParent
[in] Puntatore alla finestra padre dell'oggetto CMFCRibbonEdit .
dwEditStyle
[in] Specifica lo stile della casella di testo. È possibile combinare gli stili della finestra elencati nella sezione Osservazioni con gli stili di controllo di modifica descritti in Windows SDK.
Valore restituito
Puntatore alla nuova casella di testo se il metodo ha avuto esito positivo; in caso contrario, NULL.
Osservazioni:
Eseguire l'override di questo metodo in una classe derivata per creare una casella di testo personalizzata.
È possibile applicare gli stili di finestra seguenti a una casella di testo:
WS_CHILD
WS_VISIBLE
WS_DISABLED
WS_GROUP
WS_TABSTOP
CMFCRibbonEdit::D estroyCtrl
Elimina definitivamente l'oggetto CMFCRibbonEdit .
virtual void DestroyCtrl();
Osservazioni:
CMFCRibbonEdit::D ropDownList
Elimina una casella di riepilogo.
virtual void DropDownList();
Osservazioni:
Per impostazione predefinita, questo metodo non esegue alcuna operazione. Eseguire l'override di questo metodo per visualizzare una casella di riepilogo.
CMFCRibbonEdit::EnableSpinButtons
Abilita e imposta l'intervallo del pulsante di selezione per la casella di testo.
void EnableSpinButtons(
int nMin,
int nMax);
Parametri
nMin
[in] Valore minimo del pulsante di selezione.
nMax
[in] Valore massimo del pulsante di selezione.
Osservazioni:
I pulsanti di selezione visualizzano una freccia su e giù e consentono agli utenti di spostarsi attraverso un set fisso di valori.
CMFCRibbonEdit::GetCompactSize
Recupera le dimensioni compatta dell'oggetto CMFCRibbonEdit .
virtual CSize GetCompactSize(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per l'oggetto CMFCRibbonEdit .
Valore restituito
Dimensione compatta dell'oggetto CMFCRibbonEdit .
Osservazioni:
CMFCRibbonEdit::GetEditText
Recupera il testo nella casella di testo.
CString GetEditText() const;
Valore restituito
Testo nella casella di testo.
Osservazioni:
CMFCRibbonEdit::GetIntermediateSize
Recupera le dimensioni intermedie dell'oggetto CMFCRibbonEdit .
virtual CSize GetIntermediateSize(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per l'oggetto CMFCRibbonEdit .
Valore restituito
Dimensione intermedia dell'oggetto CMFCRibbonEdit .
Osservazioni:
CMFCRibbonEdit::GetTextAlign
Recupera l'allineamento del testo nella casella di testo.
int GetTextAlign() const;
Valore restituito
Valore enumerato per l'allineamento del testo. Per i valori possibili, vedere la sezione Osservazioni.
Osservazioni:
Il valore restituito è uno degli stili di controllo di modifica seguenti:
ES_LEFT per l'allineamento a sinistra
ES_CENTER per l'allineamento al centro
ES_RIGHT per l'allineamento a destra
Per altre informazioni su questi stili, vedere Modificare gli stili di controllo.
CMFCRibbonEdit::GetWidth
Recupera la larghezza, in pixel, del controllo CMFCRibbonEdit .
int GetWidth(BOOL bInFloatyMode = FALSE) const;
Parametri
bInFloatyMode
[in] TRUE se il CMFCRibbonEdit controllo è in modalità mobile; in caso contrario, FALSE.
Valore restituito
Larghezza, in pixel, del CMFCRibbonEdit controllo.
Osservazioni:
CMFCRibbonEdit::HasCompactMode
Indica se le dimensioni di visualizzazione per il controllo CMFCRibbonEdit possono essere compattate.
virtual BOOL HasCompactMode() const;
Valore restituito
Restituisce sempre TRUE.
Osservazioni:
Per impostazione predefinita, questo metodo restituisce sempre TRUE. Eseguire l'override di questo metodo per indicare se le dimensioni dello schermo possono essere compattate.
CMFCRibbonEdit::HasFocus
Indica se il controllo CMFCRibbonEdit ha lo stato attivo.
virtual BOOL HasFocus() const;
Valore restituito
TRUE se il CMFCRibbonEdit controllo ha lo stato attivo; in caso contrario, FALSE.
Osservazioni:
CMFCRibbonEdit::HasLargeMode
Indica se le dimensioni di visualizzazione per il controllo CMFCRibbonEdit possono essere grandi.
virtual BOOL HasLargeMode() const;
Valore restituito
Restituisce sempre FALSE.
Osservazioni:
Per impostazione predefinita, questo metodo restituisce sempre FALSE. Eseguire l'override di questo metodo per indicare se le dimensioni della visualizzazione possono essere grandi.
CMFCRibbonEdit::HasSpinButtons
Indica se la casella di testo ha un pulsante di selezione.
virtual BOOL HasSpinButtons() const;
Valore restituito
TRUE se la casella di testo ha un pulsante di selezione; in caso contrario FALSE.
Osservazioni:
CMFCRibbonEdit::IsHighlighted
Indica se il controllo CMFCRibbonEdit è evidenziato.
virtual BOOL IsHighlighted() const;
Valore restituito
TRUE se il CMFCRibbonEdit controllo è evidenziato; in caso contrario, FALSE.
Osservazioni:
CMFCRibbonEdit::OnAfterChangeRect
Chiamato dal framework quando cambiano le dimensioni del rettangolo di visualizzazione per il controllo CMFCRibbonEdit .
virtual void OnAfterChangeRect(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per il CMFCRibbonEdit controllo.
Osservazioni:
CMFCRibbonEdit::OnDraw
Chiamato dal framework per disegnare il controllo CMFCRibbonEdit .
virtual void OnDraw(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per il CMFCRibbonEdit controllo.
Osservazioni:
CMFCRibbonEdit::OnDrawLabelAndImage
Chiamato dal framework per disegnare l'etichetta e l'immagine per il controllo CMFCRibbonEdit .
virtual void OnDrawLabelAndImage(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per il CMFCRibbonEdit controllo.
Osservazioni:
CMFCRibbonEdit::OnDrawOnList
Chiamato dal framework per disegnare il controllo CMFCRibbonEdit in una casella di riepilogo comandi.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per il CMFCRibbonEdit controllo.
strText
[in] Testo visualizzato.
nTextOffset
[in] Distanza, in pixel, dal lato sinistro della casella di riepilogo al testo visualizzato.
rect
[in] Rettangolo di visualizzazione per il CMFCRibbonEdit controllo.
bIsSelected
[in] Questo parametro non viene usato.
bHighlighted
[in] Questo parametro non viene usato.
Osservazioni:
Nella casella di riepilogo comandi vengono visualizzati i controlli della barra multifunzione per consentire agli utenti di personalizzare la barra degli strumenti di accesso rapido.
CMFCRibbonEdit::OnEnable
Chiamato dal framework per abilitare o disabilitare il controllo CMFCRibbonEdit .
virtual void OnEnable(BOOL bEnable);
Parametri
bEnable
[in] TRUE per abilitare il controllo; FALSE per disabilitare il controllo.
Osservazioni:
CMFCRibbonEdit::OnHighlight
Chiamato dal framework quando il puntatore entra o lascia i limiti del controllo CMFCRibbonEdit .
virtual void OnHighlight(BOOL bHighlight);
Parametri
bHighlight
[in] TRUE se il puntatore si trova nei limiti del CMFCRibbonEdit controllo; in caso contrario, FALSE.
Osservazioni:
CMFCRibbonEdit::OnKey
Chiamato dal framework quando l'utente preme una descrizione dei tasti e il controllo CMFCRibbonEdit ha lo stato attivo.
virtual BOOL OnKey(BOOL bIsMenuKey);
Parametri
bIsMenuKey
[in] TRUE se il suggerimento del tasto viene visualizzato un menu a comparsa; in caso contrario, FALSE.
Valore restituito
TRUE se l'evento è stato gestito; in caso contrario, FALSE.
Osservazioni:
CMFCRibbonEdit::OnLButtonDown
Chiamato dal framework per aggiornare il controllo CMFCRibbonEdit quando l'utente preme il pulsante sinistro del mouse sul controllo.
virtual void OnLButtonDown(CPoint point);
Parametri
point
[in] Questo parametro non viene usato.
Osservazioni:
CMFCRibbonEdit::OnLButtonUp
Chiamato dal framework quando l'utente rilascia il pulsante sinistro del mouse.
virtual void OnLButtonUp(CPoint point);
Parametri
point
[in] Questo parametro non viene usato.
Osservazioni:
CMFCRibbonEdit::OnRTLChanged
Chiamato dal framework per aggiornare il controllo CMFCRibbonEdit quando il layout cambia direzione.
virtual void OnRTLChanged(BOOL bIsRTL);
Parametri
bIsRTL
[in] TRUE se il layout è da destra a sinistra; FALSE se il layout è da sinistra a destra.
Osservazioni:
CMFCRibbonEdit::OnShow
Chiamato dal framework per visualizzare o nascondere il controllo CMFCRibbonEdit .
virtual void OnShow(BOOL bShow);
Parametri
bShow
[in] TRUE per mostrare il controllo; FALSE per nascondere il controllo.
Osservazioni:
CMFCRibbonEdit::Redraw
Aggiorna la visualizzazione del controllo CMFCRibbonEdit .
virtual void Redraw();
Osservazioni:
Questo metodo ridisegna il rettangolo di visualizzazione per l'oggetto CMFCRibbonEdit chiamando indirettamente CWnd::RedrawWindow con i flag RDW_INVALIDATE, RDW_ERASE e RDW_UPDATENOW impostati.
CMFCRibbonEdit::SetACCData
Imposta i dati di accessibilità per l'oggetto CMFCRibbonEdit .
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parametri
pParent
Puntatore alla finestra padre per l'oggetto CMFCRibbonEdit .
data
Dati di accessibilità per l'oggetto CMFCRibbonEdit .
Valore restituito
Restituisce sempre TRUE.
Osservazioni:
CMFCRibbonEdit::SetEditText
Imposta il testo nella casella di testo.
void SetEditText(CString strText);
Parametri
strText
[in] Testo per la casella di testo.
CMFCRibbonEdit::SetTextAlign
Imposta l'allineamento del testo della casella di testo.
void SetTextAlign(int nAlign);
Parametri
nAlign
[in] Valore enumerato per l'allineamento del testo. Per i valori possibili, vedere la sezione Osservazioni.
Osservazioni:
Il parametro nAlign è uno degli stili di controllo di modifica seguenti:
ES_LEFT per l'allineamento a sinistra
ES_CENTER per l'allineamento al centro
ES_RIGHT per l'allineamento a destra
Per altre informazioni su questi stili, vedere Modificare gli stili di controllo.
CMFCRibbonEdit::SetWidth
Imposta la larghezza della casella di testo per il controllo CMFCRibbonEdit .
void SetWidth(
int nWidth,
BOOL bInFloatyMode = FALSE);
Parametri
nWidth
[in] Larghezza, in pixel, della casella di testo.
bInFloatyMode
TRUE per impostare la larghezza per la modalità mobile; FALSE per impostare la larghezza per la modalità regolare.
Osservazioni:
Il CMFCRibbonEdit controllo ha due larghezze a seconda della modalità di visualizzazione: modalità mobile e modalità regolare.
Vedi anche
Grafico della gerarchia
Classi
Classe CMFCRibbonButton
Classe CMFCRibbonBar