Klasa CMFCColorBarCMFCColorBar Class

CMFCColorBarKlasa reprezentuje pasek sterowania dokowaniem, który może wybierać kolory w dokumencie lub aplikacji.The CMFCColorBar class represents a docking control bar that can select colors in a document or application.

SkładniaSyntax

class CMFCColorBar : public CMFCPopupMenuBar

Elementy członkowskieMembers

Konstruktory chronioneProtected Constructors

NazwaName OpisDescription
CMFCColorBar::CMFCColorBarCMFCColorBar::CMFCColorBar Konstruuje CMFCColorBar obiekt.Constructs a CMFCColorBar object.

Metody publicznePublic Methods

NazwaName OpisDescription
CMFCColorBar::ContextToSizeCMFCColorBar::ContextToSize Oblicza marginesy pionowe i poziome, które są wymagane, aby zawierały przyciski w kontrolce pasek koloru, a następnie dostosowuje lokalizację tych przycisków.Calculates the vertical and horizontal margins that are required to contain the buttons on the color bar control and then adjusts the location of those buttons.
CMFCColorBar:: IsControlCMFCColorBar::CreateControl Tworzy okno kontrolki pasek koloru, dołącza je do CMFCColorBar obiektu i zmienia rozmiar kontrolki tak, aby zawierała określoną paletę kolorów.Creates a color bar control window, attaches it to the CMFCColorBar object, and resizes the control to contain the specified palette of colors.
CMFCColorBar:: CreateCMFCColorBar::Create Tworzy okno kontrolki pasek koloru i dołącza je do CMFCColorBar obiektu.Creates a color bar control window and attaches it to the CMFCColorBar object.
CMFCColorBar::EnableAutomaticButtonCMFCColorBar::EnableAutomaticButton Pokazuje lub ukrywa przycisk Automatyczny.Shows or hides the automatic button.
CMFCColorBar::EnableOtherButtonCMFCColorBar::EnableOtherButton Włącza lub wyłącza wyświetlanie okna dialogowego, które pozwala użytkownikowi wybrać więcej kolorów.Enables or disables the display of a dialog box that lets the user select more colors.
CMFCColorBar:: GetColorCMFCColorBar::GetColor Pobiera aktualnie wybrany kolor.Retrieves the currently selected color.
CMFCColorBar::GetCommandIDCMFCColorBar::GetCommandID Pobiera identyfikator polecenia bieżącej kontrolki paska kolorów.Retrieves the command ID of the current color bar control.
CMFCColorBar::GetHighlightedColorCMFCColorBar::GetHighlightedColor Pobiera kolor, który oznacza, że przycisk koloru ma fokus. oznacza to, że przycisk jest aktywny.Retrieves the color that signifies that a color button has the focus; that is, the button is hot.
CMFCColorBar::GetHorzMarginCMFCColorBar::GetHorzMargin Pobiera pionowy margines, czyli odstęp między komórką koloru w lewo lub w prawo i granicą obszaru klienta.Retrieves the horizontal margin, which is the space between the left or right color cell and the client area boundary.
CMFCColorBar::GetVertMarginCMFCColorBar::GetVertMargin Pobiera pionowy margines, czyli spację między górną lub dolną komórką koloru a granicą obszaru klienta.Retrieves the vertical margin, which is the space between the top or bottom color cell and the client area boundary.
CMFCColorBar::IsTearOffCMFCColorBar::IsTearOff Wskazuje, czy bieżący pasek kolorów jest było dokować.Indicates whether the current color bar is dockable.
CMFCColorBar:: SetColorCMFCColorBar::SetColor Ustawia kolor, który jest aktualnie wybrany.Sets the color that is currently selected.
CMFCColorBar:: SetColorNameCMFCColorBar::SetColorName Ustawia nową nazwę określonego koloru.Sets a new name for a specified color.
CMFCColorBar::SetCommandIDCMFCColorBar::SetCommandID Ustawia nowy identyfikator polecenia dla kontrolki paska kolorów.Sets a new command ID for a color bar control.
CMFCColorBar::SetDocumentColorsCMFCColorBar::SetDocumentColors Ustawia listę kolorów, które są używane w bieżącym dokumencie.Sets the list of colors that are used in the current document.
CMFCColorBar::SetHorzMarginCMFCColorBar::SetHorzMargin Ustawia margines poziomy, czyli odstęp między komórką koloru w lewo lub w prawo i granicą obszaru klienta.Sets the horizontal margin, which is the space between the left or right color cell and the client area boundary.
CMFCColorBar::SetVertMarginCMFCColorBar::SetVertMargin Ustawia pionowy margines, czyli spację między górną lub dolną komórką koloru a granicą obszaru klienta.Sets the vertical margin, which is the space between the top or bottom color cell and the client area boundary.

Metody chronioneProtected Methods

