Module  javafx.controls
软件包  javafx.scene.control

Class TextInputControl

    • Property Detail

      • font

        public final ObjectProperty<Font> fontProperty
        TextInputControl中用于文本的默认字体。 如果TextInputControl的文本是富文本，则根据嵌入在富文本中的字体信息，可能会使用或不使用此字体，但是在任何需要默认字体的情况下，将使用该字体。
        从以下版本开始：
        JavaFX 8.0
        另请参见：
        getFont() ， setFont(Font)

      • promptText

        public final StringProperty promptTextProperty
        提示文字显示在TextInputControl 。 如果设置为空或空字符串，则不显示提示文本。
        Default value:
        一个空字符串
        从以下版本开始：
        JavaFX 2.2
        另请参见：
        getPromptText() ， setPromptText(String)

      • anchor

        public final ReadOnlyIntegerProperty anchorProperty
        anchor的文字选择。 anchor和caretPosition构成了选择范围。 选择必须始终以开始<=结束的方式指定，但anchor可能小于，等于或大于caretPosition 。 根据用户如何选择文本，锚点可能表示选择的下限或上限。
        另请参见：
        getAnchor()

      • caretPosition

        public final ReadOnlyIntegerProperty caretPositionProperty
        文本中插入符号的当前位置。 anchor和caretPosition组成选择范围。 必须始终以begin <= end来指定选择，但是anchor可能小于，等于或大于caretPosition 。 取决于用户如何选择文本，插入位置可能表示选择的下限或上限。
        另请参见：
        getCaretPosition()

      • undoable

        public final ReadOnlyBooleanProperty undoableProperty
        该属性描述如果目前可以撤消已完成的内容的最新更改。
        Default value:
        假
        从以下版本开始：
        JavaFX 8u40
        另请参见：
        isUndoable()

      • redoable

        public final ReadOnlyBooleanProperty redoableProperty
        该属性描述如果现在可以重做已撤销的内容的最新更改。
        Default value:
        假
        从以下版本开始：
        JavaFX 8u40
        另请参见：
        isRedoable()

    • 构造方法详细信息

      • TextInputControl

        protected TextInputControl​(TextInputControl.Content content)
        创建一个新的TextInputControl。 内容是不可变的财产，在建造时必须指定（非空）。
        参数
        content - 内容的非空执行。

    • 方法详细信息

      • fontProperty

        public final ObjectProperty<Font> fontProperty​()
        TextInputControl中用于文本的默认字体。 如果TextInputControl的文本是富文本，则根据嵌入在富文本中的字体信息，可能会使用或不使用此字体，但是在任何需要默认字体的情况下，将使用该字体。
        从以下版本开始：
        JavaFX 8.0
        另请参见：
        getFont() ， setFont(Font)

      • setFont

        public final void setFont​(Font value)
        设置属性字体的值。
        Property description:
        TextInputControl中用于文本的默认字体。 如果TextInputControl的文本是富文本，则根据嵌入在富文本中的字体信息，可能会使用或不使用此字体，但是在任何需要默认字体的情况下，将使用该字体。
        从以下版本开始：
        JavaFX 8.0

      • getFont

        public final Font getFont​()
        获取属性字体的值。
        Property description:
        TextInputControl中用于文本的默认字体。 如果TextInputControl的文本是富文本，则根据嵌入在富文本中的字体信息，可能会使用或不使用此字体，但是在任何需要默认字体的情况下，将使用该字体。
        从以下版本开始：
        JavaFX 8.0

      • promptTextProperty

        public final StringProperty promptTextProperty​()
        提示文字显示在TextInputControl 。 如果设置为空或空字符串，则不显示提示文本。
        Default value:
        一个空字符串
        从以下版本开始：
        JavaFX 2.2
        另请参见：
        getPromptText() ， setPromptText(String)

      • getPromptText

        public final String getPromptText​()
        获取属性promptText的值。
        Property description:
        提示文字显示在TextInputControl 。 如果设置为空或空字符串，则不显示提示文本。
        Default value:
        一个空字符串
        从以下版本开始：
        JavaFX 2.2

      • setPromptText

        public final void setPromptText​(String value)
        设置属性promptText的值。
        Property description:
        提示文字显示在TextInputControl 。 如果设置为空或空字符串，则不显示提示文本。
        Default value:
        一个空字符串
        从以下版本开始：
        JavaFX 2.2

      • getTextFormatter

        public final TextFormatter<?> getTextFormatter​()
        获取属性textFormatter的值。
        Property description:
        该物业包含目前附件TextFormatter 。 由于该值是Formatter一部分，因此更改TextFormatter将基于新的textFormatter更新文本。
        Default value:
        空值
        从以下版本开始：
        JavaFX 8u40

      • setTextFormatter

        public final void setTextFormatter​(TextFormatter<?> value)
        设置属性textFormatter的值。
        Property description:
        该物业包含目前附件TextFormatter 。 由于该值是Formatter一部分，因此更改TextFormatter将基于新的textFormatter更新文本。
        Default value:
        空值
        从以下版本开始：
        JavaFX 8u40

      • getContent

        protected final TextInputControl.Content getContent​()
        返回文本输入的内容模型。
        结果
        文本输入的内容模型

      • getText

        public final String getText​()
        获取属性文本的值。
        Property description:
        TextInputControl的文本内容。

      • setText

        public final void setText​(String value)
        设置属性文本的值。
        Property description:
        TextInputControl的文本内容。

      • getLength

        public final int getLength​()
        获取属性长度的值。
        Property description:
        文本输入中的字符数。

      • isEditable

        public final boolean isEditable​()
        获取可编辑属性的值。
        Property description:
        指示该TextInputControl是否可以由用户编辑。

      • setEditable

        public final void setEditable​(boolean value)
        设置属性可编辑的值。
        Property description:
        指示该TextInputControl是否可以由用户编辑。

      • getSelection

        public final IndexRange getSelection​()
        获取属性选择的值。
        Property description:
        当前选择。

      • getSelectedText

        public final String getSelectedText​()
        获取属性selectedText的值。
        Property description:
        定义所选文本输入控件中的字符

      • getAnchor

        public final int getAnchor​()
        获取属性锚点的值。
        Property description:
        anchor的文字选择。 anchor和caretPosition组成选择范围。 选择必须始终以begin <= end来指定，但anchor可能小于，等于或大于caretPosition 。 根据用户如何选择文本，锚点可能表示选择的下限或上限。

      • anchorProperty

        public final ReadOnlyIntegerProperty anchorProperty​()
        anchor的文字选择。 anchor和caretPosition组成选择范围。 选择始终必须以开始<= end来指定，但是anchor可能小于，等于或大于caretPosition 。 根据用户如何选择文本，锚点可能表示选择的下限或上限。
        另请参见：
        getAnchor()

      • getCaretPosition

        public final int getCaretPosition​()
        获取属性caretPosition的值。
        Property description:
        文本中插入符号的当前位置。 anchor和caretPosition组成选择范围。 选择必须始终以begin <= end来指定，但anchor可能小于，等于或大于caretPosition 。 取决于用户如何选择文本，插入位置可能表示选择的下限或上限。

      • caretPositionProperty

        public final ReadOnlyIntegerProperty caretPositionProperty​()
        文本中插入符号的当前位置。 anchor和caretPosition组成了选择范围。 必须始终以开始<= end来指定选择，但是anchor可能小于，等于或大于caretPosition 。 取决于用户如何选择文本，插入位置可能表示选择的下限或上限。
        另请参见：
        getCaretPosition()

      • isUndoable

        public final boolean isUndoable​()
        200新200新新新200新200新200新200新新新200新200新新新200新新新200新新200新新200新新新新旗新新200新新200新新200新
        Property description:
        该属性描述如果目前可以撤消已完成的内容的最新更改。
        Default value:
        假
        从以下版本开始：
        JavaFX 8u40

      • undoableProperty

        public final ReadOnlyBooleanProperty undoableProperty​()
        该属性描述如果目前可以撤消已完成的内容的最新更改。
        Default value:
        假
        从以下版本开始：
        JavaFX 8u40
        另请参见：
        isUndoable()

      • isRedoable

        public final boolean isRedoable​()
        获取属性值可重新生成。
        Property description:
        该属性描述如果现在可以重做已撤销的内容的最新更改。
        Default value:
        假
        从以下版本开始：
        JavaFX 8u40

      • redoableProperty

        public final ReadOnlyBooleanProperty redoableProperty​()
        该属性描述如果现在可以重做已撤销的内容的最新更改。
        Default value:
        假
        从以下版本开始：
        JavaFX 8u40
        另请参见：
        isRedoable()

      • getText

        public String getText​(int start,
                      int end)
        返回文本输入内容的一个子集。
        参数
        start - 必须是0到结束-1之间的值。
        end - 必须小于或等于长度
        结果
        文本输入内容的子集

      • appendText

        public void appendText​(String text)
        向内容追加一串字符。
        参数
        text - 一个非空字符串

      • insertText

        public void insertText​(int index,
                       String text)
        在内容中插入一串字符。
        参数
        index - 插入文本的位置。
        text - 要插入的文本。

      • deleteText

        public void deleteText​(IndexRange range)
        从内容中删除一系列字符。
        参数
        range - 要删除的文本范围。 范围对象不能为空。
        另请参见：
        deleteText(int, int)

      • deleteText

        public void deleteText​(int start,
                       int end)
        从内容中删除一系列字符。
        参数
        start - 范围内的起始索引（含）。 这必须是> = 0和<结束。
        end - 范围内的结束索引，独占。 这是一个删除的最后一个字符（与String操作方法一致）。 这必须>开始，而<=文本的长度。

      • replaceText

        public void replaceText​(IndexRange range,
                        String text)
        用给定的文本替换一系列的字符。
        参数
        range - 要替换的文本范围。 范围对象不能为空。
        text - 要替换范围的文本。 这不能为空。
        另请参见：
        replaceText(int, int, String)

      • replaceText

        public void replaceText​(int start,
                        int end,
                        String text)
        用给定的文本替换一系列的字符。
        参数
        start - 范围内的起始指数（含）。 这必须是> = 0和<结束。
        end - 范围内的结束索引，独占。 这是一个删除的最后一个字符（与String操作方法一致）。 这必须>开始，而<=文本的长度。
        text - 要替换范围的文本。 这不能为空。

      • cut

        public void cut​()
        将文本中当前选定的范围传输到剪贴板，删除当前选择。

      • copy

        public void copy​()
        将文本中当前选定的范围传输到剪贴板，留下当前的选择。

      • paste

        public void paste​()
        将剪贴板中的内容传输到此文本中，替换当前选择。 如果没有选择，则剪贴板中的内容将插入当前插入符号位置。

      • selectBackward

        public void selectBackward​()
        在文本中向后移动选择一个字符。 这可能取决于锚点相对于插入位置的位置而取消选择的效果。 这个功能有效地移动了插入位置。

      • selectForward

        public void selectForward​()
        将选项向前移动文本中的一个字符。 这可能取决于锚点相对于插入位置的位置而取消选择的效果。 这个功能有效地将插入符号向前移动。

      • previousWord

        public void previousWord​()
        将插入符号移动到上一个单词的开头。 此功能也具有清除选择的效果。

      • nextWord

        public void nextWord​()
        将插入符号移到下一个字的开头。 此功能也具有清除选择的效果。

      • endOfNextWord

        public void endOfNextWord​()
        将插入符移动到下一个单词的末尾。 此功能也具有清除选择的效果。

      • selectPreviousWord

        public void selectPreviousWord​()
        将插入符号移动到上一个单词的开头。 这不会导致选择被清除。 相反，锚保持放置，插入位置移动到上一个单词的开头。

      • selectNextWord

        public void selectNextWord​()
        将插入符号移到下一个字的开头。 这不会导致选择被清除。 相反，锚保持放置，插入位置移动到下一个单词的开头。

      • selectEndOfNextWord

        public void selectEndOfNextWord​()
        将插入符移动到下一个单词的末尾。 这不会导致选择被清除。

      • selectAll

        public void selectAll​()
        选择文本输入中的所有文本。

      • home

        public void home​()
        将插入符移动到文本的第一个字符之前。 此功能也具有清除选择的效果。

      • end

        public void end​()
        将插入符移动到文本的最后一个字符之后。 此功能也具有清除选择的效果。

      • selectHome

        public void selectHome​()
        将插入符移动到文本的第一个字符之前。 这不会导致选择被清除。 相反，锚保持放置，插入位置移动到第一个字符之前。

      • selectEnd

        public void selectEnd​()
        将插入符移动到文本的最后一个字符之后。 这不会导致选择被清除。 相反，锚点保持放置，插入位置移动到最后一个字符之后。

      • deletePreviousChar

        public boolean deletePreviousChar​()
        如果没有选择，则从文本中删除当前插入符号位置之前的字符，如果有选择则删除选择。 如果删除成功，此函数返回true，否则返回false。
        结果
        如果删除成功则为true，否则为false

      • deleteNextChar

        public boolean deleteNextChar​()
        如果没有选择，则从文本中删除当前插入符号位置后的字符，如果有选择则删除选择。 如果删除成功，此函数返回true，否则返回false。
        结果
        如果删除成功则为true，否则为false

      • forward

        public void forward​()
        向前移动插入位置。 如果没有选择，则插入符号位置向前移动一个字符。 如果有选择，则插入符号位置被移动到选择结束，并且清除选择。

      • backward

        public void backward​()
        向后移动插入符号位置。 如果没有选择，则插入符号位置向后移动一个字符。 如果有选择，则插入符号位置将移动到选择的开头，并将选择清除。 注意：此功能主要由专家使用，主要由实施新皮肤或行为的人员使用。 开发人员或设计师直接访问此功能并不常见。

      • positionCaret

        public void positionCaret​(int pos)
        将插入符号置于pos所示的位置。 此功能也将清除选择。
        参数
        pos - 位置

      • selectPositionCaret

        public void selectPositionCaret​(int pos)
        将插入符号放置在pos所示的位置，并扩展选择（如果有）。 如果没有选择，则形成锚点处于当前插入位置并将插入位置移动到位置的选择。
        参数
        pos - 的位置

      • selectRange

        public void selectRange​(int anchor,
                        int caretPosition)
        定位锚和caretPosition明确。
        参数
        anchor - 锚
        caretPosition - caretPosition

      • extendSelection

        public void extendSelection​(int pos)
        此功能将扩展选择以包括指定的位置。 这不同于selectPositionCaret，因为它不会简单地移动插入符号。 相反，它将根据需要重新定位插入符号和锚点，以确保pos成为新的插入符号，并且选择的另一端成为锚点。
        参数
        pos - 位置

      • clear

        public void clear​()
        清除文本。

      • deselect

        public void deselect​()
        清除选择。

      • replaceSelection

        public void replaceSelection​(String replacement)
        用给定的替换字符串替换选择。 如果没有选择，则替换文本将简单地插入到当前插入位置。 如果有选择，则清除选择并插入给定的替换文本。
        参数
        replacement - 替换字符串

      • undo

        public final void undo​()
        如果可能，撤销最后修改。 如果isUndoable()返回false，则调用此方法没有任何作用。
        从以下版本开始：
        JavaFX 8u40

      • redo

        public final void redo​()
        如果可能，重做最后一次修改。 如果isRedoable()返回false，则调用此方法没有任何作用。
        从以下版本开始：
        JavaFX 8u40

      • commitValue

        public final void commitValue​()
        提交当前文本并将其转换为值。
        从以下版本开始：
        JavaFX 8u40

      • cancelEdit

        public final void cancelEdit​()
        如果该字段当前正在被编辑，该调用将把文本设置为最后一个被提交的值。
        从以下版本开始：
        JavaFX 8u40

      • getClassCssMetaData

        public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData​()
        结果
        与此类相关联的CssMetaData可能包括其类的CssMetaData。
        从以下版本开始：
        JavaFX 8.0

      • queryAccessibleAttribute

        public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                       Object... parameters)
        该方法由辅助技术调用以请求属性的值。

        子类通常覆盖此方法来实现特定角色所需的属性。
        如果未处理特定属性，则必须调用超类实现。

        重写：
        queryAccessibleAttribute在 Control
        参数
        attribute - 请求的属性
        parameters - 可选参数列表
        结果
        请求的属性的值
        另请参见：
        AccessibleAttribute

      • executeAccessibleAction

        public void executeAccessibleAction​(AccessibleAction action,
                                    Object... parameters)
        该方法由辅助技术调用，请求执行由参数指示的动作。

        此方法通常被子类覆盖，以实现特定角色所需的操作。
        如果未处理特定操作，则必须调用超类实现。

        重写：
        executeAccessibleAction在 Control
        参数
        action - 要执行的操作
        parameters - 可选参数列表
        另请参见：
        AccessibleAction