Klasa CMFCRibbonEdit

Artykuł
10/12/2023

Implementuje kontrolkę edycji znajdującą się na pasku wstążki.

Składnia

class CMFCRibbonEdit : public CMFCRibbonButton

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCRibbonEdit::CMFCRibbonEdit	`CMFCRibbonEdit` Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CMFCRibbonEdit::CanBeStretched	Wskazuje, czy wysokość kontrolki `CMFCRibbonEdit` może wzrosnąć pionowo do wysokości wiersza wstążki.
CMFCRibbonEdit::CMFCRibbonEdit	`CMFCRibbonEdit` Tworzy obiekt.
CMFCRibbonEdit::CopyFrom	Kopiuje stan określonego `CMFCRibbonEdit` obiektu do bieżącego `CMFCRibbonEdit` obiektu.
CMFCRibbonEdit::CreateEdit	Tworzy nowe pole tekstowe dla `CMFCRibbonEdit` obiektu.
CMFCRibbonEdit::D estroyCtrl	`CMFCRibbonEdit` Niszczy obiekt.
CMFCRibbonEdit::D ropDownList	Rozwija pole listy.
CMFCRibbonEdit::EnableSpinButtons	Włącza i ustawia zakres przycisku pokrętła dla pola tekstowego.
CMFCRibbonEdit::GetCompactSize	Pobiera kompaktowy rozmiar `CFMCRibbonEdit` obiektu.
CMFCRibbonEdit::GetEditText	Pobiera tekst w polu tekstowym.
CMFCRibbonEdit::GetIntermediateSize	Pobiera pośredni rozmiar `CMFCRibbonEdit` obiektu.
CMFCRibbonEdit::GetTextAlign	Pobiera wyrównanie tekstu w polu tekstowym.
CMFCRibbonEdit::GetWidth	Pobiera szerokość kontrolki `CMFCRibbonEdit` w pikselach.
CMFCRibbonEdit::HasCompactMode	Wskazuje, czy rozmiar wyświetlania kontrolki `CMFCRibbonEdit` może być kompaktowy.
CMFCRibbonEdit::HasFocus	Wskazuje, czy kontrolka `CMFCRIbbonEdit` ma fokus.
CMFCRibbonEdit::HasLargeMode	Wskazuje, czy rozmiar wyświetlania kontrolki `CMFCRibbonEdit` może być duży.
CMFCRibbonEdit::HasSpinButtons	Wskazuje, czy pole tekstowe ma przycisk pokrętła.
CMFCRibbonEdit::IsHighlighted	Wskazuje, czy kontrolka `CMFCRibbonEdit` jest wyróżniona.
CMFCRibbonEdit::OnAfterChangeRect	Wywoływana przez strukturę, gdy wymiary prostokąta wyświetlania dla kontrolki `CMFCRibbonEdit` zmieniają się.
CMFCRibbonEdit::OnDraw	Wywoływana przez strukturę w celu narysowania kontrolki `CMFCRibbonEdit` .
CMFCRibbonEdit::OnDrawLabelAndImage	Wywoływana przez platformę, aby narysować etykietę i obraz kontrolki `CMFCRibbonEdit` .
CMFCRibbonEdit::OnDrawOnList	Wywoływana przez strukturę w celu narysowania kontrolki `CMFCRibbonEdit` w polu listy poleceń.
CMFCRibbonEdit::OnEnable	Wywoływana przez platformę w celu włączenia lub wyłączenia kontrolki `CMFCRibbonEdit` .
CMFCRibbonEdit::OnHighlight	Wywoływana przez strukturę, gdy wskaźnik wchodzi lub opuszcza granice kontrolki `CMFCRibbonEdit` .
CMFCRibbonEdit::OnKey	Wywoływana przez platformę, gdy użytkownik naciska etykietkę, a kontrolka `CMFCRibbonEdit` ma fokus.
CMFCRibbonEdit::OnLButtonDown	Wywoływana przez strukturę w celu zaktualizowania kontrolki `CMFCRibbonEdit` , gdy użytkownik naciska lewy przycisk myszy na kontrolce.
CMFCRibbonEdit::OnLButtonUp	Wywoływana przez platformę, gdy użytkownik zwalnia lewy przycisk myszy.
CMFCRibbonEdit::OnRTLChanged	Wywoływana przez platformę w celu zaktualizowania kontrolki `CMFCRibbonEdit` , gdy układ zmienia kierunek.
CMFCRibbonEdit::OnShow	Wywoływana przez platformę w celu pokazania lub ukrycia kontrolki `CMFCRibbonEdit` .
CMFCRibbonEdit::Redraw	Aktualizuje wyświetlanie kontrolki `CMFCRibbonEdit` .
CMFCRibbonEdit::SetACCData	Ustawia dane ułatwień dostępu dla `CMFCRibbonEdit` obiektu.
CMFCRibbonEdit::SetEditText	Ustawia tekst w polu tekstowym.
CMFCRibbonEdit::SetTextAlign	Ustawia wyrównanie tekstu pola tekstowego.
CMFCRibbonEdit::SetWidth	Ustawia szerokość pola tekstowego kontrolki `CMFCRibbonEdit` .

