---
title: "Интерфейс IPropertyCheckBox"
type: interface
api: [api7]
tags: [interface, api7, ipropertycheckbox]
sources:
  - ipropertycheckbox.html
---

*API интерфейсов. Версия 7 > Приложение > Работа с Панелью свойств  > Интерфейс IPropertyControl  > IPropertyControl - свойства *


## Интерфейс IPropertyCheckBox

![IPropertyCheckBox](../resources/images_ipropertycheckbox.jpg)

Интерфейс элемента управления Панели свойств Опция.
| |
| --- |
Элемент панели свойств
Иерархия:
IKompasAPIObject
IPropertyControl
IPropertyCheckBox
Примечание:
1. Вместо стандартного вида элемента управления можно задать значки для его различных состояний.
2. Данный интерфейс можно получить через интерфейс коллекции элементов управления панели свойств IPropertyControls.
3. При активизации элемента управления вызывается событие ksIPropertyManagerNotify::ChangeControlValue.


## ClearValue - Очистить значение. Установить неопределенное состояние

Синтаксис Automation:
```
BOOL ClearValue();
```
Синтаксис COM:
```
HRESULT ClearValue( BOOL * Result );
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
```
Примечание:
Возможность установки неопределенного состояния доступна при использовании стиля IPropertyCheckBox::VisualStyle = ksCheckBoxOptional.
Версия Компас v23


## SetCustomBitmaps - Задать значки для различных состояний элемента управления

Функция не поддерживается
Синтаксис Automation:
```
void SetCustomBitmaps (const VARIANT& idUnchecked,
const VARIANT& idChecked,
const VARIANT& idIndeterminate,
const VARIANT& hInstance);
```
Синтаксис COM:
```
HRESULT SetCustomBitmaps ([in]VARIANT idUnchecked,
[in]VARIANT idChecked,
[in]VARIANT idIndeterminate,
[in]VARIANT hInstance );
Входные параметры:
idUnchecked    - значок ненажатого состояния,
idChecked    - битмап нажатого состояния,
idIndeterminate    - битмап неопределенного состояния,
hInstance    - dll-модуль с ресурсами значков.
```
Примечание:
1. Значки могут быть заданы в виде идентификаторов в ресурсе dll-модуля (тип данных long) или в виде полного пути к bmp-файлу значка (тип данных BSTR). Обязательным является задание значка для ненажатого состояния idUnchecked, остальные могут быть не заданы.
2. Все значения переменных должны быть одного типа (или long или BSTR).
3. Если значки задаются в виде идентификатора, то обязательно должен быть задан dll-модуль, в ресурсах которого лежат эти значки. Модуль с ресурсами значков hInstance может быть задан в виде HINSTANCE (тип значения long) или полного пути к файлу (тип значения BSTR) dll-модуля.


## VisualStyle - Визуальный стиль

Тип данных: из перечисления ksCheckBoxVisualStyleEnum
Синтаксис Automation:
```
VisualStyle = Object.VisualStyle    Получить свойство (* )
Object.VisualStyle = VisualStyle    Установить свойство (* )
VisualStyle = Object.GetVisualStyle()    Получить свойство (**)
Object.SetVisualStyle( VisualStyle )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_VisualStyle( &VisualStyle )    Получить свойство
Object.put_VisualStyle( VisualStyle )    Установить свойство
```
Примечание
Свойство задает визуальный стиль отображения чекбокса:
•ksCheckBoxDefault - обычный чекбокс,
•ksCheckBoxSwitcher - переключатель.
