Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmTextFieldGetSubstringWcs(Library Functions ManuXmTextFieldGetSubstringWcs(3)

NAME
       XmTextFieldGetSubstringWcs  --  A  TextField  function that retrieves a
       portion of a wide character internal text buffer

SYNOPSIS
       #include	<Xm/TextF.h>
       int XmTextFieldGetSubstringWcs(
       Widget widget,
       XmTextPosition start,
       int num_chars,
       int buffer_size,
       wchar_t *buffer);

DESCRIPTION
       XmTextFieldGetSubstringWcs retrieves a copy of a	portion	of the	inter-
       nal  text buffer	of a TextField widget that is stored in	a wide charac-
       ter format. The function	copies a specified number of characters	from a
       given start position in the internal text buffer	into a buffer provided
       by the application. A NULL terminator is	 placed	 at  the  end  of  the
       copied data.

       widget	 Specifies the TextField widget	ID.

       start	 Specifies  the	 beginning  character  position	from which the
		 data will be retrieved. This is an integer number of  charac-
		 ters from the beginning of the	text buffer. The first charac-
		 ter position is 0 (zero).

       num_chars Specifies the number of wchar_t characters to be copied  into
		 the provided buffer.

       buffer_size
		 Specifies  the	 size  of  the	supplied buffer	as a number of
		 wchar_t storage locations. The	minimum	size is	num_chars + 1.

       buffer	 Specifies the wide character buffer into which	 the  internal
		 text buffer will be copied.

       For  a  complete	 definition of TextField and its associated resources,
       see XmTextField(3).

RETURN
       XmCOPY_SUCCEEDED
		 The function was successful.

       XmCOPY_FAILED
		 The function failed because it	was unable to copy the	speci-
		 fied number of	characters into	the buffer provided.  The buf-
		 fer size may be insufficient. The contents of buffer are  un-
		 defined.

       XmCOPY_TRUNCATED
		 The requested number of characters extended beyond the	inter-
		 nal buffer. The function copied characters to the end of  the
		 buffer	 and  terminated  the  string  with a NULL terminator;
		 fewer than num_chars characters were copied.

RELATED
       XmTextField(3) and XmTextFieldGetSubstring(3).

						 XmTextFieldGetSubstringWcs(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmTextFieldGetSubstringWcs&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help