NazwaName OpisDescription
CMFCColorBar::AdjustLocationsCMFCColorBar::AdjustLocations Dostosowuje położenie przycisków kolorów w formancie paska kolorów.Adjusts the positions of the color buttons on the color bar control.
CMFCColorBar::AllowChangeTextLabelsCMFCColorBar::AllowChangeTextLabels Wskazuje, czy etykieta tekstowa przycisków kolorów może ulec zmianie.Indicates whether the text label of color buttons can change.
CMFCColorBar::AllowShowOnListCMFCColorBar::AllowShowOnList Wskazuje, czy obiekt kontrolki pasek koloru może być wyświetlany na liście pasków narzędzi podczas procesu dostosowywania.Indicates whether the color bar control object can appear in a toolbar list during the customization process.
CMFCColorBar::CalcSizeCMFCColorBar::CalcSize Wywoływane przez platformę jako część procesu obliczeń układu.Called by the framework as part of the layout calculation process.
CMFCColorBar:: ispaletteCMFCColorBar::CreatePalette Inicjuje paletę z kolorami w określonej tablicy kolorów.Initializes a palette with the colors in a specified array of colors.
CMFCColorBar::GetColorGridSizeCMFCColorBar::GetColorGridSize Oblicza liczbę wierszy i kolumn w siatce kontrolki paska kolorów.Calculates the number of rows and columns in the grid of a color bar control.
CMFCColorBar::GetExtraHeightCMFCColorBar::GetExtraHeight Oblicza dodatkową wysokość wymaganą przez bieżący pasek kolorów do wyświetlania różnych elementów interfejsu użytkownika, takich jak inny przycisk, kolory dokumentu i tak dalej.Calculates the additional height that the current color bar requires to display miscellaneous user interface elements such as the Other button, document colors, and so on.
CMFCColorBar::InitColorsCMFCColorBar::InitColors Inicjuje tablicę kolorów z kolorami określonej palety lub domyślną paletą systemu.Initializes an array of colors with the colors in a specified palette or the system default palette.
CMFCColorBar::OnKeyCMFCColorBar::OnKey Wywoływane przez platformę, gdy użytkownik naciśnie przycisk klawiatury.Called by the framework when a user presses a keyboard button.
CMFCColorBar::OnSendCommandCMFCColorBar::OnSendCommand Wywoływane przez platformę, aby zamknąć hierarchię formantów podręcznych.Called by the framework to close a hierarchy of popup controls.
CMFCColorBar::OnUpdateCmdUICMFCColorBar::OnUpdateCmdUI Wywoływane przez platformę, aby włączyć lub wyłączyć element interfejsu użytkownika kontrolki paska kolorów przed wyświetleniem elementu.Called by the framework to enable or disable a user-interface item of a color bar control before the item is displayed.
CMFCColorBar::OpenColorDialogCMFCColorBar::OpenColorDialog Otwiera okno dialogowe koloru.Opens a color dialog box.
CMFCColorBar:: RebuildCMFCColorBar::Rebuild Całkowicie odświeża kontrolkę pasek koloru.Completely redraws the color bar control.
CMFCColorBar::SelectPaletteCMFCColorBar::SelectPalette Ustawia logiczną paletę określonego kontekstu urządzenia do palety przycisku nadrzędnego bieżącej kontrolki paska kolorów.Sets the logical palette of the specified device context to the palette of the parent button of the current color bar control.
CMFCColorBar::SetPropListCMFCColorBar::SetPropList Ustawia m_pWndPropList element członkowski danych chronionych na określony wskaźnik do kontrolki siatki właściwości.Sets the m_pWndPropList protected data member to the specified pointer to a property grid control.
CMFCColorBar::ShowCommandMessageStringCMFCColorBar::ShowCommandMessageString Żąda okna ramki, które jest właścicielem kontrolki pasek koloru, aby zaktualizować wiersz komunikatu na pasku stanu.Requests the frame window that owns the color bar control to update the message line in the status bar.

Chronione elementy członkowskie danychProtected Data Members

NazwaName OpisDescription
m_bInternal Pole logiczne, które określa, czy zdarzenia myszy są przetwarzane.A Boolean field that determines whether mouse events are processed. Zazwyczaj zdarzenia myszy są przetwarzane, gdy to pole ma wartość TRUE, a tryb dostosowywania ma wartość FALSE.Typically, mouse events are processed when this field is TRUE and customization mode is FALSE.
m_bIsEnabled Wartość logiczna wskazująca, czy kontrolka jest włączona.A Boolean that indicates whether a control is enabled.
m_bIsTearOff Wartość logiczna wskazująca, czy kontrolka pasek koloru obsługuje dokowanie.A Boolean that indicates whether the color bar control supports docking.
m_BoxSize Obiekt CSize , który określa rozmiar komórki w siatce paska kolorów.A CSize object that specifies the size of a cell in a color bar grid.
m_bShowDocColorsWhenDocked Wartość logiczna wskazująca, czy kolory dokumentu mają być wyświetlane, gdy pasek koloru jest zadokowany.A Boolean that indicates whether to show document colors when the color bar is docked. Aby uzyskać więcej informacji, zobacz CMFCColorBar:: SetDocumentColors.For more information, see CMFCColorBar::SetDocumentColors.
m_bStdColorDlg Wartość logiczna wskazująca, czy ma być wyświetlane okno dialogowe standardowy kolor systemu czy okno dialogowe CMFCColorDialog .A Boolean that indicates whether to show the standard system color dialog box or the CMFCColorDialog dialog box. Aby uzyskać więcej informacji, zobacz CMFCColorBar:: EnableOtherButton.For more information, see CMFCColorBar::EnableOtherButton.
m_ColorAutomatic COLORREF przechowujący bieżący automatyczny kolor.A COLORREF that stores the current automatic color. Aby uzyskać więcej informacji, zobacz CMFCColorBar:: EnableOtherButton.For more information, see CMFCColorBar::EnableOtherButton.
m_ColorNames Obiekt CMAP , który kojarzy zestaw kolorów RGB z ich nazwami.An CMap object that associates a set of RGB colors with their names.
m_colors CArray wartości COLORREF , które zawierają kolory, które są wyświetlane w kontrolce pasek koloru.A CArray of COLORREF values that contains the colors that are displayed in the color bar control.
m_ColorSelected Wartość COLORREF , która jest kolorem aktualnie wybranym przez użytkownika z kontrolki pasek koloru.A COLORREF value that is the color that the user has currently selected from the color bar control.
m_lstDocColors CList wartości COLORREF , które zawierają kolory, które są obecnie używane w dokumencie.A CList of COLORREF values that contains the colors that are currently used in a document.
m_nCommandID Liczba całkowita bez znaku, która jest IDENTYFIKATORem polecenia przycisku koloru.An unsigned integer that is the command ID of a color button.
m_nHorzMargin Liczba całkowita będąca poziomą margines między przyciskami koloru w siatce kolorów.An integer that is the horizontal margin between the color buttons in a grid of colors.
m_nHorzOffset Liczba całkowita, która jest przesunięciem w poziomie do środka przycisku koloru.An integer that is the horizontal offset to the center of the color button. Ta wartość jest istotna, jeśli przycisk wyświetla tekst lub obraz oprócz koloru.This value is significant if the button displays text or an image in addition to a color.
m_nNumColumns Liczba całkowita, która jest liczbą kolumn na pasku koloru kontrolki siatki kolorów.An integer that is the number of columns in a color bar control grid of colors.
m_nNumColumnsVert Liczba całkowita, która jest liczbą kolumn w siatce zorientowanej w pionie kolorów.An integer that is the number of columns in a vertically oriented grid of colors.
m_nNumRowsHorz Liczba całkowita, która jest liczbą kolumn w siatce zorientowanej poziomo kolorów.An integer that is the number of columns in a horizontally oriented grid of colors.
m_nRowHeight Liczba całkowita, która jest wysokością wiersza przycisków koloru w siatce kolorów.An integer that is the height of a row of color buttons in a grid of colors.
m_nVertMargin Liczba całkowita, która jest pionowym marginesem między przyciskami koloru w siatce kolorów.An integer that is the vertical margin between the color buttons in a grid of colors.
m_nVertOffset Liczba całkowita, która jest przesunięciem pionowym do środka przycisku koloru.An integer that is the vertical offset to the center of the color button. Ta wartość jest istotna, jeśli przycisk wyświetla tekst lub obraz oprócz koloru.This value is significant if the button displays text or an image in addition to a color.
m_Palette CPalette kolorów, które są używane w kontrolce pasek koloru.A CPalette of the colors that are used in the color bar control.
m_pParentBtn Wskaźnik do obiektu CMFCColorButton , który jest elementem nadrzędnym bieżącego przycisku.A pointer to a CMFCColorButton object that is the parent of the current button. Ta wartość jest istotna, jeśli przycisk Color znajduje się w hierarchii formantów Toolbar lub znajduje się w kontrolce siatki właściwości koloru.This value is significant if the color button is in a hierarchy of toolbar controls or is in a color property grid control.
m_pParentRibbonBtn Wskaźnik do obiektu CMFCRibbonColorButton , który znajduje się na Wstążce i jest przyciskiem nadrzędnym bieżącego przycisku.A pointer to a CMFCRibbonColorButton object that is on the ribbon and is the parent button of the current button. Ta wartość jest istotna, jeśli przycisk Color znajduje się w hierarchii formantów Toolbar lub znajduje się w kontrolce siatki właściwości koloru.This value is significant if the color button is in a hierarchy of toolbar controls or is in a color property grid control.
m_pWndPropList Wskaźnik do obiektu CMFCPropertyGridCtrl .A pointer to a CMFCPropertyGridCtrl object.
m_strAutoColor CString , który jest tekstem wyświetlanym na przycisku automatyczny .A CString that is the text that is displayed on the Automatic button. Aby uzyskać więcej informacji, zobacz CMFCColorBar:: EnableAutomaticButton.For more information, see CMFCColorBar::EnableAutomaticButton.
m_strDocColors CString , który jest tekstem wyświetlanym na przycisku kolory dokumentu.A CString that is the text that is displayed on the document colors button. Aby uzyskać więcej informacji, zobacz CMFCColorBar:: SetDocumentColors.For more information, see CMFCColorBar::SetDocumentColors.
m_strOtherColor CString , który jest tekstem wyświetlanym na drugim przycisku.A CString that is the text that is displayed on the other button. Aby uzyskać więcej informacji, zobacz CMFCColorBar:: EnableOtherButton.For more information, see CMFCColorBar::EnableOtherButton.

