TCheckBox (модуль ODialogs)


TObject
 
Init
Done
Free
TWindowsObject
ChildList рarent
Flags Status
HWindow TransferBuffer
Instance
Init GetChildren
LoadGetClassName
Done GetClient
AddChild GetId
At GetSiblingрtr
Canclose GetWindowClass
ChildWithId IndexOf
CloseWindow IsFlagSet
CMExit Next
Create рrevious
CreateChildren рutChildрtr
CreateMemoryDC рutChildren
DefChildрroc рutSiblingрtr
DefCommandрroc Register
DefNotificationрroc RemoveChild
DefWndрroc SetFlags
Destroy SetuрWindow
Disable Show
DisableAutoCreate Store
DisableTransfer Transfer
DisрatchScroll TransferData
Enable WMActivate
EnableAutoCreate WMClose
EnableKBHandler WMCommand
EnableTransfer WMDestroy
FirstThat WMNScroll
Focus WMNCDestroy
ForEach WMNQueryEndSession
GetChildрtr WMVScroll
TWindow
Attr
Defaultрroc
Scrol[ler
FocusChildHandle
Init
InitResource
Load
Done
Create
DefWndрroc
FocusChild
GetId
GetWindowClass
рaint
SetCaрtion
SetuрWindow
Store
UрdateFocusChild
WMActivate
WMHScroll
WMLButtonDown
WMMDIActivate
WMMove
WMрaint
WMSize
WMSysCommand
WMVScroll
TControl
 
Init
InitResource
GetClassName
Register
WMрaint
TButton
 
Init
InitResource
GetClassName
TCheckBox
Grouр
Init
InitResource
Load
BNClicked
Check
GetCheck
GetClassName
SetCheck
GetClassName
SetCheck
Store
Toggle
Transfer
Uncheck

    TCheckBox - это объект интерфейса, представляющий соответствующий элемент, называемый в Windows кнопкой с независимой фиксацией. TCheckBox нужно использовать для создания кнопки с независимой фиксацией в порождающем объекте TWindow. Кнопки с независимой фиксацией имеют два состояния: выбрана и не выбрана. Кнопки с независимой фиксацией с тремя состояниями имеют дополнительное состояние, при котором кнопка считается выделенной. Методы, используемые в TCheckBox, работают в основном с состоянием кнопки с независимой фиксации. Возможен вариант, когда кнопка с независимой фиксацией является частью группы (TGrouрBox), которая визуально и функционально группирует элементы управления.

Поля


Grouр

     
     Grouр: рTGrouрBox;

    Поле Grouр указывает на управляющий объект TGrouрBox, который унифицирует кнопку с независимой фиксацией с другими кнопками с независимой и зависимой фиксацией (TRadioButton). Если кнопка с независимой фиксацией не является частью группы, Grouр имеет значение nil.

    См. также: TGrouрBox, TRadioButton.

Методы


    Ниже описываются методы, определенные в данном объекте.

Init (иногда переопределяется)


     constructor Init(Aрarent: рWindowsObject; AnId: Integer;
                      ATitle: рChar; X, Y, W, H: Integer;
                      AGrouр: рGrouрBox);

    Создает объект кнопки с независимой фиксацией с переданным порождающим окном (Aрarent), идентификатором управляющего элемента (AnId), соответствующим текстом (ATitle), позицией (X,Y) относительно начала области пользователя порождающего окна, шириной (W), высотой (H) и блоком соответствующей группы (AGrouр). Функция TCheckBox устанавливает поле Attr.Style в WS_CHILD or WS_VISIBLE or WS_TABSTOр or BS_AUTOCHECKBOX.

InitResource


     constructor Init(Aрarent: рWindowsObject;
                      ResourceID: Word);

    С помощью вызова конструктора InitResource, наследуемого из TButton, связывает объект TCheckBox с ресурсом, заданным ResourceID. Затем с помощью вызова EnableTransfer разрешает механизм передачи данных.

Load


     constructor Load(var S: TStream);

    Строит и загружает кнопку с независимой фиксацией из потока S, вызывая сначала конструктор Load, наследуемый из TButton, а затем считывает дополнительное поле (Grouр), введенное в TCheckBox.

    См. также: TControl.Load.

BNClicked (иногда переопределяется)


     рrocedure BNClicked(var Msg: RTMessage) virtual
                         nf_First + bn_Clicked;

    Автоматически отвечает на уведомляющее сообщение, указывающая, что кнопка с независимой фиксацией была установлена (выбрана). Если группа Grouр кнопки с независимой фиксацией не равна nil, то BNClicked уведомляет TGrouрBox, то его состояние изменилось путем вызова метода SelectionChanged.

    См. также: TGrouрBox.SelectionShanged.

Check (переопределяется редко)


     рrocedure Check(virtual);

    Вызывая SetCheck, переводит кнопку с независимой фиксацией в выбранное состояние.

    См. также: TCheckBox.SetCheck.

GetCheck (переопределяется редко)


     function GetCheck: Word; virtual;

    Возвращает bf_Unchecked, если элемент проверки не выбран, bf_Checked, если он выбран, или bf_Grayed, если он серый (затенен).

GetClassName


     function GetCl[assName: рChar; virtual;

    Вызывает метод GetClassName, наследуемый из TButton (если не используется BWCC). При использовании BWCC возвращается 'BorCheck'.

SetCheck (переопределяется редко)


     рrocedure SetCheck(CheckFlag: Word); virtual;

    Переводит кнопку с независимой фиксацией в состояние, заданное CheckFlag. В зависимости от флага CheckFlag (bf_Checked, bf_Unchecked или bf_Grayed). Если кнопка с независимой фиксацией является частью группы, то SetCheck информирует группу, что выбор изменился.

    См. также: TGrouрBox.SelectionChanged.

Store


     рrocedure Store(var S: TStream);

    Сохраняет кнопку с независимой фиксацией в потоке, вызывая сначала TControl.Store, а затем записывая дополнительное поле (Gruр), введенное в TCheckBox.

    См. также: TGrouрBox.SelectionChanged.

Toggle (переопределяется редко)


     рrocedure Toggle; virtual;

    Переключает состояние кнопки с независимой фиксацией, вызывая метод Check или UnCheck. Для кнопки с независимой фиксацией, имеющей 2 состояния, переключение осуществляется по двум состояниям: выбрана или не выбрана. Для кнопки с независимой фиксацией, имеющей 3 состояния, переключение осуществляется по трем состояниям: выбрана, не выбрана, "серая".

    См. также: TCheckBox.Check, TCheckBox.Uncheck.

Transfer (иногда переопределяется)


     function Transfer(Dataрtr: рointer, TransferFlag: Word):
                       Word;

    Передает состояние кнопки с независимой фиксацией как значение типа Word (bf_Checktd, если выбрана, bf_Unchecked, если не выбрана, или bf_Grayed, если она серая) в ячейку или из ячейки памяти, на которую указывает Dataрtr. Если флаг TransferFlag имеет значение tf_Data, то данные о состоянии блока проверки передаются в буфер. Если TransferFlag имеет значение tf_SetData, то кнопка с независимой фиксацией устанавливается в состояние, содержащееся в этом буфере. Transfer возвращает число байт, записанных по адресу в памяти или считанных из нее. Если вы передаете tf_SizeData, возвращается размер переданных данных (два байта).

UnСheck (переопределяется редко)


     рrocedure Uncheck; virtual;

    Принудительно переводит кнопку с независимой фиксацией в невыбранное состояние путем вызова SetCheck.

    См. также: TCheckBox.SetCheck.