Uwagi

Przykład

W poniższym przykładzie pokazano, jak skonstruować CMFCRibbonEdit obiekt, pokazać przyciski pokrętła obok kontrolki edycji i ustawić tekst kontrolki edycji. Ten fragment kodu jest częścią przykładu pokazowego pakietu 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"));

Wymagania

Nagłówek: afxRibbonEdit.h

CMFCRibbonEdit::CanBeStretched

Wskazuje, czy wysokość kontrolki CMFCRibbonEdit może wzrosnąć pionowo do wysokości wiersza wstążki.

virtual BOOL CanBeStretched();

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

CMFCRibbonEdit::CMFCRibbonEdit

Tworzy obiekt CMFCRibbonEdit.

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

CMFCRibbonEdit();

Parametry

Nid
[in] Identyfikator polecenia dla kontrolki CMFCRibbonEdit .

nWidth
[in] Szerokość w pikselach pola tekstowego kontrolki CMFCRibbonEdit .

lpszLabel
[in] Etykieta kontrolki CMFCRibbonEdit .

nImage
[in] Indeks małego obrazu do użycia dla kontrolki CMFCRibbonEdit . Kolekcja małych obrazów jest utrzymywana przez kategorię wstążki nadrzędnej.

Uwagi

Kontrolka CMFCRibbonEdit nie używa dużego obrazu.

CMFCRibbonEdit::CopyFrom

Kopiuje stan określonego obiektu CMFCRibbonEdit do bieżącego obiektu CMFCRibbonEdit .

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametry

Src
[in] Obiekt źródłowy CMFCRibbonEdit .

Uwagi

Parametr src musi mieć typ CMFCRibbonEdit.

CMFCRibbonEdit::CreateEdit

Tworzy nowe pole tekstowe dla obiektu CMFCRibbonEdit .

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

Parametry

pWndParent
[in] Wskaźnik do okna nadrzędnego CMFCRibbonEdit obiektu.

dwEditStyle
[in] Określa styl pola tekstowego. Style okien wymienione w sekcji Uwagi można połączyć ze stylami kontrolek edycji opisanymi w zestawie Windows SDK.

Wartość zwracana

Wskaźnik do nowego pola tekstowego, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby utworzyć niestandardowe pole tekstowe.

Do pola tekstowego można zastosować następujące style okien:

WS_CHILD
WS_VISIBLE
WS_DISABLED
WS_GROUP
WS_TABSTOP

CMFCRibbonEdit::D estroyCtrl

Niszczy obiekt CMFCRibbonEdit.

virtual void DestroyCtrl();

Uwagi

CMFCRibbonEdit::D ropDownList

Rozwija pole listy.

virtual void DropDownList();

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpij tę metodę, aby wyświetlić pole listy.

CMFCRibbonEdit::EnableSpinButtons

Włącza i ustawia zakres przycisku pokrętła dla pola tekstowego.

void EnableSpinButtons(
    int nMin,
    int nMax);

Parametry

nMin
[in] Minimalna wartość przycisku pokrętła.

nMax
[in] Maksymalna wartość przycisku pokrętła.

Uwagi

Przyciski pokrętła wyświetlają strzałkę w górę i w dół oraz umożliwiają użytkownikom przechodzenie przez stały zestaw wartości.

CMFCRibbonEdit::GetCompactSize

Pobiera kompaktowy rozmiar obiektu CMFCRibbonEdit .

