Professional Documents
Culture Documents
TextBox(Clase)(System.Windows.Forms)
Este artculo proviene de un motor de traduccin automtica. Mueva el puntero sobre las frases del artculo para ver el texto
original. Ms informacin.
TextBox Clase
.NET Framework current version
Jerarqua de herencia
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.TextBoxBase
System.Windows.Forms.TextBox
System.Windows.Forms.DataGridTextBox
System.Windows.Forms.DataGridViewTextBoxEditingControl
Sintaxis
C#
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
publicclassTextBox:TextBoxBase
Constructores
Nombre
Descripcin
TextBox
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
1/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
Propiedades
Nombre
Descripcin
AcceptsReturn
AcceptsTab
AccessibilityObject
AccessibleDefaultActionDescription
AccessibleDescription
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoCompleteCustomSource
AutoCompleteMode
AutoCompleteSource
AutoScrollOffset
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
2/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
AutoSize
BackColor
BackgroundImage
BackgroundImageLayout
BindingContext
BorderStyle
Bottom
Bounds
CanEnableIme
CanFocus
CanRaiseEvents
CanSelect
CanUndo
Capture
CausesValidation
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
3/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
ClientRectangle
ClientSize
CompanyName
Container
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
CreateParams
Cursor
DataBindings
DefaultCursor
DefaultImeMode
DefaultMargin
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
4/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
DefaultMaximumSize
DefaultMinimumSize
DefaultPadding
DefaultSize
Heredado de TextBoxBase.
DesignMode
DisplayRectangle
Disposing
Dock
DoubleBuffered
Enabled
Events
Focused
Font
FontHeight
ForeColor
Handle
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
5/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
Heredado de Control.
HasChildren
Height
HideSelection
ImeMode
ImeModeBase
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Lines
Location
Margin
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
6/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
MaximumSize
MaxLength
MinimumSize
Modified
Multiline
Name
Padding
Parent
PasswordChar
PreferredHeight
PreferredSize
ProductName
ProductVersion
ReadOnly
RecreatingHandle
Region
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
7/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
RenderRightToLeft
ResizeRedraw
Right
RightToLeft
ScaleChildren
ScrollBars
SelectedText
SelectionLength
SelectionStart
ShortcutsEnabled
ShowFocusCues
ShowKeyboardCues
Site
Size
TabIndex
TabStop
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
8/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
Tag
Text
TextAlign
TextLength
Top
TopLevelControl
UseSystemPasswordChar
UseWaitCursor
Visible
Width
WindowTarget
WordWrap
Mtodos
Nombre
Descripcin
AccessibilityNotifyClientsAccessibleEvents,Int32
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
9/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
especificado.Heredado de Control.
AccessibilityNotifyClientsAccessibleEvents,Int32,Int32
AppendTextString
BeginInvokeDelegate
BeginInvokeDelegate,Object[]
BringToFront
Clear
ClearUndo
ContainsControl
Copy
CreateAccessibilityInstance
CreateControl
CreateControlsInstance
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
10/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
CreateGraphics
CreateHandle
Heredado de TextBoxBase.
CreateObjRefType
Cut
DefWndProcMessage
DeselectAll
DestroyHandle
Dispose
DisposeBoolean
DoDragDropObject,DragDropEffects
DrawToBitmapBitmap,Rectangle
EndInvokeIAsyncResult
EqualsObject
Finalize
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
11/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
Focus
GetAccessibilityObjectByIdInt32
Heredado de Control.
GetAutoSizeMode
GetCharFromPositionPoint
GetCharIndexFromPositionPoint
GetChildAtPointPoint
GetChildAtPointPoint,GetChildAtPointSkip
GetContainerControl
GetFirstCharIndexFromLineInt32
GetFirstCharIndexOfCurrentLine
GetHashCode
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
12/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
GetLifetimeService
GetLineFromCharIndexInt32
GetNextControlControl,Boolean
GetPositionFromCharIndexInt32
GetPreferredSizeSize
GetScaledBoundsRectangle,SizeF,BoundsSpecified
GetServiceType
GetStyleControlStyles
GetTopLevel
GetType
Hide
InitializeLifetimeService
InitLayout
Invalidate
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
13/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
InvalidateRectangle
InvalidateRectangle,Boolean
InvalidateRegion
InvalidateRegion,Boolean
InvokeDelegate
InvokeDelegate,Object[]
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
14/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
InvokeGotFocusControl,EventArgs
InvokeLostFocusControl,EventArgs
InvokeOnClickControl,EventArgs
InvokePaintControl,PaintEventArgs
InvokePaintBackgroundControl,PaintEventArgs
IsInputCharChar
IsInputKeyKeys
MemberwiseClone
MemberwiseCloneBoolean
NotifyInvalidateRectangle
OnAcceptsTabChangedEventArgs
OnAutoSizeChangedEventArgs
OnBackColorChangedEventArgs
OnBackgroundImageChangedEventArgs
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
15/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
Heredado de Control.
OnBackgroundImageLayoutChangedEventArgs
Genera el evento
BackgroundImageLayoutChanged.Heredado
de Control.
OnBindingContextChangedEventArgs
OnBorderStyleChangedEventArgs
OnCausesValidationChangedEventArgs
OnChangeUICuesUICuesEventArgs
OnClickEventArgs
OnClientSizeChangedEventArgs
OnContextMenuChangedEventArgs
OnContextMenuStripChangedEventArgs
OnControlAddedControlEventArgs
OnControlRemovedControlEventArgs
OnCreateControl
OnCursorChangedEventArgs
OnDockChangedEventArgs
OnDoubleClickEventArgs
OnDragDropDragEventArgs
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
16/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
OnDragEnterDragEventArgs
OnDragLeaveEventArgs
OnDragOverDragEventArgs
OnEnabledChangedEventArgs
OnEnterEventArgs
OnFontChangedEventArgs
OnForeColorChangedEventArgs
OnGiveFeedbackGiveFeedbackEventArgs
OnGotFocusEventArgs
OnHandleCreatedEventArgs
OnHandleDestroyedEventArgs
OnHelpRequestedHelpEventArgs
OnHideSelectionChangedEventArgs
OnImeModeChangedEventArgs
OnInvalidatedInvalidateEventArgs
OnKeyDownKeyEventArgs
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
17/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
OnKeyPressKeyPressEventArgs
OnKeyUpKeyEventArgs
OnLayoutLayoutEventArgs
OnLeaveEventArgs
OnLocationChangedEventArgs
OnLostFocusEventArgs
OnMarginChangedEventArgs
OnModifiedChangedEventArgs
OnMouseCaptureChangedEventArgs
OnMouseClickMouseEventArgs
OnMouseDoubleClickMouseEventArgs
OnMouseDownMouseEventArgs
OnMouseEnterEventArgs
OnMouseHoverEventArgs
OnMouseLeaveEventArgs
OnMouseMoveMouseEventArgs
OnMouseUpMouseEventArgs
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
18/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
TextBoxBase.
OnMouseWheelMouseEventArgs
OnMoveEventArgs
OnMultilineChangedEventArgs
OnNotifyMessageMessage
OnPaddingChangedEventArgs
OnPaintPaintEventArgs
OnPaintBackgroundPaintEventArgs
OnParentBackColorChangedEventArgs
OnParentBackgroundImageChangedEventArgs
OnParentBindingContextChangedEventArgs
OnParentChangedEventArgs
OnParentCursorChangedEventArgs
OnParentEnabledChangedEventArgs
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
19/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
Control.
OnParentFontChangedEventArgs
OnParentForeColorChangedEventArgs
OnParentRightToLeftChangedEventArgs
OnParentVisibleChangedEventArgs
OnPreviewKeyDownPreviewKeyDownEventArgs
OnPrintPaintEventArgs
OnQueryContinueDragQueryContinueDragEventArgs
OnReadOnlyChangedEventArgs
OnRegionChangedEventArgs
OnResizeEventArgs
OnRightToLeftChangedEventArgs
OnSizeChangedEventArgs
OnStyleChangedEventArgs
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
20/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
OnSystemColorsChangedEventArgs
OnTabIndexChangedEventArgs
OnTabStopChangedEventArgs
OnTextAlignChangedEventArgs
OnTextChangedEventArgs
Heredado de TextBoxBase.
OnValidatedEventArgs
OnValidatingCancelEventArgs
OnVisibleChangedEventArgs
Paste
PasteString
PerformLayout
PerformLayoutControl,String
PointToClientPoint
PointToScreenPoint
PreProcessControlMessageMessage
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
21/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
PreProcessMessageMessage
ProcessCmdKeyMessage,Keys
ProcessDialogCharChar
ProcessDialogKeyKeys
Heredado de TextBoxBase.
ProcessKeyEventArgsMessage
ProcessKeyMessageMessage
ProcessKeyPreviewMessage
ProcessMnemonicChar
RaiseDragEventObject,DragEventArgs
RaiseKeyEventObject,KeyEventArgs
RaiseMouseEventObject,MouseEventArgs
RaisePaintEventObject,PaintEventArgs
RecreateHandle
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
22/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
RectangleToClientRectangle
RectangleToScreenRectangle
Refresh
ResetBackColor
ResetBindings
ResetCursor
ResetFont
ResetForeColor
ResetImeMode
ResetMouseEventArgs
ResetRightToLeft
ResetText
ResumeLayout
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
23/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
ResumeLayoutBoolean
RtlTranslateAlignmentContentAlignment
RtlTranslateAlignmentHorizontalAlignment
Convierte la HorizontalAlignment
especificada en la HorizontalAlignment
correspondiente para que admita texto de
derecha a izquierda.Heredado de Control.
RtlTranslateAlignmentLeftRightAlignment
RtlTranslateContentContentAlignment
RtlTranslateHorizontalHorizontalAlignment
Convierte la HorizontalAlignment
especificada en la HorizontalAlignment
correspondiente para que admita texto de
derecha a izquierda.Heredado de Control.
RtlTranslateLeftRightLeftRightAlignment
ScaleSingle
ScaleSingle,Single
ScaleSizeF
ScaleControlSizeF,BoundsSpecified
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
24/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
ScaleCoreSingle,Single
ScrollToCaret
Select
SelectBoolean,Boolean
SelectInt32,Int32
SelectAll
SelectNextControlControl,Boolean,Boolean,Boolean,Boolean
SendToBack
SetAutoSizeModeAutoSizeMode
SetBoundsInt32,Int32,Int32,Int32
SetBoundsInt32,Int32,Int32,Int32,BoundsSpecified
SetBoundsCoreInt32,Int32,Int32,Int32,BoundsSpecified
SetClientSizeCoreInt32,Int32
SetStyleControlStyles,Boolean
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
25/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
SetTopLevelBoolean
SetVisibleCoreBoolean
Show
SizeFromClientSizeSize
SuspendLayout
ToString
Undo
Update
UpdateBounds
UpdateBoundsInt32,Int32,Int32,Int32
UpdateBoundsInt32,Int32,Int32,Int32,Int32,Int32
UpdateStyles
UpdateZOrder
WndProcMessage
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
26/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
Reemplaza a
TextBoxBase.WndProcMessage.
Eventos
Nombre
Descripcin
AcceptsTabChanged
AutoSizeChanged
BackColorChanged
BackgroundImageChanged
BackgroundImageLayoutChanged
BindingContextChanged
BorderStyleChanged
CausesValidationChanged
ChangeUICues
Click
ClientSizeChanged
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
27/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
ContextMenuChanged
ContextMenuStripChanged
ControlAdded
ControlRemoved
CursorChanged
Disposed
DockChanged
DoubleClick
DragDrop
DragEnter
DragLeave
DragOver
EnabledChanged
Enter
FontChanged
ForeColorChanged
GiveFeedback
GotFocus
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
28/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
HandleCreated
HandleDestroyed
HelpRequested
HideSelectionChanged
ImeModeChanged
Invalidated
KeyDown
KeyPress
KeyUp
Layout
Leave
LocationChanged
LostFocus
MarginChanged
ModifiedChanged
MouseCaptureChanged
MouseClick
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
29/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
MouseDoubleClick
MouseDown
MouseEnter
MouseHover
MouseLeave
MouseMove
MouseUp
MouseWheel
Move
MultilineChanged
PaddingChanged
Paint
ParentChanged
PreviewKeyDown
QueryAccessibilityHelp
QueryContinueDrag
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
30/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
ReadOnlyChanged
RegionChanged
Resize
RightToLeftChanged
SizeChanged
StyleChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
TextAlignChanged
TextChanged
Validated
Validating
VisibleChanged
Descripcin
IDropTarget.OnDragDropDragEventArgs
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
31/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
IDropTarget.OnDragEnterDragEventArgs
IDropTarget.OnDragLeaveEventArgs
IDropTarget.OnDragOverDragEventArgs
Comentarios
Con el control TextBox, el usuario puede escribir texto en una aplicacin.Este control tiene funcionalidad adicional que no
se encuentra en el control de cuadro de texto de Windows estndar, como el enmascaramiento de caracteres de
contrasea y la edicin de mltiples lneas.
Habitualmente, se utiliza un control TextBox para mostrar, o aceptar como entrada, una sola lnea de texto.Es posible
utilizar las propiedades Multiline y ScrollBars para permitir que se muestren o escriban varias lneas de texto.Establezca las
propiedades AcceptsTab y AcceptsReturn en true con el fin de permitir una mayor manipulacin de texto en un control
TextBox multilnea.
Nota
Debe establecer la propiedad Multiline en true para ajustar el alto del control TextBox.Puede ajustar el alto
estableciendo la propiedad Size.
Puede limitar la cantidad de texto escrito en un control TextBox estableciendo la propiedad MaxLength en un nmero de
caracteres concreto.Los controles TextBox tambin se pueden utilizar para aceptar contraseas y otra informacin
confidencial.Es posible utilizar la propiedad PasswordChar para enmascarar caracteres escritos en una versin de una sola
lnea del control.Utilice la propiedad CharacterCasing para permitir al usuario escribir slo maysculas, slo minsculas o
una combinacin de caracteres en maysculas y minsculas en el control TextBox.
Para desplazar el contenido de TextBox hasta que el cursor smbolo de intercalacin est en la regin visible del control,
puede usar el mtodo ScrollToCaret.Para seleccionar un intervalo de texto en el cuadro de texto, puede utilizar el mtodo
Select.
Para restringir que se escriba texto en un control TextBox, se puede crear un controlador de eventos para el evento
KeyDown con el fin de validar cada carcter escrito en el control.Tambin se puede restringir toda entrada de datos en un
control TextBox; para ello, establezca la propiedad ReadOnly en true.
Nota
La mayor parte de la funcionalidad del control TextBox se hereda de la clase TextBoxBase.
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
32/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
El uso del control TextBox con los estilos visuales habilitados provocar la manipulacin incorrecta de las fuentes
suplentes.
Ejemplos
En el siguiente ejemplo de cdigo se crea un control TextBox multilnea con barras de desplazamiento verticales.En este
ejemplo se utilizan las propiedades AcceptsTab, AcceptsReturn y Dock para hacer que el control de cuadro de texto
multilnea sea til para crear documentos de texto.
C#
usingSystem;
usingSystem.Collections.Generic;
usingSystem.ComponentModel;
usingSystem.Data;
usingSystem.Drawing;
usingSystem.Linq;
usingSystem.Text;
usingSystem.Windows.Forms;
publicclassForm1:Form
{
privateTextBoxtextBox1;
publicForm1()
{
InitializeComponent();
}
privatevoidInitializeComponent()
{
this.textBox1=newSystem.Windows.Forms.TextBox();
this.SuspendLayout();
//
//textBox1
//
this.textBox1.AcceptsReturn=true;
this.textBox1.AcceptsTab=true;
this.textBox1.Dock=System.Windows.Forms.DockStyle.Fill;
this.textBox1.Multiline=true;
this.textBox1.ScrollBars=System.Windows.Forms.ScrollBars.Vertical;
//
//Form1
//
this.ClientSize=newSystem.Drawing.Size(284,264);
this.Controls.Add(this.textBox1);
this.Text="TextBoxExample";
this.ResumeLayout(false);
this.PerformLayout();
}
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
33/34
26/2/2016
TextBox(Clase)(System.Windows.Forms)
[STAThread]
staticvoidMain()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(newForm1());
}
}
Informacin de versin
.NET Framework
Disponible desde 1.1
Vea tambin
TextBoxBase
System.Windows.Forms Espacio de nombres
Volver al principio
2016 Microsoft
https://msdn.microsoft.com/eses/library/system.windows.forms.textbox(d=printer,v=vs.110).aspx
34/34