Класс CWndCWnd Class

Предоставляет базовую функциональность всех классов окон в библиотеке Microsoft Foundation Class.Provides the base functionality of all window classes in the Microsoft Foundation Class Library.

СинтаксисSyntax

class CWnd : public CCmdTarget

УчастникиMembers

Открытые конструкторыPublic Constructors

ИмяName ОписаниеDescription
CWnd::CWndCWnd::CWnd Формирует объект CWnd.Constructs a CWnd object.

Открытые методыPublic Methods

ИмяName ОписаниеDescription
CWnd::accDoDefaultActionCWnd::accDoDefaultAction Вызывается платформой для выполнения объектом действия по умолчанию.Called by the framework to perform the object's default action.
CWnd::accHitTestCWnd::accHitTest Вызывается платформой для извлечения дочернего элемента или дочернего объекта в заданной точке экрана.Called by the framework to retrieve the child element or child object at a given point on the screen.
CWnd::accLocationCWnd::accLocation Вызывается платформой для получения текущего положения указанного объекта на экране.Called by the framework to retrieve the specified object's current screen location.
CWnd::accNavigateCWnd::accNavigate Вызывается платформой для перехода к другому элементу пользовательского интерфейса внутри контейнера и, если возможно, для извлечения объекта.Called by the framework to traverse to another user interface element within a container and if possible, retrieve the object.
CWnd::accSelectCWnd::accSelect Вызывается платформой для изменения выбранной области или перемещения фокуса клавиатурного ввода указанного объекта.Called by the framework to modify the selection or move the keyboard focus of the specified object.
CWnd::AnimateWindowCWnd::AnimateWindow Анимирует связанный объект"Окно".Animates the associated window object.
CWnd::ArrangeIconicWindowsCWnd::ArrangeIconicWindows Упорядочивает все свернутые (преобразованные в значки) дочерние окна.Arranges all the minimized (iconic) child windows.
CWnd::AttachCWnd::Attach Прикрепляет дескриптор Windows к объекту CWnd.Attaches a Windows handle to a CWnd object.
CWnd::BeginModalStateCWnd::BeginModalState Данная функция-член вызывается для преобразования окна фрейма в модальное.Call this member function to make a frame window modal.
CWnd::BeginPaintCWnd::BeginPaint Подготавливает CWnd к рисованию.Prepares CWnd for painting.
CWnd::BindDefaultPropertyCWnd::BindDefaultProperty Привязывает простое стандартное свойство привязки вызывающего объекта, отмеченное в библиотеке типов, к курсору, связанному с элементом управления источником данных.Binds the calling object's default simple bound property, as marked in the type library, to a cursor associated with a data-source control.
CWnd::BindPropertyCWnd::BindProperty Привязывает связанное с курсором свойство на элементе управления, привязанном к данным, к элементу управления источником данных и регистрирует такую связь в диспетчере привязки MFC.Binds a cursor-bound property on a data-bound control to a data-source control and registers that relationship with the MFC binding manager.
CWnd::BringWindowToTopCWnd::BringWindowToTop Перемещает CWnd на вершину стека перекрывающихся окон.Brings CWnd to the top of a stack of overlapping windows.
CWnd::CalcWindowRectCWnd::CalcWindowRect Вызывается для вычисления размеров прямоугольной области окна из клиентской прямоугольной области.Called to calculate the window rectangle from the client rectangle.
CWnd::CancelToolTipsCWnd::CancelToolTips Отключает элемент управления "Всплывающая подсказка".Disables the tooltip control.
CWnd::CenterWindowCWnd::CenterWindow Выравнивает окно по центру относительно его родительских окон.Centers a window relative to its parent.
CWnd::ChangeClipboardChainCWnd::ChangeClipboardChain Удаляет объект CWnd из цепи в окне буфера обмена.Removes CWnd from the chain of Clipboard viewers.
CWnd::CheckDlgButtonCWnd::CheckDlgButton Устанавливает флажок для элемента управления "Кнопка" или снимает его.Places a check mark next to or removes a check mark from a button control.
CWnd::CheckRadioButtonCWnd::CheckRadioButton Отмечает указанный переключатель и убирает отметку для остальных переключателей в указанной группе кнопок.Checks the specified radio button and removes the check mark from all other radio buttons in the specified group of buttons.
CWnd::ChildWindowFromPointCWnd::ChildWindowFromPoint Определяет, в каком из указанных дочерних окон содержится заданная точка (если такие окна имеются).Determines which, if any, of the child windows contains the specified point.
CWnd::ClientToScreenCWnd::ClientToScreen Преобразует клиентские координаты указанной точки или прямоугольника на экране в экранные координаты.Converts the client coordinates of a given point or rectangle on the display to screen coordinates.
CWnd::CloseWindowCWnd::CloseWindow Сворачивает окно.Minimizes the window.
CWnd::ContinueModalCWnd::ContinueModal Сохраняет модальное состояние окна.Continues a window's modal status.
CWnd::CreateCWnd::Create Создает и инициализирует дочернее окно, связанное с объектом CWnd.Creates and initializes the child window associated with the CWnd object.
CWnd::CreateAccessibleProxyCWnd::CreateAccessibleProxy Создает прокси-сервер Active Accessibility для указанного объекта.Creates an Active Accessibility proxy for the specified object.
CWnd::CreateCaretCWnd::CreateCaret Создает новую форму системного курсора и получает его во владение.Creates a new shape for the system caret and gets ownership of the caret.
CWnd::CreateControlCWnd::CreateControl Создает элемент управления ActiveX, который будет представлен в программе MFC объектом CWnd.Create an ActiveX control that will be represented in an MFC program by a CWnd object.
CWnd::CreateExCWnd::CreateEx Создает перекрывающееся, всплывающее или дочернее окно Windows и прикрепляет его к объекту CWnd.Creates a Windows overlapped, pop-up, or child window and attaches it to a CWnd object.
CWnd::CreateGrayCaretCWnd::CreateGrayCaret Создает серый блок для системного курсора и получает этот курсор во владение.Creates a gray block for the system caret and gets ownership of the caret.
CWnd::CreateSolidCaretCWnd::CreateSolidCaret Создает сплошной блок для системного курсора и получает этот курсор во владение.Creates a solid block for the system caret and gets ownership of the caret.
CWnd::DeleteTempMapCWnd::DeleteTempMap Автоматически вызывается обработчиком времени простоя CWinApp и удаляет все временные объекты CWnd, созданные FromHandle.Called automatically by the CWinApp idle-time handler and deletes any temporary CWnd objects created by FromHandle.
CWnd::DestroyWindowCWnd::DestroyWindow Уничтожает прикрепленное окно Windows.Destroys the attached Windows window.
CWnd::DetachCWnd::Detach Отсоединяет дескриптор Windows от объекта CWnd и возвращает дескриптор.Detaches a Windows handle from a CWnd object and returns the handle.
CWnd::DlgDirListCWnd::DlgDirList Заполняет список файлами или каталогами.Fills a list box with a file or directory listing.
CWnd::DlgDirListComboBoxCWnd::DlgDirListComboBox Заполняет список элемента управления "Поле со списком" перечнем файлов или каталогов.Fills the list box of a combo box with a file or directory listing.
CWnd::DlgDirSelectCWnd::DlgDirSelect Извлекает текущее выделение из списка.Retrieves the current selection from a list box.
CWnd::DlgDirSelectComboBoxCWnd::DlgDirSelectComboBox Извлекает текущее выделение списка элемента управления "Поле со списком".Retrieves the current selection from the list box of a combo box.
CWnd::DragAcceptFilesCWnd::DragAcceptFiles Указывает, что в окно можно перетаскивать файлы.Indicates the window will accept dragged files.
CWnd::DragDetectCWnd::DragDetect Захватывает мышь и отслеживает ее движение, пока пользователь не отпустит левую кнопку мыши, не нажмет клавишу ESC или не переместит мышь за пределы прямоугольника перетаскивания, в котором находится указанная точка.Captures the mouse and tracks its movement until the user releases the left button, presses the ESC key, or moves the mouse outside the drag rectangle around the specified point.
CWnd::DrawAnimatedRectsCWnd::DrawAnimatedRects Рисует каркасный прямоугольник и анимирует его для обозначения открытия значка, а также сворачивания или разворачивания окна.Draws a wire-frame rectangle and animates it to indicate the opening of an icon or the minimizing or maximizing of a window.
CWnd::DrawCaptionCWnd::DrawCaption Рисует заголовок.Draws a caption.
CWnd::DrawMenuBarCWnd::DrawMenuBar Перерисовывает строку меню.Redraws the menu bar.
CWnd::EnableActiveAccessibilityCWnd::EnableActiveAccessibility Включает пользовательские функции Active Accessibility.Enables user-defined Active Accessibility functions.
CWnd::EnableDynamicLayoutCWnd::EnableDynamicLayout Включает динамическое изменение положения и размера дочерних окон при изменении размеров родительского окна.Enables the position and size of child windows to adjust dynamically when the user resizes the window.
CWnd::EnableD2DSupportCWnd::EnableD2DSupport Включает или отключает поддержку окнами D2D.Enables or disables window D2D support. Данный метод следует вызывать до инициализации основного окна.Call this method before the main window is initialized.
CWnd::EnableScrollBarCWnd::EnableScrollBar Включает или выключает одну или обе стрелки полосы прокрутки.Enables or disables one or both arrows of a scroll bar.
CWnd::EnableScrollBarCtrlCWnd::EnableScrollBarCtrl Включает или выключает элемент управления "Полоса прокрутки" того же уровня.Enables or disables a sibling scroll-bar control.
CWnd::EnableToolTipsCWnd::EnableToolTips Включает элемент управления "Всплывающая подсказка".Enables the tooltip control.
CWnd::EnableTrackingToolTipsCWnd::EnableTrackingToolTips Включает элемент управления "Всплывающая подсказка" в режиме отслеживания.Enables the tooltip control in tracking mode.
CWnd::EnableWindowCWnd::EnableWindow Разрешает или запрещает ввод с помощью мыши и клавиатуры.Enables or disables mouse and keyboard input.
CWnd::EndModalLoopCWnd::EndModalLoop Снимает с окна модальное состояние.Ends a window's modal status.
CWnd::EndModalStateCWnd::EndModalState Данная функция-член вызывается для изменения состояния окна с модального на немодальное.Call this member function to change a frame window from modal to modeless.
CWnd::EndPaintCWnd::EndPaint Отмечает завершение рисования.Marks the end of painting.
CWnd::ExecuteDlgInitCWnd::ExecuteDlgInit Инициирует ресурс диалогового окна.Initiates a dialog resource.
CWnd::FilterToolTipMessageCWnd::FilterToolTipMessage Извлекает заголовок или текст, связанный с элементом управления в диалоговом окне.Retrieves the title or text associated with a control in a dialog box.
CWnd::FindWindowCWnd::FindWindow Возвращает дескриптор окна, идентифицированного по имени и классу.Returns the handle of the window, which is identified by its window name and window class.
CWnd::FindWindowExCWnd::FindWindowEx Возвращает дескриптор окна, идентифицированного по имени и классу.Returns the handle of the window, which is identified by its window name and window class.
CWnd::FlashWindowCWnd::FlashWindow Окно однократно мигает.Flashes the window once.
CWnd::FlashWindowExCWnd::FlashWindowEx Мигание окна с дополнительными возможностями.Flashes the window with additional functionality.
CWnd::FromHandleCWnd::FromHandle Возвращает указатель на объект CWnd, когда дескриптор передается окну.Returns a pointer to a CWnd object when given a handle to a window. Если объект CWnd не прикреплен к дескриптору, создается и прикрепляется временный объект CWnd.If a CWnd object is not attached to the handle, a temporary CWnd object is created and attached.
CWnd::FromHandlePermanentCWnd::FromHandlePermanent Возвращает указатель на объект CWnd, когда дескриптор передается окну.Returns a pointer to a CWnd object when given a handle to a window.
CWnd::get_accChildCWnd::get_accChild Вызывается платформой для извлечения адреса интерфейса IDispatch для указанного дочернего элемента.Called by the framework to retrieve the address of an IDispatch interface for the specified child.
CWnd::get_accChildCountCWnd::get_accChildCount Вызывается платформой для извлечения количества дочерних элементов, принадлежащих этому объекту.Called by the framework to retrieve the number of children belonging to this object.
CWnd::get_accDefaultActionCWnd::get_accDefaultAction Вызывается платформой для извлечения строки, описывающей действие объекта по умолчанию.Called by the framework to retrieve a string that describes the object's default action.
CWnd::get_accDescriptionCWnd::get_accDescription Вызывается платформой для извлечения строки, описывающей внешний вид указанного объекта.Called by framework to retrieve a string that describes the visual appearance of the specified object.
CWnd::get_accFocusCWnd::get_accFocus Вызывается платформой для извлечения объекта, имеющего фокус клавиатурного ввода.Called by the framework to retrieve the object that has the keyboard focus.
CWnd::get_accHelpCWnd::get_accHelp Вызывается фректовой для извлечения строки справки объекта.Called by the framework to retrieve an object's Help property string.
CWnd::get_accHelpTopicCWnd::get_accHelpTopic Вызывается платформой для извлечения полного пути файла WinHelp, связанного с указанным объектом и идентификатором нужного раздела в файле.Called by the framework to retrieve the full path of the WinHelp file associated with the specified object and the identifier of the appropriate topic within that file.
CWnd::get_accKeyboardShortcutCWnd::get_accKeyboardShortcut Вызывается платформой для извлечения сочетания клавиш указанного объекта или клавиши доступа к нему.Called by the framework to retrieve the specified object's shortcut key or access key.
CWnd::get_accNameCWnd::get_accName Вызывается платформой для извлечения имени указанного объекта.Called by the framework to retrieve the name of the specified object.
CWnd::get_accParentCWnd::get_accParent Вызывается платформой для извлечения интерфейса IDispatch родительского элемента данного объекта.Called by the framework to retrieve the IDispatch interface of the object's parent.
CWnd::get_accRoleCWnd::get_accRole Вызывается платформой для извлечения информации, описывающей роль указанного объекта.Called by the framework to retrieve information that describes the role of the specified object.
CWnd::get_accSelectionCWnd::get_accSelection Вызывается платформой для извлечения выбранного дочернего элемента этого объекта.Called by the framework to retrieve the selected children of this object.
CWnd::get_accStateCWnd::get_accState Вызывается платформой для извлечения текущего состояния указанного объекта.Called by the framework to retrieve the current state of the specified object.
CWnd::get_accValueCWnd::get_accValue Вызывается платформой для извлечения значения указанного объекта.Called by the framework to retrieve the value of the specified object.
CWnd::GetActiveWindowCWnd::GetActiveWindow Извлекает активное окно.Retrieves the active window.
CWnd::GetAncestorCWnd::GetAncestor Извлекает объект окна-предка для указанного окна.Retrieves the ancestor window object of the specified window.
CWnd::GetCaptureCWnd::GetCapture Извлекает объект CWnd, захваченный мышью.Retrieves the CWnd that has the mouse capture.
CWnd::GetCaretPosCWnd::GetCaretPos Извлекает клиентские координаты текущего положения курсора.Retrieves the client coordinates of the caret's current position.
CWnd::GetCheckedRadioButtonCWnd::GetCheckedRadioButton Возвращает идентификатор отмеченного переключателя в группе кнопок.Returns the ID of the currently checked radio button in a group of buttons.
CWnd::GetClientRectCWnd::GetClientRect Возвращает размеры клиентской области CWnd.Gets the dimensions of the CWnd client area.
CWnd::GetClipboardOwnerCWnd::GetClipboardOwner Извлекает указатель на текущего владельца буфера обмена.Retrieves a pointer to the current owner of the Clipboard.
CWnd::GetClipboardViewerCWnd::GetClipboardViewer Извлекает указатель на первое окно в цепочке окон буфера обмена.Retrieves a pointer to the first window in the chain of Clipboard viewers.
CWnd::GetControlUnknownCWnd::GetControlUnknown Извлекает указатель на неизвестный элемент управления ActiveX.Retrieves a pointer to an unknown ActiveX control.
CWnd::GetDCCWnd::GetDC Извлекает контекст отображения для клиентской области.Retrieves a display context for the client area.
CWnd::GetDCExCWnd::GetDCEx Извлекает контекст отображения для клиентской области и включает обрезку при рисовании.Retrieves a display context for the client area, and enables clipping while drawing.
CWnd::GetDCRenderTargetCWnd::GetDCRenderTarget Извлекает целевой объект отрисовки из контекста устройства для окна CWnd.Retrieves the device context (DC) render target for the CWnd window.
CWnd::GetDescendantWindowCWnd::GetDescendantWindow Выполняет поиск всех окон-потомков и возвращает окно с указанным идентификатором.Searches all descendant windows and returns the window with the specified ID.
CWnd::GetDesktopWindowCWnd::GetDesktopWindow Извлекает окно рабочего стола Windows.Retrieves the Windows desktop window.
CWnd::GetDlgCtrlIDCWnd::GetDlgCtrlID Если окно CWnd является дочерним, вызов этой функции возвращает значение его идентификатора.If the CWnd is a child window, calling this function returns its ID value.
CWnd::GetDlgItemCWnd::GetDlgItem Извлекает из указанного диалогового окна элемент управления с указанным идентификатором.Retrieves the control with the specified ID from the specified dialog box.
CWnd::GetDlgItemIntCWnd::GetDlgItemInt Преобразует текст элемента управления в указанном диалоговом окне в целое число.Translates the text of a control in the given dialog box to an integer value.
CWnd::GetDlgItemTextCWnd::GetDlgItemText Извлекает заголовок или текст, связанный с элементом управления.Retrieves the caption or text associated with a control.
CWnd::GetDSCCursorCWnd::GetDSCCursor Извлекает указатель на базовый курсор, который определяется свойствами DataSource, UserName, Password, и SQL элемента управления источником данных.Retrieves a pointer to the underlying cursor that is defined by the DataSource, UserName, Password, and SQL properties of a data-source control.
CWnd::GetDynamicLayoutCWnd::GetDynamicLayout Извлекает указатель на объект диспетчера динамического макета.Retrieves a pointer to the dynamic layout manager object.
CWnd::GetExStyleCWnd::GetExStyle Возвращает расширенный стиль окна.Returns the window's extended style.
CWnd::GetFocusCWnd::GetFocus Извлекает объект CWnd, на котором в данный момент установлен фокус ввода.Retrieves the CWnd that currently has the input focus.
CWnd::GetFontCWnd::GetFont Извлекает текущий шрифт.Retrieves the current font.
CWnd::GetForegroundWindowCWnd::GetForegroundWindow Возвращает указатель на окно переднего плана (окно верхнего уровня, в котором пользователь работает на данный момент).Returns a pointer to the foreground window (the top-level window with which the user is currently working).
CWnd::GetIconCWnd::GetIcon Извлекает дескриптор значка.Retrieves the handle to an icon.
CWnd::GetLastActivePopupCWnd::GetLastActivePopup Определяет последнее проявлявшее активность всплывающее окно, принадлежащее классу CWnd.Determines which pop-up window owned by CWnd was most recently active.
CWnd::GetLayeredWindowAttributesCWnd::GetLayeredWindowAttributes Получает ключ цвета прозрачности многослойного окна.Retrieves the opacity and transparency color key of a layered window.
CWnd::GetMenuCWnd::GetMenu Извлекает указатель на заданное меню.Retrieves a pointer to the specified menu.
CWnd::GetNextDlgGroupItemCWnd::GetNextDlgGroupItem Ищет следующий (или предыдущий) элемент управления в группе элементов управления.Searches for the next (or previous) control within a group of controls.
CWnd::GetNextDlgTabItemCWnd::GetNextDlgTabItem Извлекает первый элемент управления с WS_TABSTOP стиле, который следует (или предшествует) указанному элементу управления.Retrieves the first control with the WS_TABSTOP style that follows (or precedes) the specified control.
CWnd::GetNextWindowCWnd::GetNextWindow Возвращает следующее или предыдущее окно в списке диспетчера окон.Returns the next (or previous) window in the window manager's list.
CWnd::GetOleControlSiteCWnd::GetOleControlSite Извлекает настраиваемый сайт для указанного элемента управления ActiveX.Retrieves the custom site for the specified ActiveX control.
CWnd::GetOpenClipboardWindowCWnd::GetOpenClipboardWindow Извлекает указатель на окно с открытым буфером обмена.Retrieves a pointer to the window that currently has the Clipboard open.
CWnd::GetOwnerCWnd::GetOwner Извлекает указатель на владельца объекта CWnd.Retrieves a pointer to the owner of a CWnd.
CWnd::GetParentCWnd::GetParent Извлекает родительское окно объекта CWnd (при наличии).Retrieves the parent window of CWnd (if any).
CWnd::GetParentFrameCWnd::GetParentFrame Извлекает родительское окно фрейма объекта CWnd.Retrieves the CWnd object's parent frame window.
CWnd::GetParentOwnerCWnd::GetParentOwner Возвращает указатель на родительское окно дочернего окна.Returns a pointer to a child window's parent window.
CWnd::GetPropertyCWnd::GetProperty Извлекает свойство элемента управления ActiveX.Retrieves an ActiveX control property.
CWnd::GetRenderTargetCWnd::GetRenderTarget Возвращает целевой объект отрисовки, связанный с данным окном.Gets a render target that is associated with this window.
CWnd::GetSafeHwndCWnd::GetSafeHwnd Возвращает m_hWnd, или NULL, если этот указатель NULL.Returns m_hWnd, or NULL if the this pointer is NULL.
CWnd::GetSafeOwnerCWnd::GetSafeOwner Извлекает безопасного владельца указанного окна.Retrieves the safe owner for the given window.
CWnd::GetScrollBarCtrlCWnd::GetScrollBarCtrl Возвращает элемент управления "Полоса прокрутки" того же уровня.Returns a sibling scroll-bar control.
CWnd::GetScrollBarInfoCWnd::GetScrollBarInfo Извлекает сведения об указанной полосе прокрутки.Retrieves information about the specified scroll bar.
CWnd::GetScrollInfoCWnd::GetScrollInfo Извлекает данные о полосе прокрутки, содержащиеся в структуре SCROLLINFO.Retrieves the information that the SCROLLINFO structure maintains about a scroll bar.
CWnd::GetScrollLimitCWnd::GetScrollLimit Извлекает ограничение полосы прокрутки.Retrieves the limit of the scroll bar.
CWnd::GetScrollPosCWnd::GetScrollPos Извлекает текущее положение ползунка.Retrieves the current position of a scroll box.
CWnd::GetScrollRangeCWnd::GetScrollRange Копирует текущие значения минимума и максимума указанной полосы прокрутки.Copies the current minimum and maximum scroll-bar positions for the given scroll bar.
CWnd::GetStyleCWnd::GetStyle Возвращает стиль текущего окна.Returns the current window style.
CWnd::GetSystemMenuCWnd::GetSystemMenu Позволяет приложению получить доступ к оконному меню для копирования и изменения.Allows the application to access the Control menu for copying and modification.
CWnd::GetTitleBarInfoCWnd::GetTitleBarInfo Извлекает сведения об указанной строке заголовка.Retrieves information about the specified title bar.
CWnd::GetTopLevelFrameCWnd::GetTopLevelFrame Извлекает окно фрейма верхнего уровня для указанного окна.Retrieves the window's top-level frame window.
CWnd::GetTopLevelOwnerCWnd::GetTopLevelOwner Извлекает окно верхнего уровня.Retrieves the top-level window.
CWnd::GetTopLevelParentCWnd::GetTopLevelParent Извлекает родительское окно верхнего уровня для указанного окна.Retrieves the window's top-level parent.
CWnd::GetTopWindowCWnd::GetTopWindow Возвращает первое дочернее окно, принадлежащее к классу CWnd.Returns the first child window that belongs to the CWnd.
CWnd::GetUpdateRectCWnd::GetUpdateRect Извлекает координаты наименьшего прямоугольника, в который полностью входит область обновления CWnd.Retrieves the coordinates of the smallest rectangle that completely encloses the CWnd update region.
CWnd::GetUpdateRgnCWnd::GetUpdateRgn Извлекает область обновления CWnd.Retrieves the CWnd update region.
CWnd::GetWindowCWnd::GetWindow Возвращает окно, связанное с данным окном указанным образом.Returns the window with the specified relationship to this window.
CWnd::GetWindowContextHelpIdCWnd::GetWindowContextHelpId Извлекает идентификатор контекста для справки.Retrieves the help context identifier.
CWnd::GetWindowDCCWnd::GetWindowDC Извлекает контекст отображения для всего окна, включая его строку заголовка, меню и полосы прокрутки.Retrieves the display context for the whole window, including the caption bar, menus, and scroll bars.
CWnd::GetWindowedChildCountCWnd::GetWindowedChildCount Возвращает количество связанных дочерних окон.Returns the number of associated child windows.
CWnd::GetWindowInfoCWnd::GetWindowInfo Возвращает информацию об окне.Returns information about the window.
CWnd::GetWindowlessChildCountCWnd::GetWindowlessChildCount Возвращает количество связанных безоконных дочерних окон.Returns the number of associated windowless child windows.
CWnd::GetWindowPlacementCWnd::GetWindowPlacement Получает состояние отображения, а также обычное (восстановленное), свернутое и развернутое состояния окна.Retrieves the show state and the normal (restored), minimized, and maximized positions of a window.
CWnd::GetWindowRectCWnd::GetWindowRect Получает экранные координаты объекта CWnd.Gets the screen coordinates of CWnd.
CWnd::GetWindowRgnCWnd::GetWindowRgn Извлекает копию области окна.Retrieves a copy of the window region of a window.
CWnd::GetWindowTextCWnd::GetWindowText Возвращает текст или заголовок окна (при наличии).Returns the window text or caption title (if it has one).
CWnd::GetWindowTextLengthCWnd::GetWindowTextLength Возвращает длину текста или заголовка окна.Returns the length of the window's text or caption title.
CWnd::HideCaretCWnd::HideCaret Скрывает курсор, удалив его из отображаемой области.Hides the caret by removing it from the display screen.
CWnd::HiliteMenuItemCWnd::HiliteMenuItem Выделяет или отменяет выделение элемента меню верхнего уровня (в строке меню).Highlights or removes the highlighting from a top-level (menu-bar) menu item.
CWnd::HtmlHelpCWnd::HtmlHelp Вызывается для запуска приложения HTMLHelp.Called to initiate the HTMLHelp application.
CWnd::InvalidateCWnd::Invalidate Делает недействительной всю клиентскую область.Invalidates the entire client area.
CWnd::InvalidateRectCWnd::InvalidateRect Делает недействительной клиентскую область в пределах заданного прямоугольника, добавляя этот прямоугольник в текущую область обновления.Invalidates the client area within the given rectangle by adding that rectangle to the current update region.
CWnd::InvalidateRgnCWnd::InvalidateRgn Делает недействительной клиентскую область в пределах заданной области, добавляя эту область в текущую область обновления.Invalidates the client area within the given region by adding that region to the current update region.
CWnd::InvokeHelperCWnd::InvokeHelper Вызывает метод или свойство элемента управления ActiveX.Invokes an ActiveX control method or property.
CWnd::IsChildCWnd::IsChild Указывает, является CWnd дочерним окном или другим прямым потомком указанного окна.Indicates whether CWnd is a child window or other direct descendant of the specified window.
CWnd::IsD2DSupportEnabledCWnd::IsD2DSupportEnabled Определяет, включена ли поддержка D2D.Determines whether D2D support is enabled.
CWnd::IsDialogMessageCWnd::IsDialogMessage Определяет, предназначено ли данное сообщение для немодального диалогового окна, и, если предназначено, обрабатывает его.Determines whether the given message is intended for the modeless dialog box and, if so, processes it.
CWnd::IsDlgButtonCheckedCWnd::IsDlgButtonChecked Определяет, отмечен ли элемент управления "Кнопка".Determines whether a button control is checked.
CWnd::IsDynamicLayoutEnabledCWnd::IsDynamicLayoutEnabled Определяет, активен ли для данного окна динамический макет.Determines whether dynamic layout is enabled on this window. Если динамический макет активен, положение и размеры дочерних окон могут меняться при изменении пользователем размера родительского окна.If dynamic layout is enabled, the position and size of child windows can change when the user resizes the parent window.
CWnd::IsIconicCWnd::IsIconic Определяет, является ли объект CWnd свернутым (преобразованным в значок).Determines whether CWnd is minimized (iconic).
CWnd::IsTouchWindowCWnd::IsTouchWindow Указывает, поддерживает ли объект CWnd сенсорный ввод.Specifies whether CWnd has touch support.
CWnd::IsWindowEnabledCWnd::IsWindowEnabled Определяет, возможен ли в окне ввод с помощью мыши и клавиатуры.Determines whether the window is enabled for mouse and keyboard input.
CWnd::IsWindowVisibleCWnd::IsWindowVisible Определяет, является ли окно видимым.Determines whether the window is visible.
CWnd::IsZoomedCWnd::IsZoomed Определяет, является ли объект CWnd развернутым.Determines whether CWnd is maximized.
CWnd::KillTimerCWnd::KillTimer Уничтожает системный таймер.Kills a system timer.
CWnd::LockWindowUpdateCWnd::LockWindowUpdate Отключает или повторно включает возможность рисования в заданном окне.Disables or reenables drawing in the given window.
CWnd::MapWindowPointsCWnd::MapWindowPoints Преобразует набор точек из координатного пространства объекта CWnd в координатное пространство другого окна.Converts (maps) a set of points from the coordinate space of the CWnd to the coordinate space of another window.
CWnd::MessageBoxCWnd::MessageBox Создает и отображает окно, содержащее предоставленные приложением сообщение и заголовок.Creates and displays a window that contains an application-supplied message and caption.
CWnd::ModifyStyleCWnd::ModifyStyle Изменяет стиль текущего окна.Modifies the current window style.
CWnd::ModifyStyleExCWnd::ModifyStyleEx Изменяет расширенный стиль окна.Modifies the window's extended style.
CWnd::MoveWindowCWnd::MoveWindow Изменяет положение и размеры объекта CWnd.Changes the position and dimensions of CWnd.
CWnd::NotifyWinEventCWnd::NotifyWinEvent Сообщает системе, что произошло предопределенное событие.Signals the system that a predefined event occurred.
CWnd::OnAmbientPropertyCWnd::OnAmbientProperty Реализует значения внешнего свойства.Implement ambient property values.
CWnd::OnDrawIconicThumbnailOrLivePreviewCWnd::OnDrawIconicThumbnailOrLivePreview Вызывается платформой, когда необходимо отобразить растровое изображение на эскизе вкладки Windows 7 или клиенте для быстрого просмотра приложения.Called by the framework when it needs to obtain a bitmap to be displayed on Windows 7 tab thumbnail, or on the client for application peek.
CWnd::OnHelpCWnd::OnHelp Обрабатывает справку F1 в приложении (с использованием текущего контекста).Handles F1 Help within the application (using the current context).
CWnd::OnHelpFinderCWnd::OnHelpFinder Обрабатывает ID_HELP_FINDER и ID_DEFAULT_HELP команды.Handles the ID_HELP_FINDER and ID_DEFAULT_HELP commands.
CWnd::OnHelpIndexCWnd::OnHelpIndex Обрабатывает ID_HELP_INDEX команду и предоставляет тему справки по умолчанию.Handles the ID_HELP_INDEX command and provides a default Help topic.
CWnd::OnHelpUsingCWnd::OnHelpUsing Обрабатывает команду ID_HELP_USING.Handles the ID_HELP_USING command.
CWnd::OnToolHitTestCWnd::OnToolHitTest Определяет, находится ли указатель в прямоугольнике указанного инструмента и извлекает информацию об этом инструменте.Determines whether a point is in the bounding rectangle of the specified tool and retrieves information about the tool.
CWnd::OpenClipboardCWnd::OpenClipboard Открывает буфер обмена.Opens the Clipboard. Другие приложения не смогут изменять Clipboard до тех пор, пока не будет вызвана функция Windows CloseClipboard.Other applications will not be able to modify the Clipboard until the Windows CloseClipboard function is called.
CWnd::PaintWindowlessControlsCWnd::PaintWindowlessControls Рисует неоконные элементы управления в контейнере элемента управления.Draws windowless controls on the control container.
CWnd::PostMessageCWnd::PostMessage Размещает сообщение в очереди приложения, а затем возвращает управление, не ожидая окончания обработки сообщения окном.Places a message in the application queue, then returns without waiting for the window to process the message.
CWnd::PreCreateWindowCWnd::PreCreateWindow Вызывается до создания окна Windows, присоединенного к данному объекту класса CWnd.Called before the creation of the Windows window attached to this CWnd object.
CWnd::PreSubclassWindowCWnd::PreSubclassWindow Позволяет другим необходимым подклассам произойти до subclassWindow называется.Allows other necessary subclassing to occur before SubclassWindow is called.
CWnd::PreTranslateMessageCWnd::PreTranslateMessage Используется объектом CWinApp для фильтрации сообщений окон до их передачи функциям Windows TranslateMessage и DispatchMessage.Used by CWinApp to filter window messages before they are dispatched to the TranslateMessage and DispatchMessage Windows functions.
CWnd::PrintCWnd::Print Рисует текущее окно в заданном контексте устройства.Draws the current window in the specified device context.
CWnd::PrintClientCWnd::PrintClient Рисует любое окно в заданном контексте устройства (обычно принтера).Draws any window in the specified device context (usually a printer device context).
CWnd::PrintWindowCWnd::PrintWindow Копирует визуальное окно в указанный контекст устройства (обычно принтера).Copies a visual window into the specified device context, typically a printer DC.
CWnd::RedrawWindowCWnd::RedrawWindow Обновляет заданную прямоугольную или другую область в клиентской области.Updates the specified rectangle or region in the client area.
CWnd::RegisterTouchWindowCWnd::RegisterTouchWindow Регистрация и отмена регистрации поддержки технологии касания Windows.Register/Unregister window Windows touch support.
CWnd::ReleaseDCCWnd::ReleaseDC Освобождает контексты устройств клиента и окна, делая возможным их использование другими приложениями.Releases client and window device contexts, freeing them for use by other applications.
CWnd::RepositionBarsCWnd::RepositionBars Изменяет положение панелей элементов управления в клиентской области.Repositions control bars in the client area.
CWnd::RunModalLoopCWnd::RunModalLoop Извлекает, преобразует или передает сообщения для окна, находящегося в модальном состоянии.Retrieves, translates, or dispatches messages for a window that is in modal status.
CWnd::ScreenToClientCWnd::ScreenToClient Преобразует экранные координаты указанной точки или прямоугольника в клиентские координаты.Converts the screen coordinates of a given point or rectangle on the display to client coordinates.
CWnd::ScrollWindowCWnd::ScrollWindow Прокручивает содержимое клиентской области.Scrolls the contents of the client area.
CWnd::ScrollWindowExCWnd::ScrollWindowEx Прокручивает содержимое клиентской области.Scrolls the contents of the client area. Аналогично ScrollWindow, но с дополнительными возможностями.Similar to ScrollWindow, with additional features.
CWnd::SendChildNotifyLastMsgCWnd::SendChildNotifyLastMsg Передает дочернему окну уведомляющее сообщение от родительского окна, чтобы дочернее окно могло обработать задачу.Provides a notification message to a child window, from the parent window, so the child window can handle a task.
CWnd::SendDlgItemMessageCWnd::SendDlgItemMessage Отправляет сообщение указанному элементу управления.Sends a message to the specified control.
CWnd::SendMessageCWnd::SendMessage Передает сообщение объекту CWnd и не возвращает управление, пока оно не будет обработано.Sends a message to the CWnd object and does not return until it has processed the message.
CWnd::SendMessageToDescendantsCWnd::SendMessageToDescendants Отправляет сообщение всем окнам-потомкам данного окна.Sends a message to all descendant windows of the window.
CWnd::SendNotifyMessageCWnd::SendNotifyMessage Отправляет указанное сообщение окну и возвращает управление при первой возможности, в зависимости от того, создано ли окно вызывающим потоком.Sends the specified message to the window and returns as soon as possible, depending on whether the calling thread created the window.
CWnd::SetActiveWindowCWnd::SetActiveWindow Активирует окно.Activates the window.
CWnd::SetCaptureCWnd::SetCapture Весь последующий ввод с помощью мыши передается объекту CWnd.Causes all subsequent mouse input to be sent to the CWnd.
CWnd::SetCaretPosCWnd::SetCaretPos Перемещает курсор в указанную позицию.Moves the caret to a specified position.
CWnd::SetClipboardViewerCWnd::SetClipboardViewer Добавляет объект CWnd в цепочку окон, которым отправляются уведомления при изменении содержимого буфера обмена.Adds CWnd to the chain of windows that are notified whenever the contents of the Clipboard are changed.
CWnd::SetDlgCtrlIDCWnd::SetDlgCtrlID Задает для окна идентификатор элемента управления или окна. Идентификатор может задаваться для любого дочернего окна, а не только для элемента управления в диалоговом окне.Sets the window or control ID for the window (which can be any child window, not only a control in a dialog box).
CWnd::SetDlgItemIntCWnd::SetDlgItemInt Располагает текст элемента управления в виде строки, являющейся представлением целого числа.Sets the text of a control to the string that represents an integer value.
CWnd::SetDlgItemTextCWnd::SetDlgItemText Задает заголовок или текст элемента управления в указанном диалоговом окне.Sets the caption or text of a control in the specified dialog box.
CWnd::SetFocusCWnd::SetFocus Утверждает фокус ввода.Claims the input focus.
CWnd::SetFontCWnd::SetFont Задает текущий шрифт.Sets the current font.
CWnd::SetForegroundWindowCWnd::SetForegroundWindow Помещает создавший окно поток на передний план и активирует окно.Puts the thread that created the window into the foreground and activates the window.
CWnd::SetIconCWnd::SetIcon Задает дескриптор для указанного значка.Sets the handle to a specific icon.
CWnd::SetLayeredWindowAttributesCWnd::SetLayeredWindowAttributes Задает ключ цвета прозрачности многослойного окна.Sets the opacity and transparency color key of a layered window.
CWnd::SetMenuCWnd::SetMenu Меняет указанное меню на новое.Sets the menu to the specified menu.
CWnd::SetOwnerCWnd::SetOwner Изменяет владельца объекта CWnd.Changes the owner of a CWnd.
CWnd::SetParentCWnd::SetParent Изменяет родительское окно.Changes the parent window.
CWnd::SetPropertyCWnd::SetProperty Задает свойство элемента управления ActiveX.Sets an ActiveX control property.
CWnd::SetRedrawCWnd::SetRedraw Разрешает перерисовку изменений объекта CWnd или запрещает ее.Allows changes in CWnd to be redrawn or prevents changes from being redrawn.
CWnd::SetScrollInfoCWnd::SetScrollInfo Задает сведения о полосе прокрутки.Sets information about the scroll bar.
CWnd::SetScrollPosCWnd::SetScrollPos Задает текущее положение ползунка и, если оно указано, перерисовывает полосу прокрутки в соответствии с новым положением.Sets the current position of a scroll box and, if specified, redraws the scroll bar to reflect the new position.
CWnd::SetScrollRangeCWnd::SetScrollRange Задает для указанной полосы прокрутки положения минимума и максимума.Sets minimum and maximum position values for the given scroll bar.
CWnd::SetTimerCWnd::SetTimer Устанавливает системный таймер, который отправляет WM_TIMER сообщение при срабатывании.Installs a system timer that sends a WM_TIMER message when triggered.
CWnd::SetWindowContextHelpIdCWnd::SetWindowContextHelpId Задает идентификатор контекста справки.Sets the help context identifier.
CWnd::SetWindowPlacementCWnd::SetWindowPlacement Задает состояние отображения, а также обычное (восстановленное), свернутое и развернутое состояния окна.Sets the show state and the normal (restored), minimized, and maximized positions for a window.
CWnd::SetWindowPosCWnd::SetWindowPos Изменяет размер, положение и порядок дочерних и всплывающих окон, а также окон верхнего уровня.Changes the size, position, and ordering of child, pop-up, and top-level windows.
CWnd::SetWindowRgnCWnd::SetWindowRgn Задает область окна.Sets the region of a window.
CWnd::SetWindowTextCWnd::SetWindowText Меняет текст или заголовок окна (при наличии) на указанный текст.Sets the window text or caption title (if it has one) to the specified text.
CWnd::ShowCaretCWnd::ShowCaret Показывает курсор в его текущем положении на экране.Shows the caret on the display at the caret's current position. После отображения курсор начинает автоматически мигать.Once shown, the caret begins flashing automatically.
CWnd::ShowOwnedPopupsCWnd::ShowOwnedPopups Показывает или скрывает все всплывающие окна, принадлежащие окну.Shows or hides all pop-up windows owned by the window.
CWnd::ShowScrollBarCWnd::ShowScrollBar Показывает или скрывает полосу прокрутки.Displays or hides a scroll bar.
CWnd::ShowWindowCWnd::ShowWindow Показывает или скрывает окно.Shows or hides the window.
CWnd::SubclassDlgItemCWnd::SubclassDlgItem Прикрепляет элемент управления Windows к объекту CWnd и отдает ему команду перенаправлять сообщения с помощью схемы сообщений объекта CWnd.Attaches a Windows control to a CWnd object and makes it route messages through the CWnd's message map.
CWnd::SubclassWindowCWnd::SubclassWindow Прикрепляет окно к объекту CWnd и отдает ему команду перенаправлять сообщения с помощью схемы сообщений объекта CWnd.Attaches a window to a CWnd object and makes it route messages through the CWnd's message map.
CWnd::UnlockWindowUpdateCWnd::UnlockWindowUpdate Выполняет разблокировку окна, заблокированного с помощью метода CWnd::LockWindowUpdate.Unlocks a window that was locked with CWnd::LockWindowUpdate.
CWnd::UnsubclassWindowCWnd::UnsubclassWindow Отсоединяет окно от CWnd объектаDetaches a window from a CWnd object
CWnd::UpdateDataCWnd::UpdateData Инициализирует или извлекает данные из диалогового окна.Initializes or retrieves data from a dialog box.
CWnd::UpdateDialogControlsCWnd::UpdateDialogControls Запрос на обновление состояния кнопок и других элементов управления диалогового окна.Call to update the state of dialog buttons and other controls.
CWnd::UpdateLayeredWindowCWnd::UpdateLayeredWindow Обновляет положение, размер, форму, содержимое и прозрачность многослойного окна.Updates the position, size, shape, content, and translucency of a layered window.
CWnd::UpdateWindowCWnd::UpdateWindow Обновляет клиентскую область.Updates the client area.
CWnd::ValidateRectCWnd::ValidateRect Проверяет клиентскую область в пределах заданного прямоугольника, удаляя этот прямоугольник из текущей области обновления.Validates the client area within the given rectangle by removing the rectangle from the current update region.
CWnd::ValidateRgnCWnd::ValidateRgn Проверяет клиентскую область в пределах заданной области, удаляя ее из текущей области обновления.Validates the client area within the given region by removing the region from the current update region.
CWnd::WindowFromPointCWnd::WindowFromPoint Идентифицирует окно, содержащее заданную точку.Identifies the window that contains the given point.
CWnd::WinHelpCWnd::WinHelp Вызывается для запуска приложения WinHelp.Called to initiate the WinHelp application.

Защищенные методыProtected Methods

ИмяName ОписаниеDescription
CWnd::DefaultCWnd::Default Вызывает процедуру окна по умолчанию, обеспечивающую стандартную обработку любых сообщений окна, не обработанных приложением.Calls the default window procedure, which provides default processing for any window messages that an application does not process.
CWnd::DefWindowProcCWnd::DefWindowProc Вызывает процедуру окна по умолчанию, обеспечивающую стандартную обработку любых сообщений окна, не обработанных приложением.Calls the default window procedure, which provides default processing for any window messages that an application does not process.
CWnd::DoDataExchangeCWnd::DoDataExchange Обеспечивает обмен данными диалогового окна и их проверку.For dialog data exchange and validation. Вызывается методом UpdateData.Called by UpdateData.
CWnd::GetCurrentMessageCWnd::GetCurrentMessage Возвращает указатель на сообщение, обрабатываемое этим окном в настоящий момент.Returns a pointer to the message this window is currently processing. Следует вызываться только Onпри работе в функции обработчика сообщений.Should only be called when in an OnMessage message-handler member function.
CWnd::InitDynamicLayoutCWnd::InitDynamicLayout Вызывается платформой для инициализации динамического макета окна.Called by the framework to initialize the dynamic layout for the window.
CWnd::LoadDynamicLayoutResourceCWnd::LoadDynamicLayoutResource Загружает из файла ресурсов сведения о динамическом макете.Loads dynamic layout information from the resource file.
CWnd::OnActivateCWnd::OnActivate Вызывается при активации или деактивации объекта CWnd.Called when CWnd is being activated or deactivated.
CWnd::OnActivateAppCWnd::OnActivateApp Вызывается непосредственно перед активацией или деактивацией приложения.Called when the application is about to be activated or deactivated.
CWnd::OnAppCommandCWnd::OnAppCommand Вызывается, когда пользователь создает команду события приложения.Called when the user generates an application command event.
CWnd::OnAskCbFormatNameCWnd::OnAskCbFormatName Вызывается приложением просмотра буфера обмена, когда владелец буфера обмена отображает его содержимое.Called by a Clipboard viewer application when a Clipboard owner will display the Clipboard contents.
CWnd::OnCancelModeCWnd::OnCancelMode Вызывается, чтобы разрешить объекту CWnd выполнить отмену всех внутренних режимов, таких как захват мыши.Called to allow CWnd to cancel any internal modes, such as mouse capture.
CWnd::OnCaptureChangedCWnd::OnCaptureChanged Отправляет сообщение окну, теряющему захват мыши.Sends a message to the window that is losing the mouse capture.
CWnd::OnChangeCbChainCWnd::OnChangeCbChain Уведомляет об удалении указанного окна из цепочки.Notifies that a specified window is being removed from the chain.
CWnd::OnChangeUIStateCWnd::OnChangeUIState Вызывается, когда необходимо изменить состояние пользовательского интерфейса.Called when the user interface (UI) state should be changed.
CWnd::OnCharCWnd::OnChar Вызывается, когда нажатие клавиши преобразуются в несистемный символ.Called when a keystroke translates to a non-system character.
CWnd::OnCharToItemCWnd::OnCharToItem Вызывается в поле списка детей со стилем LBS_WANTKEYBOARDINPUT в ответ на WM_CHAR сообщение.Called by a child list box with the LBS_WANTKEYBOARDINPUT style in response to a WM_CHAR message.
CWnd::OnChildActivateCWnd::OnChildActivate Вызывается для дочерних окон многодокументного интерфейса (MDI) при изменении размера или положения объекта CWnd, а также при активации объекта CWnd.Called for multiple document interface (MDI) child windows whenever the size or position of CWnd changes or CWnd is activated.
CWnd::OnChildNotifyCWnd::OnChildNotify Вызывается родительским окном, чтобы позволить уведомляющему элементу управления ответить на уведомление элемента управления.Called by a parent window to give a notifying control a chance to respond to a control notification.
CWnd::OnClipboardUpdateCWnd::OnClipboardUpdate Вызывается при изменении содержимого буфера обмена.Called when the contents of the clipboard have changed.
CWnd::OnCloseCWnd::OnClose Вызывается в качестве сигнала о необходимости закрытия объекта CWnd.Called as a signal that CWnd should be closed.
CWnd::OnColorizationColorChangedCWnd::OnColorizationColorChanged Вызывается при изменении политики отрисовки неклиентской области.Called when the rendering policy for the non-client area has changed.
CWnd::OnCommandCWnd::OnCommand Вызывается, когда пользователь выбирает какую-либо команду.Called when the user selects a command.
CWnd::OnCompactingCWnd::OnCompacting Вызывается, когда Windows обнаруживает нехватку системной памяти.Called when Windows detects that system memory is low.
CWnd::OnCompareItemCWnd::OnCompareItem Вызывается для определения относительной позиции нового элемента в элементе управления "Список" или в дочернем упорядоченном элементе управления "Поле со списком", рисуемом владельцем.Called to determine the relative position of a new item in a child sorted owner-draw combo box or list box.
CWnd::OnCompositionChangedCWnd::OnCompositionChanged Вызывается для всех окон верхнего уровня при включении или выключении композиции рабочего стола в диспетчере окон рабочего стола (DWM).Called for all top-level windows when the Desktop Window Manager (DWM) composition is enabled or disabled.
CWnd::OnContextMenuCWnd::OnContextMenu Вызывается, когда пользователь щелкает в окне правой кнопкой мыши.Called when the user clicks the right mouse button in the window.
CWnd::OnCopyDataCWnd::OnCopyData Копирует данные из одного приложения в другое.Copies data from one application to another.
CWnd::OnCreateCWnd::OnCreate Вызывается при создании окна.Called as a part of window creation.
CWnd::OnCtlColorCWnd::OnCtlColor Вызывается непосредственно перед рисованием элемента управления, если объект CWnd является родительским для элемента управления.Called if CWnd is the parent of a control when the control is about to be drawn.
CWnd::OnDeadCharCWnd::OnDeadChar Вызывается, когда нажатие клавиши преобразуется в несистемный диакритический знак.Called when a keystroke translates to a nonsystem dead character (such as accent characters).
CWnd::OnDeleteItemCWnd::OnDeleteItem Вызывается, когда дочерний элемент управления "Поле со списком", рисуемый владельцем, или элемент управления "Поле со списком" уничтожается, а также при удалении из элемента управления элементов списка.Called when an owner-draw child list box or combo box is destroyed or when items are removed from the control.
CWnd::OnDestroyCWnd::OnDestroy Вызывается при уничтожении объекта CWnd.Called when CWnd is being destroyed.
CWnd::OnDestroyClipboardCWnd::OnDestroyClipboard Вызывается, когда Clipboard опустела через вызов к функции Windows EmptyClipboard.Called when the Clipboard is emptied through a call to the Windows EmptyClipboard function.
CWnd::OnDeviceChangeCWnd::OnDeviceChange Сообщает приложению или драйверу устройства об изменении конфигурации оборудования устройства или компьютера. Notifies an application or device driver of a change to the hardware configuration of a device or the computer.
CWnd::OnDevModeChangeCWnd::OnDevModeChange Вызывается для всех окон верхнего уровня, когда пользователь меняет параметры режима устройства.Called for all top-level windows when the user changes device-mode settings.
CWnd::OnDrawClipboardCWnd::OnDrawClipboard Вызывается при изменении содержимого буфера обмена.Called when the contents of the Clipboard change.
CWnd::OnDrawItemCWnd::OnDrawItem Вызывается, когда необходимо визуально изобразить рисуемый владельцем дочерний элемент управления "Кнопка", элемент управления "Поле со списком", элемент управления "Поле" или меню.Called when a visual aspect of an owner-draw child button control, combo-box control, list-box control, or menu needs to be drawn.
CWnd::OnDropFilesCWnd::OnDropFiles Вызывается, когда пользователь отпускает левую кнопку мыши в окне, зарегистрировавшем себя в качестве получателя переносимых файлов.Called when the user releases the left mouse button over a window that has registered itself as the recipient of dropped files.
CWnd::OnEnableCWnd::OnEnable Вызывается при включении или отключении объекта CWnd.Called when CWnd is enabled or disabled.
CWnd::OnEndSessionCWnd::OnEndSession Вызывается во время окончания сессии.Called when the session is ending.
CWnd::OnEnterIdleCWnd::OnEnterIdle Вызывается для информирования процедуры главного окна приложения о переходе модального диалогового окна или меню в состояние простоя.Called to inform an application's main window procedure that a modal dialog box or a menu is entering an idle state.
CWnd::OnEnterMenuLoopCWnd::OnEnterMenuLoop Вызывается при входе в модальный цикл меню.Called when a menu modal loop has been entered.
CWnd::OnEnterSizeMoveCWnd::OnEnterSizeMove Вызывается, когда затронутое окно входит в модальный цикл перемещения или изменения размера.Called after the affected window enters a moving or sizing modal loop.
CWnd::OnEraseBkgndCWnd::OnEraseBkgnd Вызывается, когда требуется стирание фона окна.Called when the window background needs erasing.
CWnd::OnExitMenuLoopCWnd::OnExitMenuLoop Вызывается при выходе из модального цикла меню.Called when a menu modal loop has been exited.
CWnd::OnExitSizeMoveCWnd::OnExitSizeMove Вызывается, когда затронутое окно выходит из модального цикла перемещения или изменения размера.Called after the affected window exits a moving or sizing modal loop.
CWnd::OnFontChangeCWnd::OnFontChange Вызывается при изменении пула ресурсов шрифтов.Called when the pool of font resources changes.
CWnd::OnGetDlgCodeCWnd::OnGetDlgCode Вызывается, чтобы элемент управления мог самостоятельно обрабатывать нажатия на клавиши со стрелками и клавишу TAB.Called for a control so the control can process arrow-key and TAB-key input itself.
CWnd::OnGetMinMaxInfoCWnd::OnGetMinMaxInfo Вызывается, когда Windows требуется получить сведения о положении в развернутом состоянии, размерах, минимальном или максимальном размере отслеживания.Called whenever Windows needs to know the maximized position or dimensions, or the minimum or maximum tracking size.
CWnd::OnHelpInfoCWnd::OnHelpInfo Вызывается платформой, когда пользователь нажимает клавишу F1.Called by the framework when the user presses the F1 key.
CWnd::OnHotKeyCWnd::OnHotKey Вызывается, когда пользователь нажимает общесистемное сочетание клавиш.Called when the user presses a system-wide hot key.
CWnd::OnHScrollCWnd::OnHScroll Вызывается, когда пользователь щелкает горизонтальную полосу прокрутки объекта CWnd.Called when the user clicks the horizontal scroll bar of CWnd.
CWnd::OnHScrollClipboardCWnd::OnHScrollClipboard Вызывается, когда владелец буфера обмена должен прокрутить изображение из буфера, объявить необходимый раздел недействительным, а также обновить значения полосы прокрутки.Called when a Clipboard owner should scroll the Clipboard image, invalidate the appropriate section, and update the scroll-bar values.
CWnd::OnIconEraseBkgndCWnd::OnIconEraseBkgnd Вызывается, когда объект CWnd сворачивается (преобразуется в значок) и фон значка необходимо заполнить до его рисования.Called when CWnd is minimized (iconic) and the background of the icon must be filled before painting the icon.
CWnd::OnInitMenuCWnd::OnInitMenu Вызывается непосредственно перед тем, как меню станет активным.Called when a menu is about to become active.
CWnd::OnInitMenuPopupCWnd::OnInitMenuPopup Вызывается непосредственно перед тем, как всплывающее меню станет активным.Called when a pop-up menu is about to become active.
CWnd::OnInputDeviceChangeCWnd::OnInputDeviceChange Вызывается при добавлении в систему устройства ввода-вывода или его удаления из нее.Called when an I/O device is added or removed from the system.
CWnd::OnInputLangChangeCWnd::OnInputLangChange Вызывается после изменения языка ввода приложения.Called after an application's input language has been changed.
CWnd::OnInputLangChangeRequestCWnd::OnInputLangChangeRequest Вызывается, когда пользователь выбирает новый язык ввода.Called when the user chooses a new input language.
CWnd::OnKeyDownCWnd::OnKeyDown Вызывается при нажатии несистемной клавиши.Called when a nonsystem key is pressed.
CWnd::OnKeyUpCWnd::OnKeyUp Вызывается, когда нажатая несистемная клавиша отпускается.Called when a nonsystem key is released.
CWnd::OnKillFocusCWnd::OnKillFocus Вызывается непосредственно перед тем, как объект CWnd теряет фокус ввода.Called immediately before CWnd loses the input focus.
CWnd::OnLButtonDblClkCWnd::OnLButtonDblClk Вызывается, когда пользователь дважды щелкает левой кнопкой мыши.Called when the user double-clicks the left mouse button.
CWnd::OnLButtonDownCWnd::OnLButtonDown Вызывается, когда пользователь щелкает левой кнопкой мыши.Called when the user presses the left mouse button.
CWnd::OnLButtonUpCWnd::OnLButtonUp Вызывается, когда пользователь отпускает левую кнопку мыши.Called when the user releases the left mouse button.
CWnd::OnMButtonDblClkCWnd::OnMButtonDblClk Вызывается, когда пользователь дважды щелкает средней кнопкой мыши.Called when the user double-clicks the middle mouse button.
CWnd::OnMButtonDownCWnd::OnMButtonDown Вызывается, когда пользователь щелкает средней кнопкой мыши.Called when the user presses the middle mouse button.
CWnd::OnMButtonUpCWnd::OnMButtonUp Вызывается, когда пользователь отпускает среднюю кнопку мыши.Called when the user releases the middle mouse button.
CWnd::OnMDIActivateCWnd::OnMDIActivate Вызывается при активации или деактивации дочернего окна MDI.Called when an MDI child window is activated or deactivated.
CWnd::OnMeasureItemCWnd::OnMeasureItem Вызывается для рисуемого владельцем дочернего элемента управление "Поле со списком", элемента управление "Список" или меню при создании нового элемента управления.Called for an owner-draw child combo box, list box, or menu item when the control is created. Объект CWnd сообщает Windows размеры этого элемента управления.CWnd informs Windows of the dimensions of the control.
CWnd::OnMenuCharCWnd::OnMenuChar Вызывается, когда пользователь нажимает назначенный символ меню, не соответствующий ни одному из символов, назначенных для текущего меню.Called when the user presses a menu mnemonic character that doesn't match any of the predefined mnemonics in the current menu.
CWnd::OnMenuDragCWnd::OnMenuDrag Вызывается, когда пользователь начинает перетаскивать элемент меню.Called when the user begins to drag a menu item.
CWnd::OnMenuGetObjectCWnd::OnMenuGetObject Вызывается когда курсор мыши попадает на элемент меню или перемещается из центра элемента в его верхнюю или нижнюю часть.Called when the mouse cursor enters a menu item or moves from the center of the item to the top or bottom of the item.
CWnd::OnMenuRButtonUpCWnd::OnMenuRButtonUp Вызывается, если пользователь отпускает правую кнопку мыши, когда курсор находится на элементе меню.Called when the user releases the right mouse button while the cursor is on a menu item.
CWnd::OnMenuSelectCWnd::OnMenuSelect Вызывается, когда пользователь выбирает элемент меню.Called when the user selects a menu item.
CWnd::OnMouseActivateCWnd::OnMouseActivate Вызывается, если пользователь щелкает кнопкой мыши, когда курсор находится в неактивном окне.Called when the cursor is in an inactive window and the user presses a mouse button.
CWnd::OnMouseHoverCWnd::OnMouseHover Вызывается, когда курсор парит над областью клиента окна в течение периода времени, указанного в предыдущем вызове TrackMouseEvent.Called when the cursor hovers over the client area of the window for the period of time specified in a prior call to TrackMouseEvent.
CWnd::OnMouseHWheelCWnd::OnMouseHWheel Вызывается, если текущее окно создано диспетчером окон рабочего стола (DWM) и развернуто.Called when the current window is composed by the Desktop Window Manager (DWM), and that window is maximized.
CWnd::OnMouseLeaveCWnd::OnMouseLeave Вызывается, когда курсор покидает клиентскую область окна, указанную в предыдущем вызове на TrackMouseEvent.Called when the cursor leaves the client area of the window specified in a prior call to TrackMouseEvent.
CWnd::OnMouseMoveCWnd::OnMouseMove Вызывается при перемещении указателя мыши.Called when the mouse cursor moves.
CWnd::OnMouseWheelCWnd::OnMouseWheel Вызывается, когда пользователь вращает колесико мыши.Called when a user rotates the mouse wheel. Использует обработчик сообщений Windows NT 4.0.Uses Windows NT 4.0 message handling.
CWnd::OnMoveCWnd::OnMove Вызывается после изменения положения объекта CWnd.Called after the position of the CWnd has been changed.
CWnd::OnMovingCWnd::OnMoving Указывает, что пользователь перемещает объект CWnd.Indicates that a user is moving a CWnd object.
CWnd::OnNcActivateCWnd::OnNcActivate Вызывается, когда требуется изменить неклиентскую область, чтобы указать на активное или неактивное состояние.Called when the non-client area needs to be changed to indicate an active or inactive state.
CWnd::OnNcCalcSizeCWnd::OnNcCalcSize Вызывается, когда требуется вычислить размер и положение клиентской области.Called when the size and position of the client area need to be calculated.
CWnd::OnNcCreateCWnd::OnNcCreate Вызывается до OnCreate, когда создается неклиентская область.Called prior to OnCreate when the non-client area is being created.
CWnd::OnNcDestroyCWnd::OnNcDestroy Вызывается при уничтожении неклиентской области.Called when the non-client area is being destroyed.
CWnd::OnNcHitTestCWnd::OnNcHitTest Вызывается средой Windows при каждом перемещении указателя мыши, если объект CWnd содержит курсор или захватил ввод с помощью мыши, используя метод SetCapture.Called by Windows every time the mouse is moved if CWnd contains the cursor or has captured mouse input with SetCapture.
CWnd::OnNcLButtonDblClkCWnd::OnNcLButtonDblClk Вызывается, если пользователь дважды щелкает левой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user double-clicks the left mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcLButtonDownCWnd::OnNcLButtonDown Вызывается, если пользователь щелкает левой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user presses the left mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcLButtonUpCWnd::OnNcLButtonUp Вызывается, если пользователь отпускает левую кнопку мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user releases the left mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcMButtonDblClkCWnd::OnNcMButtonDblClk Вызывается, если пользователь дважды щелкает средней кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user double-clicks the middle mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcMButtonDownCWnd::OnNcMButtonDown Вызывается, если пользователь щелкает средней кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user presses the middle mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcMButtonUpCWnd::OnNcMButtonUp Вызывается, если пользователь отпускает среднюю кнопку мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user releases the middle mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcMouseHoverCWnd::OnNcMouseHover Вызывается, когда курсор парит над неклиентской областью окна в течение периода времени, указанного в предыдущем звонке на TrackMouseEvent.Called when the cursor hovers over the non-client area of the window for the period of time specified in a prior call to TrackMouseEvent.
CWnd::OnNcMouseLeaveCWnd::OnNcMouseLeave Рамочная функция вызывает эту функцию, когда курсор покидает область неклиента окна, указанную в предыдущем вызове TrackMouseEvent.The framework calls this member function when the cursor leaves the non-client area of the window specified in a prior call to TrackMouseEvent.
CWnd::OnNcMouseMoveCWnd::OnNcMouseMove Вызывается при перемещении курсора в пределах неклиентской области CWnd.Called when the cursor is moved within a non-client area of CWnd.
CWnd::OnNcPaintCWnd::OnNcPaint Вызывается, когда требуется отрисовка неклиентской области.Called when the non-client area needs painting.
CWnd::OnNcRButtonDblClkCWnd::OnNcRButtonDblClk Вызывается, если пользователь дважды щелкает правой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user double-clicks the right mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcRButtonDownCWnd::OnNcRButtonDown Вызывается, если пользователь щелкает правой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user presses the right mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcRButtonUpCWnd::OnNcRButtonUp Вызывается, если пользователь отпускает правую кнопку мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user releases the right mouse button while the cursor is within a non-client area of CWnd.
CWnd::OnNcRenderingChangedCWnd::OnNcRenderingChanged Вызывается при изменении политики отрисовки неклиентской области.Called when the rendering policy for the non-client area has changed.
CWnd::OnNcXButtonDblClkCWnd::OnNcXButtonDblClk Вызывается, если пользователь дважды щелкает кнопкой XBUTTON1 или XBUTTON2, когда курсор находится в неклиентской области окна.Called when the user double-clicks XBUTTON1 or XBUTTON2 while the cursor is in the non-client area of a window.
CWnd::OnNcXButtonDownCWnd::OnNcXButtonDown Вызывается, если пользователь щелкает кнопкой мыши XBUTTON1 или XBUTTON2, когда курсор находится в неклиентской области окна.Called when the user presses XBUTTON1 or XBUTTON2 of the mouse while the cursor is in the non-client area of a window.
CWnd::OnNcXButtonUpCWnd::OnNcXButtonUp Вызывается, если пользователь отпускает кнопку мыши XBUTTON1 или XBUTTON2, когда курсор находится в неклиентской области окна.Called when the user releases XBUTTON1 or XBUTTON2 of the mouse while the cursor is in the non-client area of a window.
CWnd::OnNextMenuCWnd::OnNextMenu Посылается, когда для переключения между панелью меню и системным меню используется клавиша "Стрелка вправо" или "Стрелка влево".Called when the right or left arrow key is used to switch between the menu bar and the system menu.
CWnd::OnNotifyCWnd::OnNotify Вызывается платформой для информирования родительского окна о событии, произошедшем для одного из его элементов управления, или о запросе информации элементом управления.Called by the framework to inform a parent window an event has occurred in one of its controls or that the control needs information.
CWnd::OnNotifyFormatCWnd::OnNotifyFormat Вызывается для определения, принимает текущее окно в сообщении WM_NOTIFY структуры формата ANSI или Юникода.Called to determine if the current window accepts ANSI or Unicode structures in the WM_NOTIFY notification message.
CWnd::OnPaintCWnd::OnPaint Вызывается для перерисовки части окна.Called to repaint a portion of the window.
CWnd::OnPaintClipboardCWnd::OnPaintClipboard Вызывается, когда требуется перерисовка клиентской области окна просмотра буфера обмена.Called when the client area of the Clipboard viewer needs repainting.
CWnd::OnPaletteChangedCWnd::OnPaletteChanged Вызывается, чтобы разрешить окнам, использующим цветовую палитру, реализовать свои логические палитры и обновить клиентские области.Called to allow windows that use a color palette to realize their logical palettes and update their client areas.
CWnd::OnPaletteIsChangingCWnd::OnPaletteIsChanging Информирует другие приложения, когда приложение собирается реализовать свою логическую палитру.Informs other applications when an application is going to realize its logical palette.
CWnd::OnParentNotifyCWnd::OnParentNotify Вызывается при создании или уничтожении дочернего окна, а также если пользователь щелкает кнопкой мыши, когда курсор находится на дочернем окне.Called when a child window is created or destroyed, or when the user clicks a mouse button while the cursor is over the child window.
CWnd::OnPowerBroadcastCWnd::OnPowerBroadcast Вызывается при возникновении события управления питанием.Called when a power-management event occurs.
CWnd::OnQueryDragIconCWnd::OnQueryDragIcon Вызывается, непосредственно перед перетаскиванием свернутого (преобразованного в значок) объекта CWnd.Called when a minimized (iconic) CWnd is about to be dragged by the user.
CWnd::OnQueryEndSessionCWnd::OnQueryEndSession Вызывается при завершении пользователем сеанса Windows.Called when the user chooses to end the Windows session.
CWnd::OnQueryNewPaletteCWnd::OnQueryNewPalette Сообщает объекту CWnd, что вскоре ему будет передан фокус ввода.Informs CWnd that it is about to receive the input focus.
CWnd::OnQueryOpenCWnd::OnQueryOpen Вызывается, когда объект CWnd является значком, на открытие которого пользователь подает запрос.Called when CWnd is an icon and the user requests that the icon be opened.
CWnd::OnQueryUIStateCWnd::OnQueryUIState Вызывается, чтобы извлечь состояние пользовательского интерфейса окна.Called to retrieve the user interface (UI) state for a window.
CWnd::OnRawInputCWnd::OnRawInput Вызывается, когда текущее окно получает необработанные данные ввода.Called when the current window gets raw input.
CWnd::OnRButtonDblClkCWnd::OnRButtonDblClk Вызывается, когда пользователь дважды щелкает правой кнопкой мыши.Called when the user double-clicks the right mouse button.
CWnd::OnRButtonDownCWnd::OnRButtonDown Вызывается, когда пользователь щелкает правой кнопкой мыши.Called when the user presses the right mouse button.
CWnd::OnRButtonUpCWnd::OnRButtonUp Вызывается, когда пользователь отпускает правую кнопку мыши.Called when the user releases the right mouse button.
CWnd::OnRenderAllFormatsCWnd::OnRenderAllFormats Вызывается при уничтожении приложения-владельца и необходимости отрисовки всех его форматов.Called when the owner application is being destroyed and needs to render all its formats.
CWnd::OnRenderFormatCWnd::OnRenderFormat Вызывается для владельца буфера обмена при необходимости отрисовки формата, отрисовка которого была отложена.Called for the Clipboard owner when a particular format with delayed rendering needs to be rendered.
CWnd::OnSessionChangeCWnd::OnSessionChange Вызывается для оповещения приложения об изменении состояния сеанса.Called to notify an application of a change in session state.
CWnd::OnSetCursorCWnd::OnSetCursor Вызывается, если данные от мыши не фиксируются, и указатель мыши перемещается в окне.Called if mouse input is not captured and the mouse causes cursor movement within a window.
CWnd::OnSetFocusCWnd::OnSetFocus Вызывается, когда объект CWnd получает фокус ввода.Called after CWnd gains the input focus.
CWnd::OnSettingChangeCWnd::OnSettingChange Вызывается, когда функция Win32 SystemParametersInfo меняет параметр уровня системы.Called when the Win32 SystemParametersInfo function changes a system-wide setting.
CWnd::OnShowWindowCWnd::OnShowWindow Вызывается непосредственно перед скрытием или отображением объекта CWnd.Called when CWnd is to be hidden or shown.
CWnd::OnSizeCWnd::OnSize Вызывается после изменения размера объекта CWnd.Called after the size of CWnd has changed.
CWnd::OnSizeClipboardCWnd::OnSizeClipboard Вызывается при изменении размера клиентской области окна буфера обмена.Called when the size of the client area of the Clipboard-viewer window has changed.
CWnd::OnSizingCWnd::OnSizing Указывает, что пользователь изменят размер прямоугольника.Indicates that the user is resizing the rectangle.
CWnd::OnSpoolerStatusCWnd::OnSpoolerStatus Вызывается из диспетчера печати при каждом добавлении задачи в очередь диспетчера или удалении задания из нее.Called from Print Manager whenever a job is added to or removed from the Print Manager queue.
CWnd::OnStyleChangedCWnd::OnStyleChanged Означает, что функция SetWindowLong Windows изменила один или несколько стилей окна.Indicates that the SetWindowLong Windows function has changed one or more of the window's styles.
CWnd::OnStyleChangingCWnd::OnStyleChanging Означает, что функция SetWindowLong Windows собирается изменить один или несколько стилей окна.Indicates that the SetWindowLong Windows function is about to change one or more of the window's styles.
CWnd::OnSysCharCWnd::OnSysChar Вызывается, когда нажатие клавиши преобразуется в системный символ.Called when a keystroke translates to a system character.
CWnd::OnSysColorChangeCWnd::OnSysColorChange Вызывается для всех окон верхнего уровня при изменении параметра системного цвета.Called for all top-level windows when a change is made in the system color setting.
CWnd::OnSysCommandCWnd::OnSysCommand Вызывается, когда пользователь выбирает команду в оконном меню или нажимает кнопку развертывания или свертывания.Called when the user selects a command from the Control menu, or when the user selects the Maximize or Minimize button.
CWnd::OnSysDeadCharCWnd::OnSysDeadChar Вызывается, когда нажатие клавиши преобразуется в системный диакритический знак.Called when a keystroke translates to a system dead character (such as accent characters).
CWnd::OnSysKeyDownCWnd::OnSysKeyDown Вызывается, когда пользователь, удерживая клавишу ALT, нажимает другую клавишу.Called when the user holds down the ALT key and then presses another key.
CWnd::OnSysKeyUpCWnd::OnSysKeyUp Вызывается, когда пользователь отпускает клавишу, нажатую при удерживании клавиши ALT.Called when the user releases a key that was pressed while the ALT key was held down.
CWnd::OnTCardCWnd::OnTCard Вызывается, когда пользователь нажимает настраиваемую кнопку.Called when the user clicks an authorable button.
CWnd::OnTimeChangeCWnd::OnTimeChange Вызывается для всех окон верхнего уровня после изменения системного времени.Called for all top-level windows after the system time changes.
CWnd::OnTimerCWnd::OnTimer Вызывается после каждого интервала, указанного в SetTimer.Called after each interval specified in SetTimer.
CWnd::OnTouchInputCWnd::OnTouchInput Обработка одного ввода Windows touch.Process single input from Windows touch.
CWnd::OnTouchInputsCWnd::OnTouchInputs Обработка входных данных Windows touch.Process inputs from Windows touch.
CWnd::OnUniCharCWnd::OnUniChar Вызывается при нажатии клавиши.Called when a key is pressed. То есть текущее окно имеет фокус клавиатуры, а WM_KEYDOWN сообщение переводится функцией TranslateMessage.That is, the current window has the keyboard focus and a WM_KEYDOWN message is translated by the TranslateMessage function.
CWnd::OnUnInitMenuPopupCWnd::OnUnInitMenuPopup Вызывается при уничтожении раскрывающегося меню или подменю.Called when a drop-down menu or submenu has been destroyed.
CWnd::OnUpdateUIStateCWnd::OnUpdateUIState Вызывается, чтобы изменить состояние пользовательского интерфейса указанного окна и всех его дочерних окон.Called to change the user interface (UI) state for the specified window and all its child windows.
CWnd::OnUserChangedCWnd::OnUserChanged Вызывается при входе пользователя в систему или выходе из нее.Called after the user has logged on or off.
CWnd::OnVKeyToItemCWnd::OnVKeyToItem Вызывается в поле CWnd списка, принадлежащем в ответ на сообщение WM_KEYDOWN.Called by a list box owned by CWnd in response to a WM_KEYDOWN message.
CWnd::OnVScrollCWnd::OnVScroll Вызывается, когда пользователь щелкает вертикальную полосу прокрутки окна.Called when the user clicks the window's vertical scroll bar.
CWnd::OnVScrollClipboardCWnd::OnVScrollClipboard Вызывается, когда владелец должен прокрутить изображение из буфера, объявить необходимый раздел недействительным, а также обновить значения полосы прокрутки.Called when the owner should scroll the Clipboard image, invalidate the appropriate section, and update the scroll-bar values.
CWnd::OnWindowPosChangedCWnd::OnWindowPosChanged Вызывается, когда размер, позиция или порядок изменяются в результате вызова в SetWindowPos или другой функции управления окнами.Called when the size, position, or Z-order has changed as a result of a call to SetWindowPos or another window-management function.
CWnd::OnWindowPosChangingCWnd::OnWindowPosChanging Вызывается, когда размер, позиция или порядок в порядке службы в результате вызова в SetWindowPos или другой функции управления окнами.Called when the size, position, or Z-order is about to change as a result of a call to SetWindowPos or another window-management function.
CWnd::OnWinIniChangeCWnd::OnWinIniChange Вызывается для всех окон верхнего уровня после изменения файла инициализации Windows (WIN.INI).Called for all top-level windows after the Windows initialization file, WIN.INI, is changed.
CWnd::OnWndMsgCWnd::OnWndMsg Указывает, что сообщение для окна обработано.Indicates if a windows message was handled.
CWnd::OnXButtonDblClkCWnd::OnXButtonDblClk Вызывается, если пользователь дважды щелкает кнопкой XBUTTON1 или XBUTTON2, когда курсор находится в клиентской области окна.Called when the user double-clicks XBUTTON1 or XBUTTON2 while the cursor is in the client area of a window.
CWnd::OnXButtonDownCWnd::OnXButtonDown Вызывается, если пользователь щелкает кнопкой XBUTTON1 или XBUTTON2, когда курсор находится в клиентской области окна.Called when the user presses XBUTTON1 or XBUTTON2 while the cursor is in the client area of a window.
CWnd::OnXButtonUpCWnd::OnXButtonUp Вызывается, если пользователь отпускает кнопку XBUTTON1 или XBUTTON2, когда курсор находится в клиентской области окна.Called when the user releases XBUTTON1 or XBUTTON2 while the cursor is in the client area of a window.
CWnd::PostNcDestroyCWnd::PostNcDestroy Эта виртуальная функция вызывается функцией OnNcDestroy по умолчанию после того, как окно было уничтожено.This virtual function is called by the default OnNcDestroy function after the window has been destroyed.
CWnd::ReflectChildNotifyCWnd::ReflectChildNotify Вспомогательная функция, отражающая сообщение его источнику.Helper function which reflects a message to its source.
CWnd::ReflectLastMsgCWnd::ReflectLastMsg Отражает последнее сообщение дочернему окну.Reflects the last message to the child window.
CWnd::ResizeDynamicLayoutCWnd::ResizeDynamicLayout Вызывается платформой при изменении размера окна для настройки макета дочерних окон, если для этого окна используется динамический макет.Called by the framework when the window size changes to adjust the layout of child windows, if dynamic layout is enabled for the window.
CWnd::WindowProcCWnd::WindowProc Предоставляет объекту CWnd процедуру окна.Provides a window procedure for a CWnd. По умолчанию отправляет сообщения через схему сообщений.The default dispatches messages through the message map.

Открытые операторыPublic Operators

ИмяName ОписаниеDescription
CWnd::operator HWNDCWnd::operator HWND Вызывается для получения дескриптора окна.Call to get a handle to a window.
CWnd::оператор !CWnd::operator != Определяет, является ли окно не таким, как окно, ручка которого m_hWnd.Determines if a window is not the same as the window whose handle is m_hWnd.
CWnd::operator ==CWnd::operator == Определяет, является ли окно таким же, как окно, рукоятки которого m_hWnd.Determines if a window is the same as the window whose handle is m_hWnd.

Открытые члены данныхPublic Data Members

ИмяName ОписаниеDescription
CWnd::m_hWndCWnd::m_hWnd Указывает на HWND прилагается к этому CWnd.Indicates the HWND attached to this CWnd.

RemarksRemarks

Объект CWnd используется отдельно от окна Windows, но они тесно связаны.A CWnd object is distinct from a Windows window, but the two are tightly linked. Объект CWnd создается или уничтожается конструктором или деструктором CWnd соответственно.A CWnd object is created or destroyed by the CWnd constructor and destructor. Окно Windows, с другой стороны, представляет собой структуру данных, внутреннюю к Windows, которая создается функцией Create члена и уничтожается CWnd виртуальным деструктором.The Windows window, on the other hand, is a data structure internal to Windows that is created by a Create member function and destroyed by the CWnd virtual destructor. Функция DestroyWindow разрушает окно Windows, не разрушая объект.The DestroyWindow function destroys the Windows window without destroying the object.

Класс CWnd и механизм карты сообщений WndProc скрывают функцию.The CWnd class and the message-map mechanism hide the WndProc function. Входящие сообщения уведомлений Windows автоматически направляются через карту сообщений на соответствующие функции членов OnMessage. CWndIncoming Windows notification messages are automatically routed through the message map to the proper OnMessage CWnd member functions. Вы переопределить функцию участника OnMessage для обработки конкретного сообщения участника в классах, полученных из полученных.You override an OnMessage member function to handle a member's particular message in your derived classes.

С помощью класса CWnd также возможно создание дочерних окон Windows для вашего приложения.The CWnd class also lets you create a Windows child window for your application. Создайте производный класс от CWnd, а затем добавьте в него переменные-члены для хранения данных, относящихся к вашему приложению.Derive a class from CWnd, then add member variables to the derived class to store data specific to your application. Реализуйте в производном классе функции-члены обработчика сообщений и схему сообщений, чтобы указать, что происходит, когда сообщения направляются в окно.Implement message-handler member functions and a message map in the derived class to specify what happens when messages are directed to the window.

Дочерние окна создаются в два этапа.You create a child window in two steps. Сначала позвоните в CWnd конструктор, CWnd чтобы построить объект, затем позвоните в функцию CWnd члена Create, чтобы создать окно ребенка и прикрепите его к объекту.First, call the constructor CWnd to construct the CWnd object, then call the Create member function to create the child window and attach it to the CWnd object.

Когда пользователь закроет ваше дочернее окно, уничтожьте объект CWnd или вызовите функцию-член DestroyWindow для удаления окна и уничтожения его структур данных.When the user terminates your child window, destroy the CWnd object, or call the DestroyWindow member function to remove the window and destroy its data structures.

В библиотеке Microsoft Foundation Class дальнейшие классы получаются как производные от CWnd, что позволяет создавать окна особых типов.Within the Microsoft Foundation Class Library, further classes are derived from CWnd to provide specific window types. Многие из этих классов, в том числе CFrameWnd, CMDIFrameWnd, CMDIChildWnd, CViewи CDialog,предназначены для дальнейшего произвлечения.Many of these classes, including CFrameWnd, CMDIFrameWnd, CMDIChildWnd, CView, and CDialog, are designed for further derivation. Контрольные классы, CWndполученные из, такие как CButton, могут быть использованы непосредственно или могут быть использованы для дальнейшего произвлечения классов.The control classes derived from CWnd, such as CButton, can be used directly or can be used for further derivation of classes.

Для получения дополнительной CWndинформации об Window Objectsиспользовании см.For more information on using CWnd, see Frame Windows and Window Objects.

Иерархия наследованияInheritance Hierarchy

CObjectCObject

CCmdTargetCCmdTarget

CWnd

ТребованияRequirements

Заголовок: afxwin.hHeader: afxwin.h

CWnd::accDoDefaultActionCWnd::accDoDefaultAction

Вызывается платформой для выполнения объектом действия по умолчанию.Called by the framework to perform the object's default action.

virtual HRESULT accDoDefaultAction(VARIANT varChild);

ПараметрыParameters

varChildvarChild
Определяет, является ли действие по умолчанию, которое необходимо высвобовать, объектом или одним из элементов ребенка объекта.Specifies whether the default action to be invoked is that of the object or one of the object's child elements. Этот параметр может быть как CHILDID_SELF (для выполнения действия объекта по умолчанию), либо идентификатора ребенка (для выполнения действия по умолчанию одного из элементов ребенка объекта).This parameter can be either CHILDID_SELF (to perform the object's default action) or a child ID (to perform the default action of one of the object's child elements).

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::accDoDefaultAction в Windows SDK.See Return Values in IAccessible::accDoDefaultAction in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переизвейдиэту CWndфункцию в классе,производное для выполнения действий объекта по умолчанию.Override this function in your CWnd-derived class to perform your object's default action. Для получения дополнительной информации см. IAccessible::accDoDefaultAction в Windows SDK.For more information, see IAccessible::accDoDefaultAction in the Windows SDK.

CWnd::accHitTestCWnd::accHitTest

Вызывается платформой для извлечения дочернего элемента или дочернего объекта в заданной точке экрана.Called by the framework to retrieve the child element or child object at a given point on the screen.

virtual HRESULT accHitTest(
    long xLeft,
    long yTop,
    VARIANT* pvarChild);

ПараметрыParameters

x СлеваxLeft
X-координация точки, которая будет проверена (в экранах единиц).X-coordinate of the point to be hit tested (in screen units).

yTopyTop
Y-координаты точки, которая будет поражена (в экранах единиц).Y-coordinate of the point to be hit tested (in screen units).

pvarChildpvarChild
Получает информацию, идентифицирующую объект в точке, указанной xLeft и yTop.Receives information identifying the object at the point specified by xLeft and yTop. Смотрите pvarID в IAccessible::accHitTest в Windows SDK.See pvarID in IAccessible::accHitTest in the Windows SDK.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::accHitTest в SDK Windows.See Return Values in IAccessible::accHitTest in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::accHitTest в Windows SDK.For more information, see IAccessible::accHitTest in the Windows SDK.

CWnd::accLocationCWnd::accLocation

Вызывается платформой для получения текущего положения указанного объекта на экране.Called by the framework to retrieve the specified object's current screen location.

virtual HRESULT accLocation(
    long* pxLeft,
    long* pyTop,
    long* pcxWidth,
    long* pcyHeight,
    VARIANT varChild);

ПараметрыParameters

pxСлеваpxLeft
Получает x-координат верхнего левого угла объекта (в блоках экрана).Receives x-coordinate of the object's upper-left corner (in screen units).

pyToppyTop
Получает y-координат верхнего левого угла объекта (в блоках экрана).Receives y-coordinate of the object's upper-left corner (in screen units).

pcxWidthpcxWidth
Получает ширину объекта (в блоках экрана).Receives width of the object (in screen units).

pcyHeightpcyHeight
Получает высоту объекта (в блоках экрана).Receives height of the object (in screen units).

varChildvarChild
Уточняется, является ли место, которое необходимо получить, местом, которое необходимо получить, объектили или один из элементов ребенка объекта.Specifies whether the location to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::accLocation в SDK Windows.See Return Values in IAccessible::accLocation in the Windows SDK.

RemarksRemarks

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной IAccessible::accLocation информации см.For more information, see IAccessible::accLocation in the Windows SDK.

CWnd::accNavigateCWnd::accNavigate

Вызывается платформой для перехода к другому элементу пользовательского интерфейса внутри контейнера и, если возможно, для извлечения объекта.Called by the framework to traverse to another user interface element within a container and if possible, retrieve the object.

virtual HRESULT accNavigate(
    long navDir,
    VARIANT varStart,
    VARIANT* pvarEndUpAt);

ПараметрыParameters

navDirnavDir
Определяет направление навигации.Specifies the direction to navigate. Смотрите navDir в IAccessible::accNavigate в Windows SDK.See navDir in IAccessible::accNavigate in the Windows SDK.

varStartvarStart
Определяет исходный объект.Specifies the starting object. Смотрите varStart в IAccessible::accNavigate Windows SDK.See varStart in IAccessible::accNavigate in the Windows SDK.

pvarendupAtpvarEndUpAt
Получает информацию об объекте пользовательского интерфейса назначения.Receives information about the destination user interface object. Смотрите PvarEnd в IAccessible::accNavigate Windows SDK.See pvarEnd in IAccessible::accNavigate in the Windows SDK.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::accNavigate в SDK Windows.See Return Values in IAccessible::accNavigate in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::accNavigate в Windows SDK.For more information, see IAccessible::accNavigate in the Windows SDK.

CWnd::accSelectCWnd::accSelect

Вызывается платформой для изменения выбранной области или перемещения фокуса клавиатурного ввода указанного объекта.Called by the framework to modify the selection or move the keyboard focus of the specified object.

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

ПараметрыParameters

флагиВыберитеflagsSelect
Определяет, как изменить текущий выбор или фокус.Specifies how to change the current selection or focus. Смотрите флагиВыберите в IAccessible::accSelect в Windows SDK.See flagsSelect in IAccessible::accSelect in the Windows SDK.

varChildvarChild
Определяет выбранный объект.Specifies the object to be selected. Этот параметр может быть как CHILDID_SELF (для выбора самого объекта), либо идентификатором ребенка (для выбора одного из детей объекта).This parameter can be either CHILDID_SELF (to select the object itself) or a child ID (to select one of the object's children).

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::accSelect в SDK Windows.See Return Values in IAccessible::accSelect in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::accSelect в Windows SDK.For more information, see IAccessible::accSelect in the Windows SDK.

CWnd::AnimateWindowCWnd::AnimateWindow

Производит специальные эффекты при показе или сокрытии окон.Produces special effects when showing or hiding windows.

BOOL AnimateWindow(
    DWORD dwTime,
    DWORD dwFlags);

ПараметрыParameters

dwTimedwTime
Определяет, сколько времени требуется для воспроизведения анимации, в миллисекундах.Specifies how long it takes to play the animation, in milliseconds. Обычно для воспроизведения анимации требуется 200 миллисекунд.Typically, an animation takes 200 milliseconds to play.

dwFlagsdwFlags
Определяет тип анимации.Specifies the type of animation. Полный список возможных значений можно узнать на экране AnimateWindow.For a full list of possible values, see AnimateWindow.

Возвращаемое значениеReturn Value

Nonzero, если функция успешно; в противном случае 0.Nonzero if the function succeeds; otherwise 0.

RemarksRemarks

Эта функция члена эмулирует функциональность функции AnimateWindow, как описано в Windows SDK.This member function emulates the functionality of the function AnimateWindow, as described in the Windows SDK.

CWnd::ArrangeIconicWindowsCWnd::ArrangeIconicWindows

Упорядочивает все свернутые (преобразованные в значки) дочерние окна.Arranges all the minimized (iconic) child windows.

UINT ArrangeIconicWindows();

Возвращаемое значениеReturn Value

Высота одного ряда иконок, если функция успешна; в противном случае 0.The height of one row of icons if the function is successful; otherwise 0.

RemarksRemarks

Эта функция участника также организует значки на окне рабочего стола, которое охватывает весь экран.This member function also arranges icons on the desktop window, which covers the entire screen. Функция члена GetDesktopWindow получает указатель на объект окна рабочего стола.The GetDesktopWindow member function retrieves a pointer to the desktop window object.

Чтобы организовать знаковые окна mDI ребенка в окне клиента MDI, позвоните CMDIFrameWnd::MDIIconArrange.To arrange iconic MDI child windows in an MDI client window, call CMDIFrameWnd::MDIIconArrange.

ПримерExample

// arrange minimized MDI child windows
// called from menu item; CMdiChildFrame is derived from CMDIChildWnd
void CMdiChildFrame::OnActionArrangeIconicWindows()
{
   UINT height = GetParent()->ArrangeIconicWindows();   
   TRACE(_T("height = %d\n"), height);
}

CWnd::ПрикрепитеCWnd::Attach

Прикрепляет окно Windows CWnd к объекту.Attaches a Windows window to a CWnd object.

BOOL Attach(HWND hWndNew);

ПараметрыParameters

hWndNewhWndNew
Определяет ручку к окну Windows.Specifies a handle to a Windows window.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

ПримерExample

В этом примере показано, как использовать Прикрепить и Отек для отображения в окне клиента MDI.This example shows how to use Attach and Detach to map to the MDI client window.

// Declare a CWnd member of CMainFrame
public:
CWnd m_wndMDIClient;
// detach MDI client window in CMainFrame destructor
m_wndMDIClient.Detach();
// In CMainFrame::OnCreate, attach MDI client window

if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
   return -1;

// attach MDI client window
if (m_wndMDIClient.Attach(m_hWndMDIClient) == 0)
{
   TRACE(_T("Failed to attach MDIClient.\n"));
   return -1; // fail to create
}

CWnd::BeginModalStateCWnd::BeginModalState

Данная функция-член вызывается для преобразования окна фрейма в модальное.Call this member function to make a frame window modal.

virtual void BeginModalState();

CWnd::BeginPaintCWnd::BeginPaint

CWnd Готовится к покраске и заполняет структуру PAINTSTRUCT данных информацией о картине.Prepares CWnd for painting and fills a PAINTSTRUCT data structure with information about the painting.

CDC* BeginPaint(LPPAINTSTRUCT lpPaint);

ПараметрыParameters

lpPaintlpPaint
Указывает на структуру PAINTSTRUCT, которая должна получать информацию о покраске.Points to the PAINTSTRUCT structure that is to receive painting information.

Возвращаемое значениеReturn Value

Определяет контекст устройства CWndдля .Identifies the device context for CWnd. Указатель может быть временным и не должен храниться за пределами EndPaint.The pointer may be temporary and should not be stored beyond the scope of EndPaint.

RemarksRemarks

Структура краски содержит структуру данных RECT, которая имеет наименьший прямоугольник, который полностью закрывает область обновления, и флаг, который определяет, был ли стерт фон.The paint structure contains a RECT data structure that has the smallest rectangle that completely encloses the update region and a flag that specifies whether the background has been erased.

Область обновления устанавливается недействительными, недействительнымифункциями участника И системой после того, как она размерирует, перемещает, создает, прокручивает или выполняет любую другую операцию, которая влияет на область клиента.The update region is set by the Invalidate, InvalidateRect, or InvalidateRgn member functions and by the system after it sizes, moves, creates, scrolls, or performs any other operation that affects the client area. Если область обновления помечена для BeginPaint стыкания, отправляет сообщение WM_ONERASEBKGND.If the update region is marked for erasing, BeginPaint sends an WM_ONERASEBKGND message.

Не звоните BeginPaint в функцию участника, кроме как в ответ на WM_PAINT сообщение.Do not call the BeginPaint member function except in response to a WM_PAINT message. Каждый вызов BeginPaint функции участника должен иметь соответствующий вызов для функции участника EndPaint.Each call to the BeginPaint member function must have a matching call to the EndPaint member function. Если карета находится в области, BeginPaint подавки картины, функция члена автоматически скрывает карету, чтобы предотвратить его стирание.If the caret is in the area to be painted, the BeginPaint member function automatically hides the caret to prevent it from being erased.

ПримерExample

// Use BeginPaint and EndPaint when responding to WM_PAINT message
// An alternative method is to use CPaintDC in place of
// BeginPaint and EndPaint
void CMdiView::OnPaint()
{
   PAINTSTRUCT ps;
   CDC *pDC = BeginPaint(&ps);

   pDC->Rectangle(CRect(0, 0, 100, 100));

   EndPaint(&ps);

   // Do not call CView::OnPaint() for painting messages
}

CWnd::BindDefaultPropertyCWnd::BindDefaultProperty

Связывает простое связанное свойство объекта вызова (например, элемент управления исправлением), отмеченное в библиотеке типа, с базовым курсором, определяемым dataSource, UserName, Password и S'L свойствами управления источником данных.Binds the calling object's default simple bound property (such as an edit control), as marked in the type library, to the underlying cursor that is defined by the DataSource, UserName, Password, and SQL properties of the data-source control.

void BindDefaultProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    LPCTSTR szFieldName,
    CWnd* pDSCWnd);

ПараметрыParameters

dwDispIDdwDispID
Определяет DISPID свойства на элементе управления, связанном с данными, которое должно быть связано с управлением источником данных.Specifies the DISPID of a property on a data-bound control that is to be bound to a data-source control.

vtPropvtProp
Упомяните тип собственности, который должен быть связан - например, VT_BSTR, VT_VARIANT и так далее.Specifies the type of the property to be bound — for example, VT_BSTR, VT_VARIANT, and so on.

szFieldNameszFieldName
Укравит название столбца в курсоре, предоставленном управлением источником данных, к которому будет привязано свойство.Specifies the name of the column, in the cursor provided by the data-source control, to which the property will be bound.

pDSCWndpDSCWnd
Указывает на окно, в котором размещается элемент управления исходным источником данных, к которому будет привязано свойство.Points to the window that hosts the data-source control to which the property will be bound. Позвоните GetDlgItem с идентификатором ресурса окна узла DCS, чтобы получить этот указатель.Call GetDlgItem with the resource ID of the DCS's host window to retrieve this pointer.

RemarksRemarks

Объект, CWnd на котором вы называете эту функцию, должен быть элементом управления, связанным с данными.The CWnd object on which you call this function must be a data-bound control.

ПримерExample

BindDefaultPropertyмогут быть использованы в следующем контексте:BindDefaultProperty might be used in the following context:

BOOL CMyDlg::OnInitDialog()
{
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pMyBound = GetDlgItem(IDC_MYBOUNDCTRL1);
   pMyBound->BindDefaultProperty(0x1, VT_BSTR, _T("ContactFirstName"), pDSC);
   return TRUE;
}

CWnd::BindPropertyCWnd::BindProperty

Связывает свойство, связанное с курсором, на элементе управления данными (например, контроль сетки) с контролем источника данных и регистрирует связь с связывающим менеджером MFC.Binds a cursor-bound property on a data-bound control (such as a grid control) to a data-source control and registers that relationship with the MFC binding manager.

void BindProperty(
    DISPID dwDispId,
    CWnd* pWndDSC);

ПараметрыParameters

dwDispIddwDispId
Определяет DISPID свойства на элементе управления, связанном с данными, которое должно быть связано с управлением источником данных.Specifies the DISPID of a property on a data-bound control that is to be bound to a data-source control.

pWndDSCpWndDSC
Указывает на окно, в котором размещается элемент управления исходным источником данных, к которому будет привязано свойство.Points to the window that hosts the data-source control to which the property will be bound. Позвоните GetDlgItem с идентификатором ресурса окна узла DCS, чтобы получить этот указатель.Call GetDlgItem with the resource ID of the DCS's host window to retrieve this pointer.

RemarksRemarks

Объект, CWnd на котором вы называете эту функцию, должен быть элементом управления, связанным с данными.The CWnd object on which you call this function must be a data-bound control.

ПримерExample

BindPropertyмогут быть использованы в следующем контексте:BindProperty might be used in the following context:

BOOL CMyDlg::OnInitDialog()
{
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pMyBound = GetDlgItem(IDC_MYBOUNDCTRL2);
   pMyBound->BindProperty(0x1, pDSC);
   return TRUE;
}

CWnd::BringWindowToTopCWnd::BringWindowToTop

Перемещает CWnd на вершину стека перекрывающихся окон.Brings CWnd to the top of a stack of overlapping windows.

void BringWindowToTop();

RemarksRemarks

Кроме того BringWindowToTop активирует всплывающие окна, окна высшего уровня и дочерние окна MDI.In addition, BringWindowToTop activates pop-up, top-level, and MDI child windows. Функцию-член BringWindowToTop следует использовать, чтобы показать любое окно, частично или полностью скрытое какими-либо перекрывающими окнами.The BringWindowToTop member function should be used to uncover any window that is partially or completely obscured by any overlapping windows.

Эта функция просто вызывает функцию Win32 BringWindowToTop.This function just calls the Win32 BringWindowToTop function. Вызовите функцию SetWindowPos, чтобы изменить положение окна в заказе.Call the SetWindowPos function to change a window's position in the Z-order. Функция BringWindowToTop не изменяет стиль окна, чтобы сделать его окном верхнего уровня.The BringWindowToTop function does not change the window style to make it a top-level window. Для получения дополнительной информации, смотрите В чем разница между HWND_TOP и HWND_TOPMOSTFor more information, see What's the difference between HWND_TOP and HWND_TOPMOST

ПримерExample

// Moves MDI child windows to the top when a mouse passes
// over it. CMdiView is derived from CView.
void CMdiView::OnMouseMove(UINT nFlags, CPoint point) 
{
   UNREFERENCED_PARAMETER(nFlags);
   UNREFERENCED_PARAMETER(point);

   GetParentFrame()->BringWindowToTop();
}

CWnd::CalcWindowRectCWnd::CalcWindowRect

Вычисляет прямоугольник окна, который может содержать указанный прямоугольник клиента.Calculates the window rectangle that can contain the specified client rectangle.

virtual void CalcWindowRect(
    LPRECT lpClientRect,
    UINT nAdjustType = adjustBorder);

ПараметрыParameters

lpClientRectlpClientRect
(в, вне) Указатель на структуру прямоугольника.[in, out] Pointer to a rectangle structure. При входе эта структура содержит прямоугольник клиента.On input, this structure contains the client rectangle. После завершения метода эта структура содержит прямоугольник окна, который может содержать указанный прямоугольник клиента.After the method is finished, this structure contains the window rectangle that can contain the specified client rectangle.

nAdjustTypenAdjustType
(в) Используйте CWnd::adjustBorder для расчета координат окон без WS_EX_CLIENTEDGE стиля; в противном случае, использовать CWnd::adjustOutside.[in] Use CWnd::adjustBorder to calculate window coordinates without the WS_EX_CLIENTEDGE style; otherwise, use CWnd::adjustOutside.

RemarksRemarks

Размер вычисленного прямоугольника окна не включает место для панели меню.The size of the calculated window rectangle does not include space for a menu bar.

Дополнительные ограничения на использование можно узнать на примере AdjustWindowRecTEx.For more usage restrictions, see AdjustWindowRectEx.

ПримерExample

// Uses CalcWindowRect to determine size for new CFrameWnd
// based on the size of the current view. The end result is a
// top level frame window of the same size as CMdiView's frame.
void CMdiView::OnMyCreateFrame()
{
   CFrameWnd *pFrameWnd = new CFrameWnd;
   CRect myRect;
   GetClientRect(myRect);
   pFrameWnd->Create(NULL, _T("My Frame"));
   pFrameWnd->CalcWindowRect(&myRect, CWnd::adjustBorder);
   pFrameWnd->MoveWindow(0, 0, myRect.Width(), myRect.Height());
   pFrameWnd->ShowWindow(SW_SHOW);
}

CWnd::CancelToolTipsCWnd::CancelToolTips

Вызов эту функцию члена, чтобы удалить наконечник инструмента с экрана, если наконечник инструмента в настоящее время отображается.Call this member function to remove a tool tip from the screen if a tool tip is currently displayed.

static void PASCAL CancelToolTips(BOOL bKeys = FALSE);

ПараметрыParameters

bKeysbKeys
TRUE для отмены советов по инструменту при нажатии клавиши и установки текста панели статуса по умолчанию; в противном случае FALSE.TRUE to cancel tool tips when a key is pressed and set the status bar text to the default; otherwise FALSE.

RemarksRemarks

Note

Использование этой функции члена не влияет на советы инструмента, управляемые вашим кодом.Using this member function has no effect on tool tips managed by your code. Это влияет только на инструмент отзыв управления CWnd::EnableToolTips.It only affects the tool tip control managed by CWnd::EnableToolTips.

ПримерExample

// In this example, tool tips were set up to
// pop up when the user moves the mouse
// over this edit control.
// If the mouse is moved to the upper left-hand
// corner, the tool tip would disappear because of
// calling CancelToolTips.
void CMyEdit::OnMouseMove(UINT nFlags, CPoint point)
{
   CRect corner(0, 0, 10, 10);
   if (corner.PtInRect(point))
      CancelToolTips();
   CEdit::OnMouseMove(nFlags, point);
}

CWnd:CenterWindowCWnd::CenterWindow

Выравнивает окно по центру относительно его родительских окон.Centers a window relative to its parent.

void CenterWindow(CWnd* pAlternateOwner = NULL);

ПараметрыParameters

pAlternateВладелецpAlternateOwner
Указатель на альтернативное окно, относительно которого оно будет по центру (кроме родительского окна).Pointer to an alternate window relative to which it will be centered (other than the parent window).

RemarksRemarks

Обычно вызывается из CDialog::OnInitDialog в центр диалоговых коробок относительно основного окна приложения.Usually called from CDialog::OnInitDialog to center dialog boxes relative to the main window of the application. По умолчанию функции центры детских окон по отношению к их родительскому окну, и всплывающие окна по отношению к их владельцу.By default, the function centers child windows relative to their parent window, and pop-up windows relative to their owner. Если всплывающее окно не принадлежит, оно центрируется по отношению к экрану.If the pop-up window is not owned, it is centered relative to the screen. Для центрировать окно по отношению к определенному окну, которое не является владельцем или родителем, параметр pAlternateOwner может быть установлен на действительное окно.To center a window relative to a specific window which is not the owner or parent, the pAlternateOwner parameter may be set to a valid window. Чтобы заставить центрирование относительно экрана, передайте значение, возвращенное CWnd::GetDesktopWindow как pAlternateOwner.To force centering relative to the screen, pass the value returned by CWnd::GetDesktopWindow as pAlternateOwner.

ПримерExample

BOOL CAboutDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   CenterWindow();

   return TRUE;
}

CWnd::ChangeClipboardChainCWnd::ChangeClipboardChain

Удаляет CWnd из цепочки Clipboard зрителей и делает окно, указанное CWnd hWndNext потомком предка в цепочке.Removes CWnd from the chain of Clipboard viewers and makes the window specified by hWndNext the descendant of the CWnd ancestor in the chain.

BOOL ChangeClipboardChain(HWND hWndNext);

ПараметрыParameters

hWndNexthWndNext
Идентифицирует окно, CWnd которое следует в цепочке Clipboard-viewer.Identifies the window that follows CWnd in the Clipboard-viewer chain.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

CWnd::CheckDlgButtonCWnd::CheckDlgButton

Выбрав (устанавливает галочку рядом) или очищает (удаляет контрольный знак) кнопку, или она изменяет состояние кнопки с тремя состояниями.Selects (places a check mark next to) or clears (removes a check mark from) a button, or it changes the state of a three-state button.

void CheckDlgButton(
    int nIDButton,
    UINT nCheck);

ПараметрыParameters

nIDButtonnIDButton
Определяет кнопку для изменения.Specifies the button to be modified.

NпроверьтеnCheck
Определяет действия, которые необходимо предпринять.Specifies the action to take. Если nCheck является ненулевой, функция CheckDlgButton участника устанавливает галостопную отметку рядом с кнопкой; если 0, контрольный знак удаляется.If nCheck is nonzero, the CheckDlgButton member function places a check mark next to the button; if 0, the check mark is removed. Для кнопок с тремя состояниями, если nCheck 2, состояние кнопки является неопределенным.For three-state buttons, if nCheck is 2, the button state is indeterminate.

RemarksRemarks

Функция CheckDlgButton отправляет BM_SETCHECK сообщение на указанную кнопку.The CheckDlgButton function sends a BM_SETCHECK message to the specified button.

ПримерExample

// Sets 3 check buttons in various ways.  Note BST_INDETERMINATE
// requires BS_3STATE or BS_AUTO3STATE in the button's style.
void CMyDlg::OnMarkButtons()
{
   CheckDlgButton(IDC_CHECK1, BST_UNCHECKED);     // 0
   CheckDlgButton(IDC_CHECK2, BST_CHECKED);       // 1
   CheckDlgButton(IDC_CHECK3, BST_INDETERMINATE); // 2
}

CWnd::CheckRadioButtonCWnd::CheckRadioButton

Выбирает (добавляет контрольный знак) заданную радиокнопку в группе и очищает (удаляет галочку) все остальные радиокнопки в группе.Selects (adds a check mark to) a given radio button in a group and clears (removes a check mark from) all other radio buttons in the group.

void CheckRadioButton(
    int nIDFirstButton,
    int nIDLastButton,
    int nIDCheckButton);

ПараметрыParameters

nIDFirstButtonnIDFirstButton
Определяет идентификатор первой радиокнопки в группе.Specifies the integer identifier of the first radio button in the group.

nIDLastButtonnIDLastButton
Определяет идентификатор всей этой кнопки радио в группе.Specifies the integer identifier of the last radio button in the group.

nIDCheckButtonnIDCheckButton
Определяет идентификатор бесхопозна кнопки радио, которая должна быть проверена.Specifies the integer identifier of the radio button to be checked.

RemarksRemarks

Функция CheckRadioButton отправляет BM_SETCHECK сообщение на указанную кнопку радио.The CheckRadioButton function sends a BM_SETCHECK message to the specified radio button.

ПримерExample

// Of the 4 radio buttons, selects radio button 3.
void CMyDlg::OnMarkRadio()
{
   CheckRadioButton(IDC_RADIO1, IDC_RADIO4, IDC_RADIO3);
}

CWnd::ChildWindowFromPointCWnd::ChildWindowFromPoint

Определяет, какие окна ребенка, принадлежащие CWnd ребенку, содержат указанную точку.Determines which, if any, of the child windows belonging to CWnd contains the specified point.

CWnd* ChildWindowFromPoint(POINT point) const;

CWnd* ChildWindowFromPoint(
    POINT point,
    UINT nFlags) const;

ПараметрыParameters

Точкиpoint
Определяет координаты клиента точки, которые должны быть протестированы.Specifies the client coordinates of the point to be tested.

nфлагиnflags
Определяет, какие окна ребенка пропустить.Specifies which child windows to skip. Этот параметр может быть комбинацией следующих значений:This parameter can be a combination of the following values:

ЗначениеValue ЗначениеMeaning
CWP_ALLCWP_ALL Не пропускайте детские окнаDo not skip any child windows
CWP_SKIPINVISIBLECWP_SKIPINVISIBLE Пропустить невидимые детские окнаSkip invisible child windows
CWP_SKIPDISABLEDCWP_SKIPDISABLED Пропустить детские окна для инвалидовSkip disabled child windows
CWP_SKIPTRANSPARENTCWP_SKIPTRANSPARENT Пропустить прозрачные детские окнаSkip transparent child windows

Возвращаемое значениеReturn Value

Идентифицирует окно ребенка, содержащее точку.Identifies the child window that contains the point. Это NULL, если данный пункт находится за пределами клиентской области.It is NULL if the given point lies outside of the client area. Если точка находится в зоне клиента, но не CWnd содержится в окне ребенка, возвращается.If the point is within the client area but is not contained within any child window, CWnd is returned.

Эта функция участника возвращает скрытое или отключенное окно ребенка, содержащее указанную точку.This member function will return a hidden or disabled child window that contains the specified point.

Более одного окна может содержать заданную точку.More than one window may contain the given point. Однако эта функция CWndвозвращает только первое окно, содержащее точку.However, this function returns only the CWnd* of the first window encountered that contains the point.

Возвращенное CWndможет быть временным и не должно храниться для последующего использования.The CWnd* that is returned may be temporary and should not be stored for later use.

ПримерExample

void CMyDlg::OnFindCenterChild() 
{
   CRect rect;
   GetClientRect(&rect);
   CWnd* pWnd = ChildWindowFromPoint(
      CPoint(rect.Width()/2, rect.Height()/2), 
      // Top left is always 0, 0.
      CWP_SKIPINVISIBLE);
   TRACE(_T("Center window is 0x%08x\n"), pWnd->m_hWnd);
}

CWnd::ClientToScreenCWnd::ClientToScreen

Преобразует клиентские координаты указанной точки или прямоугольника на экране в экранные координаты.Converts the client coordinates of a given point or rectangle on the display to screen coordinates.

void ClientToScreen(LPPOINT lpPoint) const;  void ClientToScreen(LPRECT lpRect) const;

ПараметрыParameters

lpPointlpPoint
Указывает на структуру CPoint или объект POINT, содержащий координаты клиента, которые должны быть преобразованы.Points to a POINT structure or CPoint object that contains the client coordinates to be converted.

lpRectlpRect
Указывает на структуру CRect или объект RECT, содержащий координаты клиента, которые должны быть преобразованы.Points to a RECT structure or CRect object that contains the client coordinates to be converted.

RemarksRemarks

Функция ClientToScreen члена использует координаты RECT клиента CPoint в CRect структуре POINT или объекте, на который указывает lpPoint или lpRect, для вычисления новых координат экрана; затем он заменяет координаты в структуре новыми координатами.The ClientToScreen member function uses the client coordinates in the POINT or RECT structure or the CPoint or CRect object pointed to by lpPoint or lpRect to compute new screen coordinates; it then replaces the coordinates in the structure with the new coordinates. Новые координаты экрана относительно верхнего левого угла дисплея системы.The new screen coordinates are relative to the upper-left corner of the system display.

Функция ClientToScreen участника предполагает, что данная точка или прямоугольник находится в координатах клиента.The ClientToScreen member function assumes that the given point or rectangle is in client coordinates.

ПримерExample

// resize dialog to client's size
void CMyDlg::OnSizeToClient()
{
   CRect myRect;
   GetClientRect(&myRect);

   ClientToScreen(myRect);
   MoveWindow(myRect.left, myRect.top,
              myRect.Width(), myRect.Height());
}

CWnd::CloseWindowCWnd::CloseWindow

Сворачивает окно.Minimizes the window.

void CloseWindow();

RemarksRemarks

Эта функция члена эмулирует функциональность функции CloseWindow, как описано в Windows SDK.This member function emulates the functionality of the function CloseWindow, as described in the Windows SDK.

CWnd::ПродолжитьМодCWnd::ContinueModal

Эта функция члена вызывается RunModalLoop, чтобы определить, когда модоальное состояние должно быть выведено.This member function is called by RunModalLoop to determine when the modal state should be exited.

virtual BOOL ContinueModal();

Возвращаемое значениеReturn Value

Nonzero, если модальный цикл будет продолжен; 0, когда называется EndModalLoop.Nonzero if modal loop is to be continued; 0 when EndModalLoop is called.

RemarksRemarks

По умолчанию он возвращается EndModalLoop без нуля до тех пор, пока не будет вызван.By default, it returns non-zero until EndModalLoop is called.

CWnd::СозданиеCWnd::Create

Создает указанное окно дочернего ребенка и прикрепляет его к объекту CWnd.Creates the specified child window and attaches it to the CWnd object.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    Const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

ПараметрыParameters

lpszClassNamelpszClassName
(в) Указатель на строку с нулевым завершением, содержащую имя зарегистрированного класса оконного окна системы; или название заданного класса оконного окна системы.[in] Pointer to a null-terminated string that contains the name of a registered system window class; or the name of a predefined system window class.

lpszWindowNamelpszWindowName
(в) Указатель на строку с нулевым завершением, содержащую имя отображения окна; в противном случае NULL без имени отображения окна.[in] Pointer to a null-terminated string that contains the window display name; otherwise NULL for no window display name.

dwStyledwStyle
(в) Bitwise комбинация (OR) стилей окна.[in] Bitwise combination (OR) of window styles. Вариант WS_POPUP не является действительным стилем.The WS_POPUP option is not a valid style.

rectrect
(в) Размер и расположение окна относительно верхнего левого угла родительского окна.[in] The size and location of the window relative to the top-left corner of the parent window.

pParentWndpParentWnd
(в) Указатель на родительское окно.[in] Pointer to the parent window.

nIDnID
(в) Идентификатор окна.[in] ID of the window.

pContextpContext
(в) Указатель на структуру CCreateContext, которая используется для настройки архитектуры просмотра документов для приложения.[in] Pointer to a CCreateContext structure that is used to customize the document-view architecture for the application.

Возвращаемое значениеReturn Value

ПРАВДА, если метод был успешным; в противном случае FALSE.TRUE if the method was successful; otherwise FALSE.

RemarksRemarks

Warning

CWnd::PreCreateWindowтеперь присваивает CREATESTRUCT члену hMenu своего параметра этому указателю, если меню NULL, а стиль содержит WS_CHILD.CWnd::PreCreateWindow now assigns the hMenu member of its CREATESTRUCT parameter to the this pointer if the menu is NULL and the style contains WS_CHILD. Для правильной функциональности убедитесь, что ваш элемент управления диалогом имеет идентификатор, который не является NULL.For proper functionality, ensure that your dialog control has an ID that is not NULL.

Это изменение фиксирует сбой в сценариях управляемого/родного интерпа.This change fixes a crash in managed/native interop scenarios. Заявление TRACE CWnd::Create в предупреждении разработчика проблемы.A TRACE statement in CWnd::Create alerts the developer of the problem.

Используйте функцию AfxRegisterWndClass для регистрации классов окон.Use the AfxRegisterWndClass function to register window classes. Классы оконов с определенными пользователями доступны в модуле, где они зарегистрированы.User defined window classes are available in the module where they are registered.

CWnd::OnCreate называется до Create возвращения метода и до того, как окно становится видимым.The CWnd::OnCreate method is called before the Create method returns, and before the window becomes visible.

ПримерExample

// Dynamically create static control using CWnd::Create,
// instead of with CStatic::Create, which doesn't
// need the "STATIC" class name.
void CMyDlg::OnCreateStatic() 
{
   // m_pWndStatic is a CWnd* member of CMyDlg
   m_pWndStatic = new CWnd;
   m_pWndStatic->Create(_T("STATIC"), _T("Hi"), WS_CHILD | WS_VISIBLE,
       CRect(0, 0, 20, 20), this, 1234);
}

CWnd::СозданиеДоступнопроксиCWnd::CreateAccessibleProxy

Создает прокси-сервер Active Accessibility для указанного объекта.Creates an Active Accessibility proxy for the specified object.

virtual HRESULT CreateAccessibleProxy(
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

ПараметрыParameters

wParamwParam
Идентифицирует объект, доступ к нему осуществляется прокси Active Accessibility.Identifies the object accessed by the Active Accessibility proxy. Может быть одним из следующих значенийCan be one of the following values

ЗначениеValue ЗначениеMeaning
OBJID_CLIENTOBJID_CLIENT Относится к клиентской зоне окна.Refers to the window's client area.

lParamlParam
Предоставляет дополнительную информацию, зависящая от сообщений.Provides additional message-dependent information.

pResultpResult
Указатель на LRESULT, который хранит код результата.A pointer to an LRESULT that stores the result code.

RemarksRemarks

Создает прокси-сервер Active Accessibility для указанного объекта.Creates an Active Accessibility proxy for the specified object.

CWnd::CreateCaretCWnd::CreateCaret

Создает новую форму для системы caret и утверждает, что право собственности на caret.Creates a new shape for the system caret and claims ownership of the caret.

void CreateCaret(CBitmap* pBitmap);

ПараметрыParameters

pBitmappBitmap
Определяет бит-карту, которая определяет форму caret.Identifies the bitmap that defines the caret shape.

RemarksRemarks

Бит-карта должна быть ранее создана cBitmap::CreateBitmap функции члена, функция CreateDIBitmap Windows, или CBitmap::LoadBitmap член функции.The bitmap must have previously been created by the CBitmap::CreateBitmap member function, the CreateDIBitmap Windows function, or the CBitmap::LoadBitmap member function.

CreateCaretавтоматически разрушает предыдущую форму caret, если таковые имеется, независимо от того, какое окно владеет каретой.CreateCaret automatically destroys the previous caret shape, if any, regardless of which window owns the caret. После создания, карет изначально скрыты.Once created, the caret is initially hidden. Чтобы показать карету, должна быть вызвана функция участника ShowCaret.To show the caret, the ShowCaret member function must be called.

Системный карет является общим ресурсом.The system caret is a shared resource. CWndдолжны создавать карету только тогда, когда он имеет входиную фокус ировку или активен.CWnd should create a caret only when it has the input focus or is active. Он должен уничтожить карету, прежде чем он теряет входинфокус или становится неактивным.It should destroy the caret before it loses the input focus or becomes inactive.

ПримерExample

// Changes the caret of the edit control in this dialog box
void CMyDlg::OnChangeCaret()
{
   m_pBitmapCaret = new CBitmap;
   m_pBitmapCaret->LoadBitmap(IDB_HAPPY_BITMAP);
   m_MyEdit.CreateCaret(m_pBitmapCaret);
   m_MyEdit.ShowCaret();
}

CWnd::CreateControlCWnd::CreateControl

Используйте эту функцию участника для создания элемента управления ActiveX, CWnd который будет представлен в программе MFC объектом.Use this member function to create an ActiveX control that will be represented in the MFC program by a CWnd object.

BOOL CreateControl(
    LPCTSTR pszClass,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

BOOL CreateControl(
    REFCLSID clsid,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

BOOL CreateControl(
    REFCLSID clsid,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const POINT* ppt,
    const SIZE* psize,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

ПараметрыParameters

pszClasspszClass
Эта строка может содержать OLE "короткое имя" (ProgID) для класса, например, "CIRC3. Circ3Ctrl.1".This string may contain the OLE "short name" (ProgID) for the class, e.g., "CIRC3.Circ3Ctrl.1". Имя должно соответствовать тому же имени, зарегистрированному элементом управления.The name needs to match the same name registered by the control. Кроме того, строка может содержать строку формы CLSID, содержащейся в скобках, например, "9DBAFCCF-592F-101B-85CE-00608CEC297B".Alternatively, the string may contain the string form of a CLSID, contained in braces, e.g., "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". В любом CreateControl случае преобразует строку в соответствующий идентификатор класса.In either case, CreateControl converts the string to the corresponding class ID.

pszWindowNamepszWindowName
Указатель на текст, который отображается в элементе управления.A pointer to the text to be displayed in the control. Устанавливает значение свойства подписи или текста элемента управления (если таковое имеется).Sets the value of the control's Caption or Text property (if any). Если NULL, свойство подписи или текста элемента управления не изменяется.If NULL, the control's Caption or Text property is not changed.

dwStyledwStyle
Стили Windows.Windows styles. Доступные стили перечислены в Примечаниях.The available styles are listed under Remarks.

rectrect
Определяет размер и положение элемента управления.Specifies the control's size and position. Это может быть либо объект CRect, либо структура RECT.It can be either a CRect object or a RECT structure.

Pptppt
Указывает на структуру CPoint или объект POINT, содержащий верхний левый угол элемента управления.Points to a POINT structure or CPoint object that contains the upper left corner of the control.

pSizepSize
Указывает на структуру CSize или объект СИЗЕ, содержащий размер элемента управленияPoints to a SIZE structure or CSize object that contains the control's size

pParentWndpParentWnd
Определяет родительское окно элемента управления.Specifies the control's parent window. Она не должна быть NULL.It must not be NULL.

nIDnID
Уведомляет идентификатор элемента управления.Specifies the control's ID.

pPersistpPersist
Указатель на CFile, содержащий постоянное состояние для управления.A pointer to a CFile containing the persistent state for the control. Значение по умолчанию является NULL, что указывает на то, что элемент управления инициализирует себя без восстановления его состояния от постоянного хранилища.The default value is NULL, indicating that the control initializes itself without restoring its state from any persistent storage. Если не NULL, то он должен CFileбыть указателем на объект, полученный в виде постоянных данных элемента управления, в виде потока или хранилища.If not NULL, it should be a pointer to a CFile-derived object which contains the control's persistent data, in the form of either a stream or a storage. Эти данные могли быть сохранены при предыдущей активации клиента.This data could have been saved in a previous activation of the client. Может CFile содержать другие данные, но должен иметь свой указатель на чтение-запись, установленный CreateControlна первый байт стойких данных во время вызова.The CFile can contain other data, but must have its read-write pointer set to the first byte of persistent data at the time of the call to CreateControl.

bХранениеbStorage
Указывает, следует ли интерпретировать данные в pPersist как данные IStorage или IStream.Indicates whether the data in pPersist should be interpreted as IStorage or IStream data. Если данные в pPersist является хранилищем, bStorage должно быть правдой.If the data in pPersist is a storage, bStorage should be TRUE. Если данные в pPersist является потоком, bStorage должен быть FALSE.If the data in pPersist is a stream, bStorage should be FALSE. Значение по умолчанию — FALSE.The default value is FALSE.

bstrLicKeybstrLicKey
Дополнительные данные ключей лицензии.Optional license key data. Эти данные необходимы только для создания элементов управления, требующих ключа лицензии времени выполнения.This data is needed only for creating controls that require a run-time license key. Если элемент управления поддерживает лицензирование, необходимо предоставить ключ лицензии для создания элемента управления для достижения успеха.If the control supports licensing, you must provide a license key for the creation of the control to succeed. Значение по умолчанию — NULL.The default value is NULL.

clsidclsid
Уникальный идентификатор класса управления.The unique class ID of the control.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

RemarksRemarks

CreateControlявляется прямым аналогом CWnd::Создание функции, которая CWndсоздает окно для .CreateControl is a direct analog of the CWnd::Create function, which creates the window for a CWnd. CreateControlсоздает элемент управления ActiveX вместо обычного окна.CreateControl creates an ActiveX control instead of an ordinary window.

Поддерживается только подмножество флагов Windows dwStyle для: CreateControlOnly a subset of the Windows dwStyle flags are supported for CreateControl:

  • WS_VISIBLE создает окно, которое изначально видно.WS_VISIBLE Creates a window that is initially visible. Требуется, если вы хотите, чтобы элемент управления был виден немедленно, как обычные окна.Required if you want the control to be visible immediately, like ordinary windows.

  • WS_DISABLED создает окно, которое изначально отключено.WS_DISABLED Creates a window that is initially disabled. Отключенное окно не может получать ввод от пользователя.A disabled window cannot receive input from the user. Может быть установлен, если элемент управления имеет свойство enabled.Can be set if the control has an Enabled property.

  • WS_BORDER создает окно с тонкой линией границы.WS_BORDER Creates a window with a thin-line border. Может быть установлен, если контроль имеет свойство BorderStyle.Can be set if control has a BorderStyle property.

  • WS_GROUP определяет первый элемент управления группой элементов управления.WS_GROUP Specifies the first control of a group of controls. Пользователь может изменить фокус клавиатуры с одного элемента управления в группе на другой, используя клавиши направления.The user can change the keyboard focus from one control in the group to the next by using the direction keys. Все элементы управления, определяемые со стилем WS_GROUP после первого элемента управления принадлежат одной и той же группе.All controls defined with the WS_GROUP style after the first control belong to the same group. Следующий элемент управления со стилем WS_GROUP завершает группу и запускает следующую группу.The next control with the WS_GROUP style ends the group and starts the next group.

  • WS_TABSTOP определяет элемент управления, который может получать фокус клавиатуры, когда пользователь нажимает на ключ TAB.WS_TABSTOP Specifies a control that can receive the keyboard focus when the user presses the TAB key. Нажатие клавиши TAB изменяет фокус клавиатуры на следующий элемент управления стилем WS_TABSTOP.Pressing the TAB key changes the keyboard focus to the next control of the WS_TABSTOP style.

ПримерExample

class CGenocx : public CWnd
{
protected:
   DECLARE_DYNCREATE(CGenocx)
public:
   CLSID const &GetClsid()
   {
      static CLSID const clsid = {0x20DD1B9E, 0x87C4, 0x11D1, {0x8B, 0xE3, 0x0, 0x0, 0xF8, 0x75, 0x4D, 0xA1}};
      return clsid;
   }

   // This code is generated by the Control Wizard.
   // It wraps the call to CreateControl in the call to Create.
   virtual BOOL Create(LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle,
                       const RECT &rect, CWnd *pParentWnd, UINT nID,
                       CCreateContext *pContext = NULL)
   {
      UNREFERENCED_PARAMETER(pContext);
      UNREFERENCED_PARAMETER(lpszClassName);

      return CreateControl(GetClsid(), lpszWindowName, dwStyle, rect, pParentWnd, nID);
   }

   // remainder of class declaration omitted...

CWnd::CreateExCWnd::CreateEx

Создает указанное окно и прикрепляет его к объекту. CWndCreates the specified window and attaches it to the CWnd object.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    int x,
    int y,
    int nWidth,
    int nHeight,
    HWND hWndParent,
    HMENU nIDorHMenu,
    LPVOID lpParam = NULL);

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    LPVOID lpParam = NULL);

ПараметрыParameters

dwExStyledwExStyle
Bitwise комбинация (OR) расширенных стилей окна; в противном случае NULL для расширенного окна по умолчанию.Bitwise combination (OR) of extended window styles; otherwise NULL for the default extended window style.

lpszClassNamelpszClassName
Указатель на строку с нулевым завершением, содержащую имя зарегистрированного класса оконного окна системы; или название заданного класса оконного окна системы.Pointer to a null-terminated string that contains the name of a registered system window class; or the name of a predefined system window class.

lpszWindowNamelpszWindowName
Указатель на строку с нулевым завершением, содержащую имя отображения окна; в противном случае NULL без имени отображения окна.Pointer to a null-terminated string that contains the window display name; otherwise NULL for no window display name.

dwStyledwStyle
Bitwise комбинация (OR) стилей окна; в противном случае NULL для стиля окна по умолчанию.Bitwise combination (OR) of window styles; otherwise NULL for the default window style.

xx
Начальное горизонтальное расстояние окна от левой стороны экрана или родительского окна.The initial horizontal distance of the window from the left side of the screen or the parent window.

Yy
Начальное вертикальное расстояние окна от верхней части экрана или родительского окна.The initial vertical distance of the window from the top of the screen or the parent window.

nWidthnWidth
Ширина, в пикселях, окна.The width, in pixels, of the window.

nВысотаnHeight
Высота, в пикселях, окна.The height, in pixels, of the window.

hwndParenthwndParent
Для окна ребенка ручка к родительскому окну; в противном случае, ручка окна владельца, если окно имеет владельца.For a child window, the handle to the parent window; otherwise, the handle of the owner window if the window has an owner.

nIDorHMenunIDorHMenu
Для окна ребенка идентификатор окна; в противном случае идентификатор меню для окна.For a child window, the window ID; otherwise, the ID of a menu for the window.

lpParamlpParam
Указатель на пользовательские данные, которые передаются в CWnd::OnCreate метод в поле lpCreateParams.Pointer to user data that is passed to the CWnd::OnCreate method in the lpCreateParams field.

rectrect
Размер и расположение окна относительно экрана или родительского окна.The size and location of the window relative to the screen or the parent window.

pParentWndpParentWnd
Для окна ребенка указатель на родительское окно; в противном случае, указатель на окно владельца, если окно имеет владельца.For a child window, pointer to the parent window; otherwise, pointer to the owner window if the window has an owner.

nIDnID
Для окна ребенка идентификатор окна; в противном случае идентификатор меню для окна.For a child window, the window ID; otherwise, the ID of a menu for the window.

Возвращаемое значениеReturn Value

ПРАВДА, если метод был успешным; в противном случае FALSE.TRUE if the method was successful; otherwise FALSE.

RemarksRemarks

Warning

CWnd::PreCreateWindowтеперь присваивает CREATESTRUCT члену hMenu своего параметра этому указателю, если меню NULL, а стиль содержит WS_CHILD.CWnd::PreCreateWindow now assigns the hMenu member of its CREATESTRUCT parameter to the this pointer if the menu is NULL and the style contains WS_CHILD. Для правильной функциональности убедитесь, что ваш элемент управления диалогом имеет идентификатор, который не является NULL.For proper functionality, ensure that your dialog control has an ID that is not NULL.

Это изменение фиксирует сбой в сценариях управляемого/родного интерпа.This change fixes a crash in managed/native interop scenarios. Заявление TRACE в CWnd::Create предупреждении разработчика о проблеме.A TRACE statement in CWnd::Create alerts the developer of the problem.

Стиль расширенного окна по умолчанию является WS_EX_LEFT.The default extended window style is WS_EX_LEFT. Стиль окна по умолчанию WS_OVERLAPPED.The default window style is WS_OVERLAPPED.

Используйте функцию AfxRegisterWndClass для регистрации классов окон.Use the AfxRegisterWndClass function to register window classes. Классы оконов с определенными пользователями доступны в модуле, где они зарегистрированы.User defined window classes are available in the module where they are registered.

Размеры для детских окон относительно верхнего левого угла клиентской области родительского окна.Dimensions for child windows are relative to the top-left corner of the client area of the parent window. Размеры окон верхнего уровня относительно верхнего левого угла экрана.Dimensions for top-level windows are relative to the top-left corner of the screen.

CWnd::OnCreate называется до CreateEx возвращения метода и до того, как окно становится видимым.The CWnd::OnCreate method is called before the CreateEx method returns, and before the window becomes visible.

ПримерExample

void CMyDlg::OnCreateExtendedControl() 
{
   // m_pWndStaticEx is a CWnd* member of CMyDlg
   m_pWndStaticEx = new CStatic;
   m_pWndStaticEx->CreateEx(WS_EX_CLIENTEDGE, // Make a client edge label.
      _T("STATIC"), _T("Hi"),
      WS_CHILD | WS_TABSTOP | WS_VISIBLE,
      5, 5, 30, 30, m_hWnd, (HMENU)2345);
}

CWnd::CreateGrayCaretCWnd::CreateGrayCaret

Создает серый прямоугольник для системы caret и утверждает, что право собственности на caret.Creates a gray rectangle for the system caret and claims ownership of the caret.

void CreateGrayCaret(
    int nWidth,
    int nHeight);

ПараметрыParameters

nWidthnWidth
Определяет ширину кареты (в логических единицах).Specifies the width of the caret (in logical units). Если этот параметр раподраён 0, ширина устанавливается на системно-определяемую ширину оконной границы.If this parameter is 0, the width is set to the system-defined window-border width.

nВысотаnHeight
Определяет высоту кареты (в логических единицах).Specifies the height of the caret (in logical units). Если этот параметр раподраён 0, высота устанавливается на системно-определяемую высоту оконно-пограничной.If this parameter is 0, the height is set to the system-defined window-border height.

RemarksRemarks

Форма кареты может быть линией или блоком.The caret shape can be a line or a block.

Параметры nWidth и nHeight определяют ширину и высоту caret (в логических единицах); точная ширина и высота (в пикселях) зависят от режима отображения.The parameters nWidth and nHeight specify the caret's width and height (in logical units); the exact width and height (in pixels) depend on the mapping mode.

Ширина или высота оконной границы системы может быть получена функцией GetSystemMetrics Windows с SM_CXBORDER и SM_CYBORDER индексами.The system's window-border width or height can be retrieved by the GetSystemMetrics Windows function with the SM_CXBORDER and SM_CYBORDER indexes. Использование ширины или высоты границы окна гарантирует, что карет будет виден на дисплее с высоким разрешением.Using the window-border width or height ensures that the caret will be visible on a high-resolution display.

Функция CreateGrayCaret члена автоматически разрушает предыдущую форму caret, если такая имеется, независимо от того, какое окно владеет каретой.The CreateGrayCaret member function automatically destroys the previous caret shape, if any, regardless of which window owns the caret. После создания, карет изначально скрыты.Once created, the caret is initially hidden. Чтобы показать карету, должна быть вызвана функция участника ShowCaret.To show the caret, the ShowCaret member function must be called.

Системный карет является общим ресурсом.The system caret is a shared resource. CWndдолжны создавать карету только тогда, когда он имеет входиную фокус ировку или активен.CWnd should create a caret only when it has the input focus or is active. Он должен уничтожить карету, прежде чем он теряет входинфокус или становится неактивным.It should destroy the caret before it loses the input focus or becomes inactive.

ПримерExample

// Create a 5x10 gray caret in the edit control.
void CMyDlg::OnCreateGrayCaret()
{
   m_MyEdit.CreateGrayCaret(5, 10);
   m_MyEdit.ShowCaret();
}

CWnd::CreateSolidCaretCWnd::CreateSolidCaret

Создает сплошной прямоугольник для системы caret и утверждает, что право собственности на caret.Creates a solid rectangle for the system caret and claims ownership of the caret.

void CreateSolidCaret(
    int nWidth,
    int nHeight);

ПараметрыParameters

nWidthnWidth
Определяет ширину кареты (в логических единицах).Specifies the width of the caret (in logical units). Если этот параметр раподраён 0, ширина устанавливается на системно-определяемую ширину оконной границы.If this parameter is 0, the width is set to the system-defined window-border width.

nВысотаnHeight
Определяет высоту кареты (в логических единицах).Specifies the height of the caret (in logical units). Если этот параметр раподраён 0, высота устанавливается на системно-определяемую высоту оконно-пограничной.If this parameter is 0, the height is set to the system-defined window-border height.

RemarksRemarks

Форма кареты может быть линией или блоком.The caret shape can be a line or block.

Параметры nWidth и nHeight определяют ширину и высоту caret (в логических единицах); точная ширина и высота (в пикселях) зависят от режима отображения.The parameters nWidth and nHeight specify the caret's width and height (in logical units); the exact width and height (in pixels) depend on the mapping mode.

Ширина или высота оконной границы системы может быть получена функцией GetSystemMetrics Windows с SM_CXBORDER и SM_CYBORDER индексами.The system's window-border width or height can be retrieved by the GetSystemMetrics Windows function with the SM_CXBORDER and SM_CYBORDER indexes. Использование ширины или высоты границы окна гарантирует, что карет будет виден на дисплее с высоким разрешением.Using the window-border width or height ensures that the caret will be visible on a high-resolution display.

Функция CreateSolidCaret члена автоматически разрушает предыдущую форму caret, если такая имеется, независимо от того, какое окно владеет каретой.The CreateSolidCaret member function automatically destroys the previous caret shape, if any, regardless of which window owns the caret. После создания, карет изначально скрыты.Once created, the caret is initially hidden. Чтобы показать карету, должна быть вызвана функция участника ShowCaret.To show the caret, the ShowCaret member function must be called.

Системный карет является общим ресурсом.The system caret is a shared resource. CWndдолжны создавать карету только тогда, когда он имеет входиную фокус ировку или активен.CWnd should create a caret only when it has the input focus or is active. Он должен уничтожить карету, прежде чем он теряет входинфокус или становится неактивным.It should destroy the caret before it loses the input focus or becomes inactive.

ПримерExample

// Create a 5x10 solid caret in the edit control.
void CMyDlg::OnCreateSolidCaret()
{
   m_MyEdit.CreateSolidCaret(5, 10);
   m_MyEdit.ShowCaret();
}

CWnd::CWndCWnd::CWnd

Формирует объект CWnd.Constructs a CWnd object.

CWnd();

RemarksRemarks

Окно Windows не создается и не прикрепляется до тех пор, пока не будет вызвана функция CreateEx или Create.The Windows window is not created and attached until the CreateEx or Create member function is called.

CWnd::DefaultCWnd::Default

Вызывает процедуру окна по умолчанию.Calls the default window procedure.

LRESULT Default();

Возвращаемое значениеReturn Value

Зависит от отправленного сообщения.Depends on the message sent.

RemarksRemarks

Процедура окна по умолчанию обеспечивает обработку по умолчанию для любого сообщения окна, которое приложение не обрабатывает.The default window procedure provides default processing for any window message that an application does not process. Эта функция члена гарантирует обработку каждого сообщения.This member function ensures that every message is processed.

ПримерExample

// This sample shows how to avoid any button handling in base class,
// if any, and call the default window procedure directly.
void CMyDlg::OnLButtonDown(UINT nFlags, CPoint point)
{
   UNREFERENCED_PARAMETER(nFlags);
   UNREFERENCED_PARAMETER(point);

   CWnd::Default();
}

CWnd::DefWindowProcCWnd::DefWindowProc

Вызывает процедуру окна по умолчанию, которая обеспечивает обработку по умолчанию для любого сообщения окна, которое приложение не обрабатывает.Calls the default window procedure, which provides default processing for any window message that an application does not process.

virtual LRESULT DefWindowProc(
    UINT message,
    WPARAM wParam,
    LPARAM lParam);

ПараметрыParameters

messagemessage
Определяет сообщение Windows, подаваемый для обработки.Specifies the Windows message to be processed.

wParamwParam
Определяет дополнительную информацию, зависящая от сообщений.Specifies additional message-dependent information.

lParamlParam
Определяет дополнительную информацию, зависящая от сообщений.Specifies additional message-dependent information.

Возвращаемое значениеReturn Value

Зависит от отправленного сообщения.Depends on the message sent.

RemarksRemarks

Эта функция члена гарантирует обработку каждого сообщения.This member function ensures that every message is processed. Он должен быть вызван с теми же параметрами, что и полученные процедурой окна.It should be called with the same parameters as those received by the window procedure.

CWnd::DeleteTempMapCWnd::DeleteTempMap

Вызывается автоматически обработчиком CWinApp времени простоя объекта.Called automatically by the idle time handler of the CWinApp object.

static void PASCAL DeleteTempMap();

RemarksRemarks

Удаляет все CWnd временные объекты, созданные функцией FromHandle участника.Deletes any temporary CWnd objects created by the FromHandle member function.

ПримерExample

// DeleteTempMap() is a static member and does not need 
// to be called within the scope of an instantiated CWnd object.
CWnd::DeleteTempMap();

CWnd::DestroyWindowCWnd::DestroyWindow

Уничтожает окно Windows, CWnd прикрепленное к объекту.Destroys the Windows window attached to the CWnd object.

virtual BOOL DestroyWindow();

Возвращаемое значениеReturn Value

Nonzero, если окно разрушено; в противном случае 0.Nonzero if the window is destroyed; otherwise 0.

RemarksRemarks

Функция DestroyWindow члена отправляет соответствующие сообщения в окно, чтобы отключить его и удалить фокус ввода.The DestroyWindow member function sends appropriate messages to the window to deactivate it and remove the input focus. Он также разрушает меню окна, сбрасывает очередь приложения, разрушает выдающиеся таймеры, удаляет право собственности На CWnd Clipboard и ломает цепочку Clipboard-viewer, если находится в верхней части цепочки просмотра.It also destroys the window's menu, flushes the application queue, destroys outstanding timers, removes Clipboard ownership, and breaks the Clipboard-viewer chain if CWnd is at the top of the viewer chain. Он отправляет WM_DESTROY и WM_NCDESTROY сообщения в окно.It sends WM_DESTROY and WM_NCDESTROY messages to the window. Он не разрушает CWnd объект.It does not destroy the CWnd object.

DestroyWindowявляется держателем места для выполнения очистки.DestroyWindow is a place holder for performing cleanup. Поскольку DestroyWindow это виртуальная функция, CWndона отображается в любом классе в классе View.Because DestroyWindow is a virtual function, it is shown in any CWnd-derived class in Class View. Но даже если вы переопределяете эту функцию в вашем CWnd-производном классе, DestroyWindow не обязательно называется.But even if you override this function in your CWnd-derived class, DestroyWindow is not necessarily called. Если DestroyWindow код MFC не называется, то вы должны прямо вызвать его в свой собственный код, если вы хотите, чтобы он был вызван.If DestroyWindow is not called in the MFC code, then you have to explicitly call it in your own code if you want it to be called.

Предположим, например, что DestroyWindow вы CViewпереопределили в классе производных.Assume, for example, you have overridden DestroyWindow in a CView-derived class. Поскольку исходный код DestroyWindow MFC не CFrameWndвызывается ни в DestroyWindow одном из своих классов, переопределяется, ваш переопределяется не будет вызываться, если вы не позвоните ему явно.Since MFC source code does not call DestroyWindow in any of its CFrameWnd-derived classes, your overridden DestroyWindow will not be called unless you call it explicitly.

Если окно является родительским, эти окна ребенка автоматически разрушаются при разрушении родительского окна.If the window is the parent of any windows, these child windows are automatically destroyed when the parent window is destroyed. Функция DestroyWindow члена разрушает сначала детские окна, а затем само окно.The DestroyWindow member function destroys child windows first and then the window itself.

Функция DestroyWindow члена также уничтожает безрежимные диалоговые ящики, созданные CDialog::Create.The DestroyWindow member function also destroys modeless dialog boxes created by CDialog::Create.

Если CWnd уничтоженное окно ребенка не имеет набора WS_EX_NOPARENTNOTIFY стилей, то WM_PARENTNOTIFY сообщение отправляется родителю.If the CWnd being destroyed is a child window and does not have the WS_EX_NOPARENTNOTIFY style set, then the WM_PARENTNOTIFY message is sent to the parent.

ПримерExample

// CModeless is a CDialog class representing a modeless dialog
// Destruction of the modeless dialog involves calling DestroyWindow in 
// OnOK() & OnCancel() handlers
void CModeless::OnOK() 
{ 
   if (!UpdateData(TRUE)) 
   {
      TRACE(_T("UpdateData failed during dialog termination\n"));
      // The UpdateData routine will set focus to correct item
      return;
   }
   DestroyWindow();
}

void CModeless::OnCancel()
{
   DestroyWindow();
}

CWnd::DetachCWnd::Detach

Отсоединяет дескриптор Windows от объекта CWnd и возвращает дескриптор.Detaches a Windows handle from a CWnd object and returns the handle.

HWND Detach();

Возвращаемое значениеReturn Value

HWND к объекту Windows.A HWND to the Windows object.

ПримерExample

Смотрите пример Для CWnd::Прикрепите.See the example for CWnd::Attach.

CWnd::DlgDirListCWnd::DlgDirList

Заполняет список файлами или каталогами.Fills a list box with a file or directory listing.

int DlgDirList(
    LPTSTR lpPathSpec,
    int nIDListBox,
    int nIDStaticPath,
    UINT nFileType);

ПараметрыParameters

lpPathSpeclpPathSpec
Указывает на нулевую строку, содержащую путь или имя файла.Points to a null-terminated string that contains the path or filename. DlgDirListизменяет эту строку, которая должна быть достаточно длинной, чтобы содержать изменения.DlgDirList modifies this string, which should be long enough to contain the modifications. Для получения дополнительной информации смотрите следующий раздел "Замечания".For more information, see the following "Remarks" section.

nIDListBoxnIDListBox
Определяет идентификатор ящика списка.Specifies the identifier of a list box. Если nIDListBox равен 0, предполагает, DlgDirList что нет поля списка существует и не пытается заполнить один.If nIDListBox is 0, DlgDirList assumes that no list box exists and does not attempt to fill one.

nIDStaticPathnIDStaticPath
Определяет идентификатор элемента управления статического текста, используемого для отображения текущего диска и каталога.Specifies the identifier of the static-text control used to display the current drive and directory. Если nIDStaticPath равен 0, предполагает, DlgDirList что такого управления текстом нет.If nIDStaticPath is 0, DlgDirList assumes that no such text control is present.

nFileTypenFileType
Определяет атрибуты отображаемых файлов.Specifies the attributes of the files to be displayed. Это может быть любое сочетание следующих значений:It can be any combination of the following values:

  • DDL_READWRITE файлы чтения записи данных без каких-либо дополнительных атрибутов.DDL_READWRITE Read-write data files with no additional attributes.

  • DDL_READONLY только файлы для чтения.DDL_READONLY Read-only files.

  • DDL_HIDDEN скрытые файлы.DDL_HIDDEN Hidden files.

  • DDL_SYSTEM системные файлы.DDL_SYSTEM System files.

  • DDL_DIRECTORY каталоги.DDL_DIRECTORY Directories.

  • DDL_ARCHIVE архивов.DDL_ARCHIVE Archives.

  • DDL_POSTMSGS LB_DIR флаг.DDL_POSTMSGS LB_DIR flag. При установке LB_DIR флага Windows помещает DlgDirList сообщения, генерируемые в очереди приложения; в противном случае они направляются непосредственно в процедуру диалог-бокс.If the LB_DIR flag is set, Windows places the messages generated by DlgDirList in the application's queue; otherwise, they are sent directly to the dialog-box procedure.

  • DDL_DRIVES диски.DDL_DRIVES Drives. При установке DDL_DRIVES флага DDL_EXCLUSIVE флаг устанавливается автоматически.If the DDL_DRIVES flag is set, the DDL_EXCLUSIVE flag is set automatically. Поэтому для создания списка каталогов, включающий диски и файлы, необходимо звонить DlgDirList дважды: один раз с набором флага DDL_DRIVES и один раз с флагами для остальной части списка.Therefore, to create a directory listing that includes drives and files, you must call DlgDirList twice: once with the DDL_DRIVES flag set and once with the flags for the rest of the list.

  • DDL_EXCLUSIVE Эксклюзивный бит.DDL_EXCLUSIVE Exclusive bit. Если набор эксклюзивного бита, перечислены только файлы указанного типа; в противном случае перечислены обычные файлы и файлы указанного типа.If the exclusive bit is set, only files of the specified type are listed; otherwise normal files and files of the specified type are listed.

Возвращаемое значениеReturn Value

Ненулевое значение, если функция выполнена успешно; в противном случае — 0.Nonzero if the function is successful; otherwise 0.

RemarksRemarks

DlgDirListотправляет LB_RESETCONTENT и LB_DIR сообщения в поле списка.DlgDirList sends LB_RESETCONTENT and LB_DIR messages to the list box. Он заполняет окно списка, указанное nIDListBox с именами всех файлов, которые соответствуют пути, указанному lpPathSpec.It fills the list box specified by nIDListBox with the names of all files that match the path given by lpPathSpec.

Параметр lpPathSpec имеет следующую форму:The lpPathSpec parameter has the following form:

[drive:] [ [\u]directory[\idirectory]...\u] [filename]

В этом примере диск — это дисковая буква, каталог — действительное имя каталога, а имя файла — действительное имя файла, которое должно содержать по крайней мере одну подстановку.In this example, drive is a drive letter, directory is a valid directory name, and filename is a valid filename that must contain at least one wildcard. Подстановочные знаки являются вопросительным знаком (?), что*означает матч любого персонажа, и звездочка (), то есть соответствовать любому количеству символов.The wildcards are a question mark (?), which means match any character, and an asterisk (*), meaning match any number of characters.

Если вы указываете строку длиной 0 длины для lpPathSpec, или если вы указываете только имя*каталога, но не включаетв спецификацию файла, строка будет изменена на " . *".If you specify a 0-length string for lpPathSpec, or if you specify only a directory name but do not include any file specification, the string will be changed to "*.*".

Если lpPathSpec включает в себя диск и/или имя каталога, текущий диск и каталог изменяются на назначенный диск и каталог до заполнения окна списка.If lpPathSpec includes a drive and/or directory name, the current drive and directory are changed to the designated drive and directory before the list box is filled. Текстовый контроль, идентифицированный nIDStaticPath, также обновляется с новым именем диска и/или каталога.The text control identified by nIDStaticPath is also updated with the new drive and/or directory name.

После заполнения окна списка lpPathSpec обновляется путем удаления диска и/или каталога части пути.After the list box is filled, lpPathSpec is updated by removing the drive and/or directory portion of the path.

ПримерExample

// If pDialog points to a CDialog object with a list box
// with the identifier IDC_DIRLIST, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.
TCHAR path[MAX_PATH];
_tcscpy_s(path, MAX_PATH, _T("C:\\"));

pDialog->DlgDirList(path, IDC_DIRLIST, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);

CWnd::DlgDirListComboBoxCWnd::DlgDirListComboBox

Заполняет список элемента управления "Поле со списком" перечнем файлов или каталогов.Fills the list box of a combo box with a file or directory listing.

int DlgDirListComboBox(
    LPTSTR lpPathSpec,
    int nIDComboBox,
    int nIDStaticPath,
    UINT nFileType);

ПараметрыParameters

lpPathSpeclpPathSpec
Указывает на нулевую строку, содержащую путь или имя файла.Points to a null-terminated string that contains the path or filename. DlgDirListComboBoxизменяет эту строку, так что эти данные не должны быть в виде строки буквально.DlgDirListComboBox modifies this string, so this data should not be in the form of a string literal. Смотрите следующий раздел "Замечания".See the following "Remarks" section.

nIDComboBoxnIDComboBox
Определяет идентификатор комбо-коробки в диалоговом окне.Specifies the identifier of a combo box in a dialog box. Если nIDComboBox 0, предполагает, DlgDirListComboBox что не существует комбо-бокса и не пытается заполнить один.If nIDComboBox is 0, DlgDirListComboBox assumes that no combo box exists and does not attempt to fill one.

nIDStaticPathnIDStaticPath
Определяет идентификатор элемента управления статического текста, используемого для отображения текущего диска и каталога.Specifies the identifier of the static-text control used to display the current drive and directory. Если nIDStaticPath равен 0, предполагает, DlgDirListComboBox что такого управления текстом нет.If nIDStaticPath is 0, DlgDirListComboBox assumes that no such text control is present.

nFileTypenFileType
Определяет атрибуты файлов DOS для отображения файлов.Specifies DOS file attributes of the files to be displayed. Это может быть любое сочетание следующих значений:It can be any combination of the following values:

  • DDL_READWRITE файлы чтения записи данных без каких-либо дополнительных атрибутов.DDL_READWRITE Read-write data files with no additional attributes.

  • DDL_READONLY только файлы для чтения.DDL_READONLY Read-only files.

  • DDL_HIDDEN скрытые файлы.DDL_HIDDEN Hidden files.

  • DDL_SYSTEM системные файлы.DDL_SYSTEM System files.

  • DDL_DIRECTORY каталоги.DDL_DIRECTORY Directories.

  • DDL_ARCHIVE архивов.DDL_ARCHIVE Archives.

  • DDL_POSTMSGS CB_DIR флаг.DDL_POSTMSGS CB_DIR flag. При установке CB_DIR флага Windows помещает DlgDirListComboBox сообщения, генерируемые в очереди приложения; в противном случае они направляются непосредственно в процедуру диалог-бокс.If the CB_DIR flag is set, Windows places the messages generated by DlgDirListComboBox in the application's queue; otherwise, they are sent directly to the dialog-box procedure.

  • DDL_DRIVES диски.DDL_DRIVES Drives. При установке DDL_DRIVES флага DDL_EXCLUSIVE флаг устанавливается автоматически.If the DDL_DRIVES flag is set, the DDL_EXCLUSIVE flag is set automatically. Поэтому для создания списка каталогов, включающий диски и файлы, необходимо звонить DlgDirListComboBox дважды: один раз с набором флага DDL_DRIVES и один раз с флагами для остальной части списка.Therefore, to create a directory listing that includes drives and files, you must call DlgDirListComboBox twice: once with the DDL_DRIVES flag set and once with the flags for the rest of the list.

  • DDL_EXCLUSIVE Эксклюзивный бит.DDL_EXCLUSIVE Exclusive bit. Если набор эксклюзивного бита, перечислены только файлы указанного типа; в противном случае перечислены обычные файлы и файлы указанного типа.If the exclusive bit is set, only files of the specified type are listed; otherwise normal files and files of the specified type are listed.

Возвращаемое значениеReturn Value

Определяет результат функции.Specifies the outcome of the function. Это ненулевой, если объявление было сделано, даже пустой листинг.It is nonzero if a listing was made, even an empty listing. Значение возврата 0 подразумевает, что строка ввода не содержала допустимого пути поиска.A 0 return value implies that the input string did not contain a valid search path.

RemarksRemarks

DlgDirListComboBoxотправляет CB_RESETCONTENT и CB_DIR сообщения в комбо-коробку.DlgDirListComboBox sends CB_RESETCONTENT and CB_DIR messages to the combo box. Он заполняет окно списка комбо-бокс, указанный nIDComboBox с именами всех файлов, которые соответствуют пути, данного lpPathSpec.It fills the list box of the combo box specified by nIDComboBox with the names of all files that match the path given by lpPathSpec.

Параметр lpPathSpec имеет следующую форму:The lpPathSpec parameter has the following form:

[drive:] [ [\u]directory[\idirectory]...\u] [filename]

В этом примере диск — это дисковая буква, каталог — действительное имя каталога, а имя файла — действительное имя файла, которое должно содержать по крайней мере одну подстановку.In this example, drive is a drive letter, directory is a valid directory name, and filename is a valid filename that must contain at least one wildcard. Подстановочные знаки являются вопросительным знаком (?), что*означает матч любого персонажа, и звездочка ( ), что означает, соответствовать любому количеству символов.The wildcards are a question mark (?), which means match any character, and an asterisk (*), which means match any number of characters.

Если вы укажете строку нулевой длины для lpPathSpec, текущий каталог будет использоваться и lpPathSpec не будет изменен.If you specify a zero-length string for lpPathSpec, the current directory will be used and lpPathSpec will not be modified. Если вы укажете только имя каталога, но не содержите*спецификацию файла, строка будет изменена на ".If you specify only a directory name but do not include any file specification, the string will be changed to "*".

Если lpPathSpec включает в себя диск и/или имя каталога, текущий диск и каталог изменяются на назначенный диск и каталог до заполнения окна списка.If lpPathSpec includes a drive and/or directory name, the current drive and directory are changed to the designated drive and directory before the list box is filled. Текстовый контроль, идентифицированный nIDStaticPath, также обновляется с новым именем диска и/или каталога.The text control identified by nIDStaticPath is also updated with the new drive and/or directory name.

После заполнения окна списка комбо-боксов lpPathSpec обновляется путем удаления диска и/или каталога.After the combo-box list box is filled, lpPathSpec is updated by removing the drive and/or directory portion of the path.

ПримерExample

// If pDialog points to a CDialog object with a combo box
// with the identifier IDC_DIRCOMBO, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.

TCHAR szPath[MAX_PATH];
_tcsncpy_s(szPath, MAX_PATH, _T("C:\\"), MAX_PATH);
pDialog->DlgDirListComboBox(szPath, IDC_DIRCOMBO, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);

// Note that the first argument is a string and not a string
// literal. This is necessary because DlgDirListComboBox
// modifies the supplied string. Passing a string literal
// will result in an access violation.

CWnd::DlgDirSelectCWnd::DlgDirSelect

Извлекает текущее выделение из списка.Retrieves the current selection from a list box.

BOOL DlgDirSelect(
    LPTSTR lpString,
    int nIDListBox);

ПараметрыParameters

lpStringlpString
Указывает на буфер, который должен получить текущий выбор в поле списка.Points to a buffer that is to receive the current selection in the list box.

nIDListBoxnIDListBox
Упоняет идентификатор идентификатор списка в поле диалога.Specifies the integer ID of a list box in the dialog box.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

RemarksRemarks

Он предполагает, что поле списка было заполнено функцией участника DlgDirList и что выбор представляет собой дисковое письмо, файл или имя каталога.It assumes that the list box has been filled by the DlgDirList member function and that the selection is a drive letter, a file, or a directory name.

Функция DlgDirSelect участника копирует выделение в буфер, данный lpString.The DlgDirSelect member function copies the selection to the buffer given by lpString. Если нет выбора, lpString не изменяется.If there is no selection, lpString does not change.

DlgDirSelectотправляет LB_GETCURSEL и LB_GETTEXT сообщения в поле списка.DlgDirSelect sends LB_GETCURSEL and LB_GETTEXT messages to the list box.

Он не позволяет возвращать из окна списка более одного имени файла.It does not allow more than one filename to be returned from a list box. Коробка списка не должна быть полем списка с несколькими вариантами.The list box must not be a multiple-selection list box.

CWnd::DlgDirSelectComboBoxCWnd::DlgDirSelectComboBox

Извлекает текущее выделение списка элемента управления "Поле со списком".Retrieves the current selection from the list box of a combo box.

BOOL DlgDirSelectComboBox(
    LPTSTR lpString,
    int nIDComboBox);

ПараметрыParameters

lpStringlpString
Указывает на буфер, который должен получить выбранный путь.Points to a buffer that is to receive the selected path.

nIDComboBoxnIDComboBox
Определяет идентификатор комбо-коробки в диалоговом ящике.Specifies the integer ID of the combo box in the dialog box.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

RemarksRemarks

Он предполагает, что поле списка было заполнено функцией участника DlgDirListComboBox и что выбор представляет собой дисковую букву, файл или имя каталога.It assumes that the list box has been filled by the DlgDirListComboBox member function and that the selection is a drive letter, a file, or a directory name.

Функция DlgDirSelectComboBox участника копирует выделение в указанный буфер.The DlgDirSelectComboBox member function copies the selection to the specified buffer. Если нет выбора, содержимое буфера не изменяется.If there is no selection, the contents of the buffer are not changed.

DlgDirSelectComboBoxотправляет CB_GETCURSEL и CB_GETLBTEXT сообщения в комбо-коробку.DlgDirSelectComboBox sends CB_GETCURSEL and CB_GETLBTEXT messages to the combo box.

Он не позволяет более чем одному имени файла быть возвращены из комбо-бокса.It does not allow more than one filename to be returned from a combo box.

CWnd::DoDataExchangeCWnd::DoDataExchange

Вызывается в рамках для обмена и проверки данных диалогов.Called by the framework to exchange and validate dialog data.

virtual void DoDataExchange(CDataExchange* pDX);

ПараметрыParameters

PdxpDX
Указатель на объект CDataExchange.A pointer to a CDataExchange object.

RemarksRemarks

Никогда не звоните в эту функцию напрямую.Never call this function directly. Он вызывается функцией участника UpdateData.It is called by the UpdateData member function. Вызов UpdateData для инициализации элементов управления диалоговой будкой или получения данных из диалогового окна.Call UpdateData to initialize a dialog box's controls or retrieve data from a dialog box.

При извлечении из CDialogкласса диалога для конкретного приложения необходимо переопределить эту функцию участника, если вы хотите использовать автоматический обмен и проверку данных.When you derive an application-specific dialog class from CDialog, you need to override this member function if you wish to utilize the framework's automatic data exchange and validation. Мастер Add Variable напишет переопределенную версию этой функции для вас, содержащую желаемую «карту данных» обмена данными диалогов (DDX) и проверки (DDV) глобальных вызовов функции.The Add Variable wizard will write an overridden version of this member function for you containing the desired "data map" of dialog data exchange (DDX) and validation (DDV) global function calls.

Чтобы автоматически генерировать переопределенную версию этой функции участника, сначала создайте диалоговый ресурс с редактором диалогов, а затем создайте класс диалога для конкретного приложения.To automatically generate an overridden version of this member function, first create a dialog resource with the dialog editor, then derive an application-specific dialog class. Затем используйте мастер-разноску Добавить переменную для ассоциирования переменных, данных и диапазонов проверки с различными элементами управления в новом диалоговом поле.Then use the Add Variable wizard to associate variables, data, and validation ranges with various controls in the new dialog box. Затем мастер записывает DoDataExchangeпереопределенную карту данных.The wizard then writes the overridden DoDataExchange, which contains a data map. Ниже приводится пример блока кода DDX/DDV, генерируемого мастером Add Variable:The following is an example DDX/DDV code block generated by the Add Variable wizard:

void CPenWidthsDlg::DoDataExchange(CDataExchange *pDX)
{
   CDialog::DoDataExchange(pDX);
   DDX_Text(pDX, IDC_THINPENWIDTH, m_nThinWidth);
   DDV_MinMaxInt(pDX, m_nThinWidth, 1, 20);
   DDX_Text(pDX, IDC_THICKPENWIDTH, m_nThickWidth);
   DDV_MinMaxInt(pDX, m_nThickWidth, 1, 20);
}

Переовереренная DoDataExchange функция члена должна предшествовать макро-заявлениям в исходном файле.The DoDataExchange overridden member function must precede the macro statements in your source file.

Для получения дополнительной информации об обмене и проверке данных диалогов Dialog Data Exchange and Validationсм. Displaying and Manipulating Data in a FormFor more information on dialog data exchange and validation, see Displaying and Manipulating Data in a Form and Dialog Data Exchange and Validation. Для описания DDX_ и DDV_ макросов, генерируемых мастером Добавить переменную, см.For a description of the DDX_ and DDV_ macros generated by the Add Variable wizard, see Technical Note 26.

CWnd::DragAcceptFilesCWnd::DragAcceptFiles

Вызов ими функции участника из CWnd окна, используя указатель, в cWinApp вашего приложения::InitInstance функции, чтобы указать, что окно принимает выпавные файлы из Windows File Manager или File Explorer.Call this member function from within a window, using a CWnd pointer, in your application's CWinApp::InitInstance function to indicate that the window accepts dropped files from the Windows File Manager or File Explorer.

void DragAcceptFiles(BOOL bAccept = TRUE);

ПараметрыParameters

BAcceptBAccept
Пометить, принимается ли перетащенные файлы.Flag that indicates whether dragged files are accepted.

RemarksRemarks

Только окно, DragAcceptFiles которое вызывает с bAccept параметр, установленный для TRUE идентифицировал себя как способный обрабатывать сообщение Windows WM_DROPFILES.Only the window that calls DragAcceptFiles with the bAccept parameter set to TRUE has identified itself as able to process the Windows message WM_DROPFILES. Например, в приложении MDI, если указатель CMDIFrameWnd DragAcceptFiles окна используется в CMDIFrameWnd вызове функции, только окно получает WM_DROPFILES сообщение.For example, in an MDI application, if the CMDIFrameWnd window pointer is used in the DragAcceptFiles function call, only the CMDIFrameWnd window gets the WM_DROPFILES message. Это сообщение не отправляется CMDIChildWnd во все открытые окна.This message is not sent to all open CMDIChildWnd windows. Для CMDIChildWnd получения этого сообщения окном DragAcceptFiles необходимо CMDIChildWnd позвонить с помощью указателя окна.For a CMDIChildWnd window to receive this message, you must call DragAcceptFiles with the CMDIChildWnd window pointer.

Чтобы прекратить прием перетащенных файлов, позвоните функции участника с набором bAccept в FALSE.To discontinue receiving dragged files, call the member function with bAccept set to FALSE.

CWnd::DragDetectCWnd::DragDetect

Захватывает мышь и отслеживает ее движение, пока пользователь не отпустит левую кнопку мыши, не нажмет клавишу ESC или не переместит мышь за пределы прямоугольника перетаскивания, в котором находится указанная точка.Captures the mouse and tracks its movement until the user releases the left button, presses the ESC key, or moves the mouse outside the drag rectangle around the specified point.

BOOL DragDetect(POINT pt) const;

ПараметрыParameters

птpt
Начальное положение мыши, в координатах экрана.Initial position of the mouse, in screen coordinates. Функция определяет координаты перетаскивания прямоугольника с помощью этой точки.The function determines the coordinates of the drag rectangle by using this point.

Возвращаемое значениеReturn Value

Если пользователь переместил мышь за пределы прямоугольника, удерживая левую кнопку, значение возврата ненулевое.If the user moved the mouse outside of the drag rectangle while holding down the left button , the return value is nonzero.

Если пользователь не перемещал мышь за пределы прямоугольника, удерживая левую кнопку, значение возврата равно нулю.If the user did not move the mouse outside of the drag rectangle while holding down the left button , the return value is zero.

RemarksRemarks

Эта функция члена эмулирует функциональность функции DragDetect, как описано в Windows SDK.This member function emulates the functionality of the function DragDetect, as described in the Windows SDK.

CWnd::DrawAnimatedRectsCWnd::DrawAnimatedRects

Рисует каркасный прямоугольник и анимирует его для обозначения открытия значка, а также сворачивания или разворачивания окна.Draws a wire-frame rectangle and animates it to indicate the opening of an icon or the minimizing or maximizing of a window.

BOOL DrawAnimatedRects(
    int idAni,
    CONST RECT* lprcFrom,
    CONST RECT* lprcTo);

ПараметрыParameters

idAniidAni
Определяет тип анимации.Specifies the type of animation. Если указать IDANI_CAPTION, подпись окна будет оживиться с позиции, указанной lprc, к позиции, указанной lprcTo.If you specify IDANI_CAPTION, the window caption will animate from the position specified by lprcFrom to the position specified by lprcTo. Эффект аналогичен минимизации или максимизации окна.The effect is similar to minimizing or maximizing a window.

lprcFromlprcFrom
Указатель на структуру RECT с указанием местоположения и размера значка или сведенного к минимуму окна.Pointer to a RECT structure specifying the location and size of the icon or minimized window.

lprcTolprcTo
Указатель на структуру RECT с указанием местоположения и размера восстановленного окнаPointer to a RECT structure specifying the location and size of the restored window

Возвращаемое значениеReturn Value

Nonzero, если функция успешно; в противном случае 0.Nonzero if the function succeeds; otherwise 0.

RemarksRemarks

Эта функция члена эмулирует функциональность функции DrawAnimatedRects,как описано в Windows SDK.This member function emulates the functionality of the function DrawAnimatedRects, as described in the Windows SDK.

CWnd::DrawCaptionCWnd::DrawCaption

Рисует заголовок окна.Draws a window caption.

BOOL DrawCaption(
    CDC* pDC,
    LPCRECT lprc,
    UINT uFlags);

ПараметрыParameters

pDCpDC
Указатель на контекст устройства.A pointer to a device context. Функция втягивает заголовок окна в контекст этого устройства.The function draws the window caption into this device context.

lprclprc
Указатель на структуру RECT, которая определяет прямоугольник для заголовка окна.A pointer to a RECT structure that specifies the bounding rectangle for the window caption.

uФлагиuFlags
Определяет параметры рисования.Specifies drawing options. Полный список значений можно узнать на примере DrawCaption.For a complete list of values, see DrawCaption.

Возвращаемое значениеReturn Value

Nonzero, если функция успешно; в противном случае 0.Nonzero if the function succeeds; otherwise 0.

RemarksRemarks

Эта функция члена эмулирует функциональность функции DrawCaption, как описано в Windows SDK.This member function emulates the functionality of the function DrawCaption, as described in the Windows SDK.

CWnd::DrawMenuBarCWnd::DrawMenuBar

Перерисовывает строку меню.Redraws the menu bar.

void DrawMenuBar();

RemarksRemarks

Если бар меню изменен после создания окна Windows, позвоните в эту функцию, чтобы нарисовать измененную панель меню.If a menu bar is changed after Windows has created the window, call this function to draw the changed menu bar.

ПримерExample

Смотрите пример для CWnd::GetMenu.See the example for CWnd::GetMenu.

CWnd::EnableActiveAccessibilityCWnd::EnableActiveAccessibility

Обеспечивает функции активной доступности, определяемые пользователями.Enables user-defined Active Accessibility functions.

void EnableActiveAccessibility();

RemarksRemarks

Поддержка активной доступности MFC по умолчанию достаточна для стандартных окон и элементов управления, включая элементы управления ActiveX; однако, CWndесли ваш класс, полученный из-под окон, содержит элементы пользовательского интерфейса, MFC не имеет возможности узнать о них.MFC's default Active Accessibility support is sufficient for standard windows and controls, including ActiveX controls; however, if your CWnd-derived class contains nonwindowed user interface elements, MFC has no way of knowing about them. В этом случае необходимо переопределить соответствующие функции участника Active Accessibility в вашем классе, и вы должны вызвать EnableActiveAccessibility в конструкторе класса.In that case, you must override the appropriate Active Accessibility member functions in your class, and you must call EnableActiveAccessibility in the class's constructor.

CWnd::EnableDynamicLayoutCWnd::EnableDynamicLayout

Включает или отключает диспетчер динамического макета.Enables or disables the dynamic layout manager. Если динамический макет активен, положение и размеры дочерних окон можно динамически настраивать, изменяя размер родительского окна.When dynamic layout is enabled, the position and size of child windows can adjust dynamically when the user resizes the window.

void EnableDynamicLayout(BOOL bEnable = TRUE);

ПараметрыParameters

bEnablebEnable
Значение TRUE — динамический макет включен, FALSE — отключен.TRUE to enable dynamic layout; FALSE to disable dynamic layout.

RemarksRemarks

Чтобы включить динамический макет, наряду с вызовом этого метода необходимо выполнить дополнительные действия.If you want to enable dynamic layout, you have to do more than just call this method. Необходимо также предоставить сведения о динамическом макете, информирующие о поведении элементов управления в окне в ответ на изменения размеров.You also have to provide dynamic layout information which species how the controls in the window respond to size changes. Эту информацию можно указать для каждого элемента управления в редакторе ресурсов или программным образом.You can specify this information in the resource editor, or programmatically, for each control. Смотрите динамический макет.See Dynamic Layout.

CWnd::EnableD2DSupportCWnd::EnableD2DSupport

Включает или отключает поддержку окнами D2D.Enables or disables window D2D support. Данный метод следует вызывать до инициализации основного окна.Call this method before the main window is initialized.

void EnableD2DSupport(
    BOOL bEnable = TRUE,
    BOOL bUseDCRenderTarget = FALSE);

ПараметрыParameters

bEnablebEnable
Указывает, следует включить или отключить поддержку D2D.Specifies whether to turn on, or off D2D support.

bUseDCRenderTargetbUseDCRenderTarget
Указывает, следует ли использовать целевой объект отрисовки из контекста устройства, т. е. класс CDCRenderTarget.Species whether to use the Device Context (DC) render target, CDCRenderTarget. Если значение — FALSE, используется класс CHwndRenderTarget.If FALSE, CHwndRenderTarget is used.

CWnd::EnableScrollBarCWnd::EnableScrollBar

Включает или выключает одну или обе стрелки полосы прокрутки.Enables or disables one or both arrows of a scroll bar.

BOOL EnableScrollBar(
    int nSBFlags,
    UINT nArrowFlags = ESB_ENABLE_BOTH);

ПараметрыParameters

nSBFlagsnSBFlags
Определяет тип прокрутки-бара.Specifies the scroll-bar type. Может иметь одно из следующих значений:Can have one of the following values:

  • SB_BOTH Включает или отстраняет стрелки горизонтальных и вертикальных полос прокрутки, связанных с окном.SB_BOTH Enables or disables the arrows of the horizontal and vertical scroll bars associated with the window.

  • SB_HORZ Включает или отсваивает стрелки горизонтальной панели прокрутки, связанные с окном.SB_HORZ Enables or disables the arrows of the horizontal scroll bar associated with the window.

  • SB_VERT включает или отсваивает стрелки вертикальной панели прокрутки, связанные с окном.SB_VERT Enables or disables the arrows of the vertical scroll bar associated with the window.

nArrowFlagsnArrowFlags
Определяет, включены или отключены стрелки прокрутки-бара и какие стрелки включены или отключены.Specifies whether the scroll-bar arrows are enabled or disabled and which arrows are enabled or disabled. Может иметь одно из следующих значений:Can have one of the following values:

  • ESB_ENABLE_BOTH Включает обе стрелки панели прокрутки (по умолчанию).ESB_ENABLE_BOTH Enables both arrows of a scroll bar (default).

  • ESB_DISABLE_LTUP отсрабатывает левую стрелку горизонтальной панели прокрутки или стрелку вверх вертикальной панели прокрутки.ESB_DISABLE_LTUP Disables the left arrow of a horizontal scroll bar or the up arrow of a vertical scroll bar.

  • ESB_DISABLE_RTDN отсрабатывает правую стрелку горизонтальной панели прокрутки или вниз стрелку вертикального прокрутки.ESB_DISABLE_RTDN Disables the right arrow of a horizontal scroll bar or the down arrow of a vertical scroll bar.

  • ESB_DISABLE_BOTH отсрабатывает обе стрелки панели прокрутки.ESB_DISABLE_BOTH Disables both arrows of a scroll bar.

Возвращаемое значениеReturn Value

Nonzero, если стрелки включены или отключены в указанном виде.Nonzero if the arrows are enabled or disabled as specified. В противном случае это 0, что указывает на то, что стрелки уже находятся в запрашиваемом состоянии или что произошла ошибка.Otherwise it is 0, which indicates that the arrows are already in the requested state or that an error occurred.

CWnd::EnableScrollBarCtrlCWnd::EnableScrollBarCtrl

Включает или отсвадает панель прокрутки для этого окна.Enables or disables the scroll bar for this window.

void EnableScrollBarCtrl(
    int nBar,
    BOOL bEnable = TRUE);

ПараметрыParameters

nБарnBar
Идентификатор прокрутки-бара.The scroll-bar identifier.

bEnablebEnable
Определяет, включена ли или отключена панель прокрутки.Specifies whether the scroll bar is to be enabled or disabled.

RemarksRemarks

Если в окне есть элемент управления прокруткой брата, используется панель прокрутки; в противном случае используется собственная панель прокрутки окна.If the window has a sibling scroll-bar control, that scroll bar is used; otherwise the window's own scroll bar is used.

CWnd::EnableToolTipsCWnd::EnableToolTips

Позволяет дать советы по инструментам для данного окна.Enables tool tips for the given window.

BOOL EnableToolTips(BOOL bEnable = TRUE);

ПараметрыParameters

bEnablebEnable
Определяет, включен или отключен контроль наконечника инструмента.Specifies whether the tool tip control is enabled or disabled. TRUE позволяет управлять; FALSE отскакивает от управления.TRUE enables the control; FALSE disables the control.

Возвращаемое значениеReturn Value

TRUE, если инструмент советы включены; в противном случае FALSE.TRUE if tool tips are enabled; otherwise FALSE.

RemarksRemarks

Переопределение OnToolHitTest для обеспечения структуртки TOOLINFO или структур для окна.Override OnToolHitTest to provide the TOOLINFO struct or structs for the window.

Note

Некоторые окна, такие как CToolBar, обеспечивают встроенную реализацию OnToolHitTest.Some windows, such as CToolBar, provide a built-in implementation of OnToolHitTest.

Более подробную информацию об этой структуре можно получить в SDK для Windows.See TOOLINFO in the Windows SDK for more information on this structure.

Простого EnableToolTips вызова недостаточно для отображения советов по инструменту CFrameWndдля управления ребенком, если только родительское окно не получено из.Simply calling EnableToolTips is not enough to display tool tips for your child controls unless the parent window is derived from CFrameWnd. Это связано с тем, что CFrameWnd обработчик по умолчанию предоставляет обработчик по умолчанию для уведомления TTN_NEEDTEXT.This is because CFrameWnd provides a default handler for the TTN_NEEDTEXT notification. Если родительское окно не CFrameWndполучено от , то есть, если это диалоговая коробка или представление формы, советы по инструменту для управления ребенком не отображаются правильно, если вы не предоставите обработчик для уведомления о TTN_NEEDTEXT наконечнике инструмента.If your parent window is not derived from CFrameWnd, that is, if it is a dialog box or a form view, tool tips for your child controls will not display correctly unless you provide a handler for the TTN_NEEDTEXT tool tip notification. Смотрите Советы по инструменту.See Tool Tips.

Советы по умолчанию инструмент, предусмотренные для окон EnableToolTips не имеют текст, связанный с ними.The default tool tips provided for your windows by EnableToolTips do not have text associated with them. Для получения текста для отображения наконечника инструмента уведомление TTN_NEEDTEXT отправляется в родительское окно элемента управления отзывом непосредственно перед отображением окна наконечника инструмента.To retrieve text for the tool tip to display, the TTN_NEEDTEXT notification is sent to the tool tip control's parent window just before the tool tip window is displayed. Если для этого сообщения нет обработчика, чтобы назначить TOOLTIPTEXT некоторое значение члену структуры pszText, не будет отображаться текст для наконечника инструмента.If there is no handler for this message to assign some value to the pszText member of the TOOLTIPTEXT structure, there will be no text displayed for the tool tip.

ПримерExample

// From message map for CMdiView, a CView-derived class
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTW, 0, 0xFFFF, &CMdiView::OnToolTipNotify)
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTA, 0, 0xFFFF, &CMdiView::OnToolTipNotify)
void CMdiView::OnInitialUpdate()
{
   CView::OnInitialUpdate();

   m_Edit.Create(ES_MULTILINE | WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER,
                 CRect(10, 10, 100, 100), this, IDC_TTEDIT);
   EnableToolTips(TRUE); // enable tool tips for view
}

//Notification handler
BOOL CMdiView::OnToolTipNotify(UINT id, NMHDR *pNMHDR, LRESULT *pResult)
{
   UNREFERENCED_PARAMETER(id);
   UNREFERENCED_PARAMETER(pResult);

   // need to handle both ANSI and UNICODE versions of the message
   TOOLTIPTEXTA *pTTTA = (TOOLTIPTEXTA*)pNMHDR;
   TOOLTIPTEXTW *pTTTW = (TOOLTIPTEXTW*)pNMHDR;
   CStringA strTipText;
   UINT_PTR nID = pNMHDR->idFrom;
   if (pNMHDR->code == TTN_NEEDTEXTA && (pTTTA->uFlags & TTF_IDISHWND) ||
       pNMHDR->code == TTN_NEEDTEXTW && (pTTTW->uFlags & TTF_IDISHWND))
   {
      // idFrom is actually the HWND of the tool
      nID = ::GetDlgCtrlID((HWND)nID);
   }

   if (nID != 0) // will be zero on a separator
      strTipText.Format("Control ID = %d", nID);

   if (pNMHDR->code == TTN_NEEDTEXTA)
   {
      strncpy_s(pTTTA->szText, sizeof(pTTTA->szText), strTipText,
                strTipText.GetLength() + 1);
   }
   else
   {
      ::MultiByteToWideChar(CP_ACP, 0, strTipText, strTipText.GetLength() + 1,
                            pTTTW->szText, sizeof(pTTTW->szText) / (sizeof pTTTW->szText[0]));
   }

   return TRUE; // message was handled
}

CWnd::EnableTrackingToolTipsCWnd::EnableTrackingToolTips

Включает или отражает наборы инструментов отслеживания.Enables or disables tracking tooltips.

BOOL EnableTrackingToolTips(BOOL bEnable = TRUE);

ПараметрыParameters

bEnablebEnable
Уточняется, включены или отключены советы по отслеживанию инструментов.Specifies whether tracking tool tips are enabled or disabled. Если этот параметр является правдой, советы инструмент отслеживания будут включены.If this parameter is TRUE, the tracking tool tips will be enabled. Если этот параметр FALSE, советы инструмент отслеживания будут отключены.If this parameter is FALSE, the tracking tool tips will be disabled.

Возвращаемое значениеReturn Value

Указывает состояние до EnableWindow вызова функции участника.Indicates the state before the EnableWindow member function was called. Значение возврата неявляется, если окно ранее было отключено.The return value is nonzero if the window was previously disabled. Значение возврата 0, если окно было включено ранее или произошла ошибка.The return value is 0 if the window was previously enabled or an error occurred.

RemarksRemarks

Советы инструмент отслеживания являются инструментом отзыв окна, которые можно динамически положение на экране.Tracking tool tips are tool tip windows that you can dynamically position on the screen. Быстро обновляя положение, окно наконечника инструмента, кажется, движется плавно, или "трек".By rapidly updating the position, the tool tip window appears to move smoothly, or "track." Эта функциональность может быть полезна, если вам нужен текст наконечника инструмента, чтобы следить за положением указателя по мере его движения.This functionality can be useful if you need tool tip text to follow the position of the pointer as it moves.

CWnd::EnableWindowCWnd::EnableWindow

Разрешает или запрещает ввод с помощью мыши и клавиатуры.Enables or disables mouse and keyboard input.

BOOL EnableWindow(BOOL bEnable = TRUE);

ПараметрыParameters

bEnablebEnable
Определяет, включено или отключено данное окно.Specifies whether the given window is to be enabled or disabled. Если этот параметр является правдой, окно будет включено.If this parameter is TRUE, the window will be enabled. Если этот параметр FALSE, окно будет отключено.If this parameter is FALSE, the window will be disabled.

Возвращаемое значениеReturn Value

Указывает состояние до EnableWindow вызова функции участника.Indicates the state before the EnableWindow member function was called. Значение возврата неявляется, если окно ранее было отключено.The return value is nonzero if the window was previously disabled. Значение возврата 0, если окно было включено ранее или произошла ошибка.The return value is 0 if the window was previously enabled or an error occurred.

RemarksRemarks

При отключении ввода ввод, например, клики мыши и нажатия клавиш, игнорируются.When input is disabled, input such as mouse clicks and keystrokes is ignored. Когда вход включен, окно обрабатывает все входные.When input is enabled, the window processes all input.

При изменении включенного состояния WM_ENABLE сообщение отправляется до возвращения этой функции.If the enabled state is changing, the WM_ENABLE message is sent before this function returns.

Если инвалиды, все детские окна неявно отключены, хотя они не отправляются WM_ENABLE сообщений.If disabled, all child windows are implicitly disabled, although they are not sent WM_ENABLE messages.

Перед его активацией необходимо включено окно.A window must be enabled before it can be activated. Например, если приложение отображает нештатную диалоговую коробку и отключило его основное окно, главное окно должно быть включено до того, как поле диалога будет уничтожено.For example, if an application is displaying a modeless dialog box and has disabled its main window, the main window must be enabled before the dialog box is destroyed. В противном случае другое окно получит фокус ввода и будет активировано.Otherwise, another window will get the input focus and be activated. Если окно ребенка отключено, оно игнорируется, когда Windows пытается определить, какое окно должно получать сообщения мыши.If a child window is disabled, it is ignored when Windows tries to determine which window should get mouse messages.

По умолчанию окно включено при его создании.By default, a window is enabled when it is created. Приложение может указать WS_DISABLED стиле в функции члена Create или CreateEx для создания окна, которое изначально отключено.An application can specify the WS_DISABLED style in the Create or CreateEx member function to create a window that is initially disabled. После создания окна приложение может также использовать EnableWindow функцию члена для включения или отсвагиваем окна.After a window has been created, an application can also use the EnableWindow member function to enable or disable the window.

Приложение может использовать эту функцию для включения или отключать элемент управления в диалоговом поле.An application can use this function to enable or disable a control in a dialog box. Отключенный элемент управления не может получить фокус ввода, равно как и пользователь не может получить к нему доступ.A disabled control cannot receive the input focus, nor can a user access it.

ПримерExample

//CMyFileDialog is a CFileDialog-derived class
//OnInitDialog is the handler for WM_INITDIALOG
BOOL CMyFileDialog::OnInitDialog()
{
   CFileDialog::OnInitDialog();

   CWnd *pWndParent = GetParent();

   //make sure you add #include <dlgs.h> for IDs 'edt1' & 'stc3'

   //disables the 'file name' edit and static control
   //of the standard file open dialog

   //get handle of 'file name' combobox control & disable it
   CWnd *pWnd = pWndParent->GetDlgItem(cmb13);
   pWnd->EnableWindow(FALSE);

   //get handle of 'file name' static control & disable it
   pWnd = pWndParent->GetDlgItem(stc3);
   pWnd->EnableWindow(FALSE);

   return TRUE;
}

CWnd::EndModalLoopCWnd::EndModalLoop

Прекращает вызов RunModalLoop.Terminates a call to RunModalLoop.

virtual void EndModalLoop(int nResult);

ПараметрыParameters

nResultnResult
Содержит значение, необходимое для возврата вызывающему абоненту RunModalLoop.Contains the value to be returned to the caller of RunModalLoop.

RemarksRemarks

Параметр nResult распространяется на значение возврата RunModalLoopот .The nResult parameter is propagated to the return value from RunModalLoop.

CWnd::EndModalStateCWnd::EndModalState

Данная функция-член вызывается для изменения состояния окна с модального на немодальное.Call this member function to change a frame window from modal to modeless.

virtual void EndModalState();

CWnd::EndPaintCWnd::EndPaint

Отмечает конец живописи в данном окне.Marks the end of painting in the given window.

void EndPaint(LPPAINTSTRUCT lpPaint);

ПараметрыParameters

lpPaintlpPaint
Указывает на структуру PAINTSTRUCT, содержащую информацию о покраске, полученную функцией участника BeginPaint.Points to a PAINTSTRUCT structure that contains the painting information retrieved by the BeginPaint member function.

RemarksRemarks

Функция EndPaint участника требуется для каждого BeginPaint вызова к функции участника, но только после завершения картины.The EndPaint member function is required for each call to the BeginPaint member function, but only after painting is complete.

Если карета была BeginPaint скрыта EndPaint функцией члена, восстанавливает карету на экран.If the caret was hidden by the BeginPaint member function, EndPaint restores the caret to the screen.

ПримерExample

Смотрите пример Для CWnd::BeginPaint.See the example for CWnd::BeginPaint.

CWnd::ExecuteDlgInitCWnd::ExecuteDlgInit

Инициирует ресурс диалогового окна.Initiates a dialog resource.

BOOL ExecuteDlgInit(LPCTSTR lpszResourceName);
BOOL ExecuteDlgInit(LPVOID lpResource);

ПараметрыParameters

lpszResourceNamelpszResourceName
Указатель на нулевую строку с указанием имени ресурса.A pointer to a null-terminated string specifying the name of the resource.

lpResourcelpResource
Указатель на ресурс.A pointer to a resource.

Возвращаемое значениеReturn Value

TRUE, если диалоговый ресурс выполнен; в противном случае FALSE.TRUE if a dialog resource is executed; otherwise FALSE.

RemarksRemarks

ExecuteDlgInitбудет использовать ресурсы, связанные с модулем выполнения, или ресурсы из других источников.ExecuteDlgInit will use resources bound to the executing module, or resources from other sources. Для достижения ExecuteDlgInit этой цели, находит AfxFindResourceHandleручку ресурса, вызывая .To accomplish this, ExecuteDlgInit finds a resource handle by calling AfxFindResourceHandle. Если ваше приложение MFC не использует общий DLL (MFCx0. DLL), AfxFindResourceHandle вызывает AfxGetResourceHandle, который возвращает текущую ручку ресурса для исполняемой.If your MFC application does not use the shared DLL (MFCx0[U][D].DLL), AfxFindResourceHandle calls AfxGetResourceHandle, which returns the current resource handle for the executable. Если ваше приложение MFC, использующее MFCx0. DLL, AfxFindResourceHandle пересекает CDynLinkLibrary список объектов общих и MFC расширение DLLs ищет правильную ручку ресурса.If your MFC application that uses MFCx0[U][D].DLL, AfxFindResourceHandle traverses the CDynLinkLibrary object list of shared and MFC extension DLLs looking for the correct resource handle.

CWnd::FilterToolTipMessageCWnd::FilterToolTipMessage

Вызывается фреймворком для отображения сообщений наконечника инструмента.Called by the framework to display tool tip messages.

void FilterToolTipMessage(MSG* pMsg);

ПараметрыParameters

pMsgpMsg
Указатель на сообщение наконечника инструмента.A pointer to the tool tip message.

RemarksRemarks

В большинстве приложений MFC этот метод называется фреймворком от PreTranslateMessage и EnableToolTips,и вам не нужно называть его самостоятельно.In most MFC applications this method is called by the framework from PreTranslateMessage and EnableToolTips, and you do not need to call it yourself.

Однако в некоторых приложениях, например в некоторых элементах управления ActiveX, эти методы могут не вызываться инфраструктурой, и вам нужно будет вызвать FilterToolTipMessage самостоятельно.However, in certain applications, for example some ActiveX controls, these methods might not be invoked by the framework, and you will need to call FilterToolTipMessage yourself. Для получения дополнительной информации, см.For more information, see Methods of Creating Tool Tips.

CWnd::FindWindowCWnd::FindWindow

Возвращает верхний CWnd уровень, класс окон которого дается lpszClassName и чье имя окна, или название, дается lpszWindowName.Returns the top-level CWnd whose window class is given by lpszClassName and whose window name, or title, is given by lpszWindowName.

static CWnd* PASCAL FindWindow(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName);

ПараметрыParameters

lpszClassNamelpszClassName
Указывает на строку с нулевым завершением, которая определяет WNDCLASS название класса окна (структура).Points to a null-terminated string that specifies the window's class name (a WNDCLASS structure). Если lpClassName является NULL, все имена классов совпадают.If lpClassName is NULL, all class names match.

lpszWindowNamelpszWindowName
Указывает на строку с нулевым завершением, которая определяет имя окна (название окна).Points to a null-terminated string that specifies the window name (the window's title). Если lpWindowName является NULL, все имена окон совпадают.If lpWindowName is NULL, all window names match.

Возвращаемое значениеReturn Value

Идентифицирует окно с указанным именем класса и именем окна.Identifies the window that has the specified class name and window name. Это NULL, если такое окно не найдено.It is NULL if no such window is found.

Кон CWndможет быть временным и не должен храниться для последующего использования.The CWnd* may be temporary and should not be stored for later use.

RemarksRemarks

Эта функция не выполняет поиск в детских окнах.This function does not search child windows.

ПримерExample

// activate an application with a window with a specific class name
BOOL CMyApp::FirstInstance()
{
   CWnd *pWndPrev, *pWndChild;

   // Determine if a window with the class name exists...
   pWndPrev = CWnd::FindWindow(_T("MyNewClass"), NULL);
   if (NULL != pWndPrev)
   {
      // If so, does it have any popups?
      pWndChild = pWndPrev->GetLastActivePopup();

      // If iconic, restore the main window
      if (pWndPrev->IsIconic())
         pWndPrev->ShowWindow(SW_RESTORE);

      // Bring the main window or its popup to the foreground
      pWndChild->SetForegroundWindow();

      // and you are done activating the other application
      return FALSE;
   }

   return TRUE;
}

CWnd::FindWindowExCWnd::FindWindowEx

Извлекает объект окна, имя класса и имя окна которого совпадают с указанными строками.Retrieves the window object whose class name and window name match the specified strings.

static CWnd* FindWindowEx(
    HWND hwndParent,
    HWND hwndChildAfter,
    LPCTSTR lpszClass,
    LPCTSTR lpszWindow);

ПараметрыParameters

hwndParenthwndParent
Ручка к родительскому окну, чьи детские окна должны быть обысканы.Handle to the parent window whose child windows are to be searched.

hwndChildAfterhwndChildAfter
Ручка к окну ребенка.Handle to a child window. Поиск начинается со следующего окна ребенка в порядке «Я».The search begins with the next child window in the Z order. Детское окно должно быть прямым детским окном hwndParent, а не просто окном потомка.The child window must be a direct child window of hwndParent, not just a descendant window.

lpszClasslpszClass
Указатель на строку с нулевым завершением, которая определяет имя класса или атом класса, созданный предыдущим вызовом в RegisterClass или RegisterClassEx.Pointer to a null-terminated string that specifies the class name or a class atom created by a previous call to the RegisterClass or RegisterClassEx.

lpszWindowlpszWindow
Указатель на строку с нулевым завершением, которая определяет имя окна (название окна).Pointer to a null-terminated string that specifies the window name (the window's title). Если этот параметр NULL, все имена окон совпадают.If this parameter is NULL, all window names match.

Возвращаемое значениеReturn Value

Если функция успешно работает, значение возврата является указателем на объект окна, имеющий указанный класс и имена окон.If the function succeeds, the return value is a pointer to the window object having the specified class and window names. Если функция выходит из строя, значение возврата является NULL.If the function fails, the return value is NULL.

RemarksRemarks

Эта функция-член имитирует функциональность функции FindWindowEx,как описано в SDK Windows.This member function emulates the functionality of the function FindWindowEx, as described in the Windows SDK.

CWnd::FlashWindowCWnd::FlashWindow

Мигает данный окне один раз.Flashes the given window once.

BOOL FlashWindow(BOOL bInvert);

ПараметрыParameters

bInvertbInvert
Определяет, является ли CWnd это вспышкой или возвращенным в исходное состояние.Specifies whether the CWnd is to be flashed or returned to its original state. Вспышки CWnd из одного состояния в другое, если bInvert является правдой.The CWnd is flashed from one state to the other if bInvert is TRUE. Если bInvert FALSE, окно возвращается в исходное состояние (активное или неактивное).If bInvert is FALSE, the window is returned to its original state (either active or inactive).

Возвращаемое значениеReturn Value

Nonzero, если окно было активен FlashWindow до вызова к функции члена; в противном случае 0.Nonzero if the window was active before the call to the FlashWindow member function; otherwise 0.

RemarksRemarks

Для последовательного мигания, создать системный таймер и неоднократно вызова FlashWindow.For successive flashing, create a system timer and repeatedly call FlashWindow. Мигает CWnd означает изменение внешнего вида его CWnd заголовок бар, как если бы менялись от неактивного к активному статусу, или наоборот.Flashing the CWnd means changing the appearance of its title bar as if the CWnd were changing from inactive to active status, or vice versa. (Неактивная заголовок бар изменения в активную панель заголовка; активный заголовок бар изменения неактивных заголовок бар.)(An inactive title bar changes to an active title bar; an active title bar changes to an inactive title bar.)

Как правило, окно мигает, чтобы сообщить пользователю, что он требует внимания, но что он в настоящее время не имеют входного фокуса.Typically, a window is flashed to inform the user that it requires attention but that it does not currently have the input focus.

Параметр bInvert должен быть FALSE только тогда, когда окно получает входная фокусировка и больше не будет мигать; она должна быть правдой на последовательных вызовов в ожидании, чтобы получить входин фокус.The bInvert parameter should be FALSE only when the window is getting the input focus and will no longer be flashing; it should be TRUE on successive calls while waiting to get the input focus.

Эта функция всегда возвращаетнее для минимизированных окон.This function always returns nonzero for minimized windows. Если окно сведено FlashWindow к минимуму, просто мигает значок окна; bInvert игнорируется для минимизированных окон.If the window is minimized, FlashWindow will simply flash the window's icon; bInvert is ignored for minimized windows.

ПримерExample

BOOL CPenWidthsDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   // set timer to cause dialog to flash
   SetTimer(1, 500, NULL);
   return TRUE; // return TRUE unless you set the focus to a control
}

void CPenWidthsDlg::OnTimer(UINT_PTR nIDEvent)
{
   // cause the dialog to flash
   FlashWindow(TRUE);
   CDialog::OnTimer(nIDEvent);
}

CWnd::FlashWindowExCWnd::FlashWindowEx

Мигает данное окно.Flashes the given window.

BOOL FlashWindowEx(
    DWORD dwFlags,
    UINT uCount,
    DWORD dwTimeout);

ПараметрыParameters

dwFlagsdwFlags
Определяет состояние вспышки.Specifies the flash status. Полный список значений можно узнать из структуры FLASHWINFO.For a complete list of values, see the FLASHWINFO structure.

uCountuCount
Определяет количество раз, чтобы мигать окно.Specifies the number of times to flash the window.

dwTimeoutdwTimeout
Определяет скорость, в миллисекундах, при которых окно будет мигать.Specifies the rate, in milliseconds, at which the window will be flashed. Если dwTimeout равен нулю, функция использует скорость мигания курсора по умолчанию.If dwTimeout is zero, the function uses the default cursor blink rate.

Возвращаемое значениеReturn Value

Значение возврата определяет состояние окна перед вызовом к FlashWindowEx функции.The return value specifies the window's state before the call to the FlashWindowEx function. Если подпись окна была нарисована как активная до вызова, значение возврата является ненулевым.If the window caption was drawn as active before the call, the return value is nonzero. В противном случае значение возврата равно нулю.Otherwise, the return value is zero.

RemarksRemarks

Этот метод эмулирует функциональность функции FlashWindowEx, как описано в Windows SDK.This method emulates the functionality of the function FlashWindowEx, as described in the Windows SDK.

CWnd::FromHandleCWnd::FromHandle

Возвращает указатель на объект CWnd, когда дескриптор передается окну.Returns a pointer to a CWnd object when given a handle to a window. Если объект CWnd не прикреплен к дескриптору, создается и прикрепляется временный объект CWnd.If a CWnd object is not attached to the handle, a temporary CWnd object is created and attached.

static CWnd* PASCAL FromHandle(HWND hWnd);

ПараметрыParameters

HwndhWnd
HWND окна Windows.An HWND of a Windows window.

Возвращаемое значениеReturn Value

Возвращает указатель на объект CWnd, когда дескриптор передается окну.Returns a pointer to a CWnd object when given a handle to a window. Если объект CWnd не прикреплен к дескриптору, создается и прикрепляется временный объект CWnd.If a CWnd object is not attached to the handle, a temporary CWnd object is created and attached.

Указатель может быть временным. Его не требуется сохранять для дальнейшего использования.The pointer may be temporary and should not be stored for later use.

CWnd::FromTheПостоянныйCWnd::FromHandlePermanent

Возвращает указатель на объект CWnd, когда дескриптор передается окну.Returns a pointer to a CWnd object when given a handle to a window.

static CWnd* PASCAL FromHandlePermanent(HWND hWnd);

ПараметрыParameters

HwndhWnd
HWND окна Windows.An HWND of a Windows window.

Возвращаемое значениеReturn Value

Указатель на объект CWnd.A pointer to a CWnd object.

RemarksRemarks

Если CWnd объект не прикреплен к ручке, NULL возвращается.If a CWnd object is not attached to the handle, NULL is returned.

Эта функция, в отличие от FromHandle,не создает временных объектов.This function, unlike FromHandle, does not create temporary objects.

CWnd::get_accChildCWnd::get_accChild

Вызывается платформой для извлечения адреса интерфейса IDispatch для указанного дочернего элемента.Called by the framework to retrieve the address of an IDispatch interface for the specified child.

virtual HRESULT get_accChild(
    VARIANT varChild,
    IDispatch** ppdispChild);

ПараметрыParameters

varChildvarChild
Идентифицирует ребенка, интерфейс которого IDispatch должен быть извлечен.Identifies the child whose IDispatch interface is to be retrieved.

ppdispChildppdispChild
Получает адрес интерфейса IDispatch детского объекта.Receives the address of the child object's IDispatch interface.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accChild в Windows SDK.See Return Values in IAccessible::get_accChild in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::get_accChild в Windows SDK.For more information, see IAccessible::get_accChild in the Windows SDK.

CWnd::get_accChildCountCWnd::get_accChildCount

Вызывается платформой для извлечения количества дочерних элементов, принадлежащих этому объекту.Called by the framework to retrieve the number of children belonging to this object.

virtual HRESULT get_accChildCount(long* pcountChildren);

ПараметрыParameters

pcountChildrenpcountChildren
Получает количество детей.Receives the number of children.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accChildCount в Windows SDK.See Return Values in IAccessible::get_accChildCount in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles). Вызовите версию базового класса, а затем добавьте элементы незаклееного ребенка.Call the base class version and then add the nonwindowed child elements.

Для получения дополнительной информации см. IAccessible::get_accChildCount в Windows SDK.For more information, see IAccessible::get_accChildCount in the Windows SDK.

CWnd::get_accDefaultActionCWnd::get_accDefaultAction

Вызывается платформой для извлечения строки, описывающей действие объекта по умолчанию.Called by the framework to retrieve a string that describes the object's default action.

virtual HRESULT get_accDefaultAction(
    VARIANT varChild,
    BSTR* pszDefaultAction);

ПараметрыParameters

varChildvarChild
Определяет, является ли извлеченное действие по умолчанию объектом или одним из элементов ребенка объекта.Specifies whether the default action to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pszDefaultActionpszDefaultAction
Адрес BSTR, который получает локализованную строку, описывающую действие по умолчанию для указанного объекта, или NULL, если этот объект не имеет действия по умолчанию.Address of a BSTR that receives a localized string describing the default action for the specified object, or NULL if this object has no default action.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accDefaultAction в Windows SDK.See Return Values in IAccessible::get_accDefaultAction in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переизвейдить CWndэту функцию в классе,производное, чтобы описать действие объекта по умолчанию.Override this function in your CWnd-derived class to describe your object's default action.

Для получения дополнительной информации см. IAccessible::get_accDefaultAction в Windows SDK.For more information, see IAccessible::get_accDefaultAction in the Windows SDK.

CWnd::get_accDescriptionCWnd::get_accDescription

Вызывается платформой для извлечения строки, описывающей внешний вид указанного объекта.Called by framework to retrieve a string that describes the visual appearance of the specified object.

virtual HRESULT get_accDescription(
    VARIANT varChild,
    BSTR* pszDescription);

ПараметрыParameters

varChildvarChild
Уточняется, является ли извлеченное описание описанием объекта или одним из элементов ребенка объекта.Specifies whether the description to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pszОписаниеpszDescription
Адрес BSTR, который получает локализованную строку, описывающую указанный объект, или NULL, если описание не доступно для этого объекта.Address of a BSTR that receives a localized string describing the specified object, or NULL if no description is available for this object.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accDescription в Windows SDK.See Return Values in IAccessible::get_accDescription in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переизобить CWndэту функцию в вашем классе, полученном, чтобы описать объект.Override this function in your CWnd-derived class to describe your object. Позвоните в версию базового класса и добавьте описание.Call the base class version and add your description.

Для получения дополнительной информации см. IAccessible::get_accDescription в Windows SDK.For more information, see IAccessible::get_accDescription in the Windows SDK.

CWnd::get_accFocusCWnd::get_accFocus

Вызывается платформой для извлечения объекта, имеющего фокус клавиатурного ввода.Called by the framework to retrieve the object that has the keyboard focus.

virtual HRESULT get_accFocus(VARIANT* pvarChild);

ПараметрыParameters

pvarChildpvarChild
Получает информацию об объекте, который имеет фокус.Receives information about the object that has the focus. Смотрите pvarID в IAccessible::get_accFocus в Windows SDK.See pvarID in IAccessible::get_accFocus in the Windows SDK.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::get_accFocus в SDK Windows.See Return Values in IAccessible::get_accFocus in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::get_accFocus в Windows SDK.For more information, see IAccessible::get_accFocus in the Windows SDK.

CWnd::get_accHelpCWnd::get_accHelp

Вызывается фректовой для извлечения строки справки объекта.Called by the framework to retrieve an object's Help property string.

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

ПараметрыParameters

varChildvarChild
Уточняется, является ли полученная информация о справке объектом или одним из элементов ребенка объекта.Specifies whether the help information to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pszHelppszHelp
Адрес BSTR, который получает локализованную строку, содержащую справочную информацию для указанного объекта, или NULL, если информация о справке отсутствует.Address of a BSTR that receives the localized string containing the help information for the specified object, or NULL if no help information is available.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accHelp в Windows SDK.See Return Values in IAccessible::get_accHelp in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переизобить CWndэту функцию в классе, полученном из вашего, чтобы предоставить текст справки для объекта.Override this function in your CWnd-derived class to provide help text for your object.

Для получения дополнительной информации см. IAccessible::get_accHelp в Windows SDK.For more information, see IAccessible::get_accHelp in the Windows SDK.

CWnd::get_accHelpTopicCWnd::get_accHelpTopic

Вызывается фреймворком для получения полного пути файла WinHelp, связанного с указанным объектом, и идентификатором соответствующей темы в этом файле.Called by the framework to retrieve the full path of the WinHelp file associated with the specified object and the identifier of the appropriate topic within that file.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

ПараметрыParameters

pszHelpFilepszHelpFile
Адрес BSTR, который получает полный WinHelp путь файла, связанного с указанным объектом, если таковой имеется.Address of a BSTR that receives the full path of the WinHelp file associated with the specified object, if any.

varChildvarChild
Уточняется, является ли извлекаемый предмет справки темой объекта или одним из элементов ребенка объекта.Specifies whether the Help topic to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения темы справки для объекта), либо идентификатора ребенка (для получения темы справки для одного из элементов ребенка объекта).This parameter can be either CHILDID_SELF (to obtain a Help topic for the object) or a child ID (to obtain a Help topic for one of the object's child elements).

pidTopicpidTopic
Определяет тему файла справки, связанную с указанным объектом.Identifies the Help file topic associated with the specified object. Смотрите pidTopic в IAccessible::get_accHelpTopic в Windows SDK.See pidTopic in IAccessible::get_accHelpTopic in the Windows SDK.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::get_accHelpTopic в SDK Windows.See Return Values in IAccessible::get_accHelpTopic in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переизобить CWndэту функцию в классе, полученном из вашего, чтобы предоставить справочную информацию о объекте.Override this function in your CWnd-derived class to provide help information about your object.

Для получения дополнительной информации см. IAccessible::get_accHelpTopic в Windows SDK.For more information, see IAccessible::get_accHelpTopic in the Windows SDK.

CWnd::get_accKeyboardShortcutCWnd::get_accKeyboardShortcut

Вызывается платформой для извлечения сочетания клавиш указанного объекта или клавиши доступа к нему.Called by the framework to retrieve the specified object's shortcut key or access key.

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

ПараметрыParameters

varChildvarChild
Уточняется, является ли извлечена клавиатура кратчайшим ключом объекта или одним из элементов ребенка объекта.Specifies whether the keyboard shortcut to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pszKeyboardShortcutpszKeyboardShortcut
Адрес BSTR, который получает локализованную строку, идентифицирующую ярлык клавиатуры, или NULL, если ярлык клавиатуры не связан с указанным объектом.Address of a BSTR that receives a localized string identifying the keyboard shortcut, or NULL if no keyboard shortcut is associated with the specified object.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accKeyboardShortcut в Windows SDK.See Return Values in IAccessible::get_accKeyboardShortcut in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переизобить CWndэту функцию в классе полученных клавиатуры, чтобы определить ярлык клавиатуры для объекта.Override this function in your CWnd-derived class to identify the keyboard shortcut for your object.

Для получения дополнительной информации см. IAccessible::get_accKeyboardShortcut в Windows SDK.For more information, see IAccessible::get_accKeyboardShortcut in the Windows SDK.

CWnd::get_accNameCWnd::get_accName

Вызывается платформой для извлечения имени указанного объекта.Called by the framework to retrieve the name of the specified object.

virtual HRESULT get_accName(
    VARIANT varChild,
    BSTR* pszName);

ПараметрыParameters

varChildvarChild
Уточняется, является ли имя, которое необходимо получить, объектом или одним из элементов ребенка объекта.Specifies whether the name to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pszNamepszName
Адрес BSTR, который получает строку, содержащую имя указанного объекта.Address of a BSTR that receives a string containing the specified object's name.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accName в Windows SDK.See Return Values in IAccessible::get_accName in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переизобить CWndэту функцию в классе,производные от вашего, чтобы вернуть имя объекта.Override this function in your CWnd-derived class to return the name of your object.

Для получения дополнительной информации см. IAccessible::get_accName в Windows SDK.For more information, see IAccessible::get_accName in the Windows SDK.

CWnd::get_accParentCWnd::get_accParent

Вызывается платформой для извлечения интерфейса IDispatch родительского элемента данного объекта.Called by the framework to retrieve the IDispatch interface of the object's parent.

virtual HRESULT get_accParent(IDispatch** ppdispParent);

ПараметрыParameters

ppdispParentppdispParent
Получает адрес интерфейса IDispatch родительского объекта.Receives the address of the parent object's IDispatch interface. Переменная установлена NULL, если не существует родителя, или если ребенок не может получить доступ к своему родителю.The variable is set to NULL if no parent exists, or if the child cannot access its parent.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accParent в Windows SDK.See Return Values in IAccessible::get_accParent in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

В большинстве случаев вам не придется переопределять эту функцию.In most cases you don't have to override this function.

Для получения дополнительной информации см. IAccessible::get_accParent в Windows SDK.For more information, see IAccessible::get_accParent in the Windows SDK.

CWnd::get_accRoleCWnd::get_accRole

Вызывается платформой для извлечения информации, описывающей роль указанного объекта.Called by the framework to retrieve information that describes the role of the specified object.

virtual HRESULT get_accRole(
    VARIANT varChild,
    VARIANT* pvarRole);

ПараметрыParameters

varChildvarChild
Уточняется, является ли полученная информация о роли объектом или одним из элементов ребенка объекта.Specifies whether the role information to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pvarRolepvarRole
Получает информацию о роли.Receives the role information. Смотрите pvarRole в IAccessible::get_accRole в Windows SDK.See pvarRole in IAccessible::get_accRole in the Windows SDK.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::get_accRole в SDK Windows.See Return Values in IAccessible::get_accRole in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::get_accRole в Windows SDK.For more information, see IAccessible::get_accRole in the Windows SDK.

CWnd::get_accSelectionCWnd::get_accSelection

Вызывается платформой для извлечения выбранного дочернего элемента этого объекта.Called by the framework to retrieve the selected children of this object.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

ПараметрыParameters

pvarДетиpvarChildren
Получает информацию о том, какие дети выбраны.Receives information about which children are selected. Смотрите pvarChildren в IAccessible::get_accSelection в Windows SDK.See pvarChildren in IAccessible::get_accSelection in the Windows SDK.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::get_accSelection в SDK Windows.See Return Values in IAccessible::get_accSelection in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::get_accSelection в Windows SDK.For more information, see IAccessible::get_accSelection in the Windows SDK.

CWnd::get_accStateCWnd::get_accState

Вызывается платформой для извлечения текущего состояния указанного объекта.Called by the framework to retrieve the current state of the specified object.

virtual HRESULT get_accState(
    VARIANT varChild,
    VARIANT* pvarState);

ПараметрыParameters

varChildvarChild
Определяет, является ли полученная информация о состоянии объектом или одним из элементов ребенка объекта.Specifies whether the state information to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pvarStatepvarState
Получает информацию о состоянии объекта.Receives information about the object's state. Смотрите pvarState в IAccessible::get_accState в Windows SDK.See pvarState in IAccessible::get_accState in the Windows SDK.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата IAccessible::get_accState в SDK Windows.See Return Values in IAccessible::get_accState in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::get_accState в Windows SDK.For more information, see IAccessible::get_accState in the Windows SDK.

CWnd::get_accValueCWnd::get_accValue

Вызывается платформой для извлечения значения указанного объекта.Called by the framework to retrieve the value of the specified object.

virtual HRESULT get_accValue(
    VARIANT varChild,
    BSTR* pszValue);

ПараметрыParameters

varChildvarChild
Уточняется, является ли полученная информация о значении объектом или одним из элементов ребенка объекта.Specifies whether the value information to be retrieved is that of the object or one of the object's child elements. Этот параметр может быть либо CHILDID_SELF (для получения информации об объекте), либо идентификатором ребенка (для получения информации о элементе ребенка объекта).This parameter can be either CHILDID_SELF (to obtain information about the object) or a child ID (to obtain information about the object's child element).

pszValuepszValue
Адрес BSTR, который получает локализованную строку, содержащую текущее значение объекта.Address of the BSTR that receives a localized string containing the object's current value.

Возвращаемое значениеReturn Value

Возвращает S_OK на успех, код ошибки COM при сбое.Returns S_OK on success, a COM error code on failure. Смотрите значения возврата в IAccessible::get_accValue в Windows SDK.See Return Values in IAccessible::get_accValue in the Windows SDK.

RemarksRemarks

Эта функция является частью поддержки активной доступности MFC.This function is part of MFC's Active Accessibility support.

Переопределить эту функцию в вашем -производном CWndклассе, если у вас есть неоконированные элементы пользовательского интерфейса (кроме элементов без окон ActiveX, которые mFC обрабатывает).Override this function in your CWnd-derived class if you have nonwindowed user interface elements (other than windowless ActiveX controls, which MFC handles).

Для получения дополнительной информации см. IAccessible::get_accValue в Windows SDK.For more information, see IAccessible::get_accValue in the Windows SDK.

CWnd::GetActiveWindowCWnd::GetActiveWindow

Извлекает указатель на активное окно.Retrieves a pointer to the active window.

static CWnd* PASCAL GetActiveWindow();

Возвращаемое значениеReturn Value

Активное окно или NULL, если на момент вызова окно не было активным.The active window or NULL if no window was active at the time of the call. Указатель может быть временным. Его не требуется сохранять для дальнейшего использования.The pointer may be temporary and should not be stored for later use.

RemarksRemarks

Активное окно — это либо окно с текущим входной фокусом, либо окно, явно активное функцией члена SetActiveWindow.The active window is either the window that has the current input focus or the window explicitly made active by the SetActiveWindow member function.

CWnd::GetПредCWnd::GetAncestor

Извлекает объект окна-предка для указанного окна.Retrieves the ancestor window object of the specified window.

CWnd* GetAncestor(UINT gaFlags) const;

ПараметрыParameters

gaFlagsgaFlags
Определяет предка, который должен быть извлечен.Specifies the ancestor to be retrieved. Полный список возможных значений можно узнать на примере GetAncestor.For a complete list of possible values, see GetAncestor.

Возвращаемое значениеReturn Value

Если функция успешно, значение возврата является указателем на объект окна предка.If the function succeeds, the return value is a pointer to the ancestor window object. Если функция выходит из строя, значение возврата является NULL.If the function fails, the return value is NULL.

RemarksRemarks

Эта функция члена эмулирует функциональность функции GetAncestor, как описано в Windows SDK.This member function emulates the functionality of the function GetAncestor, as described in the Windows SDK.

CWnd::GetCaptureCWnd::GetCapture

Извлекает окно, которое имеет захват мыши.Retrieves the window that has the mouse capture.

static CWnd* PASCAL GetCapture();

Возвращаемое значениеReturn Value

Идентифицирует окно, которое имеет захват мыши.Identifies the window that has the mouse capture. Это NULL, если нет окна имеет захват мыши.It is NULL if no window has the mouse capture.

Значение возврата может быть временным и не должно храниться для последующего использования.The return value may be temporary and should not be stored for later use.

RemarksRemarks

Только одно окно имеет захват мыши в любой момент времени.Only one window has the mouse capture at any given time. Окно получает захват мыши при вызове функции участника SetCapture.A window receives the mouse capture when the SetCapture member function is called. Это окно получает ввод мыши независимо от того, находится ли курсор в пределах своих границ.This window receives mouse input whether or not the cursor is within its borders.

CWnd::GetCaretPosCWnd::GetCaretPos

Извлекает координаты текущего положения caret и CPointвозвращает их в качестве .Retrieves the client coordinates of the caret's current position and returns them as a CPoint.

static CPoint PASCAL GetCaretPos();

Возвращаемое значениеReturn Value

Объект CPoint, содержащий координаты положения карета.CPoint object containing the coordinates of the caret's position.

RemarksRemarks

Положение внимательности приведено в координатах CWnd клиента окна.The caret position is given in the client coordinates of the CWnd window.

CWnd::GetCheckedRadioButtonCWnd::GetCheckedRadioButton

Извлекает идентификатор проверенной в настоящее время кнопки радио в указанной группе.Retrieves the ID of the currently checked radio button in the specified group.

int GetCheckedRadioButton(
    int nIDFirstButton,
    int nIDLastButton);

ПараметрыParameters

nIDFirstButtonnIDFirstButton
Определяет идентификатор первой радиокнопки в группе.Specifies the integer identifier of the first radio button in the group.

nIDLastButtonnIDLastButton
Определяет идентификатор всей этой кнопки радио в группе.Specifies the integer identifier of the last radio button in the group.

Возвращаемое значениеReturn Value

Идентификатор проверенной кнопки радио, или 0, если ни один не выбран.ID of the checked radio button, or 0 if none is selected.

CWnd::GetClientRectCWnd::GetClientRect

Копирует координаты CWnd клиентской области в структуру, на которую указывает lpRect.Copies the client coordinates of the CWnd client area into the structure pointed to by lpRect.

void GetClientRect(LPRECT lpRect) const;

ПараметрыParameters

lpRectlpRect
Указывает на структуру RECT или CRect объект для получения координат клиента.Points to a RECT structure or a CRect object to receive the client coordinates. И left top членов будет 0.The left and top members will be 0. И right bottom члены будут содержать ширину и высоту окна.The right and bottom members will contain the width and height of the window.

RemarksRemarks

В координатах клиента указаны верхний левый и нижний правый углы клиентской зоны.The client coordinates specify the upper-left and lower-right corners of the client area. Поскольку координаты клиента относительно верхнего CWnd левого угла клиентской области, координаты верхнего левого угла (0,0).Since client coordinates are relative to the upper-left corners of the CWnd client area, the coordinates of the upper-left corner are (0,0).

ПримерExample

Смотрите пример для CWnd::IsIconic.See the example for CWnd::IsIconic.

CWnd::GetClipboardВладелецCWnd::GetClipboardOwner

Получает текущего владельца Clipboard.Retrieves the current owner of the Clipboard.

static CWnd* PASCAL GetClipboardOwner();

Возвращаемое значениеReturn Value

Определяет окно, которому принадлежит Clipboard, если функция успешна.Identifies the window that owns the Clipboard if the function is successful. В противном случае, это NULL.Otherwise, it is NULL.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Clipboard по-прежнему может содержать данные, даже если он в настоящее время не принадлежит.The Clipboard can still contain data even if it is not currently owned.

CWnd::GetClipboardViewerCWnd::GetClipboardViewer

Извлекает первое окно в цепочке Clipboard-viewer.Retrieves the first window in the Clipboard-viewer chain.

static CWnd* PASCAL GetClipboardViewer();

Возвращаемое значениеReturn Value

Определяет окно, в настоящее время ответственное за отображение Clipboard в случае успеха; в противном случае NULL (например, если нет зрителя).Identifies the window currently responsible for displaying the Clipboard if successful; otherwise NULL (for example, if there is no viewer).

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

CWnd::GetControlUnknownCWnd::GetControlUnknown

Вызов исвызывайте эту функцию участника, чтобы получить указатель неизвестному управлению OLE.Call this member function to retrieve a pointer to an unknown OLE control.

LPUNKNOWN GetControlUnknown();

Возвращаемое значениеReturn Value

Указатель на интерфейс IUnknown управления OLE, представленный этим CWnd объектом.A pointer to the IUnknown interface of the OLE control represented by this CWnd object. Если этот объект не представляет элемент управления OLE, значение возврата является NULL.If this object does not represent an OLE control, the return value is NULL.

RemarksRemarks

Вы не должны IUnknown выпускать этот указатель.You should not release this IUnknown pointer. Как правило, вы используете для получения определенного интерфейса управления.Typically, you would use to obtain a specific interface of the control.

Указатель интерфейса, GetControlUnknown возвращенный, не считается эталонным.The interface pointer returned by GetControlUnknown is not reference-counted. Не звоните IUnknown::Release на указатель, если вы ранее не назвали IUnknown::AddRef на нем.Do not call IUnknown::Release on the pointer unless you have previously called IUnknown::AddRef on it.

ПримерExample

// The following code fragment is taken from CMyDlg::OnInitDialog
// CMyDlg is a CDialog-derived class.

// IDC_MSACALCTRL1 is the ID of the Calendar control OCX embedded
// on this dialog
CWnd *pWndCal = GetDlgItem(IDC_MSACALCTRL1);

// Use the IUnknown of the control
LPUNKNOWN pUnk = pWndCal->GetControlUnknown();

// From there get the IDispatch interface of control
LPDISPATCH pDisp = NULL;
pUnk->QueryInterface(IID_IDispatch, (LPVOID*)&pDisp);

// use IDispatch method to invoke the control's functionality

CWnd::GetCurrentMessageCWnd::GetCurrentMessage

Возвращает указатель на сообщение, обрабатываемое этим окном в настоящий момент.Returns a pointer to the message this window is currently processing. Следует вызываться только при работе в функции обработчика сообщений OnMessage.Should only be called when in an OnMessage message-handler member function.

static const MSG* PASCAL GetCurrentMessage();

Возвращаемое значениеReturn Value

Возвращает указатель в структуру MSG, содержащую сообщение, которое в настоящее время обрабатывает окно.Returns a pointer to the MSG structure that contains the message the window is currently processing. Следует вызываться только при обработке насообщении.Should only be called when in an OnMessage handler.

ПримерExample

Смотрите пример CMDIFrameWnd::MDICascade.See the example for CMDIFrameWnd::MDICascade.

CWnd::GetDCCWnd::GetDC

Извлекает указатель на общий, классовый или закрытый контекст устройства для области CWndклиента в зависимости от стиля класса, указанного для .Retrieves a pointer to a common, class, or private device context for the client area depending on the class style specified for the CWnd.

CDC* GetDC();

Возвращаемое значениеReturn Value

Определяет контекст устройства для CWnd области клиента в случае успеха; в противном случае значение возврата null.Identifies the device context for the CWnd client area if successful; otherwise, the return value is NULL. Указатель может быть временным. Его не требуется сохранять для дальнейшего использования.The pointer may be temporary and should not be stored for later use.

RemarksRemarks

Для общих контекстов устройства GetDC присваиваем атрибуты по умолчанию контексту при каждом извлечении.For common device contexts, GetDC assigns default attributes to the context each time it is retrieved. Для классовики GetDC и частных контекстов оставляют ранее назначенные атрибуты без изменений.For class and private contexts, GetDC leaves the previously assigned attributes unchanged. Контекст устройства можно использовать в последующих функциях интерфейса графического устройства (GDI) для рисования в клиентской области.The device context can be used in subsequent graphics device interface (GDI) functions to draw in the client area.

Если контекст устройства не относится к классу окон, функция участника ReleaseDC должна быть вызвана для выпуска контекста после рисования.Unless the device context belongs to a window class, the ReleaseDC member function must be called to release the context after painting.

Контекст устройства, относящийся к CWnd классу, возвращается функцией GetDC элемента, WNDCLASS если CS_CLASSDC, CS_OWNDC или CS_PARENTDC был указан как стиль в структуре при регистрации класса.A device context belonging to the CWnd class is returned by the GetDC member function if CS_CLASSDC, CS_OWNDC, or CS_PARENTDC was specified as a style in the WNDCLASS structure when the class was registered.

CWnd::GetDCExCWnd::GetDCEx

Извлекает ручку контекста устройства CWnd для окна.Retrieves the handle of a device context for the CWnd window.

CDC* GetDCEx(
    CRgn* prgnClip,
    DWORD flags);

ПараметрыParameters

prgnClipprgnClip
Определяет область отсечения, которая может быть объединена с видимой областью окна клиента.Identifies a clipping region that may be combined with the visible region of the client window.

flagsflags
Может иметь одно из следующих заранее установленных значений:Can have one of the following preset values:

  • DCX_CACHE возвращает контекст устройства из кэша, а не окно OWNDC или CLASSDC.DCX_CACHE Returns a device context from the cache rather than the OWNDC or CLASSDC window. Оверлет CS_OWNDC и CS_CLASSDC.Overrides CS_OWNDC and CS_CLASSDC.

  • DCX_CLIPCHILDREN исключает видимые области всех CWnd детских окон под окном.DCX_CLIPCHILDREN Excludes the visible regions of all child windows below the CWnd window.

  • DCX_CLIPSIBLINGS исключает видимые области всех CWnd окон братьев и сестер над окном.DCX_CLIPSIBLINGS Excludes the visible regions of all sibling windows above the CWnd window.

  • DCX_EXCLUDERGN исключает область отсечения, идентифицированную prgnClip, из видимой области контекста возвращенного устройства.DCX_EXCLUDERGN Excludes the clipping region identified by prgnClip from the visible region of the returned device context.

  • DCX_INTERSECTRGN пересекает область отсечения, идентифицированную prgnClip в видимом контексте возвращенного устройства.DCX_INTERSECTRGN Intersects the clipping region identified by prgnClip within the visible region of the returned device context.

  • DCX_LOCKWINDOWUPDATE позволяет рисовать, LockWindowUpdate даже если есть вызов в силе, что в противном случае исключить это окно.DCX_LOCKWINDOWUPDATE Allows drawing even if there is a LockWindowUpdate call in effect that would otherwise exclude this window. Это значение используется для рисования во время отслеживания.This value is used for drawing during tracking.

  • DCX_PARENTCLIP использует видимую область родительского окна и игнорирует WS_CLIPCHILDREN и WS_PARENTDC элементов стиля.DCX_PARENTCLIP Uses the visible region of the parent window and ignores the parent window's WS_CLIPCHILDREN and WS_PARENTDC style bits. Это значение устанавливает происхождение контекста устройства в верхний CWnd левый угол окна.This value sets the device context's origin to the upper-left corner of the CWnd window.

  • DCX_WINDOW возвращает контекст устройства, который соответствует прямоугольнику окна, а не клиенту прямоугольнику.DCX_WINDOW Returns a device context that corresponds to the window rectangle rather than the client rectangle.

Возвращаемое значениеReturn Value

Контекст устройства для указанного окна, если функция успешна; в противном случае NULL.The device context for the specified window if the function is successful; otherwise NULL.

RemarksRemarks

Контекст устройства может быть использован в последующих функциях GDI для рисования в клиентской области.The device context can be used in subsequent GDI functions to draw in the client area.

Эта функция, которая является расширением функции GetDC, дает приложению больше контроля над тем, как и является ли контекст устройства для окна обрезан.This function, which is an extension to the GetDC function, gives an application more control over how and whether a device context for a window is clipped.

Если контекст устройства не относится к классу окон, функция ReleaseDC должна быть вызвана для выпуска контекста после рисования.Unless the device context belongs to a window class, the ReleaseDC function must be called to release the context after drawing. Поскольку в любой момент времени доступны только пять общих контекстов устройства, отказ от выпуска контекста устройства может помешать другим приложениям получить доступ к контексту устройства.Since only five common device contexts are available at any given time, failure to release a device context can prevent other applications from gaining access to a device context.

Для получения контекста кэшированного устройства приложение должно указать DCX_CACHE.To obtain a cached device context, an application must specify DCX_CACHE. Если DCX_CACHE не указаний и окно не CS_OWNDC и CS_CLASSDC,эта функция возвращает NULL.If DCX_CACHE is not specified and the window is neither CS_OWNDC nor CS_CLASSDC, this function returns NULL.

Контекст устройства со специальными характеристиками возвращается функцией GetDCEx, если CS_CLASSDC, CS_OWNDCили CS_PARENTDC стиль был указан в структуре WNDCLASS при регистрации класса.A device context with special characteristics is returned by the GetDCEx function if the CS_CLASSDC, CS_OWNDC, or CS_PARENTDC style was specified in the WNDCLASS structure when the class was registered.

Для получения дополнительной информации об этих WNDCLASS характеристиках, см.For more information about these characteristics, see the description of the WNDCLASS structure in the Windows SDK.

CWnd::GetDCRenderTargetCWnd::GetDCRenderTarget

Извлекает целевой объект отрисовки из контекста устройства для окна CWnd.Retrieves the device context (DC) render target for the CWnd window.

CDCRenderTarget* GetDCRenderTarget();

Возвращаемое значениеReturn Value

Целевой объект отрисовки из контекста устройства, если функция выполнена успешно; в противном случае — NULL.The device context render target for the specified window if the function is successful; otherwise NULL.

RemarksRemarks

CWnd::GetDescendantWindowCWnd::GetDescendantWindow

Вызовите эту функцию участника, чтобы найти окно потомка, указанное данным идентификатором.Call this member function to find the descendant window specified by the given ID.

CWnd* GetDescendantWindow(
    int nID,
    BOOL bOnlyPerm = FALSE) const;

ПараметрыParameters

nIDnID
Определяет идентификатор элемента управления или детского окна для извлечения.Specifies the identifier of the control or child window to be retrieved.

bOnlyPermbOnlyPerm
Уточняется, может ли возвращенное окно быть временным.Specifies whether the window to be returned can be temporary. Если true, только постоянное окно может быть возвращено; если FALSE, функция может вернуть временное окно.If TRUE, only a permanent window can be returned; if FALSE, the function can return a temporary window. Для получения дополнительной информации о временных окнах см.For more information on temporary windows see Technical Note 3.

Возвращаемое значениеReturn Value

Указатель на CWnd объект или NULL, если не найдено окно ребенка.A pointer to a CWnd object, or NULL if no child window is found.

RemarksRemarks

Эта функция участника выполняет поиск всего дерева детских окон, а не только окон, которые являются непосредственными детьми.This member function searches the entire tree of child windows, not only the windows that are immediate children.

CWnd::GetDesktopWindowCWnd::GetDesktopWindow

Возвращает окно рабочего стола Windows.Returns the Windows desktop window.

static CWnd* PASCAL GetDesktopWindow();

Возвращаемое значениеReturn Value

Идентифицирует окно рабочего стола Windows.Identifies the Windows desktop window. Этот указатель может быть временным и не должен храниться для последующего использования.This pointer may be temporary and should not be stored for later use.

RemarksRemarks

Окно рабочего стола охватывает весь экран и представляет собой область, поверх которой окрашены все значки и другие окна.The desktop window covers the entire screen and is the area on top of which all icons and other windows are painted.

CWnd::GetDlgCtrlIDCWnd::GetDlgCtrlID

Возвращает значение идентификатора окна или элемента управления для любого окна ребенка, а не только элемент управления в диалоговом окне.Returns the window or control ID value for any child window, not only that of a control in a dialog box.

int GetDlgCtrlID() const;

Возвращаемое значениеReturn Value

Числовый идентификатор CWnd окна ребенка, если функция успешна; в противном случае 0.The numeric identifier of the CWnd child window if the function is successful; otherwise 0.

RemarksRemarks

Поскольку окна верхнего уровня не имеют значения идентификатора, CWnd значение возврата этой функции является недействительным, если окно верхнего уровня является недействительным.Since top-level windows do not have an ID value, the return value of this function is invalid if the CWnd is a top-level window.

ПримерExample

Смотрите пример CWnd::OnCtlColor.See the example for CWnd::OnCtlColor.

CWnd::GetDlgItemCWnd::GetDlgItem

Извлекает указатель на указанное окно управления или дочернее окно в диалоговом окне или другом окне.Retrieves a pointer to the specified control or child window in a dialog box or other window.

CWnd* GetDlgItem(int nID) const;

void GetDlgItem(
    int nID,
    HWND* phWnd) const;

ПараметрыParameters

nIDnID
Определяет идентификатор элемента управления или детского окна для извлечения.Specifies the identifier of the control or child window to be retrieved.

phWndphWnd
Указатель на детское окно.A pointer to a child window.

Возвращаемое значениеReturn Value

Указатель на данное окно управления или детское окно.A pointer to the given control or child window. Если нет контроля с идентификатором, предоставленным параметром nID, значение является NULL.If no control with the integer ID given by the nID parameter exists, the value is NULL.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Возвращается указатель, как правило, отбрасывается к типу управления, идентифицированному nID.The pointer returned is usually cast to the type of control identified by nID.

ПримерExample

// uses GetDlgItem to return a pointer to a user interface control
CEdit *pBoxOne;
pBoxOne = (CEdit*)GetDlgItem(IDC_MYEDIT);
GotoDlgCtrl(pBoxOne);

CWnd::GetDlgItemIntCWnd::GetDlgItemInt

Извлекает текст элемента управления, идентифицированного nID.Retrieves the text of the control identified by nID.

UINT GetDlgItemInt(
    int nID,
    BOOL* lpTrans = NULL,
    BOOL bSigned = TRUE) const;

ПараметрыParameters

nIDnID
Определяет идентификатор нестого числа управления диалоговой коробкой, который будет переведен.Specifies the integer identifier of the dialog-box control to be translated.

lpTranslpTrans
Указывает на переменную Boolean, которая должна получить переведенный флаг.Points to the Boolean variable that is to receive the translated flag.

bПодписанныйbSigned
Определяется, подписано ли значение, подносивео к извлечению.Specifies whether the value to be retrieved is signed.

Возвращаемое значениеReturn Value

Определяет переведенное значение текста элемента диалог-бокс.Specifies the translated value of the dialog-box item text. Поскольку 0 является допустимое значение возврата, lpTrans должен использоваться для обнаружения ошибок.Since 0 is a valid return value, lpTrans must be used to detect errors. Если подписанное значение возврата желательно, отбросьте его в тип Int.If a signed return value is desired, cast it as an int type.

Функция возвращает 0, если переведенное число превышает INT_MAX (для подписанных номеров) или UINT_MAX (для неподписанных).The function returns 0 if the translated number is greater than INT_MAX (for signed numbers) or UINT_MAX (for unsigned).

При возникновении ошибок, таких как столкновение с ненизмотенными символами и превышение вышеуказанного максимума, GetDlgItemInt копии 0 к месту, указанному lpTrans.When errors occur, such as encountering nonnumeric characters and exceeding the above maximum, GetDlgItemInt copies 0 to the location pointed to by lpTrans. Если ошибок нет, lpTrans получает ненулевое значение.If there are no errors, lpTrans receives a nonzero value. Если lpTrans является GetDlgItemInt NULL, не предупреждает об ошибках.If lpTrans is NULL, GetDlgItemInt does not warn about errors.

RemarksRemarks

Он преобразует текст указанного элемента управления в данном диалоговом поле в значение, зачистив любые дополнительные пробелы в начале текста и преобразовав десятичные цифры.It translates the text of the specified control in the given dialog box into an integer value by stripping any extra spaces at the beginning of the text and converting decimal digits. Он останавливает перевод, когда он достигает конца текста или сталкивается с любым ненчислоным персонажем.It stops the translation when it reaches the end of the text or encounters any nonnumeric character.

Если bSigned является GetDlgItemInt правдой, проверяется на знак минус (-) в начале текста и переводит текст в подписанный номер.If bSigned is TRUE, GetDlgItemInt checks for a minus sign (-) at the beginning of the text and translates the text into a signed number. В противном случае он создает неподписанное значение.Otherwise, it creates an unsigned value.

Он отправляет WM_GETTEXT сообщение на контроль.It sends a WM_GETTEXT message to the control.

CWnd::GetDlgItemTextCWnd::GetDlgItemText

Вызов эту функцию участника для получения заголовка или текста, связанных с элементом управления в диалоговом поле.Call this member function to retrieve the title or text associated with a control in a dialog box.

int GetDlgItemText(
    int nID,
    LPTSTR lpStr,
    int nMaxCount) const;

int GetDlgItemText(
    int nID,
    CString& rString) const;

ПараметрыParameters

nIDnID
Определяет идентификатор самого разложенный элемент управления, название которого должно быть извлечено.Specifies the integer identifier of the control whose title is to be retrieved.

lpStrlpStr
Указывает на буфер для получения заголовка или текста элемента управления.Points to the buffer to receive the control's title or text.

nMaxCountnMaxCount
Упоняет максимальную длину (в символах) строки, которая будет скопирована на lpStr.Specifies the maximum length (in characters) of the string to be copied to lpStr. Если строка длиннее nMaxCount, она усечена.If the string is longer than nMaxCount, it is truncated.

rStringrString
Ссылка на CString.A reference to a CString.

Возвращаемое значениеReturn Value

Определяет фактическое количество символов, скопированных в буфер, не включая термин null.Specifies the actual number of characters copied to the buffer, not including the terminating null character. Значение 0, если текст не скопирован.The value is 0 if no text is copied.

RemarksRemarks

Функция GetDlgItemText участника копирует текст к местоположению, на который указывает lpStr, и возвращает количество байтов, которые он копирует.The GetDlgItemText member function copies the text to the location pointed to by lpStr and returns a count of the number of bytes it copies.

CWnd::GetDSCCursorCWnd::GetDSCCursor

Вызовите эту функцию участника, чтобы получить указатель на базовый курсор, определяемый свойствами DataSource, UserName, Password и S'L управления источником данных.Call this member function to retrieve a pointer to the underlying cursor that is defined by the DataSource, UserName, Password, and SQL properties of the data-source control.

IUnknown* GetDSCCursor();

Возвращаемое значениеReturn Value

Указатель на курсор, определяемый управлением источником данных.A pointer to a cursor that is defined by a data-source control. MFC заботится AddRef о вызове для указателя.MFC takes care of calling AddRef for the pointer.

RemarksRemarks

Используйте ответный указатель для установки свойства ICursor сложного управления, связанного с данными, например управления сеткой, привязанной к данным.Use the returned pointer to set the ICursor property of a complex data-bound control, such as the data-bound grid control. Элемент управления источником данных не станет активным до тех пор, пока первый связанный элемент управления не запрашивает свой курсор.A data-source control will not become active until the first bound control requests its cursor. Это может произойти либо явно GetDSCCursor по звонку, либо косвенно связывающимся менеджером MFC.This can happen either explicitly by a call to GetDSCCursor or implicitly by the MFC binding manager. В любом случае, вы можете заставить управление источником GetDSCCursor данных Release стать активным, IUnknownпозвонив, а затем вызывая возвращенный указатель на .In either case, you can force a data-source control to become active by calling GetDSCCursor and then calling Release on the returned pointer to IUnknown. Активация приведет к попытке подключения к базовому источнику данных.Activation will cause the data-source control to attempt to connect to the underlying data source. Ответный указатель может быть использован в следующем контексте:The returned pointer might be used in the following context:

ПримерExample

BOOL CMyDlg::OnInitDialog()
{
   // Find the child controls on the dialog
   HRESULT hr = E_FAIL;
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pListWnd = GetDlgItem(IDC_DBLIST1);
   IUnknown *punkList = pListWnd->GetControlUnknown();
   IDBList *pList = NULL;

   if (NULL != punkList)
   {
      hr = punkList->QueryInterface(__uuidof(IDBList), (void **)&pList);
   }

   if (SUCCEEDED(hr))
   {
      // Tell the MFC binding manager that we are
      // binding DISPID 3 to the data-source control.
      pListWnd->BindProperty(0x3, pDSC);

      // Tell the listbox which field to expose as its bound column
      pList->put_BoundColumn(_T("ContactFirstName"));

      // Tell the listbox which cursor and column to populate its list from
      pList->put_ListField(_T("ContactFirstName"));

      IUnknown *punkCursor = pDSC->GetDSCCursor();
      if (NULL != punkCursor)
      {
         punkCursor->Release();
      }

      pList->Release();
      return TRUE;
   }

CWnd:GetDynamicLayoutCWnd::GetDynamicLayout

Извлекает указатель на объект диспетчера динамического макета.Retrieves a pointer to the dynamic layout manager object.

CMFCDynamicLayout* GetDynamicLayout();

Возвращаемое значениеReturn Value

Указатель на объект диспетчера динамического макета; NULL — если динамический макет отключен.A pointer to the dynamic layout manager object, or NULL if dynamic layout is not enabled.

RemarksRemarks

Объект окна владеет и управляет временем жизни возвращаемого указателя, поэтому его следует использовать только для доступа к этому объекту. Не удаляйте указатель или сохраняйте его перманентно.The window object owns and manages the lifetime of the returned pointer, so it should only be used to access the object; do not delete the pointer or store the pointer permanently.

CWnd::GetExStyleCWnd::GetExStyle

Возвращает расширенный стиль окна.Returns the window's extended style.

DWORD GetExStyle() const;

Возвращаемое значениеReturn Value

Удлинение стиля окна.The window's extended style. Для получения дополнительной информации о расширенных стилях окон, используемых в MFC, см.For more information about the extended window styles used in MFC, see Extended Window Styles.

CWnd::GetFocusCWnd::GetFocus

Извлекает указатель на CWnd то, что в настоящее время имеет фокус ввода.Retrieves a pointer to the CWnd that currently has the input focus.

static CWnd* PASCAL GetFocus();

Возвращаемое значениеReturn Value

Указатель на окно с текущим фокусом или NULL, если нет окна фокусировки.A pointer to the window that has the current focus, or NULL if there is no focus window.

Указатель может быть временным. Его не требуется сохранять для дальнейшего использования.The pointer may be temporary and should not be stored for later use.

CWnd::GetFontCWnd::GetFont

Отправляет WM_GETFONT сообщение в окно для получения текущего шрифта.Sends the WM_GETFONT message to the window to retrieve the current font.

CFont* GetFont() const;

Возвращаемое значениеReturn Value

Указатель на объект CFont, который прикрепляется к текущему шрифту для окна.Pointer to a CFont object that is attached to the current font for the window.

RemarksRemarks

Этот метод не имеет никакого эффекта, если окно не обрабатывает WM_GETFONT сообщение.This method has no effect unless the window processes the WM_GETFONT message. Многие классы MFC, которые вытекают из CWnd обработки этого сообщения, потому что они прикреплены к заданному классу окон, который включает обработчик сообщений для WM_GETFONT сообщения.Many MFC classes that derive from CWnd process this message because they are attached to a predefined window class that includes a message handler for the WM_GETFONT message. Для использования этого метода классы, полученные из CWnd этого метода, должны определить обработчик метода для сообщения WM_GETFONT.To use this method, classes that you derive from CWnd must define a method handler for the WM_GETFONT message.

CWnd::GetForegroundWindowCWnd::GetForegroundWindow

Возвращает указатель на окно переднего плана (окно, с которым пользователь в настоящее время работает).Returns a pointer to the foreground window (the window with which the user is currently working).

static CWnd* PASCAL GetForegroundWindow();

Возвращаемое значениеReturn Value

Указатель на окно переднего плана.A pointer to the foreground window. Это может быть CWnd временный объект.This may be a temporary CWnd object.

RemarksRemarks

Окно переднего плана применяется только к окнам верхнего уровня (окна кадра или диалоговые окна).The foreground window applies only to top-level windows (frame windows or dialog boxes).

CWnd::GetIconCWnd::GetIcon

Вызовите эту функцию члена для того чтобы получить ручку к или большому (32x32) или ручке к малому (16x16) значку, как показано bBigIcon.Call this member function to get the handle to either a big (32x32) or the handle to a small (16x16) icon, as indicated by bBigIcon.

HICON GetIcon(BOOL bBigIcon) const;

ПараметрыParameters

bBigIconbBigIcon
Определяет значок 32 пикселя на 32 пикселя, если это правда; определяет значок 16 пикселей на 16 пикселей, если FALSE.Specifies a 32 pixel by 32 pixel icon if TRUE; specifies a 16 pixel by 16 pixel icon if FALSE.

Возвращаемое значениеReturn Value

Дескриптор для значка.A handle to an icon. В случае неудачи возвращает NULL.If unsuccessful, returns NULL.

CWnd::GetLastActivePopupCWnd::GetLastActivePopup

Определяет последнее проявлявшее активность всплывающее окно, принадлежащее классу CWnd.Determines which pop-up window owned by CWnd was most recently active.

CWnd* GetLastActivePopup() const;

Возвращаемое значениеReturn Value

Идентифицирует последнее активное всплывающее окно.Identifies the most recently active pop-up window. Значение возврата будет само окно, если любое из следующих условий выполнено:The return value will be the window itself if any of the following conditions are met:

  • Само окно было в последнее время активно.The window itself was most recently active.

  • Окно не владеет всплывающими окнами.The window does not own any pop-up windows.

  • Окно не является окном верхнего уровня или принадлежит другому окну.The window is not a top-level window or is owned by another window.

Указатель может быть временным. Его не требуется сохранять для дальнейшего использования.The pointer may be temporary and should not be stored for later use.

ПримерExample

Смотрите пример CWnd::FindWindow.See the example for CWnd::FindWindow.

CWnd::GetLayeredWindowAttributesCWnd::GetLayeredWindowAttributes

Получает ключ цвета прозрачности многослойного окна.Retrieves the opacity and transparency color key of a layered window.

BOOL GetLayeredWindowAttributes(
    COLORREF* pcrKey,
    BYTE* pbAlpha,
    DWORD* pdwFlags) const;

ПараметрыParameters

pcrKeypcrKey
Указатель на значение COLORREF, которое получает цветной ключ прозрачности, который будет использоваться при составлении многослойного окна.Pointer to a COLORREF value that receives the transparency color key to be used when composing the layered window. Все пиксели, окрашенные окном в этом цвете, будут прозрачными.All pixels painted by the window in this color will be transparent. Это может быть NULL, если аргумент не нужен.This can be NULL if the argument is not needed.

pbAlphapbAlpha
Указатель на BYTE, который получает значение Альфа, используемое для описания непрозрачности многослойного окна.Pointer to a BYTE that receives the Alpha value used to describe the opacity of the layered window. Когда переменная, на которую ссылается pbAlpha, составляет 0, окно полностью прозрачно.When the variable referred to by pbAlpha is 0, the window is completely transparent. Когда переменная, на которую ссылается pbAlpha, составляет 255, окно непрозрачно.When the variable referred to by pbAlpha is 255, the window is opaque. Это может быть NULL, если аргумент не нужен.This can be NULL if the argument is not needed.

pdwFlagspdwFlags
Указатель на DWORD, который получает наслоение флага.Pointer to a DWORD that receives a layering flag. Это может быть NULL, если аргумент не нужен.This can be NULL if the argument is not needed. Полный список возможных значений можно узнать на примере GetLayeredWindowAttributes.For a complete list of possible values, see GetLayeredWindowAttributes.

Возвращаемое значениеReturn Value

Nonzero, если функция успешно; в противном случае 0.Nonzero if the function succeeds; otherwise 0.

RemarksRemarks

Эта функция-член эмулирует функциональность функции GetLayeredWindowAttributes,как описано в SDK Windows.This member function emulates the functionality of the function GetLayeredWindowAttributes, as described in the Windows SDK.

CWnd::GetMenuCWnd::GetMenu

Извлекает указатель в меню для этого окна.Retrieves a pointer to the menu for this window.

CMenu* GetMenu() const;

Возвращаемое значениеReturn Value

Определяет меню.Identifies the menu. Значение NULL, CWnd если не имеет меню.The value is NULL if CWnd has no menu. Значение возврата не определено, если CWnd это окно ребенка.The return value is undefined if CWnd is a child window.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Эта функция не должна использоваться для детских окон, поскольку у них нет меню.This function should not be used for child windows because they do not have a menu.

ПримерExample

void CMainFrame::OnCwndDeletefilemenu()
{
   // This example deletes the leftmost popup menu or leftmost
   // popup menu item from the application's main window.
   CWnd *pMain = AfxGetMainWnd();

   // The main window _can_ be NULL, so this code
   // doesn't ASSERT and actually tests.
   if (pMain != NULL)
   {
      // Get the main window's menu
      CMenu *pMenu = pMain->GetMenu();

      // If there is a menu and it has items, we'll
      // delete the first one.
      if (pMenu != NULL && pMenu->GetMenuItemCount() > 0)
      {
         pMenu->DeleteMenu(0, MF_BYPOSITION);
         // force a redraw of the menu bar
         pMain->DrawMenuBar();
      }

      // No need to delete pMenu because it is an MFC
      // temporary object.
   }
}

CWnd::GetMenuBarInfoCWnd::GetMenuBarInfo

Извлекает информацию об указанном баре меню.Retrieves information about the specified menu bar.

BOOL GetMenuBarInfo(
    LONG idObject,
    LONG idItem,
    PMENUBARINFO pmbi) const;

ПараметрыParameters

idObjectidObject
Определяет объект меню.Specifies the menu object. Список возможных значений можно узнать на примере GetMenuBarInfo.For a list of possible values, see GetMenuBarInfo.

idItemidItem
Оповестите элемент, для которого можно получить информацию.Specifies the item for which to retrieve information. Если этот параметр равен нулю, функция получает информацию о самом меню.If this parameter is zero, the function retrieves information about the menu itself. Если этот параметр 1, функция получает информацию о первом элементе в меню и так далее.If this parameter is 1, the function retrieves information about the first item on the menu, and so on.

pmbipmbi
Указатель на структуру MENUBARINFO, которая получает информацию.Pointer to a MENUBARINFO structure that receives the information.

Возвращаемое значениеReturn Value

Nonzero, если функция успешно; в противном случае 0.Nonzero if the function succeeds; otherwise 0.

RemarksRemarks

Эта функция члена эмулирует функциональность функции GetMenuBarInfo, как описано в Windows SDK.This member function emulates the functionality of the function GetMenuBarInfo, as described in the Windows SDK.

CWnd::GetNextDlgGroupItemCWnd::GetNextDlgGroupItem

Поиск предыдущего или следующего элемента управления в группе элементов управления в диалоговом поле.Searches for the previous or next control within a group of controls in a dialog box.

CWnd* GetNextDlgGroupItem(
    CWnd* pWndCtl,
    BOOL bPrevious = FALSE) const;

COleControlSiteOrWnd* GetNextDlgGroupItem(
    COleControlSiteOrWnd* pCurSiteOrWnd = NULL) const;

ПараметрыParameters

pWndCtlpWndCtl
Определяет элемент управления, который будет использоваться в качестве отправной точки для поиска.Identifies the control to be used as the starting point for the search.

bПредыдущийbPrevious
Определяет, как функция заключается в поиске группы элементов управления в диалоговом поле.Specifies how the function is to search the group of controls in the dialog box. Если true, функция выполняет поиск предыдущего элемента управления в группе; если FALSE, он ищет следующий контроль в группе.If TRUE, the function searches for the previous control in the group; if FALSE, it searches for the next control in the group.

pCurSiteOrWndpCurSiteOrWnd
Идентифицирует COleControlSiteOrWnd элемент управления.Identifies the COleControlSiteOrWnd control. Для получения COleControlSiteOrWndдополнительной информации о , см. RemarksFor more information about COleControlSiteOrWnd, see Remarks.

Возвращаемое значениеReturn Value

Указать на предыдущий или следующий элемент управления в группе, если функция участника успешна.Pointer to the previous or next control in the group if the member function is successful.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Группа элементов управления начинается с элемента управления, созданного с WS_GROUP стилем, и заканчивается последним элементом управления, который не был создан с WS_GROUP стилем.A group of controls begins with a control that was created with the WS_GROUP style and ends with the last control that was not created with the WS_GROUP style.

По умолчанию GetNextDlgGroupItem функция участника возвращает указатель следующему элементу управления в группе.By default, the GetNextDlgGroupItem member function returns a pointer to the next control in the group. Если pWndCtl идентифицирует первый элемент управления в GetNextDlgGroupItem группе и bPrevious является правдой, возвращает указатель к последнему элементу управления в группе.If pWndCtl identifies the first control in the group and bPrevious is TRUE, GetNextDlgGroupItem returns a pointer to the last control in the group.

Note

Поскольку MFC поддерживает элементы управления ActiveX без окон, стандартные элементы управления ActiveX и окна, ссылаясь на элемент управления только HWND больше не хватает.Because MFC supports windowless ActiveX controls, standard ActiveX controls, and windows, referring to a control by only an HWND no longer suffices. Объект COleControlSiteOrWnd включает в себя информацию, которая идентифицирует объект как оконное управление ActiveX, управление ActiveX без окон или окно, следующим образом:The COleControlSiteOrWnd object includes information that identifies the object as a windowed ActiveX control, a windowless ActiveX control, or a window, as follows:

Тип управления или окнаControl or window type Идентификационная информацияIdentifying information
Управление ActiveX с окнамиWindowed ActiveX control Содержит HWND и связывает с ним объект COleControlSite.Contains an HWND and associates a COleControlSite object with it. Член m_hWnd COleControlSiteOrWnd устанавливается на HWND управления, и m_pSite член указывает на элемент COleControlSiteуправления .The m_hWnd member of COleControlSiteOrWnd is set to the HWND of the control, and the m_pSite member points to the control's COleControlSite.
Управление ActiveX без оконWindowless ActiveX control Не содержит HWND.Contains no HWND. Член m_pSite COleControlSiteOrWnd указывает на элемент COleControlSiteуправления, а m_hWnd член NULL.The m_pSite member of COleControlSiteOrWnd points to the control's COleControlSite, and the m_hWnd member is NULL.
Стандартное окноStandard window Содержит только HWND.Contains just an HWND. Участник m_hWnd COleControlSiteOrWnd устанавливается в HWND окна, а m_pSite участник NULL.The m_hWnd member of COleControlSiteOrWnd is set to the HWND of the window, and the m_pSite member is NULL.

CWnd::GetNextDlgTabItemCWnd::GetNextDlgTabItem

Извлекает указатель на первый элемент управления, который был создан с WS_TABSTOP стилем и который предшествует или следует указанному элементу управления.Retrieves a pointer to the first control that was created with the WS_TABSTOP style and that precedes or follows the specified control.

CWnd* GetNextDlgTabItem(
    CWnd* pWndCtl,
    BOOL bPrevious = FALSE) const;

COleControlSiteOrWnd* GetNextDlgTabItem(
    COleControlSiteOrWnd* pCurSiteOrWnd,
    BOOL bPrevious) const;

ПараметрыParameters

pWndCtlpWndCtl
Определяет элемент управления, который будет использоваться в качестве отправной точки для поиска.Identifies the control to be used as the starting point for the search.

pCurSiteOrWndpCurSiteOrWnd
Идентифицирует COleControlSiteOrWnd элемент управления.Identifies the COleControlSiteOrWnd control. Для получения COleControlSiteOrWndдополнительной информации о , см. CWnd::GetNextDlgGroupItem.For more information about COleControlSiteOrWnd, see CWnd::GetNextDlgGroupItem.

bПредыдущийbPrevious
Определяет, как функция заключается в поиске диалогового окна.Specifies how the function is to search the dialog box. Если true, функция выполняет поиск предыдущего элемента управления в диалоговом поле; если FALSE, он ищет следующий контроль.If TRUE, the function searches for the previous control in the dialog box; if FALSE, it searches for the next control.

Возвращаемое значениеReturn Value

Указать на предыдущий или следующий элемент управления, который имеет WS_TABSTOP стиль, если функция члена является успешной.Pointer to the previous or next control that has the WS_TABSTOP style, if the member function is successful.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

Для получения COleControlSiteOrWndдополнительной информации о , см. CWnd::GetNextDlgGroupItem.For more information about COleControlSiteOrWnd, see CWnd::GetNextDlgGroupItem.

CWnd::GetNextWindowCWnd::GetNextWindow

Поиск следующего (или предыдущего) окна в списке менеджера окон.Searches for the next (or previous) window in the window manager's list.

CWnd* GetNextWindow(UINT nFlag = GW_HWNDNEXT) const;

ПараметрыParameters

nФлагnFlag
Определяет, возвращает ли функция указатель в следующее окно или предыдущее окно.Specifies whether the function returns a pointer to the next window or the previous window. Это может быть либо GW_HWNDNEXT, который CWnd возвращает окно, которое следует за объектом в списке менеджера окна, либо GW_HWNDPREV, которое возвращает предыдущее окно в списке менеджера окон.It can be either GW_HWNDNEXT, which returns the window that follows the CWnd object on the window manager's list, or GW_HWNDPREV, which returns the previous window on the window manager's list.

Возвращаемое значениеReturn Value

Определяет следующее (или предыдущее) окно в списке менеджера окон, если функция участника успешна.Identifies the next (or the previous) window in the window manager's list if the member function is successful.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Список менеджера окон содержит записи для всех окон верхнего уровня, связанных с ними детских окон и детских окон любых детских окон.The window manager's list contains entries for all top-level windows, their associated child windows, and the child windows of any child windows.

Если CWnd это окно верхнего уровня, функция выполняет поиск следующего (или предыдущего) окна верхнего уровня; если CWnd это окно ребенка, функция выполняет поиск следующего (или предыдущего) окна ребенка.If CWnd is a top-level window, the function searches for the next (or previous) top-level window; if CWnd is a child window, the function searches for the next (or previous) child window.

CWnd::GetOleControlSiteCWnd::GetOleControlSite

Извлекает настраиваемый сайт для указанного элемента управления ActiveX.Retrieves the custom site for the specified ActiveX control.

COleControlSite* GetOleControlSite(UINT idControl) const;

ПараметрыParameters

idControlidControl
Идентификатор элемента управления ActiveX.The ID of the ActiveX control.

CWnd::GetOpenClipboardWindowCWnd::GetOpenClipboardWindow

Извлекает ручку окна, которая в настоящее время имеет Clipboard открытым.Retrieves the handle of the window that currently has the Clipboard open.

static CWnd* PASCAL GetOpenClipboardWindow();

Возвращаемое значениеReturn Value

Ручка окна, которая в настоящее время имеет Clipboard открыт, если функция является успешной; в противном случае NULL.The handle of the window that currently has the Clipboard open if the function is successful; otherwise NULL.

CWnd::GetOwnerCWnd::GetOwner

Получает указатель владельцу окна.Retrieves a pointer to the owner of the window.

CWnd* GetOwner() const;

Возвращаемое значениеReturn Value

Указатель на объект CWnd.A pointer to a CWnd object.

RemarksRemarks

Если в окне нет владельца, по умолчанию возвращается указатель на объект родительского окна.If the window has no owner, then a pointer to the parent window object is returned by default. Обратите внимание, что отношения между владельцем и владельцем отличается от родительского ребенка аспект в нескольких важных аспектах.Note that the relationship between the owner and the owned differs from the parent-child aspect in several important aspects. Например, окно с родителем ограничено областью клиента родительского окна.For example, a window with a parent is confined to its parent window's client area. Принадлежащие окна могут быть нарисованы в любом месте на рабочем столе.Owned windows can be drawn at any location on the desktop.

Концепция собственности этой функции отличается от концепции собственности GetWindow.The ownership concept of this function is different from the ownership concept of GetWindow.

CWnd::GetParentCWnd::GetParent

Вызов исправьте эту функцию, чтобы получить указатель на родительское окно детского окна (если таковой имеется).Call this function to get a pointer to a child window's parent window (if any).

CWnd* GetParent() const;

Возвращаемое значениеReturn Value

Смотрите раздел Значения возврата в GetParent в SDK Windows.See the Return Values section in GetParent in the Windows SDK.

RemarksRemarks

Функция GetParent возвращает указатель непосредственному родителю (если он существует).The GetParent function returns a pointer to the immediate parent (if it exists). В отличие от этого функция GetParentOwner возвращает указатель в самое непосредственное окно родителя или владельца, которое не является окном ребенка (не имеет WS_CHILD стиля).In contrast, the GetParentOwner function returns a pointer to the most immediate parent or owner window that is not a child window (does not have the WS_CHILD style). Если у вас есть детское GetParent GetParentOwner окно в окне ребенка и вернуть различные результаты.If you have a child window within a child window GetParent and GetParentOwner return different results.

CWnd::GetParentFrameCWnd::GetParentFrame

Вызов эту функцию участника для получения окна родительской рамы.Call this member function to retrieve the parent frame window.

CFrameWnd* GetParentFrame() const;

Возвращаемое значениеReturn Value

Указатель на окно рамы в случае успеха; в противном случае NULL.A pointer to a frame window if successful; otherwise NULL.

RemarksRemarks

Функция участника выполняет поиск родительской цепи до тех пор, пока не будет найден объект CFrameWnd (или производный класс).The member function searches up the parent chain until a CFrameWnd (or derived class) object is found.

CWnd:GetParentВладелецCWnd::GetParentOwner

Позвоните в эту функцию участника, чтобы получить указатель на родительское окно или окно владельца детского окна.Call this member function to get a pointer to a child window's parent window or owner window.

CWnd* GetParentOwner() const;

Возвращаемое значениеReturn Value

Указатель на объект CWnd.A pointer to a CWnd object. Если объект CWnd не прикреплен к дескриптору, создается и прикрепляется временный объект CWnd.If a CWnd object is not attached to the handle, a temporary CWnd object is created and attached. Указатель может быть временным. Его не требуется сохранять для дальнейшего использования.The pointer may be temporary and should not be stored for later use.

RemarksRemarks

GetParentOwnerвозвращает указатель на самое непосредственное окно родителя или владельца, которое не является окном ребенка (не имеет WS_CHILD стиля).GetParentOwner returns a pointer to the most immediate parent or owner window that is not a child window (does not have the WS_CHILD style). Текущее окно владельца можно установить с помощью SetOwner.The current owner window can be set with SetOwner. По умолчанию родительским окном является его владелец.By default, the parent of a window is its owner.

В отличие от этого функция GetParent возвращает указатель непосредственному родителю, независимо от того, является ли это окном ребенка или нет.In contrast, the GetParent function returns a pointer to the immediate parent, whether it is a child window or not. Если у вас есть детское GetParent GetParentOwner окно в окне ребенка и вернуть различные результаты.If you have a child window within a child window GetParent and GetParentOwner return different results.

CWnd::GetPropertyCWnd::GetProperty

Позвоните в эту функцию участника, чтобы получить свойство управления ActiveX, указанное dwDispID.Call this member function to get the ActiveX control property specified by dwDispID.

void GetProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    void* pvProp)const;

ПараметрыParameters

dwDispIDdwDispID
Идентифицирует свойство, подносяе извлечению.Identifies the property to be retrieved.

vtPropvtProp
Упогоняет тип извлечения свойства.Specifies the type of the property to be retrieved. Возможные значения см. в подразделе "Примечания" раздела COleDispatchDriver::InvokeHelper.For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.

pvProppvProp
Адрес переменной, которая получит стоимость свойства.Address of the variable that will that will receive the property value. Он должен соответствовать типу, указанному vtProp.It must match the type specified by vtProp.

RemarksRemarks

GetPropertyвозвращает значение через pvProp.GetProperty returns the value through pvProp.

Note

Эта функция должна вызываться CWnd только на объекте, который представляет элемент управления ActiveX.This function should be called only on a CWnd object that represents an ActiveX control.

Для получения дополнительной информации об использовании этой функции ActiveX Control Containers: Programming ActiveX Controls in an ActiveX Control Containerучастника с помощью контейнеров ActiveX Control, см.For more information about using this member function with ActiveX Control Containers, see the article ActiveX Control Containers: Programming ActiveX Controls in an ActiveX Control Container.

CWnd::GetRenderTargetCWnd::GetRenderTarget

Возвращает целевой объект отрисовки, связанный с данным окном.Gets a render target that is associated with this window.

CHwndRenderTarget* GetRenderTarget();

Возвращаемое значениеReturn Value

Указатель на цель рендера или NULL.Pointer to the render target or NULL.

CWnd::GetSafeHwndCWnd::GetSafeHwnd

Возвращает m_hWnd, или NULL, если этот указатель NULL.Returns m_hWnd, or NULL if the this pointer is NULL.

HWND GetSafeHwnd() const;

Возвращаемое значениеReturn Value

Возвращает ручку окна для окна.Returns the window handle for a window. Возвращает NULL, CWnd если он не прикреплен к окну или CWnd если он используется с указателем NULL.Returns NULL if the CWnd is not attached to a window or if it is used with a NULL CWnd pointer.

ПримерExample

Смотрите пример CWnd::SubclassWindow.See the example for CWnd::SubclassWindow.

CWnd:GetSafeOwnerCWnd::GetSafeOwner

Вызов эту функцию участника, чтобы получить окно владельца, которое должно быть использовано для диалоговые окна или другие модальные окна.Call this member function to retrieve the owner window that should be used for dialog boxes or other modal windows.

static CWnd* GetSafeOwner(
    CWnd* pParent = NULL,
    HWND* pWndTop = NULL);

ПараметрыParameters

pРодительpParent
Указатель на родительское CWnd окно.A pointer to a parent CWnd window. Может иметь значение "NULL".May be NULL.

pWndToppWndTop
Указатель на окно, которое в настоящее время находится на вершине.A pointer to the window that is currently on top. Может иметь значение "NULL".May be NULL.

Возвращаемое значениеReturn Value

Указатель на безопасного владельца для данного окна.A pointer to the safe owner for the given window.

RemarksRemarks

Безопасный владелец является первым не-ребенок родителей окно pParent.The safe owner is the first non-child parent window of pParent. Если pParent является NULL, основное окно потока (извлеченное через AfxGetMainWnd)используется для поиска владельца.If pParent is NULL, the thread's main window (retrieved via AfxGetMainWnd) is used to find an owner.

Note

Сама система использует эту функцию для определения правильного окна владельца для диалоговых коробок и листов свойств, где владелец не указан.The framework itself uses this function to determine the correct owner window for dialog boxes and property sheets where the owner is not specified.

CWnd:GetScrollBarCtrlCWnd::GetScrollBarCtrl

Позвоните в эту функцию участника, чтобы получить указатель на указанный бар прокрутки брата или окно сплиттера.Call this member function to obtain a pointer to the specified sibling scroll bar or splitter window.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

ПараметрыParameters

nБарnBar
Определяет тип панели прокрутки.Specifies the type of scroll bar. Параметр может принимать одно из следующих значений:The parameter can take one of the following values:

  • SB_HORZ извлекает положение горизонтальной панели прокрутки.SB_HORZ Retrieves the position of the horizontal scroll bar.

  • SB_VERT извлекает положение вертикальной полосы прокрутки.SB_VERT Retrieves the position of the vertical scroll bar.

Возвращаемое значениеReturn Value

Брат управления прокруткой, или NULL, если нет.A sibling scroll-bar control, or NULL if none.

RemarksRemarks

Эта функция участника не работает на барах прокрутки, созданных при установке WS_HSCROLL или WS_VSCROLL битов при создании окна.This member function does not operate on scroll bars created when the WS_HSCROLL or WS_VSCROLL bits are set during the creation of a window. Реализация CWnd этой функции просто возвращает NULL.The CWnd implementation of this function simply returns NULL. Выведенные классы, CViewтакие как, реализуют описанную функциональность.Derived classes, such as CView, implement the described functionality.

CWnd::GetScrollBarInfoCWnd::GetScrollBarInfo

Извлекает сведения об указанной полосе прокрутки.Retrieves information about the specified scroll bar.

BOOL GetScrollBarInfo(
    LONG idObject,
    PSCROLLBARINFO psbi) const;

ПараметрыParameters

idObjectidObject
Определяет объект меню.Specifies the menu object. Список возможных значений можно узнать на примере GetScrollBarInfo.For a list of possible values, see GetScrollBarInfo.

psbipsbi
Указатель на структуру SCROLLBARINFO, которая получает информацию.Pointer to a SCROLLBARINFO structure that receives the information.

Возвращаемое значениеReturn Value

Nonzero, если функция успешно; в противном случае 0.Nonzero if the function succeeds; otherwise 0.

RemarksRemarks

Эта функция члена эмулирует функциональность функции GetScrollBarInfo, как описано в Windows SDK.This member function emulates the functionality of the function GetScrollBarInfo, as described in the Windows SDK.

CWnd::GetScrollInfoCWnd::GetScrollInfo

Вызовите эту функцию участника, SCROLLINFO чтобы получить информацию, которую структура поддерживает о панели прокрутки.Call this member function to retrieve the information that the SCROLLINFO structure maintains about a scroll bar.

BOOL GetScrollInfo(
    int nBar,
    LPSCROLLINFO lpScrollInfo,
    UINT nMask = SIF_ALL);

ПараметрыParameters

nБарnBar
Определяет, является ли панель прокрутки элементом управления или частью области неклиента окна.Specifies whether the scroll bar is a control or part of a window's nonclient area. Если он является частью области неклиента, nBar также указывает, находится ли панель прокрутки горизонтально, вертикально или и то, и другое.If it is part of the nonclient area, nBar also indicates whether the scroll bar is positioned horizontally, vertically, or both. Она должна быть одной из следующих:It must be one of the following:

  • SB_CTL извлекает параметры для управления полосой прокрутки.SB_CTL Retrieves the parameters for a scroll bar control. Член m_hWnd данных должен быть ручкой управления панелью прокрутки.The m_hWnd data member must be the handle of the scroll bar control.

  • SB_HORZ извлекает параметры для стандартной горизонтальной панели прокрутки окна.SB_HORZ Retrieves the parameters for the window's standard horizontal scroll bar.

  • SB_VERT извлекает параметры для стандартной вертикальной панели прокрутки окна.SB_VERT Retrieves the parameters for the window's standard vertical scroll bar.

lpScrollInfolpScrollInfo
Указатель на структуру SCROLLINFO.A pointer to a SCROLLINFO structure. Дополнительную информацию об этой структуре можно узнать в SDK Windows.See the Windows SDK for more information about this structure.

nМаскnMask
Определяет параметры панели прокрутки для извлечения.Specifies the scroll bar parameters to retrieve. По умолчанию определяется комбинация SIF_PAGE, SIF_POS, SIF_TRACKPOS и SIF_RANGE.The default specifies a combination of SIF_PAGE, SIF_POS, SIF_TRACKPOS, and SIF_RANGE. Дополнительную информацию о значениях SCROLLINFO nMask смотрите.See SCROLLINFO for more information on the nMask values.

Возвращаемое значениеReturn Value

Если сообщение извлекает какие-либо значения, возврат является правдой.If the message retrieved any values, the return is TRUE. В противном случае, это FALSE.Otherwise, it is FALSE.

RemarksRemarks

GetScrollInfoпозволяет приложениям использовать 32-битные позиции прокрутки.GetScrollInfo enables applications to use 32-bit scroll positions.

Структура SCROLLINFO содержит информацию о панели прокрутки, включая минимальное и максимальное положение прокрутки, размер страницы и положение окна прокрутки (большой палец).The SCROLLINFO structure contains information about a scroll bar, including the minimum and maximum scrolling positions, the page size, and the position of the scroll box (the thumb). Подробнее SCROLLINFO об изменении структуры по умолчанию можно просмотреть тему структуры в SDK Windows SDK.See the SCROLLINFO structure topic in the Windows SDK for more information about changing the structure defaults.

Обработчики сообщений MFC Windows, указывающие положение прокрутки-бар, CWnd::OnHScroll и CWnd::OnVScroll,предоставляют только 16 бит данных о положении.The MFC Windows message handlers that indicate scroll-bar position, CWnd::OnHScroll and CWnd::OnVScroll, provide only 16 bits of position data. GetScrollInfoи SetScrollInfo предоставить 32 бита данных о положении прокрутки-бара.GetScrollInfo and SetScrollInfo provide 32 bits of scroll-bar position data. Таким образом, приложение GetScrollInfo может CWnd::OnHScroll звонить CWnd::OnVScroll при обработке либо или для получения 32-битных данных положения прокрутки.бара.Thus, an application can call GetScrollInfo while processing either CWnd::OnHScroll or CWnd::OnVScroll to obtain 32-bit scroll-bar position data.

CWnd::GetScrollLimitCWnd::GetScrollLimit

Вызов исчерпе эту функцию участника, чтобы получить максимальное положение прокрутки панели прокрутки.Call this member function to retrieve the maximum scrolling position of the scroll bar.

int GetScrollLimit(int nBar);

ПараметрыParameters

nБарnBar
Определяет тип панели прокрутки.Specifies the type of scroll bar. Параметр может принимать одно из следующих значений:The parameter can take one of the following values:

  • SB_HORZ извлекает предел прокрутки горизонтальной панели прокрутки.SB_HORZ Retrieves the scroll limit of the horizontal scroll bar.

  • SB_VERT извлекает предел прокрутки вертикальной панели прокрутки.SB_VERT Retrieves the scroll limit of the vertical scroll bar.

Возвращаемое значениеReturn Value

Определяет максимальное положение панели прокрутки в случае успеха; в противном случае 0.Specifies the maximum position of a scroll bar if successful; otherwise 0.

CWnd::GetScrollPosCWnd::GetScrollPos

Извлекает текущее положение окна прокрутки панели прокрутки.Retrieves the current position of the scroll box of a scroll bar.

int GetScrollPos(int nBar) const;

ПараметрыParameters

nБарnBar
Определяет бар прокрутки для изучения.Specifies the scroll bar to examine. Параметр может принимать одно из следующих значений:The parameter can take one of the following values:

  • SB_HORZ извлекает положение горизонтальной панели прокрутки.SB_HORZ Retrieves the position of the horizontal scroll bar.

  • SB_VERT извлекает положение вертикальной полосы прокрутки.SB_VERT Retrieves the position of the vertical scroll bar.

Возвращаемое значениеReturn Value

Определяет текущее положение окна прокрутки в панели прокрутки в случае успеха; в противном случае 0.Specifies the current position of the scroll box in the scroll bar if successful; otherwise 0.

RemarksRemarks

Текущее значение — это относительное значение, которое зависит от текущего диапазона прокрутки.The current position is a relative value that depends on the current scrolling range. Например, если диапазон прокрутки составляет от 50 до 100, а поле прокрутки находится в середине бара, текущее положение — 75.For example, if the scrolling range is 50 to 100 and the scroll box is in the middle of the bar, the current position is 75.

CWnd::GetScrollRangeCWnd::GetScrollRange

Копирует текущие минимальные и максимальные позиции панели прокрутки для данной панели прокрутки в места, указанные lpMinPos и lpMaxPos.Copies the current minimum and maximum scroll-bar positions for the given scroll bar to the locations specified by lpMinPos and lpMaxPos.

void GetScrollRange(
    int nBar,
    LPINT lpMinPos,
    LPINT lpMaxPos) const;

ПараметрыParameters

nБарnBar
Определяет бар прокрутки для изучения.Specifies the scroll bar to examine. Параметр может принимать одно из следующих значений:The parameter can take one of the following values:

  • SB_HORZ извлекает положение горизонтальной панели прокрутки.SB_HORZ Retrieves the position of the horizontal scroll bar.

  • SB_VERT извлекает положение вертикальной полосы прокрутки.SB_VERT Retrieves the position of the vertical scroll bar.

lpMinPoslpMinPos
Указывает на рядпеременную переменную, которая должна получить минимальную позицию.Points to the integer variable that is to receive the minimum position.

lpMaxPoslpMaxPos
Указывает на рядпеременную переменную, которая должна получить максимальную позицию.Points to the integer variable that is to receive the maximum position.

RemarksRemarks

Если CWnd нет панели прокрутки, то функция GetScrollRange участника копирует 0 к lpMinPos и lpMaxPos.If CWnd does not have a scroll bar, then the GetScrollRange member function copies 0 to lpMinPos and lpMaxPos.

Диапазон по умолчанию для стандартной панели прокрутки составляет от 0 до 100.The default range for a standard scroll bar is 0 to 100. Диапазон по умолчанию для управления прокруткой является пустым (оба значения 0).The default range for a scroll-bar control is empty (both values are 0).

CWnd::GetStyleCWnd::GetStyle

Возвращает стиль текущего окна.Returns the current window style.

DWORD GetStyle() const;

Возвращаемое значениеReturn Value

Стиль окна.The window's style. Для получения дополнительной информации о стилях окон, используемых в MFC, см.For more information about the window styles used in MFC, see Window Styles.

CWnd::GetSystemMenuCWnd::GetSystemMenu

Позволяет приложению получить доступ к оконному меню для копирования и изменения.Allows the application to access the Control menu for copying and modification.

CMenu* GetSystemMenu(BOOL bRevert) const;

ПараметрыParameters

bRevertbRevert
Определяется, что необходимо принять меры.Specifies the action to be taken. Если bRevert является GetSystemMenu FALSE, возвращает ручку в копию меню Управления, которая используется в настоящее время.If bRevert is FALSE, GetSystemMenu returns a handle to a copy of the Control menu currently in use. Эта копия изначально идентична меню Управления, но может быть изменена.This copy is initially identical to the Control menu but can be modified. Если bRevert является GetSystemMenu правдой, сброс меню управления обратно в состояние по умолчанию.If bRevert is TRUE, GetSystemMenu resets the Control menu back to the default state. Предыдущее, возможно измененное меню управления, если такого имеется, уничтожено.The previous, possibly modified, Control menu, if any, is destroyed. Значение возврата в этом случае не определено.The return value is undefined in this case.

Возвращаемое значениеReturn Value

Определяет копию меню Управления, если bRevert является FALSE.Identifies a copy of the Control menu if bRevert is FALSE. Если bRevert является правдой, значение возврата не определено.If bRevert is TRUE, the return value is undefined.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Любое окно, GetSystemMenu которое не используется для изготовления собственной копии меню Control, получает стандартное меню Control.Any window that does not use GetSystemMenu to make its own copy of the Control menu receives the standard Control menu.

Указатель, возвращенный GetSystemMenu функцией участника, можно использовать с помощью CMenu::AppendMenu, CMenu::InsertMenu, или CMenu::ModifyMenu функции для изменения меню управления.The pointer returned by the GetSystemMenu member function can be used with the CMenu::AppendMenu, CMenu::InsertMenu, or CMenu::ModifyMenu functions to change the Control menu.

Меню управления изначально содержит элементы, отождествляемые с различными значениями идентификатора, такие как SC_CLOSE, SC_MOVE и SC_SIZE.The Control menu initially contains items identified with various ID values such as SC_CLOSE, SC_MOVE, and SC_SIZE. Элементы меню Управления генерируют WM_SYSCOMMAND сообщений.Items on the Control menu generate WM_SYSCOMMAND messages. Все предопределенные элементы Control-menu имеют идентификационные номера, превышающее 0xF000.All predefined Control-menu items have ID numbers greater than 0xF000. Если приложение добавляет элементы в меню Управления, оно должно использовать идентификационные номера меньше F000.If an application adds items to the Control menu, it should use ID numbers less than F000.

Windows может автоматически сделать элементы недоступными в стандартном меню управления.Windows may automatically make items unavailable on the standard Control menu. CWndможет осуществлять свой собственный выбор или недоступность, отвечая на WM_INITMENU сообщения, которые отправляются до отображения любого меню.CWnd can carry out its own selection or unavailability by responding to the WM_INITMENU messages, which are sent before any menu is displayed.

ПримерExample

// The following code fragment is taken from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog

// Add "About..." menu item to system menu.

// IDM_ABOUTBOX must be in the system command range.
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);

CMenu *pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
   CString strAboutMenu;
   strAboutMenu.LoadString(IDS_ABOUT);
   if (!strAboutMenu.IsEmpty())
   {
      pSysMenu->AppendMenu(MF_SEPARATOR);
      pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
   }
}

// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE);  // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon

CWnd::GetTitleBarInfoCWnd::GetTitleBarInfo

Извлекает сведения об указанной строке заголовка.Retrieves information about the specified title bar.

BOOL GetTitleBarInfo(PTITLEBARINFO pti) const;

ПараметрыParameters

Ptipti
Указатель на структуру TITLEBARINFO, которая получает информацию.Pointer to a TITLEBARINFO structure that receives the information.

RemarksRemarks

Эта функция члена эмулирует функциональность функции GetTitleBarInfo, как описано в Windows SDK.This member function emulates the functionality of the function GetTitleBarInfo, as described in the Windows SDK.

CWnd::GetTopLevelFrameCWnd::GetTopLevelFrame

Вызов эту функцию участника, чтобы получить окно верхнего уровня окна окна, если таковые имеется.Call this member function to retrieve the window's top level frame window, if any.

CFrameWnd* GetTopLevelFrame() const;

Возвращаемое значениеReturn Value

Идентифицирует окно верхнего уровня кадра окна.Identifies the top-level frame window of the window.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Если CWnd нет прикрепленного окна, или его родитель верхнего уровня не является объектом CFrameWnd,эта функция возвращает NULL.If CWnd has no attached window, or its top-level parent is not a CFrameWnd-derived object, this function returns NULL.

CWnd::GetTopLevelOwnerCWnd::GetTopLevelOwner

Вызов этой функции участника для получения окна верхнего уровня.Call this member function to retrieve the top-level window.

CWnd* GetTopLevelOwner() const;

Возвращаемое значениеReturn Value

Идентифицирует окно верхнего уровня.Identifies the top-level window. Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Окно верхнего уровня — это окно, которое является ребенком рабочего стола.The top-level window is the window that is a child of the desktop. Если CWnd нет прикрепленного окна, эта функция возвращает NULL.If CWnd has no attached window, this function returns NULL.

CWnd::GetTopLevelParentCWnd::GetTopLevelParent

Вызов исвызывайте эту функцию участника, чтобы получить родительский штаб окна верхнего уровня.Call this member function to retrieve the window's top-level parent.

CWnd* GetTopLevelParent() const;

Возвращаемое значениеReturn Value

Идентифицирует родительское окно верхнего уровня.Identifies the top-level parent window of the window.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

GetTopLevelParentпохож на GetTopLevelFrame и GetTopLevelOwner; однако он игнорирует значение, установленное в качестве текущего окна владельца.GetTopLevelParent is similar to GetTopLevelFrame and GetTopLevelOwner; however, it ignores the value set as the current owner window.

CWnd::GetTopWindowCWnd::GetTopWindow

Поиск исправок для окна ребенка верхнего уровня, которое принадлежит CWnd.Searches for the top-level child window that belongs to CWnd.

CWnd* GetTopWindow() const;

Возвращаемое значениеReturn Value

Идентифицирует окно ребенка верхнего CWnd уровня в связанном списке детских окон.Identifies the top-level child window in a CWnd linked list of child windows. Если не существует детских окон, значение NULL.If no child windows exist, the value is NULL.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

RemarksRemarks

Если CWnd нет детей, эта функция возвращает NULL.If CWnd has no children, this function returns NULL.

CWnd::GetUpdateRectCWnd::GetUpdateRect

Извлекает координаты наименьшего прямоугольника, который полностью закрывает область обновления.Retrieves the coordinates of the smallest rectangle that completely encloses the update region.

BOOL GetUpdateRect(
    LPRECT lpRect,
    BOOL bErase = FALSE);

ПараметрыParameters

lpRectlpRect
Указывает на CRect объект или структуру RECT, которая должна получать координаты клиента обновления, которое заключает область обновления.Points to a CRect object or RECT structure that is to receive the client coordinates of the update that encloses the update region.

Установите этот параметр в NULL, чтобы CWndопределить, существует ли область обновления в пределах .Set this parameter to NULL to determine whether an update region exists within the CWnd. Если lpRect является GetUpdateRect NULL, функция участника возвращается ненулевой, если область обновления существует, и 0, если она не существует.If lpRect is NULL, the GetUpdateRect member function returns nonzero if an update region exists and 0 if one does not. Это позволяет определить, является ли сообщение WM_PAINT получено из недействительной области.This provides a way to determine whether a WM_PAINT message resulted from an invalid area. Не устанавливайте этот параметр в NULL в версии Windows 3.0 и ранее.Do not set this parameter to NULL in Windows version 3.0 and earlier.

bErasebErase
Определяется, следует ли стирать фон в области обновления.Specifies whether the background in the update region is to be erased.

Возвращаемое значениеReturn Value

Определяет состояние региона обновления.Specifies the status of the update region. Значение ненулевое, если область обновления не пуста; в противном случае 0.The value is nonzero if the update region is not empty; otherwise 0.

Если параметр lpRect установлен на NULL, значение возврата является ненулевым, если существует область обновления; в противном случае 0.If the lpRect parameter is set to NULL, the return value is nonzero if an update region exists; otherwise 0.

RemarksRemarks

Если CWnd он был создан с CS_OWNDC стилем и GetUpdateRect режим отображения не MM_TEXT, функция члена дает прямоугольник в логических координатах.If CWnd was created with the CS_OWNDC style and the mapping mode is not MM_TEXT, the GetUpdateRect member function gives the rectangle in logical coordinates. В GetUpdateRect противном случае, дает прямоугольник в координатах клиента.Otherwise, GetUpdateRect gives the rectangle in client coordinates. Если нет области обновления, GetUpdateRect устанавливает прямоугольник, чтобы быть пустым (устанавливает все координаты до 0).If there is no update region, GetUpdateRect sets the rectangle to be empty (sets all coordinates to 0).

Параметр bErase определяет, GetUpdateRect следует ли стирать фон области обновления.The bErase parameter specifies whether GetUpdateRect should erase the background of the update region. Если bErase является правдой и область обновления не пуста, фон стирается.If bErase is TRUE and the update region is not empty, the background is erased. Чтобы удалить фон, GetUpdateRect отправляет сообщение WM_ERASEBKGND.To erase the background, GetUpdateRect sends the WM_ERASEBKGND message.

Прямоугольник обновления, извлеченный функцией участника BeginPaint, идентичен тому, который был получен функцией GetUpdateRect участника.The update rectangle retrieved by the BeginPaint member function is identical to that retrieved by the GetUpdateRect member function.

Функция BeginPaint участника автоматически проверяет область обновления, поэтому GetUpdateRect любой вызов, BeginPaint сделанный сразу после вызова, получает пустой регион обновления.The BeginPaint member function automatically validates the update region, so any call to GetUpdateRect made immediately after a call to BeginPaint retrieves an empty update region.

CWnd::GetUpdateRgnCWnd::GetUpdateRgn

Извлекает область обновления в область, идентифицированную pRgn.Retrieves the update region into a region identified by pRgn.

int GetUpdateRgn(
    CRgn* pRgn,
    BOOL bErase = FALSE);

ПараметрыParameters

pRgnpRgn
Идентифицирует область обновления.Identifies the update region.

bErasebErase
Уточняется, будет ли стерт фон и будут нарисованы неклиентские области детских окон.Specifies whether the background will be erased and nonclient areas of child windows will be drawn. Если значение FALSE, рисунок не выполняется.If the value is FALSE, no drawing is done.

Возвращаемое значениеReturn Value

Опознавательный флаг с коротким рядом, указывающий тип полученной области.Specifies a short-integer flag that indicates the type of resulting region. Значение может принять любое из следующих:The value can take any one of the following:

  • SIMPLEREGION Регион не имеет перекрывающихся границ.SIMPLEREGION The region has no overlapping borders.

  • COMPLEXREGION Регион имеет перекрывающиеся границы.COMPLEXREGION The region has overlapping borders.

  • НУЛРЕГИОН Регион пуст.NULLREGION The region is empty.

  • ERROR Не создан регион.ERROR No region was created.

RemarksRemarks

Координаты этого региона относительно верхнего левого угла (координаты клиента).The coordinates of this region are relative to the upper-left corner (client coordinates).

Функция участника BeginPaint автоматически проверяет область обновления, GetUpdateRgn поэтому любой вызов, сделанный сразу после вызова, BeginPaint получает пустую область обновления.The BeginPaint member function automatically validates the update region, so any call to GetUpdateRgn made immediately after a call to BeginPaint retrieves an empty update region.

CWnd::GetWindowCWnd::GetWindow

Возвращает указатель в запрашиваемый окно или NULL, если его нет.Returns a pointer to the window requested, or NULL if none.

CWnd* GetWindow(UINT nCmd) const;

ПараметрыParameters

nCmdnCmd
Определяет связь между CWnd и возвращенное окно.Specifies the relationship between CWnd and the returned window. Это может занять одно из следующих значений:It can take one of the following values:

  • GW_CHILD идентифицирует CWnd окно первого ребенка.GW_CHILD Identifies the CWnd first child window.

  • GW_HWNDFIRST CWnd Если это окно ребенка, возвращает первое окно брата.GW_HWNDFIRST If CWnd is a child window, returns the first sibling window. В противном случае он возвращает первое окно верхнего уровня в списке.Otherwise, it returns the first top-level window in the list.

  • GW_HWNDLAST CWnd Если это окно ребенка, возвращает последнее окно брата.GW_HWNDLAST If CWnd is a child window, returns the last sibling window. В противном случае он возвращает последнее окно верхнего уровня в списке.Otherwise, it returns the last top-level window in the list.

  • GW_HWNDNEXT возвращает следующее окно в списке менеджера окон.GW_HWNDNEXT Returns the next window on the window manager's list.

  • GW_HWNDPREV возвращает предыдущее окно в списке менеджера окон.GW_HWNDPREV Returns the previous window on the window manager's list.

  • GW_OWNER идентифицирует CWnd владельца.GW_OWNER Identifies the CWnd owner.

Возвращаемое значениеReturn Value

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use.

CWnd::GetWindowContextHelpIdCWnd::GetWindowContextHelpId

Вызовите эту функцию участника, чтобы получить идентификатор контекста справки, если таков, связанный с окном.Call this member function to retrieve the help context identifier, if any, associated with the window.

DWORD GetWindowContextHelpId() const;

Возвращаемое значениеReturn Value

Идентификатор контекста справки.The help context identifier. Возвращает 0, если окно не имеет.Returns 0 if the window has none.

CWnd::GetWindowedChildCountCWnd::GetWindowedChildCount

Вызов исчисляйте эту функцию участника, чтобы получить число связанных с ней окон ребенка.Call this member function to retrieve the number of associated child windows.

long GetWindowedChildCount();

Возвращаемое значениеReturn Value

Количество детских окон, CWnd связанных с объектом.The number of child windows associated with the CWnd object.

CWnd::GetWindowDCCWnd::GetWindowDC

Извлекает контекст отображения для всего окна, включая панель подписей, меню и прокрутки баров.Retrieves the display context for the entire window, including caption bar, menus, and scroll bars.

CDC* GetWindowDC();

Возвращаемое значениеReturn Value

Определяет контекст отображения для данного окна, если функция успешна; в противном случае NULL.Identifies the display context for the given window if the function is successful; otherwise NULL.

Возвращенный указатель может быть временным и не должен храниться для последующего использования.The returned pointer may be temporary and should not be stored for later use. ReleaseDC следует вызывать один раз GetWindowDCдля каждого успешного вызова.ReleaseDC should be called once for each successful call to GetWindowDC.

RemarksRemarks

Контекст отображения CWndокна позволяет рисовать в любом месте, CWnd так как происхождение контекста является верхним левым углом вместо области клиента.A window display context permits painting anywhere in CWnd, since the origin of the context is the upper-left corner of CWnd instead of the client area.

Атрибуты по умолчанию присваиваются контексту отображения каждый раз, когда он извлекает контекст.Default attributes are assigned to the display context each time it retrieves the context. Предыдущие атрибуты теряются.Previous attributes are lost.

GetWindowDCпредназначен для использования для специальных CWnd эффектов живописи в области неклиента.GetWindowDC is intended to be used for special painting effects within the CWnd nonclient area. Картина в неклиентских зонах любого окна не рекомендуется.Painting in nonclient areas of any window is not recommended.

Функция GetSystemMetrics Windows может использоваться для получения размеров различных частей области неклиента, таких как панель заголовков, меню и прокрутки баров.The GetSystemMetrics Windows function can be used to retrieve the dimensions of various parts of the nonclient area, such as the caption bar, menu, and scroll bars.

После завершения картины функция участника ReleaseDC должна быть вызвана для выпуска контекста отображения.After painting is complete, the ReleaseDC member function must be called to release the display context. Непредоставление контекста дисплея серьезно скажется на картине, запрошенной приложениями, из-за ограничений на количество контекстов устройств, которые могут быть открыты одновременно.Failure to release the display context will seriously affect painting requested by applications due to limitations on the number of device contexts that can be open at the same time.

CWnd::GetWindowInfoCWnd::GetWindowInfo

Извлекает информацию о окне.Retrieves information about the window.

BOOL GetWindowInfo(PWINDOWINFO pwi) const;

ПараметрыParameters

Pwipwi
Указатель на структуру WINDOWINFO.A pointer to a WINDOWINFO structure.

RemarksRemarks

Эта функция члена эмулирует функциональность функции GetWindowInfo, как описано в Windows SDK.This member function emulates the functionality of the function GetWindowInfo, as described in the Windows SDK.

CWnd::GetWindowlessChildCountCWnd::GetWindowlessChildCount

Извлекает количество связанных окон без окон.Retrieves the number of associated windowless child windows.

long GetWindowlessChildCount();

Возвращаемое значениеReturn Value

Количество оконных детских окон, CWnd связанных с объектом.The number of windowless child windows associated with the CWnd object.

CWnd::GetWindowPlacementCWnd::GetWindowPlacement

Получает состояние отображения, а также обычное (восстановленное), свернутое и развернутое состояния окна.Retrieves the show state and the normal (restored), minimized, and maximized positions of a window.

BOOL GetWindowPlacement(WINDOWPLACEMENT* lpwndpl) const;

ПараметрыParameters

lpwndpllpwndpl
Указывает на WINDOWPLACEMENT структуру, которая получает информацию о состоянии и положении шоу.Points to the WINDOWPLACEMENT structure that receives the show state and position information.

Возвращаемое значениеReturn Value

Ненулевое значение, если функция выполнена успешно; в противном случае — 0.Nonzero if the function is successful; otherwise 0.

RemarksRemarks

Член flags структуры WINDOWPLACEMENT, извлеченный этой функцией, всегда 0.The flags member of the WINDOWPLACEMENT structure retrieved by this function is always 0. Если CWnd максимизируется, showCmd WINDOWPLACEMENT член является SW_SHOWMAXIMIZED.If CWnd is maximized, the showCmd member of WINDOWPLACEMENT is SW_SHOWMAXIMIZED. Если окно сведено к минимуму, это SW_SHOWMINIMIZED.If the window is minimized, it is SW_SHOWMINIMIZED. Это SW_SHOWNORMAL иначе.It is SW_SHOWNORMAL otherwise.

CWnd::GetWindowRectCWnd::GetWindowRect

Копирует размеры ограничивающего прямоугольника CWnd объекта к структуре, на которую указывает lpRect.Copies the dimensions of the bounding rectangle of the CWnd object to the structure pointed to by lpRect.

void GetWindowRect(LPRECT lpRect) const;

ПараметрыParameters

lpRectlpRect
Указывает на CRect объект или структуру RECT, которая получит координаты экрана в верхнем левом и нижнем правом углах.Points to a CRect object or a RECT structure that will receive the screen coordinates of the upper-left and lower-right corners.

RemarksRemarks

Размеры приведены в координатах экрана относительно верхнего левого угла экрана.The dimensions are given in screen coordinates relative to the upper-left corner of the display screen. Включены размеры баров заголовка, границы и прокрутки, если они присутствуют.The dimensions of the caption, border, and scroll bars, if present, are included.

CWnd::GetWindowRgnCWnd::GetWindowRgn

Вызовите эту функцию участника, чтобы получить область окна окна.Call this member function to get the window region of a window.

int GetWindowRgn(HRGN hRgn)const;

ПараметрыParameters

hRgnhRgn
Ручка к оконной области.A handle to a window region.

Возвращаемое значениеReturn Value

Значение возврата определяет тип региона, получаемого функцией.The return value specifies the type of the region that the function obtains. Может иметь одно из следующих значений.It can be one of the following values:

  • НУЛРЕГИОН Регион пуст.NULLREGION The region is empty.

  • SIMPLEREGION Регион представляет собой единый прямоугольник.SIMPLEREGION The region is a single rectangle.

  • COMPLEXREGION Регион является более чем одним прямоугольником.COMPLEXREGION The region is more than one rectangle.

  • ERROR Произошла ошибка; регион не пострадал.ERROR An error occurred; the region is unaffected.

RemarksRemarks

Область окна определяет область в окне, где операционная система разрешает рисование.The window region determines the area within the window where the operating system permits drawing. Операционная система не отображает какую-либо часть окна, которая находится за пределами области окна.The operating system does not display any portion of a window that lies outside of the window region.

Координаты области окна относительно верхнего левого угла окна, а не клиентской области окна.The coordinates of a window's window region are relative to the upper-left corner of the window, not the client area of the window.

Чтобы установить область окна, позвоните CWnd::SetWindowRgn.To set the window region of a window, call CWnd::SetWindowRgn.

CWnd::GetWindowTextCWnd::GetWindowText

Копирует CWnd название заголовка (если оно имеет одно) в буфер, на который указывает lpszStringBuf или в строку назначения rString.Copies the CWnd caption title (if it has one) into the buffer pointed to by lpszStringBuf or into the destination string rString.

int GetWindowText(
    LPTSTR lpszStringBuf,
    int nMaxCount) const;

void GetWindowText(
    CString& rString) const;

ПараметрыParameters

lpszStringBuflpszStringBuf
Указывает на буфер, который должен получить скопированную строку заголовка окна.Points to the buffer that is to receive the copied string of the window's title.

nMaxCountnMaxCount
Определяет максимальное количество символов, которые будут скопированы в буфер, включая прекращение нулевого символа.Specifies the maximum number of characters to be copied to the buffer, including the terminating null character. Если строка длиннее числа символов, указанных в nMaxCount, она усечена.If the string is longer than the number of characters specified in nMaxCount, it is truncated.

rStringrString
Объект CString, который должен получить скопированную строку заголовка окна.A CString object that is to receive the copied string of the window's title.

Возвращаемое значениеReturn Value

Определяет длину, в символах, скопированных строк, не включая прекращение нулевой характер.Specifies the length, in characters, of the copied string, not including the terminating null character. Это 0, CWnd если нет подписи или если подпись пуста.It is 0 if CWnd has no caption or if the caption is empty.

RemarksRemarks

Если CWnd объект является элементом GetWindowText управления, функция элемента копирует текст в элементе управления вместо копирования подписи.If the CWnd object is a control, the GetWindowText member function copies the text within the control instead of copying the caption.

Эта функция члена WM_GETTEXT приводит к отправке CWnd WM_GETTEXT сообщения объекту.This member function causes the WM_GETTEXT message to be sent to the CWnd object.

ПримерExample

Смотрите пример CWnd::SetWindowText.See the example for CWnd::SetWindowText.

CWnd::GetWindowTextДлинCWnd::GetWindowTextLength

Возвращает длину CWnd заголовка заголовка объекта.Returns the length of the CWnd object caption title.

int GetWindowTextLength() const;

Возвращаемое значениеReturn Value

Определяет длину текста в символах, не включая какой-либо символ с нулевым прекращением.Specifies the text length in characters, not including any null-termination character. Значение 0, если такого текста не существует.The value is 0 if no such text exists.

RemarksRemarks

Если CWnd это элемент GetWindowTextLength управления, функция элемента возвращает длину текста в элемент управления, а не на подпись.If CWnd is a control, the GetWindowTextLength member function returns the length of the text within the control instead of the caption.

Эта функция члена WM_GETTEXTLENGTH приводит к отправке CWnd WM_GETTEXTLENGTH сообщения объекту.This member function causes the WM_GETTEXTLENGTH message to be sent to the CWnd object.

ПримерExample

Смотрите пример CWnd::SetWindowText.See the example for CWnd::SetWindowText.

CWnd::HideCaretCWnd::HideCaret

Скрывает курсор, удалив его из отображаемой области.Hides the caret by removing it from the display screen.

void HideCaret();

RemarksRemarks

Несмотря на то, что карет больше не виден, он может быть отображен снова с помощью функции участника ShowCaret.Although the caret is no longer visible, it can be displayed again by using the ShowCaret member function. Скрытие карета не разрушает его текущую форму.Hiding the caret does not destroy its current shape.

Скрытие является кумулятивным.Hiding is cumulative. Если HideCaret он был вызван пять раз ShowCaret подряд, функция участника должна быть вызвана пять раз, прежде чем будет показана помощь.If HideCaret has been called five times in a row, the ShowCaret member function must be called five times before the caret will be shown.

CWnd::HiliteMenuItemCWnd::HiliteMenuItem

Изюминка или удаление изюминки из верхнего уровня (меню-бар) пункт меню.Highlights or removes the highlight from a top-level (menu-bar) menu item.

BOOL HiliteMenuItem(
    CMenu* pMenu,
    UINT nIDHiliteItem,
    UINT nHilite);

ПараметрыParameters

pMenupMenu
Определяет меню верхнего уровня, содержащее элемент, который должен быть выделен.Identifies the top-level menu that contains the item to be highlighted.

nIDHiliteItemnIDHiliteItem
Определяет элемент меню, который будет выделен, в зависимости от значения параметра nHilite.Specifies the menu item to be highlighted, depending on the value of the nHilite parameter.

nHilitenHilite
Определяется, выделяется ли элемент меню или изюминка удаляется.Specifies whether the menu item is highlighted or the highlight is removed. Это может быть сочетание MF_HILITE или MF_UNHILITE с MF_BYCOMMAND или MF_BYPOSITION.It can be a combination of MF_HILITE or MF_UNHILITE with MF_BYCOMMAND or MF_BYPOSITION. Значения могут быть объединены с помощью bitwise или оператора.The values can be combined using the bitwise OR operator. Данные величины имеют следующие значения:These values have the following meanings:

  • MF_BYCOMMAND интерпретирует nIDHiliteItem как идентификатор меню-элемента (интерпретация по умолчанию).MF_BYCOMMAND Interprets nIDHiliteItem as the menu-item ID (the default interpretation).

  • MF_BYPOSITION интерпретирует nIDHiliteItem как нулевую компенсацию элемента меню.MF_BYPOSITION Interprets nIDHiliteItem as the zero-based offset of the menu item.

  • MF_HILITE Подчеркивает элемент.MF_HILITE Highlights the item. Если это значение не приведено, изюминка удаляется из элемента.If this value is not given, the highlight is removed from the item.

  • MF_UNHILITE удаляет изюминку из элемента.MF_UNHILITE Removes the highlight from the item.

Возвращаемое значениеReturn Value

Уточняется, был ли выделен элемент меню.Specifies whether the menu item was highlighted. Nonzero, если элемент был выделен; в противном случае 0.Nonzero if the item was highlighted; otherwise 0.

RemarksRemarks

Флаги MF_HILITE и MF_UNHILITE могут использоваться только с этой функцией участника; они не могут быть использованы с функцией CMenu::ModifyMenu.The MF_HILITE and MF_UNHILITE flags can be used only with this member function; they cannot be used with the CMenu::ModifyMenu member function.

CWnd::HtmlHelpCWnd::HtmlHelp

Вызовите эту функцию участника, чтобы вызвать приложение HTMLHelp.Call this member function to invoke the HTMLHelp application.

virtual void HtmlHelp(
    DWORD_PTR dwData,
    UINT nCmd = 0x000F);

ПараметрыParameters

dwDatadwData
Определяет дополнительные данные.Specifies additional data. Используемое значение зависит от значения параметра nCmd.The value used depends on the value of the nCmd parameter.

nCmdnCmd
Задает тип запрошенной справки.Specifies the type of help requested. Список возможных значений и то, как они влияют на параметр dwData, см. uCommandFor a list of possible values and how they affect the dwData parameter, see the uCommand parameter described in the HTML Help API Reference in the Windows SDK.

RemarksRemarks

Смотрите CWinApp::HtmlHelp для получения дополнительной информации.See CWinApp::HtmlHelp for more information.

CWnd::InitDynamicLayoutCWnd::InitDynamicLayout

Вызывается платформой для инициализации динамического макета окна.Called by the framework to initialize dynamic layout for a window.

void InitDynamicLayout();

RemarksRemarks

Не вызывайте этот метод напрямую.Do not call this method directly.

CWnd::НедействительноCWnd::Invalidate

Недействительная вся CWndобласть клиента .Invalidates the entire client area of CWnd.

void Invalidate(BOOL bErase = TRUE);

ПараметрыParameters

bErasebErase
Определяется, следует ли стирать фон в области обновления.Specifies whether the background within the update region is to be erased.

RemarksRemarks

Область клиента помечается для покраски, когда происходит следующее WM_PAINT сообщение.The client area is marked for painting when the next WM_PAINT message occurs. Область также может быть проверена до WM_PAINT сообщения, полученного функцией члена ValidateRect или ValidateRgn.The region can also be validated before a WM_PAINT message occurs by the ValidateRect or ValidateRgn member function.

Параметр bErase определяет, следует ли стирать фон в области обновления при обработке области обновления.The bErase parameter specifies whether the background within the update area is to be erased when the update region is processed. Если bErase является правдой, фон стирается при вызове функции участника BeginPaint; если bErase является FALSE, фон остается неизменным.If bErase is TRUE, the background is erased when the BeginPaint member function is called; if bErase is FALSE, the background remains unchanged. Если bErase является правдой для любой части региона обновления, фон во всем регионе, а не только в данной части, стирается.If bErase is TRUE for any part of the update region, the background in the entire region, not just in the given part, is erased.

Windows отправляет WM_PAINT сообщение всякий раз, когда область CWnd обновления не пуста и нет других сообщений в очереди приложения для этого окна.Windows sends a WM_PAINT message whenever the CWnd update region is not empty and there are no other messages in the application queue for that window.

ПримерExample

Смотрите пример Для CWnd::UpdateWindow.See the example for CWnd::UpdateWindow.

CWnd::НедействительноеRectCWnd::InvalidateRect

Недействительным область клиента в данном прямоугольнике, добавив, что CWnd прямоугольник в области обновления.Invalidates the client area within the given rectangle by adding that rectangle to the CWnd update region.

void InvalidateRect(
    LPCRECT lpRect,
    BOOL bErase = TRUE);

ПараметрыParameters

lpRectlpRect
Указывает на CRect объект или структуру RECT, содержащую прямоугольник (в координатах клиента), который должен быть добавлен в область обновления.Points to a CRect object or a RECT structure that contains the rectangle (in client coordinates) to be added to the update region. Если lpRect является NULL, вся клиентская область добавляется в регион.If lpRect is NULL, the entire client area is added to the region.

bErasebErase
Определяется, следует ли стирать фон в области обновления.Specifies whether the background within the update region is to be erased.

RemarksRemarks

Недействительный прямоугольник, наряду со всеми другими областями в области обновления, помечается для покраски при отправке следующего WM_PAINT сообщения.The invalidated rectangle, along with all other areas in the update region, is marked for painting when the next WM_PAINT message is sent. Недействительные области накапливаются в области обновления до тех пор, пока область не будет обработана при следующем WM_PAINT вызова или до тех пор, пока область не будет проверена функцией участника ValidateRect или ValidateRgn.The invalidated areas accumulate in the update region until the region is processed when the next WM_PAINT call occurs, or until the region is validated by the ValidateRect or ValidateRgn member function.

Параметр bErase определяет, следует ли стирать фон в области обновления при обработке области обновления.The bErase parameter specifies whether the background within the update area is to be erased when the update region is processed. Если bErase является правдой, фон стирается при вызове функции участника BeginPaint; если bErase является FALSE, фон остается неизменным.If bErase is TRUE, the background is erased when the BeginPaint member function is called; if bErase is FALSE, the background remains unchanged. Если bErase является правдой для любой части региона обновления, фон во всем регионе стирается, а не только в данной части.If bErase is TRUE for any part of the update region, the background in the entire region is erased, not just in the given part.

Windows отправляет WM_PAINT сообщение всякий раз, когда область CWnd обновления не пуста и нет других сообщений в очереди приложения для этого окна.Windows sends a WM_PAINT message whenever the CWnd update region is not empty and there are no other messages in the application queue for that window.

CWnd::НедействительноCWnd::InvalidateRgn

Недействительная область клиента в данном регионе, добавляя CWndее в текущий регион обновления.Invalidates the client area within the given region by adding it to the current update region of CWnd.

void InvalidateRgn(
    CRgn* pRgn,
    BOOL bErase = TRUE);

ПараметрыParameters

pRgnpRgn
Указатель на объект CRgn, который идентифицирует область для добавления в область обновления.A pointer to a CRgn object that identifies the region to be added to the update region. Предполагается, что в регионе есть координаты клиентов.The region is assumed to have client coordinates. Если этот параметр NULL, вся область клиента добавляется в область обновления.If this parameter is NULL, the entire client area is added to the update region.

bErasebErase
Определяется, следует ли стирать фон в области обновления.Specifies whether the background within the update region is to be erased.

RemarksRemarks

Недействительная область, наряду со всеми другими областями в области обновления, помечена для покраски при следующем отправке сообщения WM_PAINT.The invalidated region, along with all other areas in the update region, is marked for painting when the WM_PAINT message is next sent. Недействительные области накапливаются в области обновления до тех пор, пока область не будет обработана при следующем отправке сообщения WM_PAINT или до тех пор, пока область не будет проверена функцией участника ValidateRect или ValidateRgn.The invalidated areas accumulate in the update region until the region is processed when a WM_PAINT message is next sent, or until the region is validated by the ValidateRect or ValidateRgn member function.

Параметр bErase определяет, следует ли стирать фон в области обновления при обработке области обновления.The bErase parameter specifies whether the background within the update area is to be erased when the update region is processed. Если bErase является правдой, фон стирается при вызове функции участника BeginPaint; если bErase является FALSE, фон остается неизменным.If bErase is TRUE, the background is erased when the BeginPaint member function is called; if bErase is FALSE, the background remains unchanged. Если bErase является правдой для любой части региона обновления, фон во всем регионе, а не только в данной части, стирается.If bErase is TRUE for any part of the update region, the background in the entire region, not just in the given part, is erased.

Windows отправляет WM_PAINT сообщение всякий раз, когда область CWnd обновления не пуста и нет других сообщений в очереди приложения для этого окна.Windows sends a WM_PAINT message whenever the CWnd update region is not empty and there are no other messages in the application queue for that window.

Данный регион должен быть ранее создан одной из функций региона.The given region must have been previously created by one of the region functions.

CWnd::InvokeHelperCWnd::InvokeHelper

Вызов ими функции участника, чтобы вызвать метод управления ActiveX или свойство, указанное dwDispID, в контексте, указанном wFlags.Call this member function to invoke the ActiveX Control method or property specified by dwDispID, in the context specified by wFlags.

void AFX_CDECL InvokeHelper(
    DISPID dwDispID,
    WORD wFlags,
    VARTYPE vtRet,
    void* pvRet,
    const BYTE* pbParamInfo,
    ... );

ПараметрыParameters

dwDispIDdwDispID
Задает вызываемый метод или свойство.Identifies the method or property to be invoked.

wFlagswFlags
Флаги, описывающие контекст IDispatch::Invokeвызова.Flags describing the context of the call to IDispatch::Invoke.

vtRetvtRet
Указывает тип возвращаемого значения.Specifies the type of the return value. Возможные значения см. в подразделе "Примечания" раздела COleDispatchDriver::InvokeHelper.For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.

pvRetpvRet
Адрес переменной, которая получит стоимость имущества или значение возврата.Address of the variable that will that will receive the property value or return value. Он должен соответствовать типу, указанному vtRet.It must match the type specified by vtRet.

pbParamInfopbParamInfo
Указатель на нулевую строку байтов с указанием типов параметров, следующих pbParamInfo.Pointer to a null-terminated string of bytes specifying the types of the parameters following pbParamInfo. Для возможных значений, см. COleDispatchDriver::InvokeHelperFor possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.

......
Переменный список параметров, типов, указанных в pbParamInfo.Variable List of parameters, of types specified in pbParamInfo.

RemarksRemarks

Параметр pbParamInfo определяет типы параметров, передаваемых методу или свойству.The pbParamInfo parameter specifies the types of the parameters passed to the method or property. Переменный список аргументов представлен в объявлении синтаксиса как ... .The variable list of arguments is represented by ... in the syntax declaration.

Эта функция преобразует параметры в значения VARIANTARG, а IDispatch::Invoke затем вызывает метод на элементе управления ActiveX.This function converts the parameters to VARIANTARG values, then invokes the IDispatch::Invoke method on the ActiveX control. Если вызов IDispatch::Invoke завершается сбоем, эта функция создает исключение.If the call to IDispatch::Invoke fails, this function will throw an exception. Если sCODE (код статуса), IDispatch::Invoke возвращенный DISP_E_EXCEPTION, эта функция бросает объект COleException, в противном случае он бросает COleDispatchException.If the SCODE (status code) returned by IDispatch::Invoke is DISP_E_EXCEPTION, this function throws a COleException object, otherwise it throws a COleDispatchException.

Note

Эта функция должна вызываться CWnd только на объекте, который представляет элемент управления ActiveX.This function should be called only on a CWnd object that represents an ActiveX control.

Для получения дополнительной информации об использовании этой функции ActiveX Control Containers: Programming ActiveX Controls in an ActiveX Control Containerучастника с помощью контейнеров ActiveX Control, см.For more information about using this member function with ActiveX Control Containers, see the article ActiveX Control Containers: Programming ActiveX Controls in an ActiveX Control Container.

CWnd::IsChildCWnd::IsChild

Указывает, является ли окно, указанное pWnd, CWndокном ребенка или другим прямым потомком.Indicates whether the window specified by pWnd is a child window or other direct descendant of CWnd.

BOOL IsChild(const CWnd* pWnd) const;

ПараметрыParameters

pWndpWnd
Идентифицирует окно для тестирования.Identifies the window to be tested.

Возвращаемое значениеReturn Value

Определяет результат функции.Specifies the outcome of the function. Значение ненулевое, если окно, идентифицированное pWnd, является окном ребенка; CWnd в противном случае 0.The value is nonzero if the window identified by pWnd is a child window of CWnd; otherwise 0.

RemarksRemarks

Окно ребенка является прямым CWnd потомком, если CWnd объект находится в цепочке родительских окон, которая ведет из исходного всплывающее окно в окно ребенка.A child window is the direct descendant of CWnd if the CWnd object is in the chain of parent windows that leads from the original pop-up window to the child window.

CWnd::IsD2DSupportEnabledCWnd::IsD2DSupportEnabled

Определяет, включена ли поддержка D2D.Determines whether D2D support is enabled.

BOOL IsD2DSupportEnabled();

Возвращаемое значениеReturn Value

TRUE, если функция включена; в противном случае FALSE.TRUE if the feature is enabled; otherwise FALSE.

CWnd::IsDialogMessageCWnd::IsDialogMessage

Вызовите эту функцию участника, чтобы определить, предназначено ли данное сообщение для бесрежимного диалогового окна; если это так, эта функция обрабатывает сообщение.Call this member function to determine whether the given message is intended for a modeless dialog box; if it is, this function processes the message.

BOOL IsDialogMessage(LPMSG lpMsg);

ПараметрыParameters

lpMsglpMsg
Указывает на структуру MSG, содержащую проверенное сообщение.Points to an MSG structure that contains the message to be checked.

Возвращаемое значениеReturn Value

Указывается, обработала ли функция участника данное сообщение.Specifies whether the member function has processed the given message. Это ненулевой, если сообщение было обработано; в противном случае 0.It is nonzero if the message has been processed; otherwise 0. Если возврат расшатывлен 0, позвоните в функцию члена CWnd::PReTranslateMessage базового класса для обработки сообщения.If the return is 0, call the CWnd::PreTranslateMessage member function of the base class to process the message. В переопределение функции CWnd::PreTranslateMessage члена код выглядит следующим образом:In an override of the CWnd::PreTranslateMessage member function the code looks like this :

BOOL CAboutDlg::PreTranslateMessage(MSG *pMsg)
{
   if (IsDialogMessage(pMsg))
      return TRUE;
   else
      return CDialog::PreTranslateMessage(pMsg);
}

RemarksRemarks

Когда IsDialogMessage функция обрабатывает сообщение, она проверяет сообщения клавиатуры и преобразует их в команды выбора для соответствующего диалогового окна.When the IsDialogMessage function processes a message, it checks for keyboard messages and converts them to selection commands for the corresponding dialog box. Например, ключ TAB выбирает следующий элемент управления или группу элементов управления, а ключ DOWN ARROW выбирает следующий элемент управления в группе.For example, the TAB key selects the next control or group of controls, and the DOWN ARROW key selects the next control in a group.

Вы не должны передавать IsDialogMessage сообщение, обрабатываемые функциями TranslateMessage или DispatchMessage Windows, поскольку оно уже обработано.You must not pass a message processed by IsDialogMessage to the TranslateMessage or DispatchMessage Windows functions, because it has already been processed.

CWnd:IsDlgButtonCheckedCWnd::IsDlgButtonChecked

Определяет, имеет ли контрольное управление кнопку рядом с ним контрольный знак.Determines whether a button control has a check mark next to it.

UINT IsDlgButtonChecked(int nIDButton) const;

ПараметрыParameters

nIDButtonnIDButton
Определяет идентификатор самого разного соответствия управления кнопками.Specifies the integer identifier of the button control.

Возвращаемое значениеReturn Value

Nonzero, если данный элемент управления проверен, и 0, если он не проверен.Nonzero if the given control is checked, and 0 if it is not checked. Проверить можно только радиокнопки и флажки.Only radio buttons and check boxes can be checked. Для трехсостоянияки значения возврата может быть 2, если кнопка неопределенны.For three-state buttons, the return value can be 2 if the button is indeterminate. Эта функция участника возвращает 0 для кнопки.This member function returns 0 for a pushbutton.

RemarksRemarks

Если кнопка является элементом управления тремя состояниями, функция элемента определяет, затемнена она, проверена или нет.If the button is a three-state control, the member function determines whether it is dimmed, checked, or neither.

CWnd::IsDynamicLayoutCWnd::IsDynamicLayoutEnabled

Определяет, активен ли для данного окна динамический макет.Determines whether dynamic layout is enabled on this window. Если динамический макет активен, положение и размеры дочерних окон могут меняться при изменении пользователем размера родительского окна.If dynamic layout is enabled, the position and size of child windows can change when the user resizes the parent window.

BOOL IsDynamicLayoutEnabled() const;

Возвращаемое значениеReturn Value

TRUE — динамический макет активен; в противном случае — FALSE.TRUE if dynamic layout is enabled; otherwise FALSE.

RemarksRemarks

CWnd::IsIconicCWnd::IsIconic

Уточняется, является CWnd ли сведена к минимуму (иконическая).Specifies whether CWnd is minimized (iconic).

BOOL IsIconic() const;

Возвращаемое значениеReturn Value

Nonzero, CWnd если сведен о минимум; в противном случае 0.Nonzero if CWnd is minimized; otherwise 0.

ПримерExample

void CAboutDlg::OnPaint()
{
   // This code, normally emitted by the Application Wizard for a dialog-
   // based project for the dialog's WM_PAINT handler, runs only if the
   // window is iconic. The window erases the icon's area, then
   // paints the icon referenced by m_hIcon.
   if (IsIconic())
   {
      CPaintDC dc(this); // device context for painting

      SendMessage(WM_ICONERASEBKGND, (WPARAM)dc.GetSafeHdc(), 0);

      // Center icon in client rectangle
      int cxIcon = GetSystemMetrics(SM_CXICON);
      int cyIcon = GetSystemMetrics(SM_CYICON);
      CRect rect;
      GetClientRect(&rect);
      int x = (rect.Width() - cxIcon + 1) / 2;
      int y = (rect.Height() - cyIcon + 1) / 2;

      // Draw the icon
      dc.DrawIcon(x, y, m_hIcon);
   }
   else
   {
      CDialog::OnPaint();
   }
}

CWnd::IsTouchWindowCWnd::IsTouchWindow

Указывает, поддерживает ли объект CWnd сенсорный ввод.Specifies whether CWnd has touch support.

BOOL IsTouchWindow() const;

Возвращаемое значениеReturn Value

TRUE, CWnd если имеет поддержку касания; в противном случае FALSE.TRUE if CWnd has touch support; otherwise FALSE.

RemarksRemarks

CWnd::IsWindowEnabledCWnd::IsWindowEnabled

Уточняется, включен CWnd ли ввод мыши и клавиатуры.Specifies whether CWnd is enabled for mouse and keyboard input.

BOOL IsWindowEnabled() const;

Возвращаемое значениеReturn Value

Nonzero, CWnd если включен; в противном случае 0.Nonzero if CWnd is enabled; otherwise 0.

ПримерExample

//change the background color of an edit control on the dialog
HBRUSH CMyDlg::OnCtlColor(CDC *pDC, CWnd *pWnd, UINT nCtlColor)
{
   HBRUSH hbr = CDialog::OnCtlColor(pDC, pWnd, nCtlColor);

   if (pWnd->GetDlgCtrlID() == IDC_MYEDIT)
   {
      if (pWnd->IsWindowEnabled())
      {
         // Red brush for the background...
         pDC->SetBkColor(RGB(255, 0, 0));
         // m_pRedBrush is the CBrush object initialized with a red brush
         // using CreateSolidBrush
         return (HBRUSH)m_RedBrush.GetSafeHandle();
      }
      else
      {
         // Blue brush for the background...
         pDC->SetBkColor(RGB(0, 0, 255));
         // m_pBlueBrush is the CBrush object initialized with a blue
         // brush using CreateSolidBrush
         return (HBRUSH)m_BlueBrush.GetSafeHandle();
      }
   }

   return hbr;
}

CWnd::IsWindowVisibleCWnd::IsWindowVisible

Определяет состояние видимости данного окна.Determines the visibility state of the given window.

BOOL IsWindowVisible() const;

Возвращаемое значениеReturn Value

Nonzero, CWnd если он виден (имеет набор бита WS_VISIBLE стилю, и родительское окно видно).Nonzero if CWnd is visible (has the WS_VISIBLE style bit set, and parent window is visible). Поскольку значение возврата отражает состояние бита стиля WS_VISIBLE, значение возврата CWnd может быть ненулевым, даже если полностью скрыто другими окнами.Because the return value reflects the state of the WS_VISIBLE style bit, the return value may be nonzero even though CWnd is totally obscured by other windows.

RemarksRemarks

Окно обладает состоянием видимости, указанным WS_VISIBLE стилю бита.A window possesses a visibility state indicated by the WS_VISIBLE style bit. Когда этот бит стиля устанавливается с вызовом к функции участника ShowWindow, окно отображается и последующий рисунок к окну отображается до тех пор, пока окно имеет набор бита стиля.When this style bit is set with a call to the ShowWindow member function, the window is displayed and subsequent drawing to the window is displayed as long as the window has the style bit set.

Любой рисунок к окну, в который есть WS_VISIBLE стиль, не будет отображаться, если окно покрыто другими окнами или обрезано родительским окном.Any drawing to a window that has the WS_VISIBLE style will not be displayed if the window is covered by other windows or is clipped by its parent window.

ПримерExample

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is not, it calls
// CWnd::ShowWindow with the SW_SHOWNORMAL command.
void CMainFrame::DisplayModeless()
{
   if(!m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_SHOWNORMAL);
   }
}

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is, it calls
// CWnd::ShowWindow with the SW_HIDE command.
void CMainFrame::HideModeless()
{
   if(m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_HIDE);
   }
}

CWnd:: ИсоомедCWnd::IsZoomed

Определяет, CWnd был ли максимизирован.Determines whether CWnd has been maximized.

BOOL IsZoomed() const;

Возвращаемое значениеReturn Value

Nonzero, CWnd если максимизируется; в противном случае 0.Nonzero if CWnd is maximized; otherwise 0.

CWnd:KillTimerCWnd::KillTimer

Убивает событие таймер, идентифицированное nIDEvent SetTimerот предыдущего вызова.Kills the timer event identified by nIDEvent from the earlier call to SetTimer.

BOOL KillTimer(UINT_PTR nIDEvent);

ПараметрыParameters

nIDEventnIDEvent
Значение события таймер передается SetTimer.The value of the timer event passed to SetTimer.

Возвращаемое значениеReturn Value

Определяет результат функции.Specifies the outcome of the function. Значение ненулево, если событие было убито.The value is nonzero if the event was killed. Это 0, KillTimer если функция участника не смогла найти указанное событие таймер.It is 0 if the KillTimer member function could not find the specified timer event.

RemarksRemarks

До WM_TIMER сообщения, связанные с таймером, не удаляются из очереди сообщений.Pending WM_TIMER messages associated with the timer are not removed from the message queue.

ПримерExample

Смотрите пример для CWnd::SetTimer.See the example for CWnd::SetTimer.

CWnd::LoadDynamicLayoutResourceCWnd::LoadDynamicLayoutResource

Вызывается платформой для загрузки из файла ресурсов сведений о динамическом макете.Called by the framework to load dynamic layout information from the resource file.

BOOL LoadDynamicLayoutResource(LPCTSTR lpszResourceName);

ПараметрыParameters

lpszResourceNamelpszResourceName
Имя ресурса, содержащего необходимые сведения о динамическом макете для этого окна.The name of the resource that contains the desired dynamic layout information for this window.

Возвращаемое значениеReturn Value

Ненулевое значение, если функция выполнена успешно.Nonzero if the function is successful. В случае ошибки — 0.It is 0 if a failure occurs.

RemarksRemarks

Не вызывайте этот метод напрямую.Do not call this method directly.

CWnd::LockWindowUpdateCWnd::LockWindowUpdate

Отводит рисунок в данном окне.Disables drawing in the given window.

BOOL LockWindowUpdate();

Возвращаемое значениеReturn Value

Ненулевое значение, если функция выполнена успешно.Nonzero if the function is successful. Это 0, если происходит сбой или если LockWindowUpdate функция была использована для блокировки другого окна.It is 0 if a failure occurs or if the LockWindowUpdate function has been used to lock another window.

RemarksRemarks

Заблокированное окно не может быть перемещено.A locked window cannot be moved. Заодине можно запереть только одно окно.Only one window can be locked at a time. Чтобы разблокировать LockWindowUpdateокно, заблокированное с помощью, позвоните UnlockWindowUpdate.To unlock a window locked with LockWindowUpdate, call UnlockWindowUpdate.

Если приложение с заблокированным окном (или любыми заблокированными окнами ребенка) вызывает функцию GetDC, GetDCEx или BeginPaint Windows, вызванная функция возвращает контекст устройства, видимая область которого пуста.If an application with a locked window (or any locked child windows) calls the GetDC, GetDCEx, or BeginPaint Windows function, the called function returns a device context whose visible region is empty. Это произойдет до тех пор, пока UnlockWindowUpdate приложение не разблокирует окно, позвонив функции участника.This will occur until the application unlocks the window by calling the UnlockWindowUpdate member function.

В то время как обновления окон заблокированы, система отслеживает прямоугольник границ любых операций рисования в контекстах устройства, связанных с заблокированным окном.While window updates are locked, the system keeps track of the bounding rectangle of any drawing operations to device contexts associated with a locked window. При повторном включении чертежа этот прямоугольник ограниченного является недействительным в заблокированном окне и его детских окнах, чтобы заставить возможное сообщение WM_PAINT обновить экран.When drawing is reenabled, this bounding rectangle is invalidated in the locked window and its child windows to force an eventual WM_PAINT message to update the screen. Если рисунок не произошел, пока обновление окна было заблокировано, ни одна область не аннулируется.If no drawing has occurred while the window updates were locked, no area is invalidated.

Функция LockWindowUpdate члена не делает данное окно невидимым и не очищает WS_VISIBLE бит стиля.The LockWindowUpdate member function does not make the given window invisible and does not clear the WS_VISIBLE style bit.

CWnd::m_hWndCWnd::m_hWnd

Ручка окна Windows прилагается CWndк этому.The handle of the Windows window attached to this CWnd.

HWND m_hWnd;

RemarksRemarks

Член m_hWnd данных является общедоступной переменной типа HWND.The m_hWnd data member is a public variable of type HWND.

CWnd:MapWindowPointsCWnd::MapWindowPoints

Преобразует набор точек из координатного пространства объекта CWnd в координатное пространство другого окна.Converts (maps) a set of points from the coordinate space of the CWnd to the coordinate space of another window.

void MapWindowPoints(
    CWnd* pwndTo,
    LPRECT lpRect) const;

void MapWindowPoints(
    CWnd* pwndTo,
    LPPOINT lpPoint,
    UINT nCount) const;

ПараметрыParameters

pwndTopwndTo
Определяет окно, в какие точки преобразуется.Identifies the window to which points are converted. Если этот параметр NULL, точки преобразуются в координаты экрана.If this parameter is NULL, the points are converted to screen coordinates.

lpRectlpRect
Определяет прямоугольник, точки которого должны быть преобразованы.Specifies the rectangle whose points are to be converted. Первая версия этой функции доступна только для Windows 3.1 и позже.The first version of this function is available only for Windows 3.1 and later.

lpPointlpPoint
Указатель на массив структуры POINT, содержащий набор точек, которые должны быть преобразованы.A pointer to an array of POINT structure that contain the set of points to be converted.

NcountnCount
Определяет количество POINT структур в массиве, на которые указывает lpPoint.Specifies the number of POINT structures in the array pointed to by lpPoint.

CWnd::MessageBoxCWnd::MessageBox

Создает и отображает окно, содержащее сообщение и подпись, поставляемое приложением, а также сочетание предопределенных иконок и кнопок, описанных в списке стилей сообщения-Box.Creates and displays a window that contains an application-supplied message and caption, plus a combination of the predefined icons and pushbuttons described in the Message-Box Styles list.

int MessageBox(
    LPCTSTR lpszText,
    LPCTSTR lpszCaption = NULL,
    UINT nType = MB_OK);

ПараметрыParameters

lpszTextlpszText
Очки объекту CString или строке с нулевым завершением, содержащей отображаемые сообщения.Points to a CString object or null-terminated string containing the message to be displayed.

lpszCaptionlpszCaption
Очки объекту CString или строке с нулевым завершением, которые будут использоваться для подписи к яслях.Points to a CString object or null-terminated string to be used for the message-box caption. Если lpszCaption является NULL, используется подпись по умолчанию "Ошибка".If lpszCaption is NULL, the default caption "Error" is used.

nTypenType
Определяет содержимое и поведение ящика сообщений.Specifies the contents and behavior of the message box.

Возвращаемое значениеReturn Value

Этот метод использует функцию MessageBox, как это определено в SDK Windows.This method utilizes the MessageBox function as defined in the Windows SDK. Этот метод возвращает результат вызова этой функции.This method returns the result of calling this function.

RemarksRemarks

Используйте глобальную функцию AfxMessageBox вместо этой функции члена для реализации ящика сообщений в приложении.Use the global function AfxMessageBox instead of this member function to implement a message box in your application.

Ниже приведены различные значки системы, которые могут быть использованы в поле сообщения:The following shows the various system icons that can be used in a message box:

Стоп (и значок)Stop (x) icon MB_ICONHAND, MB_ICONSTOP и MB_ICONERRORMB_ICONHAND, MB_ICONSTOP, and MB_ICONERROR
Справка () значокHelp (?) icon MB_ICONQUESTIONMB_ICONQUESTION
Важный значок (!) Important (!) icon MB_ICONEXCLAMATION и MB_ICONWARNINGMB_ICONEXCLAMATION and MB_ICONWARNING
Значок информации (я)Information (i) icon MB_ICONASTERISK и MB_ICONINFORMATIONMB_ICONASTERISK and MB_ICONINFORMATION

ПримерExample

void CMainFrame::OnDisplayErrorMessage()
{
   // This displays a message box with the title "Error"
   // and the message "Help, Something went wrong."
   // The error icon is displayed in the message box, along with
   // an OK button.
   MessageBox(_T("Help, Something went wrong."), _T("Error"),
              MB_ICONERROR | MB_OK);
}

CWnd::ModifyStyleCWnd::ModifyStyle

Вызовите эту функцию участника, чтобы изменить стиль окна.Call this member function to modify a window's style.

BOOL ModifyStyle(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0);

ПараметрыParameters

dwRemovedwRemove
Определяет стили окон, которые должны быть удалены во время модификации стиля.Specifies window styles to be removed during style modification.

dwAdddwAdd
Определяет стили окон, которые будут добавлены во время модификации стиля.Specifies window styles to be added during style modification.

nФлагиnFlags
Флаги, которые должны быть переданы SetWindowPos SetWindowPos, или ноль, если не следует вызываться.Flags to be passed to SetWindowPos, or zero if SetWindowPos should not be called. По умолчанию используется значение 0.The default is zero. Список предустановленных флагов можно осмотреть в разделе «Замечания».See the Remarks section for a list of preset flags.

Возвращаемое значениеReturn Value

Nonzero, если стиль был успешно изменен; в противном случае, 0.Nonzero if style was successfully modified; otherwise, 0.

RemarksRemarks

Стили, которые должны быть добавлены или удалены, могут быть объединены с помощью bitwise ИЛИ (|) оператора.Styles to be added or removed can be combined by using the bitwise OR (|) operator. Ознакомьтесь с темами «Стиль оконов» и «CreateWindow» в SDK Windows, чтобы получить информацию о доступных стилях окон.See the topics Window Styles and CreateWindow in the Windows SDK for information about the available window styles.

Если nFlags незеро, ModifyStyle вызов функции Windows API SetWindowPos и перерисовывает окно, объединяя nFlags со следующими четырьмя предустановленными флагами:If nFlags is nonzero, ModifyStyle calls the Windows API function SetWindowPos and redraws the window by combining nFlags with the following four preset flags:

  • SWP_NOSIZE сохраняет текущий размер.SWP_NOSIZE Retains the current size.

  • SWP_NOMOVE сохраняет текущее положение.SWP_NOMOVE Retains the current position.

  • SWP_NOZORDER сохраняет текущий заказ.SWP_NOZORDER Retains the current Z order.

  • SWP_NOACTIVATE не активирует окно.SWP_NOACTIVATE Does not activate the window.

Чтобы изменить расширенные стили окна, см.To modify a window's extended styles, see ModifyStyleEx.

Note

Для некоторых стилей в некоторых элементах управления (например, ES_READONLY стиле управления элементами дейтинга) ModifyStyle может не быть должным образом изменяемым стилем, поскольку элемент управления может потребоваться для выполнения специальной внутренней обработки.For some styles in certain controls (the ES_READONLY style in the edit control, for example), ModifyStyle may not properly change the style because the control may need to perform special internal processing. В этих случаях будет доступно соответствующее сообщение об изменении стиля (EM_SETREADONLY в упомянутом примере).In these cases, a corresponding message to change the style will be available ( EM_SETREADONLY in the example mentioned).

ПримерExample

// This example adds the WS_CLIPCHILDREN style to the window.
// No Styles are removed from the window.
void CMyView::OnInitialUpdate()
{
   CView::OnInitialUpdate();
   ModifyStyle(0, WS_CLIPCHILDREN);
}

CWnd::ModifyStyleExCWnd::ModifyStyleEx

Вызовите эту функцию участника, чтобы изменить расширенный стиль окна.Call this member function to modify a window's extended style.

BOOL ModifyStyleEx(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0);

ПараметрыParameters

dwRemovedwRemove
Определяет расширенные стили, которые должны быть удалены во время модификации стиля.Specifies extended styles to be removed during style modification.

dwAdddwAdd
Определяет расширенные стили, которые будут добавлены во время модификации стиля.Specifies extended styles to be added during style modification.

nФлагиnFlags
Флаги, которые должны быть переданы SetWindowPos SetWindowPos, или ноль, если не следует вызываться.Flags to be passed to SetWindowPos, or zero if SetWindowPos should not be called. По умолчанию используется значение 0.The default is zero. Список предустановленных флагов можно осмотреть в разделе «Замечания».See the Remarks section for a list of preset flags.

Возвращаемое значениеReturn Value

Nonzero, если стиль был успешно изменен; в противном случае, 0.Nonzero if style was successfully modified; otherwise, 0.

RemarksRemarks

Стили, которые должны быть добавлены или удалены, могут быть объединены с помощью bitwise ИЛИ (|) оператора.Styles to be added or removed can be combined by using the bitwise OR (|) operator. Смотрите темы Расширенные стили окна в этой книге и CreateWindowEx в Windows SDK для получения информации о доступных расширенных стилейSee the topics Extended Window Styles in this book and CreateWindowEx in the Windows SDK for information about the available extended styles

Если nFlags незеро, ModifyStyleEx вызов функции Windows API SetWindowPos и перерисовывает окно, объединяя nFlags со следующими четырьмя предустановленными флагами:If nFlags is nonzero, ModifyStyleEx calls the Windows API function SetWindowPos and redraws the window by combining nFlags with the following four preset flags:

  • SWP_NOSIZE сохраняет текущий размер.SWP_NOSIZE Retains the current size.

  • SWP_NOMOVE сохраняет текущее положение.SWP_NOMOVE Retains the current position.

  • SWP_NOZORDER сохраняет текущий заказ.SWP_NOZORDER Retains the current Z order.

  • SWP_NOACTIVATE не активирует окно.SWP_NOACTIVATE Does not activate the window.

Чтобы изменить окна с помощью обычных стилей окон, см.To modify windows using regular window styles, see ModifyStyle.

ПримерExample

// This example would make the dialog box transparent by
// changing the dialog window's extended styles.
int CAboutDlg::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CDialog::OnCreate(lpCreateStruct) == -1)
      return -1;

   ModifyStyleEx(0, WS_EX_TRANSPARENT);   
   
   return 0;
}

CWnd::MoveWindowCWnd::MoveWindow

Изменяет положение и размеры.Changes the position and dimensions.

void MoveWindow(
    int x,
    int y,
    int nWidth,
    int nHeight,
    BOOL bRepaint = TRUE);

void MoveWindow(
    LPCRECT lpRect,
    BOOL bRepaint = TRUE);

ПараметрыParameters

xx
Определяет новое положение левой стороны CWnd.Specifies the new position of the left side of the CWnd.

Yy
Определяет новое положение верхней части CWnd.Specifies the new position of the top of the CWnd.

nWidthnWidth
Определяет новую ширину CWnd.Specifies the new width of the CWnd.

nВысотаnHeight
Определяет новую высоту CWnd.Specifies the new height of the CWnd.

bRepaintbRepaint
Определяет, следует CWnd ли перекрасить.Specifies whether CWnd is to be repainted. Если true, CWnd получает WM_PAINT сообщение в своем обработчике сообщений OnPaint, как обычно.If TRUE, CWnd receives a WM_PAINT message in its OnPaint message handler as usual. Если этот параметр FALSE, не перекрашивается какой-либо вид происходит.If this parameter is FALSE, no repainting of any kind occurs. Это относится к клиентской области, к области неклиента (включая заголовок и прокрутки баров), а также к любой части родительского окна, обнаруженного CWndв результате перемещения.'.This applies to the client area, to the nonclient area (including the title and scroll bars), and to any part of the parent window uncovered as a result of CWnd's move. Когда этот параметр FALSE, приложение должно явно аннулировать CWnd или перерисовать любые части и родительское окно, которые должны быть перерисованы.When this parameter is FALSE, the application must explicitly invalidate or redraw any parts of CWnd and parent window that must be redrawn.

lpRectlpRect
Объект CRect или структура RECT, которая определяет новый размер и положение.The CRect object or RECT structure that specifies the new size and position.

RemarksRemarks

Для объекта верхнего уровня CWnd параметры x и y относительно верхнего левого угла экрана.For a top-level CWnd object, the x and y parameters are relative to the upper-left corner of the screen. Для детского CWnd объекта они относятся к верхнему левому углу клиентской зоны родительского окна.For a child CWnd object, they are relative to the upper-left corner of the parent window's client area.

Функция MoveWindow отправляет сообщение WM_GETMINMAXINFO.The MoveWindow function sends the WM_GETMINMAXINFO message. Обработка этого CWnd сообщения дает возможность изменить значения по умолчанию для самых больших и маленьких возможных окон.Handling this message gives CWnd the opportunity to modify the default values for the largest and smallest possible windows. Если параметры функции MoveWindow члена превышают эти значения, значения могут быть заменены минимальными или максимальными значениями в WM_GETMINMAXINFO обработчике.If the parameters to the MoveWindow member function exceed these values, the values can be replaced by the minimum or maximum values in the WM_GETMINMAXINFO handler.

ПримерExample

Смотрите пример Для CWnd::ClientToScreen.See the example for CWnd::ClientToScreen.

CWnd::NotifyWinEventCWnd::NotifyWinEvent

Сообщает системе, что произошло предопределенное событие.Signals the system that a predefined event occurred. Если какие-либо клиентские приложения зарегистрировали функцию крючка для события, система вызывает функцию крючка клиента.If any client applications have registered a hook function for the event, the system calls the client's hook function.

void NotifyWinEvent(
    DWORD event,
    LONG idObjectType,
    LONG idObject);

ПараметрыParameters

eventevent
Определяет событие, которое произошло.Specifies the event that occurred. Это значение должно быть одним из констант события.This value must be one of the event constants.

idObjectTypeidObjectType
Определяет вид объекта, генерируемого событием.Identifies the kind of object that generated the event. Это значение является одним из предопределенных идентификаторов объектов или пользовательским значением идентификатора объекта.This value is one of the predefined object identifiers or a custom object ID value.

idObjectidObject
Определяет, было ли событие создано объектом или элементом ребенка объекта.Identifies whether the event was generated by an object or a child element of the object. Если это значение является CHILDID_SELF, событие было создано самим объектом.If this value is CHILDID_SELF, the event was generated by the object itself. Если нет, то это значение является идентификатором элемента, генерируемого событием.If not, this value is the child ID of the element that generated the event.

RemarksRemarks

Эта функция члена эмулирует функциональность функции NotifyWinEvent, как описано в SDK Windows.This member function emulates the functionality of the function NotifyWinEvent, as described in the Windows SDK.

CWnd::OnactivateCWnd::OnActivate

Платформа вызывает эту функцию CWnd члена при активации или деактивации объекта.The framework calls this member function when a CWnd object is being activated or deactivated.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

ПараметрыParameters

nStatenState
Определяет, CWnd активируется или деактивируется ли оно.Specifies whether the CWnd is being activated or deactivated. Может иметь одно из следующих значений.It can be one of the following values:

  • WA_INACTIVE окно деактивируется.WA_INACTIVE The window is being deactivated.

  • WA_ACTIVE Окно активируется с помощью какого-то метода, кроме щелчка мыши (например, с помощью интерфейса клавиатуры для выбора окна).WA_ACTIVE The window is being activated through some method other than a mouse click (for example, by use of the keyboard interface to select the window).

  • WA_CLICKACTIVE Окно активируется щелчком мыши.WA_CLICKACTIVE The window is being activated by a mouse click.

pWndДругиеpWndOther
Указатель на CWnd активированный или деактивированный.Pointer to the CWnd being activated or deactivated. Указатель может быть NULL, и это может быть временным.The pointer can be NULL, and it may be temporary.

bСнейдированныйbMinimized
Определяет минимизированное CWnd состояние активированного или деактивированного.Specifies the minimized state of the CWnd being activated or deactivated. Значение TRUE указывает на то, что окно сведено к минимуму.A value of TRUE indicates the window is minimized.

Если true, CWnd активируется активация; в противном случае деактивирован.If TRUE, the CWnd is being activated; otherwise deactivated.

RemarksRemarks

Если CWnd объект активирован щелчком мыши, он также получит вызов функции участника OnMouseActivate.If the CWnd object is activated with a mouse click, it will also receive an OnMouseActivate member function call.

Note

Это функция-член вызывается платформой, чтобы разрешить приложению обработать сообщение Windows.This member function is called by the framework to allow your application to handle a Windows message. Параметры, передаваемые в функцию, отражают параметры, полученные платформой при поступлении сообщения.The parameters passed to your function reflect the parameters received by the framework when the message was received. При вызове реализации базового класса этой функции эта реализация будет использовать параметры, изначально переданные с сообщением, а не параметры, передаваемые в функции.If you call the base-class implementation of this function, that implementation will use the parameters originally passed with the message and not the parameters you supply to the function.

CWnd::OnActivateAppCWnd::OnActivateApp

Платформа вызывает эту функцию участника ко всем окнам верхнего уровня активированной задачи и для всех окон верхнего уровня деактивации задачи.The framework calls this member function to all top-level windows of the task being activated and for all top-level windows of the task being deactivated.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

ПараметрыParameters

bАктивныйbActive
Определяет, CWnd активируется или деактивируется ли оно.Specifies whether the CWnd is being activated or deactivated. TRUE означает, CWnd что активируется.TRUE means the CWnd is being activated. FALSE означает, что CWnd деактивирован.FALSE means the CWnd is being deactivated.

dwThreadIDdwThreadID
Определяет значение идентификатора потока.Specifies the value of the thread ID. Если bActive является правдой, dwThreadID определяет CWnd поток, который владеет деактивированным.If bActive is TRUE, dwThreadID identifies the thread that owns the CWnd being deactivated. Если bActive false, dwThreadID определяет поток, CWnd который владеет активируемым.If bActive is FALSE, dwThreadID identifies the thread that owns the CWnd being activated.

RemarksRemarks

Note

Это функция-член вызывается платформой, чтобы разрешить приложению обработать сообщение Windows.This member function is called by the framework to allow your application to handle a Windows message. Параметры, передаваемые в функцию, отражают параметры, полученные платформой при поступлении сообщения.The parameters passed to your function reflect the parameters received by the framework when the message was received. При вызове реализации базового класса этой функции эта реализация будет использовать параметры, изначально переданные с сообщением, а не параметры, передаваемые в функции.If you call the base-class implementation of this function, that implementation will use the parameters originally passed with the message and not the parameters you supply to the function.

CWnd::OnAmbientPropertyCWnd::OnAmbientProperty

Платформа вызывает эту функцию участника для получения значений свойств окружающего из окна, содержащего элементы управления OLE.The framework calls this member function to obtain ambient property values from a window that contains OLE controls.

virtual BOOL OnAmbientProperty(
    COleControlSite* pSite,
    DISPID dispid,
    VARIANT* pvar);

ПараметрыParameters

pSitepSite
Указатель на место управления, запрашиваемое окружающим свойством.Pointer to the site of the control that requested the ambient property.

Dispiddispid
Идентификатор отправки запрашиваемого свойства окружающей среды.The dispatch ID of the requested ambient property.

pvarpvar
Указатель на выделенную VARIANT вызываемую структуру, через которую будет возвращена стоимость свойства окружающего.Pointer to a caller-allocated VARIANT structure, through which the ambient property's value will be returned.

Возвращаемое значениеReturn Value

TRUE, если эмбиент собственности поддерживается; FALSE, если нет.TRUE if the ambient property is supported; FALSE if not.

RemarksRemarks

Переизместите эту функцию, чтобы изменить значения свойств окружающего по умолчанию, возвращенные контейнером управления OLE на элементы управления.Override this function to alter the default ambient property values returned by an OLE control container to its controls. Любые запросы на свойства окружающего, не обрабатываемые главной функцией, должны быть направлены в реализацию базового класса.Any ambient property requests not handled by an overriding function should be forwarded to the base class implementation.

CWnd::OnAppCommandCWnd::OnAppCommand

Платформа вызывает эту функцию элемента, когда пользователь генерирует событие команды приложения.The framework calls this member function when the user generates an application command event. Такое событие происходит, когда пользователь нажимает кнопку команды приложения или вводит ключ команды приложения.Such an event occurs when the user clicks an application command button or types an application command key.

afx_msg void OnAppCommand(
    CWnd* pWnd,
    UINT nCmd,
    UINT nDevice,
    UINT nKey);

ПараметрыParameters

ПараметрParameter ОписаниеDescription
pWndpWnd (в) Указатель на CWnd объект, представляющий окно, где пользователь нажал кнопку команды или нажал на ключ команды.[in] Pointer to a CWnd object that represents the window where the user clicked the command button or pressed the command key. Это окно может быть окном ребенка, получая сообщение.This window can be a child window of the window receiving the message.
nCmdnCmd (в) Указывает команду приложения.[in] Indicates the application command. Список возможных значений WM_APPCOMMANDсм. cmd lParamFor a list of possible values, see the commands under the cmd section of the lParam parameter of WM_APPCOMMAND.
nDevicenDevice (в) Устройство ввода, генерируемое событиева ввода.[in] The input device that generated the input event. Список возможных значений WM_APPCOMMANDсм. uDevice lParamFor a list of possible values, see the devices under the uDevice section of the lParam parameter of WM_APPCOMMAND.
nKeynKey (в) Отослежено на любые виртуальные клавиши, которые не имеют доступа, например, ключ CTRL или кнопка левой мыши.[in] Indicates any virtual keys that are down, such as the CTRL key or the left mouse button. Список возможных значений смотрите клавиши под разделом dwKeys параметра lParam WM_APPCOMMAND.For a list of possible values, see the keys under the dwKeys section of the lParam parameter of WM_APPCOMMAND. Для получения дополнительной информации см. About Mouse InputFor more information, see the "Message Parameters" subheading in About Mouse Input.

RemarksRemarks

Этот метод получает уведомление WM_APPCOMMAND, которое описано в SDK Windows.This method receives the WM_APPCOMMAND notification, which is described in the Windows SDK.

Note

Это функция-член вызывается платформой, чтобы разрешить приложению обработать сообщение Windows.This member function is called by the framework to allow your application to handle a Windows message. Параметры, передаваемые в функцию, отражают параметры, полученные платформой при поступлении сообщения.The parameters passed to your function reflect the parameters received by the framework when the message was received. При вызове реализации базового класса этой функции эта реализация будет использовать параметры, изначально переданные с сообщением, а не параметры, передаваемые в функции.If you call the base-class implementation of this function, that implementation will use the parameters originally passed with the message and not the parameters you supply to the function.

CWnd::OnAskCbFormatNameCWnd::OnAskCbFormatName

Рамочная функция вызывает эту функцию, когда Clipboard содержит ручку данных для формата CF_OWNERDISPLAY (т.е. когда владелец Clipboard будет отображать содержимое Clipboard).The framework calls this member function when the Clipboard contains a data handle for the CF_OWNERDISPLAY format (that is, when the Clipboard owner will display the Clipboard contents).

afx_msg void OnAskCbFormatName(
    UINT nMaxCount,
    LPTSTR lpszString);

ПараметрыParameters

nMaxCountnMaxCount
Определяет максимальное количество байтов для копирования.Specifies the maximum number of bytes to copy.

lpszStringlpszString
Указывает на буфер, где хранится копия имени формата.Points to the buffer where the copy of the format name is to be stored.

RemarksRemarks

Владелец Clipboard должен узнать название своего формата.The Clipboard owner should provide a name for its format.

Переопределить эту функцию участника и скопировать имя формата CF_OWNERDISPLAY в указанный буфер, не превышая максимальное количество указанных байтов.Override this member function and copy the name of the CF_OWNERDISPLAY format into the specified buffer, not exceeding the maximum number of bytes specified.

Note

Это функция-член вызывается платформой, чтобы разрешить приложению обработать сообщение Windows.This member function is called by the framework to allow your application to handle a Windows message. Параметры, передаваемые в функцию, отражают параметры, полученные платформой при поступлении сообщения.The parameters passed to your function reflect the parameters received by the framework when the message was received. При вызове реализации базового класса этой функции эта реализация будет использовать параметры, изначально переданные с сообщением, а не параметры, передаваемые в функции.If you call the base-class