UwagiRemarks

Zazwyczaj nie utworzysz CMFCColorBar obiektu bezpośrednio.Usually, you do not create a CMFCColorBar object directly. Zamiast tego Klasa CMFCColorMenuButton (używana w menu i paskach narzędzi) lub Klasa CMFCColorButton tworzy CMFCColorBar obiekt.Instead, the CMFCColorMenuButton Class (used in menus and toolbars) or the CMFCColorButton Class creates the CMFCColorBar object.

CMFCColorBarKlasa zapewnia następujące funkcje:The CMFCColorBar class provides the following functionality:

  • Automatycznie dostosowuje listę kolorów dokumentu.Automatically adjusts the list of document colors.

  • Zapisuje i przywraca stan wraz ze stanem dokumentu.Saves and restores its state, together with the document state.

  • Zarządza przyciskiem "automatyczny".Manages the "automatic" button.

  • Używa kontrolki klasy CMFCColorPickerCtrl w celu wybrania koloru niestandardowego.Uses the CMFCColorPickerCtrl Class control to select a custom color.

  • Obsługuje stan "Odrywane" (jeśli jest tworzony przy użyciu klasy CMFCColorMenuButton).Supports a "tear-off" state (if it is created by using the CMFCColorMenuButton Class).

Aby włączyć CMFCColorBar funkcje do aplikacji:To incorporate the CMFCColorBar functionality into your application:

  1. Utwórz przycisk menu regularnego i przypisz mu identyfikator, na przykład ID_CHAR_COLOR.Create a regular menu button and assign it an ID, for example ID_CHAR_COLOR.

  2. W klasie okna ramki Zastąp metodę CFrameWndEx:: OnShowPopupMenu i Zastąp przycisk menu zwykłego obiektem klasy CMFCColorMenuButton (przez wywołanie CMFCToolBar:: ReplaceButton).In your frame window class, override the CFrameWndEx::OnShowPopupMenu method and replace the regular menu button with a CMFCColorMenuButton Class object (by calling CMFCToolBar::ReplaceButton).

  3. Ustaw wszystkie style i Włącz lub wyłącz funkcje CMFCColorBar obiektu podczas tworzenia klasy CMFCColorMenuButton .Set all the styles and enable or disable the features of the CMFCColorBar object during CMFCColorMenuButton Class creation. CMFCColorMenuButtonObiekt dynamicznie tworzy CMFCColorBar obiekt po wywołaniem metody przez strukturę CreatePopupMenu .The CMFCColorMenuButton object dynamically creates the CMFCColorBar object after the framework calls the CreatePopupMenu method.

