Класс 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

nameName ОписаниеDescription
CWnd:: CWndCWnd::CWnd Создает объект CWnd.Constructs a CWnd object.

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

nameName ОписаниеDescription
CWnd:: АккдодефаултактионCWnd::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:: АкклокатионCWnd::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:: БегинмодалстатеCWnd::BeginModalState Данная функция-член вызывается для преобразования окна фрейма в модальное.Call this member function to make a frame window modal.
CWnd:: БегинпаинтCWnd::BeginPaint Подготавливает CWnd к рисованию.Prepares CWnd for painting.
CWnd:: БинддефаултпропертиCWnd::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:: БиндпропертиCWnd::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:: БрингвиндовтотопCWnd::BringWindowToTop Перемещает CWnd на вершину стека перекрывающихся окон.Brings CWnd to the top of a stack of overlapping windows.
CWnd:: КалквиндовректCWnd::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:: ЧеккрадиобуттонCWnd::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:: КлиенттоскринCWnd::ClientToScreen Преобразует клиентские координаты указанной точки или прямоугольника на экране в экранные координаты.Converts the client coordinates of a given point or rectangle on the display to screen coordinates.
CWnd::CloseWindowCWnd::CloseWindow Сворачивает окно.Minimizes the window.
CWnd:: КонтинуемодалCWnd::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::D етачCWnd::Detach Отсоединяет дескриптор Windows от объекта CWnd и возвращает дескриптор.Detaches a Windows handle from a CWnd object and returns the handle.
CWnd::D ЛгдирлистCWnd::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::D ЛгдирселектCWnd::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::D РагакцептфилесCWnd::DragAcceptFiles Указывает, что в окно можно перетаскивать файлы.Indicates the window will accept dragged files.
CWnd::D РагдетектCWnd::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::D РаваниматедректсCWnd::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::D РавкаптионCWnd::DrawCaption Рисует заголовок.Draws a caption.
CWnd::D РавменубарCWnd::DrawMenuBar Перерисовывает строку меню.Redraws the menu bar.
CWnd:: ЕнаблеактивеакцессибилитиCWnd::EnableActiveAccessibility Включает пользовательские функции Active Accessibility.Enables user-defined Active Accessibility functions.
CWnd:: ЕнаблединамиклайаутCWnd::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:: ЕнаблескроллбарCWnd::EnableScrollBar Включает или выключает одну или обе стрелки полосы прокрутки.Enables or disables one or both arrows of a scroll bar.
CWnd:: ЕнаблескроллбарктрлCWnd::EnableScrollBarCtrl Включает или выключает элемент управления "Полоса прокрутки" того же уровня.Enables or disables a sibling scroll-bar control.
CWnd:: ЕнаблетултипсCWnd::EnableToolTips Включает элемент управления "Всплывающая подсказка".Enables the tooltip control.
CWnd:: ЕнаблетраккингтултипсCWnd::EnableTrackingToolTips Включает элемент управления "Всплывающая подсказка" в режиме отслеживания.Enables the tooltip control in tracking mode.
CWnd::EnableWindowCWnd::EnableWindow Разрешает или запрещает ввод с помощью мыши и клавиатуры.Enables or disables mouse and keyboard input.
CWnd:: ЕндмодаллупCWnd::EndModalLoop Снимает с окна модальное состояние.Ends a window's modal status.
CWnd::EndModalStateCWnd::EndModalState Данная функция-член вызывается для изменения состояния окна с модального на немодальное.Call this member function to change a frame window from modal to modeless.
CWnd:: ЕндпаинтCWnd::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:: FlashWindow интерфейсаCWnd::FlashWindow Окно однократно мигает.Flashes the window once.
CWnd:: ФлашвиндовексCWnd::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:: ФромхандлеперманентCWnd::FromHandlePermanent Возвращает указатель на объект 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::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:: PropertyCWnd::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:: ХилитеменуитемCWnd::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:: недействительностьCWnd::Invalidate Делает недействительной всю клиентскую область.Invalidates the entire client area.
CWnd:: ИнвалидатеректCWnd::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:: ИсдинамиклайаутенабледCWnd::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:: a IconCWnd::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:: с масштабомCWnd::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:: МапвиндовпоинтсCWnd::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:: МодифистилеCWnd::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:: НотифивиневентCWnd::NotifyWinEvent Сообщает системе, что произошло предопределенное событие.Signals the system that a predefined event occurred.
CWnd:: ОнамбиентпропертиCWnd::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:: ОнхелпусингCWnd::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:: ОпенклипбоардCWnd::OpenClipboard Открывает буфер обмена.Opens the Clipboard. Другие приложения не смогут изменять буфер обмена, пока не будет вызвана функция Windows клосеклипбоард .Other applications will not be able to modify the Clipboard until the Windows CloseClipboard function is called.
CWnd::P АинтвиндовлессконтролсCWnd::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 Разрешает выполнение других необходимых подклассов до вызова субклассвиндов .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::P печатьCWnd::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:: РелеаседкCWnd::ReleaseDC Освобождает контексты устройств клиента и окна, делая возможным их использование другими приложениями.Releases client and window device contexts, freeing them for use by other applications.
CWnd:: РепоситионбарсCWnd::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:: СкринтоклиентCWnd::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:: СендчилднотифиластмсгCWnd::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:: СендмессажетодесцендантсCWnd::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:: СеткаптуреCWnd::SetCapture Весь последующий ввод с помощью мыши передается объекту CWnd.Causes all subsequent mouse input to be sent to the CWnd.
CWnd:: СеткаретпосCWnd::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:: СетдлгитеминтCWnd::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:: СетфонтCWnd::SetFont Задает текущий шрифт.Sets the current font.
CWnd::SetForegroundWindowCWnd::SetForegroundWindow Помещает создавший окно поток на передний план и активирует окно.Puts the thread that created the window into the foreground and activates the window.
CWnd:: СетиконCWnd::SetIcon Задает дескриптор для указанного значка.Sets the handle to a specific icon.
CWnd:: SetLayeredWindowAttributesCWnd::SetLayeredWindowAttributes Задает ключ цвета прозрачности многослойного окна.Sets the opacity and transparency color key of a layered window.
CWnd:: СетменуCWnd::SetMenu Меняет указанное меню на новое.Sets the menu to the specified menu.
CWnd::SetOwnerCWnd::SetOwner Изменяет владельца объекта CWnd.Changes the owner of a CWnd.
CWnd:: СетпарентCWnd::SetParent Изменяет родительское окно.Changes the parent window.
CWnd:: SetPropertyCWnd::SetProperty Задает свойство элемента управления ActiveX.Sets an ActiveX control property.
CWnd:: СетредравCWnd::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:: СетскроллпосCWnd::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:: ШововнедпопупсCWnd::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:: СубклассдлгитемCWnd::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:: УпдатедатаCWnd::UpdateData Инициализирует или извлекает данные из диалогового окна.Initializes or retrieves data from a dialog box.
CWnd:: УпдатедиалогконтролсCWnd::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:: ВалидатеректCWnd::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

nameName ОписаниеDescription
CWnd::D молчаниюCWnd::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::D ОдатаексчанжеCWnd::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:: ИнитдинамиклайаутCWnd::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:: ОнкаптуречанжедCWnd::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:: ОнчартоитемCWnd::OnCharToItem Вызывается дочерним списком со стилем LBS_WANTKEYBOARDINPUT в ответ на сообщение WM_CHAR .Called by a child list box with the LBS_WANTKEYBOARDINPUT style in response to a WM_CHAR message.
CWnd:: ОнчилдактиватеCWnd::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:: ОнчилднотифиCWnd::OnChildNotify Вызывается родительским окном, чтобы позволить уведомляющему элементу управления ответить на уведомление элемента управления.Called by a parent window to give a notifying control a chance to respond to a control notification.
CWnd:: ОнклипбоардупдатеCWnd::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:: oncompactCWnd::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:: ОнкомпоситиончанжедCWnd::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:: ОнкопидатаCWnd::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:: ОндеадчарCWnd::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 Вызывается, когда буфер обмена очищается с помощью вызова функции Емптиклипбоард Windows.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:: ОндравитемCWnd::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:: ОндропфилесCWnd::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:: ОнендсессионCWnd::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:: ОнекситменулупCWnd::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:: ОнлбуттондовнCWnd::OnLButtonDown Вызывается, когда пользователь щелкает левой кнопкой мыши.Called when the user presses the left mouse button.
CWnd:: ОнлбуттонупCWnd::OnLButtonUp Вызывается, когда пользователь отпускает левую кнопку мыши.Called when the user releases the left mouse button.
CWnd:: ОнмбуттондблклкCWnd::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:: ОнмдиактиватеCWnd::OnMDIActivate Вызывается при активации или деактивации дочернего окна MDI.Called when an MDI child window is activated or deactivated.
CWnd:: ОнмеасуреитемCWnd::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:: ОнменучарCWnd::OnMenuChar Вызывается, когда пользователь нажимает назначенный символ меню, не соответствующий ни одному из символов, назначенных для текущего меню.Called when the user presses a menu mnemonic character that doesn't match any of the predefined mnemonics in the current menu.
CWnd:: ОнменудрагCWnd::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:: ОнменурбуттонупCWnd::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 Вызывается при наведении курсора на клиентскую область окна в течение периода времени, указанного в предыдущем вызове метода TrackMouseEven.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 Вызывается, когда курсор покидает клиентскую область окна, указанное в предыдущем вызове метода TrackMouseEven.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:: ОннкактиватеCWnd::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 Вызывается перед созданием при создании области без клиента.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:: ОннклбуттондблклкCWnd::OnNcLButtonDblClk Вызывается, если пользователь дважды щелкает левой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user double-clicks the left mouse button while the cursor is within a non-client area of CWnd.
CWnd:: ОннклбуттондовнCWnd::OnNcLButtonDown Вызывается, если пользователь щелкает левой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user presses the left mouse button while the cursor is within a non-client area of CWnd.
CWnd:: ОннклбуттонупCWnd::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:: ОннкмбуттондовнCWnd::OnNcMButtonDown Вызывается, если пользователь щелкает средней кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user presses the middle mouse button while the cursor is within a non-client area of CWnd.
CWnd:: ОннкмбуттонупCWnd::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 Вызывается при наведении курсора на неклиентскую область окна в течение периода времени, указанного в предыдущем вызове метода TrackMouseEven.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 Платформа вызывает эту функцию-член, когда курсор покидает неклиентскую область окна, заданную в предыдущем вызове метода TrackMouseEven.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:: ОннкпаинтCWnd::OnNcPaint Вызывается, когда требуется отрисовка неклиентской области.Called when the non-client area needs painting.
CWnd:: ОннкрбуттондблклкCWnd::OnNcRButtonDblClk Вызывается, если пользователь дважды щелкает правой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user double-clicks the right mouse button while the cursor is within a non-client area of CWnd.
CWnd:: ОннкрбуттондовнCWnd::OnNcRButtonDown Вызывается, если пользователь щелкает правой кнопкой мыши, когда курсор находится в пределах неклиентской области CWnd.Called when the user presses the right mouse button while the cursor is within a non-client area of CWnd.
CWnd:: ОннкрбуттонупCWnd::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:: ОннекстменуCWnd::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:: ОннотифиформатCWnd::OnNotifyFormat Вызывается для определения, принимает текущее окно в сообщении WM_NOTIFY структуры формата ANSI или Юникода.Called to determine if the current window accepts ANSI or Unicode structures in the WM_NOTIFY notification message.
CWnd:: onpainCWnd::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:: ОнпарентнотифиCWnd::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:: ОнповерброадкастCWnd::OnPowerBroadcast Вызывается при возникновении события управления питанием.Called when a power-management event occurs.
CWnd:: ОнкуеридрагиконCWnd::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:: ОнрбуттондблклкCWnd::OnRButtonDblClk Вызывается, когда пользователь дважды щелкает правой кнопкой мыши.Called when the user double-clicks the right mouse button.
CWnd:: ОнрбуттондовнCWnd::OnRButtonDown Вызывается, когда пользователь щелкает правой кнопкой мыши.Called when the user presses the right mouse button.
CWnd:: ОнрбуттонупCWnd::OnRButtonUp Вызывается, когда пользователь отпускает правую кнопку мыши.Called when the user releases the right mouse button.
CWnd:: ОнрендераллформатсCWnd::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:: ОнсессиончанжеCWnd::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 Указывает, что функция Windows SetWindowLong изменила один или несколько стилей окна.Indicates that the SetWindowLong Windows function has changed one or more of the window's styles.
CWnd::OnStyleChangingCWnd::OnStyleChanging Указывает, что функция Windows SetWindowLong собирается изменить один или несколько стилей окна.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:: ОнсискоммандCWnd::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:: ОнткардCWnd::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 Вызывается после каждого интервала, указанного в сеттимер.Called after each interval specified in SetTimer.
CWnd:: ОнтаучинпутCWnd::OnTouchInput Обработка одного ввода Windows touch.Process single input from Windows touch.
CWnd:: ОнтаучинпутсCWnd::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 Вызывается, когда размер, расположение или Z-порядок изменились в результате вызова 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 Вызывается, когда размер, расположение или Z-порядок собирается измениться в результате вызова 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:: ОнксбуттонупCWnd::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:: РефлектчилднотифиCWnd::ReflectChildNotify Вспомогательная функция, отражающая сообщение его источнику.Helper function which reflects a message to its source.
CWnd:: РефлектластмсгCWnd::ReflectLastMsg Отражает последнее сообщение дочернему окну.Reflects the last message to the child window.
CWnd:: РесизединамиклайаутCWnd::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