virtual CSize GetCompactSize(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla CMFCRibbonEdit obiektu.

Wartość zwracana

Kompaktowy rozmiar CMFCRibbonEdit obiektu.

Uwagi

CMFCRibbonEdit::GetEditText

Pobiera tekst w polu tekstowym.

CString GetEditText() const;

Wartość zwracana

Tekst w polu tekstowym.

Uwagi

CMFCRibbonEdit::GetIntermediateSize

Pobiera średni rozmiar obiektu CMFCRibbonEdit .

virtual CSize GetIntermediateSize(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla CMFCRibbonEdit obiektu.

Wartość zwracana

Średni rozmiar CMFCRibbonEdit obiektu.

Uwagi

CMFCRibbonEdit::GetTextAlign

Pobiera wyrównanie tekstu w polu tekstowym.

int GetTextAlign() const;

Wartość zwracana

Wyliczona wartość wyrównania tekstu. Zobacz sekcję Uwagi, aby uzyskać możliwe wartości.

Uwagi

Zwrócona wartość jest jednym z następujących stylów edycji kontrolek:

ES_LEFT wyrównania po lewej stronie
ES_CENTER do wyrównania do środka
ES_RIGHT w celu wyrównania do prawej

Aby uzyskać więcej informacji na temat tych stylów, zobacz Edytowanie stylów kontrolek.

CMFCRibbonEdit::GetWidth

Pobiera szerokość kontrolki CMFCRibbonEdit w pikselach.

int GetWidth(BOOL bInFloatyMode = FALSE) const;

Parametry

bInFloatyMode
[in] WARTOŚĆ TRUE, jeśli kontrolka CMFCRibbonEdit jest w trybie zmiennoprzecinkowa; w przeciwnym razie wartość FALSE.

Wartość zwracana

Szerokość kontrolki w pikselach CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::HasCompactMode

Wskazuje, czy rozmiar wyświetlacza dla kontrolki CMFCRibbonEdit może być kompaktowy.

virtual BOOL HasCompactMode() const;

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE. Zastąpi tę metodę, aby wskazać, czy rozmiar wyświetlacza może być kompaktowy.

CMFCRibbonEdit::HasFocus

Wskazuje, czy kontrolka CMFCRibbonEdit ma fokus.

virtual BOOL HasFocus() const;

Wartość zwracana

Wartość TRUE, jeśli kontrolka CMFCRibbonEdit ma fokus; w przeciwnym razie wartość FALSE.

Uwagi

CMFCRibbonEdit::HasLargeMode

Wskazuje, czy rozmiar wyświetlania kontrolki CMFCRibbonEdit może być duży.

virtual BOOL HasLargeMode() const;

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpi tę metodę, aby wskazać, czy rozmiar wyświetlania może być duży.

CMFCRibbonEdit::HasSpinButtons

Wskazuje, czy pole tekstowe ma przycisk pokrętła.

virtual BOOL HasSpinButtons() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli pole tekstowe ma przycisk pokrętła; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonEdit::IsHighlighted

Wskazuje, czy kontrolka CMFCRibbonEdit jest wyróżniona.

virtual BOOL IsHighlighted() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli kontrolka CMFCRibbonEdit jest wyróżniona; w przeciwnym razie wartość FALSE.

Uwagi

CMFCRibbonEdit::OnAfterChangeRect

Wywoływana przez platformę, gdy wymiary prostokąta wyświetlania dla zmiany kontrolki CMFCRibbonEdit .

virtual void OnAfterChangeRect(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::OnDraw

Wywoływana przez platformę w celu narysowania kontrolki CMFCRibbonEdit .

virtual void OnDraw(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::OnDrawLabelAndImage

Wywoływana przez platformę, aby narysować etykietę i obraz dla kontrolki CMFCRibbonEdit .

virtual void OnDrawLabelAndImage(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::OnDrawOnList

Wywoływana przez platformę w celu rysowania kontrolki CMFCRibbonEdit w polu listy poleceń.

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

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

strText
[in] Tekst wyświetlany.

nTextOffset
[in] Odległość w pikselach od lewej strony pola listy do tekstu wyświetlanego.

Rect
[in] Prostokąt wyświetlania kontrolki CMFCRibbonEdit .

bIsSelected
[in] Ten parametr nie jest używany.

bHighlighted
[in] Ten parametr nie jest używany.

Uwagi

Pole listy poleceń wyświetla kontrolki wstążki, aby umożliwić użytkownikom dostosowywanie paska narzędzi szybkiego dostępu.

CMFCRibbonEdit::OnEnable

Wywoływana przez platformę w celu włączenia lub wyłączenia kontrolki CMFCRibbonEdit .

virtual void OnEnable(BOOL bEnable);

Parametry

bEnable
[in] WARTOŚĆ TRUE, aby włączyć kontrolkę; FAŁSZ, aby wyłączyć kontrolkę.

Uwagi

CMFCRibbonEdit::OnHighlight

Wywoływana przez platformę, gdy wskaźnik wchodzi lub opuszcza granice kontrolki CMFCRibbonEdit .

virtual void OnHighlight(BOOL bHighlight);

Parametry

bHighlight
[in] Wartość TRUE, jeśli wskaźnik znajduje się w granicach kontrolki CMFCRibbonEdit ; w przeciwnym razie wartość FALSE.

Uwagi

CMFCRibbonEdit::OnKey

Wywoływana przez platformę, gdy użytkownik naciska etykietkę, a kontrolka CMFCRibbonEdit ma fokus.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametry

virtual void Redraw();

Uwagi

Ta metoda ponownie rysuje prostokąt wyświetlania dla CMFCRibbonEdit obiektu, pośrednio wywołując CWnd::RedrawWindow z ustawionymi flagami RDW_INVALIDATE, RDW_ERASE i RDW_UPDATENOW.

CMFCRibbonEdit::SetACCData

Ustawia dane ułatwień dostępu dla obiektu CMFCRibbonEdit .

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

Parametry

PParent
Wskaźnik do okna nadrzędnego CMFCRibbonEdit dla obiektu.

data
Dane ułatwień dostępu dla CMFCRibbonEdit obiektu.

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

CMFCRibbonEdit::SetEditText

Ustawia tekst w polu tekstowym.

void SetEditText(CString strText);

Parametry

strText
[in] Tekst pola tekstowego.

CMFCRibbonEdit::SetTextAlign

Ustawia wyrównanie tekstu pola tekstowego.

void SetTextAlign(int nAlign);

Parametry

nAlign
[in] Wyliczona wartość wyrównania tekstu. Zobacz sekcję Uwagi, aby uzyskać możliwe wartości.

Uwagi

Parametr nAlign jest jednym z następujących stylów kontrolki edycji:

ES_LEFT wyrównania po lewej stronie
ES_CENTER wyrównania do środka
ES_RIGHT w celu wyrównania do prawej

Aby uzyskać więcej informacji na temat tych stylów, zobacz Edytowanie stylów kontrolek.

CMFCRibbonEdit::SetWidth

Ustawia szerokość pola tekstowego dla kontrolki CMFCRibbonEdit .

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

Parametry

nWidth
[in] Szerokość pola tekstowego w pikselach.

bInFloatyMode
WARTOŚĆ TRUE, aby ustawić szerokość dla trybu zmiennoprzecinkowego; FAŁSZ, aby ustawić szerokość trybu regularnego.

Uwagi

Kontrolka CMFCRibbonEdit ma dwie szerokości w zależności od trybu wyświetlania: tryb zmiennoprzecinkowa i tryb regularny.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCRibbonButton
Klasa CMFCRibbonBar

Udostępnij za pośrednictwem

Klasa CMFCRibbonEdit

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Uwagi

Przykład

Wymagania

CMFCRibbonEdit::CanBeStretched

Wartość zwracana

Uwagi

CMFCRibbonEdit::CMFCRibbonEdit

Parametry

Uwagi

CMFCRibbonEdit::CopyFrom

Parametry

Uwagi

CMFCRibbonEdit::CreateEdit

Parametry

Wartość zwracana

Uwagi

CMFCRibbonEdit::D estroyCtrl

Uwagi

CMFCRibbonEdit::D ropDownList

Uwagi

CMFCRibbonEdit::EnableSpinButtons

Parametry

Uwagi

CMFCRibbonEdit::GetCompactSize

Parametry

Wartość zwracana

Uwagi

CMFCRibbonEdit::GetEditText

Wartość zwracana

Uwagi

CMFCRibbonEdit::GetIntermediateSize

Parametry

Wartość zwracana

Uwagi

CMFCRibbonEdit::GetTextAlign

Wartość zwracana

Uwagi

CMFCRibbonEdit::GetWidth

Parametry

Wartość zwracana

Uwagi

CMFCRibbonEdit::HasCompactMode

Wartość zwracana

Uwagi

CMFCRibbonEdit::HasFocus

Wartość zwracana

Uwagi

CMFCRibbonEdit::HasLargeMode

Wartość zwracana

Uwagi

CMFCRibbonEdit::HasSpinButtons

Wartość zwracana

Uwagi

CMFCRibbonEdit::IsHighlighted

Wartość zwracana

Uwagi

CMFCRibbonEdit::OnAfterChangeRect

Parametry

Uwagi

CMFCRibbonEdit::OnDraw

Parametry

Uwagi

CMFCRibbonEdit::OnDrawLabelAndImage

Parametry

Uwagi

CMFCRibbonEdit::OnDrawOnList

Parametry

Uwagi

CMFCRibbonEdit::OnEnable

Parametry

Uwagi

CMFCRibbonEdit::OnHighlight

Parametry

Uwagi