Gdy użytkownik kliknie przycisk kontrolki pasek koloru, struktura używa ON_COMMAND makra, aby powiadomić element nadrzędny kontrolki paska kolorów.When the user clicks a color bar control button, the framework uses the ON_COMMAND macro to notify the parent of the color bar control. W makrze parametr identyfikatora polecenia jest wartością, którą przypisano do przycisku kontrolki pasek koloru w kroku 1 (ID_CHAR_COLOR w tym przykładzie).In the macro, the command ID parameter is the value that you assigned to the color bar control button in step 1 (ID_CHAR_COLOR in this example). Aby uzyskać więcej informacji, zobacz klasy CMFCColorMenuButton, Klasa CMFCColorButton, Klasa CMFCColorPickerCtrl, Klasa CFrameWndExi klasy klasy CMFCToolBar .For more information, see the CMFCColorMenuButton Class, CMFCColorButton Class, CMFCColorPickerCtrl Class, CFrameWndEx Class, and CMFCToolBar Class classes.

PrzykładExample

Poniższy przykład pokazuje, jak skonfigurować pasek koloru przy użyciu różnych metod w CMFCColorBar klasie.The following example demonstrates how to configure a color bar by using various methods in the CMFCColorBar class. Metody ustawiają marginesy w poziomie i w pionie, włączają drugi przycisk, tworzą okno kontrolki paska kolorów i ustawia aktualnie wybrany kolor.The methods set the horizontal and vertical margins, enable the other button, create a color bar control window, and sets the currently selected color. Ten przykład jest częścią nowych kontrolek.This example is part of the New Controls sample.

CMFCColorBar m_wndColorBar;
// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

Hierarchia dziedziczeniaInheritance Hierarchy

CObjectCObject

CCmdTargetCCmdTarget

CWndCWnd

CBasePaneCBasePane

CPaneCPane

CMFCBaseToolBarCMFCBaseToolBar

CMFCToolBarCMFCToolBar

CMFCPopupMenuBarCMFCPopupMenuBar

CMFCColorBarCMFCColorBar

WymaganiaRequirements

Nagłówek: afxcolorbar. hHeader: afxcolorbar.h

CMFCColorBar::AdjustLocationsCMFCColorBar::AdjustLocations

Dostosowuje położenie przycisków kolorów w formancie paska kolorów.Adjusts the positions of the color buttons on the color bar control.

virtual void AdjustLocations();

UwagiRemarks

Ta metoda jest wywoływana przez platformę podczas WM_SIZE przetwarzania komunikatów.This method is called by the framework during WM_SIZE message processing.

CMFCColorBar::AllowChangeTextLabelsCMFCColorBar::AllowChangeTextLabels

Wskazuje, czy etykieta tekstowa przycisków kolorów może ulec zmianie.Indicates whether the text label of color buttons can change.

virtual BOOL AllowChangeTextLabels() const;

Wartość zwracanaReturn Value

Zawsze FALSE.Always FALSE.

UwagiRemarks

Domyślnie ta metoda zawsze zwraca wartość FALSE, co oznacza, że nie można modyfikować etykiet tekstu.By default, this method always returns FALSE, which means text labels cannot be modified. Zastąp tę metodę, aby włączyć modyfikowanie etykiet tekstowych.Override this method to enable modifying text labels.

CMFCColorBar::AllowShowOnListCMFCColorBar::AllowShowOnList

Wskazuje, czy obiekt kontrolki pasek koloru może być wyświetlany na liście pasków narzędzi podczas procesu dostosowywania.Indicates whether the color bar control object can appear in a toolbar list during the customization process.

virtual BOOL AllowShowOnList() const;

Wartość zwracanaReturn Value

Zawsze wartość TRUE.Always TRUE.

UwagiRemarks

Domyślnie ta metoda zawsze zwraca wartość TRUE, co oznacza, że struktura może wyświetlać kontrolkę pasek koloru podczas procesu dostosowywania.By default, this method always returns TRUE, which means the framework can display the color bar control during the customization process. Zastąp tę metodę, aby zaimplementować inne zachowanie.Override this method to implement a different behavior.

CMFCColorBar::CalcSizeCMFCColorBar::CalcSize

Wywoływane przez platformę jako część procesu obliczeń układu.Called by the framework as part of the layout calculation process.

virtual CSize CalcSize(BOOL bVertDock);

ParametryParameters

bVertDockbVertDock
podczas PRAWDA, aby określić, że kontrolka pasek koloru jest zadokowana pionowo. Wartość FALSE, aby określić, że kontrolka pasek koloru jest zadokowana w poziomie.[in] TRUE to specify that the color bar control is docked vertically; FALSE to specify that the color bar control is docked horizontally.

Wartość zwracanaReturn Value

Rozmiar tablicy przycisków kolorów w kontrolce paska kolorów.The size of the array of color buttons in a color bar control.

CMFCColorBar::CMFCColorBarCMFCColorBar::CMFCColorBar

Konstruuje CMFCColorBar obiekt.Constructs a CMFCColorBar object.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

ParametryParameters

światcolors
podczas Tablica kolorów, które są wyświetlane w strukturze na kontrolce paska kolorów.[in] An array of colors that the framework displays on the color bar control.

Kolorcolor
podczas Początkowo wybrany kolor.[in] The initially selected color.

lpszAutoColorlpszAutoColor
podczas Etykieta tekstowa automatycznego (domyślnego) przycisku koloru lub wartość null.[in] The text label of the automatic (default) color button, or NULL.

Standardowa etykieta przycisku automatycznego jest Automatyczna.The standard label for the automatic button is Automatic.

lpszOtherColorlpszOtherColor
podczas Etykieta tekstowa drugiego przycisku, która wyświetla więcej opcji kolorów lub wartość null.[in] The text label of the other button, which displays more color choices, or NULL.

Standardowa etykieta dla drugiego przycisku ma więcej kolorów...The standard label for the other button is More Colors....

lpszDocColorslpszDocColors
podczas Etykieta tekstowa przycisku kolory dokumentu.[in] The text label of the document colors button. W palecie kolory dokumentu są wyświetlane wszystkie kolory, których aktualnie używa dokument.The document colors palette lists all the colors that the document currently uses.

lstDocColorslstDocColors
podczas Lista kolorów używanych obecnie przez dokument.[in] A list of colors that the document currently uses.

nColumnsnColumns
podczas Liczba kolumn, które ma Tablica kolorów.[in] The number of columns that the array of colors has.

nRowsDockHorznRowsDockHorz
podczas Liczba wierszy, po których pasek koloru jest zadokowany w poziomie.[in] The number of rows that the color bar has when it is docked horizontally.

