Russian Belarusian English German Japanese Ukrainian

Rashka.studio - игры и приложения для Android! Заходи, ждём тебя =)

FindNextControl

CuBook05

Описание

Метод FindNextControl находит и возвращает следующий за указанным в параметре CurControl дочерний оконный компонент в соответствии с последовательностью табуляции. Если CurControl не является дочерним компонентом данного оконного элемента, то возвращается компонент, первый в последовательности табуляции. То же самое происходит, если CurControl является последним компонентом в последовательности табуляции.
Параметр GoForward определяет направление поиска. Если он равен true, то поиск проводится вперед и возвращается компонент, следующий за CurControl. Если же параметр GoForward равен false, то возвращается предшествующий компонент.
Параметры CheckTabStop и CheckParent определяют условия поиска. Если CheckTabStop равен true, то просматриваются только компоненты, в которых свойство TabStop установлено в true. При CheckTabStop равном false значение TabStop не принимается во внимание. Если параметр CheckParent равен true, то просматриваются только компоненты, в свойстве Parent которых указан данный оконный элемент, т.е. просматриваются только прямые потомки. Если CheckParent равен false, то просматриваются все, даже косвенные потомки данного элемента.
Метод FindNextControl вызывает метой GetTabOrderList и из полученного таким способом списка черпает последовательность компонентов.
 
Классы

TWinControl
 
Определение

TWinControl* __fastcall FindNextControl(TWinControl* CurControl, bool GoForward, bool CheckTabStop, bool CheckParent);
 
Пример

TWinControl *obj;
for(int i = 0; i < Form1->ControlCount; i++)
{
obj = Form1->FindNextControl(obj, true, true, true);
}
В этом примере переменная obj поочередно принимает значение всех прямых наследников формы Form1, включенных в последовательность табуляции, т.е. имеющих свойство TabStop равным true. Например, в эту последовательность войдут окна редактирования, кнопки, панели, расположенные непосредственно на форме и имеющие TabStop равным true, но не войдут кнопки и окна редактирования, расположенные на панелях.
 
Если в приведенном операторе изменить параметр CheckParent на false:
obj = Form1->FindNextControl(obj, true, true, false);
В последовательность войдут и непрямые наследники, имеющие TabStop равным true, в частности, компоненты, содержащиеся в панелях, расположенных на форме, причем независимо от значения TabStop этих панелей.
 
Если в приведенном операторе изменить параметр CheckTabStop на false:
obj = Form1->FindNextControl(obj, true, false, false);
В последовательность войдут компоненты, независимо от значения их свойства TabStop.
Если заметили ошибку, выделите фрагмент текста и нажмите Ctrl+Enter

Добавить комментарий