nameName ОписаниеDescription
CWnd:: operator HWNDCWnd::operator HWND Вызывается для получения дескриптора окна.Call to get a handle to a window.
CWnd:: operator! =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

nameName ОписаниеDescription
CWnd::m_hWndCWnd::m_hWnd Указывает HWND, присоединенный к CWndэтому объекту.Indicates the HWND attached to this CWnd.

ПримечанияRemarks

Объект 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. Функция дестройвиндов уничтожает окно Windows без уничтожения объекта.The DestroyWindow function destroys the Windows window without destroying the object.

Класс и механизм карт сообщений WndProc скрывают функцию. CWndThe CWnd class and the message-map mechanism hide the WndProc function. Входящие сообщения уведомлений Windows автоматически направляются через схему сообщений в соответствующие функции-членысообщений CWnd .Incoming Windows notification messages are automatically routed through the message map to the proper OnMessage CWnd member functions. Вы переопределяете функцию-член длясообщения , чтобы обрабатывалось конкретное сообщение члена в производных классах.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 дочернее окно и присоединить его к объекту.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, например кбуттон, можно использовать напрямую или использовать для дальнейшего наследования классов.The control classes derived from CWnd, such as CButton, can be used directly or can be used for further derivation of classes.

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

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

CObjectCObject

CCmdTargetCCmdTarget

CWnd

ТребованияRequirements

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

CWnd:: АккдодефаултактионCWnd::accDoDefaultAction

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

virtual HRESULT accDoDefaultAction(VARIANT varChild);

ПараметрыParameters

варчилдvarChild
Указывает, должно ли вызываться действие по умолчанию в отношении объекта или одного из дочерних элементов объекта.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:: аккдодефаултактион в Windows SDK.See Return Values in IAccessible::accDoDefaultAction in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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:: аккдодефаултактион в 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

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

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

пварчилдpvarChild
Получает сведения, идентифицирующие объект в точке, указанной в параметре кслефт и итоп.Receives information identifying the object at the point specified by xLeft and yTop. См. раздел пварид in IAccessible:: акчиттест в 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 в Windows SDK.See Return Values in IAccessible::accHitTest in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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:: акчиттест в Windows SDK.For more information, see IAccessible::accHitTest in the Windows SDK.

CWnd:: АкклокатионCWnd::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

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

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

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

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

варчилдvarChild
Указывает, является ли извлекаемое расположение объектом или одним из дочерних элементов объекта.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 в Windows SDK.See Return Values in IAccessible::accLocation in the Windows SDK.

ПримечанияRemarks

Переопределяйте эту функцию в 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 разделе Windows SDK.For more information, see IAccessible::accLocation in the Windows SDK.

CWnd:: АккнавигатеCWnd::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

навдирnavDir
Указывает направление перехода.Specifies the direction to navigate. См. раздел навдир in IAccessible:: аккнавигате в Windows SDK.See navDir in IAccessible::accNavigate in the Windows SDK.

варстартvarStart
Задает начальный объект.Specifies the starting object. См . раздел IAccessible::accNavigate варстарт в Windows SDK.See varStart in IAccessible::accNavigate in the Windows SDK.

пварендупатpvarEndUpAt
Получает сведения о целевом объекте пользовательского интерфейса.Receives information about the destination user interface object. См . раздел 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 в Windows SDK.See Return Values in IAccessible::accNavigate in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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:: аккнавигате в 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. См. раздел флагсселект in IAccessible:: аккселект в Windows SDK.See flagsSelect in IAccessible::accSelect in the Windows SDK.

варчилдvarChild
Указывает объект для выбора.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 в Windows SDK.See Return Values in IAccessible::accSelect in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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:: аккселект в 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

двтимеdwTime
Указывает время, затрачиваемое на воспроизведение анимации в миллисекундах.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. Полный список возможных значений см. в разделе аниматевиндов.For a full list of possible values, see AnimateWindow.

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

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

ПримечанияRemarks

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

CWnd:: АрранжеикониквиндовсCWnd::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.

ПримечанияRemarks

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

Чтобы разместить значки дочерних MDI-окон в окне клиента MDI, вызовите метод CMDIFrameWnd:: мдииконарранже.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:: AttachCWnd::Attach

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

BOOL Attach(HWND hWndNew);

ПараметрыParameters

хвндневhWndNew
Задает маркер окна 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:: БегинмодалстатеCWnd::BeginModalState

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

virtual void BeginModalState();

CWnd:: БегинпаинтCWnd::BeginPaint

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

CDC* BeginPaint(LPPAINTSTRUCT lpPaint);

ПараметрыParameters

лппаинтlpPaint
Указывает на структуру PAINTSTRUCT , которая предназначена для получения сведений о выкраске.Points to the PAINTSTRUCT structure that is to receive painting information.

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

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

ПримечанияRemarks

Структура заливки содержит структуру данных 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.

Область обновления задается функциями Invalidate, InvalidateRect или InvalidateRgn и системой после ее размера, перемещения, создания, прокрутки или выполнения любой другой операции, влияющей на клиентскую область.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 функции-члена должен иметь соответствующий вызов функции-члена ендпаинт .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:: БинддефаултпропертиCWnd::BindDefaultProperty

Привязывает свойство простого связанного объекта по умолчанию (например, элемент управления "поле ввода"), как указано в библиотеке типов, к базовому курсору, определенному в свойствах DataSource, UserName, Password и SQL элемента управления источника данных.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

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

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

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

пдсквндpDSCWnd
Указывает на окно, в котором размещен элемент управления источника данных, к которому будет привязано свойство.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.

ПримечанияRemarks

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:: БиндпропертиCWnd::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.

пвнддскpWndDSC
Указывает на окно, в котором размещен элемент управления источника данных, к которому будет привязано свойство.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.

ПримечанияRemarks

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:: БрингвиндовтотопCWnd::BringWindowToTop

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

void BringWindowToTop();

ПримечанияRemarks

Кроме того 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 брингвиндовтотоп .This function just calls the Win32 BringWindowToTop function. Вызовите функцию SetWindowPos , чтобы изменить расположение окна в Z-порядке.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_TOPMOST .For 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