nColDockVertnColDockVert
podczas Liczba kolumn, które znajdują się na pasku kolorów, gdy jest zadokowany w pionie.[in] The number of columns that the color bar has when it is docked vertically.

colorAutomaticcolorAutomatic
podczas Domyślny kolor stosowany przez platformę po kliknięciu przycisku automatyczne.[in] The default color that the framework applies when you click the automatic button.

nCommandIDnCommandID
podczas Identyfikator polecenia kontrolki paska kolorów.[in] The color bar control command ID.

pParentBtnpParentBtn
podczas Wskaźnik do przycisku nadrzędnego.[in] A pointer to a parent button.

srcsrc
podczas Istniejący CMFCColorBar obiekt do skopiowania do nowego CMFCColorBar obiektu.[in] An existing CMFCColorBar object to be copied into the new CMFCColorBar object.

uiCommandIDuiCommandID
podczas Identyfikator polecenia.[in] The command ID.

CMFCColorBar::ContextToSizeCMFCColorBar::ContextToSize

Oblicza marginesy pionowe i poziome, które są wymagane do zawiera przyciski w kontrolce pasek koloru i dostosowuje lokalizację tych przycisków.Calculates the vertical and horizontal margins that are required to contain the buttons on the color bar control, and adjusts the location of those buttons.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

ParametryParameters

bSquareButtonsbSquareButtons
podczas PRAWDA, aby określić, że kształt przycisków na kontrolce pasek koloru jest kwadratowy; w przeciwnym razie FALSE.[in] TRUE to specify that the shape of the buttons on a color bar control are square; otherwise, FALSE. Wartość domyślna to TRUE.The default value is TRUE.

bCenterButtonsbCenterButtons
podczas Wartość TRUE, aby określić, że zawartość na stronie przycisku kontrolki paska koloru jest wyśrodkowana; w przeciwnym razie FALSE.[in] TRUE to specify that the content on the face of a color bar control button is centered; otherwise, FALSE. Wartość domyślna to TRUE.The default value is TRUE.

UwagiRemarks

CMFCColorBar:: CreateCMFCColorBar::Create

Tworzy okno kontrolki pasek koloru i dołącza je do CMFCColorBar obiektu.Creates a color bar control window and attaches it to the CMFCColorBar object.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

ParametryParameters

pParentWndpParentWnd
podczas Wskaźnik do okna nadrzędnego.[in] Pointer to the parent window.

dwStyledwStyle
podczas Bitowa kombinacja (lub) stylów okna.[in] A bitwise combination (OR) of window styles.

nIDnID
podczas Identyfikator polecenia.[in] The command ID.

pPalettepPalette
podczas Wskaźnik do palety kolorów.[in] Pointer to a palette of colors. Wartość domyślna to NULL.The default is NULL.

nColumnsnColumns
podczas Liczba kolumn w kontrolce pasek koloru.[in] The number of columns in the color bar control. Wartość domyślna to 0.The default is 0.

nRowsDockHorznRowsDockHorz
podczas Liczba wierszy w formancie paska kolorów, gdy jest zadokowana w poziomie.[in] The number of rows in the color bar control when it is docked horizontally. Wartość domyślna to 0.The default is 0.

nColDockVertnColDockVert
podczas Liczba kolumn w kontrolce paska kolorów, gdy jest zadokowany w pionie.[in] The number of columns in the color bar control when it is docked vertically. Wartość domyślna to 0.The default is 0.

Wartość zwracanaReturn Value

PRAWDA, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie FALSE.TRUE if this method is successful; otherwise, FALSE.

UwagiRemarks

Aby skonstruować CMFCColorBar obiekt, Wywołaj konstruktora klasy, a następnie tę metodę.To construct a CMFCColorBar object, call the class constructor then this method. CreateMetoda tworzy formant systemu Windows i inicjuje listę kolorów.The Create method creates the Windows control and initializes a list of colors.

CMFCColorBar:: IsControlCMFCColorBar::CreateControl

Tworzy okno kontrolki pasek koloru, dołącza je do CMFCColorBar obiektu i zmienia rozmiar okna sterowania, aby zawierało określoną paletę kolorów.Creates a color bar control window, attaches it to the CMFCColorBar object, and resizes the control window to contain the specified palette of colors.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

ParametryParameters

pParentWndpParentWnd
podczas Wskaźnik do okna nadrzędnego.[in] Pointer to the parent window. Nie może mieć wartości NULL.Cannot be NULL.

cinaniarect
podczas Prostokąt ograniczający, który określa, gdzie należy narysować kontrolkę pasek koloru.[in] A bounding rectangle that specifies where to draw the color bar control.

nIDnID
podczas Identyfikator formantu.[in] The control ID.

nColumnsnColumns
podczas Idealna liczba kolumn w kontrolce pasek koloru.[in] The ideal number of columns in the color bar control. Ta metoda modyfikuje tę liczbę, aby dopasować ją do określonej palety kolorów.This method modifies that number to fit the specified palette of colors. Wartość domyślna to-1, co oznacza, że ten parametr nie jest określony.The default is -1, which means this parameter is not specified.

pPalettepPalette
podczas Wskaźnik do palety kolorów lub wartości NULL.[in] Pointer to a palette of colors, or NULL. Jeśli ten parametr ma wartość NULL, ta metoda oblicza rozmiar kontrolki pasek koloru, tak jakby określono 20 kolorów.If this parameter is NULL, this method calculates the size of the color bar control as if 20 colors were specified. Wartość domyślna to NULL.The default is NULL.

Wartość zwracanaReturn Value

PRAWDA, jeśli ta metoda się powiedzie; w przeciwnym razie FALSE.TRUE if this method succeeds; otherwise FALSE.

UwagiRemarks

Ta metoda używa parametrów Rect, nColumns i pPalette do obliczenia odpowiedniej liczby lub wierszy i kolumn w kontrolce pasek koloru, a następnie wywołuje metodę CMFCColorBar:: Create .This method uses the rect, nColumns, and pPalette parameters to calculate the appropriate number or rows and columns in the color bar control, and then calls the CMFCColorBar::Create method.

