Класс CStockPropImpl
Этот класс предоставляет методы для поддержки значений стандартных свойств.
Важно!
Этот класс и его члены нельзя использовать в приложениях, выполняемых в среде выполнения Windows.
Синтаксис
template <
class T,
class InterfaceName,
const IID* piid = &_ATL_IIDOF(InterfaceName),
const GUID* plibid = &CComModule::m_libid,
WORD wMajor = 1,
WORD wMinor = 0,
class tihclass = CcomTypeInfoHolder>
class ATL_NO_VTABLE CStockPropImpl :
public IDispatchImpl<InterfaceName, piid, plibid, wMajor, wMinor, tihclass>
Параметры
T
Класс, реализующий элемент управления и производный от CStockPropImpl.
InterfaceName
Сдвоенный интерфейс, предоставляющий стандартные свойства.
piid
Указатель на идентификатор IID InterfaceName.
plibid
Указатель на идентификатор LIBID библиотеки типов, содержащей определение InterfaceName.
wMajor
Основной номер версии для библиотеки типов. Значение по умолчанию равно 1.
wMinor
Дополнительный номер версии для библиотеки типов. Значение по умолчанию равно 0.
tihclass
Класс, используемый для управления информацией о типах для T. Значение по умолчанию — CComTypeInfoHolder.
Участники
Открытые методы
| Имя | Описание |
|---|---|
| get_Appearance | Вызовите этот метод, чтобы получить стиль заливки, используемый элементом управления, например плоский или 3D. |
| get_AutoSize | Вызовите этот метод, чтобы получить состояние флага, указывающего, может ли элемент управления иметь другой размер. |
| get_BackColor | Вызовите этот метод, чтобы получить цвет фона элемента управления. |
| get_BackStyle | Вызовите этот метод, чтобы получить стиль фона элемента управления: прозрачный или непрозрачный. |
| get_BorderColor | Вызовите этот метод, чтобы получить цвет границы элемента управления. |
| get_BorderStyle | Вызовите этот метод, чтобы получить стиль границы элемента управления. |
| get_BorderVisible | Вызовите этот метод, чтобы получить состояние флага, указывающего, видима ли граница элемента управления. |
| get_BorderWidth | Вызовите этот метод, чтобы получить ширину (в пикселях) границы элемента управления. |
| get_Caption | Вызовите этот метод, чтобы получить текст, указанный в заголовке объекта. |
| get_DrawMode | Вызовите этот метод, чтобы получить режим рисования элемента управления, например, с помощью пера XOR или инвертирования цветов. |
| get_DrawStyle | Вызовите этот метод, чтобы получить стиль рисования элемента управления, например, сплошная или пунктирная линия. |
| get_DrawWidth | Вызовите этот метод, чтобы получить ширину отрисовки (в пикселях), используемую методами рисования элемента управления. |
| get_Enabled | Вызовите этот метод, чтобы получить состояние флага, указывающего, включен ли элемент управления. |
| get_FillColor | Вызовите этот метод, чтобы получить цвет заливки элемента управления. |
| get_FillStyle | Вызовите этот метод, чтобы получить стиль заливки элемента управления, например сплошная, прозрачная, со штриховкой. |
| get_Font | Вызовите этот метод, чтобы получить указатель на свойства шрифта элемента управления. |
| get_ForeColor | Вызовите этот метод, чтобы получить цвет переднего плана элемента управления. |
| get_HWND | Вызовите этот метод, чтобы получить дескриптор окна, связанный с элементом управления. |
| get_MouseIcon | Вызовите этот метод, чтобы получить свойства рисунка изображения (значка, растрового изображения или метафайла), отображаемого при наведении указателя мыши на элемент управления. |
| get_MousePointer | Вызовите этот метод для получения типа указателя мыши, отображаемого при наведении указателя мыши на элемент управления, например стрелка, крест или песочные часы. |
| get_Picture | Вызовите этот метод, чтобы получить указатель на свойства рисунка (значка, растрового изображения или метафайла), который будет отображаться. |
| get_ReadyState | Вызовите этот метод, чтобы получить состояние готовности элемента управления, например загружается или загружен. |
| get_TabStop | Вызовите этот метод, чтобы получить флаг, указывающий, доступен ли элемент управления для перехода клавишей TAB. |
| get_Text | Вызовите этот метод, чтобы получить текст, отображаемый с элементом управления. |
| getvalid | Вызовите этот метод, чтобы получить состояние флага, указывающего, допустим ли элемент управления. |
| get_Window | Вызовите этот метод, чтобы получить дескриптор окна, связанный с элементом управления. Идентично CStockPropImpl::get_HWND. |
| put_Appearance | Вызовите этот метод, чтобы задать стиль заливки, используемый элементом управления, например плоский или 3D. |
| put_AutoSize | Вызовите этот метод, чтобы задать значение флага, указывающего, может ли элемент управления иметь другой размер. |
| put_BackColor | Вызовите этот метод, чтобы задать цвет фона элемента управления. |
| put_BackStyle | Вызовите этот метод, чтобы задать стиль фона элемента управления. |
| put_BorderColor | Вызовите этот метод, чтобы задать цвет границы элемента управления. |
| put_BorderStyle | Вызовите этот метод, чтобы задать стиль границы элемента управления. |
| put_BorderVisible | Вызовите этот метод, чтобы задать значение флага, указывающего, видима ли граница элемента управления. |
| put_BorderWidth | Вызовите этот метод, чтобы задать ширину границы элемента управления. |
| put_Caption | Вызовите этот метод, чтобы задать текст, отображаемый с элементом управления. |
| put_DrawMode | Вызовите этот метод, чтобы задать режим рисования элемента управления, например, с помощью пера XOR или инвертирования цветов. |
| put_DrawStyle | Вызовите этот метод, чтобы задать стиль рисования элемента управления, например, сплошная или пунктирная линия. |
| put_DrawWidth | Вызовите этот метод, чтобы задать ширину (в пикселях), используемую методами рисования элемента управления. |
| put_Enabled | Вызовите этот метод, чтобы задать флаг, указывающий, включен ли элемент управления. |
| put_FillColor | Вызовите этот метод, чтобы задать цвет заливки элемента управления. |
| put_FillStyle | Вызовите этот метод, чтобы задать стиль заливки элемента управления, например сплошной, прозрачный, со штриховкой. |
| put_Font | Вызовите этот метод, чтобы задать свойства шрифта элемента управления. |
| put_ForeColor | Вызовите этот метод, чтобы задать цвет переднего плана элемента управления. |
| put_HWND | Этот метод возвращает E_FAIL. |
| put_MouseIcon | Вызовите этот метод, чтобы задать свойства рисунка изображения (значка, растрового изображения или метафайла), отображаемого при наведении указателя мыши на элемент управления. |
| put_MousePointer | Вызовите этот метод, чтобы задать тип указателя мыши, отображаемый при наведении указателя мыши на элемент управления, например стрелка, крест или песочные часы. |
| put_Picture | Вызовите этот метод, чтобы задать свойства рисунка (значка, растрового изображения или метафайла), который будет отображаться. |
| put_ReadyState | Вызовите этот метод, чтобы задать состояние готовности элемента управления, например загружается или загружен. |
| put_TabStop | Вызовите этот метод, чтобы задать значение флага, указывающего, доступен ли элемент управления для перехода клавишей TAB. |
| put_Text | Вызовите этот метод, чтобы задать текст, отображаемый с элементом управления. |
| putvalid | Вызовите этот метод, чтобы задать флаг, указывающий, допустим ли элемент управления. |
| put_Window | Этот метод вызывает CStockPropImpl::put_HWND, который возвращает E_FAIL. |
| putref_Font | Вызовите этот метод, чтобы задать свойства шрифта элемента управления со счетчиком ссылок. |
| putref_MouseIcon | Вызовите этот метод, чтобы задать свойства рисунка изображения (значка, растрового изображения или метафайла), отображаемого при наведении указателя мыши на элемент управления, со счетчиком ссылок. |
| putref_Picture | Вызовите этот метод, чтобы задать свойства рисунка (значка, растрового изображения или метафайла), который будет отображаться, со счетчиком ссылок. |
Замечания
CStockPropImpl предоставляет методы put и get для каждого стандартного свойства. Эти методы предоставляют код, необходимый для задания или получения элемента данных, связанного с каждым свойством, а также для уведомления и синхронизации с контейнером при изменении любого свойства.
Visual Studio обеспечивает поддержку стандартных свойств с помощью мастеров. Дополнительные сведения о добавлении стандартных свойств запасов в элемент управления см. в учебнике по библиотеке ATL.
Для обратной совместимости CStockPropImpl также предоставляет методы get_Window и put_Window, которые просто вызывают get_HWND и put_HWND соответственно. Реализация по умолчанию put_HWND возвращает E_FAIL, так как HWND должен быть свойством только для чтения.
У следующих свойств также есть реализация putref:
Шрифт
MouseIcon
Рисунок
Те же три стандартных свойства должны иметь соответствующие элементы данных типа CComPtr или другого класса, обеспечивающего правильный подсчет ссылок в интерфейсе с помощью оператора присваивания.
Иерархия наследования
T
CStockPropImpl
Требования
Header: atlctl.h
CStockPropImpl::get_Appearance
Вызовите этот метод, чтобы получить стиль заливки, используемый элементом управления, например плоский или 3D.
HRESULT STDMETHODCALLTYPE get_Appearance(SHORT pnAppearance);
Параметры
pnAppearance
Переменная, которая получает стиль заливки элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_AutoSize
Вызовите этот метод, чтобы получить состояние флага, указывающего, может ли элемент управления иметь другой размер.
HRESULT STDMETHODCALLTYPE get_Autosize(VARIANT_BOOL* pbAutoSize);
Параметры
pbAutoSize
Переменная, которая получает состояние флага. Значение TRUE указывает, что элемент управления не может быть другого размера.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_BackColor
Вызовите этот метод, чтобы получить цвет фона элемента управления.
HRESULT STDMETHODCALLTYPE get_BackColor(OLE_COLOR* pclrBackColor);
Параметры
pclrBackColor
Переменная, которая получает цвет фона элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_BackStyle
Вызовите этот метод, чтобы получить стиль фона элемента управления: прозрачный или непрозрачный.
HRESULT STDMETHODCALLTYPE get_BackStyle(LONG* pnBackStyle);
Параметры
pnBackStyle
Переменная, которая получает стиль фона элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_BorderColor
Вызовите этот метод, чтобы получить цвет границы элемента управления.
HRESULT STDMETHODCALLTYPE get_BorderColor(OLE_COLOR* pclrBorderColor);
Параметры
pclrBorderColor
Переменная, которая получает цвет границы элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_BorderStyle
Вызовите этот метод, чтобы получить стиль границы элемента управления.
HRESULT STDMETHODCALLTYPE get_BorderStyle(LONG* pnBorderStyle);
Параметры
pnBorderStyle
Переменная, которая получает стиль границы элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_BorderVisible
Вызовите этот метод, чтобы получить состояние флага, указывающего, видима ли граница элемента управления.
HRESULT STDMETHODCALLTYPE get_BorderVisible(VARIANT_BOOL* pbBorderVisible);
Параметры
pbBorderVisible
Переменная, которая получает состояние флага. Значение TRUE указывает, что граница элемента управления является видимой.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_BorderWidth
Вызовите этот метод, чтобы получить ширину границы элемента управления.
HRESULT STDMETHODCALLTYPE get_BorderWidth(LONG* pnBorderWidth);
Параметры
pnBorderWidth
Переменная, которая получает ширину границы элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_Caption
Вызовите этот метод, чтобы получить текст, указанный в заголовке объекта.
HRESULT STDMETHODCALLTYPE get_Caption(BSTR* pbstrCaption);
Параметры
pbstrCaption
Текст, отображаемый с элементом управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_DrawMode
Вызовите этот метод, чтобы получить режим рисования элемента управления, например, с помощью пера XOR или инвертирования цветов.
HRESULT STDMETHODCALLTYPE get_DrawMode(LONG* pnDrawMode);
Параметры
pnDrawMode
Переменная, которая получает режим рисования элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_DrawStyle
Вызовите этот метод, чтобы получить стиль рисования элемента управления, например, сплошная или пунктирная линия.
HRESULT STDMETHODCALLTYPE get_DrawStyle(LONG* pnDrawStyle);
Параметры
pnDrawStyle
Переменная, которая получает стиль рисования элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_DrawWidth
Вызовите этот метод, чтобы получить ширину отрисовки (в пикселях), используемую методами рисования элемента управления.
HRESULT STDMETHODCALLTYPE get_DrawWidth(LONG* pnDrawWidth);
Параметры
pnDrawWidth
Переменная, которая получает значение ширины элемента управления в пикселях.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_Enabled
Вызовите этот метод, чтобы получить состояние флага, указывающего, включен ли элемент управления.
HRESULT STDMETHODCALLTYPE get_Enabled(VARIANT_BOOL* pbEnabled);
Параметры
pbEnabled
Переменная, которая получает состояние флага. Значение TRUE указывает, что элемент управления включен.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_FillColor
Вызовите этот метод, чтобы получить цвет заливки элемента управления.
HRESULT STDMETHODCALLTYPE get_FillColor(OLE_COLOR* pclrFillColor);
Параметры
pclrFillColor
Переменная, которая получает цвет заливки элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_FillStyle
Вызовите этот метод, чтобы получить стиль заливки элемента управления, например сплошная, прозрачная, со штриховкой.
HRESULT STDMETHODCALLTYPE get_FillStyle(LONG* pnFillStyle);
Параметры
pnFillStyle
Переменная, которая получает стиль заливки элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_Font
Вызовите этот метод, чтобы получить указатель на свойства шрифта элемента управления.
HRESULT STDMETHODCALLTYPE get_Font(IFontDisp** ppFont);
Параметры
ppFont
Переменная, которая получает указатель на свойства шрифта элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_ForeColor
Вызовите этот метод, чтобы получить цвет переднего плана элемента управления.
HRESULT STDMETHODCALLTYPE get_ForeColor(OLE_COLOR* pclrForeColor);
Параметры
pclrForeColor
Переменная, которая получает цвет переднего плана элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_HWND
Вызовите этот метод, чтобы получить дескриптор окна, связанный с элементом управления.
HRESULT STDMETHODCALLTYPE get_HWND(LONG_PTR* phWnd);
Параметры
phWnd
Дескриптор окна, сопоставленный с элементом управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_MouseIcon
Вызовите этот метод, чтобы получить свойства рисунка изображения (значка, растрового изображения или метафайла), отображаемого при наведении указателя мыши на элемент управления.
HRESULT STDMETHODCALLTYPE get_MouseIcon(IPictureDisp** ppPicture);
Параметры
ppPicture
Переменная, которая получает указатель на свойства изображения рисунка.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_MousePointer
Вызовите этот метод для получения типа указателя мыши, отображаемого при наведении указателя мыши на элемент управления, например стрелка, крест или песочные часы.
HRESULT STDMETHODCALLTYPE get_MousePointer(LONG* pnMousePointer);
Параметры
pnMousePointer
Переменная, которая получает тип указателя мыши.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_Picture
Вызовите этот метод, чтобы получить указатель на свойства рисунка (значка, растрового изображения или метафайла), который будет отображаться.
HRESULT STDMETHODCALLTYPE get_Picture(IPictureDisp** ppPicture);
Параметры
ppPicture
Переменная, которая получает указатель на свойства изображения. Дополнительные сведения см. в разделе IPictureDisp.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_ReadyState
Вызовите этот метод, чтобы получить состояние готовности элемента управления, например загружается или загружен.
HRESULT STDMETHODCALLTYPE get_ReadyState(LONG* pnReadyState);
Параметры
pnReadyState
Переменная, которая получает состояние готовности элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_TabStop
Вызовите этот метод, чтобы получить состояние флага, указывающего, доступен ли элемент управления для перехода клавишей TAB.
HRESULT STDMETHODCALLTYPE get_TabStop(VARIANT_BOOL* pbTabStop);
Параметры
pbTabStop
Переменная, которая получает состояние флага. Значение TRUE указывает, что элемент управления доступен для перехода клавишей TAB.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_Text
Вызовите этот метод, чтобы получить текст, отображаемый с элементом управления.
HRESULT STDMETHODCALLTYPE get_Text(BSTR* pbstrText);
Параметры
pbstrText
Текст, отображаемый с элементом управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::getvalid
Вызовите этот метод, чтобы получить состояние флага, указывающего, допустим ли элемент управления.
HRESULT STDMETHODCALLTYPE getvalid(VARIANT_BOOL* pbValid);
Параметры
pbValid
Переменная, которая получает состояние флага. Значение TRUE указывает, что элемент управления доступен.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::get_Window
Вызовите этот метод, чтобы получить дескриптор окна, связанный с элементом управления. Идентично CStockPropImpl::get_HWND.
HRESULT STDMETHODCALLTYPE get_Window(LONG_PTR* phWnd);
Параметры
phWnd
Дескриптор окна, сопоставленный с элементом управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_Appearance
Вызовите этот метод, чтобы задать стиль заливки, используемый элементом управления, например плоский или 3D.
HRESULT STDMETHODCALLTYPE put_Appearance(SHORT nAppearance);
Параметры
nAppearance
Новый стиль рисования, используемый элементом управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_AutoSize
Вызовите этот метод, чтобы задать значение флага, указывающего, может ли элемент управления иметь другой размер.
HRESULT STDMETHODCALLTYPE put_AutoSize(VARIANT_BOOL bAutoSize,);
Параметры
bAutoSize
Значение TRUE, если элемент управления не может иметь другой размер.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_BackColor
Вызовите этот метод, чтобы задать цвет фона элемента управления.
HRESULT STDMETHODCALLTYPE put_BackColor(OLE_COLOR clrBackColor);
Параметры
clrBackColor
Новый цвет фона элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_BackStyle
Вызовите этот метод, чтобы задать стиль фона элемента управления.
HRESULT STDMETHODCALLTYPE put_BackStyle(LONG nBackStyle);
Параметры
nBackStyle
Новый стиль фона элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_BorderColor
Вызовите этот метод, чтобы задать цвет границы элемента управления.
HRESULT STDMETHODCALLTYPE put_BorderColor(OLE_COLOR clrBorderColor);
Параметры
clrBorderColor
Новый цвет границы. Тип данных OLE_COLOR внутренне представлен как 32-разрядное целое число.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_BorderStyle
Вызовите этот метод, чтобы задать стиль границы элемента управления.
HRESULT STDMETHODCALLTYPE put_BorderStyle(LONG nBorderStyle);
Параметры
nBorderStyle
Новый стиль границы.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_BorderVisible
Вызовите этот метод, чтобы задать значение флага, указывающего, видима ли граница элемента управления.
HRESULT STDMETHODCALLTYPE put_BorderVisible(VARIANT_BOOL bBorderVisible);
Параметры
bBorderVisible
Значение TRUE, если граница должна быть видимой.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_BorderWidth
Вызовите этот метод, чтобы задать ширину границы элемента управления.
HRESULT STDMETHODCALLTYPE put_BorderWidth(LONG nBorderWidth);
Параметры
nBorderWidth
Новая ширина границы элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_Caption
Вызовите этот метод, чтобы задать текст, отображаемый с элементом управления.
HRESULT STDMETHODCALLTYPE put_Caption(BSTR bstrCaption);
Параметры
bstrCaption
Текст, отображаемый с элементом управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_DrawMode
Вызовите этот метод, чтобы задать режим рисования элемента управления, например, с помощью пера XOR или инвертирования цветов.
HRESULT STDMETHODCALLTYPE put_DrawMode(LONG nDrawMode);
Параметры
nDrawMode
Новый режим рисования для элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_DrawStyle
Вызовите этот метод, чтобы задать стиль рисования элемента управления, например, сплошная или пунктирная линия.
HRESULT STDMETHODCALLTYPE put_DrawStyle(LONG pnDrawStyle);
Параметры
nDrawStyle
Новый стиль рисования для элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_DrawWidth
Вызовите этот метод, чтобы задать ширину (в пикселях), используемую методами рисования элемента управления.
HRESULT STDMETHODCALLTYPE put_DrawWidth(LONG nDrawWidth);
Параметры
nDrawWidth
Новая ширина, используемая методами рисования элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_Enabled
Вызовите этот метод, чтобы задать значение флага, указывающего, включен ли элемент управления.
HRESULT STDMETHODCALLTYPE put_Enabled(VARIANT_BOOL bEnabled);
Параметры
bEnabled
Значение TRUE, если элемент управления включен.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_FillColor
Вызовите этот метод, чтобы задать цвет заливки элемента управления.
HRESULT STDMETHODCALLTYPE put_FillColor(OLE_COLOR clrFillColor);
Параметры
clrFillColor
Новый цвет заливки для элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_FillStyle
Вызовите этот метод, чтобы задать стиль заливки элемента управления, например сплошной, прозрачный, со штриховкой.
HRESULT STDMETHODCALLTYPE put_FillStyle(LONG nFillStyle);
Параметры
nFillStyle
Новый стиль заливки для элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_Font
Вызовите этот метод, чтобы задать свойства шрифта элемента управления.
HRESULT STDMETHODCALLTYPE put_Font(IFontDisp* pFont);
Параметры
pFont
Указатель на свойства шрифта элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_ForeColor
Вызовите этот метод, чтобы задать цвет переднего плана элемента управления.
HRESULT STDMETHODCALLTYPE put_ForeColor(OLE_COLOR clrForeColor);
Параметры
clrForeColor
Цвет переднего плана элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_HWND
Этот метод возвращает E_FAIL.
HRESULT STDMETHODCALLTYPE put_HWND(LONG_PTR /* hWnd */);
Параметры
hWnd
Зарезервировано.
Возвращаемое значение
Возвращает E_FAIL.
Замечания
Дескриптор окна доступен только для чтения.
CStockPropImpl::put_MouseIcon
Вызовите этот метод, чтобы задать свойства рисунка изображения (значка, растрового изображения или метафайла), отображаемого при наведении указателя мыши на элемент управления.
HRESULT STDMETHODCALLTYPE put_MouseIcon(IPictureDisp* pPicture);
Параметры
pPicture
Указатель на свойства изображения рисунка.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_MousePointer
Вызовите этот метод, чтобы задать тип указателя мыши, отображаемый при наведении указателя мыши на элемент управления, например стрелка, крест или песочные часы.
HRESULT STDMETHODCALLTYPE put_MousePointer(LONG nMousePointer);
Параметры
nMousePointer
Тип указателя мыши.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_Picture
Вызовите этот метод, чтобы задать свойства рисунка (значка, растрового изображения или метафайла), который будет отображаться.
HRESULT STDMETHODCALLTYPE put_Picture(IPictureDisp* pPicture);
Параметры
pPicture
Указатель на свойства изображения. Дополнительные сведения см. в разделе IPictureDisp.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_ReadyState
Вызовите этот метод, чтобы задать состояние готовности элемента управления, например загружается или загружен.
HRESULT STDMETHODCALLTYPE put_ReadyState(LONG nReadyState);
Параметры
nReadyState
Состояние готовности элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_TabStop
Вызовите этот метод, чтобы задать флаг, указывающий, доступен ли элемент управления для перехода клавишей TAB.
HRESULT STDMETHODCALLTYPE put_TabStop(VARIANT_BOOL bTabStop);
Параметры
bTabStop
Значение TRUE, если элемент управления доступен для перехода клавишей TAB.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_Text
Вызовите этот метод, чтобы задать текст, отображаемый с элементом управления.
HRESULT STDMETHODCALLTYPE put_Text(BSTR bstrText);
Параметры
bstrText
Текст, отображаемый с элементом управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::putvalid
Вызовите этот метод, чтобы задать флаг, указывающий, допустим ли элемент управления.
HRESULT STDMETHODCALLTYPE getvalid(VARIANT_BOOL bValid);
Параметры
bValid
Значение TRUE, если элемент управления допустим.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
CStockPropImpl::put_Window
Этот метод вызывает CStockPropImpl::put_HWND, который возвращает E_FAIL.
HRESULT STDMETHODCALLTYPE put_Window(LONG_PTR hWnd);
Параметры
hWnd
Дескриптор окна.
Возвращаемое значение
Возвращает E_FAIL.
Замечания
Дескриптор окна доступен только для чтения.
CStockPropImpl::putref_Font
Вызовите этот метод, чтобы задать свойства шрифта элемента управления со счетчиком ссылок.
HRESULT STDMETHODCALLTYPE putref_Font(IFontDisp* pFont);
Параметры
pFont
Указатель на свойства шрифта элемента управления.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
Аналог CStockPropImpl::put_Font, но со счетчиком ссылок.
CStockPropImpl::putref_MouseIcon
Вызовите этот метод, чтобы задать свойства рисунка изображения (значка, растрового изображения или метафайла), отображаемого при наведении указателя мыши на элемент управления, со счетчиком ссылок.
HRESULT STDMETHODCALLTYPE putref_MouseIcon(IPictureDisp* pPicture);
Параметры
pPicture
Указатель на свойства изображения рисунка.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
Аналог CStockPropImpl::put_MouseIcon, но со счетчиком ссылок.
CStockPropImpl::putref_Picture
Вызовите этот метод, чтобы задать свойства рисунка (значка, растрового изображения или метафайла), который будет отображаться, со счетчиком ссылок.
HRESULT STDMETHODCALLTYPE putref_Picture(IPictureDisp* pPicture);
Параметры
pPicture
Указатель на свойства изображения. Дополнительные сведения см. в разделе IPictureDisp.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
Аналог CStockPropImpl::put_Picture, но со счетчиком ссылок.
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по