[ Web Proxy ]

Viewing: https://developer.android.com/reference/android/text/method/TransformationMethod.html

TransformationMethod | API reference | Android Developers Skip to main content

[Android Developers]

Essentials Design & Plan Develop Google Play Blog

English
Deutsch
Espaol Amrica Latina
Franais
Indonesia
Polski
Portugus Brasil
Ting Vit

Android Studio

Stay organized with collections Save and categorize content based on your preferences.

Added in API level 1

Summary: Methods

TransformationMethod

Kotlin |Java

public interface TransformationMethod

android.text.method.TransformationMethod

Known indirect subclasses

HideReturnsTransformationMethod, PasswordTransformationMethod, ReplacementTransformationMethod, SingleLineTransformationMethod

HideReturnsTransformationMethod	This transformation method causes any carriage return characters (\r) to be hidden by displaying them as zero-width non-breaking space characters (\ufeff).
PasswordTransformationMethod
ReplacementTransformationMethod	This transformation method causes the characters in the `getOriginal()` array to be replaced by the corresponding characters in the `getReplacement()` array.
SingleLineTransformationMethod	This transformation method causes any newline characters (\n) to be displayed as spaces instead of causing line breaks, and causes carriage return characters (\r) to have no appearance.

TextView uses TransformationMethods to do things like replacing the characters of passwords with dots, or keeping the newline characters from causing line breaks in single-line text fields.

Summary

Public methods
`abstract CharSequence`	`getTransformation(CharSequence source, View view)` Returns a CharSequence that is a transformation of the source text -- for example, replacing each character with a dot in a password field.
`abstract void`	`onFocusChanged(View view, CharSequence sourceText, boolean focused, int direction, Rect previouslyFocusedRect)` This method is called when the TextView that uses this TransformationMethod gains or loses focus.

Public methods

getTransformation

Added in API level 1

public abstract CharSequence getTransformation (CharSequence source, 
                View view)

Returns a CharSequence that is a transformation of the source text -- for example, replacing each character with a dot in a password field. Beware that the returned text must be exactly the same length as the source text, and that if the source text is Editable, the returned text must mirror it dynamically instead of doing a one-time copy. The method should not return null unless source is null.

Parameters
`source`	`CharSequence`
`view`	`View`

Returns
`CharSequence`

onFocusChanged

Added in API level 1

public abstract void onFocusChanged (View view, 
                CharSequence sourceText, 
                boolean focused, 
                int direction, 
                Rect previouslyFocusedRect)

This method is called when the TextView that uses this TransformationMethod gains or loses focus.

Parameters
`view`	`View`
`sourceText`	`CharSequence`
`focused`	`boolean`
`direction`	`int`
`previouslyFocusedRect`	`Rect`

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2026-08-03 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-08-03 UTC."],[],[]]