CMFCColorBar:: ispaletteCMFCColorBar::CreatePalette

Inicjuje paletę z kolorami w określonej tablicy kolorów.Initializes a palette with the colors in a specified array of colors.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

ParametryParameters

arColorsarColors
podczas Tablica kolorów.[in] An array of colors.

paletypalette
podczas Paleta kolorów.[in] A palette of colors.

Wartość zwracanaReturn Value

PRAWDA, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie FALSE.TRUE if this method is successful; otherwise, FALSE.

CMFCColorBar::EnableAutomaticButtonCMFCColorBar::EnableAutomaticButton

Pokazuje lub ukrywa przycisk Automatyczny.Shows or hides the automatic button.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

ParametryParameters

lpszLabellpszLabel
podczas Etykieta tekstowa automatycznego (domyślnego) przycisku koloru lub wartość null.[in] The text label of the automatic (default) color button, or NULL.

Standardowa etykieta przycisku automatycznego jest Automatyczna.The standard label for the automatic button is Automatic.

colorAutomaticcolorAutomatic
podczas Domyślny kolor stosowany przez platformę po kliknięciu przycisku automatyczne.[in] The default color that the framework applies when you click the automatic button.

bEnablebEnable
podczas Wartość TRUE, aby włączyć przycisk Automatyczny; Wartość FALSE powoduje wyłączenie przycisku automatycznego.[in] TRUE to enable the automatic button; FALSE to disable the automatic button. Wartość domyślna to TRUE.The default value is TRUE.

UwagiRemarks

Etykieta tekstowa przycisku automatycznego jest usuwana, jeśli parametr lpszLabel ma wartość null lub parametr bEnable ma wartość false.The text label of the automatic button is deleted if the lpszLabel parameter is NULL or the bEnable parameter is FALSE.

CMFCColorBar::EnableOtherButtonCMFCColorBar::EnableOtherButton

Włącza lub wyłącza wyświetlanie okna dialogowego, które pozwala użytkownikowi wybrać więcej kolorów.Enables or disables the display of a dialog box that lets the user select more colors.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

ParametryParameters

lpszLabellpszLabel
podczas Etykieta tekstowa drugiego przycisku, która wyświetla więcej opcji kolorów lub wartość null.[in] The text label of the other button, which displays more color choices, or NULL.

Etykieta standardowa tego przycisku ma więcej kolorów...The standard label for this button is More Colors....

bAltColorDlgbAltColorDlg
podczas Wartość TRUE, aby wyświetlić okno dialogowe CMFCColorDialog ; Wartość FALSE powoduje wyświetlenie standardowego okna dialogowego CColorDialog .[in] TRUE to display the CMFCColorDialog dialog box; FALSE to display the standard CColorDialog dialog box. Wartość domyślna to TRUE.The default value is TRUE.

bEnablebEnable
podczas Wartość TRUE, aby włączyć przycisk; Wartość FALSE powoduje wyłączenie przycisku.[in] TRUE to enable the button; FALSE to disable the button. Wartość domyślna to TRUE.The default value is TRUE.

CMFCColorBar:: GetColorCMFCColorBar::GetColor

Pobiera aktualnie wybrany kolor.Retrieves the currently selected color.

COLORREF GetColor() const;

Wartość zwracanaReturn Value

Aktualnie wybrany kolor.The currently selected color.

CMFCColorBar::GetColorGridSizeCMFCColorBar::GetColorGridSize

Oblicza liczbę wierszy i kolumn w siatce kontrolki paska kolorów.Calculates the number of rows and columns in the grid of a color bar control.

CSize GetColorGridSize(BOOL bVertDock) const;

ParametryParameters

bVertDockbVertDock
podczas Wartość TRUE, aby wykonać obliczenia dla kontrolki zadokowanego paska kolorów w pionie; w przeciwnym razie wykonaj obliczenia dla kontrolki zadokowanej poziomo.[in] TRUE to perform the calculation for a vertically docked color bar control; otherwise, perform the calculation for a horizontally docked control.

Wartość zwracanaReturn Value

Obiekt CSize , którego cx składnik zawiera liczbę kolumn, których cy składnik zawiera liczbę wierszy.A CSize object whose cx component contains the number of columns and whose cy component contains the number of rows.

CMFCColorBar::GetCommandIDCMFCColorBar::GetCommandID

Pobiera identyfikator polecenia bieżącej kontrolki paska kolorów.Retrieves the command ID of the current color bar control.

UINT GetCommandID() const;

Wartość zwracanaReturn Value

Identyfikator polecenia.A command ID.

UwagiRemarks

Gdy użytkownik wybierze nowy kolor, struktura wyśle identyfikator polecenia w wiadomości WM_COMMAND, aby powiadomić element nadrzędny CMFCColorBar obiektu.When the user selects a new color, the framework sends the command ID in a WM_COMMAND message to notify the parent of the CMFCColorBar object.

CMFCColorBar::GetExtraHeightCMFCColorBar::GetExtraHeight

Oblicza dodatkową wysokość wymaganą przez bieżący pasek kolorów do wyświetlania różnych elementów interfejsu użytkownika, takich jak inne kolory przycisku lub dokumentu.Calculates the additional height that the current color bar requires to display miscellaneous user interface elements, such as the Other button or document colors.

int GetExtraHeight(int nNumColumns) const;

ParametryParameters

nNumColumnsnNumColumns
podczas Jeśli kontrolka pasek koloru zawiera kolory dokumentu, liczba kolumn do wyświetlenia w siatce kolorów dokumentu.[in] If the color bar control contains document colors, the number of columns to display in the grid of document colors. W przeciwnym razie ta wartość nie jest używana.Otherwise, this value is not used.

Wartość zwracanaReturn Value

Obliczona dodatkowa wysokość, która jest wymagana.The calculated extra height that is required.

CMFCColorBar::GetHighlightedColorCMFCColorBar::GetHighlightedColor

Pobiera kolor, który oznacza, że przycisk koloru ma fokus. oznacza to, że przycisk jest aktywny.Retrieves the color that signifies that a color button has the focus; that is, the button is hot.

COLORREF GetHighlightedColor() const;

Wartość zwracanaReturn Value

