共用方式為

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 物件。

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

終結 CMFCRibbonEdit 物件。

virtual void DestroyCtrl();

備註

下拉式清單框。

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]從清單框左側到顯示文字的距離，以像素為單位。

rect
[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);

參數

point
[in]不使用此參數。

備註

CMFCRibbonEdit：：OnLButtonUp

當使用者放開滑鼠左鍵時，由架構呼叫。

virtual void OnLButtonUp(CPoint point);

參數

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 的顯示模式有兩個寬度：浮動模式和一般模式。

另請參閱

階層架構圖表
類別
CMFCRibbonButton 類別
CMFCRibbonBar 類別