лпклиентректlpClientRect
[вход, выход] Указатель на структуру прямоугольника.[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.

наджусттипеnAdjustType
окне Используйте 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.

ПримечанияRemarks

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

Дополнительные ограничения на использование см. в разделе аджуствиндовректекс.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:: КанцелтултипсCWnd::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

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

ПримечанияRemarks

Примечание

Использование этой функции – члена не влияет на подсказки инструментов, которыми управляет ваш код.Using this member function has no effect on tool tips managed by your code. Он влияет только на элемент управления «подсказка», управляемый CWnd:: енаблетултипс.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

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

ПримечанияRemarks

Обычно вызывается из класса CDialog:: онинитдиалог в центр диалоговых окон по отношению к главному окну приложения.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. Чтобы центрировать окно относительно определенного окна, которое не является владельцем или родителем, параметр палтернатеовнер может быть установлен в допустимое окно.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:: жетдесктопвиндов как палтернатеовнер.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:: ЧанжеклипбоардчаинCWnd::ChangeClipboardChain

Удаляет CWnd из цепочки средств просмотра буфера обмена и делает окно заданным, хвнднекст потомки CWnd предка в цепочке.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

хвнднекстhWndNext
Определяет окно, следующее CWnd в цепочке средства просмотра буфера обмена.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

нидбуттонnIDButton
Задает изменяемую кнопку.Specifies the button to be modified.

nДополнительныеnCheck
Указывает действие, которое необходимо выполнить.Specifies the action to take. Если nДополнительные имеет ненулевое 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. Для кнопок с тремя состояниями, если nДополнительные имеет значение 2, состояние кнопки является неопределенным.For three-state buttons, if nCheck is 2, the button state is indeterminate.

ПримечанияRemarks

Функция 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:: ЧеккрадиобуттонCWnd::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

нидфирстбуттонnIDFirstButton
Задает целочисленный идентификатор для первого переключателя в группе.Specifies the integer identifier of the first radio button in the group.

нидластбуттонnIDLastButton
Задает целочисленный идентификатор последнего переключателя в группе.Specifies the integer identifier of the last radio button in the group.

нидчеккбуттонnIDCheckButton
Задает целочисленный идентификатор переключателя для проверки.Specifies the integer identifier of the radio button to be checked.

ПримечанияRemarks

Функция 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

pointpoint
Указывает клиентские координаты проверяемой точки.Specifies the client coordinates of the point to be tested.

нфлагс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:: КлиенттоскринCWnd::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

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

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

ПримечанияRemarks

CRect CPoint POINT RECT Функция члена использует координаты клиента в структуре или или объект или, на который указывает лппоинт или лпрект для вычислений новых экранных координат; затем ClientToScreen заменяет координаты в структуре новыми координатами.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();

ПримечанияRemarks

Эта функция члена эмулирует функциональность функции клосевиндов, как описано в 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

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

ПримечанияRemarks

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

CWnd::CreateCWnd::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

лпсзкласснамеlpszClassName
окне Указатель на строку, завершающуюся нулем, которая содержит имя зарегистрированного системного класса окна; или имя стандартного класса системного окна.[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.

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

двстилеdwStyle
окне Побитовое сочетание (или) стилей окна.[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.

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

nIDnID
окне ИДЕНТИФИКАТОР окна.[in] ID of the window.

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

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

Значение TRUE, если метод выполнен успешно; в противном случае — FALSE.TRUE if the method was successful; otherwise FALSE.

ПримечанияRemarks

Предупреждение

CWnd::PreCreateWindowТеперь присваивает этому указателю элемент HMENU своего CREATESTRUCT параметра, если меню имеет значение 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.

Используйте функцию афксрегистервндкласс для регистрации классов окон.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.

пресултpResult
Указатель на LRESULT, в котором хранится код результата.A pointer to an LRESULT that stores the result code.

ПримечанияRemarks

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

CWnd::CreateCaretCWnd::CreateCaret

Создает новую фигуру для системного курсора и владельца курсора.Creates a new shape for the system caret and claims ownership of the caret.

void CreateCaret(CBitmap* pBitmap);

ПараметрыParameters

пбитмапpBitmap
Определяет точечный рисунок, определяющий фигуру курсора.Identifies the bitmap that defines the caret shape.

ПримечанияRemarks

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

CreateCaretавтоматически удаляет предыдущую фигуру курсора, если она есть, независимо от того, какое окно владеет курсором.CreateCaret automatically destroys the previous caret shape, if any, regardless of which window owns the caret. После создания курсор изначально скрыт.Once created, the caret is initially hidden. Чтобы отобразить курсор, необходимо вызвать функцию члена шовкарет .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

псзклассpszClass
Эта строка может содержать "короткое имя" (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. Задает значение свойства Caption или Text элемента управления (если оно имеется).Sets the value of the control's Caption or Text property (if any). Если значение равно NULL, свойство Caption или Text элемента управления не изменяется.If NULL, the control's Caption or Text property is not changed.

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

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

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

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

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

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

пперсистpPersist
Указатель на кфиле , содержащий постоянное состояние для элемента управления.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.

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

бстрликкэйbstrLicKey
Необязательные данные лицензионного ключа.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.

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

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

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

ПримечанияRemarks

CreateControl— Это прямая аналоговая функция CWnd:: Create , которая создает окно для 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 двстиле поддерживается для CreateControlследующих компонентов:Only 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

Создает указанное окно и прикрепляет его к CWnd объекту.Creates 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

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

лпсзкласснамеlpszClassName
Указатель на строку, завершающуюся нулем, которая содержит имя зарегистрированного системного класса окна; или имя стандартного класса системного окна.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.

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

двстилеdwStyle
Побитовое сочетание (или) стилей окна; в противном случае значение 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.

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

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

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

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

лппарамlpParam
Указатель на данные пользователя, которые передаются в метод CWnd:: OnCreate в поле лпкреатепарамс .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.

ппарентвндpParentWnd
Для дочернего окна — Указатель на родительское окно; в противном случае — указатель на окно владельца, если у окна есть владелец.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

Значение TRUE, если метод выполнен успешно; в противном случае — FALSE.TRUE if the method was successful; otherwise FALSE.

ПримечанияRemarks

Предупреждение

CWnd::PreCreateWindowТеперь присваивает этому указателю элемент HMENU своего CREATESTRUCT параметра, если меню имеет значение 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.

Используйте функцию афксрегистервндкласс для регистрации классов окон.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

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

void CreateGrayCaret(
    int nWidth,
    int nHeight);

ПараметрыParameters

нвидсnWidth
Задает ширину курсора (в логических единицах).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.

нхеигхт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.

ПримечанияRemarks

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

Параметры нвидс и нхеигхт задают ширину и высоту курсора (в логических единицах); Точная ширина и высота (в пикселях) зависят от режима сопоставления.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.

В функции 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 – член автоматически удаляет предыдущую фигуру курсора, если она есть, независимо от того, какое окно владеет курсором.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. Чтобы отобразить курсор, необходимо вызвать функцию члена шовкарет .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

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

void CreateSolidCaret(
    int nWidth,
    int nHeight);

ПараметрыParameters

нвидсnWidth
Задает ширину курсора (в логических единицах).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.

нхеигхт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.

ПримечанияRemarks

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

Параметры нвидс и нхеигхт задают ширину и высоту курсора (в логических единицах); Точная ширина и высота (в пикселях) зависят от режима сопоставления.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.

В функции 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 – член автоматически удаляет предыдущую фигуру курсора, если она есть, независимо от того, какое окно владеет курсором.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. Чтобы отобразить курсор, необходимо вызвать функцию члена шовкарет .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();

ПримечанияRemarks

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

CWnd::D молчаниюCWnd::Default

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

LRESULT Default();

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

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

ПримечанияRemarks

Процедура окна по умолчанию предоставляет обработку по умолчанию для любого сообщения окна, которое не обрабатывается приложением.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.

ПримечанияRemarks

Эта функция-член гарантирует обработку каждого сообщения.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();

ПримечанияRemarks

Удаляет все временные 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

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

ПримечанияRemarks

Функция DestroyWindow – член отправляет в окно соответствующие сообщения, чтобы отключить его и удалить фокус ввода.The DestroyWindow member function sends appropriate messages to the window to deactivate it and remove the input focus. Он также уничтожает меню окна, очищает очередь приложений, уничтожает необработанные таймеры, удаляет владение буфером обмена и прерывает цепочку просмотра буфера, если CWnd находится в верхней части цепочки средств просмотра.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любом классе, производном от.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. Поскольку исходный код MFC не вызывает DestroyWindow ни в одном 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.

Функция Member также уничтожает немодальные диалоговые окна, созданные с помощью класса CDialog:: Create. DestroyWindowThe 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::D етачCWnd::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:: Attach.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

лппасспекlpPathSpec
Указывает на строку, завершающуюся нулем, которая содержит путь или имя файла.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.

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

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

нфилетипеnFileType
Задает атрибуты отображаемых файлов.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.

  • Флаг LB_DIR DDL_POSTMSGS.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.

ПримечанияRemarks

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

Параметр лппасспек имеет следующий вид:The lpPathSpec parameter has the following form:

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

В этом примере диск — это буква диска, Каталог — это допустимое имя каталога, а 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.

Если указать строку нулевой длины для лппасспекили указать только имя каталога, но не включать спецификацию файла, строка будет изменена на "*.*".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 "*.*".

Если лппасспек включает имя диска и/или каталога, то текущий диск и каталог заменяются на указанный диск и каталог до заполнения списка.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. Элемент управления Text, идентифицируемый нидстатикпас , также обновляется с новым именем диска и/или каталога.The text control identified by nIDStaticPath is also updated with the new drive and/or directory name.

После заполнения списка лппасспек обновляется путем удаления части диска и (или) каталога в пути.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

лппасспекlpPathSpec
Указывает на строку, завершающуюся нулем, которая содержит путь или имя файла.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.

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

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

нфилетипеnFileType
Указывает атрибуты файла 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.

  • Флаг CB_DIR DDL_POSTMSGS.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.

ПримечанияRemarks

DlgDirListComboBoxотправляет сообщения CB_RESETCONTENT и CB_DIR в поле со списком.DlgDirListComboBox sends CB_RESETCONTENT and CB_DIR messages to the combo box. Он заполняет список поля со списком, заданного параметром нидкомбобокс , именами всех файлов, которые соответствуют пути, заданному параметром лппасспек.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.

Параметр лппасспек имеет следующий вид:The lpPathSpec parameter has the following form:

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

В этом примере диск — это буква диска, Каталог — это допустимое имя каталога, а 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.

Если указать строку нулевой длины для лппасспек, будет использоваться текущий каталог и лппасспек не будет изменен.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 "*".

Если лппасспек включает имя диска и/или каталога, то текущий диск и каталог заменяются на указанный диск и каталог до заполнения списка.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. Элемент управления Text, идентифицируемый нидстатикпас , также обновляется с новым именем диска и/или каталога.The text control identified by nIDStaticPath is also updated with the new drive and/or directory name.

После заполнения списка с раскрывающимся списком лппасспек обновляется путем удаления диска и/или части каталога в пути.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::D ЛгдирселектCWnd::DlgDirSelect

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

BOOL DlgDirSelect(
    LPTSTR lpString,
    int nIDListBox);

ПараметрыParameters

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

нидлистбоксnIDListBox
Задает целочисленный идентификатор поля списка в диалоговом окне.Specifies the integer ID of a list box in the dialog box.

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

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

ПримечанияRemarks

Предполагается, что поле со списком заполнено функцией-членом длгдирлист и выбрана буква диска, файл или имя каталога.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.

Функция – член копирует выделенный фрагмент в буфер, заданный параметром лпстринг. DlgDirSelectThe DlgDirSelect member function copies the selection to the buffer given by 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

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

нидкомбобоксnIDComboBox
Задает целочисленный идентификатор поля со списком в диалоговом окне.Specifies the integer ID of the combo box in the dialog box.

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

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

ПримечанияRemarks

Предполагается, что поле со списком заполнено функцией-членом длгдирлисткомбобокс и выбрана буква диска, файл или имя каталога.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::D ОдатаексчанжеCWnd::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.

ПримечанияRemarks

Никогда не вызывайте эту функцию напрямую.Never call this function directly. Он вызывается функцией-членом упдатедата .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. Мастер добавления переменной запишет переопределенную версию этой функции-члена, которая содержит нужные вызовы глобальной функции обмена данными диалоговых данных (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, созданного мастером добавления переменной.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.

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

CWnd::D РагакцептфилесCWnd::DragAcceptFiles

Вызовите эту функцию-член из окна, используя CWnd указатель, в функции CWinApp:: InitInstance приложения, чтобы указать, что окно принимает удаленные файлы из диспетчера файлов Windows или проводника.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

бакцептBAccept
Флаг, указывающий, принимаются ли перетаскиваемые файлы.Flag that indicates whether dragged files are accepted.

ПримечанияRemarks

Только окно, вызывающее DragAcceptFiles параметр бакцепт , которому присвоено значение 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. Чтобы окно получало это сообщение, необходимо вызвать DragAcceptFiles с помощью CMDIChildWnd указателя окна. CMDIChildWndFor a CMDIChildWnd window to receive this message, you must call DragAcceptFiles with the CMDIChildWnd window pointer.

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

CWnd::D РагдетектCWnd::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

ptpt
Начальное расположение мыши в экранных координатах.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.

ПримечанияRemarks

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

CWnd::D РаваниматедректсCWnd::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, заголовок окна будет анимироваться от расположения, указанного параметром лпркфром , к положению, заданному параметром лпркто.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.

лпркфромlprcFrom
Указатель на структуру Rect , указывающую расположение и размер значка или сворачивания окна.Pointer to a RECT structure specifying the location and size of the icon or minimized window.

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

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

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

ПримечанияRemarks

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

CWnd::D РавкаптионCWnd::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.

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

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

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

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

ПримечанияRemarks

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

CWnd::D РавменубарCWnd::DrawMenuBar

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

void DrawMenuBar();

ПримечанияRemarks

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

ПримерExample

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

CWnd:: ЕнаблеактивеакцессибилитиCWnd::EnableActiveAccessibility

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

void EnableActiveAccessibility();

ПримечанияRemarks

Поддержка Active Accessibility по умолчанию в 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:: ЕнаблединамиклайаутCWnd::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.

ПримечанияRemarks

Чтобы включить динамический макет, наряду с вызовом этого метода необходимо выполнить дополнительные действия.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.

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

CWnd:: ЕнаблескроллбарCWnd::EnableScrollBar

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

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

ПараметрыParameters

нсбфлагсnSBFlags
Указывает тип полосы прокрутки.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.

нарровфлагсnArrowFlags
Указывает, включены или отключены стрелки полосы прокрутки и какие стрелки включены или отключены.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 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

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

bEnablebEnable
Указывает, должна ли быть включена или отключена полоса прокрутки.Specifies whether the scroll bar is to be enabled or disabled.

ПримечанияRemarks

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

CWnd:: ЕнаблетултипсCWnd::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.

ПримечанияRemarks

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

Примечание

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

Дополнительные сведения об этой структуре см. в разделе тулинфо в Windows SDK.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 псзтекст структуры, текст подсказки не будет отображаться.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:: ЕнаблетраккингтултипсCWnd::EnableTrackingToolTips

Включает или отключает отслеживание всплывающих подсказок.Enables or disables tracking tooltips.

BOOL EnableTrackingToolTips(BOOL bEnable = TRUE);

ПараметрыParameters

bEnablebEnable
Указывает, включены или отключены подсказки по средствам отслеживания.Specifies whether tracking tool tips are enabled or disabled. Если этот параметр имеет значение TRUE, подсказки средства отслеживания будут включены.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.

ПримечанияRemarks

Советы по инструментам отслеживания — это окна всплывающих подсказок, которые можно динамически разместить на экране.Tracking tool tips are tool tip windows that you can dynamically position on the screen. При быстром обновлении положения откроется окно подсказки, которое перемещается плавно, или «Track».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:: ЕнаблевиндовCWnd::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. Если этот параметр имеет значение TRUE, окно будет включено.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.

ПримечанияRemarks

Если входные данные отключены, ввод, например щелчок мыши и нажатие клавиш, игнорируется.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 или креатикс , чтобы создать окно, которое изначально отключено.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

NрезультатnResult
Содержит значение, возвращаемое вызывающему объекту RunModalLoop.Contains the value to be returned to the caller of RunModalLoop.

ПримечанияRemarks

Параметр nрезультат распространяется на возвращаемое значение из 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:: ЕндпаинтCWnd::EndPaint

Помечает конец рисования в данном окне.Marks the end of painting in the given window.

void EndPaint(LPPAINTSTRUCT lpPaint);

ПараметрыParameters

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

ПримечанияRemarks

Функция- BeginPaint член является обязательной для каждого вызова функции-члена, но только после завершения рисования. EndPaintThe 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:: бегинпаинт.See the example for CWnd::BeginPaint.

CWnd::ExecuteDlgInitCWnd::ExecuteDlgInit

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

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

ПараметрыParameters

лпсзресаурценамеlpszResourceName
Указатель на строку с завершающим нулем, указывающую имя ресурса.A pointer to a null-terminated string specifying the name of the resource.

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

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

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

ПримечанияRemarks

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 [U] [D]). DLL) AfxFindResourceHandle вызывает афксжетресаурцехандле, который возвращает текущий обработчик ресурсов для исполняемого объекта.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 [U] [D]. DLL, AfxFindResourceHandle проходит CDynLinkLibrary по списку объектов общих библиотек DLL расширения MFC и ищет правильный маркер ресурсов.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

пмсгpMsg
Указатель на сообщение подсказки.A pointer to the tool tip message.

ПримечанияRemarks

В большинстве приложений MFC этот метод вызывается платформой из претранслатемессаже и енаблетултипс, и вам не нужно вызывать его самостоятельно.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, эти методы могут не вызываться платформой, и вам нужно будет вызвать Филтертултипмессаже самостоятельно.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 , класс окон которого предоставляется параметром лпсзкласснаме , а имя окна или заголовок — лпсзвиндовнаме.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

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

лпсзвиндовнамеlpszWindowName
Указывает на строку, завершающуюся нулем, которая указывает имя окна (заголовок окна).Points to a null-terminated string that specifies the window name (the window's title). Если лпвиндовнаме имеет значение 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.

ПримечанияRemarks

Эта функция не выполняет поиск в дочерних окнах.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

Извлекает объект Window, имя класса и имя окна которого совпадают с указанными строками.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

хвндпарентhwndParent
Маркер родительского окна, для которого должны быть просмотрены дочерние окна.Handle to the parent window whose child windows are to be searched.

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

лпсзклассlpszClass
Указатель на строку, завершающуюся нулем, которая указывает имя класса или класс Atom, созданный предыдущим вызовом 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

Если функция выполнена, возвращаемое значение является указателем на объект Window с указанными именами класса и окна.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.

ПримечанияRemarks

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

CWnd:: FlashWindow интерфейсаCWnd::FlashWindow

Заflash заданное окно один раз.Flashes the given window once.

BOOL FlashWindow(BOOL bInvert);

ПараметрыParameters

бинвертbInvert
Указывает, должен CWnd ли объект быть мигать или возвращен в исходное состояние.Specifies whether the CWnd is to be flashed or returned to its original state. Объект CWnd будет мигать из одного состояния в другое, если бинверт имеет значение true.The CWnd is flashed from one state to the other if bInvert is TRUE. Если бинверт имеет значение false, окно возвращается в исходное состояние (активное или неактивное).If bInvert is FALSE, the window is returned to its original state (either active or inactive).

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

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

ПримечанияRemarks

Для последующего мигания Создайте системный таймер и повторно вызовите FlashWindow.For successive flashing, create a system timer and repeatedly call FlashWindow. Мигание CWnd означает изменение внешнего вида строки заголовка так, как будто изменилось с неактивного на активное состояние, или наоборот. CWndFlashing 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.

Параметр бинверт должен иметь значение false, только если окно получает фокус ввода и больше не будет мигать; при последовательных вызовах он должен иметь значение TRUE, ожидая получения фокуса ввода.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 будет просто мигать значок окна. бинверт игнорируется для сворачивания окон.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:: ФлашвиндовексCWnd::FlashWindowEx

Завспышки в заданном окне.Flashes the given window.

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

ПараметрыParameters

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

укаунтuCount
Указывает количество попыток мигания окна.Specifies the number of times to flash the window.

двтимеаутdwTimeout
Указывает скорость в миллисекундах, с которой окно будет мигать.Specifies the rate, in milliseconds, at which the window will be flashed. Если двтимеаут равен нулю, функция использует частоту мерцания курсора по умолчанию.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.

ПримечанияRemarks

Этот метод эмулирует функциональность функции флашвиндовекс, как описано в 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:: Фромхандлеперманент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.

ПримечанияRemarks

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

варчилдvarChild
Определяет дочерний 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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

пкаунтчилдренpcountChildren
Получает число дочерних элементов.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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, является ли возвращаемое действие по умолчанию объектом или одним из дочерних элементов объекта.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).

псздефаултактионpszDefaultAction
Адрес строки 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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, является ли извлекаемое описание объектом или одним из дочерних элементов объекта.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).

псздескриптион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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

пварчилдpvarChild
Получает сведения об объекте, который находится в фокусе.Receives information about the object that has the focus. См. раздел пварид in 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 в Windows SDK.See Return Values in IAccessible::get_accFocus in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, должны ли извлекаться справочные сведения — объект или один из дочерних элементов объекта.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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

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

варчилдvarChild
Указывает, должен ли раздел справки извлекаться из объекта или одного из дочерних элементов объекта.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).

пидтопикpidTopic
Определяет раздел файла справки, связанный с указанным объектом.Identifies the Help file topic associated with the specified object. См. раздел пидтопик in 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 в Windows SDK.See Return Values in IAccessible::get_accHelpTopic in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, следует ли получать сочетание клавиш для объекта или для одного из дочерних элементов объекта.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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, является ли извлекаемое имя объектом или одним из дочерних элементов объекта.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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

ппдисппарентppdispParent
Получает адрес 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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, являются ли извлекаемые сведения о роли объектом или одним из дочерних элементов объекта.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).

