قائمة بإضافات KTX

androidx.activity

الاعتمادية

Groovy

dependencies {
    implementation "androidx.activity:activity-ktx:1.10.1"
}

Kotlin

dependencies {
    implementation("androidx.activity:activity-ktx:1.10.1")
}

وظائف الإضافة

بالنسبة إلى OnBackPressedDispatcher
OnBackPressedCallback OnBackPressedDispatcher.addCallback(owner: LifecycleOwner? = null, enabled: Boolean = true, onBackPressed: OnBackPressedCallback.() -> Unit)

أنشئ وأضِف OnBackPressedCallback جديدًا يستدعي onBackPressed في OnBackPressedCallback.handleOnBackPressed.

بالنسبة إلى ComponentActivity
Lazy<VM> ComponentActivity.viewModels(noinline factoryProducer: () -> ViewModelProvider.Factory = null)

تعرض هذه الدالة تفويض Lazy للوصول إلى ViewModel الخاص بـ ComponentActivity. وإذا تم تحديد factoryProducer، سيتم استخدام ViewModelProvider.Factory الذي تعرضه لإنشاء ViewModel للمرة الأولى.

androidx.benchmark

الاعتمادية

رائع

dependencies {
    implementation "androidx.benchmark:benchmark-junit4:1.4.0"
}

Kotlin

dependencies {
    implementation("androidx.benchmark:benchmark-junit4:1.4.0")
}

الدوال ذات المستوى الأعلى

الوحدة beginTraceSection(sectionName: String)

الوحدة endTraceSection()

androidx.benchmark.junit4

الاعتمادية

رائع

dependencies {
    implementation "androidx.benchmark:benchmark-junit4:1.4.0"
}

Kotlin

dependencies {
    implementation("androidx.benchmark:benchmark-junit4:1.4.0")
}

وظائف الإضافة

بالنسبة إلى BenchmarkRule
الوحدة BenchmarkRule.measureRepeated(crossinline block: BenchmarkRule.Scope.() -> Unit)

قياس أداء مجموعة من الرموز

androidx.collection

الاعتمادية

رائع

dependencies {
    implementation "androidx.collection:collection-ktx:1.5.0"
}

Kotlin

dependencies {
    implementation("androidx.collection:collection-ktx:1.5.0")
}

وظائف الإضافة

بالنسبة إلى LongSparseArray
عامل التشغيل قيمة منطقية LongSparseArray<T>.contains(key: Long)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

الوحدة LongSparseArray<T>.forEach(action: (key: Long, value: T) -> Unit)

ينفّذ الإجراء المحدّد لكل إدخال مفتاح/قيمة.

T LongSparseArray<T>.getOrDefault(key: Long, defaultValue: T)

لعرض القيمة المقابلة للمفتاح، أو defaultValue في حال عدم توفّره.

T LongSparseArray<T>.getOrElse(key: Long, defaultValue: () -> T)

تعرض هذه الدالة القيمة المقابلة للمفتاح، أو من defaultValue عندما لا يكون المفتاح متوفّرًا.

Boolean LongSparseArray<T>.isNotEmpty()

عرض القيمة "صحيح" عندما تحتوي المجموعة على عناصر

LongIterator LongSparseArray<T>.keyIterator()

لعرض مكرّر على مفاتيح المجموعة.

operator LongSparseArray<T> LongSparseArray<T>.plus(other: LongSparseArray<T>)

تنشئ هذه السمة مجموعة جديدة من خلال إضافة إدخالات من غير ذلك أو استبدالها.

Boolean LongSparseArray<T>.remove(key: Long, value: T)

تزيل هذه الدالة الإدخال الخاص بالمفتاح فقط إذا كان مرتبطًا بالقيمة.

عامل التشغيل الوحدة LongSparseArray<T>.set(key: Long, value: T)

يسمح باستخدام عامل الفهرس لتخزين القيم في المجموعة.

Iterator<T> LongSparseArray<T>.valueIterator()

لعرض مكرّر على قيم المجموعة.

