blockly > IFocusableTree > getRestoredFocusableNode
طريقة IFocusableTree.getRestoredFocusableNode()
تُعيد هذه الدالة عنصر IFocusableNode الخاص بهذه الشجرة الذي يجب أن يتلقّى التركيز النشط عندما يتمّ إعادة التركيز إلى الشجرة نفسها.
هناك بعض الملاحظات المهمة جدًا التي يجب مراعاتها بشأن دورة حياة تركيز الشجرة عند تنفيذ إصدار من هذه الطريقة لا يعرض قيمة فارغة: 1. لا تضمن قيمة previousNode غير الصالحة حالة التركيز لأول مرة لأنّه يمكن حذف العقد. 2. لا تُستخدَم هذه الطريقة إلا عند التركيز على الشجرة نفسها، إما من خلال التنقّل باستخدام علامة التبويب أو من خلال FocusManager.focusTree(). وفي كثير من الحالات، سيتم التركيز مباشرةً على العقدة التي تم التركيز عليها سابقًا بدلاً من ذلك، ما سيؤدي إلى تجاوز هذه الطريقة. 3- يتضمن السلوك التلقائي (أي عرض القيمة null هنا) إما استعادة العقدة السابقة (previousNode) أو التركيز على جذر الشجرة. 4. قد لا تكون العقدة المقدَّمة صالحة في بعض الأحيان، مثل محاولة التركيز على عقدة تمت إزالتها مؤخرًا من الشجرة الرئيسية. يمكن للعمليات التحقّق من صلاحية العقدة من أجل تخصيص العقدة التي يجب أن يعود إليها التركيز.
تهدف هذه الطريقة إلى حد كبير إلى تزويد عمليات تنفيذ الأشجار بوسائل لتحديد عقدة تلقائية أفضل من الجذر.
Signature:
getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;
المعلمات
المَعلمة | النوع | الوصف |
---|---|---|
previousNode | IFocusableNode | null | العقدة التي كانت تركّز بشكل سلبي على هذه الشجرة في السابق، أو قيمة فارغة إذا لم يتم التركيز على الشجرة بعد |
المرتجعات:
IFocusableNode | null
عنصر IFocusableNode الذي من المفترض أن يتلقّى التركيز الآن، أو قيمة فارغة إذا كان يجب استخدام السلوك التلقائي بدلاً من ذلك.