пварролеpvarRole
Получает сведения о роли.Receives the role information. См. раздел пварроле in 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 в Windows SDK.See Return Values in IAccessible::get_accRole in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

пварчилдренpvarChildren
Получает сведения о том, какие дочерние элементы выбраны.Receives information about which children are selected. См. раздел пварчилдрен in 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 в Windows SDK.See Return Values in IAccessible::get_accSelection in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, являются ли извлекаемые сведения о состоянии объектом или одним из дочерних элементов объекта.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).

пварстатеpvarState
Получает сведения о состоянии объекта.Receives information about the object's state. См. раздел пварстате in 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 в Windows SDK.See Return Values in IAccessible::get_accState in the Windows SDK.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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

варчилдvarChild
Указывает, являются ли получаемые сведения о значениях объектом или одним из дочерних элементов объекта.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).

псзвалуеpszValue
Адрес строки 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.

ПримечанияRemarks

Эта функция является частью поддержки Active ACCESSIBILITY 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.

ПримечанияRemarks

Активное окно — это либо окно с текущим фокусом ввода, либо окно, явно активное функцией-членом сетактивевиндов .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:: ancestorCWnd::GetAncestor

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

CWnd* GetAncestor(UINT gaFlags) const;

ПараметрыParameters

гафлагсgaFlags
Указывает извлекаемый предок.Specifies the ancestor to be retrieved. Полный список возможных значений см. в разделе- предок.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.

ПримечанияRemarks

Эта функция — имитирует функциональные возможности функции с именем ancestor, как описано в 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.

ПримечанияRemarks

Только одно окно захватывает мышь в любое заданное время.Only one window has the mouse capture at any given time. Окно получает захват мыши при вызове функции-члена сеткаптуре .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

Возвращает клиентские координаты текущей позиции курсора и возвращает их в виде 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.

ПримечанияRemarks

Позиции курсора задаются в клиентских координатах 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

