CMFCRibbonEdit 類別
實作位於功能區列上的編輯控制項。
語法
class CMFCRibbonEdit : public CMFCRibbonButton
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| CMFCRibbonEdit：：CMFCRibbonEdit | 建構 CMFCRibbonEdit 物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CMFCRibbonEdit：：CanBeStretched | 指出控制項的高度 CMFCRibbonEdit 是否可以垂直增加至功能區列的高度。 |
| CMFCRibbonEdit：：CMFCRibbonEdit | 建構 CMFCRibbonEdit 物件。 |
| CMFCRibbonEdit：：CopyFrom | 將指定 CMFCRibbonEdit 物件的狀態複製到目前的 CMFCRibbonEdit 物件。 |
| CMFCRibbonEdit：：CreateEdit | 建立 物件的新文字方塊 CMFCRibbonEdit 。 |
| CMFCRibbonEdit：:D estroyCtrl | CMFCRibbonEdit終結 物件。 |
| CMFCRibbonEdit：:D ropDownList | 下拉式清單方塊。 |
| CMFCRibbonEdit：：EnableSpinButtons | 啟用及設定文字方塊的微調按鈕範圍。 |
| CMFCRibbonEdit：：GetCompactSize | 擷取 物件的精簡大小 CFMCRibbonEdit 。 |
| CMFCRibbonEdit：：GetEditText | 擷取文字方塊中的文字。 |
| CMFCRibbonEdit：：GetIntermediateSize | 擷取 物件的中繼大小 CMFCRibbonEdit 。 |
| CMFCRibbonEdit：：GetTextAlign | 擷取文字方塊中文字的對齊方式。 |
| CMFCRibbonEdit：：GetWidth | 擷取控制項的 CMFCRibbonEdit 寬度，以圖元為單位。 |
| CMFCRibbonEdit：：HasCompactMode | 指出控制項的 CMFCRibbonEdit 顯示大小是否可以壓縮。 |
| CMFCRibbonEdit：：HasFocus | 指出控制項是否 CMFCRIbbonEdit 具有焦點。 |
| CMFCRibbonEdit：：HasLargeMode | 指出控制項的 CMFCRibbonEdit 顯示大小是否可以很大。 |
| CMFCRibbonEdit：：HasSpinButtons | 指出文字方塊是否有微調按鈕。 |
| CMFCRibbonEdit：：IsHighlighted | 指出控制項是否 CMFCRibbonEdit 反白顯示。 |
| CMFCRibbonEdit：：OnAfterChangeRect | 當控制項顯示矩形的維度變更時，由架構呼叫 CMFCRibbonEdit 。 |
| CMFCRibbonEdit：：OnDraw | 由架構呼叫以繪製 CMFCRibbonEdit 控制項。 |
| CMFCRibbonEdit：：OnDrawLabelAndImage | 由架構呼叫，以繪製控制項的 CMFCRibbonEdit 標籤和影像。 |
| CMFCRibbonEdit：：OnDrawOnList | 由架構呼叫，以在命令清單方塊中繪製 CMFCRibbonEdit 控制項。 |
| CMFCRibbonEdit：：OnEnable | 由架構呼叫以啟用或停用 CMFCRibbonEdit 控制項。 |
| CMFCRibbonEdit：：OnHighlight | 當指標進入或離開控制項界限 CMFCRibbonEdit 時，由架構呼叫。 |
| CMFCRibbonEdit：：OnKey | 當使用者按下按鍵提示且 CMFCRibbonEdit 控制項具有焦點時，由架構呼叫。 |
| CMFCRibbonEdit：：OnLButtonDown | 由架構呼叫，當使用者按下控制項上的滑鼠左鍵時，更新 CMFCRibbonEdit 控制項。 |
| CMFCRibbonEdit：：OnLButtonUp | 當使用者放開滑鼠左鍵時，由架構呼叫。 |
| CMFCRibbonEdit：：OnRTLChanged | 架構呼叫，以在版面配置變更方向時更新 CMFCRibbonEdit 控制項。 |
| CMFCRibbonEdit：：OnShow | 由架構呼叫以顯示或隱藏 CMFCRibbonEdit 控制項。 |
| CMFCRibbonEdit：：Redraw | 更新控制項的 CMFCRibbonEdit 顯示。 |
| CMFCRibbonEdit：：SetACCData | 設定 物件的協助工具資料 CMFCRibbonEdit 。 |
| CMFCRibbonEdit：：SetEditText | 設定文字方塊中的文字。 |
| CMFCRibbonEdit：：SetTextAlign | 設定文字方塊的文字對齊方式。 |
| CMFCRibbonEdit：：SetWidth | 設定控制項文字方塊 CMFCRibbonEdit 的寬度。 |
備註
範例
下列範例示範如何建構 CMFCRibbonEdit 物件、顯示編輯控制項旁的微調按鈕，以及設定編輯控制項的文字。 此程式碼片段是 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"));
需求
標頭： afxRibbonEdit.h
CMFCRibbonEdit：：CanBeStretched
指出 CMFCRibbonEdit 控制項的高度 是否可以垂直增加至功能區列的高度。
virtual BOOL CanBeStretched();
傳回值
一律會傳回 FALSE。
備註
CMFCRibbonEdit：：CMFCRibbonEdit
CMFCRibbonEdit(
UINT nID,
int nWidth,
LPCTSTR lpszLabel = NULL,
int nImage = -1);
CMFCRibbonEdit();
參數
nID
[in]控制項的 CMFCRibbonEdit 命令識別碼。
nWidth
[in]控制項文字方塊 CMFCRibbonEdit 的寬度，以圖元為單位。
lpszLabel
[in]控制項的 CMFCRibbonEdit 標籤。
nImage
[in]要用於控制項之小型影像的 CMFCRibbonEdit 索引。 小型影像的集合是由父功能區類別所維護。
備註
控制項 CMFCRibbonEdit 不會使用大型影像。
CMFCRibbonEdit：：CopyFrom
將指定 CMFCRibbonEdit 物件的狀態複製到目前的 CMFCRibbonEdit 物件。
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
參數
src
[in]來源 CMFCRibbonEdit 物件。
備註
src 參數的類型必須是 CMFCRibbonEdit 。
CMFCRibbonEdit：：CreateEdit
建立 CMFCRibbonEdit 物件的新文字方塊 。
virtual CMFCRibbonRichEditCtrl* CreateEdit(
CWnd* pWndParent,
DWORD dwEditStyle);
參數
pWndParent
[in]物件的父視窗 CMFCRibbonEdit 指標。
dwEditStyle
[in]指定文字方塊的樣式。 您可以將[備註] 區段中所列的視窗樣式與 Windows SDK 中所述的編輯控制項樣式 結合。
傳回值
如果方法成功，則為新文字方塊的指標;否則為 Null。
備註
覆寫衍生類別中的這個方法，以建立自訂文字方塊。
您可以將下列 視窗樣式 套用至文字方塊：
WS_CHILD
WS_VISIBLE
WS_DISABLED
WS_GROUP
WS_TABSTOP
CMFCRibbonEdit：:D estroyCtrl
virtual void DestroyCtrl();
備註
CMFCRibbonEdit：:D ropDownList
下拉式清單方塊。
virtual void DropDownList();
備註
根據預設，此方法不會執行任何動作。 覆寫此方法以下拉式清單方塊。
CMFCRibbonEdit：：EnableSpinButtons
啟用及設定文字方塊的微調按鈕範圍。
void EnableSpinButtons(
int nMin,
int nMax);
參數
nMin
[in]微調按鈕的最小值。
nMax
[in]微調按鈕的最大值。
備註
微調按鈕會顯示向上和向下箭號，讓使用者能夠移動一組固定的值。
CMFCRibbonEdit：：GetCompactSize
擷取 CMFCRibbonEdit 物件的精簡大小 。
virtual CSize GetCompactSize(CDC* pDC);
參數
pDC
[in]物件的裝置內容的 CMFCRibbonEdit 指標。
傳回值
物件的精簡大小 CMFCRibbonEdit 。
備註
CMFCRibbonEdit：：GetEditText
擷取文字方塊中的文字。
CString GetEditText() const;
傳回值
文字方塊中的文字。
備註
CMFCRibbonEdit：：GetIntermediateSize
擷取 CMFCRibbonEdit 物件的中繼大小 。
virtual CSize GetIntermediateSize(CDC* pDC);
參數
pDC
[in]物件的裝置內容的 CMFCRibbonEdit 指標。
傳回值
物件的中繼大小 CMFCRibbonEdit 。
備註
CMFCRibbonEdit：：GetTextAlign
擷取文字方塊中文字的對齊方式。
int GetTextAlign() const;
傳回值
文字對齊列舉值。 如需可能的值，請參閱一節。
備註
傳回的值是下列其中一個編輯控制項樣式：
左對齊的 ES_LEFT
置中對齊的ES_CENTER
正確對齊的ES_RIGHT
如需這些樣式的詳細資訊，請參閱 編輯控制項樣式 。
CMFCRibbonEdit：：GetWidth
擷取 CMFCRibbonEdit 控制項的 寬度，以圖元為單位。
int GetWidth(BOOL bInFloatyMode = FALSE) const;
參數
bInFloatyMode
[in]如果 CMFCRibbonEdit 控制項處於浮動模式，則為 TRUE，否則為 FALSE。
傳回值
控制項的 CMFCRibbonEdit 寬度，以圖元為單位。
備註
CMFCRibbonEdit：：HasCompactMode
指出 CMFCRibbonEdit 控制項的 顯示大小是否可以壓縮。
virtual BOOL HasCompactMode() const;
傳回值
一律會傳回 TRUE。
備註
根據預設，此方法一律會傳回 TRUE。 覆寫這個方法，指出是否可以壓縮顯示大小。
CMFCRibbonEdit：：HasFocus
指出 CMFCRibbonEdit 控制項是否 具有焦點。
virtual BOOL HasFocus() const;
傳回值
如果 CMFCRibbonEdit 控制項有焦點，則為 TRUE;否則為 FALSE。
備註
CMFCRibbonEdit：：HasLargeMode
指出 CMFCRibbonEdit 控制項的 顯示大小是否很大。
virtual BOOL HasLargeMode() const;
傳回值
一律會傳回 FALSE。
備註
根據預設，此方法一律會傳回 FALSE。 覆寫這個方法，以指出顯示大小是否可以很大。
CMFCRibbonEdit：：HasSpinButtons
指出文字方塊是否有微調按鈕。
virtual BOOL HasSpinButtons() const;
傳回值
如果文字方塊有微調按鈕，則為 TRUE;否則為 FALSE。
備註
CMFCRibbonEdit：：IsHighlighted
指出是否 反白顯示 CMFCRibbonEdit 控制項。
virtual BOOL IsHighlighted() const;
傳回值
如果已反白顯示控制項， CMFCRibbonEdit 則為 TRUE;否則為 FALSE。
備註
CMFCRibbonEdit：：OnAfterChangeRect
當 CMFCRibbonEdit 控制項的顯示矩形維度變更時，由架構呼叫 。
virtual void OnAfterChangeRect(CDC* pDC);
參數
pDC
[in]控制項之裝置內容的 CMFCRibbonEdit 指標。
備註
CMFCRibbonEdit：：OnDraw
由架構呼叫以繪製 CMFCRibbonEdit 控制項。
virtual void OnDraw(CDC* pDC);
參數
pDC
[in]控制項之裝置內容的 CMFCRibbonEdit 指標。
備註
CMFCRibbonEdit：：OnDrawLabelAndImage
由架構呼叫，以繪製 CMFCRibbonEdit 控制項的 標籤和影像。
virtual void OnDrawLabelAndImage(CDC* pDC);
參數
pDC
[in]控制項之裝置內容的 CMFCRibbonEdit 指標。
備註
CMFCRibbonEdit：：OnDrawOnList
由架構呼叫，以在命令清單方塊中繪製 CMFCRibbonEdit 控制項。
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
參數
pDC
[in]控制項之裝置內容的 CMFCRibbonEdit 指標。
strText
[in]顯示文字。
nTextOffset
[in]從清單方塊左側到顯示文字的距離，以圖元為單位。
矩形
[in]控制項的 CMFCRibbonEdit 顯示矩形。
bIsSelected
[in]不使用此參數。
bHighlighted
[in]不使用此參數。
備註
命令清單方塊會顯示功能區控制項，讓使用者自訂快速存取工具列。
CMFCRibbonEdit：：OnEnable
由架構呼叫以啟用或停用 CMFCRibbonEdit 控制項。
virtual void OnEnable(BOOL bEnable);
參數
bEnable
[in]TRUE 可啟用控制項;FALSE 可停用控制項。
備註
CMFCRibbonEdit：：OnHighlight
當指標進入或離開 CMFCRibbonEdit 控制項的界限 時，由架構呼叫。
virtual void OnHighlight(BOOL bHighlight);
參數
bHighlight
[in]如果指標位於控制項的 CMFCRibbonEdit 界限，則為 TRUE，否則為 FALSE。
備註
CMFCRibbonEdit：：OnKey
當使用者按下按鍵提示且 CMFCRibbonEdit 控制項具有焦點時，由架構呼叫。
virtual BOOL OnKey(BOOL bIsMenuKey);
參數
bIsMenuKey
[in]如果按鍵提示顯示快顯功能表，則為 TRUE;否則為 FALSE。
傳回值
如果已處理事件，則為 TRUE;否則為 FALSE。
備註
CMFCRibbonEdit：：OnLButtonDown
由架構呼叫，當使用者按下控制項上的滑鼠左鍵時， 更新 CMFCRibbonEdit 控制項。
virtual void OnLButtonDown(CPoint point);
參數
點
[in]不使用此參數。
備註
CMFCRibbonEdit：：OnLButtonUp
當使用者放開滑鼠左鍵時，由架構呼叫。
virtual void OnLButtonUp(CPoint point);
參數
點
[in]不使用此參數。
備註
CMFCRibbonEdit：：OnRTLChanged
架構呼叫，以在版面配置變更方向時更新 CMFCRibbonEdit 控制項。
virtual void OnRTLChanged(BOOL bIsRTL);
參數
bIsRTL
[in]如果版面配置由右至左則為 TRUE;如果版面配置由左至右，則為 FALSE。
備註
CMFCRibbonEdit：：OnShow
由架構呼叫以顯示或隱藏 CMFCRibbonEdit 控制項。
virtual void OnShow(BOOL bShow);
參數
bShow
[in]TRUE 可顯示控制項;FALSE 可隱藏控制項。
備註
CMFCRibbonEdit：：Redraw
更新 的顯示 CMFCRibbonEdit 控制項。
virtual void Redraw();
備註
這個方法會透過間接呼叫 CWnd：：RedrawWindow 並設定RDW_INVALIDATE、RDW_ERASE和RDW_UPDATENOW旗標，來重新繪製物件的顯示矩形 CMFCRibbonEdit 。
CMFCRibbonEdit：：SetACCData
設定 CMFCRibbonEdit 物件的協助工具資料 。
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
參數
pParent
物件的父視窗 CMFCRibbonEdit 指標。
data
物件的協助工具資料 CMFCRibbonEdit 。
傳回值
一律會傳回 TRUE。
備註
CMFCRibbonEdit：：SetEditText
設定文字方塊中的文字。
void SetEditText(CString strText);
參數
strText
[in]文字方塊的文字。
CMFCRibbonEdit：：SetTextAlign
設定文字方塊的文字對齊方式。
void SetTextAlign(int nAlign);
參數
nAlign
[in]文字對齊列舉值。 如需可能的值，請參閱一節。
備註
參數 nAlign 是下列其中一個編輯控制項樣式：
左對齊的ES_LEFT
置中對齊的ES_CENTER
正確對齊的ES_RIGHT
如需這些樣式的詳細資訊，請參閱 編輯控制項樣式 。
CMFCRibbonEdit：：SetWidth
設定 CMFCRibbonEdit 控制項文字方塊 的寬度。
void SetWidth(
int nWidth,
BOOL bInFloatyMode = FALSE);
參數
nWidth
[in]文字方塊的寬度，以圖元為單位。
bInFloatyMode
TRUE 可設定浮動模式的寬度;FALSE 可設定一般模式的寬度。
備註
控制項 CMFCRibbonEdit 的顯示模式有兩個寬度：浮動模式和一般模式。
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應