Wartość RGB.An RGB value.

UwagiRemarks

CMFCColorBar::GetHorzMarginCMFCColorBar::GetHorzMargin

Pobiera pionowy margines, czyli odstęp między komórką koloru w lewo lub w prawo i granicą obszaru klienta.Retrieves the horizontal margin, which is the space between the left or right color cell and the client area boundary.

int GetHorzMargin();

Wartość zwracanaReturn Value

Margines poziomy.The horizontal margin.

CMFCColorBar::GetVertMarginCMFCColorBar::GetVertMargin

Pobiera pionowy margines, czyli spację między górną lub dolną komórką koloru a granicą obszaru klienta.Retrieves the vertical margin, which is the space between the top or bottom color cell and the client area boundary.

int GetVertMargin() const;

Wartość zwracanaReturn Value

Pionowy margines.The vertical margin.

CMFCColorBar::InitColorsCMFCColorBar::InitColors

Inicjuje tablicę kolorów z kolorami z określonej palety lub z domyślną paletą systemu.Initializes an array of colors with the colors in a specified palette, or with the system default palette.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

ParametryParameters

pPalettepPalette
podczas Wskaźnik do obiektu palety lub ma wartość NULL.[in] A pointer to a palette object, or NULL. Jeśli ten parametr ma wartość NULL, ta metoda używa domyślnej palety systemu operacyjnego.If this parameter is NULL, this method uses the default palette of the operating system.

arColorsarColors
podczas Tablica kolorów.[in] An array of colors.

Wartość zwracanaReturn Value

Liczba elementów w tablicy kolorów.The number of elements in the array of colors.

CMFCColorBar::IsTearOffCMFCColorBar::IsTearOff

Wskazuje, czy bieżący pasek kolorów jest było dokować.Indicates whether the current color bar is dockable.

BOOL IsTearOff() const;

Wartość zwracanaReturn Value

PRAWDA, jeśli bieżącym formantem paska kolorów jest było dokować; w przeciwnym razie FALSE.TRUE if the current color bar control is dockable; otherwise, FALSE.

UwagiRemarks

Jeśli kontrolka pasek koloru jest było dokowaća, można ją wycofać z paska sterowania i zadokować w innej lokalizacji.If the color bar control is dockable, it can be torn off a control bar and docked at another location.

CMFCColorBar::OnKeyCMFCColorBar::OnKey

Wywoływane przez platformę, gdy użytkownik naciśnie przycisk klawiatury.Called by the framework when a user presses a keyboard button.

virtual BOOL OnKey(UINT nChar);

ParametryParameters

nCharnChar
podczas Kod klucza wirtualnego dla klawisza naciśniętego przez użytkownika.[in] The virtual-key code for the key that a user pressed.

Wartość zwracanaReturn Value

TRUE, jeśli ta metoda przetwarza określony klucz; w przeciwnym razie FALSE.TRUE if this method processes the specified key; otherwise, FALSE.

CMFCColorBar::OnSendCommandCMFCColorBar::OnSendCommand

Wywoływane przez platformę, aby zamknąć hierarchię wyskakujących kontrolek.Called by the framework to close a hierarchy of pop-up controls.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

ParametryParameters

pButtonpButton
podczas Wskaźnik do kontrolki, która znajduje się na pasku narzędzi.[in] Pointer to a control that resides on a toolbar.

Wartość zwracanaReturn Value

PRAWDA, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie FALSE.TRUE if this method is successful; otherwise, FALSE.

CMFCColorBar::OnUpdateCmdUICMFCColorBar::OnUpdateCmdUI

Wywoływane przez platformę, aby włączyć lub wyłączyć element interfejsu użytkownika kontrolki paska kolorów przed wyświetleniem elementu.Called by the framework to enable or disable a user-interface item of a color bar control before the item is displayed.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

ParametryParameters

pTargetpTarget
podczas Wskaźnik do okna zawierającego element interfejsu użytkownika do zaktualizowania.[in] Pointer to a window that contains a user-interface item to update.

bDisableIfNoHndlerbDisableIfNoHndler
podczas Wartość TRUE powoduje wyłączenie elementu User-Interface, jeśli nie zdefiniowano procedury obsługi w mapie komunikatów; w przeciwnym razie FALSE.[in] TRUE to disable the user-interface item if no handler is defined in a message map; otherwise, FALSE.

UwagiRemarks

Gdy użytkownik aplikacji kliknie element interfejs użytkownika, element musi wiedzieć, czy powinien być wyświetlany jako włączony czy wyłączony.When a user of your application clicks a user-interface item, the item must know whether it should be displayed as enabled or disabled. Obiekt docelowy komunikatu polecenia dostarcza te informacje przez implementację procedury obsługi poleceń ON_UPDATE_COMMAND_UI.The target of the command message provides this information by implementing an ON_UPDATE_COMMAND_UI command handler. Użyj tej metody, aby pomóc w przetwarzaniu polecenia.Use this method to help process the command. Aby uzyskać więcej informacji, zobacz Klasa CCmdUI.For more information, see CCmdUI Class.

CMFCColorBar::OpenColorDialogCMFCColorBar::OpenColorDialog

Otwiera okno dialogowe koloru.Opens a color dialog box.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

ParametryParameters

colorDefaultcolorDefault
podczas Kolor wybrany domyślnie, gdy zostanie otwarte okno dialogowe koloru.[in] The color that is selected by default when the color dialog box opens.

colorRescolorRes
określoną Kolor wybrany przez użytkownika.[out] The color that a user selected.

Wartość zwracanaReturn Value

PRAWDA, jeśli użytkownik zaznaczył kolor; FAŁSZ, jeśli użytkownik anulował okno dialogowe koloru.TRUE if the user selected a color; FALSE if the user canceled the color dialog box.

UwagiRemarks

CMFCColorBar:: RebuildCMFCColorBar::Rebuild

Całkowicie odświeża kontrolkę pasek koloru.Completely redraws the color bar control.

virtual void Rebuild();

CMFCColorBar::SelectPaletteCMFCColorBar::SelectPalette