нидфирстбуттонnIDFirstButton
Задает целочисленный идентификатор для первого переключателя в группе.Specifies the integer identifier of the first radio button in the group.

нидластбуттонnIDLastButton
Задает целочисленный идентификатор последнего переключателя в группе.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 клиентской области в структуру, на которую указывает лпрект.Copies the client coordinates of the CWnd client area into the structure pointed to by lpRect.

void GetClientRect(LPRECT lpRect) const;

ПараметрыParameters

лпректlpRect
Указывает на структуру 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.

ПримечанияRemarks

Клиентские координаты указывают верхний левый и нижний правый угол клиентской области.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:: «Icon».See the example for CWnd::IsIconic.

CWnd::GetClipboardOwnerCWnd::GetClipboardOwner

Извлекает текущего владельца буфера обмена.Retrieves the current owner of the Clipboard.

static CWnd* PASCAL GetClipboardOwner();

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

Определяет окно, которому принадлежит буфер обмена, если функция выполнена успешно.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.

ПримечанияRemarks

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

CWnd::GetClipboardViewerCWnd::GetClipboardViewer

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

static CWnd* PASCAL GetClipboardViewer();

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

Определяет окно, которое в настоящее время отвечает за отображение буфера обмена в случае успеха; в противном случае — 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.

ПримечанияRemarks

Не следует освобождать этот 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. Должен вызываться только в обработчикесообщений on.Should only be called when in an OnMessage handler.

ПримерExample

См. пример для CMDIFrameWnd:: мдикаскаде.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.

ПримечанияRemarks

Для общих контекстов устройств 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.

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

Контекст устройства, принадлежащий CWnd классу, возвращается GetDC функцией-членом, если CS_CLASSDC, CS_OWNDC или CS_PARENTDC были указаны в WNDCLASS качестве стиля в структуре при регистрации класса.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

пргнклипprgnClip
Определяет область обрезки, которая может быть объединена с видимой областью окна клиента.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 Возвращает контекст устройства из кэша, а не из окна ОВНДК или КЛАССДК.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 исключает область обрезки, обозначенную пргнклип , из видимой области возвращаемого контекста устройства.DCX_EXCLUDERGN Excludes the clipping region identified by prgnClip from the visible region of the returned device context.

  • DCX_INTERSECTRGN пересекает область обрезки, обозначенную пргнклип , в видимой области возвращаемого контекста устройства.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.

ПримечанияRemarks

Контекст устройства можно использовать в последующих функциях 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.

Если контекст устройства не принадлежит классу окна, необходимо вызвать функцию релеаседк , чтобы освободить контекст после рисования.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.

Контекст устройства с особыми характеристиками возвращается функцией жетдцекс , если при регистрации класса в структуре вндкласс был указан стиль CS_CLASSDC, CS_OWNDCили CS_PARENTDC .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 структуры в Windows SDK.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.

ПримечанияRemarks

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.

бонлипермbOnlyPerm
Указывает, может ли возвращаемое окно быть временным.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. Дополнительные сведения о временных окнах см. в техническом примечании 3.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.

ПримечанияRemarks

Эта функция члена выполняет поиск по всему дереву дочерних окон, а не только к окнам, которые являются непосредственными дочерними элементами.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.

ПримечанияRemarks

Окно рабочего стола охватывает весь экран и является областью, на которой рисуются все значки и другие окна.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.

ПримечанияRemarks

Так как окна верхнего уровня не имеют значения идентификатора, возвращаемое значение этой функции является недопустимым, если 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:: онктлколор.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.

фвндphWnd
Указатель на дочернее окно.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.

ПримечанияRemarks

Возвращаемый указатель обычно приводится к типу элемента управления, идентифицируемого 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.

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

бсигнедbSigned
Указывает, подписывается ли возвращаемое значение.Specifies whether the value to be retrieved is signed.

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

Задает переведенное значение текста элемента диалогового окна.Specifies the translated value of the dialog-box item text. Поскольку 0 является допустимым возвращаемым значением, для обнаружения ошибок необходимо использовать лптранс .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 в расположение, на которое указывает лптранс.When errors occur, such as encountering nonnumeric characters and exceeding the above maximum, GetDlgItemInt copies 0 to the location pointed to by lpTrans. Если ошибок нет, лптранс получает ненулевое значение.If there are no errors, lpTrans receives a nonzero value. Если лптранс имеет значение NULL GetDlgItemInt , не предупреждает об ошибках.If lpTrans is NULL, GetDlgItemInt does not warn about errors.

ПримечанияRemarks

Он преобразует текст указанного элемента управления в заданном диалоговом окне в целочисленное значение, удаляя лишние пробелы в начале текста и преобразуя десятичные разряды.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.

Если бсигнед имеет значение true 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.

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

rStrrString
Ссылка на 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.

ПримечанияRemarks

Функция-член копирует текст в расположение, на которое указывает LPSTR, и возвращает количество копируемых байтов. GetDlgItemTextThe 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 и SQL элемента управления источника данных.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.

ПримечанияRemarks

Используйте возвращаемый указатель, чтобы задать свойство Икурсор сложного элемента управления с привязкой к данным, например элемент управления сетки с привязкой к данным.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.

ПримечанияRemarks

Объект окна владеет и управляет временем жизни возвращаемого указателя, поэтому его следует использовать только для доступа к этому объекту. Не удаляйте указатель или сохраняйте его перманентно.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

Указатель на объект кфонт , присоединенный к текущему шрифту окна.Pointer to a CFont object that is attached to the current font for the window.

ПримечанияRemarks

Этот метод не действует, если только окно не обрабатывает сообщение 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.

ПримечанияRemarks

Окно переднего плана применяется только к окнам верхнего уровня (окнам фрейма или диалоговым окнам).The foreground window applies only to top-level windows (frame windows or dialog boxes).

CWnd:: "Icon"CWnd::GetIcon

Вызовите эту функцию-член, чтобы получить маркер для большого (32x32) или маркера на маленький значок (16x16), как указано в ббигикон.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

ббигиконbBigIcon
Задает значок 32 пикселей на 32 пикселей, если значение TRUE; Задает значок 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

пкркэйpcrKey
Указатель на значение 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.

пбалфаpbAlpha
Указатель на байт, который получает альфа-значение, используемое для описания прозрачности многоуровневого окна.Pointer to a BYTE that receives the Alpha value used to describe the opacity of the layered window. Если переменная, на которую ссылается пбалфа , имеет значение 0, окно полностью прозрачно.When the variable referred to by pbAlpha is 0, the window is completely transparent. Если переменная, на которую ссылается пбалфа , имеет значение 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.

пдвфлагсpdwFlags
Указатель на DWORD, принимающий флаг слоев.Pointer to a DWORD that receives a layering flag. Может иметь значение NULL, если аргумент не требуется.This can be NULL if the argument is not needed. Полный список возможных значений см. в разделе жетлайередвиндоваттрибутес.For a complete list of possible values, see GetLayeredWindowAttributes.

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

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

ПримечанияRemarks

Эта функция члена эмулирует функциональность функции жетлайередвиндоваттрибутес, как описано в Windows SDK.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.

ПримечанияRemarks

Эта функция не должна использоваться для дочерних окон, так как у них нет меню.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

идобжектidObject
Указывает объект меню.Specifies the menu object. Список возможных значений см. в разделе GetMenuBarInfo.For a list of possible values, see GetMenuBarInfo.

идитемidItem
Указывает элемент, для которого требуется получить сведения.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.

пмбиpmbi
Указатель на структуру менубаринфо , которая получает сведения.Pointer to a MENUBARINFO structure that receives the information.

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

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

ПримечанияRemarks

Эта функция члена эмулирует функциональность функции 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

пвндктлpWndCtl
Определяет элемент управления, который будет использоваться в качестве отправной точки для поиска.Identifies the control to be used as the starting point for the search.

бпревиаус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.

пкурситеорвндpCurSiteOrWnd
COleControlSiteOrWnd Определяет элемент управления.Identifies the COleControlSiteOrWnd control. Дополнительные сведения о COleControlSiteOrWndсм. в разделе Примечания.For 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.

ПримечанияRemarks

Группа элементов управления начинается с элемента управления, созданного с использованием стиля 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. Если пвндктл определяет первый элемент управления в группе, а бпревиаус имеет значение true GetNextDlgGroupItem , возвращает указатель на последний элемент управления в группе.If pWndCtl identifies the first control in the group and bPrevious is TRUE, GetNextDlgGroupItem returns a pointer to the last control in the group.

Примечание

Поскольку 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
Оконный элемент управления ActiveXWindowed ActiveX control Содержит HWND и связывает с ним объект колеконтролсите .Contains an HWND and associates a COleControlSite object with it. Элемент имеет значение HWND элемента управления, а m_pSite элемент указывает на элемент управления COleControlSite. m_hWnd COleControlSiteOrWndThe 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_hWnd элемент управления ,иэлементимеетзначениеnull.COleControlSite m_pSite COleControlSiteOrWndThe 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. Элемент имеет значение HWND окна, а m_pSite член имеет значение null. COleControlSiteOrWnd m_hWndThe 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

пвндктлpWndCtl
Определяет элемент управления, который будет использоваться в качестве отправной точки для поиска.Identifies the control to be used as the starting point for the search.

пкурситеорвндpCurSiteOrWnd
COleControlSiteOrWnd Определяет элемент управления.Identifies the COleControlSiteOrWnd control. Дополнительные сведения о COleControlSiteOrWndсм. в разделе CWnd:: жетнекстдлгграупитем.For more information about COleControlSiteOrWnd, see CWnd::GetNextDlgGroupItem.

бпревиаус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:: жетнекстдлгграупитем.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

нфлаг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.

ПримечанияRemarks

Список диспетчера окон содержит записи для всех окон верхнего уровня, связанных с ними дочерних окон и дочерних окон дочерних окон.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

идконтролidControl
Идентификатор элемента управления ActiveX.The ID of the ActiveX control.

CWnd::GetOpenClipboardWindowCWnd::GetOpenClipboardWindow

Получает маркер окна, в котором в данный момент открыт буфер обмена.Retrieves the handle of the window that currently has the Clipboard open.

static CWnd* PASCAL GetOpenClipboardWindow();

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

Маркер окна, в котором в данный момент открыт буфер обмена, если функция выполнена успешно; в противном случае — 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.

ПримечанияRemarks

Если окно не имеет владельца, то по умолчанию возвращается указатель на объект родительского окна.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.

Понятие владения этой функцией отличается от концепции «владение ».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

См. раздел "возвращаемые значения" в разделе " родители " в Windows SDK.See the Return Values section in GetParent in the Windows SDK.

ПримечанияRemarks

