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
的顯示模式有兩個寬度:浮動模式和一般模式。
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應