بالنسبة إلى SparseArrayCompat
عامل التشغيل قيمة منطقية SparseArrayCompat<T>.contains(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

الوحدة SparseArrayCompat<T>.forEach(action: (key: Int, value: T) -> Unit)

ينفّذ الإجراء المحدّد لكل إدخال مفتاح/قيمة.

T SparseArrayCompat<T>.getOrDefault(key: Int, defaultValue: T)

لعرض القيمة المقابلة للمفتاح، أو defaultValue في حال عدم توفّره.

T SparseArrayCompat<T>.getOrElse(key: Int, defaultValue: () -> T)

تعرض هذه الدالة القيمة المقابلة للمفتاح، أو من defaultValue عندما لا يكون المفتاح متوفّرًا.

Boolean SparseArrayCompat<T>.isNotEmpty()

عرض القيمة "صحيح" عندما تحتوي المجموعة على عناصر

IntIterator SparseArrayCompat<T>.keyIterator()

لعرض مكرّر على مفاتيح المجموعة.

operator SparseArrayCompat<T> SparseArrayCompat<T>.plus(other: SparseArrayCompat<T>)

تنشئ هذه السمة مجموعة جديدة من خلال إضافة إدخالات من غير ذلك أو استبدالها.

Boolean SparseArrayCompat<T>.remove(key: Int, value: T)

تزيل هذه الدالة الإدخال الخاص بالمفتاح فقط إذا كان مرتبطًا بالقيمة.

عامل التشغيل الوحدة SparseArrayCompat<T>.set(key: Int, value: T)

يسمح باستخدام عامل الفهرس لتخزين القيم في المجموعة.

Iterator<T> SparseArrayCompat<T>.valueIterator()

لعرض مكرّر على قيم المجموعة.

سمات الإضافة

بالنسبة إلى LongSparseArray
Int LongSparseArray<T>.size()

تعرض هذه الدالة عدد أزواج المفتاح/القيمة في المجموعة.

بالنسبة إلى SparseArrayCompat
Int SparseArrayCompat<T>.size()

تعرض هذه الدالة عدد أزواج المفتاح/القيمة في المجموعة.

الدوال ذات المستوى الأعلى

ArrayMap< K, V> arrayMapOf()

تعرض هذه الدالة ArrayMap فارغًا جديدًا.

ArrayMap< K, V> arrayMapOf(vararg pairs: Pair<K, V>)

تعرض هذه الدالة ArrayMap جديدة تتضمّن المحتوى المحدّد، ويتم تقديمها كقائمة من الأزواج حيث يكون المكوّن الأول هو المفتاح والمكوّن الثاني هو القيمة.

ArraySet<T> arraySetOf()

تعرض هذه الطريقة ArraySet جديدًا فارغًا.

ArraySet<T> arraySetOf(vararg values: T)

تعرض هذه السمة ArraySet جديدة تتضمّن المحتوى المحدّد.

LruCache< K, V> lruCache(maxSize: Int, crossinline sizeOf: (key: K, value: V) -> Int = { _, _ -> 1 }, crossinline create: (key: K) -> V? = { null as V? }, crossinline onEntryRemoved: (evicted: Boolean, key: K, oldValue: V, newValue: V?) -> Unit = { _, _, _, _ -> })

تنشئ هذه الدالة LruCache مع المَعلمات المحدّدة.

androidx.core.animation

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.animation.Animator
AnimatorListener Animator.addListener(crossinline onEnd: (animator: Animator) -> Unit = {}, crossinline onStart: (animator: Animator) -> Unit = {}, crossinline onCancel: (animator: Animator) -> Unit = {}, crossinline onRepeat: (animator: Animator) -> Unit = {})

أضِف أداة معالجة إلى هذا العنصر Animator باستخدام الإجراءات المتوفّرة.

AnimatorPauseListener Animator.addPauseListener(crossinline onResume: (animator: Animator) -> Unit = {}, crossinline onPause: (animator: Animator) -> Unit = {})

أضِف أداة معالجة الإيقاف المؤقت والاستئناف إلى هذا العنصر المتحرّك باستخدام الإجراءات المتوفّرة.

AnimatorListener Animator.doOnCancel(crossinline action: (animator: Animator) -> Unit)

أضِف إجراءً سيتم تنفيذه عند إلغاء الرسوم المتحركة.

AnimatorListener Animator.doOnEnd(crossinline action: (animator: Animator) -> Unit)

أضِف إجراءً سيتم تنفيذه عند انتهاء الرسوم المتحركة.

AnimatorPauseListener Animator.doOnPause(crossinline action: (animator: Animator) -> Unit)

إضافة إجراء سيتم تنفيذه عند إيقاف الرسوم المتحركة مؤقتًا

AnimatorListener Animator.doOnRepeat(crossinline action: (animator: Animator) -> Unit)

أضِف إجراءً سيتم تنفيذه عند تكرار الصورة المتحركة.

AnimatorPauseListener Animator.doOnResume(crossinline action: (animator: Animator) -> Unit)

أضِف إجراء سيتم تنفيذه عند استئناف الرسوم المتحركة بعد إيقافها مؤقتًا.

AnimatorListener Animator.doOnStart(crossinline action: (animator: Animator) -> Unit)

أضِف إجراءً سيتم تنفيذه عند بدء الصورة المتحركة.

androidx.core.content

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.content.Context
T? Context.getSystemService()

إرجاع معرّف خدمة على مستوى النظام حسب الفئة

الوحدة Context.withStyledAttributes(set: AttributeSet? = null, attrs: IntArray, @AttrRes defStyleAttr: Int = 0, @StyleRes defStyleRes: Int = 0, block: TypedArray.() -> Unit)

تنفيذ block على جهاز استقبال TypedArray

الوحدة Context.withStyledAttributes(@StyleRes resourceId: Int, attrs: IntArray, block: TypedArray.() -> Unit)

تنفيذ block على جهاز استقبال TypedArray

بالنسبة إلى android.content.SharedPreferences
الوحدة SharedPreferences.edit(commit: Boolean = false, action: Editor.() -> Unit)

يسمح بتعديل مثيل الإعدادات المفضّلة هذا من خلال استدعاء apply أو commit للاحتفاظ بالتغييرات.

الدوال ذات المستوى الأعلى

ContentValues contentValuesOf(vararg pairs: Pair<String, Any?>)

تعرض هذه الدالة ContentValues جديدة تحتوي على أزواج المفاتيح/القيم المحدّدة كعناصر.

androidx.core.content.res

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.content.res.TypedArray
Boolean TypedArray.getBooleanOrThrow(@StyleableRes index: Int)

استرداد القيمة المنطقية للسمة في الفهرس أو عرض IllegalArgumentException إذا لم يتم تحديدها.

Int TypedArray.getColorOrThrow(@StyleableRes index: Int)

استرداد قيمة اللون للسمة في الفهرس أو عرض IllegalArgumentException إذا لم يتم تحديدها

ColorStateList TypedArray.getColorStateListOrThrow(@StyleableRes index: Int)

استرجِع قيمة قائمة حالات الألوان للسمة في الفهرس أو اعرض IllegalArgumentException إذا لم يتم تحديدها.

Float TypedArray.getDimensionOrThrow(@StyleableRes index: Int)

استرجِع قيمة السمة في الفهرس أو أرسِل IllegalArgumentException إذا لم يتم تحديدها.

Int TypedArray.getDimensionPixelOffsetOrThrow(@StyleableRes index: Int)

استرجِع قيمة إزاحة البكسل للسمة في الفهرس أو اعرض IllegalArgumentException إذا لم يتم تحديدها.

Int TypedArray.getDimensionPixelSizeOrThrow(@StyleableRes index: Int)

استرجِع قيمة حجم البكسل للسمة في الفهرس أو اعرض الخطأ IllegalArgumentException إذا لم يتم تحديدها.

Drawable TypedArray.getDrawableOrThrow(@StyleableRes index: Int)

استرداد قيمة العنصر القابل للرسم للسمة في الفهرس أو عرض IllegalArgumentException إذا لم يتم تحديدها

Float TypedArray.getFloatOrThrow(@StyleableRes index: Int)

استرجِع قيمة العدد العشري للسمة في الفهرس أو أرسِل IllegalArgumentException إذا لم يتم تحديدها.

نوع الخط TypedArray.getFontOrThrow(@StyleableRes index: Int)

استرجِع قيمة الخط للسمة في الفهرس أو اعرض IllegalArgumentException إذا لم يتم تحديدها.

Int TypedArray.getIntOrThrow(@StyleableRes index: Int)

استرداد قيمة العدد الصحيح للسمة في الفهرس أو عرض IllegalArgumentException إذا لم يتم تحديدها

Int TypedArray.getIntegerOrThrow(@StyleableRes index: Int)

استرداد قيمة العدد الصحيح للسمة في الفهرس أو عرض IllegalArgumentException إذا لم يتم تحديدها

Int TypedArray.getResourceIdOrThrow(@StyleableRes index: Int)

يستردّ معرّف المورد للسمة في الفهرس أو يعرض IllegalArgumentException إذا لم يتم تحديده.

String TypedArray.getStringOrThrow(@StyleableRes index: Int)

استرجِع قيمة السلسلة للسمة في الفهرس أو اعرض IllegalArgumentException إذا لم يتم تحديدها.

Array<CharSequence> TypedArray.getTextArrayOrThrow(@StyleableRes index: Int)

استرجِع قيمة مصفوفة النص للسمة في الفهرس أو اعرض IllegalArgumentException إذا لم يتم تحديدها.

CharSequence TypedArray.getTextOrThrow(@StyleableRes index: Int)

استرداد قيمة النص للسمة في الفهرس أو عرض IllegalArgumentException إذا لم يتم تحديدها.

R TypedArray.use(block: (TypedArray) -> R)

تنفيذ دالة block المحدّدة على هذا TypedArray ثم إعادة تدويره

androidx.core.database

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.database.Cursor
ByteArray؟ Cursor.getBlobOrNull(index: Int)

تعرض قيمة العمود المطلوب كصفيف بايت قابل للتسوية.

مضاعفة؟ Cursor.getDoubleOrNull(index: Int)

تعرض قيمة العمود المطلوب كقيمة مزدوجة تقبل القيم الخالية.

Float؟ Cursor.getFloatOrNull(index: Int)

تعرض قيمة العمود المطلوب كعدد عشري يقبل القيم الخالية.

Int؟ Cursor.getIntOrNull(index: Int)

تعرض هذه الدالة قيمة العمود المطلوب كعدد صحيح يقبل القيم الخالية.

طويل؟ Cursor.getLongOrNull(index: Int)

تعرض هذه الدالة قيمة العمود المطلوب كقيمة طويلة قابلة للتصغير.

Short؟ Cursor.getShortOrNull(index: Int)

تعرض قيمة العمود المطلوب كقيمة قصيرة تقبل القيم الخالية.

String? Cursor.getStringOrNull(index: Int)

تعرض قيمة العمود المطلوب كسلسلة تقبل القيم الخالية.

androidx.core.database.sqlite

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.database.sqlite.SQLiteDatabase
T SQLiteDatabase.transaction(exclusive: Boolean = true, body: SQLiteDatabase.() -> T)

تنفيذ body في عملية مع وضع علامة على أنّها ناجحة إذا اكتملت بدون استثناء

androidx.core.graphics

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.graphics.Bitmap
Bitmap Bitmap.applyCanvas(block: Canvas.() -> Unit)

تنشئ هذه الدالة لوحة رسم جديدة للرسم على الصورة النقطية، وتنفّذ الكتلة المحدّدة على لوحة الرسم التي تم إنشاؤها حديثًا.

عامل التشغيل قيمة منطقية Bitmap.contains(p: Point)

تعرض هذه الطريقة القيمة "صحيح" إذا كانت النقطة المحدّدة داخل الصورة النقطية.

عامل التشغيل قيمة منطقية Bitmap.contains(p: PointF)

تعرض هذه الطريقة القيمة "صحيح" إذا كانت النقطة المحدّدة داخل الصورة النقطية.

عامل التشغيل Int Bitmap.get(x: Int, y: Int)

تعرض هذه الدالة قيمة البكسل في الموقع الجغرافي المحدّد.

Bitmap Bitmap.scale(width: Int, height: Int, filter: Boolean = true)

تنشئ هذه الطريقة صورة نقطية جديدة، يتم تغيير حجمها من هذه الصورة النقطية، عندما يكون ذلك ممكنًا.

عامل التشغيل الوحدة Bitmap.set(x: Int, y: Int, color: Int)

تكتب هذه الطريقة عددًا صحيحًا للون محدّدًا في الصورة النقطية (بافتراض أنّها قابلة للتغيير) عند الإحداثي (x, y) المحدّد.

بالنسبة إلى android.graphics.Canvas
الوحدة Canvas.withClip(clipRect: Rect, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.clipRect وCanvas.restoreToCount.

الوحدة Canvas.withClip(clipRect: RectF, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.clipRect وCanvas.restoreToCount.

الوحدة Canvas.withClip(left: Int, top: Int, right: Int, bottom: Int, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.clipRect وCanvas.restoreToCount.

الوحدة Canvas.withClip(left: Float, top: Float, right: Float, bottom: Float, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.clipRect وCanvas.restoreToCount.

الوحدة Canvas.withClip(clipPath: Path, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.clipPath وCanvas.restoreToCount.

الوحدة Canvas.withMatrix(matrix: Matrix = Matrix(), block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.concat وCanvas.restoreToCount.

الوحدة Canvas.withRotation(degrees: Float = 0.0f, pivotX: Float = 0.0f, pivotY: Float = 0.0f, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.rotate وCanvas.restoreToCount.

الوحدة Canvas.withSave(block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في طلبات إلى Canvas.save وCanvas.restoreToCount.

الوحدة Canvas.withScale(x: Float = 1.0f, y: Float = 1.0f, pivotX: Float = 0.0f, pivotY: Float = 0.0f, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Canvas.save/Canvas.scale وCanvas.restoreToCount.

الوحدة Canvas.withSkew(x: Float = 0.0f, y: Float = 0.0f, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في طلبات إلى Canvas.save/Canvas.skew وCanvas.restoreToCount.

الوحدة Canvas.withTranslation(x: Float = 0.0f, y: Float = 0.0f, block: Canvas.() -> Unit)

لفّ الكتلة المحدّدة في طلبات إلى Canvas.save/Canvas.translate وCanvas.restoreToCount.

بالنسبة إلى android.graphics.Color
عامل التشغيل Float Color.component1()

تعرض هذه السمة المكوّن الأول للّون.

عامل التشغيل Float Color.component2()

تعرض هذه السمة المكوّن الثاني من اللون.

عامل التشغيل Float Color.component3()

تعرض هذه السمة المكوّن الثالث للّون.

عامل التشغيل Float Color.component4()

تعرض هذه السمة المكوّن الرابع للّون.

infix Color! Color.convertTo(colorSpace: Named)

تحويل جهاز استقبال الألوان إلى لون في مساحة الألوان المحدّدة

infix Color! Color.convertTo(colorSpace: ColorSpace)

تحويل جهاز استقبال الألوان إلى لون في مساحة الألوان المحدّدة

عامل التشغيل اللون Color.plus(c: Color)

يدمج لونَين نصف شفافَين معًا.

بالنسبة إلى android.graphics.ImageDecoder.Source
Bitmap Source.decodeBitmap(crossinline action: ImageDecoder.(info: ImageInfo, source: Source) -> Unit)

إنشاء صورة نقطية من مصدر

Drawable Source.decodeDrawable(crossinline action: ImageDecoder.(info: ImageInfo, source: Source) -> Unit)

إنشاء عنصر قابل للرسم من مصدر

بالنسبة إلى android.graphics.Matrix
عامل التشغيل المصفوفة Matrix.times(m: Matrix)

تضرب هذه المصفوفة مصفوفة أخرى وتعرض النتيجة كمصفوفة جديدة.

FloatArray Matrix.values()

تعرض هذه الدالة القيم التسع للمصفوفة كصفيف جديد من الأرقام العشرية.

بالنسبة إلى android.graphics.Paint
Boolean Paint.setBlendMode(blendModeCompat: BlendModeCompat?)

طريقة ملائمة لضبط BlendMode الخاص بـ Paint بطريقة متوافقة مع الإصدارات القديمة.

بالنسبة إلى android.graphics.Path
infix Path Path.and(p: Path)

تعرِض هذه السمة تقاطع مسارَين على شكل مسار جديد.

Iterable<PathSegment> Path.flatten(error: Float = 0.5f)

تعمل هذه السمة على تسوية (أو تقريب) المسار باستخدام سلسلة من أجزاء الخطوط.

عامل التشغيل المسار Path.minus(p: Path)

تعرض هذه السمة الفرق بين مسارين كـ مسار جديد.

infix Path Path.or(p: Path)

تعرض هذه الدالة اتحاد مسارَين كـ مسار جديد.

عامل التشغيل المسار Path.plus(p: Path)

تعرض هذه الدالة اتحاد مسارَين كـ مسار جديد.

infix Path Path.xor(p: Path)

تعرض هذه السمة اتحاد مسارين مطروحًا منه تقاطعهما كـ مسار جديد.

بالنسبة إلى android.graphics.Picture
صورة Picture.record(width: Int, height: Int, block: Canvas.() -> Unit)

تنشئ هذه الدالة لوحة رسم جديدة لتسجيل الأوامر في هذه الصورة، وتنفّذ الكتلة المحدّدة على لوحة الرسم التي تم إنشاؤها حديثًا، وتعرض هذه الصورة.

بالنسبة إلى android.graphics.Point
عامل التشغيل Int Point.component1()

تعرض هذه السمة الإحداثي x لهذه النقطة.

عامل التشغيل Int Point.component2()

تعرض هذه الدالة الإحداثي y لهذه النقطة.

عامل التشغيل Point Point.minus(p: Point)

تعويض هذه النقطة بنفي النقطة المحدّدة وعرض النتيجة كنقطة جديدة

عامل التشغيل Point Point.minus(xy: Int)

تعويض هذه النقطة بنفي المبلغ المحدّد على المحورين X وY وعرض النتيجة كنقطة جديدة

عامل التشغيل Point Point.plus(p: Point)

تعويض هذه النقطة بالنقطة المحدّدة وعرض النتيجة كنقطة جديدة

عامل التشغيل Point Point.plus(xy: Int)

تعويض هذه النقطة بالمقدار المحدّد على المحورين X وY وعرض النتيجة كنقطة جديدة

PointF Point.toPointF()

تعرض هذه الطريقة تمثيلاً PointF لهذه النقطة.

عامل التشغيل Point Point.unaryMinus()

تعرض هذه الطريقة نقطة جديدة تمثّل نفي هذه النقطة.

بالنسبة إلى android.graphics.PointF
عامل التشغيل Float PointF.component1()

تعرض هذه السمة الإحداثي x لهذه النقطة.

عامل التشغيل Float PointF.component2()

تعرض هذه الدالة الإحداثي y لهذه النقطة.

operator PointF PointF.minus(p: PointF)

تعويض هذه النقطة بنفي النقطة المحدّدة وعرض النتيجة كنقطة جديدة

operator PointF PointF.minus(xy: Float)

تعويض هذه النقطة بنفي المبلغ المحدّد على المحورين X وY وعرض النتيجة كنقطة جديدة

operator PointF PointF.plus(p: PointF)

تعويض هذه النقطة بالنقطة المحدّدة وعرض النتيجة كنقطة جديدة

operator PointF PointF.plus(xy: Float)

تعويض هذه النقطة بالمقدار المحدّد على المحورين X وY وعرض النتيجة كنقطة جديدة

Point PointF.toPoint()

تعرض هذه الدالة تمثيلاً لنقطة.

operator PointF PointF.unaryMinus()

تعرض هذه الطريقة نقطة جديدة تمثّل نفي هذه النقطة.

بالنسبة إلى android.graphics.PorterDuff.Mode
PorterDuffColorFilter Mode.toColorFilter(color: Int)

تنشئ هذه الطريقة PorterDuffColorFilter جديدًا يستخدم PorterDuff.Mode هذا كوضع لتركيب ألفا أو المزج، واللون المحدّد.

PorterDuffXfermode Mode.toXfermode()

تنشئ هذه الطريقة PorterDuffXfermode جديدة تستخدم PorterDuff.Mode هذه كوضع لمزج الألوان أو تركيبها مع قناة ألفا.

بالنسبة إلى android.graphics.Rect
infix Rect Rect.and(r: Rect)

تعرض هذه الدالة تقاطع مستطيلَين كمستطيل جديد.

عامل التشغيل Int Rect.component1()

تعرض هذه السمة "left"، وهو المكوّن الأول للمستطيل.

عامل التشغيل Int Rect.component2()

تعرض هذه الدالة "أعلى"، وهو العنصر الثاني من المستطيل.

عامل التشغيل Int Rect.component3()

تعرض هذه السمة "right"، وهي العنصر الثالث من المستطيل.

عامل التشغيل Int Rect.component4()

تعرض هذه السمة "bottom"، وهو العنصر الرابع من المستطيل.

عامل التشغيل قيمة منطقية Rect.contains(p: Point)

تعرض هذه الدالة القيمة "صحيح" إذا كانت النقطة المحدّدة داخل المستطيل.

operator المنطقة Rect.minus(r: Rect)

تعرض هذه الطريقة الفرق بين هذا المستطيل والمستطيل المحدّد كمنطقة جديدة.

عامل التشغيل Rect Rect.minus(xy: Int)

لعرض مستطيل جديد يمثّل هذا المستطيل مع إزاحة بمقدار سالب للمبلغ المحدّد على المحورين X وY.

عامل التشغيل Rect Rect.minus(xy: Point)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل إزاحة هذا المستطيل بمقدار معكوس النقطة المحدّدة.

infix Rect Rect.or(r: Rect)

تعرض هذه الدالة اتحاد مستطيلَين كمستطيل جديد.

عامل التشغيل Rect Rect.plus(r: Rect)

تُجري هذه الطريقة عملية اتحاد بين هذا المستطيل والمستطيل المحدّد وتعرض النتيجة كمستطيل جديد.

عامل التشغيل Rect Rect.plus(xy: Int)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل هذا المستطيل مع إزاحة بالمقدار المحدّد على المحورين السيني والصادي.

عامل التشغيل Rect Rect.plus(xy: Point)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل هذا المستطيل مع إزاحة بمقدار النقطة المحدّدة.

عامل التشغيل Rect Rect.times(factor: Int)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل مكوّنات هذا المستطيل التي تم تغيير حجم كلّ منها بمقدار العامل.

RectF Rect.toRectF()

تعرض هذه الطريقة تمثيلاً RectF لهذا المستطيل.

المنطقة Rect.toRegion()

تعرض هذه الطريقة تمثيلاً لمنطقة هذا المستطيل.

infix المنطقة Rect.xor(r: Rect)

تعرض هذه الدالة اتحاد مستطيلين مطروحًا منه تقاطعهما كمنطقة جديدة.

بالنسبة إلى android.graphics.RectF
infix RectF RectF.and(r: RectF)

تعرض هذه الدالة تقاطع مستطيلَين كمستطيل جديد.

عامل التشغيل Float RectF.component1()

تعرض هذه السمة "left"، وهو المكوّن الأول للمستطيل.

عامل التشغيل Float RectF.component2()

تعرض هذه الدالة "أعلى"، وهو العنصر الثاني من المستطيل.

عامل التشغيل Float RectF.component3()

تعرض هذه السمة "right"، وهي العنصر الثالث من المستطيل.

عامل التشغيل Float RectF.component4()

تعرض هذه السمة "bottom"، وهو العنصر الرابع من المستطيل.

عامل التشغيل قيمة منطقية RectF.contains(p: PointF)

تعرض هذه الدالة القيمة "صحيح" إذا كانت النقطة المحدّدة داخل المستطيل.

operator المنطقة RectF.minus(r: RectF)

تعرض هذه الطريقة الفرق بين هذا المستطيل والمستطيل المحدّد كمنطقة جديدة.

عامل التشغيل RectF RectF.minus(xy: Float)

لعرض مستطيل جديد يمثّل هذا المستطيل مع إزاحة بمقدار سالب للمبلغ المحدّد على المحورين X وY.

عامل التشغيل RectF RectF.minus(xy: PointF)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل إزاحة هذا المستطيل بمقدار معكوس النقطة المحدّدة.

infix RectF RectF.or(r: RectF)

تعرض هذه الدالة اتحاد مستطيلَين كمستطيل جديد.

عامل التشغيل RectF RectF.plus(r: RectF)

تُجري هذه الطريقة عملية اتحاد بين هذا المستطيل والمستطيل المحدّد وتعرض النتيجة كمستطيل جديد.

عامل التشغيل RectF RectF.plus(xy: Float)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل هذا المستطيل مع إزاحة بالمقدار المحدّد على المحورين السيني والصادي.

عامل التشغيل RectF RectF.plus(xy: PointF)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل هذا المستطيل مع إزاحة بمقدار النقطة المحدّدة.

عامل التشغيل RectF RectF.times(factor: Int)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل مكوّنات هذا المستطيل التي تم تغيير حجم كلّ منها بمقدار العامل.

عامل التشغيل RectF RectF.times(factor: Float)

تعرض هذه الدالة مستطيلاً جديدًا يمثّل مكوّنات هذا المستطيل التي تم تغيير حجم كلّ منها بمقدار العامل.

مستطيل RectF.toRect()

تعرض هذه الطريقة تمثيلاً Rect لهذا المستطيل.

المنطقة RectF.toRegion()

تعرض هذه الطريقة تمثيلاً لمنطقة هذا المستطيل.

RectF RectF.transform(m: Matrix)

تحويل هذا المستطيل في مكانه باستخدام المصفوفة المقدَّمة وعرض هذا المستطيل

infix المنطقة RectF.xor(r: RectF)

تعرض هذه الدالة اتحاد مستطيلين مطروحًا منه تقاطعهما كمنطقة جديدة.

بالنسبة إلى android.graphics.Region
infix المنطقة Region.and(r: Rect)

لعرض تقاطع هذه المنطقة وRect المحدّد كمنطقة جديدة.

infix المنطقة Region.and(r: Region)

لعرض تقاطع هذه المنطقة والمنطقة المحدّدة كمنطقة جديدة.

عامل التشغيل قيمة منطقية Region.contains(p: Point)

عرض القيمة "صحيح" إذا كانت المنطقة تحتوي على Point المحدّدة.

الوحدة Region.forEach(action: (rect: Rect) -> Unit)

ينفّذ الإجراء المحدّد على كل مستطيل في هذه المنطقة.

operator Iterator<Rect> Region.iterator()

تعرض هذه الدالة Iterator على المستطيلات في هذه المنطقة.

operator المنطقة Region.minus(r: Rect)

إرجاع الفرق بين هذه المنطقة وRect المحدّد كمنطقة جديدة

operator المنطقة Region.minus(r: Region)

لعرض الفرق بين هذه المنطقة والمنطقة المحدّدة كمنطقة جديدة.

operator المنطقة Region.not()

تعرض هذه الدالة نفي هذه المنطقة كمنطقة جديدة.

infix المنطقة Region.or(r: Rect)

لعرض اتحاد هذه المنطقة وRect المحدّد كمنطقة جديدة.

infix المنطقة Region.or(r: Region)

لعرض اتحاد هذه المنطقة والمنطقة المحدّدة كمنطقة جديدة.

operator المنطقة Region.plus(r: Rect)

لعرض اتحاد هذه المنطقة وRect المحدّد كمنطقة جديدة.

operator المنطقة Region.plus(r: Region)

لعرض اتحاد هذه المنطقة والمنطقة المحدّدة كمنطقة جديدة.

operator المنطقة Region.unaryMinus()

تعرض هذه الدالة نفي هذه المنطقة كمنطقة جديدة.

infix المنطقة Region.xor(r: Rect)

عرض الاتحاد ناقص التقاطع بين هذه المنطقة وRect المحدّد كمنطقة جديدة

infix المنطقة Region.xor(r: Region)

عرض اتحاد هذه المنطقة والمنطقة المحدّدة مطروحًا منهما التقاطع بينهما كمنطقة جديدة

بالنسبة إلى android.graphics.Shader
الوحدة Shader.transform(block: Matrix.() -> Unit)

لفّ الكتلة المحدّدة في استدعاءات Shader.getLocalMatrix وShader.setLocalMatrix.

بالنسبة إلى kotlin.Int
عامل التشغيل Int Int.component1()

عرض مكوّن ألفا لعدد صحيح يمثّل لونًا

عامل التشغيل Int Int.component2()

لعرض مكوّن اللون الأحمر في عدد صحيح للون.

عامل التشغيل Int Int.component3()

لعرض مكوّن اللون الأخضر لعدد صحيح يمثّل لونًا

عامل التشغيل Int Int.component4()

لعرض مكوّن اللون الأزرق لعدد صحيح يمثّل لونًا

infix Long Int.convertTo(colorSpace: Named)

تحويل متلقّي عدد صحيح للون إلى لون طويل في مساحة الألوان المحدّدة

infix Long Int.convertTo(colorSpace: ColorSpace)

تحويل متلقّي عدد صحيح للون إلى لون طويل في مساحة الألوان المحدّدة

اللون Int.toColor()

تُنشئ هذه الدالة مثيلاً جديدًا من Color من عدد صحيح للون.

Long Int.toColorLong()

تحويل عدد صحيح للون ARGB المحدّد إلى عدد صحيح طويل للون RGBA في مساحة الألوان sRGB

بالنسبة إلى kotlin.Long
عامل التشغيل Float Long.component1()

تعرض هذه السمة المكوّن الأول للّون.

عامل التشغيل Float Long.component2()

تعرض هذه السمة المكوّن الثاني من اللون.

عامل التشغيل Float Long.component3()

تعرض هذه السمة المكوّن الثالث للّون.

عامل التشغيل Float Long.component4()

تعرض هذه السمة المكوّن الرابع للّون.

infix Long Long.convertTo(colorSpace: Named)

تحويل جهاز استقبال الألوان الطويلة إلى لون طويل في مساحة الألوان المحدّدة

infix Long Long.convertTo(colorSpace: ColorSpace)

تحويل جهاز استقبال الألوان الطويلة إلى لون طويل في مساحة الألوان المحدّدة

اللون Long.toColor()

تنشئ هذه الدالة مثيلاً جديدًا من Color من color long.

Int Long.toColorInt()

تحويل اللون الطويل المحدّد إلى عدد صحيح للون بتنسيق ARGB

بالنسبة إلى kotlin.String
Int String.toColorInt()

لعرض لون Int مطابق لهذا String.

سمات الإضافة

بالنسبة إلى kotlin.Int
Int Int.alpha()

عرض مكوّن ألفا لعدد صحيح يمثّل لونًا

Int Int.blue()

لعرض مكوّن اللون الأزرق لعدد صحيح يمثّل لونًا

Int Int.green()

لعرض مكوّن اللون الأخضر لعدد صحيح يمثّل لونًا

Float Int.luminance()

تعرض هذه الدالة درجة الإضاءة النسبية لعدد صحيح يمثّل لونًا، على افتراض ترميز sRGB.

Int Int.red()

لعرض مكوّن اللون الأحمر في عدد صحيح للون.

بالنسبة إلى kotlin.Long
Float Long.alpha()

لعرض مكوّن ألفا للون طويل.

Float Long.blue()

عرض مكوّن اللون الأزرق من قيمة لون طويلة

ColorSpace Long.colorSpace()

تعرض مساحة الألوان المشفرة في عدد صحيح طويل للألوان المحدّد.

Float Long.green()

لعرض مكوّن اللون الأخضر من قيمة اللون الطويلة.

Boolean Long.isSrgb()

تشير إلى ما إذا كان اللون ضمن مساحة الألوان sRGB.

Boolean Long.isWideGamut()

تشير هذه السمة إلى ما إذا كان اللون في مساحة ألوان ذات نطاق واسع.

Float Long.luminance()

تعرض هذه الدالة درجة الإضاءة النسبية للون.

Float Long.red()

عرض مكوّن اللون الأحمر من عدد صحيح طويل.

الدوال ذات المستوى الأعلى

Bitmap createBitmap(width: Int, height: Int, config: Config = Bitmap.Config.ARGB_8888)

تعرض هذه السمة خريطة بتة قابلة للتغيير مع العرض والارتفاع المحدّدين.

Bitmap createBitmap(width: Int, height: Int, config: Config = Bitmap.Config.ARGB_8888, hasAlpha: Boolean = true, colorSpace: ColorSpace = ColorSpace.get(ColorSpace.Named.SRGB))

تعرض هذه السمة خريطة بتة قابلة للتغيير مع العرض والارتفاع المحدّدين.

المصفوفة rotationMatrix(degrees: Float, px: Float = 0.0f, py: Float = 0.0f)

تنشئ هذه السمة مصفوفة دوران، يتم تحديدها بزاوية دوران بالدرجات حول نقطة المحور التي تقع عند الإحداثيات (px, py).

المصفوفة scaleMatrix(sx: Float = 1.0f, sy: Float = 1.0f)

تُنشئ مصفوفة مقياس مع عامل المقياس sx وsy على المحورين x وy على التوالي.

المصفوفة translationMatrix(tx: Float = 0.0f, ty: Float = 0.0f)

تُنشئ مصفوفة ترجمة تحتوي على مقادير الترجمة tx وty على المحورَين x وy على التوالي.

androidx.core.graphics.drawable

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.graphics.Bitmap
الرمز Bitmap.toAdaptiveIcon()

أنشئ رمزًا من الصورة النقطية التكيّفية هذه.

BitmapDrawable Bitmap.toDrawable(resources: Resources)

إنشاء BitmapDrawable من Bitmap هذا

الرمز Bitmap.toIcon()

أنشئ رمزًا من الصورة النقطية هذه.

بالنسبة إلى android.graphics.Color
ColorDrawable Color.toDrawable()

إنشاء ColorDrawable من هذا اللون (عبر Color.toArgb)

بالنسبة إلى android.graphics.drawable.Drawable
Bitmap Drawable.toBitmap(@Px width: Int = intrinsicWidth, @Px height: Int = intrinsicHeight, config: Config? = null)

لعرض تمثيل Bitmap لهذا العنصر Drawable.

الوحدة Drawable.updateBounds(@Px left: Int = bounds.left, @Px top: Int = bounds.top, @Px right: Int = bounds.right, @Px bottom: Int = bounds.bottom)

تعدّل هذه الطريقة حدود العنصر القابل للرسم.

بالنسبة إلى android.net.Uri
الرمز Uri.toIcon()

إنشاء رمز من معرّف الموارد المنتظم (URI) هذا

بالنسبة إلى kotlin.ByteArray
الرمز ByteArray.toIcon()

إنشاء رمز من ByteArray هذا

بالنسبة إلى kotlin.Int
ColorDrawable Int.toDrawable()

أنشئ ColorDrawable من قيمة اللون هذه.

androidx.core.location

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.location.Location
عامل التشغيل Double Location.component1()

تعرض هذه السمة خط العرض للموقع الجغرافي.

عامل التشغيل Double Location.component2()

تعرض هذه السمة خط الطول للموقع الجغرافي.

androidx.core.net

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.net.Uri
ملف Uri.toFile()

تُنشئ هذه الطريقة ملفًا من معرّف الموارد المنتظم (URI) المحدّد.

بالنسبة إلى java.io.File
Uri File.toUri()

تنشئ هذه الدالة معرّف الموارد المنتظم (URI) من الملف المحدّد.

بالنسبة إلى kotlin.String
Uri String.toUri()

تنشئ هذه الدالة كائن Uri من سلسلة URI المرمّزة المحدّدة.

androidx.core.os

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.os.Handler
Runnable Handler.postAtTime(uptimeMillis: Long, token: Any? = null, crossinline action: () -> Unit)

إصدار Handler.postAtTime الذي يعيد ترتيب المَعلمات، ما يسمح بوضع الإجراء خارج الأقواس.

Runnable Handler.postDelayed(delayInMillis: Long, token: Any? = null, crossinline action: () -> Unit)

إصدار Handler.postDelayed الذي يعيد ترتيب المَعلمات، ما يسمح بوضع الإجراء خارج الأقواس.

الدوال ذات المستوى الأعلى

حزمة bundleOf(vararg pairs: Pair<String, Any?>)

تعرض هذه الدالة حزمة جديدة تحتوي على أزواج المفتاح/القيمة المحدّدة كعناصر.

PersistableBundle persistableBundleOf(vararg pairs: Pair<String, Any?>)

تعرض هذه الدالة PersistableBundle جديدًا يتضمّن أزواج المفتاح/القيمة المحدّدة كعناصر.

T trace(sectionName: String, block: () -> T)

لفّ الكتلة المحدّدة في استدعاءات Trace.beginSection (مع sectionName المقدَّم) وTrace.endSection.

androidx.core.text

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.text.Spannable
الوحدة Spannable.clearSpans()

محو جميع الفواصل من هذا النص

عامل التشغيل الوحدة Spannable.set(start: Int, end: Int, span: Any)

أضِف span إلى النطاق start&hellip;end من النص.

عامل التشغيل الوحدة Spannable.set(range: IntRange, span: Any)

أضِف span إلى النطاق الخاص بالنص.

بالنسبة إلى android.text.SpannableStringBuilder
SpannableStringBuilder SpannableStringBuilder.backgroundColor(color: Int, builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن BackgroundColorSpan

SpannableStringBuilder SpannableStringBuilder.bold(builderAction: SpannableStringBuilder.() -> Unit)

يجب تضمين النص الملحق في builderAction بنمط StyleSpan غامق.

SpannableStringBuilder SpannableStringBuilder.color(color: Int, builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن ForegroundColorSpan

SpannableStringBuilder SpannableStringBuilder.inSpans(vararg spans: Any, builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن spans

SpannableStringBuilder SpannableStringBuilder.inSpans(span: Any, builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن span

SpannableStringBuilder SpannableStringBuilder.italic(builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction في StyleSpan مائل.

SpannableStringBuilder SpannableStringBuilder.scale(proportion: Float, builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن RelativeSizeSpan

SpannableStringBuilder SpannableStringBuilder.strikeThrough(builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن StrikethroughSpan

SpannableStringBuilder SpannableStringBuilder.subscript(builderAction: SpannableStringBuilder.() -> Unit)

لف النص الملحق في builderAction ضمن SubscriptSpan.

SpannableStringBuilder SpannableStringBuilder.superscript(builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن SuperscriptSpan.

SpannableStringBuilder SpannableStringBuilder.underline(builderAction: SpannableStringBuilder.() -> Unit)

لفّ النص الملحق في builderAction ضمن UnderlineSpan

بالنسبة إلى android.text.Spanned
Array<out T> Spanned.getSpans(start: Int = 0, end: Int = length)

الحصول على جميع الفترات الزمنية التي تمثّل مثيلاً من T

String Spanned.toHtml(option: Int = TO_HTML_PARAGRAPH_LINES_CONSECUTIVE)

تعرض هذه الدالة سلسلة HTML من النطاقات في Spanned.

بالنسبة إلى kotlin.CharSequence
Boolean CharSequence.isDigitsOnly()

تعرض هذه الدالة ما إذا كان CharSequence المحدّد يحتوي على أرقام فقط.

Spannable CharSequence.toSpannable()

تعرض هذه الدالة Spannable جديدًا من CharSequence، أو المصدر نفسه إذا كان مثيلاً من SpannableString.

ممتدّة CharSequence.toSpanned()

تعرض هذه الدالة Spanned جديدًا من CharSequence، أو المصدر نفسه إذا كان مثيلاً من SpannedString.

Int CharSequence.trimmedLength()

تعرض هذه الدالة الطول الذي سيكون عليه CharSequence المحدّد إذا تم حذف المسافات وأحرف التحكّم في ASCII من البداية والنهاية، كما هو الحال في String.trim.

بالنسبة إلى kotlin.String
String String.htmlEncode()

يجب ترميز السلسلة باستخدام HTML.

ممتدّة String.parseAsHtml(flags: Int = FROM_HTML_MODE_LEGACY, imageGetter: ImageGetter? = null, tagHandler: TagHandler? = null)

تعرض هذه الدالة Spanned من تحليل هذه السلسلة بتنسيق HTML.

سمات الإضافة

بالنسبة إلى java.util.Locale
Int Locale.layoutDirection()

تعرض هذه السمة اتجاه التنسيق للغة معيّنة.

الدوال ذات المستوى الأعلى

SpannedString buildSpannedString(builderAction: SpannableStringBuilder.() -> Unit)

تنشئ هذه الدالة سلسلة جديدة من خلال ملء SpannableStringBuilder تم إنشاؤها حديثًا باستخدام builderAction المقدَّمة، ثم تحويلها إلى SpannedString.

androidx.core.transition

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.transition.Transition
TransitionListener Transition.addListener(crossinline onEnd: (transition: Transition) -> Unit = {}, crossinline onStart: (transition: Transition) -> Unit = {}, crossinline onCancel: (transition: Transition) -> Unit = {}, crossinline onResume: (transition: Transition) -> Unit = {}, crossinline onPause: (transition: Transition) -> Unit = {})

أضِف أداة معالجة إلى هذا الانتقال باستخدام الإجراءات المتوفّرة.

TransitionListener Transition.doOnCancel(crossinline action: (transition: Transition) -> Unit)

أضِف إجراءً سيتم تنفيذه عند إلغاء هذا الانتقال.

TransitionListener Transition.doOnEnd(crossinline action: (transition: Transition) -> Unit)

أضِف إجراءً سيتم تنفيذه عند انتهاء عملية الانتقال هذه.

TransitionListener Transition.doOnPause(crossinline action: (transition: Transition) -> Unit)

أضِف إجراءً سيتم تنفيذه عند إيقاف هذا الانتقال مؤقتًا.

TransitionListener Transition.doOnResume(crossinline action: (transition: Transition) -> Unit)

أضِف إجراءً سيتم تنفيذه عند استئناف هذا الانتقال بعد توقّف مؤقت.

TransitionListener Transition.doOnStart(crossinline action: (transition: Transition) -> Unit)

أضِف إجراءً سيتم تنفيذه عند بدء عملية الانتقال هذه.

androidx.core.util

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.util.AtomicFile
ByteArray AtomicFile.readBytes()

تعرض هذه الطريقة محتوى هذا الملف بالكامل على شكل مصفوفة بايت.

String AtomicFile.readText(charset: Charset = Charsets.UTF_8)

تعرض هذه الطريقة المحتوى الكامل لهذا الملف كسلسلة باستخدام UTF-8 أو charset المحدّد.

الوحدة AtomicFile.tryWrite(block: (out: FileOutputStream) -> Unit)

نفِّذ عمليات الكتابة داخل block على هذا الملف.

الوحدة AtomicFile.writeBytes(array: ByteArray)

تضبط هذه السمة محتوى هذا الملف على أنّه مصفوفة من وحدات البايت.

الوحدة AtomicFile.writeText(text: String, charset: Charset = Charsets.UTF_8)

تضبط هذه السمة محتوى هذا الملف على نص بترميز UTF-8 أو مجموعة الأحرف المحدّدة.

بالنسبة إلى android.util.LongSparseArray
عامل التشغيل قيمة منطقية LongSparseArray<T>.contains(key: Long)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean LongSparseArray<T>.containsKey(key: Long)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean LongSparseArray<T>.containsValue(value: T)

تعرض القيمة "صحيح" إذا كانت المجموعة تحتوي على value.

الوحدة LongSparseArray<T>.forEach(action: (key: Long, value: T) -> Unit)

ينفّذ الإجراء المحدّد لكل إدخال مفتاح/قيمة.

T LongSparseArray<T>.getOrDefault(key: Long, defaultValue: T)

لعرض القيمة المقابلة للمفتاح، أو defaultValue في حال عدم توفّره.

T LongSparseArray<T>.getOrElse(key: Long, defaultValue: () -> T)

تعرض هذه الدالة القيمة المقابلة للمفتاح، أو من defaultValue عندما لا يكون المفتاح متوفّرًا.

Boolean LongSparseArray<T>.isEmpty()

عرض القيمة "صحيح" عندما لا تحتوي المجموعة على عناصر

Boolean LongSparseArray<T>.isNotEmpty()

عرض القيمة "صحيح" عندما تحتوي المجموعة على عناصر

LongIterator LongSparseArray<T>.keyIterator()

لعرض مكرّر على مفاتيح المجموعة.

operator LongSparseArray<T> LongSparseArray<T>.plus(other: LongSparseArray<T>)

تنشئ هذه السمة مجموعة جديدة من خلال إضافة إدخالات من غير ذلك أو استبدالها.

الوحدة LongSparseArray<T>.putAll(other: LongSparseArray<T>)

عدِّل هذه المجموعة عن طريق إضافة إدخالات من غير ذلك أو استبدال الإدخالات الحالية بإدخالات من غير ذلك.

Boolean LongSparseArray<T>.remove(key: Long, value: T)

تزيل هذه الدالة الإدخال الخاص بالمفتاح فقط إذا كان مرتبطًا بالقيمة.

عامل التشغيل الوحدة LongSparseArray<T>.set(key: Long, value: T)

يسمح باستخدام عامل الفهرس لتخزين القيم في المجموعة.

Iterator<T> LongSparseArray<T>.valueIterator()

لعرض مكرّر على قيم المجموعة.

بالنسبة إلى android.util.Pair
عامل التشغيل F Pair<F, S>.component1()

تعرِض المكوّن الأول من الزوج.

عامل التشغيل S Pair<F, S>.component2()

تعرض هذه الدالة المكوّن الثاني من الزوج.

Pair< F, S> Pair<F, S>.toKotlinPair()

تعرض هذه الدالة Pair كـ kotlin.Pair.

بالنسبة إلى android.util.Range
infix Range<T> Range<T>.and(other: Range<T>)

تعرِض هذه الدالة التقاطع بين هذا النطاق وغيره.

عامل التشغيل Range<T> Range<T>.plus(value: T)

عرض أصغر نطاق يتضمّن هذا النطاق والقيمة

عامل التشغيل Range<T> Range<T>.plus(other: Range<T>)

عرض أصغر نطاق يتضمّن هذا وغيره

ClosedRange<T> Range<T>.toClosedRange()

تعرض هذه الدالة Range كـ ClosedRange.

بالنسبة إلى android.util.Size
عامل التشغيل Int Size.component1()

تعرض هذه السمة "width"، وهي المكوّن الأول من Size.

عامل التشغيل Int Size.component2()

تعرض هذه السمة "الارتفاع"، وهو العنصر الثاني من الحجم.

بالنسبة إلى android.util.SizeF
عامل التشغيل Float SizeF.component1()

تعرض هذه السمة "width"، وهي المكوّن الأول من SizeF.

عامل التشغيل Float SizeF.component2()

تعرِض هذه الدالة "height"، وهي المكوّن الثاني من SizeF.

بالنسبة إلى android.util.SparseArray
عامل التشغيل قيمة منطقية SparseArray<T>.contains(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseArray<T>.containsKey(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseArray<T>.containsValue(value: T)

تعرض القيمة "صحيح" إذا كانت المجموعة تحتوي على value.

الوحدة SparseArray<T>.forEach(action: (key: Int, value: T) -> Unit)

ينفّذ الإجراء المحدّد لكل إدخال مفتاح/قيمة.

T SparseArray<T>.getOrDefault(key: Int, defaultValue: T)

لعرض القيمة المقابلة للمفتاح، أو defaultValue في حال عدم توفّره.

T SparseArray<T>.getOrElse(key: Int, defaultValue: () -> T)

تعرض هذه الدالة القيمة المقابلة للمفتاح، أو من defaultValue عندما لا يكون المفتاح متوفّرًا.

Boolean SparseArray<T>.isEmpty()

عرض القيمة "صحيح" عندما لا تحتوي المجموعة على عناصر

Boolean SparseArray<T>.isNotEmpty()

عرض القيمة "صحيح" عندما تحتوي المجموعة على عناصر

IntIterator SparseArray<T>.keyIterator()

لعرض مكرّر على مفاتيح المجموعة.

عامل التشغيل SparseArray<T> SparseArray<T>.plus(other: SparseArray<T>)

تنشئ هذه السمة مجموعة جديدة من خلال إضافة إدخالات من غير ذلك أو استبدالها.

الوحدة SparseArray<T>.putAll(other: SparseArray<T>)

عدِّل هذه المجموعة عن طريق إضافة إدخالات من غير ذلك أو استبدال الإدخالات الحالية بإدخالات من غير ذلك.

Boolean SparseArray<T>.remove(key: Int, value: T)

تزيل هذه الدالة الإدخال الخاص بالمفتاح فقط إذا كان مرتبطًا بالقيمة.

عامل التشغيل الوحدة SparseArray<T>.set(key: Int, value: T)

يسمح باستخدام عامل الفهرس لتخزين القيم في المجموعة.

Iterator<T> SparseArray<T>.valueIterator()

لعرض مكرّر على قيم المجموعة.

بالنسبة إلى android.util.SparseBooleanArray
عامل التشغيل قيمة منطقية SparseBooleanArray.contains(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseBooleanArray.containsKey(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseBooleanArray.containsValue(value: Boolean)

تعرض القيمة "صحيح" إذا كانت المجموعة تحتوي على value.

الوحدة SparseBooleanArray.forEach(action: (key: Int, value: Boolean) -> Unit)

ينفّذ الإجراء المحدّد لكل إدخال مفتاح/قيمة.

Boolean SparseBooleanArray.getOrDefault(key: Int, defaultValue: Boolean)

لعرض القيمة المقابلة للمفتاح، أو defaultValue في حال عدم توفّره.

Boolean SparseBooleanArray.getOrElse(key: Int, defaultValue: () -> Boolean)

تعرض هذه الدالة القيمة المقابلة للمفتاح، أو من defaultValue عندما لا يكون المفتاح متوفّرًا.

Boolean SparseBooleanArray.isEmpty()

عرض القيمة "صحيح" عندما لا تحتوي المجموعة على عناصر

Boolean SparseBooleanArray.isNotEmpty()

عرض القيمة "صحيح" عندما تحتوي المجموعة على عناصر

IntIterator SparseBooleanArray.keyIterator()

لعرض مكرّر على مفاتيح المجموعة.

operator SparseBooleanArray SparseBooleanArray.plus(other: SparseBooleanArray)

تنشئ هذه السمة مجموعة جديدة من خلال إضافة إدخالات من غير ذلك أو استبدالها.

الوحدة SparseBooleanArray.putAll(other: SparseBooleanArray)

عدِّل هذه المجموعة عن طريق إضافة إدخالات من غير ذلك أو استبدال الإدخالات الحالية بإدخالات من غير ذلك.

Boolean SparseBooleanArray.remove(key: Int, value: Boolean)

تزيل هذه الدالة الإدخال الخاص بالمفتاح فقط إذا كان مرتبطًا بالقيمة.

عامل التشغيل الوحدة SparseBooleanArray.set(key: Int, value: Boolean)

يسمح باستخدام عامل الفهرس لتخزين القيم في المجموعة.

BooleanIterator SparseBooleanArray.valueIterator()

لعرض مكرّر على قيم المجموعة.

بالنسبة إلى android.util.SparseIntArray
عامل التشغيل قيمة منطقية SparseIntArray.contains(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseIntArray.containsKey(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseIntArray.containsValue(value: Int)

تعرض القيمة "صحيح" إذا كانت المجموعة تحتوي على value.

الوحدة SparseIntArray.forEach(action: (key: Int, value: Int) -> Unit)

ينفّذ الإجراء المحدّد لكل إدخال مفتاح/قيمة.

Int SparseIntArray.getOrDefault(key: Int, defaultValue: Int)

لعرض القيمة المقابلة للمفتاح، أو defaultValue في حال عدم توفّره.

Int SparseIntArray.getOrElse(key: Int, defaultValue: () -> Int)

تعرض هذه الدالة القيمة المقابلة للمفتاح، أو من defaultValue عندما لا يكون المفتاح متوفّرًا.

Boolean SparseIntArray.isEmpty()

عرض القيمة "صحيح" عندما لا تحتوي المجموعة على عناصر

Boolean SparseIntArray.isNotEmpty()

عرض القيمة "صحيح" عندما تحتوي المجموعة على عناصر

IntIterator SparseIntArray.keyIterator()

لعرض مكرّر على مفاتيح المجموعة.

عامل التشغيل SparseIntArray SparseIntArray.plus(other: SparseIntArray)

تنشئ هذه السمة مجموعة جديدة من خلال إضافة إدخالات من غير ذلك أو استبدالها.

الوحدة SparseIntArray.putAll(other: SparseIntArray)

عدِّل هذه المجموعة عن طريق إضافة إدخالات من غير ذلك أو استبدال الإدخالات الحالية بإدخالات من غير ذلك.

Boolean SparseIntArray.remove(key: Int, value: Int)

تزيل هذه الدالة الإدخال الخاص بالمفتاح فقط إذا كان مرتبطًا بالقيمة.

عامل التشغيل الوحدة SparseIntArray.set(key: Int, value: Int)

يسمح باستخدام عامل الفهرس لتخزين القيم في المجموعة.

IntIterator SparseIntArray.valueIterator()

لعرض مكرّر على قيم المجموعة.

بالنسبة إلى android.util.SparseLongArray
عامل التشغيل قيمة منطقية SparseLongArray.contains(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseLongArray.containsKey(key: Int)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت المجموعة تحتوي على key.

Boolean SparseLongArray.containsValue(value: Long)

تعرض القيمة "صحيح" إذا كانت المجموعة تحتوي على value.

الوحدة SparseLongArray.forEach(action: (key: Int, value: Long) -> Unit)

ينفّذ الإجراء المحدّد لكل إدخال مفتاح/قيمة.

Long SparseLongArray.getOrDefault(key: Int, defaultValue: Long)

لعرض القيمة المقابلة للمفتاح، أو defaultValue في حال عدم توفّره.

Long SparseLongArray.getOrElse(key: Int, defaultValue: () -> Long)

تعرض هذه الدالة القيمة المقابلة للمفتاح، أو من defaultValue عندما لا يكون المفتاح متوفّرًا.

Boolean SparseLongArray.isEmpty()

عرض القيمة "صحيح" عندما لا تحتوي المجموعة على عناصر

Boolean SparseLongArray.isNotEmpty()

عرض القيمة "صحيح" عندما تحتوي المجموعة على عناصر

IntIterator SparseLongArray.keyIterator()

لعرض مكرّر على مفاتيح المجموعة.

operator SparseLongArray SparseLongArray.plus(other: SparseLongArray)

تنشئ هذه السمة مجموعة جديدة من خلال إضافة إدخالات من غير ذلك أو استبدالها.

الوحدة SparseLongArray.putAll(other: SparseLongArray)

عدِّل هذه المجموعة عن طريق إضافة إدخالات من غير ذلك أو استبدال الإدخالات الحالية بإدخالات من غير ذلك.

Boolean SparseLongArray.remove(key: Int, value: Long)

تتم إزالة الإدخال الخاص بـ key فقط إذا تم ضبطه على value.

عامل التشغيل الوحدة SparseLongArray.set(key: Int, value: Long)

يسمح باستخدام عامل الفهرس لتخزين القيم في المجموعة.

LongIterator SparseLongArray.valueIterator()

لعرض مكرّر على قيم المجموعة.

بالنسبة إلى kotlin.Double
النصف Double.toHalf()

تعرض هذه الدالة مثيلاً من Half يمثّل قيمة Double معيّنة.

بالنسبة إلى kotlin.Float
النصف Float.toHalf()

تعرض هذه الدالة مثيلاً من النوع Half يمثّل قيمة Float المحدّدة.

بالنسبة إلى kotlin.Pair
Pair< F, S> Pair<F, S>.toAndroidPair()

تعرض هذه الدالة kotlin.Pair كـ Pair في Android.

بالنسبة إلى kotlin.Short
النصف Short.toHalf()

تعرض هذه الدالة مثيلاً من النوع Half يمثّل قيمة Short المحدّدة.

بالنسبة إلى kotlin.String
النصف String.toHalf()

تعرِض هذه الدالة مثيلاً من النوع Half يمثّل String المحدّد.

بالنسبة إلى kotlin.ranges.ClosedRange
Range<T> ClosedRange<T>.toRange()

تعرض هذه الدالة ClosedRange كـ Range.

سمات الإضافة

بالنسبة إلى android.util.LongSparseArray
Int LongSparseArray<T>.size()

تعرض هذه الدالة عدد أزواج المفتاح/القيمة في المجموعة.

بالنسبة إلى android.util.SparseArray
Int SparseArray<T>.size()

تعرض هذه الدالة عدد أزواج المفتاح/القيمة في المجموعة.

بالنسبة إلى android.util.SparseBooleanArray
Int SparseBooleanArray.size()

تعرض هذه الدالة عدد أزواج المفتاح/القيمة في المجموعة.

بالنسبة إلى android.util.SparseIntArray
Int SparseIntArray.size()

تعرض هذه الدالة عدد أزواج المفتاح/القيمة في المجموعة.

بالنسبة إلى android.util.SparseLongArray
Int SparseLongArray.size()

تعرِض هذه الدالة عدد إدخالات المفتاح/القيمة في المجموعة.

الدوال ذات المستوى الأعلى

LruCache< K, V> lruCache(maxSize: Int, crossinline sizeOf: (key: K, value: V) -> Int = { _, _ -> 1 }, crossinline create: (key: K) -> V? = { null as V? }, crossinline onEntryRemoved: (evicted: Boolean, key: K, oldValue: V, newValue: V?) -> Unit = { _, _, _, _ -> })

تنشئ هذه الدالة LruCache مع المَعلمات المحدّدة.

infix Range<T> T.rangeTo(that: T)

تُنشئ هذه الدالة نطاقًا من قيمة Comparable إلى تلك.

androidx.core.view

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.view.Menu
عامل التشغيل قيمة منطقية Menu.contains(item: MenuItem)

تعرض القيمة true إذا تم العثور على item في هذه القائمة.

الوحدة Menu.forEach(action: (item: MenuItem) -> Unit)

ينفّذ الإجراء المحدّد على كل عنصر في هذه القائمة.

الوحدة Menu.forEachIndexed(action: (index: Int, item: MenuItem) -> Unit)

ينفّذ الإجراء المحدّد على كل عنصر في هذه القائمة، مع توفير الفهرس التسلسلي الخاص به.

operator MenuItem Menu.get(index: Int)

تعرض هذه الدالة القائمة في الفهرس.

Boolean Menu.isEmpty()

تعرض هذه السمة القيمة "صحيح" إذا كانت هذه القائمة لا تحتوي على أي عناصر.

Boolean Menu.isNotEmpty()

تعرض القيمة "صحيح" إذا كانت هذه القائمة تحتوي على عنصر واحد أو أكثر.

operator MutableIterator<MenuItem> Menu.iterator()

تعرض هذه الدالة MutableIterator على العناصر في هذه القائمة.

عامل التشغيل الوحدة Menu.minusAssign(item: MenuItem)

تزيل هذه السمة العنصر من هذه القائمة.

بالنسبة إلى android.view.View
الوحدة View.doOnAttach(crossinline action: (view: View) -> Unit)

ينفّذ الإجراء المحدّد عند ربط طريقة العرض هذه بإطار.

الوحدة View.doOnDetach(crossinline action: (view: View) -> Unit)

تنفِّذ هذه السمة الإجراء المحدّد عندما يتم فصل طريقة العرض هذه عن النافذة.

الوحدة View.doOnLayout(crossinline action: (view: View) -> Unit)

ينفّذ الإجراء المحدّد عند تخطيط طريقة العرض هذه.

الوحدة View.doOnNextLayout(crossinline action: (view: View) -> Unit)

ينفِّذ الإجراء المحدّد عندما يتم تخطيط طريقة العرض هذه في المرة التالية.

OneShotPreDrawListener View.doOnPreDraw(crossinline action: (view: View) -> Unit)

ينفّذ الإجراء المحدّد عندما تكون شجرة العرض على وشك الرسم.

Bitmap View.drawToBitmap(config: Config = Bitmap.Config.ARGB_8888)

عرض تمثيل Bitmap لهذا View

Runnable View.postDelayed(delayInMillis: Long, crossinline action: () -> Unit)

إصدار من View.postDelayed يعيد ترتيب المَعلمات، ما يسمح بوضع الإجراء خارج الأقواس.

Runnable View.postOnAnimationDelayed(delayInMillis: Long, crossinline action: () -> Unit)

إصدار View.postOnAnimationDelayed الذي يعيد ترتيب المَعلمات، ما يسمح بوضع الإجراء خارج الأقواس.

الوحدة View.setPadding(@Px size: Int)

تضبط هذه السمة المساحة المتروكة للعرض.

الوحدة View.updateLayoutParams(block: LayoutParams.() -> Unit)

ينفّذ block باستخدام layoutParams الخاص بـ View ويعيد تعيين layoutParams باستخدام الإصدار المعدَّل.

الوحدة View.updateLayoutParams(block: T.() -> Unit)

ينفّذ block مع نسخة مكتوبة من layoutParams الخاصة بـ View ويعيد تعيين layoutParams باستخدام النسخة المعدَّلة.

الوحدة View.updatePadding(@Px left: Int = paddingLeft, @Px top: Int = paddingTop, @Px right: Int = paddingRight, @Px bottom: Int = paddingBottom)

تعدّل هذه السمة مساحة العرض المتروكة.

الوحدة View.updatePaddingRelative(@Px start: Int = paddingStart, @Px top: Int = paddingTop, @Px end: Int = paddingEnd, @Px bottom: Int = paddingBottom)

تعدّل هذه السمة الحشو النسبي لطريقة العرض هذه.

بالنسبة إلى android.view.ViewGroup
عامل التشغيل قيمة منطقية ViewGroup.contains(view: View)

تعرِض true إذا تم العثور على view في مجموعة العرض هذه.

الوحدة ViewGroup.forEach(action: (view: View) -> Unit)

ينفّذ الإجراء المحدّد على كل طريقة عرض في مجموعة طرق العرض هذه.

الوحدة ViewGroup.forEachIndexed(action: (index: Int, view: View) -> Unit)

تنفِّذ هذه الطريقة الإجراء المحدّد على كل طريقة عرض في مجموعة طرق العرض هذه، مع توفير الفهرس التسلسلي الخاص بها.

عامل التشغيل عرض ViewGroup.get(index: Int)

تعرض هذه الطريقة طريقة العرض في الفهرس.

Boolean ViewGroup.isEmpty()

تعرِض القيمة "صحيح" إذا كانت مجموعة طرق العرض هذه لا تحتوي على أي طرق عرض.

Boolean ViewGroup.isNotEmpty()

تعرِض القيمة "صحيح" إذا كانت مجموعة طرق العرض هذه تحتوي على طريقة عرض واحدة أو أكثر.

operator MutableIterator<View> ViewGroup.iterator()

تعرض هذه الدالة MutableIterator على طرق العرض في مجموعة طرق العرض هذه.

عامل التشغيل الوحدة ViewGroup.minusAssign(view: View)

يزيل العرض من مجموعة العرض هذه.

عامل التشغيل الوحدة ViewGroup.plusAssign(view: View)

تضيف هذه السمة طريقة عرض إلى مجموعة طرق العرض هذه.

بالنسبة إلى android.view.ViewGroup.MarginLayoutParams
الوحدة MarginLayoutParams.setMargins(@Px size: Int)

تضبط هذه السمة الهوامش في MarginLayoutParams الخاصة بـ ViewGroup.

الوحدة MarginLayoutParams.updateMargins(@Px left: Int = leftMargin, @Px top: Int = topMargin, @Px right: Int = rightMargin, @Px bottom: Int = bottomMargin)

تعدِّل هذه السمة الهوامش في ViewGroup ضمن ViewGroup.MarginLayoutParams.

الوحدة MarginLayoutParams.updateMarginsRelative(@Px start: Int = marginStart, @Px top: Int = topMargin, @Px end: Int = marginEnd, @Px bottom: Int = bottomMargin)

تعدّل هذه السمة الهوامش النسبية في MarginLayoutParams الخاصة بـ ViewGroup.

سمات الإضافة

بالنسبة إلى android.view.Menu
Sequence<MenuItem> Menu.children()

تعرض هذه السمة تسلسلاً للعناصر في هذه القائمة.

Int Menu.size()

تعرض هذه السمة عدد العناصر في هذه القائمة.

بالنسبة إلى android.view.View
Boolean View.isGone()

تعرض القيمة "صحيح" عندما تكون إمكانية رؤية طريقة العرض هذه هي View.GONE، وتعرض القيمة "خطأ" في الحالات الأخرى.

Boolean View.isInvisible()

تعرض القيمة "صحيح" عندما تكون إمكانية رؤية طريقة العرض هذه هي View.INVISIBLE، وتعرض القيمة "خطأ" في الحالات الأخرى.

Boolean View.isVisible()

تعرض هذه الطريقة القيمة true عندما يكون مستوى رؤية طريقة العرض هذه هو View.VISIBLE، وتعرض القيمة false في الحالات الأخرى.

Int View.marginBottom()

تعرض هذه الطريقة الهامش السفلي إذا كانت LayoutParams الخاصة بهذا العرض هي ViewGroup.MarginLayoutParams، أو تعرض 0.

Int View.marginEnd()

تعرض هذه الطريقة الهامش الأيمن إذا كانت LayoutParams الخاصة بهذا العرض هي ViewGroup.MarginLayoutParams، أو 0 في الحالات الأخرى.

Int View.marginLeft()

تعرض هذه السمة الهامش الأيسر إذا كان LayoutParams الخاص بطريقة العرض هذه هو ViewGroup.MarginLayoutParams، أو 0 في حال عدم توفّر ذلك.

Int View.marginRight()

تعرض هذه السمة الهامش الأيمن إذا كانت LayoutParams الخاصة بطريقة العرض هذه هي ViewGroup.MarginLayoutParams، أو 0 في الحالات الأخرى.

Int View.marginStart()

تعرض هذه السمة الهامش الأيمن إذا كانت LayoutParams الخاصة بهذا العرض هي ViewGroup.MarginLayoutParams، أو 0 في الحالات الأخرى.

Int View.marginTop()

تعرض هذه السمة الهامش العلوي إذا كانت LayoutParams الخاصة بهذا العرض هي ViewGroup.MarginLayoutParams، أو 0 في الحالات الأخرى.

بالنسبة إلى android.view.ViewGroup
Sequence<View> ViewGroup.children()

تعرض هذه السمة Sequence على عناصر العرض الثانوية في مجموعة العرض هذه.

Int ViewGroup.size()

تعرض هذه السمة عدد المشاهدات في مجموعة طرق العرض هذه.

androidx.core.widget

الاعتمادية

Groovy

dependencies {
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.17.0")
}

وظائف الإضافة

بالنسبة إلى android.widget.TextView
TextWatcher TextView.addTextChangedListener(crossinline beforeTextChanged: (text: CharSequence?, start: Int, count: Int, after: Int) -> Unit = { _, _, _, _ -> }, crossinline onTextChanged: (text: CharSequence?, start: Int, count: Int, after: Int) -> Unit = { _, _, _, _ -> }, crossinline afterTextChanged: (text: Editable?) -> Unit = {})

إضافة أداة معالجة تغيير النص إلى TextView هذا باستخدام الإجراءات المتوفّرة

TextWatcher TextView.doAfterTextChanged(crossinline action: (text: Editable?) -> Unit)

أضِف إجراءً سيتم تنفيذه بعد تغيير النص.

TextWatcher TextView.doBeforeTextChanged(crossinline action: (text: CharSequence?, start: Int, count: Int, after: Int) -> Unit)

أضِف إجراءً سيتم تنفيذه قبل تغيير النص.

TextWatcher TextView.doOnTextChanged(crossinline action: (text: CharSequence?, start: Int, count: Int, after: Int) -> Unit)

أضِف إجراءً سيتم تنفيذه عند تغيير النص.

androidx.dynamicanimation.animation

الاعتمادية

رائع

dependencies {
    implementation "androidx.dynamicanimation:dynamicanimation-ktx:"
}

Kotlin

dependencies {
    implementation("androidx.dynamicanimation:dynamicanimation-ktx:")
}

وظائف الإضافة

بالنسبة إلى SpringAnimation
SpringAnimation SpringAnimation.withSpringForceProperties(func: SpringForce.() -> Unit)

تعدّل هذه الطريقة خصائص قوة النابض أو تطبّقها، مثل SpringForce.mDampingRatio وSpringForce.mFinalPosition ودرجة الصلابة في SpringAnimation.

الدوال ذات المستوى الأعلى

FlingAnimation flingAnimationOf(setter: (Float) -> Unit, getter: () -> Float)

تُنشئ هذه السمة FlingAnimation لسمة يمكن الوصول إليها من خلال الدالتَين setter وgetter المتوفّرتَين.

SpringAnimation springAnimationOf(setter: (Float) -> Unit, getter: () -> Float, finalPosition: Float = Float.NaN)

تنشئ هذه الدالة SpringAnimation لسمة يمكن الوصول إليها من خلال دالتَي الضبط والحصول المتوفّرتَين.

androidx.fragment.app

الاعتمادية

Groovy

dependencies {
    implementation "androidx.fragment:fragment-ktx:1.8.9"
}

Kotlin

dependencies {
    implementation("androidx.fragment:fragment-ktx:1.8.9")
}

وظائف الإضافة

بالنسبة إلى android.view.View
F View.findFragment()

ابحث عن Fragment مرتبط بـ View.

بالنسبة إلى الجزء
Lazy<VM> Fragment.activityViewModels(noinline factoryProducer: () -> ViewModelProvider.Factory = null)

تعرض هذه الدالة تفويضًا للسمة للوصول إلى ViewModel الخاص بالنشاط الرئيسي، وفي حال تحديد factoryProducer، سيتم استخدام ViewModelProvider.Factory الذي تعرضه لإنشاء ViewModel للمرة الأولى.

Lazy<VM> Fragment.createViewModelLazy(viewModelClass: KClass<VM>, storeProducer: () -> ViewModelStore, factoryProducer: () -> ViewModelProvider.Factory = null)

طريقة مساعدة لإنشاء ViewModelLazy، تحلّ null التي تم تمريرها على أنّها factoryProducer إلى الإعدادات الأصلية التلقائية.

Lazy<VM> Fragment.viewModels(noinline ownerProducer: () -> ViewModelStoreOwner = { this }, noinline factoryProducer: () -> ViewModelProvider.Factory = null)

تعرض هذه الدالة عنصرًا نائبًا للسمة من أجل الوصول إلى ViewModel تلقائيًا ضمن نطاق Fragment هذا:

بالنسبة إلى FragmentTransaction
FragmentTransaction FragmentTransaction.add(@IdRes containerViewId: Int, tag: String? = null, args: Bundle? = null)

أضِف جزءًا إلى FragmentManager المرتبط، مع تضخيم طريقة عرض الجزء في طريقة عرض الحاوية المحدّدة بواسطة containerViewId، وذلك لاستردادها لاحقًا من خلال FragmentManager.findFragmentById.

FragmentTransaction FragmentTransaction.add(tag: String, args: Bundle? = null)

أضِف جزءًا إلى FragmentManager المرتبط بدون إضافة الجزء إلى أي عرض حاوية.

FragmentTransaction FragmentTransaction.replace(@IdRes containerViewId: Int, tag: String? = null, args: Bundle? = null)

استبدِل جزءًا حاليًا تمت إضافته إلى حاوية.

بالنسبة إلى FragmentManager
الوحدة FragmentManager.commit(allowStateLoss: Boolean = false, body: FragmentTransaction.() -> Unit)

نفِّذ body في FragmentTransaction يتم تنفيذه تلقائيًا إذا اكتمل بدون استثناء.

الوحدة FragmentManager.commitNow(allowStateLoss: Boolean = false, body: FragmentTransaction.() -> Unit)

نفِّذ body في FragmentTransaction يتم تنفيذه تلقائيًا إذا اكتمل بدون استثناء.

الوحدة FragmentManager.transaction(now: Boolean = false, allowStateLoss: Boolean = false, body: FragmentTransaction.() -> Unit)

نفِّذ body في FragmentTransaction يتم تنفيذه تلقائيًا إذا اكتمل بدون استثناء.

androidx.fragment.app.testing

الاعتمادية

Groovy

dependencies {
    implementation "androidx.fragment:fragment-testing:1.8.9"
}

Kotlin

dependencies {
    implementation("androidx.fragment:fragment-testing:1.8.9")
}

الدوال ذات المستوى الأعلى

FragmentScenario<F!> launchFragment(fragmentArgs: Bundle? = null, @StyleRes themeResId: Int = R.style.FragmentScenarioEmptyFragmentActivityTheme, factory: FragmentFactory? = null)

تُطلق هذه الدالة جزءًا (Fragment) مع وسيطات معيّنة تستضيفه FragmentActivity فارغة باستخدام FragmentFactory معيّن، وتنتظر إلى أن يصل الجزء إلى حالة "مستأنف".

FragmentScenario<F!> launchFragment(fragmentArgs: Bundle? = null, @StyleRes themeResId: Int = R.style.FragmentScenarioEmptyFragmentActivityTheme, crossinline instantiate: () -> F)

يُطلق هذا الأمر جزءًا مع وسيطات معيّنة تستضيفه FragmentActivity فارغة باستخدام instantiate لإنشاء الجزء، وينتظر إلى أن يصل إلى حالة "تمت استئناف النشاط".

FragmentScenario<F!> launchFragmentInContainer(fragmentArgs: Bundle? = null, @StyleRes themeResId: Int = R.style.FragmentScenarioEmptyFragmentActivityTheme, factory: FragmentFactory? = null)

تُطلق هذه القاعدة Fragment في حاوية العرض الجذرية للنشاط android.R.id.content، مع الوسيطات المحدّدة التي تستضيفها FragmentActivity فارغة، وتنتظر إلى أن تصل إلى حالة مستأنَفة.

FragmentScenario<F!> launchFragmentInContainer(fragmentArgs: Bundle? = null, @StyleRes themeResId: Int = R.style.FragmentScenarioEmptyFragmentActivityTheme, crossinline instantiate: () -> F)

يُطلق هذا الإجراء جزءًا في حاوية العرض الجذرية للنشاط android.R.id.content، مع وسيطات معيّنة تستضيفها FragmentActivity فارغة باستخدام instantiate لإنشاء الجزء، وينتظر إلى أن يصل إلى حالة مستأنفة.

androidx.lifecycle

الاعتمادية

Groovy

dependencies {
    implementation "androidx.lifecycle:lifecycle-livedata-core-ktx:2.9.3"
    implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.9.3"
    implementation "androidx.lifecycle:lifecycle-reactivestreams-ktx:2.9.3"
    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.9.3"
    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.9.3"
}

Kotlin

dependencies {
    implementation("androidx.lifecycle:lifecycle-livedata-core-ktx:2.9.3")
    implementation("androidx.lifecycle:lifecycle-livedata-ktx:2.9.3")
    implementation("androidx.lifecycle:lifecycle-reactivestreams-ktx:2.9.3")
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.9.3")
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.9.3")
}

وظائف الإضافة

بالنسبة إلى kotlinx.coroutines.flow.Flow
LiveData<T> Flow<T>.asLiveData(context: CoroutineContext = EmptyCoroutineContext, timeoutInMs: Long = DEFAULT_TIMEOUT)

تنشئ هذه الدالة LiveData تتضمّن قيمًا تم جمعها من Flow المصدر.

LiveData<T> Flow<T>.asLiveData(context: CoroutineContext = EmptyCoroutineContext, timeout: Duration)

تنشئ هذه الدالة LiveData تتضمّن قيمًا تم جمعها من Flow المصدر.

بالنسبة إلى org.reactivestreams.Publisher
LiveData<T> Publisher<T>.toLiveData()

تنشئ هذه الدالة مصدر LiveData قابلاً للمراقبة من Publisher في ReactiveStreams.

بالنسبة إلى LiveData
Flow<T> LiveData<T>.asFlow()

تنشئ Flow تحتوي على قيم يتم إرسالها من LiveData الأصلية: عند البدء، يتلقّى جامع Flow أحدث قيمة تحتفظ بها LiveData ثم يراقب تحديثات LiveData.

LiveData<X> LiveData<X>.distinctUntilChanged()

لا ينبعث من إنشاء عنصر LiveData جديد أي قيمة إلى أن يتم تغيير قيمة this LiveData المصدر.

LiveData<Y> LiveData<X>.map(crossinline transform: (X) -> Y)

تعرض هذه الدالة LiveData تم ربطها من this LiveData من خلال تطبيق transform على كل مجموعة قيم تم ضبطها على this LiveData.

Observer<T> LiveData<T>.observe(owner: LifecycleOwner, crossinline onChanged: (T) -> Unit)

تضيف هذه الدالة تعبير lambda onChanged المحدّد كمراقب ضمن فترة نشاط المالك المحدّد وتعرض مرجعًا للمراقب.

LiveData<Y> LiveData<X>.switchMap(crossinline transform: (X) -> LiveData<Y>)

تعرض هذه الدالة LiveData تم ربطها من this LiveData عن طريق تطبيق transform على كل مجموعة قيم تم ضبطها على this.

الناشر<T> LiveData<T>.toPublisher(lifecycle: LifecycleOwner)

تحوّل هذه الدالة مصدر بيانات LiveData المحدّد إلى Publisher من ReactiveStreams.

بالنسبة إلى ViewModelProvider
VM ViewModelProvider.get()

تعرض هذه الدالة ViewModel حاليًا أو تنشئ ViewModel جديدًا في النطاق (عادةً، يكون جزءًا أو نشاطًا) مرتبطًا بـ ViewModelProvider.

بالنسبة إلى LifecycleOwner
تعليق T LifecycleOwner.whenCreated(block: suspend CoroutineScope.() -> T)

يتم تنفيذ الرمز البرمجي المحدّد عندما تكون حالة LifecycleOwner في Lifecycle.State.CREATED أو أعلى.

تعليق T LifecycleOwner.whenResumed(block: suspend CoroutineScope.() -> T)

يتم تنفيذ الرمز البرمجي المحدّد عندما تكون Lifecycle الخاصة بـ LifecycleOwner في حالة Lifecycle.State.RESUMED على الأقل.

تعليق T LifecycleOwner.whenStarted(block: suspend CoroutineScope.() -> T)

يتم تنفيذ الرمز البرمجي المحدّد عندما تكون دورة حياة LifecycleOwner في حالة Lifecycle.State.STARTED على الأقل.

مراحل النشاط
تعليق T Lifecycle.whenCreated(block: suspend CoroutineScope.() -> T)

يتم تنفيذ الرمز البرمجي المحدّد عندما تكون دورة الحياة في حالة Lifecycle.State.CREATED على الأقل.

تعليق T Lifecycle.whenResumed(block: suspend CoroutineScope.() -> T)

يتم تنفيذ الرمز البرمجي المحدّد عندما تكون دورة الحياة في حالة Lifecycle.State.RESUMED على الأقل.

تعليق T Lifecycle.whenStarted(block: suspend CoroutineScope.() -> T)

يتم تنفيذ الرمز البرمجي المحدّد عندما تكون دورة الحياة في الحالة Lifecycle.State.STARTED على الأقل.

تعليق T Lifecycle.whenStateAtLeast(minState: Lifecycle.State, block: suspend CoroutineScope.() -> T)

يتم تنفيذ الكتلة المحدّدة على CoroutineDispatcher الذي ينفّذ الكتلة على سلسلة التعليمات الرئيسية ويعلّق التنفيذ ما لم تكن حالة Lifecycle هي minState على الأقل.

سمات الإضافة

مراحل النشاط
LifecycleCoroutineScope Lifecycle.coroutineScope()

CoroutineScope المرتبط بهذا Lifecycle

بالنسبة إلى LifecycleOwner
LifecycleCoroutineScope LifecycleOwner.lifecycleScope()

CoroutineScope مرتبطة بدورة الحياة الخاصة بـ LifecycleOwner.

بالنسبة إلى ViewModel
CoroutineScope ViewModel.viewModelScope()

CoroutineScope المرتبط بهذا ViewModel

الدوال ذات المستوى الأعلى

LiveData<T> liveData(context: CoroutineContext = EmptyCoroutineContext, timeoutInMs: Long = DEFAULT_TIMEOUT, block: suspend LiveDataScope<T>.() -> Unit)

تنشئ هذه الدالة LiveData تتضمّن قيمًا تم إنشاؤها من الكتلة المحدّدة التي يتم تنفيذها في LiveDataScope.

LiveData<T> liveData(context: CoroutineContext = EmptyCoroutineContext, timeout: Duration, block: suspend LiveDataScope<T>.() -> Unit)

تنشئ هذه الدالة LiveData تتضمّن قيمًا تم إنشاؤها من الكتلة المحدّدة التي يتم تنفيذها في LiveDataScope.

androidx.navigation

الاعتمادية

رائع

dependencies {
    implementation "androidx.navigation:navigation-runtime-ktx:2.9.3"
    implementation "androidx.navigation:navigation-fragment-ktx:2.9.3"
    implementation "androidx.navigation:navigation-ui-ktx:2.9.3"
}

Kotlin

dependencies {
    implementation("androidx.navigation:navigation-runtime-ktx:2.9.3")
    implementation("androidx.navigation:navigation-fragment-ktx:2.9.3")
    implementation("androidx.navigation:navigation-ui-ktx:2.9.3")
}

وظائف الإضافة

بالنسبة إلى android.app.Activity
NavController Activity.findNavController(@IdRes viewId: Int)

ابحث عن NavController باستخدام رقم تعريف العرض وActivity الذي يحتوي عليه.

NavArgsLazy<Args> Activity.navArgs()

تعرض هذه الدالة عنصرًا نائبًا من النوع Lazy للوصول إلى البيانات الإضافية الخاصة بـ Activity كعنصر Args.

بالنسبة إلى android.view.View
NavController View.findNavController()

ابحث عن NavController مرتبط بـ View.

بالنسبة إلى NavGraphBuilder
الوحدة NavGraphBuilder.activity(@IdRes id: Int, builder: ActivityNavigatorDestinationBuilder.() -> Unit)

إنشاء ActivityNavigator.Destination جديد

الوحدة NavGraphBuilder.navigation(@IdRes id: Int, @IdRes startDestination: Int, builder: NavGraphBuilder.() -> Unit)

إنشاء NavGraph متداخل

بالنسبة إلى NavGraph
عامل التشغيل قيمة منطقية NavGraph.contains(@IdRes id: Int)

تعرِض true إذا تم العثور على وجهة تتضمّن id في الرسم البياني للتنقّل هذا.

عامل التشغيل NavDestination NavGraph.get(@IdRes id: Int)

تعرض هذه السمة الوجهة مع id.

عامل التشغيل الوحدة NavGraph.minusAssign(node: NavDestination)

تزيل هذه السمة node من الرسم البياني للتنقّل هذا.

عامل التشغيل الوحدة NavGraph.plusAssign(node: NavDestination)

تضيف هذه السمة وجهة إلى NavGraph.

عامل التشغيل الوحدة NavGraph.plusAssign(other: NavGraph)

إضافة جميع الوجهات من مجموعة أخرى إلى هذه المجموعة

بالنسبة إلى NavController
NavGraph NavController.createGraph(@IdRes id: Int = 0, @IdRes startDestination: Int, builder: NavGraphBuilder.() -> Unit)

إنشاء NavGraph جديد

بالنسبة إلى NavHost
NavGraph NavHost.createGraph(@IdRes id: Int = 0, @IdRes startDestination: Int, builder: NavGraphBuilder.() -> Unit)

إنشاء NavGraph جديد

بالنسبة إلى NavigatorProvider
عامل التشغيل T NavigatorProvider.get(name: String)

يستردّ هذا الإجراء Navigator مسجَّلاً حسب الاسم.

عامل التشغيل T NavigatorProvider.get(clazz: KClass<T>)

يسترد هذا الإجراء Navigator مسجَّلاً باستخدام الاسم المقدَّم من خلال Navigator.Name annotation.

NavGraph NavigatorProvider.navigation(@IdRes id: Int = 0, @IdRes startDestination: Int, builder: NavGraphBuilder.() -> Unit)

إنشاء NavGraph جديد

عامل التشغيل الوحدة NavigatorProvider.plusAssign(navigator: Navigator<out NavDestination>)

سجِّل أداة تنقّل باستخدام الاسم المقدَّم من خلال التعليق التوضيحي Navigator.Name.

operator Navigator<out NavDestination!>? NavigatorProvider.set(name: String, navigator: Navigator<out NavDestination>)

تسجيل أداة تنقّل بالاسم

بالنسبة إلى الجزء
Lazy<VM> Fragment.navGraphViewModels(@IdRes navGraphId: Int, noinline factoryProducer: () -> ViewModelProvider.Factory = null)

تعرض هذه الدالة عنصرًا نائبًا للسمة من أجل الوصول إلى ViewModel ضمن نطاق الرسم البياني للتنقّل المتوفّر في سجلّ التراجع الخاص بـ {@link NavController}:

الدوال ذات المستوى الأعلى

ActivityNavigator.Extras ActivityNavigatorExtras(activityOptions: ActivityOptionsCompat? = null, flags: Int = 0)

أنشِئ مثيلاً جديدًا من ActivityNavigator.Extras باستخدام مثيل ActivityOptionsCompat محدّد و/أو أي علامات Intent.FLAG_ACTIVITY_.

NavOptions navOptions(optionsBuilder: NavOptionsBuilder.() -> Unit)

إنشاء NavOptions جديد

androidx.navigation.fragment

الاعتمادية

رائع

dependencies {
    implementation "androidx.navigation:navigation-fragment-ktx:2.9.3"
}

Kotlin

dependencies {
    implementation("androidx.navigation:navigation-fragment-ktx:2.9.3")
}

وظائف الإضافة

بالنسبة إلى NavGraphBuilder
الوحدة NavGraphBuilder.dialog(@IdRes id: Int)

إنشاء DialogFragmentNavigator.Destination جديد

الوحدة NavGraphBuilder.dialog(@IdRes id: Int, builder: DialogFragmentNavigatorDestinationBuilder.() -> Unit)

إنشاء DialogFragmentNavigator.Destination جديد

الوحدة NavGraphBuilder.fragment(@IdRes id: Int)

إنشاء FragmentNavigator.Destination جديد

الوحدة NavGraphBuilder.fragment(@IdRes id: Int, builder: FragmentNavigatorDestinationBuilder.() -> Unit)

إنشاء FragmentNavigator.Destination جديد

بالنسبة إلى الجزء
NavController Fragment.findNavController()

العثور على NavController من خلال Fragment

NavArgsLazy<Args> Fragment.navArgs()

تعرض هذه الدالة كائنًا مفوَّضًا من النوع Lazy للوصول إلى وسيطات Fragment ككائن Args.

الدوال ذات المستوى الأعلى

FragmentNavigator.Extras FragmentNavigatorExtras(vararg sharedElements: Pair<View, String>)

إنشاء مثيل جديد من FragmentNavigator.Extras باستخدام العناصر المشترَكة المحدّدة

androidx.navigation.ui

الاعتمادية

رائع

dependencies {
    implementation "androidx.navigation:navigation-ui-ktx:2.9.3"
}

Kotlin

dependencies {
    implementation("androidx.navigation:navigation-ui-ktx:2.9.3")
}

وظائف الإضافة

بالنسبة إلى android.view.MenuItem
Boolean MenuItem.onNavDestinationSelected(navController: NavController)

محاولة الانتقال إلى NavDestination المرتبط بـ MenuItem هذا

بالنسبة إلى androidx.appcompat.app.AppCompatActivity
الوحدة AppCompatActivity.setupActionBarWithNavController(navController: NavController, drawerLayout: DrawerLayout?)

تُعدّ هذه السمة ActionBar التي تعرضها AppCompatActivity.getSupportActionBar لاستخدامها مع NavController.

الوحدة AppCompatActivity.setupActionBarWithNavController(navController: NavController, configuration: AppBarConfiguration = AppBarConfiguration(navController.graph))

تُعدّ هذه السمة ActionBar التي تعرضها AppCompatActivity.getSupportActionBar لاستخدامها مع NavController.

بالنسبة إلى androidx.appcompat.widget.Toolbar
الوحدة Toolbar.setupWithNavController(navController: NavController, drawerLayout: DrawerLayout?)

تُعدّ هذه السمة شريط أدوات لاستخدامه مع NavController.

الوحدة Toolbar.setupWithNavController(navController: NavController, configuration: AppBarConfiguration = AppBarConfiguration(navController.graph))

تُعدّ هذه السمة شريط أدوات لاستخدامه مع NavController.

بالنسبة إلى com.google.android.material.appbar.CollapsingToolbarLayout
الوحدة CollapsingToolbarLayout.setupWithNavController(toolbar: Toolbar, navController: NavController, drawerLayout: DrawerLayout?)

تُعدّ هذه السمة CollapsingToolbarLayout وToolbar لاستخدامهما مع NavController.

الوحدة CollapsingToolbarLayout.setupWithNavController(toolbar: Toolbar, navController: NavController, configuration: AppBarConfiguration = AppBarConfiguration(navController.graph))

تُعدّ هذه السمة CollapsingToolbarLayout وToolbar لاستخدامهما مع NavController.

بالنسبة إلى com.google.android.material.bottomnavigation.BottomNavigationView
الوحدة BottomNavigationView.setupWithNavController(navController: NavController)

تُعدّ هذه الفئة BottomNavigationView لاستخدامها مع NavController.

بالنسبة إلى com.google.android.material.navigation.NavigationView
الوحدة NavigationView.setupWithNavController(navController: NavController)

تُعدّ هذه السمة NavigationView لاستخدامها مع NavController.

بالنسبة إلى NavController
Boolean NavController.navigateUp(drawerLayout: DrawerLayout?)

يتعامل مع الزر "أعلى" من خلال تفويض سلوكه إلى NavController المحدّد.

Boolean NavController.navigateUp(appBarConfiguration: AppBarConfiguration)

يتعامل مع الزر "أعلى" من خلال تفويض سلوكه إلى NavController المحدّد.

الدوال ذات المستوى الأعلى

AppBarConfiguration AppBarConfiguration(navGraph: NavGraph, drawerLayout: DrawerLayout? = null, noinline fallbackOnNavigateUpListener: () -> Boolean = { false })

خيارات الإعداد لطُرق NavigationUI التي تتفاعل مع عمليات تنفيذ نمط شريط التطبيق، مثل android.support.v7.widget.Toolbar وandroid.support.design.widget.CollapsingToolbarLayout وandroid.support.v7.app.ActionBar

AppBarConfiguration AppBarConfiguration(topLevelMenu: Menu, drawerLayout: DrawerLayout? = null, noinline fallbackOnNavigateUpListener: () -> Boolean = { false })

خيارات الإعداد لطُرق NavigationUI التي تتفاعل مع عمليات تنفيذ نمط شريط التطبيق، مثل android.support.v7.widget.Toolbar وandroid.support.design.widget.CollapsingToolbarLayout وandroid.support.v7.app.ActionBar

AppBarConfiguration AppBarConfiguration(topLevelDestinationIds: Set<Int>, drawerLayout: DrawerLayout? = null, noinline fallbackOnNavigateUpListener: () -> Boolean = { false })

خيارات الإعداد لطُرق NavigationUI التي تتفاعل مع عمليات تنفيذ نمط شريط التطبيق، مثل android.support.v7.widget.Toolbar وandroid.support.design.widget.CollapsingToolbarLayout وandroid.support.v7.app.ActionBar

androidx.paging

الاعتمادية

Groovy

dependencies {
    implementation "androidx.paging:paging-common-ktx:2.1.2"
    implementation "androidx.paging:paging-runtime-ktx:2.1.2"
    implementation "androidx.paging:paging-rxjava2-ktx:2.1.2"
}

Kotlin

dependencies {
    implementation("androidx.paging:paging-common-ktx:2.1.2")
    implementation("androidx.paging:paging-runtime-ktx:2.1.2")
    implementation("androidx.paging:paging-rxjava2-ktx:2.1.2")
}

وظائف الإضافة

بالنسبة إلى المصنع
Flowable<PagedList<Value>> DataSource.Factory<Key, Value>.toFlowable(config: PagedList.Config, initialLoadKey: Key? = null, boundaryCallback: PagedList.BoundaryCallback<Value>? = null, fetchScheduler: Scheduler? = null, notifyScheduler: Scheduler? = null, backpressureStrategy: BackpressureStrategy = BackpressureStrategy.LATEST)

تنشئ هذه الدالة Flowable<PagedList> من DataSource.Factory، وهي تسهّل استخدام RxPagedListBuilder.

Flowable<PagedList<Value>> DataSource.Factory<Key, Value>.toFlowable(pageSize: Int, initialLoadKey: Key? = null, boundaryCallback: PagedList.BoundaryCallback<Value>? = null, fetchScheduler: Scheduler? = null, notifyScheduler: Scheduler? = null, backpressureStrategy: BackpressureStrategy = BackpressureStrategy.LATEST)

تنشئ هذه الدالة Flowable<PagedList> من DataSource.Factory، وهي تسهّل استخدام RxPagedListBuilder.

LiveData<PagedList<Value>> DataSource.Factory<Key, Value>.toLiveData(config: PagedList.Config, initialLoadKey: Key? = null, boundaryCallback: PagedList.BoundaryCallback<Value>? = null, fetchExecutor: Executor = ArchTaskExecutor.getIOThreadExecutor())

تنشئ هذه الدالة LiveData<PagedList> من DataSource.Factory، وهي توفّر طريقة سهلة لاستخدام LivePagedListBuilder.

LiveData<PagedList<Value>> DataSource.Factory<Key, Value>.toLiveData(pageSize: Int, initialLoadKey: Key? = null, boundaryCallback: PagedList.BoundaryCallback<Value>? = null, fetchExecutor: Executor = ArchTaskExecutor.getIOThreadExecutor())

تنشئ هذه الدالة LiveData<PagedList> من DataSource.Factory، وهي توفّر طريقة سهلة لاستخدام LivePagedListBuilder.

Observable<PagedList<Value>> DataSource.Factory<Key, Value>.toObservable(config: PagedList.Config, initialLoadKey: Key? = null, boundaryCallback: PagedList.BoundaryCallback<Value>? = null, fetchScheduler: Scheduler? = null, notifyScheduler: Scheduler? = null)

تنشئ هذه الدالة Observable<PagedList> من DataSource.Factory، وهي توفّر طريقة سهلة للاستخدام مع RxPagedListBuilder.

Observable<PagedList<Value>> DataSource.Factory<Key, Value>.toObservable(pageSize: Int, initialLoadKey: Key? = null, boundaryCallback: PagedList.BoundaryCallback<Value>? = null, fetchScheduler: Scheduler? = null, notifyScheduler: Scheduler? = null)

تنشئ هذه الدالة Observable<PagedList> من DataSource.Factory، وهي توفّر طريقة سهلة للاستخدام مع RxPagedListBuilder.

الدوال ذات المستوى الأعلى

PagedList.Config Config(pageSize: Int, prefetchDistance: Int = pageSize, enablePlaceholders: Boolean = true, initialLoadSizeHint: Int = pageSize * PagedList.Config.Builder.DEFAULT_INITIAL_PAGE_MULTIPLIER, maxSize: Int = PagedList.Config.MAX_SIZE_UNBOUNDED)

تنشئ هذه الدالة PagedList.Config، وهي طريقة سهلة لاستخدام PagedList.Config.Builder.

PagedList<Value> PagedList(dataSource: DataSource<Key, Value>, config: PagedList.Config, notifyExecutor: Executor, fetchExecutor: Executor, boundaryCallback: PagedList.BoundaryCallback<Value>? = null, initialKey: Key? = null)

تنشئ هذه الدالة PagedList، وهي طريقة سهلة لاستخدام PagedList.Builder.

androidx.palette.graphics

الاعتمادية

Groovy

dependencies {
    implementation "androidx.palette:palette-ktx:1.0.0"
}

Kotlin

dependencies {
    implementation("androidx.palette:palette-ktx:1.0.0")
}

وظائف الإضافة

بالنسبة إلى لوحة الألوان
operator Palette.Swatch? Palette.get(target: Target)

تعرض هذه الدالة عيّنة الألوان المحدّدة للهدف المحدّد من لوحة الألوان، أو null إذا لم يتم العثور على عيّنة.

androidx.preference

الاعتمادية

Groovy

dependencies {
    implementation "androidx.preference:preference-ktx:1.2.1"
}

Kotlin

dependencies {
    implementation("androidx.preference:preference-ktx:1.2.1")
}

وظائف الإضافة

بالنسبة إلى PreferenceGroup
عامل التشغيل قيمة منطقية PreferenceGroup.contains(preference: Preference)

تعرض الدالة القيمة true إذا تم العثور على preference في مجموعة الإعدادات المفضّلة هذه.

الوحدة PreferenceGroup.forEach(action: (preference: Preference) -> Unit)

ينفّذ الإجراء المحدّد على كل إعداد مفضّل في مجموعة الإعدادات المفضّلة هذه.

الوحدة PreferenceGroup.forEachIndexed(action: (index: Int, preference: Preference) -> Unit)

تُنفِّذ هذه الطريقة الإجراء المحدّد على كل إعداد مفضّل في مجموعة الإعدادات المفضّلة هذه، مع توفير الفهرس التسلسلي.

operator T? PreferenceGroup.get(key: CharSequence)

تعرض هذه السمة الإعداد المفضّل الذي يتضمّن key، أو null إذا لم يتم العثور على إعداد مفضّل يتضمّن key.

operator Preference PreferenceGroup.get(index: Int)

تعرض هذه الطريقة الإعداد المفضّل في index.

Boolean PreferenceGroup.isEmpty()

تعرض القيمة "صحيح" إذا كانت مجموعة الإعدادات المفضّلة هذه لا تحتوي على أي إعدادات مفضّلة.

Boolean PreferenceGroup.isNotEmpty()

تعرِض القيمة "صحيح" إذا كانت مجموعة الإعدادات المفضّلة هذه تحتوي على إعداد مفضّل واحد أو أكثر.

operator MutableIterator<Preference> PreferenceGroup.iterator()

تعرض هذه السمة MutableIterator على الإعدادات المفضّلة في مجموعة الإعدادات المفضّلة هذه.

عامل التشغيل الوحدة PreferenceGroup.minusAssign(preference: Preference)

تتم إزالة preference من مجموعة الإعدادات المفضّلة هذه.

عامل التشغيل الوحدة PreferenceGroup.plusAssign(preference: Preference)

تضيف هذه السمة preference إلى مجموعة الإعدادات المفضّلة هذه.

سمات الإضافة

بالنسبة إلى PreferenceGroup
Sequence<Preference> PreferenceGroup.children()

تعرض هذه الطريقة تسلسلاً للإعدادات المفضّلة في مجموعة الإعدادات المفضّلة هذه.

Int PreferenceGroup.size()

تعرض هذه السمة عدد الإعدادات المفضّلة في مجموعة الإعدادات المفضّلة هذه.

androidx.room

الاعتمادية

Groovy

dependencies {
    implementation "androidx.room:room-ktx:2.7.2"
}

Kotlin

dependencies {
    implementation("androidx.room:room-ktx:2.7.2")
}

وظائف الإضافة

بالنسبة إلى RoomDatabase
تعليق R RoomDatabase.withTransaction(block: suspend () -> R)

يستدعي كتلة التعليق المحدّدة في معاملة قاعدة بيانات.

androidx.slice.builders

الاعتمادية

Groovy

dependencies {
    implementation "androidx.slice:slice-builders-ktx:1.0.0-alpha08"
}

Kotlin

dependencies {
    implementation("androidx.slice:slice-builders-ktx:1.0.0-alpha08")
}

وظائف الإضافة

بالنسبة إلى GridRowBuilderDsl
GridRowBuilder GridRowBuilderDsl.cell(buildCell: CellBuilderDsl.() -> Unit)

GridRowBuilder GridRowBuilderDsl.seeMoreCell(buildCell: CellBuilderDsl.() -> Unit)

بالنسبة إلى ListBuilderDsl
ListBuilder ListBuilderDsl.gridRow(buildGrid: GridRowBuilderDsl.() -> Unit)

ListBuilder ListBuilderDsl.header(buildHeader: HeaderBuilderDsl.() -> Unit)

ListBuilder ListBuilderDsl.inputRange(buildInputRange: InputRangeBuilderDsl.() -> Unit)

ListBuilder ListBuilderDsl.range(buildRange: RangeBuilderDsl.() -> Unit)

ListBuilder ListBuilderDsl.row(buildRow: RowBuilderDsl.() -> Unit)

ListBuilder ListBuilderDsl.seeMoreRow(buildRow: RowBuilderDsl.() -> Unit)

الدوال ذات المستوى الأعلى

الشريحة list(context: Context, uri: Uri, ttl: Long, addRows: ListBuilderDsl.() -> Unit)

يقلّل من الإسهاب المطلوب لإنشاء Slice في Kotlin.

SliceAction tapSliceAction(pendingIntent: PendingIntent, icon: IconCompat, imageMode: Int = ICON_IMAGE, title: CharSequence)

طريقة المصنع لإنشاء SliceAction قابلة للنقر.

SliceAction toggleSliceAction(pendingIntent: PendingIntent, icon: IconCompat? = null, title: CharSequence, isChecked: Boolean)

طريقة المصنع لإنشاء SliceAction قابلة للتبديل.

androidx.sqlite.db

الاعتمادية

Groovy

dependencies {
    implementation "androidx.sqlite:sqlite-ktx:2.5.2"
}

Kotlin

dependencies {
    implementation("androidx.sqlite:sqlite-ktx:2.5.2")
}

وظائف الإضافة

بالنسبة إلى SupportSQLiteDatabase
T SupportSQLiteDatabase.transaction(exclusive: Boolean = true, body: SupportSQLiteDatabase.() -> T)

تنفيذ body في عملية مع وضع علامة على أنّها ناجحة إذا اكتملت بدون استثناء

androidx.work

الاعتمادية

وظائف الإضافة

بالنسبة إلى com.google.common.util.concurrent.ListenableFuture
تعليق R ListenableFuture<R>.await()

تنتظر هذه الطريقة اكتمال ListenableFuture بدون حظر سلسلة محادثات.

بالنسبة إلى العملية
suspend Operation.State.SUCCESS! Operation.await()

ينتظر عملية بدون حظر سلسلة التعليمات.

بالنسبة إلى البيانات
Boolean Data.hasKeyWithValueOfType(key: String)

تعرض القيمة "صحيح" إذا كان مثيل البيانات يتضمّن قيمة تتوافق مع المفتاح المحدّد بنوع T متوقّع.

بالنسبة إلى Builder
OneTimeWorkRequest.Builder OneTimeWorkRequest.Builder.setInputMerger(@NonNull inputMerger: KClass<out InputMerger>)

تضبط هذه السمة InputMerger على OneTimeWorkRequest.Builder.

الدوال ذات المستوى الأعلى

OneTimeWorkRequest.Builder OneTimeWorkRequestBuilder()

تنشئ هذه الدالة OneTimeWorkRequest باستخدام ListenableWorker المحدّد.

PeriodicWorkRequest.Builder PeriodicWorkRequestBuilder(repeatInterval: Long, repeatIntervalTimeUnit: TimeUnit)

تنشئ هذه الدالة PeriodicWorkRequest.Builder باستخدام ListenableWorker معيّن.

PeriodicWorkRequest.Builder PeriodicWorkRequestBuilder(repeatInterval: Duration)

تنشئ هذه الدالة PeriodicWorkRequest.Builder باستخدام ListenableWorker معيّن.

PeriodicWorkRequest.Builder PeriodicWorkRequestBuilder(repeatInterval: Long, repeatIntervalTimeUnit: TimeUnit, flexTimeInterval: Long, flexTimeIntervalUnit: TimeUnit)

تنشئ هذه الدالة PeriodicWorkRequest.Builder باستخدام ListenableWorker معيّن.

PeriodicWorkRequest.Builder PeriodicWorkRequestBuilder(repeatInterval: Duration, flexTimeInterval: Duration)

تنشئ هذه الدالة PeriodicWorkRequest.Builder باستخدام ListenableWorker معيّن.

البيانات workDataOf(vararg pairs: Pair<String, Any?>)

تحويل قائمة من الأزواج إلى عنصر Data

androidx.work.testing

الاعتمادية

Groovy

dependencies {
    implementation "androidx.work:work-testing:2.10.3"
}

Kotlin

dependencies {
    implementation("androidx.work:work-testing:2.10.3")
}

الدوال ذات المستوى الأعلى

TestListenableWorkerBuilder<W> TestListenableWorkerBuilder(context: Context, inputData: Data = Data.EMPTY, tags: List<String> = emptyList(), runAttemptCount: Int = 1, triggeredContentUris: List<Uri> = emptyList(), triggeredContentAuthorities: List<String> = emptyList())

تنشئ هذه الدالة مثيلاً من TestListenableWorkerBuilder.

TestWorkerBuilder<W> TestWorkerBuilder(context: Context, executor: Executor, inputData: Data = Data.EMPTY, tags: List<String> = emptyList(), runAttemptCount: Int = 1, triggeredContentUris: List<Uri> = emptyList(), triggeredContentAuthorities: List<String> = emptyList())

تنشئ هذه الدالة مثيلاً من TestWorkerBuilder.

com.google.android.play.core.ktx

الاعتمادية

Groovy

dependencies {
    implementation "com.google.android.play:core-ktx:1.8.1"
}

Kotlin

dependencies {
    implementation("com.google.android.play:core-ktx:1.8.1")
}

وظائف الإضافة

بالنسبة إلى com.google.android.play.core.appupdate.AppUpdateManager
suspend AppUpdateInfo AppUpdateManager.requestAppUpdateInfo()

يطلب هذا الإجراء التحقّق من توفّر تحديث للتطبيق الحالي.

تعليق الوحدة AppUpdateManager.requestCompleteUpdate()

بالنسبة إلى خطوات التحديث المرنة، يتم تشغيل إكمال التحديث.

Flow<AppUpdateResult> AppUpdateManager.requestUpdateFlow()

نقطة دخول لمراقبة توفّر التحديثات ومستوى تقدّمها

Boolean AppUpdateManager.startUpdateFlowForResult(appUpdateInfo: AppUpdateInfo, appUpdateType: Int, fragment: Fragment, requestCode: Int)

إصدار من AppUpdateManager.startUpdateFlowForResult يقبل أحد أجزاء AndroidX لعرض النتيجة.

بالنسبة إلى com.google.android.play.core.splitinstall.SplitInstallManager
تعليق الوحدة SplitInstallManager.requestCancelInstall(sessionId: Int)

تعليق إصدار SplitInstallManager.cancelInstall

تعليق الوحدة SplitInstallManager.requestDeferredInstall(moduleNames: List<String>)

تعليق إصدار SplitInstallManager.deferredInstall

تعليق الوحدة SplitInstallManager.requestDeferredLanguageInstall(languages: List<Locale>)

تعليق إصدار SplitInstallManager.deferredLanguageInstall

تعليق الوحدة SplitInstallManager.requestDeferredLanguageUninstall(languages: List<Locale>)

تعليق إصدار SplitInstallManager.deferredLanguageUninstall

تعليق الوحدة SplitInstallManager.requestDeferredUninstall(moduleNames: List<String>)

تعليق إصدار SplitInstallManager.deferredUninstall

suspend Int SplitInstallManager.requestInstall(modules: List<String> = listOf(), languages: List<String> = listOf())

يبدأ عملية تثبيت الوحدات أو اللغات المطلوبة.

Flow<SplitInstallSessionState> SplitInstallManager.requestProgressFlow()

تنشئ هذه الدالة Flow مخزَّنًا مؤقتًا وتعرضه، وهو يعرض جميع أحداث التقدّم لعمليات التثبيت المقسَّم الجارية.

suspend SplitInstallSessionState SplitInstallManager.requestSessionState(sessionId: Int)

تعليق إصدار SplitInstallManager.getSessionState

suspend List<SplitInstallSessionState> SplitInstallManager.requestSessionStates()

تعليق إصدار SplitInstallManager.getSessionStates

Boolean SplitInstallManager.startConfirmationDialogForResult(sessionState: SplitInstallSessionState, fragment: Fragment, requestCode: Int)

إصدار من SplitInstallManager.startConfirmationDialogForResult يقبل جزء AndroidX لعرض النتيجة.

سمات الإضافة

بالنسبة إلى com.google.android.play.core.appupdate.AppUpdateInfo
Int AppUpdateInfo.installStatus()

تعرِض هذه السمة حالة التقدّم في التحديث.

Boolean AppUpdateInfo.isFlexibleUpdateAllowed()

تعرِض هذه السمة القيمة true إذا كان التحديث المرن مسموحًا به.

Boolean AppUpdateInfo.isImmediateUpdateAllowed()

تعرض القيمة true إذا كان التحديث الفوري مسموحًا به.

بالنسبة إلى com.google.android.play.core.install.InstallState
Boolean InstallState.hasTerminalStatus()

يشير ذلك إلى أنّ هذه حالة نهائية (لن تكون هناك أي تحديثات أخرى) ويجب التعامل معها وفقًا لذلك (نجاح أو إلغاء أو تعذّر).

Int InstallState.installErrorCode()

تعرِض هذه الطريقة رمز الخطأ الخاص بعملية التثبيت، أو {@link InstallErrorCode#NO_ERROR}.

Int InstallState.installStatus()

تعرِض هذه السمة حالة عملية التثبيت.

String! InstallState.packageName()

تعرض هذه السمة اسم حزمة التطبيق الذي يتم تثبيته.

بالنسبة إلى com.google.android.play.core.splitinstall.SplitInstallSessionState
Long SplitInstallSessionState.bytesDownloaded()

عدد وحدات البايت التي تم تنزيلها من خلال هذا التحديث.

Int SplitInstallSessionState.errorCode()

رمز الخطأ لهذا التحديث.

Boolean SplitInstallSessionState.hasTerminalStatus()

تشير إلى أنّ هذا التحديث نهائي، ما يعني أنّه لن يتم إجراء أي تحديثات أخرى لهذه الجلسة.

List<String> SplitInstallSessionState.languages()

اللغات التي يشملها هذا التحديث

List<String> SplitInstallSessionState.moduleNames()

الوحدات التي يتضمّنها هذا التحديث

Int SplitInstallSessionState.sessionId()

معرّف جلسة هذا التحديث.

Int SplitInstallSessionState.status()

رمز حالة هذا التعديل

Long SplitInstallSessionState.totalBytesToDownload()

إجمالي عدد وحدات البايت التي سيتم تنزيلها من خلال هذا التحديث.

الدوال ذات المستوى الأعلى

SplitInstallStateUpdatedListener SplitInstallStateUpdatedListener(onRequiresConfirmation: (SplitInstallSessionState) -> Unit, onInstalled: (SplitInstallSessionState) -> Unit, onFailed: (SplitInstallSessionState) -> Unit = {}, onPending: (SplitInstallSessionState) -> Unit = {}, onDownloaded: (SplitInstallSessionState) -> Unit = {}, onDownloading: (SplitInstallSessionState) -> Unit = {}, onInstalling: (SplitInstallSessionState) -> Unit = {}, onCanceling: (SplitInstallSessionState) -> Unit = {}, onCanceled: (SplitInstallSessionState) -> Unit = {}, onNonTerminalStatus: (SplitInstallSessionState) -> Unit = {}, onTerminalStatus: (SplitInstallSessionState) -> Unit = {})

دالة تسهيل لإنشاء SplitInstallStateUpdatedListener.