GetParent Функция возвращает указатель на ближайший родительский элемент (если он существует).The GetParent function returns a pointer to the immediate parent (if it exists). В отличие от этого функция жетпарентовнер возвращает указатель на наиболее непосредственный родительский или подчиненный окно, которое не является дочерним окном (не имеет стиля 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.

ПримечанияRemarks

Функция-член выполняет поиск по родительской цепочке до тех пор, пока не будет найден объект CFrameWnd (или производный класс).The member function searches up the parent chain until a CFrameWnd (or derived class) object is found.

CWnd::GetParentOwnerCWnd::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.

ПримечанияRemarks

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). Окно текущего владельца можно задать с помощью сетовнер.The current owner window can be set with SetOwner. По умолчанию родительским элементом окна является его владелец.By default, the parent of a window is its owner.

В отличие от этого функция- родитель возвращает указатель на ближайший родительский элемент, будь это дочернее окно.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:: PropertyCWnd::GetProperty

Вызовите эту функцию члена, чтобы получить свойство элемента управления ActiveX, заданное параметром двдиспид.Call this member function to get the ActiveX control property specified by dwDispID.

void GetProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    void* pvProp)const;

ПараметрыParameters

двдиспидdwDispID
Определяет извлекаемое свойство.Identifies the property to be retrieved.

втпропvtProp
Указывает тип извлекаемого свойства.Specifies the type of the property to be retrieved. Возможные значения см. в подразделе "Примечания" раздела COleDispatchDriver::InvokeHelper.For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.

пвпропpvProp
Адрес переменной, которая будет принимать значение свойства.Address of the variable that will that will receive the property value. Он должен соответствовать типу, заданному параметром втпроп.It must match the type specified by vtProp.

ПримечанияRemarks

GetPropertyВозвращает значение через пвпроп.GetProperty returns the value through pvProp.

Примечание

Эта функция должна вызываться только для CWnd объекта, представляющего элемент управления ActiveX.This function should be called only on a CWnd object that represents an ActiveX control.

Дополнительные сведения об использовании этой функции – члена с контейнерами элементов управления ActiveX см. в статье контейнеры элементов управления ActiveX: Программирование элементов управления ActiveX в контейнереэлементов управления ActiveX.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 указателем.Returns NULL if the CWnd is not attached to a window or if it is used with a NULL CWnd pointer.

ПримерExample

См. пример для CWnd:: субклассвиндов.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

ппарентpParent
Указатель на родительское CWnd окно.A pointer to a parent CWnd window. Может иметь значение NULL.May be NULL.

пвндтопpWndTop
Указатель на окно, находящегося в данный момент в верхней части.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.

ПримечанияRemarks

Владелец безопасности — это первое, не дочернее родительское окно ппарент.The safe owner is the first non-child parent window of pParent. Если ппарент имеет значение null, то основное окно потока (полученное через афксжетмаинвнд) используется для поиска владельца.If pParent is NULL, the thread's main window (retrieved via AfxGetMainWnd) is used to find an owner.

Примечание

Сама платформа использует эту функцию для определения правильного окна владельца для диалоговых окон и страниц свойств, в которых не указан владелец.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

нбар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.

ПримечанияRemarks

Эта функция-член не работает с полосами прокрутки, созданными при установке битов 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

идобжектidObject
Указывает объект меню.Specifies the menu object. Список возможных значений см. в разделе жетскроллбаринфо.For a list of possible values, see GetScrollBarInfo.

псбиpsbi
Указатель на структуру скроллбаринфо , которая получает сведения.Pointer to a SCROLLBARINFO structure that receives the information.

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

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

ПримечанияRemarks

Эта функция члена эмулирует функциональность функции жетскроллбаринфо, как описано в 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

нбарnBar
Указывает, является ли полоса прокрутки элементом управления или частью неклиентской области окна.Specifies whether the scroll bar is a control or part of a window's nonclient area. Если он является частью неклиентской области, НБАР также указывает, располагается ли полоса прокрутки горизонтально, вертикально или и то, и другое.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.

лпскроллинфоlpScrollInfo
Указатель на структуру скроллинфо .A pointer to a SCROLLINFO structure. Дополнительные сведения об этой структуре см. в Windows SDK.See the Windows SDK for more information about this structure.

нмаск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 сведения о значениях нмаск см. в разделе.See SCROLLINFO for more information on the nMask values.

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

Если сообщение получает какие-либо значения, возвращается значение TRUE.If the message retrieved any values, the return is TRUE. В противном случае — FALSE.Otherwise, it is FALSE.

ПримечанияRemarks

GetScrollInfoпозволяет приложениям использовать 32-разрядные позиции прокрутки.GetScrollInfo enables applications to use 32-bit scroll positions.

Структура скроллинфо содержит сведения о полосе прокрутки, включая минимальные и максимальные положения прокрутки, размер страницы и положение ползунка (бегунка).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). Дополнительные сведения об изменении структуры по умолчанию см. в разделе " Структура"вWindowsSDK.SCROLLINFOSee the SCROLLINFO structure topic in the Windows SDK for more information about changing the structure defaults.

Обработчики сообщений Windows MFC, указывающие расположение полосы прокрутки, CWnd:: онхскролл и CWnd:: онвскролл, предоставляют только 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

нбар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

нбар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.

ПримечанияRemarks

Текущая величина — это относительное значение, которое зависит от текущего диапазона прокрутки.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

Копирует текущие минимальное и максимальное позиции полосы прокрутки для заданной полосы прокрутки в расположения, заданные лпминпос и лпмакспос.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

нбар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.

лпминпосlpMinPos
Указывает на целочисленную переменную, которая должна принимать минимальную позиции.Points to the integer variable that is to receive the minimum position.

лпмакспосlpMaxPos
Указывает на целочисленную переменную, которая должна принимать максимальную позиции.Points to the integer variable that is to receive the maximum position.

ПримечанияRemarks

Если CWnd отсутствует полоса прокрутки, GetScrollRange функция-член копирует 0 в лпминпос и лпмакспос.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

бревертbRevert
Указывает выполняемое действие.Specifies the action to be taken. Если бреверт имеет значение false GetSystemMenu , возвращает маркер копии меню элемента управления, используемой в данный момент.If bRevert is FALSE, GetSystemMenu returns a handle to a copy of the Control menu currently in use. Эта копия изначально идентична меню Control, но может быть изменена.This copy is initially identical to the Control menu but can be modified. Если бреверт имеет значение true 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

Определяет копию меню управления, если бреверт имеет значение false.Identifies a copy of the Control menu if bRevert is FALSE. Если бреверт имеет значение true, возвращаемое значение не определено.If bRevert is TRUE, the return value is undefined.

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

ПримечанияRemarks

Любое окно, которое не использует GetSystemMenu для создания собственной копии меню элемента управления, получает стандартное меню управления.Any window that does not use GetSystemMenu to make its own copy of the Control menu receives the standard Control menu.

GetSystemMenu Указатель, возвращаемый функцией члена, можно использовать с функциями кмену:: аппендмену, кмену:: инсертменуили кмену:: модифимену для изменения меню Control.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. Все предопределенные элементы меню элементов управления имеют номера ИДЕНТИФИКАТОРов больше число 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

птиpti
Указатель на структуру титлебаринфо , которая получает сведения.Pointer to a TITLEBARINFO structure that receives the information.

ПримечанияRemarks

Эта функция члена эмулирует функциональность функции жеттитлебаринфо, как описано в 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.

ПримечанияRemarks

Если 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.

ПримечанияRemarks

Окно верхнего уровня — это окно, которое является дочерним по отношению к рабочему столу.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.

ПримечанияRemarks

GetTopLevelParentаналогичен жеттоплевелфраме и жеттоплевеловнер; Однако он игнорирует значение, установленное в качестве текущего окна владельца.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.

ПримечанияRemarks

Если CWnd не имеет дочерних элементов, эта функция возвращает значение null.If CWnd has no children, this function returns NULL.

CWnd:: ЖетупдатеректCWnd::GetUpdateRect

Получает координаты наименьшего прямоугольника, полностью охватывающего область обновления.Retrieves the coordinates of the smallest rectangle that completely encloses the update region.

BOOL GetUpdateRect(
    LPRECT lpRect,
    BOOL bErase = FALSE);

ПараметрыParameters

лпректlpRect
Указывает на 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. Если лпрект имеет значение null, GetUpdateRect функция-член возвращает ненулевой, если существует регион обновления, и 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.

берасеbErase
Указывает, следует ли стирать фон в области обновления.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.

Если для параметра лпрект задано значение null, то возвращаемое значение будет ненулевым, если существует регион обновления. в противном случае — 0.If the lpRect parameter is set to NULL, the return value is nonzero if an update region exists; otherwise 0.

ПримечанияRemarks

Если CWnd был создан с использованием стиля CS_OWNDC, а режим сопоставления не является MM_TEXT GetUpdateRect , функция-член предоставляет прямоугольник в логических координатах.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. В противном случае предоставляет прямоугольник в клиентских координатах. GetUpdateRectOtherwise, 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).

Параметр берасе указывает, следует GetUpdateRect ли удалять фон области обновления.The bErase parameter specifies whether GetUpdateRect should erase the background of the update region. Если берасе имеет значение true и область обновления не пуста, фон удаляется.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.

Прямоугольник обновления, полученный функцией-членом бегинпаинт , идентичен тому, который извлекается GetUpdateRect функцией-членом.The update rectangle retrieved by the BeginPaint member function is identical to that retrieved by the GetUpdateRect member function.

GetUpdateRect BeginPaint Функция- 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

Извлекает регион обновления в регион, определенный параметром пргн.Retrieves the update region into a region identified by pRgn.

int GetUpdateRgn(
    CRgn* pRgn,
    BOOL bErase = FALSE);

ПараметрыParameters

пргнpRgn
Определяет регион обновления.Identifies the update region.

берасеbErase
Указывает, будет ли отображаться фон и неклиентские области дочерних окон.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 The region has no overlapping borders.

  • КОМПЛЕКСРЕГИОН. область содержит перекрывающиеся границы.COMPLEXREGION The region has overlapping borders.

  • НУЛЛРЕГИОН. регион пуст.NULLREGION The region is empty.

  • Ошибка: регион не создан.ERROR No region was created.

ПримечанияRemarks

Координаты этой области задаются относительно левого верхнего угла (клиентские координаты).The coordinates of this region are relative to the upper-left corner (client coordinates).

Функция-член бегинпаинт автоматически проверяет область обновления, поэтому любой вызов, 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

нкмдnCmd
Задает связь между 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. Релеаседк должен вызываться один раз для каждого успешного вызова GetWindowDC.ReleaseDC should be called once for each successful call to GetWindowDC.

ПримечанияRemarks

Контекст отображения окна позволяет рисовать в 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.

Функцию 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.

После завершения рисования необходимо вызвать функцию-член релеаседк , чтобы освободить контекст отображения.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

пвиpwi
Указатель на структуру виндовинфо .A pointer to a WINDOWINFO structure.

ПримечанияRemarks

Эта функция члена эмулирует функциональность функции жетвиндовинфо, как описано в 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

лпвндплlpwndpl
Указывает на 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.

ПримечанияRemarks

Элемент 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 объекта в структуру, на которую указывает лпрект.Copies the dimensions of the bounding rectangle of the CWnd object to the structure pointed to by lpRect.

