004. xfnGetControlCaption

xfnGetControlCaption 함수

• • 컨트롤의 캡션값을 반환하는 함수입니다.

  • 컨트롤 캡션의 최우측 문자열이 '*'일 경우 이를 제외하고 값을 반환합니다.

구문

• xfnGetControlCaption(ctr As Control, Optional ByVal blnIncludeStar As Boolean = False) As String

반환값

• • 성공 : 컨트롤의 캡션을 반환합니다.

  • 오류 : 상수 xCON_ERR_STRING 을 반환합니다.

    • 상수값은 #ERROR입니다.

참고

• • 컨트롤의 캡션은 짝이되는 레이블의 Caption 속성을 가져오게 됩니다.

    • 짝이 되는 레이블이 없을 경우,

      • 컨트롤 원본을 반환합니다.(컨트롤 원본이 수식('='으로 시작)이면 컨트롤 이름을 반환합니다.)

    • 컨트롤 원본이 없으면 컨트롤 이름을 반환합니다.

예제

코드

'UserName 필드의 짝 Label = "성명*"

'우측 '*'포함하여 반환합니다.

?xfnGetControlCaption(UserName,True)

성명*

'우측 '*'삭제 한 후 반환합니다.

?xfnGetControlCaption(UserName,False)

성명

'짝 Label이 없을 경우, 컨트롤 원본을 반환합니다.

?xfnGetControlCaption(UserName)

UserName