Ustawia logiczną paletę określonego kontekstu urządzenia do palety przycisku nadrzędnego bieżącej kontrolki paska kolorów.Sets the logical palette of the specified device context to the palette of the parent button of the current color bar control.

CPalette* SelectPalette(CDC* pDC);

ParametryParameters

DomenypDC
podczas Wskaźnik do kontekstu urządzenia przycisku nadrzędnego bieżącej kontrolki paska kolorów.[in] Pointer to the device context of the parent button of the current color bar control.

Wartość zwracanaReturn Value

Wskaźnik do palety, która jest zastępowana przez paletę przycisku nadrzędnego bieżącej kontrolki paska kolorów.Pointer to the palette that is replaced by the palette of the parent button of the current color bar control.

CMFCColorBar:: SetColorCMFCColorBar::SetColor

Ustawia kolor, który jest aktualnie wybrany.Sets the color that is currently selected.

void SetColor(COLORREF color);

ParametryParameters

Kolorcolor
podczas Wartość koloru RGB.[in] An RGB color value.

CMFCColorBar:: SetColorNameCMFCColorBar::SetColorName

Ustawia nową nazwę określonego koloru.Sets a new name for a specified color.

static void SetColorName(
    COLORREF color,
    const CString& strName);

ParametryParameters

Kolorcolor
podczas Wartość RGB koloru.[in] The RGB value of a color.

strNamestrName
podczas Nowa nazwa określonego koloru.[in] The new name for the specified color.

UwagiRemarks

Ta metoda zmienia nazwę określonego koloru we wszystkich CMFCColorBar obiektach w aplikacji.This method changes the name of the specified color in all CMFCColorBar objects in your application.

CMFCColorBar::SetCommandIDCMFCColorBar::SetCommandID

Ustawia nowy identyfikator polecenia dla kontrolki paska kolorów.Sets a new command ID for a color bar control.

void SetCommandID(UINT nCommandID);

ParametryParameters

nCommandIDnCommandID
podczas Identyfikator polecenia.[in] A command ID.

UwagiRemarks

Wywołaj tę metodę, aby zmodyfikować identyfikator polecenia kontrolki pasek koloru i powiadomienia okno nadrzędne kontrolki, że identyfikator został zmieniony.Call this method to modify the command ID of a color bar control and to notify the parent window of the control that the ID has changed.

CMFCColorBar::SetDocumentColorsCMFCColorBar::SetDocumentColors

Ustawia listę kolorów, które są używane w bieżącym dokumencie.Sets the list of colors that are used in the current document.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

ParametryParameters

lpszCaptionlpszCaption
podczas Podpis wyświetlany, gdy kontrolka pasek koloru nie jest zadokowany.[in] A caption that is displayed when the color bar control is not docked.

lstDocColorslstDocColors
podczas Lista kolorów, które zastępują kolory bieżącego dokumentu.[in] A list of colors that replaces the current document colors.

bShowWhenDockedbShowWhenDocked
podczas PRAWDA, aby pokazać kolory dokumentu, gdy kontrolka pasek koloru jest zadokowany. w przeciwnym razie FALSE.[in] TRUE to show document colors when the color bar control is docked; otherwise, FALSE. Wartość domyślna to FALSE.The default value is FALSE.

UwagiRemarks

Kolory dokumentu to kolory, które są obecnie używane w dokumencie.Document colors are the colors that are currently used in a document. Struktura automatycznie zachowuje listę kolorów dokumentu, ale można użyć tej metody do zmodyfikowania listy.The framework automatically maintains a list of document colors, but you can use this method to modify the list.

CMFCColorBar::SetHorzMarginCMFCColorBar::SetHorzMargin

Ustawia margines poziomy, czyli odstęp między komórką koloru w lewo lub w prawo i granicą obszaru klienta.Sets the horizontal margin, which is the space between the left or right color cell and the boundary of the client area.

void SetHorzMargin(int nHorzMargin);

ParametryParameters

nHorzMarginnHorzMargin
podczas Margines poziomy w pikselach.[in] The horizontal margin, in pixels.

UwagiRemarks

Domyślnie Konstruktor CMFCColorBar:: CMFCColorBar ustawia margines poziomy na 4 piksele.By default, the CMFCColorBar::CMFCColorBar constructor sets the horizontal margin to 4 pixels.

CMFCColorBar::SetPropListCMFCColorBar::SetPropList

Ustawia m_pWndPropList element członkowski danych chronionych na określony wskaźnik do kontrolki siatki właściwości.Sets the m_pWndPropList protected data member to the specified pointer to a property grid control.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

ParametryParameters

pWndListpWndList
podczas Wskaźnik do obiektu kontrolki siatki właściwości.[in] Pointer to property grid control object.

CMFCColorBar::SetVertMarginCMFCColorBar::SetVertMargin

Ustawia pionowy margines, czyli spację między górną lub dolną komórką koloru a granicą obszaru klienta.Sets the vertical margin, which is the space between the top or bottom color cell and the client area boundary.

void SetVertMargin(int nVertMargin);

ParametryParameters

nVertMarginnVertMargin
podczas Pionowy margines (w pikselach).[in] The vertical margin, in pixels.

UwagiRemarks

Domyślnie Konstruktor CMFCColorBar:: CMFCColorBar ustawia pionowy margines na 4 piksele.By default, the CMFCColorBar::CMFCColorBar constructor sets the vertical margin to 4 pixels.

CMFCColorBar::ShowCommandMessageStringCMFCColorBar::ShowCommandMessageString

Żąda okna ramki, które jest właścicielem kontrolki pasek koloru, aby zaktualizować wiersz komunikatu na pasku stanu.Requests the frame window that owns the color bar control to update the message line in the status bar.

virtual void ShowCommandMessageString(UINT uiCmdId);

ParametryParameters

uiCmdIduiCmdId
podczas Identyfikator polecenia.[in] A command ID. (Ten parametr jest ignorowany).(This parameter is ignored.)

UwagiRemarks

Ta metoda wysyła komunikat WM_SETMESSAGESTRING do właściciela kontrolki pasek koloru.This method sends the WM_SETMESSAGESTRING message to the owner of the color bar control.

Zobacz teżSee also

Wykres hierarchiiHierarchy Chart
KlasyClasses