void GetWindowRect(LPRECT lpRect) const;

ПараметрыParameters

лпректlpRect
Указывает на 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.

ПримечанияRemarks

Размеры задаются в экранных координатах относительно левого верхнего угла экрана отображения.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

хргнhRgn
Маркер области окна.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 The region is a single rectangle.

  • КОМПЛЕКСРЕГИОН. регион является более чем одним прямоугольником.COMPLEXREGION The region is more than one rectangle.

  • Произошла ошибка; область не затрагивается.ERROR An error occurred; the region is unaffected.

ПримечанияRemarks

Область окна определяет область внутри окна, в которой операционная система разрешает рисование.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:: сетвиндовргн.To set the window region of a window, call CWnd::SetWindowRgn.

CWnd::GetWindowTextCWnd::GetWindowText

Копирует заголовок заголовка (если он имеется) в буфер, на который указывает лпсзстрингбуф , или в строку назначения, которая является RSTR. CWndCopies 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

лпсзстрингбуфlpszStringBuf
Указывает на буфер, который получает скопированную строку заголовка окна.Points to the buffer that is to receive the copied string of the window's title.

нмакскаунтnMaxCount
Указывает максимальное число символов, копируемых в буфер, включая завершающий нуль.Specifies the maximum number of characters to be copied to the buffer, including the terminating null character. Если строка длиннее числа символов, указанных в нмакскаунт, она усекается.If the string is longer than the number of characters specified in nMaxCount, it is truncated.

rStrrString
Объект CString , который получает скопированную строку заголовка окна.A CString object that is to receive the copied string of the window's title.

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

Задает длину копируемой строки в символах, не включая завершающий символ null.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.

ПримечанияRemarks

Если объект является элементом управления, то GetWindowText функция-член копирует текст внутри элемента управления вместо копирования заголовка. CWndIf the CWnd object is a control, the GetWindowText member function copies the text within the control instead of copying the caption.

Эта функция члена вызывает отправку 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::GetWindowTextLengthCWnd::GetWindowTextLength

Возвращает длину CWnd заголовка заголовка объекта.Returns the length of the CWnd object caption title.

int GetWindowTextLength() const;

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

Задает длину текста в символах, не включая завершающий символ null.Specifies the text length in characters, not including any null-termination character. Если такого текста не существует, значение равно 0.The value is 0 if no such text exists.

ПримечанияRemarks

Если CWnd является элементом управления GetWindowTextLength , функция-член возвращает длину текста внутри элемента управления, а не заголовка.If CWnd is a control, the GetWindowTextLength member function returns the length of the text within the control instead of the caption.

Эта функция члена вызывает отправку 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();

ПримечанияRemarks

Хотя курсор больше не отображается, его можно снова отобразить с помощью функции-члена шовкарет .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

пменуpMenu
Определяет меню верхнего уровня, содержащее элемент для выделения.Identifies the top-level menu that contains the item to be highlighted.

нидхилитеитемnIDHiliteItem
Указывает пункт меню, который должен быть выделен в зависимости от значения параметра нхилите .Specifies the menu item to be highlighted, depending on the value of the nHilite parameter.

нхилитеnHilite
Указывает, выделен ли пункт меню или удаляется выделение.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. Значения можно комбинировать с помощью побитового оператора или.The values can be combined using the bitwise OR operator. Эти значения имеют следующее значение:These values have the following meanings:

  • MF_BYCOMMAND интерпретирует нидхилитеитем как идентификатор элемента меню (интерпретация по умолчанию).MF_BYCOMMAND Interprets nIDHiliteItem as the menu-item ID (the default interpretation).

  • MF_BYPOSITION интерпретирует нидхилитеитем как смещение элемента меню, начинающееся с нуля.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. Ненулевое значение, если элемент был выделен; в противном случае — 0.Nonzero if the item was highlighted; otherwise 0.

ПримечанияRemarks

Флаги MF_HILITE и MF_UNHILITE можно использовать только с этой функцией члена. они не могут использоваться с функцией члена кмену:: модифимену .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

двдатаdwData
Указывает дополнительные данные.Specifies additional data. Используемое значение зависит от значения параметра нкмд .The value used depends on the value of the nCmd parameter.

нкмдnCmd
Задает тип запрошенной справки.Specifies the type of help requested. Список возможных значений и их влияние на параметр двдата см. в описании параметра укомманд , как описано в справочнике по API справки HTML в Windows SDK.For 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.

ПримечанияRemarks

Дополнительные сведения см. в разделе CWinApp:: HtmlHelp .See CWinApp::HtmlHelp for more information.

CWnd:: ИнитдинамиклайаутCWnd::InitDynamicLayout

Вызывается платформой для инициализации динамического макета окна.Called by the framework to initialize dynamic layout for a window.

void InitDynamicLayout();

ПримечанияRemarks

Не вызывайте этот метод напрямую.Do not call this method directly.

CWnd:: недействительностьCWnd::Invalidate

Делает недействительным всю клиентскую область CWnd.Invalidates the entire client area of CWnd.

void Invalidate(BOOL bErase = TRUE);

ПараметрыParameters

берасеbErase
Указывает, следует ли стирать фон в области обновления.Specifies whether the background within the update region is to be erased.

ПримечанияRemarks

Клиентская область помечается для рисования при возникновении следующего сообщения WM_PAINT .The client area is marked for painting when the next WM_PAINT message occurs. Кроме того, область можно проверить до того, как будет вызвано сообщение WM_PAINT функцией-членом валидатерект или валидатергн .The region can also be validated before a WM_PAINT message occurs by the ValidateRect or ValidateRgn member function.

Параметр берасе указывает, следует ли удалять фон в области обновления при обработке области обновления.The bErase parameter specifies whether the background within the update area is to be erased when the update region is processed. Если берасе имеет значение true, фон удаляется при вызове функции-члена бегинпаинт ; Если берасе имеет значение false, фон остается неизменным.If bErase is TRUE, the background is erased when the BeginPaint member function is called; if bErase is FALSE, the background remains unchanged. Если берасе имеет значение true для любой части области обновления, то фон во всем регионе, а не только в заданной части, удаляется.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:: упдатевиндов.See the example for CWnd::UpdateWindow.

CWnd:: ИнвалидатеректCWnd::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

лпректlpRect
Указывает на 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. Если лпрект имеет значение null, в регион добавляется вся клиентская область.If lpRect is NULL, the entire client area is added to the region.

берасеbErase
Указывает, следует ли стирать фон в области обновления.Specifies whether the background within the update region is to be erased.

ПримечанияRemarks

Недействительный прямоугольник, а также все остальные области в области обновления помечаются для рисования при отправке следующего сообщения 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 или пока область не будет проверена функцией-членом валидатерект или валидатергн .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.

Параметр берасе указывает, следует ли удалять фон в области обновления при обработке области обновления.The bErase parameter specifies whether the background within the update area is to be erased when the update region is processed. Если берасе имеет значение true, фон удаляется при вызове функции-члена бегинпаинт ; Если берасе имеет значение false, фон остается неизменным.If bErase is TRUE, the background is erased when the BeginPaint member function is called; if bErase is FALSE, the background remains unchanged. Если берасе имеет значение true для любой части области обновления, фон во всем регионе удаляется, а не только в данной части.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

пргнpRgn
Указатель на объект кргн , определяющий область, добавляемую в область обновления.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.

берасеbErase
Указывает, следует ли стирать фон в области обновления.Specifies whether the background within the update region is to be erased.

ПримечанияRemarks

Недействительная область, а также все остальные области в области обновления помечаются для рисования при следующей отправке сообщения 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 или пока регион не будет проверен функцией-членом валидатерект или валидатергн .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.

Параметр берасе указывает, следует ли удалять фон в области обновления при обработке области обновления.The bErase parameter specifies whether the background within the update area is to be erased when the update region is processed. Если берасе имеет значение true, фон удаляется при вызове функции-члена бегинпаинт ; Если берасе имеет значение false, фон остается неизменным.If bErase is TRUE, the background is erased when the BeginPaint member function is called; if bErase is FALSE, the background remains unchanged. Если берасе имеет значение true для любой части области обновления, то фон во всем регионе, а не только в заданной части, удаляется.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.

Заданный регион должен быть ранее создан одной из функций Region.The given region must have been previously created by one of the region functions.

CWnd::InvokeHelperCWnd::InvokeHelper

Вызовите эту функцию члена, чтобы вызвать метод или свойство элемента управления ActiveX, заданное параметром двдиспид, в контексте, заданном параметром вфлагс.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

двдиспидdwDispID
Задает вызываемый метод или свойство.Identifies the method or property to be invoked.

вфлагсwFlags
Флаги, описывающие контекст вызова IDispatch::Invoke.Flags describing the context of the call to IDispatch::Invoke.

втретvtRet
Указывает тип возвращаемого значения.Specifies the type of the return value. Возможные значения см. в подразделе "Примечания" раздела COleDispatchDriver::InvokeHelper.For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.

пвретpvRet
Адрес переменной, которая будет принимать значение свойства или возвращаемое значение.Address of the variable that will that will receive the property value or return value. Он должен соответствовать типу, заданному параметром втрет.It must match the type specified by vtRet.

пбпараминфоpbParamInfo
Указатель на строку байтов с завершающим нулем, указывающую типы параметров, следующие пбпараминфо.Pointer to a null-terminated string of bytes specifying the types of the parameters following pbParamInfo. Возможные значения см. в разделе "Примечания" COleDispatchDriver::InvokeHelperдля.For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.

......
Список переменных параметров типов, указанных в пбпараминфо.Variable List of parameters, of types specified in pbParamInfo.

ПримечанияRemarks

Параметр пбпараминфо задает типы параметров, передаваемых методу или свойству.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.

Примечание

Эта функция должна вызываться только для CWnd объекта, представляющего элемент управления ActiveX.This function should be called only on a CWnd object that represents an ActiveX control.

Дополнительные сведения об использовании этой функции – члена с контейнерами элементов управления ActiveX см. в статье контейнеры элементов управления ActiveX: Программирование элементов управления ActiveX в контейнереэлементов управления ActiveX.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

Указывает, является ли окно, заданное параметром приводится , дочерним окном или другим прямым потомком 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

ПриводитсяpWnd
Определяет тестируемое окно.Identifies the window to be tested.

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

Указывает результат функции.Specifies the outcome of the function. Значение не равно нулю, если окно, идентифицируемое приводится , является дочерним окном CWnd; в противном случае — 0.The value is nonzero if the window identified by pWnd is a child window of CWnd; otherwise 0.

ПримечанияRemarks

Дочернее окно является прямым потомком 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:: ИсдиалогмессажеCWnd::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

лпмсгlpMsg
Указывает на структуру 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::P ретранслатемессаже базового класса, чтобы обработать сообщение.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);
}

ПримечанияRemarks

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 выбирает следующий элемент управления или группу элементов управления, а клавиша со стрелкой вниз выбирает следующий элемент управления в группе.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 функциями Windows TranslateMessage или DispatchMessage , так как оно уже обработано.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

