다음을 통해 공유

OLEUIINSERTOBJECTW 구조체(oledlg.h)

  • 아티클

OLE 사용자 인터페이스 라이브러리가 개체 삽입 대화 상자를 초기화하는 데 사용하는 정보와 대화 상자가 해제될 때 라이브러리가 정보를 반환할 수 있는 공간이 포함되어 있습니다.

구문

typedef struct tagOLEUIINSERTOBJECTW {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCWSTR         lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCWSTR         lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPWSTR          lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;

멤버

cbStruct

구조체의 크기(바이트)입니다. 이 필드는 입력에 채워야 합니다.

dwFlags

입력 시 초기화 및 만들기 플래그를 지정합니다. 종료 시 사용자의 선택 항목을 지정합니다. 다음 플래그의 조합일 수 있습니다.

값 의미
IOF_SHOWHELP
 대화 상자에 도움말 단추가 표시됩니다.
IOF_SELECTCREATENEW
 새로 만들기 라디오 단추가 처음에 선택됩니다. IOF_SELECTCREATEFROMFILE 사용할 수 없습니다.
IOF_SELECTCREATEFROMFILE
 파일에서 만들기 라디오 단추가 처음에 선택됩니다. IOF_SELECTCREATENEW 사용할 수 없습니다.
IOF_CHECKLINK
 링크 검사 상자가 처음에 선택됩니다.
IOF_CHECKDISPLAYASICON
 아이콘으로 표시 검사 상자가 처음에 선택되고, 현재 아이콘이 표시되고, 아이콘 변경 단추가 활성화됩니다.
IOF_CREATENEWOBJECT
 사용자가 확인을 선택하여 대화 상자를 해제하고 새로 만들기 라디오 단추를 선택한 경우 새 개체를 만들어야 합니다.
IOF_CREATEFILEOBJECT
 사용자가 확인을 선택하여 대화 상자를 해제하고 파일에서 만들기 라디오 단추를 선택하면 지정된 파일에서 새 개체를 만들어야 합니다.
IOF_CREATELINKOBJECT
 사용자가 확인을 선택하여 대화 상자를 해제하고 사용자가 링크 검사 상자를 선택한 경우 새 연결된 개체를 만들어야 합니다.
IOF_DISABLELINK
 링크 검사 상자는 초기화 시 사용하지 않도록 설정됩니다.
IOF_VERIFYSERVERSEXIST
 대화 상자는 등록 데이터베이스에 지정된 서버가 있는지 확인하여 목록 상자에 추가하는 클래스의 유효성을 검사해야 합니다. 이는 중요한 성능 요소입니다.
IOF_DISABLEDISPLAYASICON
 초기화 시 아이콘으로 표시 검사 상자가 비활성화됩니다.
IOF_HIDECHANGEICON
 개체 삽입 대화 상자에서 아이콘 변경 단추가 숨겨집니다.
IOF_SHOWINSERTCONTROL
 컨트롤 삽입 라디오 단추를 표시합니다.
IOF_SELECTCREATECONTROL
 컨트롤 만들기 라디오 단추를 표시합니다.

hWndOwner

대화 상자를 소유하는 창입니다. 이 멤버는 NULL이 아니어야 합니다.

lpszCaption

대화 상자의 제목으로 사용할 문자열에 대한 포인터입니다. NULL인 경우 라이브러리는 Insert 개체를 사용합니다.

lpfnHook

대화 상자용 메시지를 처리하는 후크 함수에 대한 포인터입니다. 후크 함수는 라이브러리의 대화 상자 프로시저로 다시 처리되지 않았다는 메시지를 전달하려면 0을 반환해야 합니다. 후크 함수는 라이브러리의 대화 상자 프로시저가 이미 처리한 메시지를 처리하지 못하도록 0이 아닌 값을 반환해야 합니다.

lCustData

라이브러리가 lpfnHook 멤버가 가리키는 후크 함수에 전달하는 애플리케이션 정의 데이터입니다. 라이브러리는 WM_INITDIALOG 메시지의 lParam 매개 변수에서 OLEUIINSERTOBJECT 구조체에 대한 포인터를 전달합니다. 이 포인터를 사용하여 lCustData 멤버를 검색할 수 있습니다.

hInstance

lpTemplateName 멤버가 지정한 대화 상자 템플릿을 포함하는 인스턴스입니다.

lpszTemplate

라이브러리의 개체 삽입 대화 상자 템플릿으로 대체될 대화 상자 템플릿의 리소스 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

hResource

사용자 지정된 템플릿 핸들입니다.

clsid

삽입할 개체의 클래스에 대한 CLSID입니다. 출력에 채워집니다.

lpszFile

연결하거나 포함할 파일의 이름에 대한 포인터입니다. 출력에 채워집니다.

cchFile

lpszFile 버퍼의 크기; 는 MAX_PATH 초과하지 않습니다.

cClsidExclude

lpClsidExclude 목록에 포함된 CLSID 수입니다. 입력에 채워집니다.

lpClsidExclude

목록에서 제외할 CLSID 목록에 대한 포인터입니다.

iid

요청된 인터페이스의 식별자입니다. OleUIInsertObject가 개체를 만드는 경우 이 인터페이스에 대한 포인터를 반환합니다. OleUIInsertObject에서 개체를 만들지 않으면 이 매개 변수는 무시됩니다.

oleRender

렌더링 옵션. OleUIInsertObject에서 개체를 만드는 경우 개체를 만들 때 렌더링 옵션을 선택합니다. OleUIInsertObject에서 개체를 만들지 않으면 이 매개 변수는 무시됩니다.

lpFormatEtc

원하는 형식입니다. OleUIInsertObject가 개체를 만드는 경우 개체를 만들 때 형식을 선택합니다. OleUIInsertObject에서 개체를 만들지 않으면 이 매개 변수는 무시됩니다.

lpIOleClientSite

개체에 사용할 클라이언트 사이트에 대한 포인터입니다. OleUIInsertObject에서 개체를 만들지 않으면 이 매개 변수는 무시됩니다.

lpIStorage

개체에 사용할 스토리지에 대한 포인터입니다. OleUIInsertObject에서 개체를 만들지 않으면 이 매개 변수는 무시됩니다.

ppvObj

삽입되는 개체에 대한 인터페이스 포인터를 포함하는 출력 포인터 변수의 주소입니다. OleUIInsertObject에서 개체를 만들지 않으면 이 매개 변수는 무시됩니다.

sc

생성 호출의 결과입니다. OleUIInsertObject에서 개체를 만들지 않으면 이 매개 변수는 무시됩니다.

hMetaPict

개체의 캐시에 배치되지 않은 경우 상징적인 측면을 포함하는 MetafilePict 구조체입니다.

설명

참고

oledlg.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 OLEUIINSERTOBJECT를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 oledlg.h

추가 정보

OleUIInsertObject