İpucu, kullanıcılar görünüme uzun bastığında veya fareleriyle bir görünümün üzerine geldiğinde görünümün yanında görünen küçük bir açıklayıcı mesajdır. Bu, uygulamanız düzende yer kazanmak için bir işlemi veya bilgi parçasını temsil eden bir simge kullandığında faydalıdır. Bu sayfada, Android 8.0 (API düzeyi) ve sonraki sürümlerde bu ipuçlarını nasıl ekleyeceğiniz gösterilmektedir.
Üretkenlik uygulamalarındakiler gibi bazı senaryolarda, fikirleri ve eylemleri paylaşmak için açıklayıcı bir yöntem gerekir. Şekil 1'de gösterildiği gibi açıklayıcı bir mesaj görüntülemek için ipuçlarını kullanabilirsiniz.
Şekil 1. Bir Android uygulamasında gösterilen ipucu.
Bazı standart widget'lar, title veya content description özelliklerinin içeriğine dayalı ipuçları gösterir. Android 8.0'dan itibaren, diğer özelliklerin değerinden bağımsız olarak ipucunda görüntülenen metni belirtebilirsiniz.
İpucu metnini ayarlama
setTooltipText() yöntemini çağırarak View içinde ipucu metnini belirtebilirsiniz. İlgili XML özelliğini veya API'yi kullanarak tooltipText özelliğini ayarlayabilirsiniz.
XML dosyalarınızda ipucu metnini belirtmek için aşağıdaki örnekte gösterildiği gibi android:tooltipText özelliğini ayarlayın:
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
Kodunuzda ipucu metnini belirtmek için aşağıdaki örnekte gösterildiği gibi setTooltipText(CharSequence) yöntemini kullanın:
Kotlin
val fab: FloatingActionButton = findViewById(R.id.fab) fab.tooltipText = "Send an email"
Java
FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");
API, tooltipText özelliğinin değerini almak için kullanabileceğiniz bir getTooltipText() yöntemi de içerir.
Android, kullanıcılar farelerini görünümün üzerine getirdiğinde veya görünüme uzun bastığında tooltipText özelliğinin değerini gösterir.