нидбуттонnIDButton
Задает целочисленный идентификатор элемента управления "Кнопка".Specifies the integer identifier of the button control.

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

Ненулевое значение, если данный элемент управления установлен, и 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.

ПримечанияRemarks

Если кнопка является элементом управления с тремя состояниями, функция-член определяет, является ли она недоступной, установленной или ни одной.If the button is a three-state control, the member function determines whether it is dimmed, checked, or neither.

CWnd:: ИсдинамиклайаутенабледCWnd::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.

ПримечанияRemarks

CWnd::IsIconicCWnd::IsIconic

Указывает, CWnd является ли элемент сведенным (значком).Specifies whether CWnd is minimized (iconic).

BOOL IsIconic() const;

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

Ненулевое значение, если 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:: ИстаучвиндовCWnd::IsTouchWindow

Указывает, поддерживает ли объект CWnd сенсорный ввод.Specifies whether CWnd has touch support.

BOOL IsTouchWindow() const;

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

Значение true CWnd , если имеет поддержку касания; в противном случае — значение false.TRUE if CWnd has touch support; otherwise FALSE.

ПримечанияRemarks

CWnd:: ИсвиндовенабледCWnd::IsWindowEnabled

Указывает, CWnd разрешено ли ввод с клавиатуры и мыши.Specifies whether CWnd is enabled for mouse and keyboard input.

BOOL IsWindowEnabled() const;

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

Ненулевое значение, если 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:: ИсвиндоввисиблеCWnd::IsWindowVisible

Определяет состояние видимости данного окна.Determines the visibility state of the given window.

BOOL IsWindowVisible() const;

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

Ненулевое значение, если 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.

ПримечанияRemarks

Окно имеет состояние видимости, определяемое битом стиля 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::IsZoomedCWnd::IsZoomed

Определяет, CWnd было ли развернуто.Determines whether CWnd has been maximized.

BOOL IsZoomed() const;

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

Ненулевое значение, если CWnd разворачивается; в противном случае — 0.Nonzero if CWnd is maximized; otherwise 0.

CWnd::KillTimerCWnd::KillTimer

Ликвидирует событие таймера, идентифицируемое нидевент , из предыдущего вызова SetTimer.Kills the timer event identified by nIDEvent from the earlier call to SetTimer.

BOOL KillTimer(UINT_PTR nIDEvent);

ПараметрыParameters

нидевентnIDEvent
Значение события таймера, переданного в сеттимер.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.

ПримечанияRemarks

Ожидающие сообщения WM_TIMER , связанные с таймером, не удаляются из очереди сообщений.Pending WM_TIMER messages associated with the timer are not removed from the message queue.

ПримерExample

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

CWnd:: ЛоаддинамиклайаутресаурцеCWnd::LoadDynamicLayoutResource

Вызывается платформой для загрузки из файла ресурсов сведений о динамическом макете.Called by the framework to load dynamic layout information from the resource file.

BOOL LoadDynamicLayoutResource(LPCTSTR lpszResourceName);

ПараметрыParameters

лпсзресаурценамеlpszResourceName
Имя ресурса, содержащего необходимые сведения о динамическом макете для этого окна.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.

ПримечанияRemarks

Не вызывайте этот метод напрямую.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.

ПримечанияRemarks

Невозможно переместить заблокированное окно.A locked window cannot be moved. Одновременно может быть заблокировано только одно окно.Only one window can be locked at a time. Чтобы разблокировать окно LockWindowUpdate, заблокированное, вызовите унлокквиндовупдате.To unlock a window locked with LockWindowUpdate, call UnlockWindowUpdate.

Если приложение с заблокированным окном (или любыми закрытыми дочерними окнами) вызывает функцию Windows GetDC, жетдцекс или бегинпаинт , вызываемая функция возвращает контекст устройства, видимая область которого пуста.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.

Функция члена не делает данное окно невидимым и не очищает бит стиля WS_VISIBLE. LockWindowUpdateThe 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;

ПримечанияRemarks

Элемент m_hWnd данных является открытой переменной типа HWND.The m_hWnd data member is a public variable of type HWND.

CWnd:: МапвиндовпоинтсCWnd::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

пвндтоpwndTo
Определяет окно, в котором преобразуются точки.Identifies the window to which points are converted. Если этот параметр имеет значение NULL, точки преобразуются в экранные координаты.If this parameter is NULL, the points are converted to screen coordinates.

лпректlpRect
Задает прямоугольник, точки которого должны быть преобразованы.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.

лппоинтlpPoint
Указатель на массив структуры Point , содержащий набор точек для преобразования.A pointer to an array of POINT structure that contain the set of points to be converted.

нкаунтnCount
Указывает количество POINT структур в массиве, на которое указывает лппоинт.Specifies the number of POINT structures in the array pointed to by lpPoint.

CWnd::MessageBoxCWnd::MessageBox

Создает и отображает окно, содержащее предоставляемое приложением сообщение и заголовок, а также сочетание стандартных значков и кнопок, описанных в списке стили окна сообщений .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.

лпсзкаптионlpszCaption
Указывает на CString объект или строку, завершающуюся нулем, используемую для подписи в окне сообщения.Points to a CString object or null-terminated string to be used for the message-box caption. Если лпсзкаптион имеет значение null, используется заголовок по умолчанию "Error".If lpszCaption is NULL, the default caption "Error" is used.

NуведомленияnType
Задает содержимое и поведение окна сообщения.Specifies the contents and behavior of the message box.

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

Этот метод использует функцию MessageBox , определенную в Windows SDK.This method utilizes the MessageBox function as defined in the Windows SDK. Этот метод возвращает результат вызова этой функции.This method returns the result of calling this function.

ПримечанияRemarks

Для реализации окна сообщения в приложении используйте глобальную функцию 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:

![() ]Значок значка "останавливает x(../../mfc/reference/media/vc364f1.gif " () ") значок"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

двремовеdwRemove
Задает стили окна, которые будут удалены во время изменения стиля.Specifies window styles to be removed during style modification.

дваддdwAdd
Задает стили окна, добавляемые во время изменения стиля.Specifies window styles to be added during style modification.

нфлагсnFlags
Флаги, передаваемые в SetWindowPos, или нуль SetWindowPos , если не следует вызывать.Flags to be passed to SetWindowPos, or zero if SetWindowPos should not be called. По умолчанию используется значение ноль.The default is zero. Список предустановленных флагов см. в разделе "Примечания".See the Remarks section for a list of preset flags.

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

Ненулевое значение, если стиль изменен успешно. в противном случае — значение 0.Nonzero if style was successfully modified; otherwise, 0.

ПримечанияRemarks

Добавляемые или удаляемые стили можно объединять с помощью побитового оператора|or ().Styles to be added or removed can be combined by using the bitwise OR (|) operator. Сведения о доступных стилях окна см. в разделе стили окна "темы" и CreateWindow в Windows SDK.See the topics Window Styles and CreateWindow in the Windows SDK for information about the available window styles.

Если нфлагс имеет ненулевое значение, ModifyStyle вызывает функцию Windows API SetWindowPos и перерисовывает окно, объединяя нфлагс со следующими четырьмя предустановленными флагами: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 оставляет текущий Z порядок.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.

Примечание

Для некоторых стилей в некоторых элементах управления (например, стиль 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

двремовеdwRemove
Задает расширенные стили, которые будут удалены во время изменения стиля.Specifies extended styles to be removed during style modification.

дваддdwAdd
Задает расширенные стили, добавляемые во время изменения стиля.Specifies extended styles to be added during style modification.

нфлагсnFlags
Флаги, передаваемые в SetWindowPos, или нуль SetWindowPos , если не следует вызывать.Flags to be passed to SetWindowPos, or zero if SetWindowPos should not be called. По умолчанию используется значение ноль.The default is zero. Список предустановленных флагов см. в разделе "Примечания".See the Remarks section for a list of preset flags.

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

Ненулевое значение, если стиль изменен успешно. в противном случае — значение 0.Nonzero if style was successfully modified; otherwise, 0.

ПримечанияRemarks

Добавляемые или удаляемые стили можно объединять с помощью побитового оператора|or ().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

Если нфлагс имеет ненулевое значение, ModifyStyleEx вызывает функцию Windows API SetWindowPos и перерисовывает окно, объединяя нфлагс со следующими четырьмя предустановленными флагами: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 оставляет текущий Z порядок.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.

нвидсnWidth
Задает новую ширину CWnd.Specifies the new width of the CWnd.

нхеигхт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.

лпректlpRect
Объект крект или Структура Rect , указывающая новый размер и расположение.The CRect object or RECT structure that specifies the new size and position.

ПримечанияRemarks

Для объекта верхнего уровня 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.

Функция отправляет сообщение WM_GETMINMAXINFO. MoveWindowThe 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:: клиенттоскрин.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.

идобжекттипеidObjectType
Определяет тип объекта, создавшего событие.Identifies the kind of object that generated the event. Это значение представляет собой один из стандартных идентификаторов объекта или значение идентификатора пользовательского объекта.This value is one of the predefined object identifiers or a custom object ID value.

идобжектidObject
Определяет, было ли событие создано объектом или дочерним элементом объекта.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.

ПримечанияRemarks

Эта функция члена эмулирует функциональность функции нотифивиневент, как описано в Windows SDK.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

NсведенияnState
Указывает, активируется ли 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.

пвндосерpWndOther
Указатель на CWnd активируемый или Деактивируемый.Pointer to the CWnd being activated or deactivated. Указатель может иметь значение NULL и может быть временным.The pointer can be NULL, and it may be temporary.

бминимизед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.

ПримечанияRemarks

Если объект активируется нажатием кнопки мыши, он также получает вызов функции-члена онмаусеактивате. CWndIf the CWnd object is activated with a mouse click, it will also receive an OnMouseActivate member function call.

Примечание

Это функция-член вызывается платформой, чтобы разрешить приложению обработать сообщение 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

бактиве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.

двсреадидdwThreadID
Указывает значение идентификатора потока.Specifies the value of the thread ID. Если бактиве имеет значение true, двсреадид идентифицирует поток CWnd , которому принадлежит Деактивируемый.If bActive is TRUE, dwThreadID identifies the thread that owns the CWnd being deactivated. Если бактиве имеет значение false, двсреадид идентифицирует поток, которому принадлежит CWnd активируемый объект.If bActive is FALSE, dwThreadID identifies the thread that owns the CWnd being activated.

ПримечанияRemarks

Примечание

Это функция-член вызывается платформой, чтобы разрешить приложению обработать сообщение 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:: ОнамбиентпропертиCWnd::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

пситеpSite
Указатель на сайт элемента управления, который запросил внешнее свойство.Pointer to the site of the control that requested the ambient property.

DISPIDdispid
Идентификатор диспетчеризации запрошенного внешнего свойства.The dispatch ID of the requested ambient property.

пварpvar
Указатель на структуру, выделенную 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.

ПримечанияRemarks

Переопределите эту функцию, чтобы изме